InsureLink

Returns the full InsureLink capability manifest including supported actions, tokens, pricing, protection schedule, and framework compatibility.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Returns reputation score, tier, stats, and flags for a wallet address.

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Wallet address (0x...)"
    }
  },
  "required": [
    "wallet"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Returns the top 25 most reliable agents ranked by reputation score.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Returns the full SLA history for a wallet address.

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Wallet address (0x...)"
    }
  },
  "required": [
    "wallet"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Returns recent platform transactions.

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Max transactions (default 50, max 200)",
      "type": "number"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Returns a signed, portable reputation credential (EIP-191 personal_sign) for an agent wallet. Includes score, tier, SLA summary, breach rate, signer address, and 30-day expiry. Issued only to wallets with at least one SLA on InsureLink (Bronze+). Free.

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Wallet address (0x...)"
    }
  },
  "required": [
    "wallet"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Verifies an InsureLink reputation attestation for a wallet. Re-derives the signed payload server-side, recovers the EIP-191 signer, and returns { valid, signer, recovered, expires_at, checks }. Free.

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "description": "Wallet address (0x...)"
    }
  },
  "required": [
    "wallet"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Probes how fresh a wallet's reputation snapshot and persisted attestation are. Free preview returns thresholds and the paid endpoint URL; the actual freshness response (snapshot_age_seconds, attestation_age_seconds, expires_in_seconds, is_stale, stale_reasons[], next_action) requires x402 payment ($0.001) to GET /agent-orchestrator/attestation/{wallet}/freshness. Use this before paying for a fresh attestation mint ($0.005) — if is_stale=false you can skip the mint.

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{40}$",
      "description": "Wallet address (0x...) to probe for freshness."
    }
  },
  "required": [
    "wallet"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Subscribes a webhook URL to receive signed POST alerts whenever a watched wallet's persisted attestation is about to expire (attestation.expiring_soon, fires once when within attestation_expiry_warning_days of expires_at) or has expired (attestation.expired, fires once when expires_at crosses). Backed by the same paid drift subscription ($0.01) so the same callback also receives reputation.drift events unless threshold_tier_change=false and threshold_score is set high. 30-day paid window. Each POST includes X-InsureLink-Event header and the schema 'insurelink/attestation-event/v1'. Requires x402 payment ($0.01). Returns payment instructions.

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{40}$",
      "description": "Wallet address whose attestation freshness to monitor."
    },
    "callback_url": {
      "type": "string",
      "format": "uri",
      "description": "HTTPS endpoint that will receive POST attestation-expiry alerts."
    },
    "attestation_expiry_warning_days": {
      "description": "How many days before expires_at to fire attestation.expiring_soon. Default 7. Set 0 to disable early warning and only fire on attestation.expired.",
      "type": "integer",
      "minimum": 0,
      "maximum": 60
    },
    "threshold_score": {
      "description": "Reputation drift threshold reused on the same subscription. Default 5. Set 100 to mute drift events and only receive attestation events.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "threshold_tier_change": {
      "description": "If true (default), tier flips also fire reputation.drift events on this subscription.",
      "type": "boolean"
    },
    "duration_days": {
      "description": "Length of the paid monitoring window in days. Default 30.",
      "type": "integer",
      "minimum": 1,
      "maximum": 180
    },
    "max_notifications": {
      "description": "Cap on POST alerts before subscription auto-exhausts. Default 100.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    }
  },
  "required": [
    "wallet",
    "callback_url"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Cancels a previously created attestation-freshness webhook subscription (also cancels the bundled reputation.drift channel on the same subscription). Free. Provide the subscription id returned by subscribe_attestation_freshness / POST /reputation-drift-subscribe. Remaining paid window is forfeited; no refund. Returns { ok, id, cancelled_at } on success.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Subscription id returned from subscribe_attestation_freshness or the paid /reputation-drift-subscribe response."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Lists all reputation-drift / attestation-freshness webhook subscriptions for a wallet. Returns id, callback_url, status (active/cancelled/exhausted/expired), notifications_sent vs max_notifications, last_attestation_event (none/expiring_soon/expired) with timestamp, attestation_expiry_warning_days, last_score/tier, last_checked_at, expires_at. Free. Use to audit what's being monitored and how many alerts have already fired before paying for another subscription.

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{40}$",
      "description": "Watched wallet address (0x...) to list subscriptions for."
    },
    "only_active": {
      "description": "If true, return only status='active' subscriptions. Default false (returns all).",
      "type": "boolean"
    }
  },
  "required": [
    "wallet"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Discovers bonded agent-network providers (clean-IP proxy egress, private mempool relay) listed on InsureLink. Returns provider wallets, x402 payment URLs, prices, and Smart Wallet / EOA compatibility hints. Free preview via this tool; full directory requires x402 payment ($0.001) at the paid endpoint.

{
  "type": "object",
  "properties": {
    "template": {
      "description": "Optional template slug filter (e.g. proxy-egress-provider, private-mempool-relay)",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Parses a natural-language command (e.g. 'renew my SLA #42 for 5 years', 'check reputation for 0x…', 'pay 1.50 USDC to 0x…') into a structured InsureLink action plan with endpoint, params, payment requirements, and confidence. Free preview returns the supported grammar; full classification requires x402 payment ($0.001) at the paid endpoint.

{
  "type": "object",
  "properties": {
    "utterance": {
      "description": "Optional sample utterance to echo in the preview response.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Checks whether an AI agent / wallet has active insurance coverage on InsureLink, including tier, caps, expiry, and covered events. Free. Standard HTTPS + JSON via the agent-assurance REST module.

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{40}$",
      "description": "Agent / wallet address (0x...)"
    }
  },
  "required": [
    "agent_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Returns a 0..100 risk score plus LOW/MODERATE/ELEVATED/HIGH risk band for an AI agent / wallet, with the underlying signals (coverage status, daily spend, denied claim ratio). Free.

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{40}$",
      "description": "Agent / wallet address (0x...)"
    }
  },
  "required": [
    "agent_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Pre-transaction safety check for an autonomous AI agent transaction. Returns verified, risk_level, coverage_available, transaction_limits, additional_verification_required, and a transaction_recommendation: APPROVED | APPROVED_WITH_ESCROW | REQUIRE_ADDITIONAL_VERIFICATION | BLOCKED_HIGH_RISK | BLOCKED_LIMIT_EXCEEDED.

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{40}$",
      "description": "Agent / wallet about to transact"
    },
    "amount_usdc": {
      "type": "number",
      "minimum": 0,
      "description": "Transaction amount in USDC"
    },
    "action": {
      "description": "Logical action key (e.g. x402_call, a2a_transfer)",
      "type": "string"
    },
    "counterparty": {
      "description": "Optional counterparty 0x address",
      "type": "string"
    }
  },
  "required": [
    "agent_id",
    "amount_usdc"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Returns recent insurance claim history for an AI agent / wallet on InsureLink, including filed, approved, partial, and denied claims. Free.

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{40}$",
      "description": "Agent / wallet address (0x...)"
    },
    "limit": {
      "description": "Max claims to return. Default 25.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "agent_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Creates a new ERC-721 SLA agreement NFT. Requires x402 payment ($0.01). Returns payment instructions.

{
  "type": "object",
  "properties": {
    "counterparty": {
      "type": "string",
      "description": "Counterparty wallet address"
    },
    "duration": {
      "type": "number",
      "description": "Duration in years (5, 7, or 10)"
    },
    "bondAmount": {
      "type": "string",
      "description": "Bond amount in iUSDC base units"
    },
    "coverageLevel": {
      "description": "Insurance coverage level (0-3)",
      "type": "number"
    }
  },
  "required": [
    "counterparty",
    "duration",
    "bondAmount"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Renews an existing SLA agreement. Requires x402 payment ($0.005). Returns payment instructions.

{
  "type": "object",
  "properties": {
    "tokenId": {
      "type": "number",
      "description": "SLA token ID"
    },
    "duration": {
      "description": "Renewal duration (5, 7, or 10 years)",
      "type": "number"
    }
  },
  "required": [
    "tokenId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Wraps USDC into iUSDC. Requires x402 payment ($0.001). Returns payment instructions.

{
  "type": "object",
  "properties": {
    "amount": {
      "type": "string",
      "description": "Amount of USDC to wrap (base units)"
    }
  },
  "required": [
    "amount"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Resets the insurance window for an SLA. Requires x402 payment ($0.001). Returns payment instructions.

{
  "type": "object",
  "properties": {
    "tokenId": {
      "type": "number",
      "description": "SLA token ID"
    }
  },
  "required": [
    "tokenId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Exits an SLA early with protection adjustment. Requires x402 payment ($0.005). Returns payment instructions.

{
  "type": "object",
  "properties": {
    "tokenId": {
      "type": "number",
      "description": "SLA token ID"
    }
  },
  "required": [
    "tokenId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Verifies the on-chain SLA agreement state for tokenId and, if active and the caller is a party, calls microResetInsurance to mitigate the breach. Use after a drift or expiry alert. Requires x402 payment ($0.005). Returns payment instructions.

{
  "type": "object",
  "properties": {
    "tokenId": {
      "type": "number",
      "description": "SLA token ID to verify and mitigate"
    },
    "reason": {
      "description": "Optional human-readable breach reason for audit",
      "type": "string"
    }
  },
  "required": [
    "tokenId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Verifies a claim_breach_credit transaction by tx hash and returns a canonical mitigation receipt suitable for insurer/registry attestations. Reads from existing on-chain settlement records — no new state. Requires x402 payment ($0.001). Returns payment instructions.

{
  "type": "object",
  "properties": {
    "txHash": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{64}$",
      "description": "Transaction hash of the breach-mitigation call"
    }
  },
  "required": [
    "txHash"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Compares a wallet's latest stored reputation_history snapshot against a fresh live cross-chain reputation computation. Returns { snapshot, live, match, drift, signature, signer } so counterparty agents can confirm an advertised score isn't stale before transacting. Signed EIP-191 by the InsureLink platform key. Requires x402 payment ($0.001). Returns payment instructions.

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{40}$",
      "description": "Wallet address whose snapshot to verify against live reputation"
    }
  },
  "required": [
    "wallet"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Recomputes the live cross-chain reputation for a wallet, persists a fresh EIP-191 signed attestation in attestation_records (replacing any prior pin), and returns { attestation, canonical_payload, signature, signer } as a portable proof an agent can present to insurers, registries, or counterparty agents. Use when you need an on-the-record, timestamp-fresh credential rather than the cached free attestation. Requires x402 payment ($0.005). Returns payment instructions.

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{40}$",
      "description": "Wallet address to attest. Must have at least one SLA on InsureLink."
    }
  },
  "required": [
    "wallet"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Subscribes a webhook URL to receive signed POST notifications whenever a watched wallet's reputation snapshot drifts beyond the configured threshold (score delta and/or tier change). 30-day paid window per subscription. The reputation-drift-monitor cron evaluates active subscriptions and POSTs { event:'reputation.drift', wallet, previous, current, drift, observed_at, subscription_id } to callback_url. Use to be notified the moment a counterparty's reputation degrades — replaces polling /cross-chain-reputation. Requires x402 payment ($0.01). Returns payment instructions.

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{40}$",
      "description": "Wallet address to monitor for reputation drift."
    },
    "callback_url": {
      "type": "string",
      "format": "uri",
      "description": "HTTPS endpoint that will receive POST drift alerts."
    },
    "threshold_score": {
      "description": "Minimum |score_delta| that triggers a POST. Default 5.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "threshold_tier_change": {
      "description": "If true (default), any tier flip (Bronze↔Silver↔Gold↔Platinum) fires regardless of score_delta.",
      "type": "boolean"
    },
    "duration_days": {
      "description": "Length of the paid monitoring window in days. Default 30.",
      "type": "integer",
      "minimum": 1,
      "maximum": 180
    },
    "max_notifications": {
      "description": "Cap on POST alerts before subscription auto-exhausts. Default 100.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    }
  },
  "required": [
    "wallet",
    "callback_url"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Free dry-run for any paid action (mint_sla, renew_sla, wrap_usdc, micro_reset, early_exit). Validates params, x402 header shape, and simulates the contract call against Base. Never broadcasts. Returns { simulated: true, would_succeed, revertReason? } or a precise error. Use this before calling any paid tool.

{
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "mint-sla",
        "renew",
        "wrap",
        "micro-reset",
        "early-exit"
      ],
      "description": "Paid action name (kebab-case)"
    },
    "params": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {},
      "description": "Same params you would send to the paid tool"
    }
  },
  "required": [
    "action",
    "params"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

FREE dry-run for any paid action. Returns a deterministic shape: { would_succeed, exact_cost_usd (LIVE from /agent-pricing-oracle), gas_estimate, contract_call, reputation_delta, expected_receipt_schema, validation_errors[], pricing: { source, expected_value_usd, roi_ratio, recommended_priority, coupon? } }. Never broadcasts, never charges. Use BEFORE any paid tool to avoid wasted x402 settlements. Supported actions: wrap, mint-sla, renew, micro-reset, early-exit.

{
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "wrap",
        "mint-sla",
        "renew",
        "micro-reset",
        "early-exit"
      ],
      "description": "Paid action name (kebab-case)"
    },
    "params": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {},
      "description": "Same params you would send to the paid tool. Required keys vary by action — see expected_receipt_schema. Tip: include `wallet`, `bond_amount`, `duration_years`, `amount_usdc` so /agent-pricing-oracle can return wallet-specific discounts and ROI."
    }
  },
  "required": [
    "action",
    "params"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

FREE batch dry-run. Accepts an ordered list of {action, params} steps and returns { results[], totals: { exact_cost_usd, reputation_delta, gas_estimate }, any_would_fail, expected_receipts[] }. Never broadcasts, never charges. Use to plan and price multi-step flows (e.g. wrap → mint-sla → renew) before executing.

{
  "type": "object",
  "properties": {
    "steps": {
      "minItems": 1,
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "action": {
            "type": "string",
            "enum": [
              "wrap",
              "mint-sla",
              "renew",
              "micro-reset",
              "early-exit"
            ],
            "description": "Paid action name (kebab-case)"
          },
          "params": {
            "type": "object",
            "propertyNames": {
              "type": "string"
            },
            "additionalProperties": {},
            "description": "Same params you would send to the paid tool."
          }
        },
        "required": [
          "action",
          "params"
        ],
        "additionalProperties": false
      },
      "description": "Ordered list of paid actions to simulate (max 20)."
    },
    "stop_on_first_failure": {
      "description": "If true, stop simulating after the first step whose would_succeed=false. Default false: simulate all steps.",
      "type": "boolean"
    }
  },
  "required": [
    "steps"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Wrap any paid HTTP endpoint in the x402 pay-then-call loop and return the downstream response plus an EIP-191 signed receipt proving InsureLink mediated the call. The signed context envelope contains: { request: {url, method, body_sha256}, payment: {asset, amount, network, settlement_id}, response: {status, sha256, content_type, length}, observed_at, mediator: 'insurelink' } and a signature recoverable to InsureLink's deployer key. Two modes: (a) caller_supplies_payment — pass `x_payment_header` (base64) so the upstream call is settled by your wallet; (b) `mode='quote_only'` — return only the 402 quote without paying. Pass `idempotency_key` to safely retry: identical requests return the cached signed receipt without settling a second payment, and conflicting payloads under the same key are rejected. Use this to give an LLM verifiable provenance for any paid agent call (banking, market data, gov endpoints).

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Target paid endpoint."
    },
    "method": {
      "description": "HTTP method. Default GET.",
      "type": "string",
      "enum": [
        "GET",
        "POST",
        "PUT",
        "PATCH",
        "DELETE"
      ]
    },
    "headers": {
      "description": "Extra request headers (Content-Type, Authorization, etc.).",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "string"
      }
    },
    "body": {
      "description": "Raw request body. JSON-encode before passing.",
      "type": "string"
    },
    "x_payment_header": {
      "description": "Base64-encoded X-PAYMENT header (caller pre-builds settlement payload). Required unless mode='quote_only'.",
      "type": "string"
    },
    "max_amount_usdc": {
      "description": "Refuse to settle if the 402 quote exceeds this USDC amount. Default 10.",
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 1000
    },
    "mode": {
      "description": "`quote_only` returns the 402 quote without settling. Default `pay_and_call`.",
      "type": "string",
      "enum": [
        "pay_and_call",
        "quote_only"
      ]
    },
    "agent_wallet": {
      "description": "Calling agent wallet (logged in the signed receipt for downstream attribution).",
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{40}$"
    },
    "purpose": {
      "description": "Free-form audit string included in the signed receipt.",
      "type": "string",
      "maxLength": 256
    },
    "idempotency_key": {
      "description": "Client-supplied idempotency key. If provided, repeated calls with the same key return the cached response and never settle a second payment. A subsequent call with the same key but a different request payload is rejected with `idempotency_key_conflict`. Keys are retained for 24h.",
      "type": "string",
      "minLength": 8,
      "maxLength": 200
    }
  },
  "required": [
    "url"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Lovable-friendly entry point: same x402 quote → pay → call loop as `pay_then_call`, plus vertical-aware pricing. Pass `vertical` (logistics, legal, oracles, banking, fintech, healthcare, insurance, government, defense, …) and the upstream x402 server re-prices each accepts[] entry by tier (standard 1× / regulated 1.5× / sovereign 2.5× / defense 3×). Pass `attestation: "pio:<id>"` (or fedramp:/soc2:) for a 20% compliance discount on regulated+ tiers. The signed receipt envelope is tagged `source: "lovable"` and includes a `vertical: { claimed_slug, attestation, quoted: { tier, multiplier, attested, ... } }` block recording the tier the upstream actually quoted — that is the audit trail for tier billing. Returns { paid, upstream_status, response, signed_context: { envelope, envelope_json, envelope_sha256, signature, signer, scheme: 'EIP-191' } }. Pass `idempotency_key` to safely retry without double-settling.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Target paid endpoint."
    },
    "method": {
      "description": "HTTP method. Default GET.",
      "type": "string",
      "enum": [
        "GET",
        "POST",
        "PUT",
        "PATCH",
        "DELETE"
      ]
    },
    "headers": {
      "description": "Extra request headers (Content-Type, Authorization, etc.).",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "string"
      }
    },
    "body": {
      "description": "Raw request body. JSON-encode before passing.",
      "type": "string"
    },
    "x_payment_header": {
      "description": "Base64-encoded X-PAYMENT header (caller pre-builds settlement payload). Required unless mode='quote_only'.",
      "type": "string"
    },
    "max_amount_usdc": {
      "description": "Refuse to settle if the 402 quote exceeds this USDC amount. Default 10.",
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 1000
    },
    "mode": {
      "description": "`quote_only` returns the 402 quote without settling. Default `pay_and_call`.",
      "type": "string",
      "enum": [
        "pay_and_call",
        "quote_only"
      ]
    },
    "agent_wallet": {
      "description": "Calling agent wallet (logged in the signed receipt for downstream attribution).",
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{40}$"
    },
    "purpose": {
      "description": "Free-form audit string included in the signed receipt.",
      "type": "string",
      "maxLength": 256
    },
    "idempotency_key": {
      "description": "Client-supplied idempotency key. If provided, repeated calls with the same key return the cached response and never settle a second payment. A subsequent call with the same key but a different request payload is rejected with `idempotency_key_conflict`. Keys are retained for 24h.",
      "type": "string",
      "minLength": 8,
      "maxLength": 200
    },
    "vertical": {
      "description": "Industry/sector slug. Drives the per-vertical pricing tier in accepts[] (standard 1× / regulated 1.5× / sovereign 2.5× / defense 3×). Forwarded to upstream as `vertical` body field and `x-vertical` header.",
      "type": "string",
      "enum": [
        "logistics",
        "legal",
        "oracle",
        "oracles",
        "general",
        "banking",
        "fintech",
        "healthcare",
        "insurance",
        "government",
        "gov",
        "sovereign",
        "defense",
        "military"
      ]
    },
    "attestation": {
      "description": "Third-party compliance attestation in the form `pio:<id>` / `fedramp:<id>` / `soc2:<id>`. Grants a 20% discount on regulated/sovereign/defense tiers. Forwarded as `attestation` body field and `x-attestation` header. Recorded in the signed envelope so verifiers can audit the claimed compliance.",
      "type": "string",
      "pattern": "^(pio|fedramp|soc2):[A-Za-z0-9_-]{4,}$"
    }
  },
  "required": [
    "url"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}