Giters

bulikos / bitcoin-ordinals-setup

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Bitcoin Ordinals

This document is extended guide to help you produce your first ordinal. I highly recommend to first browse the original ordinals handbook.

BitcoinCore

BitcoinCore is a Bitcoin node software, which is going to serve the requests from ord wallet. Let's start with installing and running BitcoinCore.

Install BitcoinCore

Download and install

  1. Make and enter directory for following actions.
  • mkdir my_folder and cd my_folder
  1. Download BitcoinCore tar archive.
  • curl -O https://bitcoincore.org/bin/bitcoin-core-24.0.1/bitcoin-24.0.1-x86_64-linux-gnu.tar.gz
  1. Unpack archive
  • tar xzf bitcoin-24.0.1-x86_64-linux-gnu.tar.gz
  1. Install. You may need sudo access (add sudo before the command).
  • install -m 0755 -o root -g root -t /usr/local/bin bitcoin-24.0.1/bin/*
  1. Verify instalation by succuessfully running.
  • bitcoind -version

Configure and run BitcoinCore

Here are two options, either setup a daemon running the program in background, or run the program directly in terminal window. The tx-index option used in both options will download all transactions (not only blocks) to local disk using the $HOME/.bitcoin direcotory, make sure to have at least +500GB of free space. Mentioned option is mandatory for ord wallet, as the wallet later based on this transactions builds index of satoshis. The rest option enables REST API calls.

  • Run daemon option:
    • Start daemon process - bitcoind -txindex -rest -daemon
    • To stop the daemon use bitcoin-cli stop
  • Run program directly option:
    • Start program bitcoind -txindex -rest.
    • To stop the program close the terminal or use CTRL+C keys.

Check status of syncing

After starting the BitcoinCore you can check status of synchronization (downloading all blocks and txs to your disk) with command bitcoin-cli getblockcount and bitcoin-cli getindexinfo, the numbers should within several hours match the current blockchain height (which can be found online).

Ord wallet

Once we have sucuessfully started and synced the Bitcoin node we can start working with ord wallet.

Install Ord and prepare wallet

  1. Download and install ord wallet
  • curl --proto '=https' --tlsv1.2 -fsLS https://ordinals.com/install.sh | bash -s
  1. Verifiy installation by priting ord version.
  • ord --version

  1. For those getting the Command 'ord' not found error. Navigate to bin folder inside your home directory - cd $HOME/bin and try running ./ord --version. If it helped, hold on inside this directory and always use ./ord instead of the ord in following commands.

  2. Prepare wallet (its recommended to create a new one).

  • ord wallet create, remember to save you seed phrase.
  1. Fund the wallet by generating new address and sending some funds from your other wallet or CEX.
  • Generate receiving address ord wallet receive
  1. Check status of transactions
  • ord wallet transactions and ord wallet outputs

Build ord index

  1. To produce ordinals the ord first needs to build an index. In my case this operation took more time than syncing the BitcoinCore. The command will show you the current progress. Ord index is stored in ~/.local/share/ord directory
  • ord index

Send your first inscription

  1. Create file you want to upload, you can use nano to create text file.
  • nano
  1. First check some balance
  • ord wallet balance
  1. Simulate inscription creation (without broadcasting transaction) to get estimation of total fees. Be sure to use the option --fee-rate with optimal value, otherwise will be used the default value (1) and your tx may get stuck in mempool. The current optimal fee can be obtained from here.
  • ord wallet inscribe --fee-rate 15 --dry-run text.txt
  1. Create inscription with broadcasting.
  • ord wallet inscribe --fee-rate 15 text.txt

About