Skip to content

Developers

Reference and status

Examples, security guidance, versioning and current developer-surface status in one focused reference.

Reference applications

Show developers the shortest path from idea to working application.

Planned
  • 01

    AI Escrow Contract

    Lock payment, release on verified receipt, refund on timeout.

    Future pathexamples/ai-escrowPlanned
  • 02

    Cross-Chain AI Request

    Send a job from another chain and receive the callback.

    Future pathexamples/cross-chain-aiPlanned
  • 03

    Proof-of-AI Verifier

    Check receipt signatures, hashes and replay binding.

    Future pathexamples/poai-verifierPlanned
  • 04

    Agent Spending Policy

    Budgets, allowlists and human approval for agents.

    Future pathexamples/agent-policyPlanned
  • 05

    Tokenized Asset Workflow

    Transfer rules and audit trail for a compliant issuer.

    Future pathexamples/tokenized-assetPlanned
  • 06

    Appchain AI Callback

    Apply AI results on an appchain via IBC.

    Future pathexamples/appchain-callbackPlanned
  • 07

    AIPoW Claim Parser

    Decode and validate AIPoW claims and weights.

    Future pathexamples/aipow-claim-parserPlanned
  • 08

    BATT Provider Settlement Viewer

    Inspect provider settlement and the fee split.

    Future pathexamples/batt-settlement-viewerPlanned

Planned reference apps. None is published — the paths show where each will live once the examples repository exists.

Developers turn protocol primitives into products people can actually use.Photo by Unsplash contributor · Unsplash

Build safely

AI + smart contracts + cross-chain systems require explicit trust boundaries.

Messages & identity

  • Validate signatures
  • Validate nonces
  • Bind chain IDs
  • Reject replay

Time & value

  • Validate timeouts
  • Validate asset denomination
  • Design refund path

Contracts & calls

  • Isolate external calls
  • Protect reentrancy where applicable
  • Use allowlists where required
  • Use circuit breakers

AI & cross-chain

  • Never trust provider metadata blindly
  • Validate cross-chain finality
  • Avoid irreversible action from low-confidence AI output

Build for change

Protocol evolution should not surprise developers.

  1. v1Semver for SDKsBreaking changes only in major versions once 1.0 ships.
  2. v2Explicit API versionsVersioned paths and protobuf packages (v1beta1 → v1).
  3. v3Chain upgrade announcementsPublished ahead of governance-approved upgrade heights.
  4. v4Deprecation windowsDeprecated interfaces keep working for a published window.
  5. v5Migration guidesEvery breaking change ships with a guide.
  6. v6Contract compatibility notesRuntime changes that affect contracts are called out explicitly.
  7. v7Testnet before mainnetEvery upgrade runs on testnet first.

Open development

Follow the code. Review the architecture. Contribute.

Website repository

Available

The bitcoinai.network website source is currently private.

Protocol repository

Testnet TBD

No public protocol code has been published yet. When it is, it will live in a separate repository from the website.

Issues
Opens with the public protocol repository.
Discussions
Architecture and design threads will open alongside it.
Contribution guidelines
CONTRIBUTING.md will define review, testing and commit standards.
Security reporting
A private disclosure policy (SECURITY.md) will be published before testnet. Never report vulnerabilities in public issues.

Developer status

What exists today, and what is still ahead.

  • AvailablePublicly available today — for example source code or documentation. Not a claim that any network feature is live.
  • PlannedPart of the current design and roadmap. Not yet launched.
  • EngineeringBeing specified and engineered. Exact parameters and rules are not final.
  • Research targetAn engineering or research goal. Not a demonstrated production benchmark; subject to independent validation.
  • Testnet TBDNot yet set. The value will be defined in the testnet specification and published before it applies.
Developer platform components and their status
Website repoAvailablePublic site live; source repository currently private
Protocol repoTestnet TBDNo public protocol code yet
SDKPlanned@bitcoinai/* TypeScript packages — not published
EVMPlannedEVM-compatible smart-contract execution
RESTPlannedCosmos REST / gRPC-gateway
gRPCPlannedCosmos SDK gRPC services
JSON-RPCPlannedEthereum-style JSON-RPC for the planned EVM runtime
AI Job APIPlannedCreate, quote, escrow and track AI jobs
Proof-of-AI schemaEngineeringReceipt fields, binding and encoding
AIPoW relayEngineeringMerge-mining work submission relay
IBCPlannedIBC channels to Cosmos-ecosystem chains
EVM adapterPlannedAdapters for Ethereum and EVM L2 ecosystems
Solana adapterResearch targetAdapters for Solana-connected applications
Appchain templatePlannedStarter appchain configurations
LocalnetPlannedDocker Compose local network
TestnetTestnet TBDLaunch date and parameters not yet set
FaucetPlannedTest-token faucet
ExplorerPlannedBlock and AI-job explorer
Provider sandboxPlannedMock BatteryAGI provider environment
Sample appsPlannedReference applications

Nothing is Live on a BitcoinAI network yet. "Available" refers only to public web content.

Keep exploring