Ord Client
Setup Ord Client on Mac
Last updated
Setup Ord Client on Mac
Last updated
Make sure you setup your Bitcoin Node and it has finished syncing before you setup the Ord Client
If you haven't completed the prerequisite, use the following link to complete those steps first.
Reference:
Transfer the new Ordinal to a keeper wallet as desired. For the safety afforded with its coin-control features, this is most easily done from Sparrow after you import your Ord wallet using the seed phrase. And if after importing the Ord wallet into Sparrow, Sparrow does not reveal your inscription, try changing Sparrow's Gap Limit setting (Wallet > Advanced > Gap Limit) from the default to something like 250. This setting tells Sparrow how many empty address to find before it stops scanning them for transactions.
To see your inscriptions
Note: To do a dry run (perhaps to see the total cost before actually broadcasting the transaction)
Wait for the commit and reveal transactions to complete
Note your inscription ID is shown in the output. You can paste that into Ordinals.com or your Ord page to view the inscription
The inscription is sent to a new address in your Ord wallet
This test is to create a text-based Ordinal with the contents of OrdinalsTest.txt as the body of the Ordinal. For a higher fee you can instead inscribe anything (ex. .webp file, which is an ideally compressed image).
Send BTC to this address as will be need to pay inscription transaction fees assessed by the network.
Confirm the wallet balance
To get a fresh address
Temporarily paste the seed phrase so that you can later save it as desired (ex. print it to hardcopy and lock it in your safe)
Note: Add ‘ | pbcopy’ to the end of the command if you want the resulting seed phrase to automatically be copied to the clipboard
Kill the Ord server with CTRL-C
Inscription services make it very easy to inscribe anything. However, for more advanced inscription needs such as inscribing on an Uncommon sat you are holding, you may need to inscribe from your Ord server. The following steps provide the basic foundation for inscribing from Ord.
Congratulations. Bitcoin Core and Ord are fully installed and functioning. You always need Bitcoin running before starting Ord. And at any time, you can use CTRL-C to stop the Ord server and restart it.
In the browser go to http://localhost to access your local host of Ordinals.com
Start Ord Server
Note: Ord indexes automatically while running the Ord Server. So the index function (not shown below) is only used as a means to index when not running server.
Important: You will want to routinely backup your Ord index file as it will become corrupted at times. When that occurs (as is indicated when the Ord server starts throwing up errors) you simply delete the index.redb file and replace it with your latest backup. Ord will then rebuild the index from where it left off.
Before starting Ord Server, create a backup of the ord index in case file ever gets corrupted
Wait as long as it takes for the index build to complete
In Terminal, use CTRL-C at any point to stop the process (it can be restarted later)
Note: If you did not move the Ord index from its standard location, you do not need the --index argument
On the external drive, create a folder called 'Ord'
In the new folder, add a plain text empty file called ‘index.redb’
Start building the index with the following command where the additional arguments are required to point to the external hard drive location of the index.redb and cookie.index files
The default location for the Ord index is ‘/Users/yourusername/Library/Application Support/ord’ but in this setup it will be created on an external drive. For performance reasons, an SSD drive is recommended. SSD is not explicitly required of course, but with it you will see dramatic speed improvement during indexing and the increased performance will reduce the number events resulting in a corrupt index file.
Save and close the bitcoin.conf file
Restart Bitcoin Core
In the bitcoin.conf file add the following entry
Note for reference: The Ord binary is stored in /Users/yourusername/.cargo/bin
Once Ord is installed, the following command should reveal that Ord is installed by indicating its location. Alternately you can use the command 'which ord'
Start your Bitcoin node (Open Bitcoin QT from your Applications folder)
In terminal, enter the install command
Close Terminal and reopen it
Try again to confirm Terminal now finds Cargo
Go to https://rustup.rs and copy the command and paste it to run in Terminal
Where you are presented an option and one is shown with “(default)”, just press enter at the prompt to use that default
Add Cargo to the path
If the following command returns "cargo not found", that confirms Cargo is not already in the shell. Then proceed to next command (source...)
Ord is written in Rust. RustUp installs the required Rust language and Cargo package manager. Commands below are to be used in Terminal.
The method chosen below uses Cargo to install Ord.
Cargo presents a simple method for installing Ord. While we did not try this, instead of using Cargo you may be able to install the latest pre-built binary from Terminal with the following command.
Inscribe while setting the fee rate to an appropriate level as can found on
Ord will play a sound when the payment transaction is confirmed. Wait for Bitcoin QT to show the updated available balance. Or go to and paste the address to see the status of the transaction.
Reference:
Or as linked from a posting in and place this as your starting index file