SDKs

Raw

Generated read-only clients for TypeScript, Python, Go, and Rust, all derived from the same OpenAPI contracts.

Universe implementation Verified 2026-09-02 Metadata & Sources

Describes what a Bitcoin Universe service actually does today. It is not a statement about the protocol in general.

Page ID

sdks

Normative authority

Universe implementation documentation

Networks

mainnet, regtest

Documentation version

2026.08

Audience

developer, integrator

Owner

bitcoin-universe-docs

Sources

Universe ARC-20 index and Marketplace v1 authority at 670030e50071 private repository
Universe Atomicals NFT, Realm, and Subrealm index at 1d9109c68d95 private repository

Known limitations

Every client is read-only with an explicit base URL, typed errors, timeouts, and cancellation in the language idiom. No client signs, broadcasts, or stores keys.
The Go and Python toolchains are exercised in CI; the Rust client is compiled and checked locally with cargo.

Language	Location	Transport	Notes
TypeScript	`packages/client`	fetch	Generated types for every operation and response
Python	`clients/python`	urllib, no runtime dependencies	Type hints, Ruff and mypy clean in CI
Go	`clients/go`	net/http with contexts	`gofmt` and `go vet` clean in CI
Rust	`clients/rust`	reqwest with rustls	`cargo check` and Clippy clean in CI

Each client requires an explicit base URL: none of them hides a default production origin. Retries are absent by default; a caller who wants retries for safe idempotent reads adds them explicitly.

Coverage

The generated coverage manifest lists every read-only operation each client exposes. Regenerating is one command and must leave the working tree clean:

npm run sdk:generate

Quick start (Python)

from atomicals_client.client import Client

client = Client("http://127.0.0.1:3043")
status = client.arc20_get_status()
print(status["coverage"], status["chainTip"])

Quick start (Rust)

let client = atomicals_client::Client::new("http://127.0.0.1:3043")?;
let status = client.arc20_get_status().await?;
println!("{} at {}", status["coverage"], status["chainTip"]);

Release artifacts

Versioned archives and checksums for every SDK ship with each release so the packages stay installable without any external registry credential. See releases.