نام (NAME)

bitcoind - دیمن و کارساز شبکه بیت‌کوین کور (Bitcoin Core)

خلاصه دستور (SYNOPSIS)

bitcoind [options]

توضیحات (DESCRIPTION)

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

دیمن بیت‌کوین کور (bitcoind) یک برنامه بدون رابط گرافیکی (headless) است که برای اعتبارسنجی و بازپخش تراکنش‌ها و بلوک‌ها و همچنین بازپخش آدرس‌ها به شبکه بیت‌کوین متصل می‌شود.

این برنامه ستون فقرات شبکه بیت‌کوین را فراهم می‌آورد و سرویس‌های RPC، REST و ZMQ آن می‌توانند خدمات گوناگون مربوط به تراکنش‌ها، بلوک‌ها و نشانی‌ها را ارائه دهند.

یک مؤلفه اختیاری کیف پول نیز وجود دارد که خدمات تراکنشی را فراهم می‌کند.

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

گزینه‌ها (OPTIONS)

-alertnotify=<cmd>

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

-allowignoredconf

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

-assumevalid=<hex>

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

-blockfilterindex=<type>

نگهداری یک نمایه (index) از فیلترهای فشرده بر اساس بلوک (پیش‌فرض: 0، مقادیر: basic). اگر <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>

حداکثر اندازه حافظه موقت (کش) پایگاه داده به مگابایت (حداقل 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 آن نیز پاک خواهد شد.

-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" کنترل می‌کنند که آیا مجوزها برای اتصالات ورودی اعمال شوند یا اتصالات دستی (پیش‌فرض: فقط ورودی). قابل تکرار است.

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

-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).

-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> تفسیر می‌شود. این گزینه تنها کیف‌های پول موجود را بارگذاری می‌کند و کیف جدید نمی‌سازد.

-walletbroadcast

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

-walletdir=<dir>

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

-walletnotify=<cmd>

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

-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)

گزینه‌های اشکال‌زدایی و آزمایش (Debugging/Testing):

-debug=<category>

خروجی گزارش اشکال‌زدایی و ردگیری (پیش‌فرض: -nodebug، ارائه <category> اختیاری است). اگر دسته‌ای ارائه نشود یا 1 یا "all" باشد، تمامی لاگ‌ها چاپ می‌شوند. در صورت 0 یا "none"، سایر دسته‌ها نادیده گرفته می‌شوند. مقادیر معتبر دیگر عبارتند از: 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 selection):

-chain=<chain>

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

-signet

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

-signetchallenge

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

-signetseednode

تعیین یک گره بذری برای شبکه signet، در قالب hostname[:port]، مانند sig.net:1234

-testnet

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

-testnet4

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

گزینه‌های بازنشر گره (Node relay):

-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' به همتایان موجود در فهرست سفید با مجوزهای پیش‌فرض (پیش‌فرض: 0)

-whitelistrelay

افزودن مجوز 'relay' به همتایان موجود در فهرست سفید با مجوزهای پیش‌فرض (پیش‌فرض: 1)

گزینه‌های ساخت بلوک (Block creation):

-blockmintxfee=<amt>

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

-blockreservedweight=<n>

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

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

-rest

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

-rpcallowip=<ip>

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

-rpcauth=<userpw>

نام کاربری و گذرواژه هش‌شده با HMAC-SHA-256 برای اتصالات JSON-RPC به قالب <USERNAME>:<SALT>$<HASH>. این گزینه می‌تواند چندین بار تکرار شود.

-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 ورودی برای یک کاربر خاص به قالب: <USERNAME>:<rpc 1>,<rpc 2>,...,<rpc n>.

-rpcwhitelistdefault

تنظیم رفتار پیش‌فرض برای فهرست سفید rpc.

-server

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

حق نشر (COPYRIGHT)

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

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

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

همچنین ببینید (SEE ALSO)

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