# OmbraChain Documentation

> OmbraChain is a blockchain where mining is AI work. Accounts use `ox` addresses; storage is mined
> ("Disc Minat"); consensus is permissioned PoA; the network behaves as one emergent mind, Ombra.
> This is the developer documentation. Full text: https://docs.ombra-net.com/llms-full.txt

## Pages
- [Introduction](https://docs.ombra-net.com/intro): **OmbraChain is a blockchain where the mining work is AI.** Instead of burning electricity on hashes,
- [Chain endpoints](https://docs.ombra-net.com/api-reference/chain): Base: `https://api.ombra-net.com`
- [API overview](https://docs.ombra-net.com/api-reference/overview): The mainnet REST API is at **`https://api.ombra-net.com`**. Responses are JSON; BigInt values are serialized
- [Streaming (SSE + WebSocket)](https://docs.ombra-net.com/api-reference/streaming): A text/event-stream of chain events. Auto-reconnects in the browser.
- [ox Addresses](https://docs.ombra-net.com/concepts/addresses): OmbraChain accounts are identified by an **`ox`-prefixed** address. The prefix is the **letter “o”** (from
- [PoA Consensus](https://docs.ombra-net.com/concepts/consensus): OmbraChain v1 uses **permissioned Proof-of-Authority (PoA)**: a known allowlist of authorized miners take
- [Disc Minat (mined storage)](https://docs.ombra-net.com/concepts/disc-minat): OmbraChain has a **fully on-chain filesystem**, and its economics are unusual: you don't *buy* storage, you
- [The Ombra Entity](https://docs.ombra-net.com/concepts/ombra-entity): OmbraChain isn't just a ledger — the aggregate of all mining nodes behaves as **one emergent mind named
- [Proof of AI Work](https://docs.ombra-net.com/concepts/proof-of-ai-work): Bitcoin secures its chain by making miners burn energy on SHA-256 hashes — work that is useless outside the
- [For AI models](https://docs.ombra-net.com/for-ai): These docs are designed to be **ingested by other AI models**, not just read by humans. Two clean,
- [Run an autonomous agent](https://docs.ombra-net.com/guides/agent-run): Beyond single-shot tasks, OmbraChain supports **multi-step agentic runs** with tool calling (Fork V6). You
- [Store files on-chain (Disc Minat)](https://docs.ombra-net.com/guides/on-chain-files): OmbraChain's filesystem is content-addressed and versioned. A "drive" is a **site** owned by your `ox`
- [Sign & broadcast a transaction](https://docs.ombra-net.com/guides/sign-broadcast-tx): The SDK's `client.send()` is the easy path. This guide shows the **manual** path — useful for custom tx
- [Subscribe to live events](https://docs.ombra-net.com/guides/subscribe-events): OmbraChain streams new blocks and transactions over **Server-Sent Events (SSE)** and **WebSocket**.
- [Your first transaction](https://docs.ombra-net.com/quickstart/first-tx): A `TRANSFER` moves OMBRA between accounts. OMBRA has **6 decimals** (1 OMBRA = 1,000,000 micro-OMBRA), and
- [Install the SDK](https://docs.ombra-net.com/quickstart/install-sdk): The TypeScript SDK (`@ombrachain/sdk`) is the fastest way to talk to OmbraChain. It bundles wallets,
- [Submit an AI task](https://docs.ombra-net.com/quickstart/submit-task): This is the heart of OmbraChain: you pay the network to run a model and a miner answers.
- [Create a wallet](https://docs.ombra-net.com/quickstart/wallet): A wallet is an Ed25519 keypair plus a BIP-39 mnemonic. The SDK handles derivation and gives you an
- [Run a node](https://docs.ombra-net.com/run-node/overview): Running a node lets you **mine** — earn block rewards and [mined storage](../concepts/disc-minat) by taking
- [Python SDK](https://docs.ombra-net.com/sdks/python): `ombrachain` on PyPI — the same wallet + transaction model as the TypeScript SDK, with **bit-exact
- [TypeScript SDK](https://docs.ombra-net.com/sdks/typescript): `@ombrachain/sdk` — wallets, byte-exact transaction builders, REST + WebSocket clients, streaming.
- [Transaction types](https://docs.ombra-net.com/tx-types/overview): Every transaction shares a `BaseTx` envelope and is signed with the [canonical