| BITCOIN-TX(1) | User Commands | BITCOIN-TX(1) |
نام (NAME)
bitcoin-tx - ابزار ایجاد و دستکاری تراکنشهای خام بیتکوین
خلاصه دستور (SYNOPSIS)
bitcoin-tx [options] <hex-tx>
[commands]
bitcoin-tx [options] -create [commands]
توضیحات (DESCRIPTION)
ابزار کمکی bitcoin-tx بیتکوین کور نگارش v31.1.0
ابزار bitcoin-tx برای ایجاد و اصلاح تراکنشهای بیتکوین استفاده میشود.
دستور bitcoin-tx میتواند با "<hex-tx> [commands]" برای بهروزرسانی یک تراکنش کدگذاریشده به صورت هگز (hex-encoded) بیتکوین، یا با "-create [commands]" برای ایجاد یک تراکنش کدگذاریشده به صورت هگز استفاده شود.
گزینهها (OPTIONS)
-create
- ایجاد یک TX (تراکنش) خالی و جدید.
-help
- چاپ این پیام راهنما و خروج (همچنین -h یا -?)
-json
- انتخاب خروجی JSON
-txid
- خروجی دادن تنها شناسه تراکنش (txid) با کدگذاری هگز از تراکنش حاصل.
-version
- چاپ نسخه و خروج
گزینههای اشکالزدایی/آزمایش:
گزینههای انتخاب زنجیره:
-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.
دستورها:
- delin=N
- حذف ورودی N از TX
- delout=N
- حذف خروجی N از TX
- in=TXID:VOUT(:SEQUENCE_NUMBER)
- افزودن ورودی به TX
- locktime=N
- تنظیم زمان قفل (lock time) تراکنش بر روی N
- nversion=N
- تنظیم نسخه TX بر روی N
- outaddr=VALUE:ADDRESS
- افزودن خروجی مبتنی بر آدرس به TX
- outdata=[VALUE:]DATA
- افزودن خروجی مبتنی بر داده به TX
- outmultisig=VALUE:REQUIRED:PUBKEYS:PUBKEY1:PUBKEY2:....[:FLAGS]
- افزودن خروجی چندامضایی چند-از-چند (Pay To n-of-m Multi-sig) به TX. در اینجا n = REQUIRED و m = PUBKEYS است. به صورت اختیاری فلگ "W" را برای ایجاد یک خروجی pay-to-witness-script-hash اضافه کنید. به صورت اختیاری فلگ "S" را برای قرار دادن خروجی در یک pay-to-script-hash اضافه کنید.
- outpubkey=VALUE:PUBKEY[:FLAGS]
- افزودن خروجی pay-to-pubkey به TX. به صورت اختیاری فلگ "W" را برای ایجاد یک خروجی pay-to-witness-pubkey-hash اضافه کنید. به صورت اختیاری فلگ "S" را برای قرار دادن خروجی در یک pay-to-script-hash اضافه کنید.
- outscript=VALUE:SCRIPT[:FLAGS]
- افزودن خروجی اسکریپت خام به TX. به صورت اختیاری فلگ "W" را برای ایجاد یک خروجی pay-to-witness-script-hash اضافه کنید. به صورت اختیاری فلگ "S" را برای قرار دادن خروجی در یک pay-to-script-hash اضافه کنید.
- replaceable(=N)
- تنظیم شماره توالی انتخاب اختیاریِ جایگزینی با کارمزد (Replace-By-Fee یا RBF) برای ورودی N. اگر N ارائه نشود، دستور تلاش میکند تا تمام ورودیهای موجود را برای RBF فعال کند. اگر تراکنش هیچ ورودیای نداشته باشد، این گزینه نادیده گرفته میشود.
- sign=SIGHASH-FLAGS
- افزودن صفر یا چند امضا به تراکنش. این دستور نیازمند ثباتهای JSON است: prevtxs=JSON object، privatekeys=JSON object. برای اطلاع از قالب فلگهای sighash و اشیاء JSON، به مستندات signrawtransactionwithkey مراجعه کنید.
دستورهای ثبات (Register Commands):
- load=NAME:FILENAME
- بارگذاری فایل JSON با نام FILENAME در ثبات NAME
- set=NAME:JSON-STRING
- تنظیم ثبات NAME با مقدار JSON-STRING دادهشده
کپیرایت (COPYRIGHT)
حق نشر (C) ۲۰۰۹-۲۰۲۶ توسعهدهندگان هسته بیتکوین (The Bitcoin Core developers)
اگر بیتکوین کور را مفید میدانید لطفاً مشارکت کنید. برای اطلاعات بیشتر درباره نرمافزار به 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)
| July 2026 | bitcoin-tx v31.1.0 |