BITCOIN-CLI(1) دستورات کاربر BITCOIN-CLI(1)

bitcoin-cli - ابزار خط فرمان ارتباط با سرور بیت‌کوین

bitcoin-cli [options] <command> [params]
bitcoin-cli [options] -named <command> [name=value]...
bitcoin-cli [options] help
bitcoin-cli [options] help <command>

کلاینت RPC بیت‌کوین کور (Bitcoin Core) نسخه v31.1.0

ابزار bitcoin-cli یک واسط خط فرمان برای تعامل با سرور RPC بیت‌کوین کور فراهم می‌کند.

از این ابزار می‌توان برای پرس‌وجوی اطلاعات شبکه، مدیریت کیف‌های پول، ایجاد یا انتشار تراکنش‌ها و کنترل سرور بیت‌کوین کور استفاده کرد.

از دستور «help» برای فهرست کردن تمام دستورات استفاده کنید. برای نمایش راهنمای یک دستور خاص از «help <command>» استفاده کنید. گزینه -named به شما امکان می‌دهد پارامترها را با قالب کلید=مقدار (key=value) مشخص کنید، که نیاز به ارسال پارامترهای مکانی بلااستفاده را از بین می‌برد.

-color=<when>

تنظیم رنگ برای خروجی خط فرمان (پیش‌فرض: auto). مقادیر معتبر: always،‏ auto (افزودن کدهای رنگی هنگامی که خروجی استاندارد به یک ترمینال متصل است و سیستم‌عامل WIN32 نیست)، never. تنها بر خروجی -getinfo اعمال می‌شود.

-conf=<file>

مشخص کردن فایل پیکربندی. مسیرهای نسبی با پیشوند مکان datadir تکمیل خواهند شد. (پیش‌فرض: bitcoin.conf)

-datadir=<dir>

مشخص کردن دایرکتوری داده

-help

چاپ این پیام راهنما و خروج (همچنین -h یا -?)

-named

ارسال آرگومان‌های نام‌دار به جای آرگومان‌های مکانی (پیش‌فرض: false)

-rpcclienttimeout=<n>

زمان مهلت (تایم‌اوت) به ثانیه در حین درخواست‌های HTTP، یا 0 برای بدون محدودیت زمانی. (پیش‌فرض: 900)

-rpcconnect=<ip>

ارسال دستورات به گره در حال اجرا روی <ip> (پیش‌فرض: 127.0.0.1)

-rpccookiefile=<loc>

مکان کوکی احراز هویت (auth cookie). مسیرهای نسبی با پیشوند مکان datadir مختص شبکه تکمیل خواهند شد. (پیش‌فرض: دایرکتوری داده)

-rpcpassword=<pw>

رمز عبور برای اتصالات JSON-RPC

-rpcport=<port>

اتصال به JSON-RPC روی <port> (پیش‌فرض: 8332، testnet: 18332، testnet4: 48332، signet: 38332، regtest: 18443)

-rpcuser=<user>

نام کاربری برای اتصالات JSON-RPC

-rpcwait

انتظار برای شروع به کار سرور RPC

-rpcwaittimeout=<n>

زمان مهلت به ثانیه برای انتظار جهت شروع به کار سرور RPC، یا 0 برای بدون محدودیت زمانی. (پیش‌فرض: 0)

-rpcwallet=<walletname>

ارسال RPC برای کیف پول غیرپیش‌فرض در سرور RPC (باید دقیقاً با گزینه متناظر -wallet ارسال‌شده به bitcoind مطابقت داشته باشد). این کار نقطه پایانی (endpoint) استفاده‌شده در RPC را تغییر می‌دهد، مانند: http://127.0.0.1:8332/wallet/<walletname>

-stdin

خواندن آرگومان‌های اضافی از ورودی استاندارد، هر خط یکی تا زمان رسیدن به EOF/Ctrl-D (برای اطلاعات حساس مانند عبارات عبور توصیه می‌شود). هنگام ترکیب با -stdinrpcpass، خط نخست از ورودی استاندارد برای رمز عبور RPC استفاده می‌شود.

-stdinrpcpass

خواندن رمز عبور RPC از ورودی استاندارد به صورت یک تک‌خط. هنگام ترکیب با -stdin، خط اول از ورودی استاندارد برای رمز عبور RPC استفاده می‌شود. هنگام ترکیب با -stdinwalletpassphrase، گزینه -stdinrpcpass خط اول را مصرف کرده و -stdinwalletpassphrase خط دوم را مصرف می‌کند.

-stdinwalletpassphrase

خواندن عبارت عبور کیف پول از ورودی استاندارد به صورت یک تک‌خط. هنگام ترکیب با -stdin، خط اول از ورودی استاندارد برای عبارت عبور کیف پول استفاده می‌شود.

-version

چاپ نسخه و خروج

گزینه‌های اشکال‌زدایی/آزمایش:

گزینه‌های انتخاب زنجیره:

-chain=<chain>

استفاده از زنجیره <chain> (پیش‌فرض: main). مقادیر مجاز: main، test، testnet4، signet، regtest

-signet

استفاده از زنجیره signet. معادل با -chain=signet. توجه داشته باشید که شبکه توسط پارامتر -signetchallenge تعریف می‌شود

-signetchallenge

بلوک‌ها باید اسکریپت مشخص‌شده را برآورده کنند تا معتبر در نظر گرفته شوند (فقط برای شبکه‌های signet؛ مقدار پیش‌فرض آن چالش پیش‌فرض سراسری شبکه آزمایشی signet است)

-signetseednode

مشخص کردن یک گره سید (seed node) برای شبکه signet، در قالب hostname[:port]، مانند sig.net:1234 (می‌توان چندین بار برای مشخص کردن چندین گره سید استفاده کرد؛ مقدار پیش‌فرض آن گره(های) سید پیش‌فرض سراسری شبکه آزمایشی signet است)

-testnet

استفاده از زنجیره testnet3. معادل با -chain=test. پشتیبانی از testnet3 منسوخ شده و در انتشار آینده حذف خواهد شد. پیشنهاد می‌شود اکنون با استفاده از -testnet4 به testnet4 مهاجرت کنید.

-testnet4

استفاده از زنجیره testnet4. معادل با -chain=testnet4.

دستورات خط فرمان (CLI):

-addrinfo

دریافت تعداد آدرس‌های شناخته‌شده برای گره، به تفکیک شبکه و در مجموع، پس از فیلتر کردن بر اساس کیفیت و تازگی. تعداد کل آدرس‌های شناخته‌شده برای گره ممکن است بیشتر باشد.

-generate

تولید بلوک‌ها، معادل با RPC getnewaddress و به دنبال آن RPC generatetoaddress. آرگومان‌های عددی صحیح مکانی و اختیاری عبارتند از: تعداد بلوک‌ها برای تولید (پیش‌فرض: 1) و حداکثر تکرارها برای تلاش (پیش‌فرض: 1000000)، معادل با آرگومان‌های nblocks و maxtries در RPC generatetoaddress. مثال: bitcoin-cli -generate 4 1000

-getinfo

دریافت اطلاعات عمومی از سرور ریموت. توجه داشته باشید که بر خلاف فراخوانی‌های RPC سمت سرور، خروجی -getinfo نتیجه چندین درخواست غیراتمیک است. برخی از ورودی‌ها در خروجی ممکن است نشان‌دهنده نتایج از وضعیت‌های متفاوت باشند (مثلاً موجودی کیف پول ممکن است مربوط به بلوکی متفاوت از وضعیت زنجیره گزارش‌شده باشد)

-netinfo

دریافت اطلاعات اتصال همتایان (peers) شبکه از سرور ریموت. یک آرگومان اختیاری از 0 تا 4 می‌تواند برای فهرست‌بندی‌های مختلف همتایان ارسال شود (پیش‌فرض: 0). اگر مقداری غیر از صفر ارسال شود، یک آرگومان اضافی "outonly" (یا "o") می‌تواند برای مشاهده فقط همتایان خروجی ارسال گردد. برای راهنمای تفصیلی عبارت "help" (یا "h") را ارسال کنید.

کپی‌رایت © 2009-2026 توسعه‌دهندگان بیت‌کوین کور (The Bitcoin Core developers)

اگر بیت‌کوین کور را مفید می‌دانید لطفاً در توسعه آن مشارکت کنید. برای اطلاعات بیشتر در مورد نرم‌افزار به https://bitcoincore.org مراجعه کنید. کد منبع در https://github.com/bitcoin/bitcoin در دسترس است.

این یک نرم‌افزار آزمایشی است. تحت مجوز نرم‌افزاری MIT منتشر شده است، فایل همراه COPYING یا https://opensource.org/license/MIT را ببینید.

bitcoin(1), bitcoind(1), bitcoin-cli(1), bitcoin-tx(1), bitcoin-wallet(1), bitcoin-util(1), bitcoin-qt(1)

July 2026 bitcoin-cli v31.1.0