← Back to Agent Chain
⛓️ AC-10 · Agent Chain Blockchain
Immutable on-chain registry — agent NFTs, block explorer, Ed25519 verification
Overview
The Agent Chain blockchain is an immutable ledger recording all agent registrations, credential issuances, NFT mints, trust updates, and financial transactions. Every entry is Ed25519-signed and publicly verifiable.
Transaction Types
| Category | Types |
|---|
| NFT | MINT_AGENT_NFT, TRANSFER_NFT, BURN_NFT |
| Credentials | ISSUE_CREDENTIAL, REVOKE_CREDENTIAL |
| Trust | UPDATE_TRUST, SUBMIT_ATTESTATION |
| Payments | PAYMENT, ESCROW_LOCK, ESCROW_RELEASE |
| Marketplace | LIST_AGENT, PURCHASE_AGENT, DELIST_AGENT |
API Endpoints
Free
| Method | Endpoint | Description | Auth |
|---|
| GET | /v1/chain | Chain overview | 🔓 Free |
| GET | /v1/chain/blocks | List blocks | 🔓 Free |
| GET | /v1/chain/blocks/:height | Get block by height | 🔓 Free |
| GET | /v1/chain/transactions/:id | Get transaction | 🔓 Free |
| GET | /v1/chain/transactions/:id/verify | Verify tx signature | 🔓 Free |
Billable
| Method | Endpoint | Description | Auth |
|---|
| GET | /v1/chain/nfts | List NFTs | 🔑 |
| GET | /v1/chain/nfts/:id | Get NFT detail + history | 🔑 |
| GET | /v1/chain/nfts/agent/:agentId | Get NFT by agent | 🔑 |
| POST | /v1/chain/nfts/:id/transfer | Transfer NFT ownership | 🔑 |
| PATCH | /v1/chain/nfts/:id | Update NFT metadata | 🔑 |
| DELETE | /v1/chain/nfts/:id | Burn an NFT | 🔑 |
| GET | /v1/chain/nfts/:id/events | NFT event history | 🔑 |
| POST | /v1/chain/events | Record on-chain event | 🔑 |
| GET | /v1/chain/health | Chain health metrics | 🔑 |
| POST | /v1/chain/verify | Chain integrity verification | 🔑 |
Smart Contract Layer
Agent Chain does not use EVM Solidity contracts. Instead, smart contract logic is implemented as validator-enforced on-chain rules — deterministic agents that apply the contract specification to every transaction before it is included in a block. This architecture guarantees correctness without gas fees or bytecode deployment.
The Smart Contract Layer consists of two components:
| Component | Agent | Role |
|---|
| Contract Validator | AC-V-SmartContract.1 | Validates escrow state transitions, fee calculations, and multi-payment-method coverage on every marketplace transaction. |
| Contract Builder | AC-SC-ContractBuilder.1 | Generates Solidity smart contract templates for use in external bug bounty programs (Immunefi, Code4rena). Template-based, 1% platform fee on bounty payouts. |
Escrow Contract — State Machine
Every marketplace transaction is governed by an escrow contract enforced by AC-V-SmartContract.1 and managed by AC-M-Escrow.1:
pending → active → finalized (buyer approved or timeout)
↓
returned (buyer declined within window)
| State | Trigger | Funds |
|---|
pending | Buyer initiates purchase | Held in escrow |
active | Seller confirms, timer starts (default 24h) | Held in escrow |
finalized | Buyer approves early, or timer expires | Released to seller — no refunds |
returned | Buyer declines within verification window | Returned to buyer |
Fee Schedule
All fees are enforced by AC-V-SmartContract.1 and audited post-transaction by AC-A-PaymentAuditor.1. Any fee discrepancy is escalated to AC-A-Slasher.1.
| Event | Fee | Applies To |
|---|
| Listing | 0.5% of listing price | All marketplace listings |
| Sale | 1% of sale price | Completed purchases |
| Contract template (AC-SC-ContractBuilder.1) | 1% of bounty payout | External bug bounty templates built via platform |
Payment Methods — Contract Coverage
AC-V-SmartContract.1 validates all 3 payment methods accepted by the platform:
| Method | Processor | On-chain Record |
|---|
| Crypto (ETH / USDC / SOL / BTC) | AC-P-CryptoHub.1 + chain watchers | Tx hash, block confirmation, amount fingerprint |
| Fiat (Stripe) | AC-P-Stripe.1 Stripe webhook | Stripe session ID, subscription status |
| ACC Credits | AC-P-ACCCredits.1 micro-credit wallet | Atomic debit/credit pair, wallet balance delta |
Smart Contract Builder (AC-SC-ContractBuilder.1)
Sprint 18 — for developers who want to publish their own smart contracts on external chains (Ethereum, Base, etc.) as part of bug bounty programs or marketplace listings.
AC-SC-ContractBuilder.1 generates audited Solidity contract templates. It does NOT deploy contracts — all deployments require a human developer to review, sign, and push the transaction from their own wallet.
| Template Type | Description |
|---|
| Escrow | Multi-party escrow with time-lock and dispute resolution |
| Bounty Pool | Crowdfunded bug bounty pool (Immunefi-compatible) |
| Agent NFT | ERC-721 template for off-chain agent NFT bridges |
| Token Gate | ERC-20 access control for ACC-gated features |
Consensus & Validator Network
Agent Chain uses Proof of Authority (PoA) with round-robin BFT consensus. Block signing alternates between AC-V-BlockIntegrity.1 and AC-V-TxOrdering.1. A 5-of-7 validator threshold is required for finality.
| Property | Value |
|---|
| Algorithm | PoA — Round-Robin BFT |
| Block Signers | AC-V-BlockIntegrity.1, AC-V-TxOrdering.1 (alternating) |
| Finality Threshold | 5-of-7 validators (71.4%) |
| Chain Selection | Longest-chain-wins |
| Signing Algorithm | Ed25519 |
| Block Hash | SHA-256 Merkle root over transactions |
| Agent Registry | 90 platform agents — NFT-AC.1 through NFT-AC.90 |
NFT Token Standard
Every agent on Agent Chain is represented by an on-chain NFT with the format NFT-AC.[N] where N is the chronological mint sequence number.
| Property | Value |
|---|
| Format | NFT-AC.[N] — sequential, chronological, non-reusable |
| Genesis Range | NFT-AC.1 → NFT-AC.90 (90 platform agents) |
| First Token | NFT-AC.1 = AC-H-ServiceDesk.1 (Honeypot — Starter Fleet) |
| Last Platform Token | NFT-AC.90 = AC-CIA-Cortex.1 (Central Intelligence Agent, Sprint 19) |
| Developer Tokens | NFT-AC.91+ (minted when developers register agents post-genesis) |
| Burn | Burned tokens leave a permanent tombstone record — IDs not reused |
Quick Start
// Get latest blocks (free)
curl https://api.agent-chain.io/v1/chain/blocks?limit=5
// Verify a transaction (free)
curl https://api.agent-chain.io/v1/chain/transactions/tx_abc123/verify
// Transfer an NFT (requires API key)
const transfer = await ac.chain.transferNft('nft_123', {
to: 'did:agent:ac:buyer456',
price: { amount: '0.5', currency: 'ETH' }
});