.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH BITCOIN-CLI "1" "July 2026" "bitcoin-cli v31.1.0" "دستورات کاربر"
.SH "نام (NAME)"
bitcoin-cli \- ابزار خط فرمان ارتباط با سرور بیت‌کوین
.SH "خلاصه دستور (SYNOPSIS)"
.B bitcoin-cli
[\fI\,options\/\fR] \fI\,<command> \/\fR[\fI\,params\/\fR]
.br
.B bitcoin-cli
[\fI\,options\/\fR] \fI\,-named <command> \/\fR[\fI\,name=value\/\fR]...
.br
.B bitcoin-cli
[\fI\,options\/\fR] \fI\,help\/\fR
.br
.B bitcoin-cli
[\fI\,options\/\fR] \fI\,help <command>\/\fR
.SH "توضیحات (DESCRIPTION)"
کلاینت RPC بیت‌کوین کور (Bitcoin Core) نسخه v31.1.0
.PP
ابزار
.B bitcoin\-cli
یک واسط خط فرمان برای تعامل با سرور RPC بیت‌کوین کور فراهم می‌کند.
.PP
از این ابزار می‌توان برای پرس‌وجوی اطلاعات شبکه، مدیریت کیف‌های پول، ایجاد یا انتشار تراکنش‌ها و کنترل سرور بیت‌کوین کور استفاده کرد.
.PP
از دستور «help» برای فهرست کردن تمام دستورات استفاده کنید. برای نمایش راهنمای یک دستور خاص از «help <command>» استفاده کنید.
گزینه
.B \-named
به شما امکان می‌دهد پارامترها را با قالب کلید=مقدار (key=value) مشخص کنید، که نیاز به ارسال پارامترهای مکانی بلااستفاده را از بین می‌برد.
.SH "گزینه‌ها (OPTIONS)"
.HP
\fB\-color=\fR<when>
.IP
تنظیم رنگ برای خروجی خط فرمان (پیش‌فرض: auto). مقادیر معتبر: always،‏ auto
(افزودن کدهای رنگی هنگامی که خروجی استاندارد به یک ترمینال متصل است
و سیستم‌عامل WIN32 نیست)، never. تنها بر خروجی
.B \-getinfo
اعمال می‌شود.
.HP
\fB\-conf=\fR<file>
.IP
مشخص کردن فایل پیکربندی. مسیرهای نسبی با پیشوند مکان datadir تکمیل خواهند شد. (پیش‌فرض: bitcoin.conf)
.HP
\fB\-datadir=\fR<dir>
.IP
مشخص کردن دایرکتوری داده
.HP
\fB\-help\fR
.IP
چاپ این پیام راهنما و خروج (همچنین
.B \-h
یا
.BR \-? )
.HP
\fB\-named\fR
.IP
ارسال آرگومان‌های نام‌دار به جای آرگومان‌های مکانی (پیش‌فرض: false)
.HP
\fB\-rpcclienttimeout=\fR<n>
.IP
زمان مهلت (تایم‌اوت) به ثانیه در حین درخواست‌های HTTP، یا 0 برای بدون محدودیت زمانی. (پیش‌فرض:
900)
.HP
\fB\-rpcconnect=\fR<ip>
.IP
ارسال دستورات به گره در حال اجرا روی <ip> (پیش‌فرض: 127.0.0.1)
.HP
\fB\-rpccookiefile=\fR<loc>
.IP
مکان کوکی احراز هویت (auth cookie). مسیرهای نسبی با پیشوند مکان datadir مختص شبکه تکمیل خواهند شد. (پیش‌فرض: دایرکتوری داده)
.HP
\fB\-rpcpassword=\fR<pw>
.IP
رمز عبور برای اتصالات JSON\-RPC
.HP
\fB\-rpcport=\fR<port>
.IP
اتصال به JSON\-RPC روی <port> (پیش‌فرض: 8332، testnet: 18332، testnet4:
48332، signet: 38332، regtest: 18443)
.HP
\fB\-rpcuser=\fR<user>
.IP
نام کاربری برای اتصالات JSON\-RPC
.HP
\fB\-rpcwait\fR
.IP
انتظار برای شروع به کار سرور RPC
.HP
\fB\-rpcwaittimeout=\fR<n>
.IP
زمان مهلت به ثانیه برای انتظار جهت شروع به کار سرور RPC، یا 0 برای بدون محدودیت زمانی. (پیش‌فرض: 0)
.HP
\fB\-rpcwallet=\fR<walletname>
.IP
ارسال RPC برای کیف پول غیرپیش‌فرض در سرور RPC (باید دقیقاً با گزینه متناظر
.B \-wallet
ارسال‌شده به bitcoind مطابقت داشته باشد). این کار نقطه پایانی (endpoint) استفاده‌شده در RPC را تغییر می‌دهد، مانند:
http://127.0.0.1:8332/wallet/<walletname>
.HP
\fB\-stdin\fR
.IP
خواندن آرگومان‌های اضافی از ورودی استاندارد، هر خط یکی تا زمان رسیدن به EOF/Ctrl\-D
(برای اطلاعات حساس مانند عبارات عبور توصیه می‌شود). هنگام ترکیب با
.BR \-stdinrpcpass ،
خط نخست از ورودی استاندارد برای رمز عبور RPC استفاده می‌شود.
.HP
\fB\-stdinrpcpass\fR
.IP
خواندن رمز عبور RPC از ورودی استاندارد به صورت یک تک‌خط. هنگام ترکیب با
.BR \-stdin ،
خط اول از ورودی استاندارد برای رمز عبور RPC استفاده می‌شود. هنگام ترکیب با
.BR \-stdinwalletpassphrase ،
گزینه
.B \-stdinrpcpass
خط اول را مصرف کرده و
.B \-stdinwalletpassphrase
خط دوم را مصرف می‌کند.
.HP
\fB\-stdinwalletpassphrase\fR
.IP
خواندن عبارت عبور کیف پول از ورودی استاندارد به صورت یک تک‌خط. هنگام ترکیب با
.BR \-stdin ،
خط اول از ورودی استاندارد برای عبارت عبور کیف پول استفاده می‌شود.
.HP
\fB\-version\fR
.IP
چاپ نسخه و خروج
.PP
گزینه‌های اشکال‌زدایی/آزمایش:
.PP
گزینه‌های انتخاب زنجیره:
.HP
\fB\-chain=\fR<chain>
.IP
استفاده از زنجیره <chain> (پیش‌فرض: main). مقادیر مجاز: main، test،
testnet4، signet، regtest
.HP
\fB\-signet\fR
.IP
استفاده از زنجیره signet. معادل با \fB\-chain\fR=\fI\,signet\/\fR. توجه داشته باشید که شبکه
توسط پارامتر
.B \-signetchallenge
تعریف می‌شود
.HP
\fB\-signetchallenge\fR
.IP
بلوک‌ها باید اسکریپت مشخص‌شده را برآورده کنند تا معتبر در نظر گرفته شوند (فقط برای
شبکه‌های signet؛ مقدار پیش‌فرض آن چالش پیش‌فرض سراسری شبکه آزمایشی signet است)
.HP
\fB\-signetseednode\fR
.IP
مشخص کردن یک گره سید (seed node) برای شبکه signet، در قالب hostname[:port]،
مانند sig.net:1234 (می‌توان چندین بار برای مشخص کردن چندین گره سید استفاده کرد؛
مقدار پیش‌فرض آن گره(های) سید پیش‌فرض سراسری شبکه آزمایشی signet است)
.HP
\fB\-testnet\fR
.IP
استفاده از زنجیره testnet3. معادل با \fB\-chain\fR=\fI\,test\/\fR. پشتیبانی از testnet3
منسوخ شده و در انتشار آینده حذف خواهد شد.
پیشنهاد می‌شود اکنون با استفاده از
.B \-testnet4
به testnet4 مهاجرت کنید.
.HP
\fB\-testnet4\fR
.IP
استفاده از زنجیره testnet4. معادل با \fB\-chain\fR=\fI\,testnet4\/\fR.
.PP
دستورات خط فرمان (CLI):
.HP
\fB\-addrinfo\fR
.IP
دریافت تعداد آدرس‌های شناخته‌شده برای گره، به تفکیک شبکه و در مجموع،
پس از فیلتر کردن بر اساس کیفیت و تازگی. تعداد کل آدرس‌های شناخته‌شده
برای گره ممکن است بیشتر باشد.
.HP
\fB\-generate\fR
.IP
تولید بلوک‌ها، معادل با RPC getnewaddress و به دنبال آن RPC generatetoaddress.
آرگومان‌های عددی صحیح مکانی و اختیاری عبارتند از: تعداد بلوک‌ها برای تولید (پیش‌فرض: 1)
و حداکثر تکرارها برای تلاش (پیش‌فرض: 1000000)، معادل با آرگومان‌های nblocks و maxtries در
RPC generatetoaddress. مثال: bitcoin\-cli \fB\-generate\fR 4 1000
.HP
\fB\-getinfo\fR
.IP
دریافت اطلاعات عمومی از سرور ریموت. توجه داشته باشید که بر خلاف
فراخوانی‌های RPC سمت سرور، خروجی
.B \-getinfo
نتیجه چندین درخواست غیراتمیک است. برخی از ورودی‌ها در خروجی ممکن است
نشان‌دهنده نتایج از وضعیت‌های متفاوت باشند (مثلاً موجودی کیف پول ممکن است
مربوط به بلوکی متفاوت از وضعیت زنجیره گزارش‌شده باشد)
.HP
\fB\-netinfo\fR
.IP
دریافت اطلاعات اتصال همتایان (peers) شبکه از سرور ریموت. یک آرگومان
اختیاری از 0 تا 4 می‌تواند برای فهرست‌بندی‌های مختلف همتایان ارسال شود (پیش‌فرض: 0).
اگر مقداری غیر از صفر ارسال شود، یک آرگومان اضافی "outonly" (یا "o")
می‌تواند برای مشاهده فقط همتایان خروجی ارسال گردد. برای راهنمای تفصیلی عبارت "help" (یا "h")
را ارسال کنید.
.SH "کپی‌رایت (COPYRIGHT)"
کپی‌رایت \(co 2009-2026 توسعه‌دهندگان بیت‌کوین کور (The Bitcoin Core developers)
.PP
اگر بیت‌کوین کور را مفید می‌دانید لطفاً در توسعه آن مشارکت کنید. برای اطلاعات بیشتر در مورد نرم‌افزار به
<https://bitcoincore.org>
مراجعه کنید. کد منبع در
<https://github.com/bitcoin/bitcoin>
در دسترس است.
.PP
این یک نرم‌افزار آزمایشی است.
تحت مجوز نرم‌افزاری MIT منتشر شده است، فایل همراه COPYING یا
<https://opensource.org/license/MIT>
را ببینید.
.SH "همچنین ببینید (SEE ALSO)"
.BR bitcoin (1),
.BR bitcoind (1),
.BR bitcoin-cli (1),
.BR bitcoin-tx (1),
.BR bitcoin-wallet (1),
.BR bitcoin-util (1),
.BR bitcoin-qt (1)