BITCOIN-QT(1) User Commands BITCOIN-QT(1)

bitcoin-qt - کلاینت گرافیکی بیتکوین بر پایه چارچوب نرمافزاری Qt

bitcoin-qt [options] [URI]

بیت‌کوین کور نگارش v31.1.0

برنامه bitcoin-qt یک واسط کاربری گرافیکی برای تعامل با بیت‌کوین کور (Bitcoin Core) فراهم می‌کند.

این برنامه عملکردهای اصلی bitcoind را با یک واسط کاربرپسند برای مدیریت کیف پول، تاریخچه تراکنش‌ها و آمارهای شبکه ترکیب می‌کند.

این برنامه برای کاربرانی مناسب است که واسط گرافیکی را به واسط خط فرمان ترجیح می‌دهند.

شما می‌توانید به صورت اختیاری یک شناسه پرداخت [URI] را، مثلاً در قالب BIP21 URI، تعیین کنید.

-alertnotify=<cmd>

اجرای دستور هنگام صدور یک هشدار (%s در دستور با پیام جایگزین می‌شود)

-allowignoredconf

برای سازگاری رو به عقب، پرونده استفاده‌نشده bitcoin.conf در datadir به جای خطا، به عنوان هشدار در نظر گرفته شود.

-assumevalid=<hex>

اگر این بلوک در زنجیره باشد، فرض می‌شود که خود و اجداد آن معتبر هستند و در صورت امکان از اعتبارسنجی اسکریپت آن‌ها صرف‌نظر می‌شود (0 برای اعتبارسنجی همه، پیش‌فرض: 00000000000000000000ccebd6d74d9194d8dcdc1d177c478e094bfad51ba5ac، testnet3: 000000007a61e4230b28ac5cb6b5e5a0130de37ac1faf2f8987d2fa6505b67f4، testnet4: 0000000002368b1e4ee27e2e85676ae6f9f9e69579b29093e9a82c170bf7cf8a، signet: 00000008414aab61092ef93f1aacc54cf9e9f16af29ddad493b908a01ff5c329)

-blockfilterindex=<type>

نگهداری یک نمایه (index) از فیلترهای فشرده بر اساس بلوک (پیش‌فرض: 0، مقادیر: basic). اگر <type> ارائه نشود یا اگر <type> = 1 باشد، نمایه‌ها برای همه انواع شناخته‌شده فعال می‌شوند.

-blocknotify=<cmd>

اجرای دستور هنگام تغییر بهترین بلوک (%s در دستور با هش بلوک جایگزین می‌شود)

-blockreconstructionextratxn=<n>

تعداد تراکنش‌های اضافی برای نگهداری در حافظه جهت بازسازی بلوک‌های فشرده (پیش‌فرض: 100)

-blocksdir=<dir>

تعیین دایرکتوری برای نگهداری زیردایرکتوری بلوک‌ها برای پرونده‌های *.dat (پیش‌فرض: <datadir>)

-blocksonly

رد کردن یا نکردن تراکنش‌های دریافتی از همتایان شبکه. انتشار و بازنشر خودکار تراکنش‌ها را غیرفعال می‌کند، مگر اینکه همتای مبدأ مجوز 'forcerelay' داشته باشد. تراکنش‌های RPC تحت تأثیر قرار نمی‌گیرند. (پیش‌فرض: 0)

-blocksxor

اعمال یا عدم اعمال کلید XOR بر روی پرونده‌های *.dat در blocksdir. کلید ایجادشده برای یک blocksdir موجود یا در صورت تنظیم `-blocksxor=0` صفر خواهد بود، و برای یک blocksdir تازه مقداردهی‌شده تصادفی است. (پیش‌فرض: 1)

-coinstatsindex

نگهداری نمایه آمار سکه‌ها که توسط دستور RPC به نام gettxoutsetinfo استفاده می‌شود (پیش‌فرض: 0)

-conf=<file>

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

-daemon

اجرا در پس‌زمینه به صورت دیمن و پذیرش دستورات (پیش‌فرض: 0)

-daemonwait

انتظار برای تکمیل مقداردهی اولیه پیش از خروج. این گزینه متضمن -daemon است (پیش‌فرض: 0)

-datadir=<dir>

تعیین دایرکتوری داده‌ها

-dbcache=<n>

حداکثر اندازه حافظه موقت (کش) پایگاه داده به <n> مبی‌بایت (حداقل 4، پیش‌فرض: 1024). مطمئن شوید که حافظه رم کافی در اختیار دارید. علاوه بر این، حافظه استفاده‌نشده تخصیص‌یافته به mempool با این کش به اشتراک گذاشته می‌شود (گزینه -maxmempool را ببینید).

-debuglogfile=<file>

تعیین مکان پرونده گزارش اشکال‌زدایی (پیش‌فرض: debug.log). مسیرهای نسبی با پیشوند مکان datadir ویژه هر شبکه تکمیل می‌شوند. برای غیرفعال کردن نوشتن لاگ در فایل از -nodebuglogfile استفاده کنید.

-help

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

-includeconf=<file>

تعیین پرونده پیکربندی اضافی، نسبی نسبت به مسیر -datadir (تنها از درون پرونده پیکربندی قابل استفاده است، نه خط فرمان)

-loadblock=<file>

وارد کردن بلوک‌ها از پرونده خارجی در زمان راه‌اندازی

-maxmempool=<n>

نگه داشتن استخر حافظه تراکنش‌ها زیر <n> مگابایت (پیش‌فرض: 300)

-mempoolexpiry=<n>

نگه نداشتن تراکنش‌ها در mempool بیشتر از <n> ساعت (پیش‌فرض: 336)

-par=<n>

تنظیم تعداد ریسمان‌های اعتبارسنجی اسکریپت (0 = خودکار، تا 15، کمتر از 0 = آزاد گذاشتن آن تعداد هسته پردازنده، پیش‌فرض: 0)

-persistmempool

ذخیره mempool در زمان خاموش شدن و بارگذاری مجدد در زمان راه‌اندازی (پیش‌فرض: 1)

-persistmempoolv1

آیا پرونده mempool.dat ایجادشده توسط -persistmempool یا دستور RPC به نام savemempool در قالب قدیمی (نسخه 1) نوشته شود یا قالب فعلی (نسخه 2). این گزینه موقت در آینده حذف خواهد شد. (پیش‌فرض: 0)

-pid=<file>

تعیین پرونده pid. مسیرهای نسبی با پیشوند مکان datadir ویژه هر شبکه تکمیل می‌شوند. (پیش‌فرض: bitcoind.pid)

-prune=<n>

کاهش فضای ذخیره‌سازی با فعال کردن هرس (حذف) بلوک‌های قدیمی. این امکان فراخوانی دستور RPC به نام pruneblockchain را برای حذف بلوک‌های خاص فراهم می‌سازد و در صورت تعیین اندازه هدف به مبی‌بایت، هرس خودکار را فعال می‌کند. این حالت با -txindex ناسازگار است. هشدار: بازگرداندن این تنظیم مستلزم بارگیری مجدد کل زنجیره بلوکی است. (پیش‌فرض: 0 = غیرفعال بودن هرس بلوک‌ها، 1 = امکان هرس دستی از طریق RPC، >=550 = هرس خودکار پرونده‌های بلوک برای ماندن زیر اندازه مشخص‌شده به مبی‌بایت)

-reindex

در صورت فعال بودن، وضعیت زنجیره و نمایه بلوک‌ها پاک شده و از پرونده‌های blk*.dat روی دیسک بازسازی می‌شوند. همچنین سایر نمایه‌های اختیاری فعال نیز پاک و بازسازی می‌شوند. اگر یک اسنپ‌شات assumeutxo بارگذاری شده باشد، chainstate آن نیز پاک خواهد شد. اسنپ‌شات می‌تواند بعداً از طریق RPC بارگذاری مجدد شود.

-reindex-chainstate

در صورت فعال بودن، وضعیت زنجیره پاک شده و از پرونده‌های blk*.dat روی دیسک بازسازی می‌شود. در صورت بارگذاری اسنپ‌شات assumeutxo، chainstate آن نیز پاک خواهد شد. اسنپ‌شات می‌تواند بعداً از طریق RPC بارگذاری مجدد شود.

-settings=<file>

تعیین مسیر پرونده داده‌های تنظیمات پویا. با -nosettings قابل غیرفعال‌سازی است. پرونده در زمان اجرا نوشته می‌شود و نباید توسط کاربران ویرایش گردد (از bitcoin.conf برای تنظیمات دلخواه استفاده کنید). مسیرهای نسبی با پیشوند مکان datadir تکمیل می‌شوند. (پیش‌فرض: settings.json)

-shutdownnotify=<cmd>

اجرای فوری دستور پیش از آغاز خاموش‌سازی. نیاز به خاموشی ممکن است اضطراری باشد، بنابراین نباید اجرای آن طولانی شود (اگر دستور نیازی به تعامل با سرور ندارد، اجرای آن در پس‌زمینه را مد نظر قرار دهید).

-startupnotify=<cmd>

اجرای دستور در زمان راه‌اندازی.

-txindex

نگهداری یک نمایه کامل تراکنش‌ها، مورد استفاده در فراخوانی rpc دستور getrawtransaction (پیش‌فرض: 0)

-txospenderindex

نگهداری نمایه خرج‌کننده خروجی تراکنش، مورد استفاده در دستور rpc به نام gettxspendingprevout (پیش‌فرض: 0)

-version

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

گزینه‌های اتصال:

-addnode=<ip>

افزودن یک گره برای اتصال و تلاش جهت باز نگه داشتن اتصال (برای اطلاعات بیشتر راهنمای RPC دستور addnode را ببینید). این گزینه را می‌توان چندین بار برای افزودن چندین گره تکرار کرد؛ اتصالات در هر لحظه به ۸ عدد محدود هستند و جدا از سقف -maxconnections محاسبه می‌شوند.

-asmap=<file>

تعیین نگاشت asn مورد استفاده برای دسته‌بندی همتایان. مسیرهای نسبی با پیشوند مکان datadir ویژه هر شبکه تکمیل می‌شوند. در صورت ارائه آرگومان بولی (-asmap یا -asmap=1)، از داده‌های نگاشت تعبیه‌شده در فایل باینری استفاده خواهد شد.

-bantime=<n>

مدت زمان پیش‌فرض (به ثانیه) برای مسدودسازی‌های پیکربندی‌شده به صورت دستی (پیش‌فرض: 86400)

-bind=<addr>[:<port>][=onion]

اتصال به آدرس داده‌شده و گوش دادن دائمی به آن (پیش‌فرض: 0.0.0.0). برای IPv6 از ساختار [host]:port استفاده کنید. با افزودن =onion در انتها، هرگونه اتصال ورودی به آن آدرس و درگاه به عنوان اتصال ورودی تور (Tor) نشانه‌گذاری می‌شود (پیش‌فرض: 127.0.0.1:8334=onion، testnet3: 127.0.0.1:18334=onion، testnet4: 127.0.0.1:48334=onion، signet: 127.0.0.1:38334=onion، regtest: 127.0.0.1:18445=onion)

-cjdnsreachable

در صورت تنظیم، یعنی این میزبان برای CJDNS پیکربندی شده است (اتصال به آدرس‌های fc00::/8 ما را به شبکه CJDNS هدایت می‌کند، doc/cjdns.md را ببینید) (پیش‌فرض: 0)

-connect=<ip>

تنها به گره مشخص‌شده متصل شو؛ گزینه -noconnect اتصالات خودکار را غیرفعال می‌سازد (قواعد این همتا مشابه -addnode است). این گزینه را می‌توان چندین بار برای اتصال به چندین گره مشخص کرد.

-discover

شناسایی خودکار آدرس‌های IP خودی (پیش‌فرض: 1 در حالت گوش دادن و عدم وجود -externalip یا -proxy)

-dns

اجازه جستجوی DNS برای -addnode، -seednode و -connect (پیش‌فرض: 1)

-dnsseed

درخواست آدرس همتایان از طریق DNS lookup در صورت کمبود آدرس‌ها (پیش‌فرض: 1 مگر اینکه -connect استفاده شده باشد یا -maxconnections=0)

-externalip=<ip>

تعیین آدرس عمومی خود

-fixedseeds

اجازه استفاده از گره‌های بذری ثابت (fixed seeds) در صورت عدم ارائه همتا از سوی دانه‌های DNS (پیش‌فرض: 1)

-forcednsseed

همواره آدرس‌های همتایان از طریق پرس‌وجوی DNS دریافت شود (پیش‌فرض: 0)

-i2pacceptincoming

پذیرش اتصالات ورودی I2P (پیش‌فرض: 1). در صورت عدم تنظیم -i2psam نادیده گرفته می‌شود. گوش دادن به اتصالات ورودی I2P از طریق پراکسی SAM انجام می‌شود، نه با اتصال به آدرس و پورت محلی.

-i2psam=<ip:port>

پراکسی I2P SAM برای دسترسی به همتایان I2P و پذیرش اتصالات I2P

-listen

پذیرش اتصالات از خارج (پیش‌فرض: 1 در صورت عدم وجود -proxy، -connect یا -maxconnections=0)

-listenonion

ایجاد خودکار سرویس پیازی تور (Tor onion service) (پیش‌فرض: 1)

-maxconnections=<n>

حفظ حداکثر <n> اتصال خودکار به همتایان (پیش‌فرض: 125). این محدودیت برای اتصالاتی که به صورت دستی از طریق -addnode یا دستور RPC مربوطه اضافه شده‌اند اعمال نمی‌شود (که محدودیت جداگانه ۸ دارند). همچنین برای اتصالات موقت انتشار خصوصی نیز اعمال نمی‌شود (که محدودیت جداگانه ۶۴ دارند).

-maxreceivebuffer=<n>

حداکثر بافر دریافت به ازای هر اتصال، <n>*1000 بایت (پیش‌فرض: 5000)

-maxsendbuffer=<n>

حداکثر مصرف حافظه به ازای هر اتصال برای بافر ارسال، <n>*1000 بایت (پیش‌فرض: 1000)

-maxuploadtarget=<n>

تلاش برای نگه داشتن ترافیک خروجی زیر میزان هدف در هر ۲۴ ساعت. این محدودیت برای همتایان دارای مجوز 'download' یا بلوک‌های ایجادشده در یک هفته گذشته اعمال نمی‌شود. 0 = بدون محدودیت (پیش‌فرض: 0M). پسوندهای اختیاری واحد [k|K|m|M|g|G|t|T] (پیش‌فرض: M). حروف کوچک بر مبنای 1000 و حروف بزرگ بر مبنای 1024 هستند.

-natpmp

استفاده از PCP یا NAT-PMP برای نگاشت درگاه شنود (پیش‌فرض: 1)

-networkactive

فعال‌سازی تمام فعالیت‌های شبکه P2P (پیش‌فرض: 1). با دستور RPC به نام setnetworkactive قابل تغییر است.

-onion=<ip:port|path>

استفاده از پراکسی SOCKS5 جداگانه برای دسترسی به همتایان از طریق سرویس‌های پیازی Tor؛ تنظیم -noonion برای غیرفعال کردن (پیش‌فرض: -proxy). می‌تواند مسیر فایل محلی با پیشوند 'unix:' باشد.

-onlynet=<net>

برقراری اتصالات خروجی خودکار تنها به شبکه <net> (ipv4، ipv6، onion، i2p، cjdns). اتصالات ورودی و دستی تحت تأثیر این گزینه قرار نمی‌گیرند. می‌تواند چندین بار برای شبکه‌های متعدد مشخص شود.

-peerblockfilters

ارائه فیلترهای بلوک فشرده به همتایان مطابق با BIP 157 (پیش‌فرض: 0)

-peerbloomfilters

پشتیبانی از فیلتر کردن بلوک‌ها و تراکنش با فیلترهای بلوم (پیش‌فرض: 0)

-port=<port>

گوش دادن به اتصالات روی درگاه <port> (پیش‌فرض: 8333، testnet3: 18333، testnet4: 48333، signet: 38333، regtest: 18444). برای I2P مرتبط نیست (doc/i2p.md را ببینید). اگر روی مقدار x تنظیم شود، درگاه شنود پیازی پیش‌فرض روی x+1 تنظیم خواهد شد.

-proxy=<ip>[:<port>]|unix:<path>[=<network>]

اتصال از طریق پراکسی SOCKS5، تنظیم -noproxy برای غیرفعال‌سازی. در صورت پشتیبانی پراکسی می‌تواند مسیر فایل محلی با پیشوند 'unix:' باشد. می‌تواند به =network ختم شود تا پراکسی فقط برای آن شبکه تنظیم گردد. شبکه می‌تواند هر یک از موارد ipv4، ipv6، tor یا cjdns باشد. (پیش‌فرض: غیرفعال)

-proxyrandomize

تصادفی‌سازی اطلاعات کاربری برای هر اتصال پراکسی. این گزینه جداسازی جریان Tor را فعال می‌کند (پیش‌فرض: 1)

-seednode=<ip>

اتصال به یک گره برای دریافت آدرس‌های همتایان، و سپس قطع ارتباط. این گزینه را می‌توان چندین بار مشخص کرد. هنگام راه‌اندازی، گره‌های بذری قبل از dnsseeds امتحان می‌شوند.

-timeout=<n>

تعیین مهلت زمانی اتصال سوکت به میلی‌ثانیه. اگر تلاش اولیه برای اتصال پس از این مدت ناموفق بود، لغو می‌شود (حداقل: 1، پیش‌فرض: 5000)

-torcontrol=<ip>:<port>

میزبان و درگاه کنترل Tor در صورت فعال بودن شنود پیازی (پیش‌فرض: 127.0.0.1:9051). در صورت عدم تعیین، درگاه پیش‌فرض 9051 استفاده خواهد شد.

-torpassword=<pass>

گذرواژه درگاه کنترل Tor (پیش‌فرض: خالی)

-v2transport

پشتیبانی از پروتکل انتقال نسخه ۲ (v2 transport) (پیش‌فرض: 1)

-whitebind=<[permissions@]addr>

اتصال به آدرس داده‌شده و افزودن پرچم‌های مجوز به همتایانی که به آن متصل می‌شوند. برای IPv6 از ساختار [host]:port استفاده کنید. مجوزهای مجاز: bloomfilter (اجازه درخواست بلوک‌ها و تراکنش‌های فیلترشده با BIP37)، noban (عدم مسدودسازی به دلیل رفتار نامناسب؛ متضمن download)، forcerelay (بازنشر تراکنش‌هایی که از قبل در mempool هستند؛ متضمن relay)، relay (بازنشر حتی در حالت -blocksonly، و اعلان‌های نامحدود تراکنش)، mempool (اجازه درخواست محتویات mempool تحت BIP35)، download (اجازه getheaders در حین IBD، بدون قطع اتصال پس از سقف maxuploadtarget)، addr (پاسخ‌ها به GETADDR کش را دور زده و حاوی رکوردهای تصادفی با به‌روزترین اطلاعات هستند). چند مجوز را با کاما جدا کنید (پیش‌فرض: download,noban,mempool,relay). قابل تکرار است.

-whitelist=<[permissions@]IP address or network>

افزودن پرچم‌های مجوز به همتایانی که از آدرس IP مشخص (مانند 1.2.3.4) یا شبکه با نشانه‌گذاری CIDR (مانند 1.2.3.0/24) استفاده می‌کنند. از همان مجوزهای -whitebind استفاده می‌کند. پرچم‌های اضافی "in" و "out" کنترل می‌کنند که آیا مجوزها برای اتصالات ورودی اعمال شوند یا اتصالات دستی (پیش‌فرض: فقط ورودی). قابل تکرار است.

گزینه‌های کیف پول:

-addresstype

نوع آدرس‌های مورد استفاده ("legacy"، "p2sh-segwit"، "bech32"، "bech32m"، پیش‌فرض: "bech32")

-avoidpartialspends

گروه‌بندی خروجی‌ها بر اساس آدرس، انتخاب چندتایی (احتمالاً همه) یا هیچ‌کدام، به جای انتخاب مجزا برای هر خروجی. حریم خصوصی بهبود می‌یابد زیرا نشانی‌ها بیشتر با تراکنش‌های کمتر پاکسازی می‌شوند و خروجی‌ها در آدرس‌های باقی‌مانده تمیز تجمیع می‌گردند. ممکن است به دلیل انتخاب سکه با بهینگی کمتر ناشی از این محدودیت افزوده و احتمالاً استفاده از ورودی‌های بیشتر از حد نیاز، منجر به کارمزد بالاتر شود. همیشه برای کیف‌های دارای "avoid_reuse" فعال است، در غیر این صورت پیش‌فرض: 0.

-changetype

نوع آدرس باقی‌مانده (change) مورد استفاده ("legacy"، "p2sh-segwit"، "bech32"، "bech32m"). پیش‌فرض در صورت -addresstype=legacy برابر با "legacy" است، در غیر این صورت جزئیات پیاده‌سازی است.

-consolidatefeerate=<amt>

حداکثر نرخ کارمزد (به BTC/kvB) که در آن ساخت تراکنش می‌تواند از ورودی‌های بیشتری نسبت به حداقل لازم استفاده کند تا استخر UTXO کیف پول کاهش یابد (پیش‌فرض: 0.0001).

-disablewallet

عدم بارگذاری کیف پول و غیرفعال‌سازی فراخوانی‌های RPC مربوط به کیف پول

-discardfee=<amt>

نرخ کارمزد (به BTC/kvB) که نشان‌دهنده آستانه تحمل شما برای صرف‌نظر از پول خرد باقی‌مانده با افزودن آن به کارمزد است (پیش‌فرض: 0.0001). نکته: یک خروجی در صورتی که با این نرخ خاک (dust) باشد دور ریخته می‌شود، اما ما همیشه تا سقف نرخ کارمزد بازنشر خاک دور می‌ریزیم و کارمزد دورریز بالاتر از آن با تخمین کارمزد برای طولانی‌ترین هدف محدود می‌شود.

-fallbackfee=<amt>

نرخ کارمزدی (به BTC/kvB) که در صورت عدم وجود داده کافی برای برآورد کارمزد استفاده خواهد شد. مقدار 0 ویژگی fallbackfee را به طور کامل غیرفعال می‌کند. (پیش‌فرض: 0.00)

-keypool=<n>

تنظیم اندازه استخر کلید روی <n> (پیش‌فرض: 1000). هشدار: اندازه‌های کوچک‌تر ممکن است در صورت عدم استفاده از هیچ‌یک از آدرس‌های استخر کلید اصلی، خطر از دست رفتن دارایی را هنگام بازیابی از نسخه پشتیبان قدیمی افزایش دهند.

-maxapsfee=<n>

پرداخت تا این مقدار کارمزد اضافی (مطلق) (به BTC) در صورتی که امکان استفاده از اجتناب از خرج ناقص را فراهم کند (پیش‌فرض: 0.00)

-mintxfee=<amt>

نرخ‌های کارمزد (به BTC/kvB) کمتر از این مقدار برای ایجاد تراکنش بدون کارمزد در نظر گرفته می‌شوند (پیش‌فرض: 0.00001)

-signer=<cmd>

ابزار امضای خارجی، doc/external-signer.md را ببینید

-spendzeroconfchange

خرج کردن پول خرد تأییدنشده هنگام ارسال تراکنش‌ها (پیش‌فرض: 1)

-txconfirmtarget=<n>

در نظر گرفتن کارمزد کافی تا تأیید تراکنش‌ها به طور میانگین ظرف n بلوک آغاز شود (پیش‌فرض: 6)

-wallet=<path>

تعیین مسیر کیف پول برای بارگذاری در زمان راه‌اندازی. می‌تواند چندین بار برای بارگذاری چندین کیف پول استفاده شود. مسیر به یک دایرکتوری حاوی داده‌های کیف پول و پرونده‌های گزارش اشاره دارد. اگر مسیر مطلق نباشد، نسبی نسبت به <walletdir> تفسیر می‌شود. این گزینه تنها کیف‌های پول موجود را بارگذاری می‌کند و کیف جدیدی نمی‌سازد. برای سازگاری رو به عقب، این گزینه نام پرونده‌های داده موجود در بالاترین سطح <walletdir> را نیز می‌پذیرد.

-walletbroadcast

انتشار تراکنش‌ها توسط کیف پول (پیش‌فرض: 1)

-walletdir=<dir>

تعیین دایرکتوری نگهداری کیف‌های پول (پیش‌فرض: <datadir>/wallets در صورت وجود، در غیر این صورت <datadir>)

-walletnotify=<cmd>

اجرای دستور هنگام تغییر یک تراکنش در کیف پول. %s در دستور با TxID، %w با نام کیف پول، %b با هش بلوک حاوی تراکنش (در صورت تأیید نشدن با 'unconfirmed') و %h با ارتفاع بلوک (-1 در صورت تأیید نشدن) جایگزین می‌شوند. %w در حال حاضر در ویندوز پیاده‌سازی نشده است. در سیستم‌هایی که %w پشتیبانی می‌شود، نباید درون علامت نقل‌قول قرار گیرد زیرا این کار به اسکیپ شل مورد استفاده برای فراخوانی دستور آسیب می‌زند.

-walletrbf

ارسال تراکنش‌ها با قابلیت جایگزینی با کارمزد (full-RBF opt-in) فعال (فقط RPC، پیش‌فرض: 1)

گزینه‌های اعلان ZeroMQ:

-zmqpubhashblock=<address>

فعال‌سازی انتشار هش بلوک در <address>

-zmqpubhashblockhwm=<n>

تنظیم حد آستانه بالای پیام خروجی (high water mark) برای انتشار هش بلوک (پیش‌فرض: 1000)

-zmqpubhashtx=<address>

فعال‌سازی انتشار هش تراکنش در <address>

-zmqpubhashtxhwm=<n>

تنظیم حد آستانه بالای پیام خروجی برای انتشار هش تراکنش (پیش‌فرض: 1000)

-zmqpubrawblock=<address>

فعال‌سازی انتشار بلوک خام در <address>

-zmqpubrawblockhwm=<n>

تنظیم حد آستانه بالای پیام خروجی برای انتشار بلوک خام (پیش‌فرض: 1000)

-zmqpubrawtx=<address>

فعال‌سازی انتشار تراکنش خام در <address>

-zmqpubrawtxhwm=<n>

تنظیم حد آستانه بالای پیام خروجی برای انتشار تراکنش خام (پیش‌فرض: 1000)

-zmqpubsequence=<address>

فعال‌سازی انتشار توالی هش بلوک و تراکنش در <address>

-zmqpubsequencehwm=<n>

تنظیم حد آستانه بالای پیام خروجی برای توالی انتشار هش (پیش‌فرض: 1000)

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

-debug=<category>

خروجی گزارش اشکال‌زدایی و ردگیری (پیش‌فرض: -nodebug، ارائه <category> اختیاری است). اگر <category> ارائه نشود یا 1 یا "all" باشد، تمامی لاگ‌های اشکال‌زدایی چاپ می‌شوند. در صورت 0 یا "none"، سایر دسته‌ها نادیده گرفته می‌شوند. مقادیر معتبر دیگر برای <category> عبارتند از: addrman، bench، blockstorage، cmpctblock، coindb، estimatefee، http، i2p، ipc، kernel، leveldb، libevent، mempool، mempoolrej، net، privatebroadcast، proxy، prune، qt، rand، reindex، rpc، scan، selectcoins، tor، txpackages، txreconciliation، validation، walletdb، zmq. این گزینه می‌تواند چندین بار برای نمایش چند دسته مشخص شود.

-debugexclude=<category>

استثنا کردن لاگ اشکال‌زدایی و ردگیری برای یک دسته خاص. می‌تواند همراه با -debug=1 برای خروجی لاگ‌های اشکال‌زدایی تمام دسته‌ها به‌جز دسته مشخص‌شده استفاده شود. این گزینه می‌تواند چندین بار تکرار شود. اولویت این گزینه بر "-debug" ارجح است.

-help-debug

چاپ پیام راهنما همراه با گزینه‌های اشکال‌زدایی و خروج

-logips

درج آدرس‌های IP در خروجی لاگ (پیش‌فرض: 0)

-loglevelalways

همواره یک دسته و سطح به ابتدای لاگ اضافه شود (پیش‌فرض: 0)

-logsourcelocations

افزودن نام مکان کد منبع مبدأ (پرونده سورس، شماره خط و نام تابع) به ابتدای خروجی اشکال‌زدایی (پیش‌فرض: 0)

-logthreadnames

افزودن نام ریسمان مبدأ به ابتدای خروجی اشکال‌زدایی (پیش‌فرض: 0)

-logtimestamps

افزودن مهر زمانی به ابتدای خروجی اشکال‌زدایی (پیش‌فرض: 1)

-maxtxfee=<amt>

حداکثر کارمزد کل (به BTC) برای استفاده در یک تراکنش منفرد کیف پول؛ تنظیم بیش از حد کم این گزینه ممکن است باعث لغو تراکنش‌های بزرگ شود (پیش‌فرض: 0.10)

-printtoconsole

ارسال اطلاعات ردگیری/اشکال‌زدایی به کنسول (پیش‌فرض: 1 در صورت عدم وجود -daemon. برای غیرفعال کردن لاگ در پرونده، -nodebuglogfile را تنظیم کنید)

-shrinkdebugfile

کوچک‌سازی پرونده debug.log در زمان راه‌اندازی کلاینت (پیش‌فرض: 1 در صورت عدم وجود -debug)

-uacomment=<cmt>

افزودن نظر به رشته User Agent

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

-chain=<chain>

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

-signet

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

-signetchallenge

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

-signetseednode

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

-testnet

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

-testnet4

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

گزینه‌های بازنشر گره:

-bytespersigop

بایت‌های معادل به ازای هر sigop در تراکنش‌ها برای بازنشر و استخراج (پیش‌فرض: 20)

-datacarrier

بازنشر و استخراج تراکنش‌های حامل داده (پیش‌فرض: 1)

-datacarriersize

بازنشر و استخراج تراکنش‌هایی که scriptPubKey داده‌دار خام آن‌ها در مجموع از این اندازه کمتر یا مساوی باشد، با اجازه خروجی‌های چندگانه (پیش‌فرض: 100000)

-minrelaytxfee=<amt>

کارمزدهای (به BTC/kvB) کمتر از این مقدار برای بازنشر، استخراج و ساخت تراکنش بدون کارمزد محسوب می‌شوند (پیش‌فرض: 0.000001)

-permitbaremultisig

بازنشر تراکنش‌هایی که خروجی‌های چندامضایی غیراز P2SH می‌سازند (پیش‌فرض: 1)

-privatebroadcast

انتشار تراکنش‌های ارسال‌شده از طریق دستور RPC به نام sendrawtransaction با استفاده از اتصالات کوتاه‌مدت از طریق شبکه‌های Tor یا I2P، بدون قرار دادن اولیه در mempool. تراکنش‌های ارسالی از طریق کیف پول تحت تأثیر این گزینه قرار نمی‌گیرند (پیش‌فرض: 0)

-whitelistforcerelay

افزودن مجوز 'forcerelay' به همتایان موجود در فهرست سفید با مجوزهای پیش‌فرض. این گزینه باعث بازنشر تراکنش‌ها حتی در صورت وجود قبلی در mempool می‌شود. (پیش‌فرض: 0)

-whitelistrelay

افزودن مجوز 'relay' به همتایان موجود در فهرست سفید با مجوزهای پیش‌فرض. این گزینه باعث پذیرش تراکنش‌های بازنشرشده حتی در صورت عدم بازنشر تراکنش‌ها می‌شود (پیش‌فرض: 1)

گزینه‌های ساخت بلوک:

-blockmintxfee=<amt>

تنظیم کمترین نرخ کارمزد (به BTC/kvB) برای گنجاندن تراکنش‌ها در ساخت بلوک (پیش‌فرض: 0.00000001)

-blockreservedweight=<n>

رزرو فضا برای سرآیند بلوک با اندازه ثابت به‌علاوه بزرگترین تراکنش coinbase که نرم‌افزار استخراج ممکن است به بلوک بیفزاید. تنها بر کلاینت‌های RPC استخراج تأثیر می‌گذارد، نه کلاینت‌های IPC. (پیش‌فرض: 8000).

گزینه‌های کارساز RPC:

-rest

پذیرش درخواست‌های عمومی REST (پیش‌فرض: 0)

-rpcallowip=<ip>

اجازه اتصالات JSON-RPC از مبدأ مشخص‌شده. مقادیر معتبر برای <ip> عبارتند از یک IP منفرد (مانند 1.2.3.4)، شبکه/نت‌ماسک (مانند 1.2.3.4/255.255.255.0)، شبکه/CIDR (مانند 1.2.3.4/24)، تمام ipv4 (0.0.0.0/0)، یا تمام ipv6 (::/0). مقدار RFC4193 تنها در صورتی مجاز است که -cjdnsreachable=0 باشد. این گزینه می‌تواند چندین بار مشخص شود.

-rpcauth=<userpw>

نام کاربری و گذرواژه هش‌شده با HMAC-SHA-256 برای اتصالات JSON-RPC. فیلد <userpw> به قالب <USERNAME>:<SALT>$<HASH> است. یک اسکریپت رسمی پایتون در share/rpcauth قرار دارد. کلاینت سپس به صورت عادی با استفاده از جفت آرگومان‌های rpcuser=<USERNAME>/rpcpassword=<PASSWORD> متصل می‌شود. این گزینه می‌تواند چندین بار مشخص شود.

-rpcbind=<addr>[:port]

اتصال به نشانی داده‌شده برای شنود اتصالات JSON-RPC. کارساز RPC را در معرض شبکه‌های غیرقابل اعتماد مانند اینترنت عمومی قرار ندهید! این گزینه نادیده گرفته می‌شود مگر اینکه -rpcallowip نیز ارسال شده باشد. درگاه اختیاری است و -rpcport را بازنویسی می‌کند. برای IPv6 از ساختار [host]:port استفاده کنید. این گزینه می‌تواند چندین بار مشخص شود (پیش‌فرض: 127.0.0.1 و ::1 یعنی localhost)

-rpccookiefile=<loc>

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

-rpccookieperms=<readable-by>

تنظیم دسترسی‌ها روی پرونده کوکی احراز هویت RPC تا توسط [owner|group|all] قابل خواندن باشد (پیش‌فرض: owner [از طریق umask 0077])

-rpcpassword=<pw>

گذرواژه برای اتصالات JSON-RPC

-rpcport=<port>

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

-rpcthreads=<n>

تنظیم تعداد ریسمان‌ها برای سرویس‌دهی به فراخوانی‌های RPC (پیش‌فرض: 16)

-rpcuser=<user>

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

-rpcwhitelist=<whitelist>

تنظیم فهرست سفید برای فیلتر کردن فراخوانی‌های RPC ورودی برای یک کاربر خاص. فیلد <whitelist> به قالب <USERNAME>:<rpc 1>,<rpc 2>,...,<rpc n> است. اگر چند فهرست سفید برای یک کاربر مشخص تعریف شده باشد، اشتراک آن‌ها در نظر گرفته می‌شود. برای اطلاعات درباره رفتار پیش‌فرض فهرست سفید، مستندات -rpcwhitelistdefault را ببینید.

-rpcwhitelistdefault

تنظیم رفتار پیش‌فرض برای فهرست سفید rpc. مگر اینکه rpcwhitelistdefault برابر با 0 تنظیم شده باشد، اگر هرگونه -rpcwhitelist تنظیم شود، کارساز rpc به گونه‌ای عمل می‌کند که گویی همه کاربران rpc مشمول فهرست‌های سفید «خالی مگر در صورت تعیین خلاف آن» هستند. اگر rpcwhitelistdefault برابر با 1 تنظیم شده باشد و هیچ -rpcwhitelist تنظیم نشده باشد، کارساز rpc به گونه‌ای عمل می‌کند که گویی همه کاربران rpc مشمول فهرست‌های سفید خالی هستند.

-server

پذیرش دستورات خط فرمان و دستورات JSON-RPC

گزینه‌های رابط کاربری (UI Options):

-choosedatadir

انتخاب دایرکتوری داده در هنگام راه‌اندازی (پیش‌فرض: 0)

-lang=<lang>

تنظیم زبان، به عنوان مثال "de_DE" (پیش‌فرض: زبان محلی سیستم)

-min

شروع برنامه به صورت کمینه‌شده (minimized)

-resetguisettings

بازنشانی تمام تنظیمات تغییریافته در واسط گرافیکی کاربر (GUI)

-splash

نمایش صفحه تصویر آغازین (splash) در هنگام راه‌اندازی (پیش‌فرض: 1)

حق نشر (C) 2009-2026 توسعه‌دهندگان Bitcoin Core

لطفاً در صورتی که بیت‌کوین کور را مفید می‌دانید در توسعه آن مشارکت نمایید. برای اطلاعات بیشتر درباره نرم‌افزار به 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-qt v31.1.0