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.
- 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.
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.
- v1Semver for SDKsBreaking changes only in major versions once 1.0 ships.
- v2Explicit API versionsVersioned paths and protobuf packages (v1beta1 → v1).
- v3Chain upgrade announcementsPublished ahead of governance-approved upgrade heights.
- v4Deprecation windowsDeprecated interfaces keep working for a published window.
- v5Migration guidesEvery breaking change ships with a guide.
- v6Contract compatibility notesRuntime changes that affect contracts are called out explicitly.
- v7Testnet before mainnetEvery upgrade runs on testnet first.
Open development
Follow the code. Review the architecture. Contribute.
Website repository
AvailableThe bitcoinai.network website source is currently private.
Protocol repository
Testnet TBDNo 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.
| Component | Scope | Status | |
|---|---|---|---|
| Website repo | Available | Public site live; source repository currently private | Available |
| Protocol repo | Testnet TBD | No public protocol code yet | Testnet TBD |
| SDK | Planned | @bitcoinai/* TypeScript packages — not published | Planned |
| EVM | Planned | EVM-compatible smart-contract execution | Planned |
| REST | Planned | Cosmos REST / gRPC-gateway | Planned |
| gRPC | Planned | Cosmos SDK gRPC services | Planned |
| JSON-RPC | Planned | Ethereum-style JSON-RPC for the planned EVM runtime | Planned |
| AI Job API | Planned | Create, quote, escrow and track AI jobs | Planned |
| Proof-of-AI schema | Engineering | Receipt fields, binding and encoding | Engineering |
| AIPoW relay | Engineering | Merge-mining work submission relay | Engineering |
| IBC | Planned | IBC channels to Cosmos-ecosystem chains | Planned |
| EVM adapter | Planned | Adapters for Ethereum and EVM L2 ecosystems | Planned |
| Solana adapter | Research target | Adapters for Solana-connected applications | Research target |
| Appchain template | Planned | Starter appchain configurations | Planned |
| Localnet | Planned | Docker Compose local network | Planned |
| Testnet | Testnet TBD | Launch date and parameters not yet set | Testnet TBD |
| Faucet | Planned | Test-token faucet | Planned |
| Explorer | Planned | Block and AI-job explorer | Planned |
| Provider sandbox | Planned | Mock BatteryAGI provider environment | Planned |
| Sample apps | Planned | Reference applications | Planned |
Nothing is Live on a BitcoinAI network yet. "Available" refers only to public web content.