sadoprotocol · 2023

Ordit SDK

Indexer, parser, and API toolkit for Bitcoin Ordinals
RoleLead Developer
StatusProduction
Orgsadoprotocol

Context

When the Ordinals protocol emerged in early 2023, the only way to interact with it was through Casey Rodarmor's reference ord indexer, a Rust binary that requires a full Bitcoin node and produces a local database. There was no JavaScript SDK, no REST API, no way for web developers to build Ordinals applications without running heavy infrastructure.

Ordit was built to fill that gap: a JavaScript-native toolkit that gives web developers everything they need to build on Ordinals without running their own indexer.

Architecture

The SDK operates at three layers:

  • Indexer — connects to a Bitcoin node, traces sat provenance through the UTXO graph, indexes inscriptions and their content. Produces a queryable database of ordinal state
  • Parser — decodes inscription content from witness data, handles recursive inscriptions, resolves parent-child relationships between inscriptions
  • API toolkit — JavaScript client library for querying ordinal data, constructing inscription transactions, building PSBTs for ordinal transfers

Why It Matters

Ordit was the infrastructure layer that made SADO Protocol and Ordzaar possible. Without a reliable, fast indexer and a developer-friendly API, building a marketplace would have meant every consumer application re-implementing the same low-level Bitcoin parsing logic.

The SDK abstracts the complexity of sat tracking (tracing individual satoshis through transaction inputs and outputs), inscription decoding (extracting data from Taproot witness scripts), and PSBT construction (building partially-signed transactions for trustless trading) into clean JavaScript interfaces.

Open Source Ecosystem

Ordit lives under the sadoprotocol GitHub organisation alongside the SADO Protocol itself, reference implementations, and documentation. Multiple repositories cover different aspects of the stack, from the core indexer to API wrappers to example applications.

Result
Production SDK powering Ordzaar and third-party exchanges, providing JavaScript access to Bitcoin Ordinals without running infrastructure