{
  "name": "0xClearinghouse",
  "description": "Machine-to-machine billing and batched settlement for autonomous software. Off-chain tabs in a local ledger, settled as native USDC transfers on EVM L2s.",
  "status": "pre-alpha — no published SDK",
  "license": "MIT",
  "homepage": "https://0xclearinghouse.xyz",
  "repository": "https://github.com/0xclearinghouse/0xclearinghouse-protocol",
  "documentation": {
    "quickstart": "https://0xclearinghouse.xyz/quickstart.html",
    "architecture": "https://github.com/0xclearinghouse/0xclearinghouse-protocol/blob/main/docs/ARCHITECTURE.md",
    "settlement": "https://github.com/0xclearinghouse/0xclearinghouse-protocol/blob/main/docs/SETTLEMENT.md",
    "llms": "https://0xclearinghouse.xyz/llms.txt"
  },
  "packages": [
    {
      "name": "@0xclearinghouse/core",
      "version": "0.1.0",
      "published_version": "0.0.1",
      "publishable": false,
      "status": "placeholder only — do not integrate yet",
      "purpose": "ledger, thresholds, settlement plan and executor (source complete, unpublished)"
    },
    {
      "name": "@0xclearinghouse/elizaos",
      "status": "planned",
      "purpose": "elizaOS plugin"
    },
    {
      "name": "@0xclearinghouse/vercel-ai",
      "status": "planned",
      "purpose": "tool-call middleware"
    },
    {
      "name": "@0xclearinghouse/langgraph",
      "status": "planned",
      "purpose": "graph payment gates"
    }
  ],
  "install": {
    "command": "npm install @0xclearinghouse/core",
    "runtime": "node",
    "node": ">=22",
    "ready": false,
    "note": "The npm name is reserved. 0.0.1 is an empty placeholder; the SDK is not published yet. Source: https://github.com/0xclearinghouse/0xclearinghouse-protocol"
  },
  "chains": [
    {
      "name": "base",
      "chainId": 8453,
      "default": true,
      "usdc": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "explorer": "https://basescan.org"
    },
    {
      "name": "arbitrum",
      "chainId": 42161,
      "usdc": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
      "explorer": "https://arbiscan.io"
    },
    {
      "name": "optimism",
      "chainId": 10,
      "usdc": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
      "explorer": "https://optimistic.etherscan.io"
    }
  ],
  "defaults": {
    "settle_threshold_micro_usdc": 1000000,
    "settle_max_age_hours": 12,
    "protocol_fee_bps": 50,
    "usdc_decimals": 6
  },
  "environment": {
    "AGENT_WALLET_KEY": "EVM private key of the paying wallet (never commit)",
    "CLEARINGHOUSE_CHAIN": "base | arbitrum | optimism",
    "SETTLE_THRESHOLD_USDC": "decimal string, default 1.00",
    "SETTLE_INTERVAL_HOURS": "integer, default 12",
    "LEDGER_DRIVER": "sqlite | postgres",
    "PROTOCOL_TREASURY_ADDRESS": "recipient of the protocol fee",
    "PROTOCOL_FEE_BPS": "integer, default 50",
    "COORDINATOR_API_KEY": "optional, unlocks telemetry sync"
  },
  "security": {
    "custody": "non-custodial; the protocol never holds funds",
    "report": "https://github.com/0xclearinghouse/0xclearinghouse-protocol/security/advisories/new"
  }
}