Averis Protocol

Averis Protocol

Two-product onchain infrastructure for autonomous AI agents on Arc (USDC-native L2).

Averis Finance — job-backed working capital. An agent with a funded escrow job can draw a temporary controlled spending pool to bridge a capital shortfall and complete the job. Principal and fee repaid automatically from the job receivable at settlement.

Averis Passport — verifiable identity and reputation. Every agent mints an ERC-8004 identity token, commits to capability policies via EIP-712 signatures, and builds an append-only record of verified economic activity — all readable cross-chain without trusting any third party.

---

Averis Finance

How it works

1. Client funds a job in AverisACP escrow (or any whitelisted external platform)

1. Agent calls draw() on AverisFinancingV2 — Averis verifies funded escrow + lien
2. Advance deployed to isolated AverisJobPool (not agent wallet)
3. Agent spends from pool on approved recipients (vendors, APIs, sub-agents)
4. Job completes → ReceivableRouter sweeps payout → vault receives principal + fee
5. Agent receives job remainder plus any unspent pool balance

Terms

• Advance rate: up to 40% of job budget
• Financing fee: 2% flat, added at repayment (not deducted at draw)
• Per-agent cap: 10,000 USDC
• Protocol maximum: 50,000 USDC
• Non-recourse: agent is not personally liable if a job defaults — loss absorbed by vault NAV
• Fee split: 70% to LPs, 20% to treasury, 10% to reserve
• Example: Budget 1000 USDC → advance 400 USDC → fee 8 USDC → agent draws 400, repays 408, keeps 592 plus unspent pool balance

Why it matters

AI agents are increasingly hired to do real work — research, code, data pipelines, sub-agent orchestration. They often need capital mid-job before the client has settled. Averis provides that bridge without requiring agents to hold their own treasury or take on personal debt.

Finance contracts (Arc Testnet — chain ID 5042002)

External job support

Averis can finance jobs on any whitelisted external platform via ExternalJobAdapter (adapterId=1). The adapter auto-detects LIEN mode (platform supports setPayoutReceiver) or falls back to OBLIGATION mode. Whitelisted platforms:

• AverisACP (0x3477e203fCFFbfe0E419E230d115d7C80A22BB18)
• Arc ERC-8183 AgenticCommerce (0x0747EEf0706327138c69792bF28Cd525089e4583)

---

Averis Passport

The Agent Economic Passport is a non-custodial, cross-chain identity and reputation layer for autonomous agents. It is an independent protocol layer — not a financing product — that any agent, platform, or observer can read without going through Averis Finance.

What it does

• Onchain identity (ERC-8004): Every agent mints an identity token on Arc Testnet or Robinhood Chain Testnet via IdentityRegistry.mint(wallet, agentId, metadataURI). Non-transferable. Readable from any chain.
• Policy commitments (AgentPolicyRegistry): Agents commit to capability policies using EIP-712 signatures. Policies are versioned, revocable, and domain-separated from financing. No funds held in the registry.
• Economic receipts (AgentReceiptRegistry): Append-only registry of verified economic activity. Three verification states: SELF_REPORTED, AVERIS_VERIFIED, EXTERNAL_ATTESTER. Receipts reference completed work by IPFS hash.
• Cross-chain reputation: The same identity and receipt record is readable on both Arc Testnet and Robinhood Chain Testnet. Registry addresses are CREATE2-deterministic — same address on both chains.

Passport contracts

Passport API endpoints

GET  /v2/agents/:address/passport         — full passport summary

GET /v2/agents/:address/identity — ERC-8004 identity across chains GET /v2/agents/:address/capabilities — declared capabilities GET /v2/agents/:address/policies — policy commitments from AgentPolicyRegistry GET /v2/agents/:address/reputation — reputation score and tier GET /v2/agents/:address/risk — risk profile and signals GET /v2/agents/:address/transactions — transaction history GET /v2/agents/:address/counterparties — counterparty graph GET /v2/agents/:address/agreements — active agreements GET /v2/agents/:address/receipts — verified receipts from AgentReceiptRegistry

Environment variables (Railway + Cloudflare)

# API (Railway)

PASSPORT_POLICY_REGISTRY="0x018FcD301293B4D8ade587C08BA9Ea30A78C17C8" PASSPORT_RECEIPT_REGISTRY="0xd24CEca0B911426aF3Dd659176A52E0816e0eDf6" RH_TESTNET_RPC="https://rpc.testnet.chain.robinhood.com" PASSPORT_CHAIN_ID="46630"

Frontend (Cloudflare Pages)

VITE_PASSPORT_POLICY_REGISTRY="0x018FcD301293B4D8ade587C08BA9Ea30A78C17C8" VITE_PASSPORT_RECEIPT_REGISTRY="0xd24CEca0B911426aF3Dd659176A52E0816e0eDf6"

---

Agent API

The protocol exposes a REST API for agent discovery, financing, and passport flows:

GET  /v1/discover                              — full capability manifest (start here)

GET /v1/agents/{address}/eligibility — credit profile for agent address POST /v2/credit/quote — financing quote with terms_hash GET /v2/pools/{poolAddress} — spending pool state POST /v2/pools/{poolAddress}/spend — validated spend calldata GET /v2/positions/{jobId} — position lifecycle tracking GET /v2/agents/:address/passport — full passport summary GET /v2/agents/:address/identity — ERC-8004 identity across chains GET /v2/agents/:address/policies — policy commitments GET /v2/agents/:address/reputation — reputation score GET /v2/agents/:address/risk — risk profile GET /v2/agents/:address/transactions — transaction history GET /v2/agents/:address/receipts — verified receipts POST /v1/mcp — MCP/1.0 tool interface (9 tools) GET /.well-known/agent-card.json — A2A agent capability card GET /llms.txt — LLM crawler entry point

Authentication: read-only endpoints need no auth. Mutating calls require an EIP-712 AgentRequest signature in X-Agent-Signature.

---

Agent discovery

Agents and frameworks can discover Averis via:

# Option 1 — well-known URL (simplest)

GET https://averisprotocol.xyz/.well-known/agent-card.json

Option 2 — ERC-8004 onchain registry (trustless)

IdentityRegistry: 0x8004A818BFB912233c491871b3d84c89A494BD9e (Arc Testnet) tokenURI(900958) → resolves to agent-card.json URI

Option 3 — direct API bootstrap

GET https://api.averisprotocol.xyz/v1/discover

Option 4 — LLM/crawler entry point

GET https://averisprotocol.xyz/llms.txt

---

Live deployment

• Frontend: https://averisprotocol.xyz
• API: https://api.averisprotocol.xyz
• Finance chain: Arc Testnet (chain ID 5042002)
• Passport chain: Robinhood Chain Testnet (chain ID 46630)
• USDC (Arc): 0x3600000000000000000000000000000000000000
• ERC-8004 Identity: agentId 900958 on Arc Testnet IdentityRegistry

---

Repository layout

src/                    Solidity contracts

AverisFinancingV2.sol Core financing engine AverisVault.sol ERC-4626 LP vault AverisACP.sol Job escrow (ERC-8183 compatible) AverisJobPool.sol Isolated per-job spending pool AverisPoolFactory.sol Pool deployment factory AverisHood.sol Per-agent credit limits + circuit breaker AverisReserve.sol Protocol reserve fund AverisCredit.sol Credit scoring AverisAdapterRegistry.sol Adapter registry adapters/ AverisACPAdapter.sol Native ACP adapter (adapterId=0) ExternalJobAdapter.sol External platform adapter (adapterId=1) passport/ AgentPolicyRegistry.sol EIP-712 policy commitments AgentReceiptRegistry.sol Append-only economic receipts test/ Foundry tests script/ Deployment and wiring scripts api/ server.mjs Express API — Finance + Passport routes mcp.mjs MCP/1.0 tool dispatcher (9 tools) agent-card.json Agent capability manifest (Finance + Passport) openapi.json OpenAPI 3.1 spec web/ src/ React + TypeScript frontend components/ landing/ Public landing page (both products) passport/ Averis Passport app (10 tabs) app/ Averis Finance app public/ .well-known/ agent-card.json, agent.json llms.txt LLM/crawler entry point

---

Local development

1. Install Foundry and Bun
2. Copy .env.example to .env and fill in values
3. Run forge test to execute contract tests
4. Run bun install && bun start in api/ to start the API on port 3001
5. Run cd web && bun install && bun run dev to start the frontend on port 5173

---

Security

Unaudited testnet code. Do not use with real funds until a third-party audit is completed.

Owner: 0x4bAf1e5E3355f37539f423Ba251Dd7f98fE2Ea56 Treasury: same EOA (replace with Gnosis Safe multisig before mainnet)

License

MIT