How to run ord against signet and etch Runes (works for v0.17.0)

Step 1: Run and sync Bitcoin core on signet.

To run ord against signet we first need to run Bitcoin core in signet mode. This is done by adding a -signet flag to the start command:

  • Note: This guide is written for ord 0.17.0, there might be different commands using another version.
  • Note: It is possible to run both signet and mainnet at the same time, but that requires to configuring different ports and data directories for the two setups.
  • Note: This guide expects that bitcoin core does not run on mainnet. So either quit your existing running node or configure a new datadir for signet and also add -port=18333 (default port is 18332).
  • Note: Syncing on signet is much faster then mainnet, but it still requires a few hours.
Windows
Linux and Mac

Step 2: Open a terminal (Linux and Mac) or Command Prompt (Windows) and navigate to the folder where you have ord.

  • Note: You can always check all available commands yourself by running ord --help.
Windows
Linux and Mac

Step 3: Start the ord server against signet

To start the ord server, you need to run the following command in the terminal.

  • Note: Running the server will connect to your bitcoin core node and synchronize ord. You therefore need to specify the data dir of your bitcoin core node (the same folder you specified when starting bitcoin core on the signet).
  • Note: The flag --index-runes is required to sync Runes and use the Rune specific commands.
  • Note: A pre-indexed signet ord database can be downloaded here (choose the signet version): here
Windows
Linux and Mac

Step 4: Create a wallet

When you create a new wallet, you will be returned a seed phrase. Backup this seed phrase in a safe place (you have done it with XVerse and all other wallets, same procedure here).

  • Note: You need to open a new terminal or command prompt to run new commands since the server is still running in the old terminal/command prompt.
Windows
Linux and Mac

Step 5: Fund your wallet

Funding your wallet is a 2 way process. First you need to get the address of your wallet, then you need to send signet funds to that address. To get the address, run the following command in the terminal.

  • Note: You need signet BTC to send to your address. Google BTC signet faucet and you should get some alternatives. signet faucets are usually unstable so try a bunch.
Windows
Linux and Mac

Step 6: Etch some Runes - Batch file

When the node is fully synced we can start with etching some runes. To do this, you need a batch yaml file with the Runes you want to etch.

  • Note: Create a file with the Rune content (adjust to your needs), example etchRune.yaml.
  • Note: You also need to do an inscription (the Rune is linked to the inscription). This is also specified in the yaml file and in the example I have just used a text file with the name runeguardian.txt. This file need to be there, so create this file yourself and add some custom content.
  • Note: You can also have a look at the official batch.yaml example file batch.yaml.

Step 7: Etch the file you created in step 6

  • Note: When I was etching the Rune, it took some blocks before it was fully minted. I got a message saying that the Rune must Mature first, this message disappeared after some blocks, so just hang tight and wait.
Windows
Linux and Mac

Step 8: Mint the Rune

Minting a Rune only requires fee and the name of the Rune you want to mint.

  • Note: as of 0.17.0 there is no destination flag, so you mint your Runes to the ord wallet itself. To transfer the Runes you need to use the wallet send command
Windows
Linux and Mac

Step 9: Check your Rune

If the Etching went OK the Runes should be indexed and can be seen on the ordinals signet webpage.

  • You can find it here.