Wallet

يمكن أن تُرسم العملات الفردية بمحتوى تعسفي، مما يُنشئ قطع فنية رقمية متناسبة مع بيتكوين يمكن الاحتفاظ بها في محفظة بيتكوين ونقلها باستخدام المعاملات المالية في بيتكوين. إن النقوش متينة وثابتة وآمنة ولامركزية تمامًا مثل بيتكوين نفسه.

العمل مع الأنسكريبشين يتطلب وجود نود بيتكوين كاملة لمنحك نظرة على الحالة الحالية لسلسلة كتل بيتكوين، ومحفظة قادرة على إنشاء الأنسكريبشين وأداء التحكم في العملات عند بناء المعاملات لإرسالها إلى محفظة أخرى.

توفر Bitcoin Core كل من نود بيتكوين كاملة ومحفظة. ومع ذلك، لا يمكن لمحفظة Bitcoin Core إنشاء النقوش ولا تؤدي إلى التحكم في العملات.

هذا يتطلب ord, وهو أداة ترتيبية. أورد لا تنفذ محفظة خاصة بها، لذا تفاعل أوامر محفظة أورد مع محافظ Bitcoin Core.

تشمل هذه الدليل الفقرات التالية:

تثبيت Bitcoin Core
مزامنة Bitcoin blockchain
إنشاء محفظة Bitcoin Core
استخدام ord wallet receive لاستقبال العملات
إنشاء الأنسكريبشين باستخدام ord wallet inscribe
إرسال الأنسكريبشين باستخدام ord wallet send
استقبال الأنسكريبشين باستخدام ord wallet receive
Batch inscribing with ord wallet inscribe --batch

الحصول على المساعدة

إذا واجهتك مشكلة، جرب أن تطلب المساعدة على الديسكورد ، أو تفقد موقعissues discussions GitHub للقضايا والمناقشات ذات الصلة.

تثبيت Bitcoin Core

يتوفر Bitcoin Core من موقع bitcoincore.org على صفحه التحميل.

Making inscriptions requires Bitcoin Core 28 or newer.

This guide does not cover installing Bitcoin Core in detail. Once Bitcoin Core is installed, you should be able to run bitcoind -version successfully from the command line. Do NOT use bitcoin-qt.

تهيئة Bitcoin Core

ord requires Bitcoin Core's transaction index and rest interface.

لتهيئة نود Bitcoin Core الخاص بك للحفاظ على فهرس المعاملات، أضف ما يلي إلى ملف bitcoin.conf الخاص بك:

txindex=1

Or, run bitcoind with -txindex:

bitcoind -txindex

Details on creating or modifying your bitcoin.conf file can be found here.

مزامنة شبكه البيتكوين

لبدء مزامنه السلسلة:

bitcoind -txindex

...واتركها تعمل حتى يتم استدعاء الأمر getblockcount:

bitcoin-cli getblockcount

يتم قبول عدد البلوكات من خلال المتصفح مثل the mempool.space block explorer.ال ord يتفاعل مع bitcoind لذالك يجب أن تبقي النود فعال بلخلفيه عند استعمالك له.

The blockchain takes about 600GB of disk space. If you have an external drive you want to store blocks on, use the configuration option blocksdir=<external_drive_path>. This is much simpler than using the datadir option because the cookie file will still be in the default location for bitcoin-cli and ord to find.

مشكلات وحلول

Make sure you can access bitcoind with bitcoin-cli -getinfo and that it is fully synced.

If bitcoin-cli -getinfo returns Could not connect to the server, bitcoind is not running.

Make sure rpcuser, rpcpassword, or rpcauth are NOT set in your bitcoin.conf file. ord requires using cookie authentication. Make sure there is a file .cookie in your bitcoin data directory.

If bitcoin-cli -getinfo returns Could not locate RPC credentials, then you must specify the cookie file location. If you are using a custom data directory (specifying the datadir option), then you must specify the cookie location like bitcoin-cli -rpccookiefile=<your_bitcoin_datadir>/.cookie -getinfo. When running ord you must specify the cookie file location with --cookie-file=<your_bitcoin_datadir>/.cookie.

Make sure you do NOT have disablewallet=1 in your bitcoin.conf file. If bitcoin-cli listwallets returns Method not found then the wallet is disabled and you won't be able to use ord.

Make sure txindex=1 is set. Run bitcoin-cli getindexinfo and it should return something like

{
  "txindex": {
    "synced": true,
    "best_block_height": 776546
  }
}

If it only returns {}, txindex is not set. If it returns "synced": false, bitcoind is still creating the txindex. Wait until "synced": true before using ord.

If you have maxuploadtarget set it can interfere with fetching blocks for ord index. Either remove it or set whitebind=127.0.0.1:8333.

تحميل برنامج أورد `ord`

أدوات ord مكتوبه بلغه الداست ويمكن بنائها منالمصدر.الثنائيات المبنية مسبقًا متوفرة على صفحه الإصدار.

يمكنك تحميل الثنائيات المبنية مسبقًا بإعطاء الأمر التالي:

curl --proto '=https' --tlsv1.2 -fsLS https://ordinals.com/install.sh | bash -s

بمجرد الانتهاء من تحميل ال ord، يجب أن تكون قادرًا على تشغيل:

ord --version

والذي يشير الى الإصدار ord الحالي.

Creating a Wallet

ord uses bitcoind to manage private keys, sign transactions, and broadcast transactions to the Bitcoin network. Additionally the ord wallet requires ord server running in the background. Make sure these programs are running:

bitcoind -txindex

ord server

To create a wallet named ord, the default, for use with ord wallet, run:

ord wallet create

This will print out your seed phrase mnemonic, store it somewhere safe.

{
  "mnemonic": "dignity buddy actor toast talk crisp city annual tourist orient similar federal",
  "passphrase": ""
}

If you want to specify a different name or use an ord server running on a non-default URL you can set these options:

ord wallet --name foo --server-url http://127.0.0.1:8080 create

To see all available wallet options you can run:

ord wallet help

Restoring and Dumping Wallet

The ord wallet uses descriptors, so you can export the output descriptors and import them into another descriptor-based wallet. To export the wallet descriptors, which include your private keys:

$ ord wallet dump
==========================================
= THIS STRING CONTAINS YOUR PRIVATE KEYS =
=        DO NOT SHARE WITH ANYONE        =
==========================================
{
  "wallet_name": "ord",
  "descriptors": [
    {
      "desc": "tr([551ac972/86'/1'/0']tprv8h4xBhrfZwX9o1XtUMmz92yNiGRYjF9B1vkvQ858aN1UQcACZNqN9nFzj3vrYPa4jdPMfw4ooMuNBfR4gcYm7LmhKZNTaF4etbN29Tj7UcH/0/*)#uxn94yt5",
      "timestamp": 1296688602,
      "active": true,
      "internal": false,
      "range": [
        0,
        999
      ],
      "next": 0
    },
    {
      "desc": "tr([551ac972/86'/1'/0']tprv8h4xBhrfZwX9o1XtUMmz92yNiGRYjF9B1vkvQ858aN1UQcACZNqN9nFzj3vrYPa4jdPMfw4ooMuNBfR4gcYm7LmhKZNTaF4etbN29Tj7UcH/1/*)#djkyg3mv",
      "timestamp": 1296688602,
      "active": true,
      "internal": true,
      "range": [
        0,
        999
      ],
      "next": 0
    }
  ]
}

An ord wallet can be restored from a mnemonic:

ord wallet restore --from mnemonic

Type your mnemonic and press return.

To restore from a descriptor in descriptor.json:

cat descriptor.json | ord wallet restore --from descriptor

To restore from a descriptor in the clipboard:

ord wallet restore --from descriptor

Paste the descriptor into the terminal and press CTRL-D on unix and CTRL-Z on Windows.

استقبال الساتس

يتم إنشاء الأنسكريبشين على الساتوشيات فردية باستخدام معاملات بيتكوين العادية التي تدفع الرسوم بوحدات الساتوشي، لذا ستحتاج محفظتك إلى بعض الساتوشيات.

إحصل على عنوان جديد من محفظة ال ord من خلال الأمر التالي:

ord wallet receive

وأرسل لها بعض التمويل.

يمكنك رؤية المعاملات المعلقة بالأمر التالي:

ord wallet transactions

بمجرد تأكيد الصفقة، يجب أن تكون قادرًا على رؤية المعاملات من خلال ord wallet outputs.

إنشاء محتوى إنسكريبشين

يمكن إنسكرايب الساتوشيات بأي نوع من المحتوى، ولكن محفظة ord تدعم فقط أنواع المحتوى التي يمكن عرضها عبر مستكشف الكتل ord.

بالإضافة إلى ذلك، تُدرج الإنسكريبشين في المعاملات، لذلك كلما زاد حجم المحتوى، زادت الرسوم التي يجب دفعها لعملية الإنسكريبشين .

يتم تضمين محتوى الإنسكريبشين في شهادات المعاملات، والتي تحصل على الشاهد. لحساب الرسوم التقريبية التي ستدفعها معاملة الإنسكريبشين ، قسم حجم المحتوى على أربعة ثم اضرب الناتج بمعدل الرسوم.

يجب أن تكون المعاملات أقل من 400,000 وحدة وزنية، وإلا فلن يتم نقلها بواسطة بيتكوين كور. بايت واحد من المحتوى يكلف وحدة وزنية واحدة. نظرًا لأن المعاملات لا تشمل فقط المحتوى ، يجب تقييد محتوى الإنسكريبشين لأقل من 400,000 وحدة وزنية. 390,000 وحدة وزنية يجب أن تكون آمنة وصحيحه.

إنشاء الإنسكريبشينس

لإنشاء الإنسكريبشين مع محتوى FILE , اعطي الأمر:

ord wallet inscribe --fee-rate FEE_RATE --file FILE

أورد سيقوم بإخراج رقمين معرّفين للمعاملات، واحد لمعاملة الالتزام، وآخر لمعاملة الكشف، وكذلك مُعرف إنسكريبشين . مُعرفات إنسكريبشين على الشكل TXIDiN، حيث TXID هو مُعرّف المعاملة لمعاملة الكشف، و N هو المؤشر الإنسكريبشين في معاملة الكشف.

تُؤكد معاملة الالتزام على tapscript يحتوي على محتوى الإنسكريبشين، وتقوم معاملة الكشف بإنفاق من هذا الـ tapscript، مكشفةً المحتوى على الشبكة وتسجيله على أول ساتوشي في المدخل الذي يحتوي على الـ tapscript المقابل.

إنتظر حتى يتم تعدين المعاملة. يمكنك التحقق منها من خلالthe mempool.space block explorer.

بمجرد أن يتم تعدين الصفقة (reveal transaction)، يجب أن يتم طباعة معرّف الإنسكريبشين (inscription ID) عند تشغيل الأمر:

ord wallet inscriptions

Parent-Child Inscriptions

Parent-child inscriptions enable what is colloquially known as collections, see provenance for more information.

To make an inscription a child of another, the parent inscription has to be inscribed and present in the wallet. To choose a parent run ord wallet inscriptions and copy the inscription id (<PARENT_INSCRIPTION_ID>).

Now inscribe the child inscription and specify the parent like so:

ord wallet inscribe --fee-rate FEE_RATE --parent <PARENT_INSCRIPTION_ID> --file CHILD_FILE

This relationship cannot be added retroactively, the parent has to be present at inception of the child.

إرسال الإنسكريبشينس

أطلب من المستلم إنشاء عنوان جديد عن طريق تشغيل:

ord wallet receive

أرسل الإنسكريبشين من خلال:

ord wallet send --fee-rate <FEE_RATE> <ADDRESS> <INSCRIPTION_ID>

تفقد حاله المعاملة من خلال:

ord wallet transactions

بمجرد تأكيد المعاملة المرسلة، يمكن للمستلم تأكيد الاستلام عن طريق الأمر :

ord wallet inscriptions

Sending Runes

أطلب من المستلم إنشاء عنوان جديد عن طريق تشغيل:

ord wallet receive

Send the runes by running:

ord wallet send --fee-rate <FEE_RATE> <ADDRESS> <RUNES_AMOUNT>

Where RUNES_AMOUNT is the number of runes to send, a : character, and the name of the rune. For example if you want to send 1000 of the EXAMPLE rune, you would use 1000:EXAMPLE.

ord wallet send --fee-rate 1 SOME_ADDRESS 1000:EXAMPLE

تفقد حاله المعاملة من خلال:

ord wallet transactions

Once the send transaction confirms, the recipient can confirm receipt with:

ord wallet balance

استقبال الإنسكريبشينس

قم بإنشاء عنوان استقبال جديد باستخدام:

ord wallet receive

يمكن للمرسل نقل الإنسكريبشين إلى عنوانك باستخدام:

ord wallet send --fee-rate <FEE_RATE> ADDRESS INSCRIPTION_ID

تفقد حاله المعاملة من خلال:

ord wallet transactions

Once the send transaction confirms, you can confirm receipt by running:

ord wallet inscriptions

Ordinal Theory Handbook