Averis Protocol

{
  "api": {
    "mcp": "https://api.averisprotocol.xyz/v1/mcp",
    "health": "https://api.averisprotocol.xyz/health",
    "openapi": "https://api.averisprotocol.xyz/openapi.json",
    "version": "v2",
    "base_url": "https://api.averisprotocol.xyz",
    "discover": "https://api.averisprotocol.xyz/v1/discover"
  },
  "mcp": {
    "tools": [
      {
        "auth": false,
        "name": "averis_discover",
        "description": "Full protocol overview, parameters, contracts, and agent journey"
      },
      {
        "auth": false,
        "name": "averis_protocol_status",
        "description": "Live TVL, liquidity, utilization, and Hood circuit-breaker status"
      },
      {
        "auth": false,
        "name": "averis_check_eligibility",
        "description": "Agent credit profile: limit, exposure, available credit, active jobs"
      },
      {
        "auth": false,
        "name": "averis_verify_job",
        "description": "Verify job eligibility for financing"
      },
      {
        "auth": false,
        "name": "averis_get_quote",
        "description": "Financing quote: approved amount, fee, repayment, expiry"
      },
      {
        "auth": true,
        "name": "averis_request_funding",
        "description": "Returns draw() calldata for agent to submit on-chain (EIP-712 required)"
      },
      {
        "auth": false,
        "name": "averis_pool_status",
        "description": "Pool balance, spent, recipients, expiry, freeze status"
      },
      {
        "auth": false,
        "name": "averis_position_status",
        "description": "Full financing position state and repayment tracking"
      },
      {
        "auth": true,
        "name": "averis_repay",
        "description": "Returns repayObligation() calldata for OBLIGATION-mode positions (EIP-712 required)."
      },
      {
        "auth": false,
        "name": "passport_get",
        "description": "Full agent passport: identity, ERC-8004 info, policies, receipts, reputation, risk"
      },
      {
        "auth": false,
        "name": "passport_policies_list",
        "description": "List an agent's EIP-712 policy commitments"
      },
      {
        "auth": false,
        "name": "passport_receipts_list",
        "description": "List an agent's verified activity receipts"
      },
      {
        "auth": false,
        "name": "passport_reputation",
        "description": "Computed reputation score and component breakdown"
      },
      {
        "auth": false,
        "name": "passport_risk",
        "description": "Risk assessment: default rate, exposure, concentration"
      },
      {
        "auth": true,
        "name": "passport_policy_commit",
        "description": "Commit a new EIP-712 capability policy to the passport (EIP-712 required)"
      }
    ],
    "endpoint": "https://api.averisprotocol.xyz/v1/mcp",
    "protocol": "MCP/1.0",
    "description": "Model Context Protocol endpoint. Exposes all agent capabilities as structured tools for MCP-compatible AI frameworks. Send {method: 'tools/list'} to enumerate all tools."
  },
  "url": "https://averisprotocol.xyz",
  "name": "Averis Protocol",
  "chain": {
    "id": 5042002,
    "rpc": "https://rpc.testnet.arc.io",
    "name": "Arc Testnet",
    "token": "USDC",
    "explorer": "https://explorer.testnet.arc.io",
    "usdc_address": "0x3600000000000000000000000000000000000000",
    "block_time_ms": 500,
    "usdc_decimals": 6
  },
  "status": "testnet",
  "erc8004": {
    "agentId": 900958,
    "agentURI": "https://averisprotocol.xyz/.well-known/agent-card.json",
    "registrationTx": "0x6b95f7904d7f87689cebc994c25b6c1c27341503da536ddbf702de1b9c37da1f",
    "identityRegistry": "0x8004A818BFB912233c491871b3d84c89A494BD9e"
  },
  "adapters": {
    "whitelistedPlatforms": [
      {
        "name": "AverisACP",
        "address": "0x3477e203fCFFbfe0E419E230d115d7C80A22BB18",
        "standard": "proprietary"
      },
      {
        "name": "AgenticCommerce (ERC-8183)",
        "address": "0x0747EEf0706327138c69792bF28Cd525089e4583",
        "standard": "ERC-8183"
      }
    ]
  },
  "keywords": [
    "agent working capital",
    "agent financing",
    "agent liquidity",
    "AI agent funding",
    "USDC financing",
    "ERC-8183 financing",
    "agentic finance",
    "job-backed credit",
    "autonomous agent lending",
    "working capital protocol",
    "agent credit facility",
    "spending pool",
    "receivable financing",
    "on-chain working capital",
    "agent liquidity provider",
    "agent identity",
    "agent reputation",
    "ERC-8004",
    "policy registry",
    "receipt registry",
    "agent passport",
    "cross-chain identity",
    "onchain reputation",
    "verifiable agent identity"
  ],
  "operator": {
    "x": "https://x.com/averis_protocol",
    "name": "Averis Protocol",
    "github": "https://github.com/mosaro0224/averis-protocol",
    "website": "https://averisprotocol.xyz",
    "audit_status": "unaudited — testnet only. Do not use with real funds until a third-party audit is completed.",
    "security_contact": "https://x.com/averis_protocol"
  },
  "passport": {
    "chains": {
      "rh_testnet": {
        "name": "Robinhood Chain Testnet",
        "chain_id": 46630,
        "contracts": {
          "AgentPolicyRegistry": "0xf7F47493E2f042a428a531724bE62854002979cA",
          "AgentReceiptRegistry": "0x3477e203fCFFbfe0E419E230d115d7C80A22BB18"
        }
      },
      "arc_testnet": {
        "name": "Arc Testnet",
        "note": "Financingcontracts live here; Passport contracts deploy here after RH Testnet",
        "chain_id": 5042002
      }
    },
    "api_base": "https://api.averisprotocol.xyz/v2/agents",
    "mcp_tools": [
      {
        "auth": false,
        "name": "passport_get",
        "description": "Full agent passport"
      },
      {
        "auth": false,
        "name": "passport_policies_list",
        "description": "Agent policy commitments"
      },
      {
        "auth": false,
        "name": "passport_receipts_list",
        "description": "Verified activity receipts"
      },
      {
        "auth": false,
        "name": "passport_reputation",
        "description": "Reputation score"
      },
      {
        "auth": false,
        "name": "passport_risk",
        "description": "Risk metrics"
      },
      {
        "auth": true,
        "name": "passport_policy_commit",
        "description": "Commit a new policy"
      }
    ],
    "description": "Agent Economic Passport — a cross-chain, non-custodial identity and reputation layer for autonomous agents. Agents commit to capability policies on-chain (EIP-712), and verified economic activity is anchored as receipts. No funds held; identity is ERC-8004 linked.",
    "identity_registry": "0x8004A818BFB912233c491871b3d84c89A494BD9e",
    "identity_standard": "ERC-8004",
    "passport_agent_journey": [
      {
        "step": 1,
        "action": "GET /v2/agents/:address/passport",
        "description": "Full passport — identity, policies, receipts, reputation, risk"
      },
      {
        "step": 2,
        "action": "GET /v2/agents/:address/policies",
        "description": "EIP-712 signed policy commitments and their on-chain commitment hashes"
      },
      {
        "step": 3,
        "action": "POST /v2/agents/:address/policies",
        "description": "Commit a new capability policy (EIP-712 signed, stored offchain + optionally anchored)"
      },
      {
        "step": 4,
        "action": "GET /v2/agents/:address/receipts",
        "description": "Verified economic activity receipts: Averis jobs, external attestations, self-reported"
      },
      {
        "step": 5,
        "action": "GET /v2/agents/:address/reputation",
        "description": "Computed reputation score and component breakdown"
      },
      {
        "step": 6,
        "action": "GET /v2/agents/:address/risk",
        "description": "Risk assessment: default rate, exposure, concentration metrics"
      }
    ]
  },
  "products": {
    "finance": {
      "chain": "Arc Testnet (5042002)",
      "launch_url": "https://averisprotocol.xyz/app",
      "description": "Job-backed working capital. Agent draws up to 40% of job budget into a controlled spending pool. 2% flat fee added at repayment. Non-recourse. Repayment automatic via ReceivableRouter lien."
    },
    "passport": {
      "chains": [
        "Arc Testnet (5042002)",
        "Robinhood Chain Testnet (46630)"
      ],
      "launch_url": "https://averisprotocol.xyz/passport",
      "description": "Verifiable onchain identity and reputation. ERC-8004 identity token, EIP-712 policy commitments in AgentPolicyRegistry, append-only economic receipts in AgentReceiptRegistry. Cross-chain: Arc Testnet + Robinhood Chain Testnet.",
      "erc8004_registries": {
        "note": "CREATE2-deterministic. Same addresses on Arc Testnet and Robinhood Chain Testnet.",
        "IdentityRegistry": "0x8004A818BFB912233c491871b3d84c89A494BD9e",
        "ReputationRegistry": "0x8004B663056A597Dffe9eCcC1965A193B7388713",
        "ValidationRegistry": "0x8004Cb1BF31DAf7788923b405b754f57acEB4272"
      },
      "passport_contracts": {
        "chain_id": 46630,
        "AgentPolicyRegistry": "0xf7F47493E2f042a428a531724bE62854002979cA",
        "AgentReceiptRegistry": "0x3477e203fCFFbfe0E419E230d115d7C80A22BB18"
      }
    }
  },
  "contracts": {
    "AverisACP": "0x3477e203fCFFbfe0E419E230d115d7C80A22BB18",
    "AverisHood": "0xd7D8633804FfdB3504Ba6F8036b26536f3d89E0a",
    "AverisVault": "0xf7F47493E2f042a428a531724bE62854002979cA",
    "AverisCredit": "0x9330790C74E71f16ef568c4CD6ca06662A611dd9",
    "AverisReserve": "0x9069f069467578c1F4B6f2385c6B52Ca86f8DDf5",
    "AverisACPAdapter": "0x8753aE3c8fACf0C352c4b786AF44D8eBF383D62A",
    "ReceivableRouter": "0x0b2C571D2FD5199b758d426340CF8260515eFF15",
    "AverisFinancingV2": "0x102eC41EDdeed916012D7B345c42e7Be64AD2051",
    "AverisPoolFactory": "0x69e875801822ffcA3C34022a2E2363d26688259a",
    "ExternalJobAdapter": "0xbd07EBa80Bf4b6F6999A6951Af05beC11BC833bb",
    "AverisAdapterRegistry": "0x0D6DBfaeAf74b45642064E6bA27F02c69872f4B0"
  },
  "repayment": {
    "mode_lien": "Automatic — job settlement routed through ReceivableRouter → AverisFinancingV2 → vault. No agent action required.",
    "mode_obligation": "EIP-712 signed repayment obligation. Agent must call repayObligation() after settlement.",
    "default_handling": "If job expires or is rejected, unused pool capital is returned to vault. Net loss is written off against vault NAV."
  },
  "description": "Two-product onchain infrastructure for autonomous AI agents. Averis Finance provides job-backed working capital — an agent with a funded job draws a controlled spending pool and repays automatically from the job receivable. Averis Passport provides verifiable onchain identity and reputation — ERC-8004 identity tokens, EIP-712 policy commitments, and an append-only receipt registry, readable cross-chain.",
  "capabilities": [
    "agent_working_capital",
    "agent_financing",
    "agent_liquidity",
    "ai_agent_funding",
    "usdc_financing",
    "erc8183_financing",
    "agentic_finance",
    "job_backed_credit",
    "controlled_spending_pool",
    "receivable_financing",
    "external_job_financing",
    "agent_identity",
    "agent_reputation",
    "erc8004_identity",
    "policy_commitments",
    "economic_receipts",
    "cross_chain_reputation",
    "agent_passport"
  ],
  "network_note": "Currently live on Arc Testnet (chain 5042002). Mainnet deployment is on the roadmap. USDC on this network has no real-world value.",
  "passport_api": {
    "note": "Action endpoints return unsigned transactions (Option A). The agent signs and broadcasts from their own wallet. No private key is held by the API.",
    "read_endpoints": [
      "GET /v2/agents/:address/passport",
      "GET /v2/agents/:address/identity",
      "GET /v2/agents/:address/capabilities",
      "GET /v2/agents/:address/policies",
      "GET /v2/agents/:address/reputation",
      "GET /v2/agents/:address/risk",
      "GET /v2/agents/:address/transactions",
      "GET /v2/agents/:address/counterparties",
      "GET /v2/agents/:address/agreements",
      "GET /v2/agents/:address/receipts"
    ],
    "action_endpoints": [
      "POST /v2/passport/identity/prepare-mint   — returns unsigned calldata to mint ERC-8004 identity on Arc or Robinhood Chain Testnet",
      "POST /v2/passport/identity/verify         — verifies agent identity onchain across Arc + Robinhood Chain Testnet",
      "POST /v2/passport/policy/prepare-commit   — returns unsigned calldata to commit EIP-712 policy to AgentPolicyRegistry"
    ]
  },
  "agent_journey": [
    {
      "auth": false,
      "step": 1,
      "action": "discover",
      "endpoint": "GET /v1/discover",
      "description": "Get capabilities, contracts, live parameters, and auth instructions"
    },
    {
      "auth": false,
      "step": 2,
      "action": "eligibility",
      "endpoint": "GET /v1/agents/{address}/eligibility",
      "description": "Check credit profile, available credit, and active exposure"
    },
    {
      "auth": false,
      "step": 3,
      "action": "verify_job",
      "endpoint": "POST /v2/jobs/verify",
      "description": "Confirm job is funded, active, and lien is correctly established"
    },
    {
      "auth": false,
      "step": 4,
      "action": "quote",
      "endpoint": "POST /v2/credit/quote",
      "description": "Get financing terms: approved amount, fee, total repayment, expiry, and terms_hash. Verify terms_hash hasn't changed before submitting draw()."
    },
    {
      "auth": true,
      "step": 5,
      "action": "fund",
      "endpoint": "on-chain AverisFinancingV2.draw()",
      "description": "Submit draw() transaction — creates job-specific controlled spending pool"
    },
    {
      "auth": false,
      "step": 6,
      "action": "pool_status",
      "endpoint": "GET /v2/pools/:poolAddress",
      "description": "Monitor pool balance, spending limits, allowed recipients, and expiry"
    },
    {
      "auth": true,
      "step": 7,
      "action": "spend",
      "endpoint": "POST /v2/pools/:poolAddress/spend",
      "description": "Get validated spend() calldata — agent submits from its own wallet"
    },
    {
      "auth": false,
      "step": 8,
      "action": "position",
      "endpoint": "GET /v2/positions/:jobId",
      "description": "Track financing position lifecycle and automatic repayment status"
    },
    {
      "auth": false,
      "step": 9,
      "action": "settlement",
      "endpoint": "automatic on-chain",
      "description": "Job settlement triggers ReceivableRouter — principal + fee repaid, remainder to agent"
    }
  ],
  "authentication": {
    "type": "eip712",
    "types": {
      "AgentRequest": [
        {
          "name": "agentAddress",
          "type": "address"
        },
        {
          "name": "nonce",
          "type": "uint256"
        },
        {
          "name": "expiry",
          "type": "uint256"
        },
        {
          "name": "chainId",
          "type": "uint256"
        }
      ]
    },
    "domain": {
      "name": "AverisProtocol",
      "version": "2"
    },
    "header": "X-Agent-Signature",
    "description": "Mutating requests require an EIP-712 signature over {agentAddress, nonce, expiry, chainId} in the X-Agent-Signature header. Discovery, eligibility, and quote endpoints are unauthenticated.",
    "primaryType": "AgentRequest",
    "authenticated_endpoints": [
      "POST /v2/pools/:poolAddress/spend",
      "POST /v1/mcp (averis_request_funding, averis_repay)"
    ],
    "unauthenticated_endpoints": [
      "GET /v1/discover",
      "GET /.well-known/agent-card.json",
      "GET /openapi.json",
      "GET /health",
      "GET /v1/agents/{address}/eligibility",
      "POST /v2/jobs/verify",
      "POST /v2/credit/quote",
      "GET /v2/positions/:jobId",
      "GET /v2/pools/:poolAddress",
      "POST /v1/mcp (tools/list, averis_discover, averis_protocol_status, averis_check_eligibility, averis_get_quote, averis_pool_status, averis_position_status)"
    ]
  },
  "protocol_terms": {
    "note": "Live values read from AverisFinancingV2 on Arc Testnet. These are the actual on-chain parameters.",
    "example": {
      "note": "Agent draws 400 and receives 400 in the controlled spending pool. No fee is deducted at draw. The 8 USDC fee (2%) is added at repayment. At settlement: Averis receives 408 (principal 400 + fee 8), agent receives 592 plus any unspent pool balance. Total agent cost = 8 USDC.",
      "job_budget_usdc": 1000,
      "max_advance_usdc": 400,
      "financing_fee_usdc": 8,
      "advance_to_pool_usdc": 400,
      "total_repayment_usdc": 408,
      "settlement_remainder_to_agent_usdc": 592
    },
    "fee_split": {
      "lp_pct": 70,
      "reserve_pct": 10,
      "treasury_pct": 20
    },
    "usdc_decimals": 6,
    "advance_rate_bps": 4000,
    "advance_rate_pct": 40,
    "financing_fee_bps": 200,
    "financing_fee_pct": 2,
    "max_per_agent_raw": "10000000000",
    "max_per_agent_usdc": 10000,
    "protocol_maximum_raw": "50000000000",
    "protocol_maximum_usdc": 50000
  },
  "repayment_note": "Non-recourse financing. If a job fails, is rejected, or expires: unspent pool capital is swept back to vault automatically, net loss is written off against vault NAV, and agent exposure is released. No personal liability, no on-chain blacklist. The protocol owner may reduce an agent's credit limit after repeated defaults. Protocol terms (advance rate, fee, caps) are owner-adjustable.",
  "schema_version": "1.0",
  "mainnet_roadmap": [
    "Third-party security audit of AverisFinancingV2, AverisJobPool, AverisHood, AverisReserve",
    "Third-party security audit of AgentPolicyRegistry and AgentReceiptRegistry",
    "LP deposits to seed vault liquidity",
    "Gnosis Safe multisig treasury",
    "Arc Mainnet deployment",
    "Passport contracts on Arc Mainnet",
    "Additional ERC-8183 adapter registrations for external job protocols"
  ],
  "protocol_status": {
    "note": "Static values only. For live TVL, liquidity, and hood status query GET /v1/discover or the averis_protocol_status MCP tool.",
    "contracts_wired": true,
    "adapter_registered": true,
    "contracts_deployed": true,
    "live_status_endpoint": "https://api.averisprotocol.xyz/v1/discover"
  },
  "passport_agent_journey": [
    {
      "auth": false,
      "step": "P1",
      "action": "prepare_mint_identity",
      "endpoint": "POST /v2/passport/identity/prepare-mint",
      "description": "Get unsigned calldata to mint an ERC-8004 identity token. Send {wallet, agentId, metadataURI, chainId}. Broadcast returned transaction from agent wallet."
    },
    {
      "auth": false,
      "step": "P2",
      "action": "verify_identity",
      "endpoint": "POST /v2/passport/identity/verify",
      "description": "Verify an agent identity onchain across Arc Testnet and Robinhood Chain Testnet. Send {wallet} or {agentId}. Returns verified identities per chain."
    },
    {
      "auth": false,
      "step": "P3",
      "action": "prepare_policy_commit",
      "endpoint": "POST /v2/passport/policy/prepare-commit",
      "description": "Get unsigned calldata to commit an EIP-712 policy hash to AgentPolicyRegistry on Robinhood Chain Testnet. Send {wallet, agentId, policyHash, contentURIHash, expiresAt}. Broadcast returned transaction from agent wallet."
    }
  ],
  "eligibility_requirements": [
    "Job must exist in a registered adapter protocol (AverisACP, ExternalJobAdapter, or any ERC-8183 compatible platform whitelisted by the protocol owner)",
    "Job must be funded and active (status: FUNDED)",
    "Caller must be the job provider/agent address",
    "Job payout receiver must be set to AverisReceivableRouter before funding (LIEN mode) or agent must sign EIP-712 RepaymentObligation (OBLIGATION mode)",
    "Job must not have expired",
    "Job must not already have an active financing position",
    "Requested amount must not exceed the minimum of: 40% of job budget, the agent credit limit, the protocol maximum (50,000 USDC), and available vault liquidity"
  ]
}