{
  "network": {
    "name": "AdValorem Capability Network",
    "version": "1.0",
    "operator": "AdValorem",
    "base_url": "https://agentic.advalorem.io",
    "registry_url": "https://agentic.advalorem.io/registry",
    "status_url": "https://agentic.advalorem.io/status",
    "docs_url": "https://agentic.advalorem.io/api",
    "auth_methods": [
      "x402",
      "bearer",
      "flashbots-signature"
    ],
    "settlement_currency": "USDC",
    "settlement_chain": "base",
    "spec_version": "capability-network/1.0",
    "operational_status": "degraded",
    "operational_status_since": "2026-07-20T14:08:00Z",
    "operational_status_notes": "Builder submission service is offline pending Rust bidder patch. See bundle-submit capability status for details. This is an honest, self-declared degradation."
  },
  "capabilities": [
    {
      "id": "bundle-submit",
      "name": "Bundle Submit",
      "version": "1.0",
      "description": "Submit an Ethereum bundle to our own rbuilder for block construction and 4-relay fanout (Flashbots, Titan, Aestus, Agnostic). Honest true-value bidding, no shared searcher pool, no sandwich exposure.",
      "category": "execution",
      "endpoint": "https://builder.advalorem.io/rpc",
      "method": "POST",
      "authentication": "flashbots-signature",
      "x402": false,
      "x402_planned": true,
      "price": "0.10",
      "currency": "USDC",
      "price_model": "per_bundle",
      "latency_ms_p50": 420,
      "latency_ms_p99": 1200,
      "success_rate_30d": null,
      "availability": false,
      "input_schema": {
        "type": "object",
        "properties": {
          "jsonrpc": {
            "const": "2.0"
          },
          "method": {
            "const": "eth_sendBundle"
          },
          "params": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "txs": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "description": "RLP-encoded signed tx hex"
                  }
                },
                "blockNumber": {
                  "type": "string",
                  "description": "hex block number"
                },
                "minTimestamp": {
                  "type": "integer"
                },
                "maxTimestamp": {
                  "type": "integer"
                },
                "revertingTxHashes": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              },
              "required": [
                "txs",
                "blockNumber"
              ]
            }
          },
          "id": {
            "type": "integer"
          }
        }
      },
      "output_schema": {
        "type": "object",
        "properties": {
          "jsonrpc": {
            "const": "2.0"
          },
          "result": {
            "oneOf": [
              {
                "type": "null",
                "description": "accepted-and-queued"
              },
              {
                "type": "object",
                "properties": {
                  "bundleHash": {
                    "type": "string"
                  }
                }
              }
            ]
          },
          "id": {
            "type": "integer"
          }
        }
      },
      "example_request": "curl -X POST https://builder.advalorem.io/rpc -H 'Content-Type: application/json' -H 'X-Flashbots-Signature: 0xADDR:0xSIG' -d '{\"jsonrpc\":\"2.0\",\"method\":\"eth_sendBundle\",\"params\":[{\"txs\":[\"0x...\"],\"blockNumber\":\"0x...\"}],\"id\":1}'",
      "example_response": "{\"jsonrpc\":\"2.0\",\"result\":null,\"id\":1}",
      "status": "degraded",
      "degraded_since": "2026-07-20T14:08:00Z",
      "reason": "rbuilder bidder patch in progress. Audit on 2026-07-20 found the 0.001 ETH subsidy was draining coinbase principal per win (net -0.01965 ETH across 21 blocks in 81 minutes). Subsidy zeroed in config; Rust guard patch pending (min_profit, uncertainty_reserve, coinbase floor, daily_subsidy_cap). Bundle submission will not be accepted for inclusion until the patched bidder is deployed and 500-slot shadow auction validates positive retained margin."
    },
    {
      "id": "liquidation-search",
      "name": "Liquidation Search",
      "version": "1.0",
      "description": "Stream of imminent on-chain liquidation events across Aave v3, Compound v3, Morpho, and Spark. Ranked by profit-after-gas. Real-time WebSocket or polling JSON.",
      "category": "opportunity",
      "endpoint": "https://agentic.advalorem.io/v1/liquidation-search",
      "method": "GET",
      "authentication": "bearer",
      "x402": false,
      "x402_planned": true,
      "price": "0.02",
      "currency": "USDC",
      "price_model": "per_query",
      "latency_ms_p50": 180,
      "latency_ms_p99": 500,
      "success_rate_30d": null,
      "availability": false,
      "input_schema": {
        "type": "object",
        "properties": {
          "min_profit_usd": {
            "type": "number",
            "default": 50
          },
          "protocols": {
            "type": "array",
            "items": {
              "enum": [
                "aave-v3",
                "compound-v3",
                "morpho",
                "spark"
              ]
            }
          },
          "chain": {
            "enum": [
              "ethereum",
              "base",
              "arbitrum"
            ],
            "default": "ethereum"
          }
        }
      },
      "output_schema": {
        "type": "object",
        "properties": {
          "opportunities": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "protocol": {
                  "type": "string"
                },
                "borrower": {
                  "type": "string"
                },
                "collateral_token": {
                  "type": "string"
                },
                "debt_token": {
                  "type": "string"
                },
                "collateral_usd": {
                  "type": "number"
                },
                "debt_usd": {
                  "type": "number"
                },
                "health_factor": {
                  "type": "number"
                },
                "estimated_profit_usd": {
                  "type": "number"
                },
                "deadline_block": {
                  "type": "integer"
                }
              }
            }
          }
        }
      },
      "example_request": "curl 'https://agentic.advalorem.io/v1/liquidation-search?min_profit_usd=100' -H 'Authorization: Bearer $TOKEN'",
      "example_response": "{\"opportunities\":[{\"protocol\":\"aave-v3\",\"borrower\":\"0x...\",\"health_factor\":0.98,\"estimated_profit_usd\":142.30,\"deadline_block\":22843012}]}",
      "status": "planned",
      "reason": "Not implemented. Previously mislabeled as available; corrected 2026-07-20."
    },
    {
      "id": "wallet-monitor",
      "name": "Wallet Monitor",
      "version": "1.0",
      "description": "Subscribe to any Ethereum, Base, or Arbitrum wallet. Get webhook callbacks on inbound/outbound transfers, contract interactions, and position changes. Sub-second delivery on same-AZ Reth node.",
      "category": "signal",
      "endpoint": "https://agentic.advalorem.io/v1/wallet-monitor",
      "method": "POST",
      "authentication": "bearer",
      "x402": false,
      "x402_planned": true,
      "price": "0.001",
      "currency": "USDC",
      "price_model": "per_event_delivered",
      "latency_ms_p50": 450,
      "latency_ms_p99": 1100,
      "success_rate_30d": null,
      "availability": false,
      "input_schema": {
        "type": "object",
        "required": [
          "addresses",
          "webhook_url"
        ],
        "properties": {
          "addresses": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "chains": {
            "type": "array",
            "items": {
              "enum": [
                "ethereum",
                "base",
                "arbitrum"
              ]
            }
          },
          "events": {
            "type": "array",
            "items": {
              "enum": [
                "transfer_in",
                "transfer_out",
                "contract_call",
                "position_change"
              ]
            }
          },
          "webhook_url": {
            "type": "string",
            "format": "uri"
          }
        }
      },
      "output_schema": {
        "type": "object",
        "properties": {
          "subscription_id": {
            "type": "string"
          },
          "expires_at": {
            "type": "integer"
          }
        }
      },
      "example_request": "curl -X POST https://agentic.advalorem.io/v1/wallet-monitor -H 'Authorization: Bearer $TOKEN' -d '{\"addresses\":[\"0xabc...\"],\"chains\":[\"ethereum\"],\"events\":[\"transfer_in\"],\"webhook_url\":\"https://your-agent.example/hook\"}'",
      "example_response": "{\"subscription_id\":\"sub_abc123\",\"expires_at\":1795104000}",
      "status": "planned",
      "reason": "Not implemented. Previously mislabeled as available; corrected 2026-07-20."
    },
    {
      "id": "arbitrage-search",
      "name": "Arbitrage Search",
      "version": "0.1",
      "description": "Real-time DEX arbitrage opportunities across Uniswap v2/v3/v4, Curve, Balancer, and Maverick. Includes execution path, expected profit, and pre-signed bundle template.",
      "category": "opportunity",
      "endpoint": "https://agentic.advalorem.io/v1/arbitrage-search",
      "method": "GET",
      "authentication": "bearer",
      "x402": false,
      "x402_planned": true,
      "price": "0.03",
      "currency": "USDC",
      "price_model": "per_query",
      "latency_ms_p50": null,
      "latency_ms_p99": null,
      "success_rate_30d": null,
      "availability": false,
      "coming_soon": true,
      "eta": "2026-08-15"
    },
    {
      "id": "portfolio-analysis",
      "name": "Portfolio Analysis",
      "version": "0.1",
      "description": "Real-time analysis of any wallet's on-chain position: total value, protocol exposure, risk score, PnL, impermanent-loss exposure. Multi-chain aggregation.",
      "category": "analysis",
      "endpoint": "https://agentic.advalorem.io/v1/portfolio-analysis",
      "method": "GET",
      "authentication": "bearer",
      "x402": false,
      "x402_planned": true,
      "price": "0.01",
      "currency": "USDC",
      "price_model": "per_query",
      "latency_ms_p50": null,
      "latency_ms_p99": null,
      "success_rate_30d": null,
      "availability": false,
      "coming_soon": true,
      "eta": "2026-08-30"
    },
    {
      "id": "contract-simulation",
      "name": "Contract Simulation",
      "version": "0.1",
      "description": "Simulate any transaction against current mainnet state. Returns gas usage, state diff, event logs, revert reasons. Runs on our own Reth node, no third-party dependency.",
      "category": "analysis",
      "endpoint": "https://agentic.advalorem.io/v1/simulate",
      "method": "POST",
      "authentication": "bearer",
      "x402": false,
      "x402_planned": true,
      "price": "0.005",
      "currency": "USDC",
      "price_model": "per_simulation",
      "latency_ms_p50": null,
      "latency_ms_p99": null,
      "success_rate_30d": null,
      "availability": false,
      "coming_soon": true,
      "eta": "2026-09-15"
    },
    {
      "id": "research",
      "name": "Research",
      "version": "0.1",
      "description": "Structured research over on-chain data, protocol docs, and current market context. Returns a JSON report with sources cited to primary Etherscan/GitHub/protocol sources.",
      "category": "intelligence",
      "endpoint": "https://agentic.advalorem.io/v1/research",
      "method": "POST",
      "authentication": "bearer",
      "x402": false,
      "x402_planned": true,
      "price": "0.03",
      "currency": "USDC",
      "price_model": "per_report",
      "latency_ms_p50": null,
      "latency_ms_p99": null,
      "success_rate_30d": null,
      "availability": false,
      "coming_soon": true,
      "eta": "2026-09-30"
    }
  ],
  "metric_definitions": {
    "bids_received": "Count of bid attempts internally constructed by rbuilder for a slot. Not a relay event.",
    "submits": "Count of relay submit RPCs sent (all 4 relays; a single won slot can produce many submits).",
    "accepted": "Count of relay 'accepted' HTTP responses. NOT the same as blocks won. Many acceptances precede one delivered payload per slot.",
    "blocks_won": "TO ADD: Count of blocks where relay proposer_payload_delivered.builder_pubkey == our BLS pubkey.",
    "gross_block_value": "TO ADD: Sum of priority_fee_revenue + direct_coinbase_transfers across won blocks (ETH).",
    "validator_payments": "TO ADD: Sum of payout tx values across won blocks (ETH).",
    "builder_retained_profit": "TO ADD: gross_block_value - validator_payments - payout_gas (ETH).",
    "subsidy_spent": "TO ADD: Sum of subsidy contribution to bids across won blocks (ETH). Currently 0 (subsidy zeroed).",
    "net_builder_profit": "TO ADD: builder_retained_profit - subsidy_spent (ETH).",
    "private_orderflow_value": "TO ADD: Sum of bundle-coinbase-payments from private bundles (ETH). Currently 0 landed.",
    "external_bundles_landed": "TO ADD: Count of externally-submitted bundles included in won blocks. Currently 0."
  }
}