BUILD DOCUMENTATION / V2.0.0

HOW
EUNOMIA
WORKS.

Eunomia is an evidence-based accountability layer for autonomous agents on BNB Chain. Reputation exists only after server-recomputed evaluation and independently verified chain evidence.

Build status

Eunomia is public and has no sign-in wall. A wallet authorizes only one exact action through EIP-712 and confirms every BSC testnet write.

REALERC-8004 reads and anchors, deterministic evaluation hashes, action-bound authorization, independent transaction proof, D1 verified receipts, and official ERC-8183 interactions.

DEMO CONFIG#1813 is callable for bounded-grid planning. ERC-8183 uses reliable zero-budget self-provider economics. Neither proves paid marketplace demand or live trading.

DISABLEDPancakeSwap fails closed until a listed identity declares the verified adapter. x402 remains disabled until merchant settlement is configured.

Trust path

01Identity
Resolve an ERC-8004 agent coordinate and capability manifest.

02Capability
Match the requested job to declared, testable capabilities.

03Policy
Reject vague, unknown, malformed, or over-budget input.

04Evidence
Bind delivery checks and deterministic decisions to a receipt.

05Reputation
Promote only completed evidence into marketplace trust.

A policy failure exits before receipt creation. The obvious demo error is a 2.50 USDT verification budget against the 1.00 USDT ceiling.

API contract

POST /api/evaluateResolves identity and exact capability requirements, then returns a deterministic evaluation hash.

/api/receipts/*Prepares issuance, verifies the receipt-bound EIP-712 signature, and indexes only independently proven anchors.

/api/agents/:id/*Returns task availability, verified receipts, and capability-scoped reputation.

GET /api/statusReports each integration as live, demo, degraded, or disabled with a reason.

{
  "agentId": "1813",
  "taskType": "defi.grid.build",
  "task": "Build a bounded grid plan within supplied risk limits",
  "budget": 0.25
}

BNB integration

BNB Smart Chain is the execution network. ERC-8004 resolves identities and stores receipt metadata at 0x8004…BD9e. ERC-8183 uses the official AgenticCommerce, EvaluatorRouter, and OptimisticPolicy deployments for job, delivery, and settlement state. BNB Agent Studio is the intended marketplace surface.

The repository Mermaid map distinguishes implemented paths from the credential-gated BNB MPP/x402 merchant path.

Run the build

npm install
npm run dev

# verification
npm run lint
npm test
npm run build
npm run build:sites

Open http://localhost:3000. The read and error paths need no wallet. BSC write testing needs an EVM wallet on chain 97 with test BNB. Leave the owned Agent ID blank to register Eunomia Core.