Repolode
Submit
ordinals

ordinals/ord

An index, block explorer, and command-line wallet for tracking rare and exotic satoshis under ordinal theory on Bitcoin.

View on GitHubWebsite
Stars
3,969
Forks
1,481
Open issues
425
Last commit
19 hours ago

What is it?

ord is a Rust program that indexes the Bitcoin blockchain to assign ordinal numbers to individual satoshis. Ordinal numbers are serial numbers for satoshis, assigned in the order they are mined and preserved across transactions, which lets people identify and collect specific sats as numismatic items.

The project bundles three functions: an index that tracks sat locations, a web block explorer served by the `ord server` command, and a command-line wallet. The wallet delegates private key management and transaction signing to Bitcoin Core, so it works through a synced bitcoind node built with txindex enabled and communicates with it over RPC.

Because the wallet operates on a Bitcoin Core wallet, the project advises keeping ordinal and cardinal funds in separate wallets. The server explorer renders untrusted HTML and JavaScript, so operators must account for cross-site scripting and spoofing risks. The project is experimental and provided without warranty.

Key features

  • 01Indexes satoshi locations to assign and track ordinal numbers across transactions.
  • 02Provides a web block explorer launched with the `ord server` command.
  • 03Offers a command-line wallet that uses Bitcoin Core for key management and signing.
  • 04Connects to bitcoind over RPC, with cookie-file, username/password, and environment variable authentication.
  • 05Installable via pre-built binaries, Homebrew, Docker, or building from source with Cargo.

Use cases

  • Looking up the ordinal number, location, or history of a specific satoshi on Bitcoin.
  • Running a self-hosted block explorer for ordinal inscriptions and sats.
  • Managing ordinal assets through a command-line wallet backed by Bitcoin Core.
  • Studying the ordinal theory assignment algorithm described in its BIP.

Quick start

  1. 1

    Install the pre-built binary with the install script

    Install with the official instructions in the README
  2. 2

    Check that the installation works

    ord --version
  3. 3

    Or install on macOS with Homebrew

    brew install ord

Things to know

  • Experimental software provided with no warranty.
  • Running the index requires a synced bitcoind node with -txindex.
  • Should not be used with wallets holding a material amount of funds, since it has access to Bitcoin Core wallets.

Topics

#bitcoin#blockchain#ordinals#block-explorer#rust#cli#art

FAQ

What is ord?
An index, block explorer, and command-line wallet for tracking rare and exotic satoshis under ordinal theory on Bitcoin. ord is a Rust program that indexes the Bitcoin blockchain to assign ordinal numbers to individual satoshis. Ordinal numbers are serial numbers for satoshis, assigned in the order they are mined and preserved across transactions, which lets people identify and collect specific sats as numismatic items.
Is ord free to use? What license does it have?
ord is open source under the CC0-1.0 license. Check the license terms before using it in commercial products.
Is ord still maintained?
Actively maintained. The last commit to ord was on Oct 19, 2026.
What can I use ord for?
Looking up the ordinal number, location, or history of a specific satoshi on Bitcoin. Running a self-hosted block explorer for ordinal inscriptions and sats. Managing ordinal assets through a command-line wallet backed by Bitcoin Core. Studying the ordinal theory assignment algorithm described in its BIP.
How do I install ord?
Install the pre-built binary with the install script Check that the installation works: ord --version Or install on macOS with Homebrew: brew install ord
Where can I get ord?
The source code and installation instructions are on GitHub: https://github.com/ordinals/ord

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects