Agent commerce: 27 tools, 10 production services, signed authority, planning, Base USDC x402.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Paid URL: 0.10 USDC per call on Base; 10 signed-wallet free calls shared over rolling 30 days. Read the backend 402 body for x402 terms. Preview whether an action fits the supplied scope, budget, usage, expiry and fee limits. Operating boundary: Supply the policy, usage and proposed action. Read the preview and reasons. An agent uses them to prepare the next request; a human adjusts the policy or approves the action through its service. POST /api/agent-allowance-console. Existing product credentials, signed mandates, and single-use action grants remain required where applicable. This adapter grants no authority and never supplies server credentials. This current operation is a bounded computation on caller-supplied data.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Paid URL: 0.10 USDC per call on Base; 10 signed-wallet free calls shared over rolling 30 days. Read the backend 402 body for x402 terms. Preview whether an action fits the supplied scope, budget, usage, expiry and fee limits. Operating boundary: Supply the policy, usage and proposed action. Read the preview and reasons. An agent uses them to prepare the next request; a human adjusts the policy or approves the action through its service. POST /api/agent-allowance-console. Existing product credentials, signed mandates, and single-use action grants remain required where applicable. This adapter grants no authority and never supplies server credentials. This current operation is a bounded computation on caller-supplied data.
| Argument | Type | Description |
|---|---|---|
| mode* | any | |
| as_of* | string | |
| agent_id* | string | |
| currency* | any | |
| max_runs* | integer | |
| used_runs* | integer | |
| expires_at* | string | |
| spent_minor* | integer | |
| budget_minor* | integer | |
| max_fee_minor* | integer | |
| requested_fee_minor* | integer | |
| allowed_product_keys* | array | |
| requested_product_key* | string |
{
"type": "object",
"required": [
"mode",
"agent_id",
"allowed_product_keys",
"requested_product_key",
"currency",
"budget_minor",
"spent_minor",
"requested_fee_minor",
"max_fee_minor",
"max_runs",
"used_runs",
"expires_at",
"as_of"
],
"properties": {
"mode": {
"const": "evaluate_allowance"
},
"as_of": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}Z(?![\\s\\S])"
},
"agent_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}(?![\\s\\S])",
"maxLength": 64,
"minLength": 1
},
"currency": {
"const": "USD"
},
"max_runs": {
"type": "integer",
"maximum": 1000000,
"minimum": 0
},
"used_runs": {
"type": "integer",
"maximum": 1000000,
"minimum": 0
},
"expires_at": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}Z(?![\\s\\S])"
},
"spent_minor": {
"type": "integer",
"maximum": 1000000000000,
"minimum": 0
},
"budget_minor": {
"type": "integer",
"maximum": 1000000000000,
"minimum": 0
},
"max_fee_minor": {
"type": "integer",
"maximum": 1000000000000,
"minimum": 0
},
"requested_fee_minor": {
"type": "integer",
"maximum": 1000000000000,
"minimum": 0
},
"allowed_product_keys": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}(?![\\s\\S])",
"maxLength": 64,
"minLength": 1
},
"maxItems": 16,
"minItems": 1,
"uniqueItems": true
},
"requested_product_key": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}(?![\\s\\S])",
"maxLength": 64,
"minLength": 1
}
},
"additionalProperties": false
}Paid URL: 0.10 USDC per call on Base; 10 signed-wallet free calls shared over rolling 30 days. Read the backend 402 body for x402 terms. Compare a proposed request with the policy, usage and budget values you supply and return an allow-or-deny preview. Operating boundary: Supply policy, usage and request values. Read the preview and reasons. An agent checks the preview before the payment flow; a human sets the budget and approves any exception. POST /api/agent-budget-guard. Existing product credentials, signed mandates, and single-use action grants remain required where applicable. This adapter grants no authority and never supplies server credentials. This current money service follows its published inspection, policy evaluation or private invoice contract. Payment is an API access fee and grants no spending authority.
| Argument | Type | Description |
|---|---|---|
| mode* | any | |
| usage* | object | |
| policy* | object | |
| request* | object | |
| agent_id* | string |
{
"type": "object",
"required": [
"mode",
"agent_id",
"policy",
"usage",
"request"
],
"properties": {
"mode": {
"const": "evaluate_action"
},
"usage": {
"type": "object",
"required": [
"spent_minor",
"used_runs",
"as_of"
],
"properties": {
"as_of": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}Z(?![\\s\\S])"
},
"used_runs": {
"type": "integer",
"maximum": 1000000,
"minimum": 0
},
"spent_minor": {
"type": "integer",
"maximum": 1000000000000,
"minimum": 0
}
},
"additionalProperties": false
},
"policy": {
"type": "object",
"required": [
"policy_id",
"agent_id",
"currency",
"budget_minor",
"max_action_fee_minor",
"max_runs",
"allowed_rails",
"allowed_callback_origins",
"callback_required",
"not_before",
"expires_at"
],
"properties": {
"agent_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}(?![\\s\\S])",
"maxLength": 64,
"minLength": 1
},
"currency": {
"const": "USD"
},
"max_runs": {
"type": "integer",
"maximum": 1000000,
"minimum": 0
},
"policy_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}(?![\\s\\S])",
"maxLength": 64,
"minLength": 1
},
"expires_at": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}Z(?![\\s\\S])"
},
"not_before": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}Z(?![\\s\\S])"
},
"budget_minor": {
"type": "integer",
"maximum": 1000000000000,
"minimum": 0
},
"allowed_rails": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}(?![\\s\\S])",
"maxLength": 64,
"minLength": 1
},
"maxItems": 16,
"minItems": 0,
"uniqueItems": true
},
"callback_required": {
"type": "boolean"
},
"max_action_fee_minor": {
"type": "integer",
"maximum": 1000000000000,
"minimum": 0
},
"allowed_callback_origins": {
"type": "array",
"items": {
"type": "string",
"maxLength": 256,
"minLength": 9,
"description": "Canonical HTTPS origin only, with no path, trailing slash, credentials, query or fragment. Matching uses the parsed request URL origin; no destination is contacted."
},
"maxItems": 16,
"minItems": 0,
"uniqueItems": true
}
},
"additionalProperties": false
},
"request": {
"type": "object",
"required": [
"rail_key",
"fee_minor",
"run_count",
"callback_url"
],
"properties": {
"rail_key": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}(?![\\s\\S])",
"maxLength": 64,
"minLength": 1
},
"fee_minor": {
"type": "integer",
"maximum": 1000000000000,
"minimum": 0,
"description": "Total fee for this action request in USD cents, including all requested runs. It is not multiplied by run_count."
},
"run_count": {
"type": "integer",
"maximum": 1000000,
"minimum": 1
},
"callback_url": {
"anyOf": [
{
"type": "string",
"maxLength": 2048,
"minLength": 9,
"description": "ASCII HTTPS URL without credentials, control characters, backslashes or fragment. Its normalized origin is compared exactly with allowed_callback_origins. No request is sent."
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"agent_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}(?![\\s\\S])",
"maxLength": 64,
"minLength": 1
}
},
"additionalProperties": false
}Paid URL: 0.25 USDC per call on Base; 10 signed-wallet free calls shared over rolling 30 days. Free computation: /api/mcp or /api/service-resolver. Read the backend 402 body for x402 terms. Turn supplied service health and queue observations into a prioritized operator brief. Operating boundary: Supply service health and queue observations. Read the ordered priorities and their source observations. Agents prepare the brief; humans use it to choose the next operational task. POST /api/agent-daily-operator-brief. Existing product credentials, signed mandates, and single-use action grants remain required where applicable. This adapter grants no authority and never supplies server credentials. This current operation is a bounded computation on caller-supplied data.
| Argument | Type | Description |
|---|---|---|
| as_of* | string | A valid UTC calendar timestamp with whole seconds, supplied by the caller. |
| queues* | array | Unique queue names. Empty queues must have a null or zero oldest age. |
| services* | array | Unique service_id values. |
{
"type": "object",
"required": [
"as_of",
"services",
"queues"
],
"properties": {
"as_of": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}Z(?![\\s\\S])",
"description": "A valid UTC calendar timestamp with whole seconds, supplied by the caller."
},
"queues": {
"type": "array",
"items": {
"type": "object",
"required": [
"queue",
"state",
"count",
"oldest_age_seconds"
],
"properties": {
"count": {
"type": "integer",
"maximum": 2147483647,
"minimum": 0
},
"queue": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]{0,63}(?![\\s\\S])",
"maxLength": 64,
"minLength": 1
},
"state": {
"enum": [
"active",
"retained"
]
},
"oldest_age_seconds": {
"anyOf": [
{
"type": "integer",
"maximum": 2147483647,
"minimum": 0
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"maxItems": 16,
"description": "Unique queue names. Empty queues must have a null or zero oldest age."
},
"services": {
"type": "array",
"items": {
"type": "object",
"required": [
"service_id",
"status"
],
"properties": {
"status": {
"enum": [
"ready",
"unavailable",
"degraded"
]
},
"service_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]{0,63}(?![\\s\\S])",
"maxLength": 64,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 8,
"description": "Unique service_id values."
}
},
"additionalProperties": false
}Paid URL: 0.10 USDC per call on Base; 10 signed-wallet free calls shared over rolling 30 days. Read the backend 402 body for x402 terms. Evaluate supplied alternatives against explicit weighted numeric criteria and constraints, with transparent scores, evidence gaps and ties. Operating boundary: Submit alternatives, numeric criteria, weights and constraints. Read the resulting scores alongside missing evidence, failed constraints and tied alternatives. POST /api/agent-decision-packet-rail. Existing product credentials, signed mandates, and single-use action grants remain required where applicable. This adapter grants no authority and never supplies server credentials. Wallet-authenticated bounded operations service with durable records. See /api/operations-contract for exact schemas, verified scope and unavailable capabilities.
| Argument | Type | Description |
|---|---|---|
| mode* | any | |
| usage* | any | |
| options* | array | |
| criteria* | array | |
| objective* | string | |
| constraints* | array | |
Paid URL: 0.10 USDC per call on Base; 10 signed-wallet free calls shared over rolling 30 days. Read the backend 402 body for x402 terms. Escrow principal and API-fee wallet: 0x69255FeaC86268C0D0bD0CBd128da7B9aB44b1c4. Principal funding is separate, and every call requires a signed wallet ownership proof. Managed Base USDC custody with verified funding, immutable parties, EIP-712 release policies, expiry refunds to the payer and a durable public release log. Operating boundary: Create an escrow with a fixed payer, payee, amount and expiry. Fund it with Base USDC, then use the signed release policy to pay the payee or receive an expiry refund as the payer. Agents call the escrow tools; humans review and sign the funding and release terms. API fees and escrow principal are separate amounts. POST /api/agent-escrow-lite. Existing product credentials, signed mandates, and single-use action grants remain required where applicable. This adapter grants no authority and never supplies server credentials. This managed custody service uses immutable escrow parties and EIP-712 release policies. Releases pay only the payee; expiry refunds pay only the payer. Public logs report durable state and transaction evidence. Work-order grants do not authorize payment.
| Argument | Type | Description |
|---|---|---|
| mode* | any | |
| terms | object | |
| mandate | object | |
| escrow_id | string | |
| funding_payment | any |
Paid URL: 0.10 USDC per call on Base; 10 signed-wallet free calls shared over rolling 30 days. Read the backend 402 body for x402 terms. Inspect supplied file bytes, compute content hashes, identify exact duplicates and report bounded content metadata. Operating boundary: Send inline file bytes in a supported format. The response includes content hashes, exact duplicates and metadata. The input schema lists size and format limits. POST /api/agent-file-desk-rail. Existing product credentials, signed mandates, and single-use action grants remain required where applicable. This adapter grants no authority and never supplies server credentials. Wallet-authenticated bounded operations service with durable records. See /api/operations-contract for exact schemas, verified scope and unavailable capabilities.
| Argument | Type | Description |
|---|---|---|
| mode* | any | |
| files* | array | |
| usage* | any | |
| idempotency_key* | string |
{
"type": "object",
"required": [
"idempotency_key",
"usage",
"mode",
"files"
],
"properties": {
"mode": {
"const": "inspect"
},
"files": {
"type": "array",
"items": {
"type": "object",
"required": [
"file_id",
"name",
"content_base64",
"expected_sha256"
],
"properties": {
"name": {
"type": "string",
"pattern": "^[^/\\\\\\u0000-\\u001f\\u007f]+(?![\\s\\S])",
"maxLength": 160,
"minLength": 1
},
"file_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}(?![\\s\\S])"
},
"content_base64": {
"type": "string",
"pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?(?![\\s\\S])",
"maxLength": 43692
},
"expected_sha256": {
"anyOf": [
{
"type": "string",
"pattern": "^[a-f0-9]{64}(?![\\s\\S])"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"maxItems": 16,
"minItems": 1
},
"usage": {
"enum": [
"synthetic",
"operational"
]
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}(?![\\s\\S])"
}
},
"additionalProperties": false
}Paid URL: 0.10 USDC per call on Base; 10 signed-wallet free calls shared over rolling 30 days. Read the backend 402 body for x402 terms. Keep a private issuer-wallet ledger of invoice amounts, parties, run references and the issuer’s review. Operating boundary: Sign issuer-wallet ownership proof, create the invoice record and attach run references. The issuer reviews those references and records the result. Agents manage the ledger through the API; humans inspect it through their agent. Payment collection uses the separate Invoices product. POST /api/agent-invoice-rail. Existing product credentials, signed mandates, and single-use action grants remain required where applicable. This adapter grants no authority and never supplies server credentials. This current money service follows its published inspection, policy evaluation or private invoice contract. Payment is an API access fee and grants no spending authority.
| Argument | Type | Description |
|---|---|---|
| mode* | string | |
| note | string | |
| usage | any | |
| decision | any | |
| rail_key | string | |
| expires_at | integer | |
| invoice_id | string |
Paid URL: 0.10 USDC per call on Base; 10 signed-wallet free calls shared over rolling 30 days. Read the backend 402 body for x402 terms. Turn a task into an ordered plan of supported computations, with the fields needed for each step. Operating boundary: Supply the task and supported steps. Read the ordered plan and required fields. An agent submits each prepared step through its listed service; a human reviews the sequence and budget first. POST /api/agent-paid-workflow. Existing product credentials, signed mandates, and single-use action grants remain required where applicable. This adapter grants no authority and never supplies server credentials. This current operation is a bounded computation on caller-supplied data.
| Argument | Type | Description |
|---|---|---|
| mode* | any | |
| agent_id* | string | |
| constraints* | object | |
| product_key* | any |
{
"type": "object",
"required": [
"mode",
"agent_id",
"product_key",
"constraints"
],
"properties": {
"mode": {
"const": "prepare_workflow"
},
"agent_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}(?![\\s\\S])",
"maxLength": 64,
"minLength": 1
},
"constraints": {
"type": "object",
"required": [
"max_steps",
"include_checkout_estimate",
"include_allowance_preview",
"include_proof_preparation"
],
"properties": {
"max_steps": {
"type": "integer",
"maximum": 5,
"minimum": 1
},
"include_allowance_preview": {
"type": "boolean"
},
"include_checkout_estimate": {
"type": "boolean"
},
"include_proof_preparation": {
"type": "boolean"
}
},
"additionalProperties": false
},
"product_key": {
"enum": [
"diligenceops-paid-run",
"mcp-diligence-rail",
"agent-daily-operator-brief",
"agent-work-order-rail"
]
}
},
"additionalProperties": false
}Paid URL: 0.10 USDC per call on Base; 10 signed-wallet free calls shared over rolling 30 days. Read the backend 402 body for x402 terms. Persist wallet-scoped permission grants and revocations and evaluate an exact subject, action and resource against those records. Operating boundary: Record a permission grant or revocation for a subject, action and resource. Query those records to make an access decision in the target system. POST /api/agent-permission-ledger. Existing product credentials, signed mandates, and single-use action grants remain required where applicable. This adapter grants no authority and never supplies server credentials. Wallet-authenticated bounded operations service with durable records. See /api/operations-contract for exact schemas, verified scope and unavailable capabilities.
| Argument | Type | Description |
|---|---|---|
| mode* | any | |
| limit | integer | |
| usage | any | |
| action | string | |
| offset | integer | |
| reason | string | |
| actions | array | |
| grant_id |
Paid URL: 0.10 USDC per call on Base; 10 signed-wallet free calls shared over rolling 30 days. Read the backend 402 body for x402 terms. Record wallet-scoped SLA terms and evaluate deadlines against retained completed-work or callback observations. Operating boundary: Save your wallet’s service terms and deadlines, then evaluate them against retained work and callback observations. Read the result to identify completed and overdue commitments. POST /api/agent-sla-rail. Existing product credentials, signed mandates, and single-use action grants remain required where applicable. This adapter grants no authority and never supplies server credentials. Wallet-authenticated bounded operations service with durable records. See /api/operations-contract for exact schemas, verified scope and unavailable capabilities.
| Argument | Type | Description |
|---|---|---|
| mode* | any | |
| label | string | |
| usage | any | |
| sla_id | string | |
| deadline_at | integer | |
| retry_limit | integer | |
| callback_url | any | |
| expected_work |
Paid URL: 0.10 USDC per call on Base; 10 signed-wallet free calls shared over rolling 30 days. Read the backend 402 body for x402 terms. Build and verify durable signed task handoff packs with authenticated sender, recipient, context, declared permissions and checkpoint state. Operating boundary: Build and verify durable signed task handoff packs with authenticated sender, recipient, context, declared permissions and checkpoint state. The sender builds a pack, the recipient verifies it and applies the declared permissions, and a human reviews the context and next step. Sign wallet ownership proof for each request. POST /api/agent-to-agent-handoff-pack. Existing product credentials, signed mandates, and single-use action grants remain required where applicable. This adapter grants no authority and never supplies server credentials. Wallet-authenticated durable trust service. Signed records attest only to the stated evidence and permission scope. See /api/trust-contract for the public verification key and bounded contract.
| Argument | Type | Description |
|---|---|---|
| mode* | any | |
| task | object | |
| state | object | |
| usage | any | |
| permissions | object | |
| handoff_pack | string | |
Paid URL: 0.10 USDC per call on Base; 10 signed-wallet free calls shared over rolling 30 days. Read the backend 402 body for x402 terms. Compute a bounded trust score from verified completed work, Base payment receipts and Wever escrow refunds, disclosing all inputs and unavailable dispute coverage. Operating boundary: Compute a bounded trust score from verified completed work, Base payment receipts and Wever escrow refunds, disclosing all inputs and unavailable dispute coverage. Agents compare the disclosed inputs; humans review the completed-work, payment and refund evidence. Scores summarize the records covered by this service. Sign wallet ownership proof for each request. POST /api/agent-trust-scorecard. Existing product credentials, signed mandates, and single-use action grants remain required where applicable. This adapter grants no authority and never supplies server credentials. Wallet-authenticated durable trust service. Signed records attest only to the stated evidence and permission scope. See /api/trust-contract for the public verification key and bounded contract.
| Argument | Type | Description |
|---|---|---|
| mode* | any | |
| payments* | array | |
| completed_work* | array |
{
"type": "object",
"required": [
"mode",
"completed_work",
"payments"
],
"properties": {
"mode": {
"const": "compute"
},
"payments": {
"type": "array",
"items": {
"type": "object",
"required": [
"transaction_hash",
"payee",
"amount_atomic",
"authorization_nonce"
],
"properties": {
"payee": {
"type": "string",
"pattern": "^0x(?!0{40})[a-fA-F0-9]{40}(?![\\s\\S])"
},
"amount_atomic": {
"type": "string",
"pattern": "^[1-9][0-9]{0,11}(?![\\s\\S])"
},
"transaction_hash": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{64}(?![\\s\\S])"
},
"authorization_nonce": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{64}(?![\\s\\S])"
}
},
"additionalProperties": false
},
"maxItems": 5,
"uniqueItems": true
},
"completed_work": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"kind",
"nonce"
],
"properties": {
"kind": {
"const": "wallet_free_call"
},
"nonce": {
"type": "string",
"pattern": "^[a-f0-9]{32,64}(?![\\s\\S])"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"payment_id"
],
"properties": {
"kind": {
"const": "settled_payment"
},
"payment_id": {
"type": "string",
"pattern": "^[a-f0-9]{64}(?![\\s\\S])"
}
},
"additionalProperties": false
}
]
},
"maxItems": 10,
"uniqueItems": true
}
},
"additionalProperties": false
}Paid URL: 0.10 USDC per call on Base; 10 signed-wallet free calls shared over rolling 30 days. Read the backend 402 body for x402 terms. Validate a task with a local dry run, then prepare the POST request for its supported computation. Operating boundary: Choose a supported computation and supply its task fields. Review validation and the prepared POST request. The agent submits that request to the named endpoint; the human reviews the task and result. POST /api/agent-work-order-exchange. Existing product credentials, signed mandates, and single-use action grants remain required where applicable. This adapter grants no authority and never supplies server credentials. This current operation is a bounded computation on caller-supplied data.
| Argument | Type | Description |
|---|---|---|
| mode* | any | |
| task* | object | |
| product_key* | any | |
| requested_outcome* | string | |
| requesting_agent_id* | string |
{
"type": "object",
"required": [
"mode",
"requesting_agent_id",
"product_key",
"requested_outcome",
"task"
],
"properties": {
"mode": {
"const": "prepare_work_order_exchange"
},
"task": {
"type": "object",
"maxProperties": 16
},
"product_key": {
"enum": [
"diligenceops-paid-run",
"mcp-diligence-rail",
"agent-daily-operator-brief",
"agent-work-order-rail"
]
},
"requested_outcome": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f]+(?![\\s\\S])",
"maxLength": 256,
"minLength": 1
},
"requesting_agent_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}(?![\\s\\S])",
"maxLength": 64,
"minLength": 1
}
},
"additionalProperties": false
}Paid URL: 0.10 USDC per call on Base; 10 signed-wallet free calls shared over rolling 30 days. Free computation: /api/mcp or /api/service-resolver. Read the backend 402 body for x402 terms. Prepare a validated DiligenceOps task for a specific Connect recipient. Submission, recipient permission and execution remain separate steps. Operating boundary: Supply the DiligenceOps task and Connect recipient. Read the validated task package. The agent submits it through Connect with the recipient’s permission; the human reviews the requested work and returned result. POST /api/agent-work-order-rail. Existing product credentials, signed mandates, and single-use action grants remain required where applicable. This adapter grants no authority and never supplies server credentials. This current operation is a bounded computation on caller-supplied data.
| Argument | Type | Description |
|---|---|---|
| service_id* | any | |
| recipient_id* | string | |
| expected_evidence* | array | |
| available_evidence* | array |
{
"type": "object",
"required": [
"service_id",
"recipient_id",
"available_evidence",
"expected_evidence"
],
"properties": {
"service_id": {
"const": "com.weverlabs/diligenceops-inventory"
},
"recipient_id": {
"type": "string",
"pattern": "^mbx_[a-f0-9]{24}(?![\\s\\S])",
"maxLength": 28,
"minLength": 28
},
"expected_evidence": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_.:/ -]+(?![\\s\\S])",
"maxLength": 96,
"minLength": 1,
"description": "Use a nonempty ASCII label up to 96 bytes before trimming. Each normalized label must be unique."
},
"maxItems": 16,
"minItems": 1
},
"available_evidence": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_.:/ -]+(?![\\s\\S])",
"maxLength": 96,
"minLength": 1,
"description": "Use a nonempty ASCII label up to 96 bytes before trimming. Each normalized label must be unique."
},
"maxItems": 16,
"minItems": 0
}
},
"additionalProperties": false
}Paid URL: 0.10 USDC per call on Base; 10 signed-wallet free calls shared over rolling 30 days. Read the backend 402 body for x402 terms. Verifies allowlisted AP2 direct closed-checkout mandates, binds the presenter to the holder wallet, rejects expiry and replay, and durably consumes each mandate once. Operating boundary: Submit a signed AP2 direct checkout mandate from a trusted provider. Sign wallet ownership proof as its holder. The gateway checks expiry and replay, binds the holder and records one-time consumption. Agents call the gateway; humans review the exact checkout intent and sign in their wallet. POST /api/ap2-mandate-gateway. Existing product credentials, signed mandates, and single-use action grants remain required where applicable. This adapter grants no authority and never supplies server credentials. This gateway verifies only its published AP2 direct closed-checkout profile, requires a trusted issuer and holder wallet proof, and consumes the mandate once. It does not execute the checkout or transfer funds. Start at /api/ap2-contract and /api/ap2-challenge.
| Argument | Type | Description |
|---|---|---|
| mode* | any | |
| presentation* | string | |
| challenge_token* | string |
{
"type": "object",
"required": [
"mode",
"presentation",
"challenge_token"
],
"properties": {
"mode": {
"const": "verify_mandate"
},
"presentation": {
"type": "string",
"maxLength": 32768,
"minLength": 1
},
"challenge_token": {
"type": "string",
"maxLength": 16384,
"minLength": 1
}
},
"additionalProperties": false
}Look up a covered tokenized asset by its id or ticker and return its full sourced Asset Passport, including taxonomy stage, six-field rights matrix, claim, backing, access, liquidity, risks and source trail. Reads the versioned Atlas reference dataset, not live market quotes. Each result preserves source dates and labels for provisional or unverified historical display data. POST /api/atlas-asset-passport. Paid URL: 0.10 USDC per call on Base mainnet using x402 exact, under the existing shared 10 signed-wallet free calls over rolling 30 days. X-Wever-Wallet-Proof must bind to the exact JSON arguments and this API path, not /mcp. The adapter forwards only caller-supplied proof and payment headers. Authority is read-only: no dataset or external writes, asset trading, autonomous source fetches, spending authority or publication. API access billing is separate: it records free usage or settles an explicit caller-supplied payment authorization. Read /api/atlas-contract and the backend 402 body for exact schemas and billing terms.
| Argument | Type | Description |
|---|---|---|
| asset* | string | A covered Atlas asset id or ticker, case-insensitive. Example: paxg or PAXG. |
{
"type": "object",
"required": [
"asset"
],
"properties": {
"asset": {
"type": "string",
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]*$",
"maxLength": 64,
"minLength": 1,
"description": "A covered Atlas asset id or ticker, case-insensitive. Example: paxg or PAXG."
}
},
"additionalProperties": false
}Search covered tokenized assets by literal text, category, stage or six rights filters and return paginated summaries with stage and rights. Empty arguments list all covered assets within the result limit. Reads the versioned Atlas reference dataset, not live market quotes. Each result preserves source dates and labels for provisional or unverified historical display data. POST /api/atlas-asset-search. Paid URL: 0.10 USDC per call on Base mainnet using x402 exact, under the existing shared 10 signed-wallet free calls over rolling 30 days. X-Wever-Wallet-Proof must bind to the exact JSON arguments and this API path, not /mcp. The adapter forwards only caller-supplied proof and payment headers. Authority is read-only: no dataset or external writes, asset trading, autonomous source fetches, spending authority or publication. API access billing is separate: it records free usage or settles an explicit caller-supplied payment authorization. Read /api/atlas-contract and the backend 402 body for exact schemas and billing terms.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| query | string | Case-insensitive literal text search over sourced asset fields. Combined with category when both are supplied. |
| stage | integer | Exact taxonomy stage: 1 wrapper, 2 issuer-sponsored, 3 native issuance. All supplied filters are combined. |
| offset | integer | |
| rights | object | Combine disclosed rights filters. Enumerated values match exactly. not disclosed matches missing public disclosure, not a negative right. |
Confirm simulated delivery of a shipped order with order_id, bearer order_token and delivery_reference. Reuses escrow-lite signed release and atomically credits the order-scoped simulated boutique treasury once. action=dispute invokes existing dispute-open service and native escrow freeze with claim {reason_code, statement_sha256}; action=dispute-submit-evidence and dispute-status use the existing dispute services in the same simulation store. action=status reads operator state. Disputed orders cannot release. Resolution remains operator-authorized through the existing dispute rail and is not exposed by this bridge. Simulation only, no real funds, shipping verification, wallet ownership assertion or real treasury configuration. The existing order token is a simulation capability, not merchant or buyer authentication. Rejects payment headers and simulation=false. 120 virtual USDC ceiling, 64 orders, 2 MiB, 24-hour expiry. Synthetic test records are isolated from production custody and dispute records. Real escrow/dispute caps and all other tools are unchanged.
| Argument | Type | Description |
|---|---|---|
| claim | object | |
| action | string | |
| order_id* | string | |
| references | array | |
| simulation | boolean | |
| order_token* | string | |
Simulation only. Create a boutique order with product_id and buyer_wallet. USD catalog amount maps exactly 1:1 to virtual USDC on the Base x402 pattern. Optional idempotency_key permits exact create retries; retain the returned bearer order_token. Repeat the same product_id and buyer_wallet with action=initiate_payment, simulate_payment, status, or confirm_fulfillment and order_token. Fulfillment confirmation also requires fulfillment_reference. Reuses existing x402 middleware and escrow-lite state machine with isolated synthetic settlement, no network signer or real funds. Simulation ceiling is 120 virtual USDC; real escrow remains capped at 25 USDC and real checkout is disabled. No merchant inventory reservation, shipping, tax, wallet ownership assertion, real payment authorization or actual fulfillment. All payment headers and simulation=false are rejected. Catalog tools remain read-only snapshots. No API fees or allowance consumption. Orders expire after 24 hours; bounded to 64 active simulations.
| Argument | Type | Description |
|---|---|---|
| action | string | |
| product_id* | string | |
| simulation | boolean | |
| order_token | string | |
| buyer_wallet* | string | |
| idempotency_key | string | |
| fulfillment_reference |
Browse Rebecca Belle Boutique products with stable IDs, names, prices, photos, availability and descriptive details. Supply store=women, men, kids, or home to browse a live collection with query, size, brand, category, min_price, max_price, nwt, sort, page, and page_size. Home offers home goods. Product IDs use rb-#####, mm-#####, lc-#####, and rh-##### respectively. The collections share a cart with $8 shipping per whole order and card payment through the boutique checkout. Collection and product records expose agent_purchase_enabled. Omit store and filters to read the legacy nine-piece seasonal snapshot. Catalog prices use 1 USD = 1 USDC; checkout calculates shipping and tax. Anonymous catalog reads are free.
| Argument | Type | Description |
|---|---|---|
| nwt | boolean | |
| page | integer | |
| size | string | |
| sort | string | |
| brand | string | |
| query | string | |
| store | string | |
| category | string | |
Read one Rebecca Belle Boutique product by its exact catalog ID. Supply store=women, men, kids, or home to browse a live collection with query, size, brand, category, min_price, max_price, nwt, sort, page, and page_size. Home offers home goods. Product IDs use rb-#####, mm-#####, lc-#####, and rh-##### respectively. The collections share a cart with $8 shipping per whole order and card payment through the boutique checkout. Collection and product records expose agent_purchase_enabled. Omit store and filters to read the legacy nine-piece seasonal snapshot. Catalog prices use 1 USD = 1 USDC; checkout calculates shipping and tax. Anonymous catalog reads are free.
| Argument | Type | Description |
|---|---|---|
| id* | string |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
}One owner-operated Rebecca Belle Boutique acceptance order for a dedicated 1.00 USDC test product on Base mainnet. No catalog items. Creates a bounded order, observes the existing managed escrow, records test shipment and delivery, and independently checks native USDC receipts. This tool never signs, submits or initiates transfers and rejects payment headers. quote is public; other actions require a request-bound X-Wever-Wallet-Proof for /api/boutique-real-money-acceptance and configured buyer/operator. The human executes separately approved funding and release through the unchanged wever_agent-escrow-lite tool. That rail has separate 0.10 USDC API fees after its free allowance and automatic expiry refunds. Test evidence is not customer revenue or actual merchandise fulfillment.
No arguments.
{
"type": "object",
"oneOf": [
{
"type": "object",
"required": [
"action"
],
"properties": {
"action": {
"const": "quote"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"action",
"idempotency_key"
],
"properties": {
"action": {
"const": "create_order"
},
"idempotency_key": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{16,64}$"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"action"
],
"properties": {
"action": {
"const": "status"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"action"
],
"properties": {
"action": {
"const": "verify_payment"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"action",
"carrier",
"tracking_number"
],
"properties": {
"action": {
"const": "record_shipment"
},
"carrier": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f]+$",
"maxLength": 128,
"minLength": 1
},
"tracking_number": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f]+$",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"action",
"delivery_reference"
],
"properties": {
"action": {
"const": "confirm_delivery"
},
"delivery_reference": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f]+$",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"action"
],
"properties": {
"action": {
"const": "verify_release"
}
},
"additionalProperties": false
}
]
}Record a simulated shipment against a funded boutique order using order_id, bearer order_token and tracking {carrier, tracking_number}. Marks shipped while keeping all virtual USDC in escrow. Exact retries are safe; conflicting tracking is rejected. Simulation only, no real funds, shipping verification, wallet ownership assertion or real treasury configuration. The existing order token is a simulation capability, not merchant or buyer authentication. Rejects payment headers and simulation=false. 120 virtual USDC ceiling, 64 orders, 2 MiB, 24-hour expiry. Synthetic test records are isolated from production custody and dispute records. Real escrow/dispute caps and all other tools are unchanged.
| Argument | Type | Description |
|---|---|---|
| order_id* | string | |
| tracking* | object | |
| simulation | boolean | |
| order_token* | string |
{
"type": "object",
"required": [
"order_id",
"order_token",
"tracking"
],
"properties": {
"order_id": {
"type": "string",
"pattern": "^bo_[a-f0-9]{64}$",
"maxLength": 67
},
"tracking": {
"type": "object",
"required": [
"carrier",
"tracking_number"
],
"properties": {
"carrier": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f]+$",
"maxLength": 80,
"minLength": 1
},
"tracking_number": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f]+$",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
},
"simulation": {
"type": "boolean",
"const": true,
"default": true
},
"order_token": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"maxLength": 64
}
},
"additionalProperties": false
}Paid URL: 0.10 USDC per call on Base; 10 signed-wallet free calls shared over rolling 30 days. Read the backend 402 body for x402 terms. Send a bounded HTTPS callback probe and persist the actual response, timing and exact acknowledgment check. Retrieve prior observations without resending. Operating boundary: Supply one public HTTPS callback URL and the acknowledgment you expect. The service makes one request, saves its timing and response, and lets you retrieve that observation later. Each new probe is an explicit call. POST /api/callback-health-monitor. Existing product credentials, signed mandates, and single-use action grants remain required where applicable. This adapter grants no authority and never supplies server credentials. Wallet-authenticated bounded operations service with durable records. See /api/operations-contract for exact schemas, verified scope and unavailable capabilities.
| Argument | Type | Description |
|---|---|---|
| mode* | any | |
| usage | any | |
| probe_id | string | |
| callback_url | string | |
| idempotency_key | string |
{
"type": "object",
"oneOf": [
{
"type": "object",
"required": [
"mode",
"idempotency_key",
"callback_url",
"usage"
],
"properties": {
"mode": {
"const": "probe"
},
"usage": {
"enum": [
"synthetic",
"operational"
]
},
"callback_url": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"idempotency_key": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,96}(?![\\s\\S])"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"mode",
"probe_id"
],
"properties": {
"mode": {
"const": "retrieve"
},
"probe_id": {
"type": "string",
"pattern": "^[a-f0-9]{64}(?![\\s\\S])"
}
},
"additionalProperties": false
}
],
"required": [
"mode"
],
"properties": {
"mode": {
"enum": [
"probe",
"retrieve"
]
},
"usage": {
"enum": [
"synthetic",
"operational"
]
},
"probe_id": {
"type": "string",
"pattern": "^[a-f0-9]{64}(?![\\s\\S])"
},
"callback_url": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"idempotency_key": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,96}(?![\\s\\S])"
}
},
"additionalProperties": false
}Paid URL: 2.00 USDC per mandate on Base; 10 signed-wallet free calls shared over rolling 30 days. Only issue_mandate is billed; GET, contract reads, drafts and all other modes have no x402 fee. Credentials and grants remain required for their existing operations. Read the backend 402 body for x402 terms. Issue signed mandates and approve an exact action. The named agent uses its grant to create an immutable work-order record. Operating boundary: The operator issues a mandate, then approves an action grant lasting up to 300 seconds. The credentialed agent consumes the grant once to create one work-order record. Inspect the same grant until its result is final. Mandate issuance costs 2 USDC after the free calls are used; reads, drafts and other authority modes use their existing credentials at no access fee. Work execution, delivery and payment each use their own service. POST /api/delegated-authority. Existing product credentials, signed mandates, and single-use action grants remain required where applicable. This adapter grants no authority and never supplies server credentials. This current operation is a credentialed authority control plane for immutable work-order record creation. It does not execute the recorded work, deliver results, or authorize payment. Operator issuance and grant approval require X-Wever-Operator-Key and Idempotency-Key; consumption requires the target agent's X-Wever-Agent-Key. Usage and attribution come from validated credentials and durable authority records. AP2 issuance also accepts issue_mandate with mandate.profile com.weverlabs.ap2.direct-checkout.1, the holder public key, signed checkout challenge, consent digest and bounded expiry. It requires a dedicated AP2 issuer credential in X-Wever-Operator-Key, Idempotency-Key and a fresh holder wallet proof. Issuance costs 2.00 USDC per issued mandate; verification at /api/ap2-mandate-gateway costs 0.10 USDC per call, subject to the same shared free allowance. The AP2 mandate records checkout intent and grants no tool access, execution authority or spending authority.
| Argument | Type | Description |
|---|---|---|
| mode* |
Paid URL: 1.00 USDC per call on Base; 10 signed-wallet free calls shared over rolling 30 days. Free computation: /api/mcp or /api/service-resolver. Read the backend 402 body for x402 terms. Compare submitted evidence labels with the required list and return matched and missing items. Operating boundary: Supply required and available evidence labels. Read matched and missing labels. An agent uses the result to request the missing items; a human reviews the list and checks the documents. Direct runs cost 1 USDC after the shared free allowance; the Labs MCP and resolver computation paths are free. POST /api/diligenceops-paid-run. Existing product credentials, signed mandates, and single-use action grants remain required where applicable. This adapter grants no authority and never supplies server credentials. This current operation is a bounded computation on caller-supplied data.
| Argument | Type | Description |
|---|---|---|
| expected_evidence* | array | |
| available_evidence* | array |
{
"type": "object",
"required": [
"available_evidence",
"expected_evidence"
],
"properties": {
"expected_evidence": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_.:/ -]+(?![\\s\\S])",
"maxLength": 96,
"minLength": 1,
"description": "Use a nonempty ASCII label up to 96 bytes before trimming. Each normalized label must be unique."
},
"maxItems": 16,
"minItems": 1
},
"available_evidence": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_.:/ -]+(?![\\s\\S])",
"maxLength": 96,
"minLength": 1,
"description": "Use a nonempty ASCII label up to 96 bytes before trimming. Each normalized label must be unique."
},
"maxItems": 16,
"minItems": 0
}
},
"additionalProperties": false
}Either escrow party opens a dispute against already funded escrow or a funded work order. Records the claim reference, immutable parties and locked amount, and an operator-signed receipt. Atomically pauses release and refund. Rejects locked value above 25.00 USDC, unfunded or already disposed funds, and unrelated wallets. No new principal enters. POST /api/dispute-open. Paid URL: 0.10 USDC per call on Base mainnet using x402 exact, under the existing shared 10 signed-wallet free calls over rolling 30 days. Every call requires X-Wever-Wallet-Proof bound to the exact JSON arguments and this API path. Fees are separate from the locked principal and grant no resolution authority. Disputes expire after 14 days; unresolved expiry refunds the payer with a signed timeout receipt, subject to settlement confirmation and the UTC daily cap. External custody and security audit remains pending. Company-authored. Read /api/dispute-contract for schemas, operator authorization and recovery limits.
| Argument | Type | Description |
|---|---|---|
| claim* | object | |
| order_id | string | |
| escrow_id | string | |
| idempotency_key* | string |
{
"type": "object",
"oneOf": [
{
"required": [
"escrow_id"
]
},
{
"required": [
"order_id"
]
}
],
"required": [
"idempotency_key",
"claim"
],
"properties": {
"claim": {
"type": "object",
"required": [
"reason_code",
"statement_sha256"
],
"properties": {
"uri": {
"type": "string",
"maxLength": 512,
"minLength": 1,
"description": "HTTPS, ipfs, or ar reference. No raw evidence, personal data, credentials, query strings, or fragments."
},
"reason_code": {
"enum": [
"non_delivery",
"quality",
"scope",
"payment",
"other"
]
},
"statement_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}(?![\\s\\S])"
}
},
"additionalProperties": false
},
"order_id": {
"type": "string",
"pattern": "^wo_[a-f0-9]{64}(?![\\s\\S])"
},
"escrow_id": {
"type": "string",
"pattern": "^esc_[a-f0-9]{64}(?![\\s\\S])"
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{8,128}(?![\\s\\S])"
}
},
"additionalProperties": false
}Requires a domain-bound operator signature for the exact dispute and outcome. Release to the payee, refund to the payer, or split explicit atomic amounts summing to the locked total. Durable transfer nonces prevent duplicate movement on concurrent retries. Total resolved value is limited to 100.00 USDC per UTC day. action=extend permits one operator-authorized 14-day extension before expiry. POST /api/dispute-resolve. Paid URL: 0.10 USDC per call on Base mainnet using x402 exact, under the existing shared 10 signed-wallet free calls over rolling 30 days. Every call requires X-Wever-Wallet-Proof bound to the exact JSON arguments and this API path. Fees are separate from the locked principal and grant no resolution authority. Disputes expire after 14 days; unresolved expiry refunds the payer with a signed timeout receipt, subject to settlement confirmation and the UTC daily cap. External custody and security audit remains pending. Company-authored. Read /api/dispute-contract for schemas, operator authorization and recovery limits.
| Argument | Type | Description |
|---|---|---|
| action* | any | |
| outcome | any | |
| dispute_id* | string | |
| reason_uri | string | HTTPS, ipfs, or ar reference. No raw evidence, personal data, credentials, query strings, or fragments. |
| reason_sha256* | string | |
Read the dispute and full operator-signed receipt chain, including opening, each evidence submission, extension and resolution or timeout. Read-only: no settlement, signing or reconciliation. Requires a party wallet proof. POST /api/dispute-status. Paid URL: 0.10 USDC per call on Base mainnet using x402 exact, under the existing shared 10 signed-wallet free calls over rolling 30 days. Every call requires X-Wever-Wallet-Proof bound to the exact JSON arguments and this API path. Fees are separate from the locked principal and grant no resolution authority. Disputes expire after 14 days; unresolved expiry refunds the payer with a signed timeout receipt, subject to settlement confirmation and the UTC daily cap. External custody and security audit remains pending. Company-authored. Read /api/dispute-contract for schemas, operator authorization and recovery limits.
| Argument | Type | Description |
|---|---|---|
| dispute_id* | string |
{
"type": "object",
"required": [
"dispute_id"
],
"properties": {
"dispute_id": {
"type": "string",
"pattern": "^dp_[a-f0-9]{64}(?![\\s\\S])"
}
},
"additionalProperties": false
}Either party submits bounded evidence hashes and URIs. Raw personal information is not accepted. Both parties can read the evidence and its operator-signed receipt. Closed or expired disputes reject evidence. POST /api/dispute-submit-evidence. Paid URL: 0.10 USDC per call on Base mainnet using x402 exact, under the existing shared 10 signed-wallet free calls over rolling 30 days. Every call requires X-Wever-Wallet-Proof bound to the exact JSON arguments and this API path. Fees are separate from the locked principal and grant no resolution authority. Disputes expire after 14 days; unresolved expiry refunds the payer with a signed timeout receipt, subject to settlement confirmation and the UTC daily cap. External custody and security audit remains pending. Company-authored. Read /api/dispute-contract for schemas, operator authorization and recovery limits.
| Argument | Type | Description |
|---|---|---|
| dispute_id* | string | |
| references* | array | |
| idempotency_key* | string |
{
"type": "object",
"required": [
"dispute_id",
"idempotency_key",
"references"
],
"properties": {
"dispute_id": {
"type": "string",
"pattern": "^dp_[a-f0-9]{64}(?![\\s\\S])"
},
"references": {
"type": "array",
"items": {
"type": "object",
"required": [
"sha256",
"uri"
],
"properties": {
"uri": {
"type": "string",
"maxLength": 512,
"minLength": 1,
"description": "HTTPS, ipfs, or ar reference. No raw evidence, personal data, credentials, query strings, or fragments."
},
"sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}(?![\\s\\S])"
}
},
"additionalProperties": false
},
"maxItems": 4,
"minItems": 1,
"uniqueItems": true
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{8,128}(?![\\s\\S])"
}
},
"additionalProperties": false
}Paid URL: 0.10 USDC per call on Base; 10 signed-wallet free calls shared over rolling 30 days. Free computation: /api/mcp or /api/service-resolver. Read the backend 402 body for x402 terms. Review submitted MCP tool declarations and list missing annotations and actions that change data or spend money. Operating boundary: Supply MCP tool declarations. Read the annotation inventory and review items. Agents compare the declared interfaces; humans review the actions and choose which tools to connect. POST /api/mcp-diligence-rail. Existing product credentials, signed mandates, and single-use action grants remain required where applicable. This adapter grants no authority and never supplies server credentials. This current operation is a bounded computation on caller-supplied data.
| Argument | Type | Description |
|---|---|---|
| tools* | array |
{
"type": "object",
"required": [
"tools"
],
"properties": {
"tools": {
"type": "array",
"items": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"pattern": "^[A-Za-z0-9_.:-]+(?![\\s\\S])",
"maxLength": 64,
"minLength": 1
},
"annotations": {
"type": "object",
"properties": {
"readOnlyHint": {
"type": "boolean"
},
"openWorldHint": {
"type": "boolean"
},
"destructiveHint": {
"type": "boolean"
}
},
"additionalProperties": false
},
"description": {
"type": "string",
"maxLength": 256,
"minLength": 1,
"description": "At most 256 UTF-8 bytes, well-formed text; no unsupported control characters."
}
},
"additionalProperties": false
},
"maxItems": 16,
"minItems": 1
}
},
"additionalProperties": false
}Paid URL: 0.10 USDC per call on Base; 10 signed-wallet free calls shared over rolling 30 days. Read the backend 402 body for x402 terms. Inspect a canonical Base USDC transaction receipt for the configured Wever recipient and return the observed payment details. Operating boundary: Supply the receipt reference. Read the chain, recipient, amount and verification result. An agent links the receipt to its work record; a human inspects the same transaction details. POST /api/payment-authority-inspector. Existing product credentials, signed mandates, and single-use action grants remain required where applicable. This adapter grants no authority and never supplies server credentials. This current money service follows its published inspection, policy evaluation or private invoice contract. Payment is an API access fee and grants no spending authority.
| Argument | Type | Description |
|---|---|---|
| mode* | any | |
| payee* | string | |
| payer* | string | |
| amount_atomic* | string | |
| transaction_hash* | string | |
| min_confirmations* | integer | |
| authorization_nonce |
Bind a trusted-issuer AP2 signed presentation and a separate EIP-712 principal_signature from a configured treasury holder to the exact payout recipient, amount and expiry. AP2 retains its API-fee scope; only the separate treasury signature authorizes principal. Uses the wever_ap2-mandate-gateway verifier, trust anchors and replay ledger with holder binding v2. Returns authorized with a signed receipt. No money moves. POST /api/payout-authorize. Paid URL: 0.10 USDC per call on Base mainnet using x402 exact, under the existing shared 10 signed-wallet free calls over rolling 30 days. Every call requires X-Wever-Wallet-Proof bound to the exact JSON arguments and this API path, including paid calls. The tool fee is separate from the payout amount and grants no disbursement authority. The operator manually funds the dedicated hot payout wallet; Ledger keys never reach the server, and sweep and reclaim remain manual. No private keys are accepted. A disbursement primitive, not a bank: no yield, conversion or fiat. External custody and security audit required before large-value use. Company-authored; usage remains explicitly labeled. Read /api/payout-contract for exact schemas and authorization flow.
| Argument | Type | Description |
|---|---|---|
| payout_id* | string | |
| expires_at* | integer | |
| presentation* | string | |
| challenge_token* | string | |
| idempotency_key |
Create an immutable payout instruction with recipient, amount_usdc, idempotency_key, memo and rail_reference. Enforces the configured 25.00 USDC per-payout cap and 100.00 USDC daily cap before accepting. Returns created with a signed receipt. No money moves. POST /api/payout-create. Paid URL: 0.10 USDC per call on Base mainnet using x402 exact, under the existing shared 10 signed-wallet free calls over rolling 30 days. Every call requires X-Wever-Wallet-Proof bound to the exact JSON arguments and this API path, including paid calls. The tool fee is separate from the payout amount and grants no disbursement authority. The operator manually funds the dedicated hot payout wallet; Ledger keys never reach the server, and sweep and reclaim remain manual. No private keys are accepted. A disbursement primitive, not a bank: no yield, conversion or fiat. External custody and security audit required before large-value use. Company-authored; usage remains explicitly labeled. Read /api/payout-contract for exact schemas and authorization flow.
| Argument | Type | Description |
|---|---|---|
| memo* | string | |
| usage | any | |
| recipient* | string | |
| amount_usdc* | string | |
| rail_reference* | string | |
| idempotency_key |
Disburse native USDC on Base from the dedicated service-operated payout wallet only for an authorized payout with a valid unexpired holder-bound mandate. The persisted transfer nonce prevents duplicate payment on retries. Returns executed with the independently confirmed transaction hash and signed receipt. POST /api/payout-execute. Paid URL: 0.10 USDC per call on Base mainnet using x402 exact, under the existing shared 10 signed-wallet free calls over rolling 30 days. Every call requires X-Wever-Wallet-Proof bound to the exact JSON arguments and this API path, including paid calls. The tool fee is separate from the payout amount and grants no disbursement authority. The operator manually funds the dedicated hot payout wallet; Ledger keys never reach the server, and sweep and reclaim remain manual. No private keys are accepted. A disbursement primitive, not a bank: no yield, conversion or fiat. External custody and security audit required before large-value use. Company-authored; usage remains explicitly labeled. Read /api/payout-contract for exact schemas and authorization flow.
| Argument | Type | Description |
|---|---|---|
| payout_id* | string | |
| idempotency_key* | string |
{
"type": "object",
"required": [
"payout_id",
"idempotency_key"
],
"properties": {
"payout_id": {
"type": "string",
"pattern": "^po_[a-f0-9]{64}(?![\\s\\S])"
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,128}(?![\\s\\S])"
}
},
"additionalProperties": false
}Read a payout and its signed transition receipts by payout_id or the original create idempotency_key. Read-only: no payout state change, signing, reconciliation or transaction submission. POST /api/payout-status. Paid URL: 0.10 USDC per call on Base mainnet using x402 exact, under the existing shared 10 signed-wallet free calls over rolling 30 days. Every call requires X-Wever-Wallet-Proof bound to the exact JSON arguments and this API path, including paid calls. The tool fee is separate from the payout amount and grants no disbursement authority. The operator manually funds the dedicated hot payout wallet; Ledger keys never reach the server, and sweep and reclaim remain manual. No private keys are accepted. A disbursement primitive, not a bank: no yield, conversion or fiat. External custody and security audit required before large-value use. Company-authored; usage remains explicitly labeled. Read /api/payout-contract for exact schemas and authorization flow.
| Argument | Type | Description |
|---|---|---|
| payout_id | string | |
| idempotency_key | string |
{
"type": "object",
"oneOf": [
{
"required": [
"payout_id"
]
},
{
"required": [
"idempotency_key"
]
}
],
"required": [],
"properties": {
"payout_id": {
"type": "string",
"pattern": "^po_[a-f0-9]{64}(?![\\s\\S])"
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,128}(?![\\s\\S])"
}
},
"additionalProperties": false
}Paid URL: 0.10 USDC per call on Base; 10 signed-wallet free calls shared over rolling 30 days. Read the backend 402 body for x402 terms. Store, list and retrieve durable verification proofs in a private authenticated wallet inbox. Operating boundary: Store, list and retrieve durable verification proofs in a private authenticated wallet inbox. Agents store and retrieve proofs by reference; humans inspect those records through their wallet-connected agent. Each proof keeps its verification status. Sign wallet ownership proof for each request. POST /api/proof-inbox. Existing product credentials, signed mandates, and single-use action grants remain required where applicable. This adapter grants no authority and never supplies server credentials. Wallet-authenticated durable trust service. Signed records attest only to the stated evidence and permission scope. See /api/trust-contract for the public verification key and bounded contract.
| Argument | Type | Description |
|---|---|---|
| mode* | any | |
| limit | integer | |
| proof | object | |
| offset | integer | |
| proof_id | string | |
| idempotency_key | string |
Paid URL: 0.10 USDC per call on Base; 10 signed-wallet free calls shared over rolling 30 days. Read the backend 402 body for x402 terms. Prepare a reference envelope and a digest binding the supplied source and destination, ready for the sender’s delivery step. Operating boundary: Supply source, destination and artifact references. Read the prepared envelope and binding digest. The sending agent delivers it through its chosen transport; the human reviews the references and resulting acknowledgment. POST /api/proof-relay. Existing product credentials, signed mandates, and single-use action grants remain required where applicable. This adapter grants no authority and never supplies server credentials. This current operation is a bounded computation on caller-supplied data.
| Argument | Type | Description |
|---|---|---|
| mode* | any | |
| destination* | any | |
| source_agent_id* | string | |
| proof_references* | array |
{
"type": "object",
"required": [
"mode",
"source_agent_id",
"destination",
"proof_references"
],
"properties": {
"mode": {
"const": "prepare_proof_relay"
},
"destination": {
"oneOf": [
{
"type": "object",
"required": [
"kind",
"agent_id"
],
"properties": {
"kind": {
"const": "agent"
},
"agent_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}(?![\\s\\S])",
"maxLength": 64,
"minLength": 1
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"url"
],
"properties": {
"url": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"kind": {
"const": "callback"
}
},
"additionalProperties": false
}
]
},
"source_agent_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}(?![\\s\\S])",
"maxLength": 64,
"minLength": 1
},
"proof_references": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"reference",
"payload_sha256"
],
"properties": {
"kind": {
"enum": [
"receipt",
"passport",
"proof"
]
},
"reference": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]{0,127}(?![\\s\\S])",
"maxLength": 128,
"minLength": 1
},
"payload_sha256": {
"anyOf": [
{
"type": "string",
"pattern": "^[a-f0-9]{64}(?![\\s\\S])"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"maxItems": 16,
"minItems": 1
}
},
"additionalProperties": false
}Create an immutable purchase intent and exact plain-language quote. Item price plus flat $8 shipping and $0 tax; no additional buyer API fees. Requires a configured X-Wever-Agent-Key. Boutique supports quantity 1 per unique catalog listing. Creates no payment or approval. If approval_mode is customer_agent, obtain your customer human's approval of the exact quote and delivery address, then call purchase-execute with customer_approval. Otherwise use the returned human review URL.
| Argument | Type | Description |
|---|---|---|
| item_id* | string | |
| quantity* | integer | |
| business_id* | string | |
| idempotency_key* | string | |
| delivery_address* | object |
{
"type": "object",
"required": [
"business_id",
"item_id",
"quantity",
"delivery_address",
"idempotency_key"
],
"properties": {
"item_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
},
"quantity": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"business_id": {
"type": "string",
"pattern": "^[a-z][a-z0-9-]{0,63}$"
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{16,64}$"
},
"delivery_address": {
"type": "object",
"required": [
"name",
"line1",
"line2",
"city",
"state",
"postal_code",
"country"
],
"properties": {
"city": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f]+$",
"maxLength": 120,
"minLength": 1
},
"name": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f]+$",
"maxLength": 120,
"minLength": 1
},
"line1": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f]+$",
"maxLength": 120,
"minLength": 1
},
"line2": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f]*$",
"maxLength": 120
},
"state": {
"enum": [
"AL",
"AK",
"AZ",
"AR",
"CA",
"CO",
"CT",
"DE",
"DC",
"FL",
"GA",
"HI",
"ID",
"IL",
"IN",
"IA",
"KS",
"KY",
"LA",
"ME",
"MD",
"MA",
"MI",
"MN",
"MS",
"MO",
"MT",
"NE",
"NV",
"NH",
"NJ",
"NM",
"NY",
"NC",
"ND",
"OH",
"OK",
"OR",
"PA",
"RI",
"SC",
"SD",
"TN",
"TX",
"UT",
"VT",
"VA",
"WA",
"WV",
"WI",
"WY"
]
},
"country": {
"const": "US"
},
"postal_code": {
"type": "string",
"pattern": "^[0-9]{5}(-[0-9]{4})?$"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Open a dispute for your funded purchase through wever_dispute-open. The private statement is retained with the purchase and its digest goes to the existing dispute rail. Existing operator resolution and 300 USDC per-dispute and 350 USDC daily boutique limits apply. Requires X-Wever-Agent-Key.
| Argument | Type | Description |
|---|---|---|
| intent_id* | string | |
| statement* | string | |
| reason_code* | any | |
| idempotency_key* | string |
{
"type": "object",
"required": [
"intent_id",
"reason_code",
"statement",
"idempotency_key"
],
"properties": {
"intent_id": {
"type": "string",
"pattern": "^pi_[a-f0-9]{64}$"
},
"statement": {
"type": "string",
"maxLength": 2000,
"minLength": 1
},
"reason_code": {
"enum": [
"non_delivery",
"quality",
"scope",
"payment",
"other"
]
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{16,64}$"
}
},
"additionalProperties": false
}Execute a purchase after customer approval, without merchant review. Explicitly delegated customer agents may supply customer_approval attesting their human approved the exact saved quote and address: quote_sha256, exact amount_atomic in six-decimal USDC, currency USD, approval_text from the quote, approved_at Unix seconds and a stable approval_id. Never supply consent before the human approves. Other agents require the human review page. Approval is recorded before AP2 and escrow funding; no immediate treasury release. Omit customer_approval to retry an already approved intent. Exact retries reuse saved requests and cannot replace consent or create a second payment. Requires X-Wever-Agent-Key.
| Argument | Type | Description |
|---|---|---|
| intent_id* | string | |
| customer_approval | object |
{
"type": "object",
"required": [
"intent_id"
],
"properties": {
"intent_id": {
"type": "string",
"pattern": "^pi_[a-f0-9]{64}$"
},
"customer_approval": {
"type": "object",
"required": [
"quote_sha256",
"amount_atomic",
"currency",
"approval_text",
"approved_at",
"approval_id"
],
"properties": {
"currency": {
"const": "USD"
},
"approval_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{16,64}(?![\\s\\S])"
},
"approved_at": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"quote_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"amount_atomic": {
"type": "string",
"pattern": "^[1-9][0-9]{0,8}$"
},
"approval_text": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f]+$",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Read your own purchase quote, recorded human approval, fulfillment and completion state. Requires the same configured X-Wever-Agent-Key. No wallet or signing instructions are returned.
| Argument | Type | Description |
|---|---|---|
| intent_id* | string |
{
"type": "object",
"required": [
"intent_id"
],
"properties": {
"intent_id": {
"type": "string",
"pattern": "^pi_[a-f0-9]{64}$"
}
},
"additionalProperties": false
}Paid URL: 0.10 USDC per call on Base; 10 signed-wallet free calls shared over rolling 30 days. Read the backend 402 body for x402 terms. Execute supported bounded Wever computations, measure their runs and compare actual outputs and caller-specified expectations. Operating boundary: Choose a supported Wever computation, supply input and expected results, then compare the actual output and timing. Sample acceptance inputs stay labeled as tests. POST /api/rail-playground. Existing product credentials, signed mandates, and single-use action grants remain required where applicable. This adapter grants no authority and never supplies server credentials. Wallet-authenticated bounded operations service with durable records. See /api/operations-contract for exact schemas, verified scope and unavailable capabilities.
| Argument | Type | Description |
|---|---|---|
| mode* | any | |
| cases* | array | |
| usage* | any | |
| repeats* | integer | |
| idempotency_key* | string |
{
"type": "object",
"required": [
"idempotency_key",
"usage",
"mode",
"repeats",
"cases"
],
"properties": {
"mode": {
"const": "run"
},
"cases": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"case_id",
"service_key",
"input",
"expected_sha256",
"assertions"
],
"properties": {
"input": {
"type": "object",
"required": [
"available_evidence",
"expected_evidence"
],
"properties": {
"expected_evidence": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_.:/ -]+(?![\\s\\S])",
"maxLength": 96,
"minLength": 1,
"description": "ASCII only, at most 96 bytes before trimming; cannot be blank. Normalized duplicates are rejected."
},
"maxItems": 16,
"minItems": 1
},
"available_evidence": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_.:/ -]+(?![\\s\\S])",
"maxLength": 96,
"minLength": 1,
"description": "ASCII only, at most 96 bytes before trimming; cannot be blank. Normalized duplicates are rejected."
},
"maxItems": 16,
"minItems": 0
}
},
"additionalProperties": false
},
"case_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}(?![\\s\\S])"
},
"assertions": {
"type": "array",
"items": {
"type": "object",
"required": [
"pointer",
"equals"
],
"properties": {
"equals": {
"anyOf": [
{
"type": "string",
"maxLength": 1024
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"pointer": {
"type": "string",
"pattern": "^(?:/(?:[^~/]|~[01])*)*(?![\\s\\S])",
"maxLength": 256
}
},
"additionalProperties": false
},
"maxItems": 16,
"minItems": 0
},
"service_key": {
"const": "diligenceops-paid-run"
},
"expected_sha256": {
"anyOf": [
{
"type": "string",
"pattern": "^[a-f0-9]{64}(?![\\s\\S])"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"case_id",
"service_key",
"input",
"expected_sha256",
"assertions"
],
"properties": {
"input": {
"type": "object",
"required": [
"tools"
],
"properties": {
"tools": {
"type": "array",
"items": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"pattern": "^[A-Za-z0-9_.:-]+(?![\\s\\S])",
"maxLength": 64,
"minLength": 1
},
"annotations": {
"type": "object",
"properties": {
"readOnlyHint": {
"type": "boolean"
},
"openWorldHint": {
"type": "boolean"
},
"destructiveHint": {
"type": "boolean"
}
},
"additionalProperties": false
},
"description": {
"type": "string",
"maxLength": 256,
"minLength": 1,
"description": "At most 256 UTF-8 bytes, well-formed text; no unsupported control characters."
}
},
"additionalProperties": false
},
"maxItems": 16,
"minItems": 1
}
},
"additionalProperties": false
},
"case_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}(?![\\s\\S])"
},
"assertions": {
"type": "array",
"items": {
"type": "object",
"required": [
"pointer",
"equals"
],
"properties": {
"equals": {
"anyOf": [
{
"type": "string",
"maxLength": 1024
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"pointer": {
"type": "string",
"pattern": "^(?:/(?:[^~/]|~[01])*)*(?![\\s\\S])",
"maxLength": 256
}
},
"additionalProperties": false
},
"maxItems": 16,
"minItems": 0
},
"service_key": {
"const": "mcp-diligence-rail"
},
"expected_sha256": {
"anyOf": [
{
"type": "string",
"pattern": "^[a-f0-9]{64}(?![\\s\\S])"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"case_id",
"service_key",
"input",
"expected_sha256",
"assertions"
],
"properties": {
"input": {
"type": "object",
"required": [
"as_of",
"services",
"queues"
],
"properties": {
"as_of": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}Z(?![\\s\\S])",
"description": "A valid UTC calendar timestamp with whole seconds, supplied by the caller."
},
"queues": {
"type": "array",
"items": {
"type": "object",
"required": [
"queue",
"state",
"count",
"oldest_age_seconds"
],
"properties": {
"count": {
"type": "integer",
"maximum": 2147483647,
"minimum": 0
},
"queue": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]{0,63}(?![\\s\\S])",
"maxLength": 64,
"minLength": 1
},
"state": {
"enum": [
"active",
"retained"
]
},
"oldest_age_seconds": {
"anyOf": [
{
"type": "integer",
"maximum": 2147483647,
"minimum": 0
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"maxItems": 16,
"description": "Unique queue names. Empty queues must have a null or zero oldest age."
},
"services": {
"type": "array",
"items": {
"type": "object",
"required": [
"service_id",
"status"
],
"properties": {
"status": {
"enum": [
"ready",
"unavailable",
"degraded"
]
},
"service_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]{0,63}(?![\\s\\S])",
"maxLength": 64,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 8,
"description": "Unique service_id values."
}
},
"additionalProperties": false
},
"case_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}(?![\\s\\S])"
},
"assertions": {
"type": "array",
"items": {
"type": "object",
"required": [
"pointer",
"equals"
],
"properties": {
"equals": {
"anyOf": [
{
"type": "string",
"maxLength": 1024
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"pointer": {
"type": "string",
"pattern": "^(?:/(?:[^~/]|~[01])*)*(?![\\s\\S])",
"maxLength": 256
}
},
"additionalProperties": false
},
"maxItems": 16,
"minItems": 0
},
"service_key": {
"const": "agent-daily-operator-brief"
},
"expected_sha256": {
"anyOf": [
{
"type": "string",
"pattern": "^[a-f0-9]{64}(?![\\s\\S])"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"case_id",
"service_key",
"input",
"expected_sha256",
"assertions"
],
"properties": {
"input": {
"type": "object",
"required": [
"service_id",
"recipient_id",
"available_evidence",
"expected_evidence"
],
"properties": {
"service_id": {
"const": "com.weverlabs/diligenceops-inventory"
},
"recipient_id": {
"type": "string",
"pattern": "^mbx_[a-f0-9]{24}(?![\\s\\S])",
"maxLength": 28,
"minLength": 28
},
"expected_evidence": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_.:/ -]+(?![\\s\\S])",
"maxLength": 96,
"minLength": 1,
"description": "ASCII only, at most 96 bytes before trimming; cannot be blank. Normalized duplicates are rejected."
},
"maxItems": 16,
"minItems": 1
},
"available_evidence": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_.:/ -]+(?![\\s\\S])",
"maxLength": 96,
"minLength": 1,
"description": "ASCII only, at most 96 bytes before trimming; cannot be blank. Normalized duplicates are rejected."
},
"maxItems": 16,
"minItems": 0
}
},
"additionalProperties": false
},
"case_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}(?![\\s\\S])"
},
"assertions": {
"type": "array",
"items": {
"type": "object",
"required": [
"pointer",
"equals"
],
"properties": {
"equals": {
"anyOf": [
{
"type": "string",
"maxLength": 1024
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"pointer": {
"type": "string",
"pattern": "^(?:/(?:[^~/]|~[01])*)*(?![\\s\\S])",
"maxLength": 256
}
},
"additionalProperties": false
},
"maxItems": 16,
"minItems": 0
},
"service_key": {
"const": "agent-work-order-rail"
},
"expected_sha256": {
"anyOf": [
{
"type": "string",
"pattern": "^[a-f0-9]{64}(?![\\s\\S])"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}
]
},
"maxItems": 6,
"minItems": 1
},
"usage": {
"enum": [
"synthetic",
"operational"
]
},
"repeats": {
"type": "integer",
"maximum": 3,
"minimum": 1
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}(?![\\s\\S])"
}
},
"additionalProperties": false
}Paid URL: 0.10 USDC per call on Base; 10 signed-wallet free calls shared over rolling 30 days. Read the backend 402 body for x402 terms. Issue and verify signed receipt passports backed by completed, wallet-owned Wever computation records. Operating boundary: Issue and verify signed receipt passports backed by completed, wallet-owned Wever computation records. Agents issue or verify a passport after a completed run; humans inspect its receipt and linked artifacts. Sign wallet ownership proof for each request. POST /api/receipt-passport. Existing product credentials, signed mandates, and single-use action grants remain required where applicable. This adapter grants no authority and never supplies server credentials. Wallet-authenticated durable trust service. Signed records attest only to the stated evidence and permission scope. See /api/trust-contract for the public verification key and bounded contract.
| Argument | Type | Description |
|---|---|---|
| mode* | any | |
| work | any | |
| usage | any | |
| passport | string | |
| idempotency_key | string |
{
"type": "object",
"oneOf": [
{
"type": "object",
"required": [
"mode",
"idempotency_key",
"work",
"usage"
],
"properties": {
"mode": {
"const": "issue"
},
"work": {
"oneOf": [
{
"type": "object",
"required": [
"kind",
"nonce"
],
"properties": {
"kind": {
"const": "wallet_free_call"
},
"nonce": {
"type": "string",
"pattern": "^[a-f0-9]{32,64}(?![\\s\\S])"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"payment_id"
],
"properties": {
"kind": {
"const": "settled_payment"
},
"payment_id": {
"type": "string",
"pattern": "^[a-f0-9]{64}(?![\\s\\S])"
}
},
"additionalProperties": false
}
]
},
"usage": {
"enum": [
"synthetic",
"operational"
]
},
"idempotency_key": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,96}(?![\\s\\S])"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"mode",
"passport"
],
"properties": {
"mode": {
"const": "verify"
},
"passport": {
"type": "string",
"maxLength": 24000,
"minLength": 1
}
},
"additionalProperties": false
}
],
"required": [
"mode"
],
"properties": {
"mode": {
"enum": [
"issue",
"verify"
]
},
"work": {
"oneOf": [
{
"type": "object",
"required": [
"kind",
"nonce"
],
"properties": {
"kind": {
"const": "wallet_free_call"
},
"nonce": {
"type": "string",
"pattern": "^[a-f0-9]{32,64}(?![\\s\\S])"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"payment_id"
],
"properties": {
"kind": {
"const": "settled_payment"
},
"payment_id": {
"type": "string",
"pattern": "^[a-f0-9]{64}(?![\\s\\S])"
}
},
"additionalProperties": false
}
]
},
"usage": {
"enum": [
"synthetic",
"operational"
]
},
"passport": {
"type": "string",
"maxLength": 24000,
"minLength": 1
},
"idempotency_key": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,96}(?![\\s\\S])"
}
},
"additionalProperties": false
}Create a rail-signed WL-R-XXXXXX referral code, permanently attribute your own wallet with a signed code_token, inspect earnings, claim USDC, or verify a signed referral receipt. POST /api/referral-rail. Every call requires X-Wever-Wallet-Proof signed by the caller wallet and bound to the exact request body. Attribution requires the referee wallet proof, rejects self-referrals and permits only the first code. Earnings accrue from verified real payment and settlement records: 20 percent of eligible USDC paid for 12 months from the first attributed paid call. Claims reserve earnings and create a linked payout instruction for the authenticated referrer wallet, require a stable claim_id for retries, and allow 1.00 to 25.00 USDC per claim. Optional amount_usdc requests an exact amount within the available balance; omit it to claim the available balance up to 25 USDC. The treasury holder uses wever_payout-authorize and wever_payout-execute with AP2 holder binding v2 and separate EIP-712 spending consent. The dedicated payout wallet requires manual funding; the shared payout cap is 100 USDC per UTC day. Retry the original claim after execution to reconcile the confirmed transfer and obtain its receipt. Total outstanding accruals are capped at 200.00 USDC and fail closed beyond that cap. Attributions and confirmed payouts return record-backed, verifiable signed receipts. Paid URL: 0.10 USDC per call on Base mainnet using x402 exact, under the existing shared 10 signed-wallet free calls over rolling 30 days. The payout wallet does not receive API fees or escrow principal. Read the backend 402 body and /api/referral-contract for the exact contract and public verification key. This adapter forwards only caller-supplied credentials and grants no spending authority.
No arguments.
{
"type": "object",
"oneOf": [
{
"type": "object",
"required": [
"action"
],
"properties": {
"action": {
"type": "string",
"const": "create_code"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"action",
"code",
"code_token"
],
"properties": {
"code": {
"type": "string",
"pattern": "^WL-R-[A-Z0-9]{6}$"
},
"action": {
"type": "string",
"const": "attribute"
},
"code_token": {
"type": "string",
"maxLength": 4096,
"minLength": 64
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"action"
],
"properties": {
"action": {
"type": "string",
"const": "earnings"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"action",
"claim_id"
],
"properties": {
"action": {
"type": "string",
"const": "claim"
},
"claim_id": {
"type": "string",
"pattern": "^[A-Za-z0-9:_-]{1,64}$"
},
"amount_usdc": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,2})(\\.[0-9]{1,6})?$"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"action",
"receipt"
],
"properties": {
"action": {
"type": "string",
"const": "verify_receipt"
},
"receipt": {
"type": "string",
"maxLength": 8192,
"minLength": 64
}
},
"additionalProperties": false
}
]
}Paid URL: 0.10 USDC per call on Base; 10 signed-wallet free calls shared over rolling 30 days. Read the backend 402 body for x402 terms. Retrieve a wallet-owned completed Wever computation from durable billing records, including its exact result and verified digest. Operating boundary: Provide the completed computation ID from your wallet to retrieve its retained result and content digest. The response includes the record status and available evidence. POST /api/return-package-viewer. Existing product credentials, signed mandates, and single-use action grants remain required where applicable. This adapter grants no authority and never supplies server credentials. Wallet-authenticated bounded operations service with durable records. See /api/operations-contract for exact schemas, verified scope and unavailable capabilities.
| Argument | Type | Description |
|---|---|---|
| mode* | any | |
| work* | any |
{
"type": "object",
"required": [
"mode",
"work"
],
"properties": {
"mode": {
"const": "retrieve"
},
"work": {
"oneOf": [
{
"type": "object",
"required": [
"kind",
"nonce"
],
"properties": {
"kind": {
"const": "wallet_free_call"
},
"nonce": {
"type": "string",
"pattern": "^[a-f0-9]{32,64}(?![\\s\\S])"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"payment_id"
],
"properties": {
"kind": {
"const": "settled_payment"
},
"payment_id": {
"type": "string",
"pattern": "^[a-f0-9]{64}(?![\\s\\S])"
}
},
"additionalProperties": false
}
]
}
},
"additionalProperties": false
}Prepay wallet-bound 30-day tool subscriptions. action=plans lists signed server-configured prices and terms. action=subscribe requires a stable 64-hex purchase_id and plan name; single-tool also requires the covered MCP tool name. Pay the quoted plan amount up front through x402 exact on Base mainnet. A shared free access call is reserved for checkout when available; otherwise the quote includes the 0.10 USDC rail access fee. Confirmed settlement returns a record-backed Ed25519 subscription receipt. action=status shows quota and cycle end. action=cancel marks cancellation at cycle end with no mid-cycle refund. Manual renewal requires a fresh subscribe after expiry; no stacking within one wallet and plan scope. Covered calls authenticate with X-Wever-Wallet-Proof. Fresh valid per-call authorizations from that same wallet also use quota; existing payment retries retain their recorded billing. Omit Payment-Signature for covered calls to avoid unnecessary payment verification. Expired or exhausted quota returns normal per-call 402. Subscription purchases and escrow principal never consume quota. auto_renew defaults false; true is rejected because the installed AP2 gateway cannot authorize recurring pulls or mandate revocation. cancel_auto_renew confirms no automatic mandate is held. verify_receipt checks both signature and durable wallet-owned record. Paid URL: 0.10 USDC per call on Base mainnet using x402 exact, under the existing shared 10 signed-wallet free calls over rolling 30 days. POST /api/subscription-rail with a fresh exact-body wallet proof. Public keys, signed plans and terms: /api/subscription-contract.
No arguments.
{
"type": "object",
"oneOf": [
{
"type": "object",
"required": [
"action"
],
"properties": {
"action": {
"type": "string",
"const": "plans"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"action",
"plan",
"purchase_id"
],
"properties": {
"plan": {
"type": "string",
"maxLength": 64,
"minLength": 1
},
"tool": {
"type": "string",
"pattern": "^wever_[a-z0-9-]+$"
},
"action": {
"type": "string",
"const": "subscribe"
},
"mandate": {
"type": "object"
},
"auto_renew": {
"type": "boolean",
"default": false
},
"purchase_id": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"action"
],
"properties": {
"action": {
"type": "string",
"const": "status"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"action"
],
"properties": {
"action": {
"type": "string",
"const": "cancel_auto_renew"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"action",
"subscription_id"
],
"properties": {
"action": {
"type": "string",
"const": "cancel"
},
"subscription_id": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"action",
"receipt"
],
"properties": {
"action": {
"type": "string",
"const": "verify_receipt"
},
"receipt": {
"type": "string",
"maxLength": 8192,
"minLength": 64
}
},
"additionalProperties": false
}
]
}Read a wallet's native USDC balance and ETH balance for gas visibility on Base mainnet. wallet_address must use the exact EIP-55 checksum. Reads public chain data only. Treasury arguments never accept private keys, signatures or transaction instructions; these tools cannot sign, submit transactions, transfer funds or spend. POST /api/treasury-balance. Paid URL: 0.10 USDC per call on Base mainnet using x402 exact, under the existing shared 10 signed-wallet free calls over rolling 30 days. API access billing is separate from wallet visibility: the existing access layer processes caller-supplied payment and wallet-proof headers only. X-Wever-Wallet-Proof must bind to the exact JSON arguments and this API path, not /mcp. The inspected wallet need not be the access payer. Read /api/treasury-contract and the backend 402 body for schemas, coverage and billing terms.
| Argument | Type | Description |
|---|---|---|
| wallet_address* | string | Public Base wallet address in its exact EIP-55 checksum spelling. No ownership proof or secrets belong in tool arguments. |
{
"type": "object",
"required": [
"wallet_address"
],
"properties": {
"wallet_address": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"maxLength": 42,
"minLength": 42,
"description": "Public Base wallet address in its exact EIP-55 checksum spelling. No ownership proof or secrets belong in tool arguments."
}
},
"additionalProperties": false
}Read recent native USDC transfers into and out of a wallet on Base mainnet, including amounts, timestamps and transaction hashes. Optional limit and UTC time window bound the returned history. wallet_address must use the exact EIP-55 checksum. Reads public chain data only. Treasury arguments never accept private keys, signatures or transaction instructions; these tools cannot sign, submit transactions, transfer funds or spend. POST /api/treasury-flows. Paid URL: 0.10 USDC per call on Base mainnet using x402 exact, under the existing shared 10 signed-wallet free calls over rolling 30 days. API access billing is separate from wallet visibility: the existing access layer processes caller-supplied payment and wallet-proof headers only. X-Wever-Wallet-Proof must bind to the exact JSON arguments and this API path, not /mcp. The inspected wallet need not be the access payer. Read /api/treasury-contract and the backend 402 body for schemas, coverage and billing terms.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| end_time | string | UTC ISO 8601 timestamp, for example 2026-10-01T00:00:00Z. Start is inclusive and end is exclusive; maximum window 366 days. Defaults to the current time. |
| start_time | string | UTC ISO 8601 timestamp, for example 2026-10-01T00:00:00Z. Start is inclusive and end is exclusive; maximum window 366 days. Defaults to 30 days before end_time. |
| wallet_address* | string | Public Base wallet address in its exact EIP-55 checksum spelling. No ownership proof or secrets belong in tool arguments. |
Paid URL: 0.10 USDC per call on Base; 10 signed-wallet free calls shared over rolling 30 days. Read the backend 402 body for x402 terms. Itemize caller-supplied USD estimates and calculate a total for supported computations. Operating boundary: Supply computation items and your USD estimates. Read the itemized total. An agent carries the estimate into its work plan; a human compares the items before requesting a provider checkout. POST /api/unified-agent-checkout. Existing product credentials, signed mandates, and single-use action grants remain required where applicable. This adapter grants no authority and never supplies server credentials. This current operation is a bounded computation on caller-supplied data.
| Argument | Type | Description |
|---|---|---|
| mode* | any | |
| items* | array | |
| agent_id* | string | |
| currency* | any | |
| payment_reference* | any | |
| allowance_reference* | any |
{
"type": "object",
"required": [
"mode",
"agent_id",
"currency",
"items",
"payment_reference",
"allowance_reference"
],
"properties": {
"mode": {
"const": "prepare_checkout"
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"product_key",
"unit_amount_minor",
"quantity"
],
"properties": {
"quantity": {
"type": "integer",
"maximum": 1000,
"minimum": 1
},
"product_key": {
"enum": [
"diligenceops-paid-run",
"mcp-diligence-rail",
"agent-daily-operator-brief",
"agent-work-order-rail"
]
},
"unit_amount_minor": {
"type": "integer",
"maximum": 1000000000000,
"minimum": 0
}
},
"additionalProperties": false
},
"maxItems": 16,
"minItems": 1
},
"agent_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}(?![\\s\\S])",
"maxLength": 64,
"minLength": 1
},
"currency": {
"const": "USD"
},
"payment_reference": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]{0,127}(?![\\s\\S])",
"maxLength": 128,
"minLength": 1
},
{
"type": "null"
}
]
},
"allowance_reference": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]{0,127}(?![\\s\\S])",
"maxLength": 128,
"minLength": 1
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}Only the named worker wallet may accept a funded order before its deadline. POST /api/workorder-accept. Paid URL: 0.10 USDC per call on Base mainnet using x402 exact, under the existing shared 10 signed-wallet free calls over rolling 30 days. Every call requires X-Wever-Wallet-Proof bound to the exact JSON arguments and this API path, including paid calls. Order value is capped at 25.00 USDC under the existing escrow-lite rail; API access fees and escrow principal are separate. Normal states are open, funded, accepted, delivered and released. Disputed orders freeze release and retain an expiry refund path; expired funded orders refund only the hirer. No private keys are accepted, no arbitrary payee or payer substitution is allowed, and the adapter grants no authority. Read /api/workorder-contract for schemas, recovery and evidence bounds. Live funded acceptance remains a manual operator step.
| Argument | Type | Description |
|---|---|---|
| order_id* | string | |
| idempotency_key* | string |
{
"type": "object",
"required": [
"order_id",
"idempotency_key"
],
"properties": {
"order_id": {
"type": "string",
"pattern": "^wo_[a-f0-9]{64}(?![\\s\\S])"
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]+(?![\\s\\S])",
"maxLength": 128,
"minLength": 8
}
},
"additionalProperties": false
}The hirer names one worker wallet and defines the title, description, acceptance criteria, USDC price and deadline. Creates immutable work terms for an order capped at 25.00 USDC. POST /api/workorder-create. Paid URL: 0.10 USDC per call on Base mainnet using x402 exact, under the existing shared 10 signed-wallet free calls over rolling 30 days. Every call requires X-Wever-Wallet-Proof bound to the exact JSON arguments and this API path, including paid calls. Order value is capped at 25.00 USDC under the existing escrow-lite rail; API access fees and escrow principal are separate. Normal states are open, funded, accepted, delivered and released. Disputed orders freeze release and retain an expiry refund path; expired funded orders refund only the hirer. No private keys are accepted, no arbitrary payee or payer substitution is allowed, and the adapter grants no authority. Read /api/workorder-contract for schemas, recovery and evidence bounds. Live funded acceptance remains a manual operator step.
| Argument | Type | Description |
|---|---|---|
| title* | string | At most 200 UTF-8 bytes. Control characters are not allowed. |
| usage | any | |
| deadline* | integer | |
| price_usdc* | string | |
| description* | string | At most 4000 UTF-8 bytes. Control characters are not allowed. |
Only the named worker wallet may submit a deliverable reference and proof hash for an accepted order. Delivery evidence is recorded in the proof inbox; submission is not automatic acceptance or payment. POST /api/workorder-deliver. Paid URL: 0.10 USDC per call on Base mainnet using x402 exact, under the existing shared 10 signed-wallet free calls over rolling 30 days. Every call requires X-Wever-Wallet-Proof bound to the exact JSON arguments and this API path, including paid calls. Order value is capped at 25.00 USDC under the existing escrow-lite rail; API access fees and escrow principal are separate. Normal states are open, funded, accepted, delivered and released. Disputed orders freeze release and retain an expiry refund path; expired funded orders refund only the hirer. No private keys are accepted, no arbitrary payee or payer substitution is allowed, and the adapter grants no authority. Read /api/workorder-contract for schemas, recovery and evidence bounds. Live funded acceptance remains a manual operator step.
| Argument | Type | Description |
|---|---|---|
| order_id* | string | |
| proof_hash* | string | |
| idempotency_key* | string | |
| deliverable_reference* | string | At most 2048 UTF-8 bytes. Control characters are not allowed. |
{
"type": "object",
"required": [
"order_id",
"idempotency_key",
"deliverable_reference",
"proof_hash"
],
"properties": {
"order_id": {
"type": "string",
"pattern": "^wo_[a-f0-9]{64}(?![\\s\\S])"
},
"proof_hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}(?![\\s\\S])"
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]+(?![\\s\\S])",
"maxLength": 128,
"minLength": 8
},
"deliverable_reference": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f-\\u009f]+(?![\\s\\S])",
"maxLength": 2048,
"minLength": 1,
"description": "At most 2048 UTF-8 bytes. Control characters are not allowed."
}
},
"additionalProperties": false
}Either authenticated party may pause release of the order and record bounded evidence in the proof inbox. Dispute blocks further release; expiry refund to the original hirer remains available. Arbitration UI is outside v1. POST /api/workorder-dispute. Paid URL: 0.10 USDC per call on Base mainnet using x402 exact, under the existing shared 10 signed-wallet free calls over rolling 30 days. Every call requires X-Wever-Wallet-Proof bound to the exact JSON arguments and this API path, including paid calls. Order value is capped at 25.00 USDC under the existing escrow-lite rail; API access fees and escrow principal are separate. Normal states are open, funded, accepted, delivered and released. Disputed orders freeze release and retain an expiry refund path; expired funded orders refund only the hirer. No private keys are accepted, no arbitrary payee or payer substitution is allowed, and the adapter grants no authority. Read /api/workorder-contract for schemas, recovery and evidence bounds. Live funded acceptance remains a manual operator step.
| Argument | Type | Description |
|---|---|---|
| order_id* | string | |
| proof_hash* | string | |
| idempotency_key* | string | |
| evidence_reference* | string | At most 2048 UTF-8 bytes. Control characters are not allowed. |
{
"type": "object",
"required": [
"order_id",
"idempotency_key",
"evidence_reference",
"proof_hash"
],
"properties": {
"order_id": {
"type": "string",
"pattern": "^wo_[a-f0-9]{64}(?![\\s\\S])"
},
"proof_hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}(?![\\s\\S])"
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]+(?![\\s\\S])",
"maxLength": 128,
"minLength": 8
},
"evidence_reference": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f-\\u009f]+(?![\\s\\S])",
"maxLength": 2048,
"minLength": 1,
"description": "At most 2048 UTF-8 bytes. Control characters are not allowed."
}
},
"additionalProperties": false
}The hirer funds the order through escrow-lite using caller-signed principal authorization. Only confirmed principal funding moves an open order to funded. Escrow principal is the hirer's order value, separate from the API access fee. POST /api/workorder-fund. Paid URL: 0.10 USDC per call on Base mainnet using x402 exact, under the existing shared 10 signed-wallet free calls over rolling 30 days. Every call requires X-Wever-Wallet-Proof bound to the exact JSON arguments and this API path, including paid calls. Order value is capped at 25.00 USDC under the existing escrow-lite rail; API access fees and escrow principal are separate. Normal states are open, funded, accepted, delivered and released. Disputed orders freeze release and retain an expiry refund path; expired funded orders refund only the hirer. No private keys are accepted, no arbitrary payee or payer substitution is allowed, and the adapter grants no authority. Read /api/workorder-contract for schemas, recovery and evidence bounds. Live funded acceptance remains a manual operator step.
| Argument | Type | Description |
|---|---|---|
| order_id* | string | |
| funding_payment* | any | |
| idempotency_key* | string | |
| payer_terms_signature* | string |
{
"type": "object",
"required": [
"order_id",
"idempotency_key",
"payer_terms_signature",
"funding_payment"
],
"properties": {
"order_id": {
"type": "string",
"pattern": "^wo_[a-f0-9]{64}(?![\\s\\S])"
},
"funding_payment": {
"oneOf": [
{
"type": "null"
},
{
"type": "object",
"required": [
"x402Version",
"resource",
"accepted",
"payload"
],
"properties": {
"payload": {
"type": "object",
"required": [
"signature",
"authorization"
],
"properties": {
"signature": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{130}(?![\\s\\S])"
},
"authorization": {
"type": "object",
"required": [
"from",
"to",
"value",
"validAfter",
"validBefore",
"nonce"
],
"properties": {
"to": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"from": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"nonce": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}(?![\\s\\S])"
},
"value": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,77})(?![\\s\\S])"
},
"validAfter": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,77})(?![\\s\\S])"
},
"validBefore": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,77})(?![\\s\\S])"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"accepted": {
"type": "object",
"required": [
"scheme",
"network",
"asset",
"amount",
"payTo",
"maxTimeoutSeconds",
"extra"
],
"properties": {
"asset": {
"const": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
},
"extra": {
"type": "object",
"required": [
"name",
"version"
],
"properties": {
"name": {
"const": "USD Coin"
},
"version": {
"const": "2"
}
},
"additionalProperties": false
},
"payTo": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"amount": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,77})(?![\\s\\S])"
},
"scheme": {
"const": "exact"
},
"network": {
"const": "eip155:8453"
},
"maxTimeoutSeconds": {
"type": "integer",
"maximum": 3600,
"minimum": 1
}
},
"additionalProperties": false
},
"resource": {
"type": "object",
"required": [
"url",
"description",
"mimeType"
],
"properties": {
"url": {
"type": "string",
"maxLength": 512,
"minLength": 1
},
"mimeType": {
"const": "application/json"
},
"description": {
"type": "string",
"maxLength": 256
}
},
"additionalProperties": false
},
"x402Version": {
"const": 2
}
},
"additionalProperties": false
}
]
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]+(?![\\s\\S])",
"maxLength": 128,
"minLength": 8
},
"payer_terms_signature": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{130}(?![\\s\\S])"
}
},
"additionalProperties": false
}Only the hirer may approve a delivered order. The AP2 gateway verifies a trusted holder-bound, unexpired, unused mandate for the exact order intent. A separate payer-signed EIP-712 escrow release mandate authorizes payment only to the immutable worker. Confirmed settlement produces signed record-backed receipts for both parties. POST /api/workorder-release. Paid URL: 0.10 USDC per call on Base mainnet using x402 exact, under the existing shared 10 signed-wallet free calls over rolling 30 days. Every call requires X-Wever-Wallet-Proof bound to the exact JSON arguments and this API path, including paid calls. Order value is capped at 25.00 USDC under the existing escrow-lite rail; API access fees and escrow principal are separate. Normal states are open, funded, accepted, delivered and released. Disputed orders freeze release and retain an expiry refund path; expired funded orders refund only the hirer. No private keys are accepted, no arbitrary payee or payer substitution is allowed, and the adapter grants no authority. Read /api/workorder-contract for schemas, recovery and evidence bounds. Live funded acceptance remains a manual operator step.
| Argument | Type | Description |
|---|---|---|
| mandate* | object | |
| order_id* | string | |
| presentation* | string | At most 32768 UTF-8 bytes. Control characters are not allowed. |
| challenge_token* | string | At most 16384 UTF-8 bytes. Control characters are not allowed. |
Paid URL: 0.10 USDC per call on Base; 10 signed-wallet free calls shared over rolling 30 days. Read the backend 402 body for x402 terms. Check an EOA payment signature and read its Base USDC nonce, balance and chain time. Operating boundary: Supply the payment signature and its terms. Read the signature check, nonce, balance and chain time. An agent uses these observations before settlement; a human reviews the payment terms in the wallet. POST /api/x402-payment-gateway. Existing product credentials, signed mandates, and single-use action grants remain required where applicable. This adapter grants no authority and never supplies server credentials. This current money service follows its published inspection, policy evaluation or private invoice contract. Payment is an API access fee and grants no spending authority.
| Argument | Type | Description |
|---|---|---|
| mode* | any | |
| payment* | object | |
| target_product* | any |
{
"type": "object",
"required": [
"mode",
"target_product",
"payment"
],
"properties": {
"mode": {
"const": "inspect_x402_authorization"
},
"payment": {
"type": "object",
"required": [
"x402Version",
"resource",
"accepted",
"payload"
],
"properties": {
"payload": {
"type": "object",
"required": [
"signature",
"authorization"
],
"properties": {
"signature": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{130}(?![\\s\\S])"
},
"authorization": {
"type": "object",
"required": [
"from",
"to",
"value",
"validAfter",
"validBefore",
"nonce"
],
"properties": {
"to": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"from": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"nonce": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}(?![\\s\\S])"
},
"value": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,77})(?![\\s\\S])"
},
"validAfter": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,77})(?![\\s\\S])"
},
"validBefore": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,77})(?![\\s\\S])"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"accepted": {
"type": "object",
"required": [
"scheme",
"network",
"amount",
"asset",
"payTo",
"maxTimeoutSeconds",
"extra"
],
"properties": {
"asset": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"extra": {
"type": "object",
"required": [
"name",
"version"
],
"properties": {
"name": {
"const": "USD Coin"
},
"version": {
"const": "2"
}
},
"additionalProperties": false
},
"payTo": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"amount": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,77})(?![\\s\\S])"
},
"scheme": {
"const": "exact"
},
"network": {
"const": "eip155:8453"
},
"maxTimeoutSeconds": {
"type": "integer",
"maximum": 3600,
"minimum": 1
}
},
"additionalProperties": false
},
"resource": {
"type": "object",
"required": [
"url",
"description",
"mimeType"
],
"properties": {
"url": {
"type": "string",
"maxLength": 256,
"minLength": 1
},
"mimeType": {
"const": "application/json"
},
"description": {
"type": "string",
"maxLength": 256
}
},
"additionalProperties": false
},
"x402Version": {
"const": 2
}
},
"additionalProperties": false
},
"target_product": {
"enum": [
"diligenceops-paid-run",
"agent-daily-operator-brief",
"mcp-diligence-rail",
"agent-work-order-rail",
"agent-paid-workflow",
"unified-agent-checkout",
"agent-allowance-console",
"agent-work-order-exchange",
"proof-relay",
"delegated-authority",
"x402-payment-gateway",
"payment-authority-inspector",
"agent-invoice-rail",
"agent-budget-guard"
]
}
},
"additionalProperties": false
}| idempotency_key* |
| string |
{
"type": "object",
"required": [
"idempotency_key",
"usage",
"mode",
"objective",
"criteria",
"constraints",
"options"
],
"properties": {
"mode": {
"const": "evaluate"
},
"usage": {
"enum": [
"synthetic",
"operational"
]
},
"options": {
"type": "array",
"items": {
"type": "object",
"required": [
"option_id",
"label",
"assessments"
],
"properties": {
"label": {
"type": "string",
"maxLength": 160,
"minLength": 1
},
"option_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}(?![\\s\\S])"
},
"assessments": {
"type": "array",
"items": {
"type": "object",
"required": [
"criterion_id",
"value",
"evidence"
],
"properties": {
"value": {
"anyOf": [
{
"type": "integer",
"maximum": 1000000000,
"minimum": -1000000000
},
{
"type": "null"
}
]
},
"evidence": {
"type": "array",
"items": {
"type": "object",
"required": [
"reference",
"summary"
],
"properties": {
"summary": {
"type": "string",
"maxLength": 512,
"minLength": 1
},
"reference": {
"type": "string",
"maxLength": 256,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 2,
"minItems": 0
},
"criterion_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}(?![\\s\\S])"
}
},
"additionalProperties": false
},
"maxItems": 16,
"minItems": 1
}
},
"additionalProperties": false
},
"maxItems": 16,
"minItems": 2
},
"criteria": {
"type": "array",
"items": {
"type": "object",
"required": [
"criterion_id",
"label",
"direction",
"weight",
"min_value",
"max_value"
],
"properties": {
"label": {
"type": "string",
"maxLength": 160,
"minLength": 1
},
"weight": {
"type": "integer",
"maximum": 1000,
"minimum": 1
},
"direction": {
"enum": [
"maximize",
"minimize"
]
},
"max_value": {
"type": "integer",
"maximum": 1000000000,
"minimum": -1000000000
},
"min_value": {
"type": "integer",
"maximum": 1000000000,
"minimum": -1000000000
},
"criterion_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}(?![\\s\\S])"
}
},
"additionalProperties": false
},
"maxItems": 16,
"minItems": 1
},
"objective": {
"type": "string",
"maxLength": 2000,
"minLength": 1
},
"constraints": {
"type": "array",
"items": {
"type": "object",
"required": [
"criterion_id",
"operator",
"value"
],
"properties": {
"value": {
"type": "integer",
"maximum": 1000000000,
"minimum": -1000000000
},
"operator": {
"enum": [
"gte",
"lte"
]
},
"criterion_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}(?![\\s\\S])"
}
},
"additionalProperties": false
},
"maxItems": 32,
"minItems": 0
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}(?![\\s\\S])"
}
},
"additionalProperties": false
}| idempotency_key | string |
| payer_terms_signature | string |
{
"type": "object",
"oneOf": [
{
"type": "object",
"required": [
"mode",
"terms",
"payer_terms_signature",
"idempotency_key"
],
"properties": {
"mode": {
"const": "prepare_funding"
},
"terms": {
"type": "object",
"required": [
"escrow_id",
"payer_wallet",
"payee_wallet",
"custody_wallet",
"chain_id",
"asset",
"amount_atomic",
"expires_at",
"funding_nonce",
"release_policy"
],
"properties": {
"asset": {
"const": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
},
"chain_id": {
"const": 8453
},
"escrow_id": {
"type": "string",
"pattern": "^esc_[0-9a-f]{64}(?![\\s\\S])"
},
"expires_at": {
"type": "integer",
"maximum": 4102444800,
"minimum": 1
},
"payee_wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"payer_wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"amount_atomic": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,77})(?![\\s\\S])"
},
"funding_nonce": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}(?![\\s\\S])"
},
"custody_wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"release_policy": {
"oneOf": [
{
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"const": "payer_signed"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"const": "mutual"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"attestor_wallet",
"delivery_sha256"
],
"properties": {
"kind": {
"const": "delivery_attestation"
},
"attestor_wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"delivery_sha256": {
"type": "string",
"pattern": "^[0-9a-f]{64}(?![\\s\\S])"
}
},
"additionalProperties": false
}
]
}
},
"additionalProperties": false
},
"idempotency_key": {
"type": "string",
"pattern": "^[a-zA-Z0-9_.:-]{1,128}(?![\\s\\S])"
},
"payer_terms_signature": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{130}(?![\\s\\S])"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"mode",
"escrow_id",
"idempotency_key",
"funding_payment"
],
"properties": {
"mode": {
"const": "fund_escrow"
},
"escrow_id": {
"type": "string",
"pattern": "^esc_[0-9a-f]{64}(?![\\s\\S])"
},
"funding_payment": {
"anyOf": [
{
"type": "null"
},
{
"type": "object",
"required": [
"x402Version",
"resource",
"accepted",
"payload"
],
"properties": {
"payload": {
"type": "object",
"required": [
"signature",
"authorization"
],
"properties": {
"signature": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{130}(?![\\s\\S])"
},
"authorization": {
"type": "object",
"required": [
"from",
"to",
"value",
"validAfter",
"validBefore",
"nonce"
],
"properties": {
"to": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"from": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"nonce": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}(?![\\s\\S])"
},
"value": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,77})(?![\\s\\S])"
},
"validAfter": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,77})(?![\\s\\S])"
},
"validBefore": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,77})(?![\\s\\S])"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"accepted": {
"type": "object",
"required": [
"scheme",
"network",
"asset",
"amount",
"payTo",
"maxTimeoutSeconds",
"extra"
],
"properties": {
"asset": {
"const": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
},
"extra": {
"type": "object",
"required": [
"name",
"version"
],
"properties": {
"name": {
"const": "USD Coin"
},
"version": {
"const": "2"
}
},
"additionalProperties": false
},
"payTo": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"amount": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,77})(?![\\s\\S])"
},
"scheme": {
"const": "exact"
},
"network": {
"const": "eip155:8453"
},
"maxTimeoutSeconds": {
"type": "integer",
"maximum": 3600,
"minimum": 1
}
},
"additionalProperties": false
},
"resource": {
"type": "object",
"required": [
"url",
"description",
"mimeType"
],
"properties": {
"url": {
"type": "string",
"maxLength": 512,
"minLength": 1
},
"mimeType": {
"const": "application/json"
},
"description": {
"type": "string",
"maxLength": 256
}
},
"additionalProperties": false
},
"x402Version": {
"const": 2
}
},
"additionalProperties": false
}
]
},
"idempotency_key": {
"type": "string",
"pattern": "^[a-zA-Z0-9_.:-]{1,128}(?![\\s\\S])"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"mode",
"escrow_id",
"idempotency_key",
"mandate"
],
"properties": {
"mode": {
"const": "release_escrow"
},
"mandate": {
"type": "object",
"required": [
"context",
"terms",
"payer_terms_signature",
"signatures"
],
"properties": {
"terms": {
"type": "object",
"required": [
"escrow_id",
"payer_wallet",
"payee_wallet",
"custody_wallet",
"chain_id",
"asset",
"amount_atomic",
"expires_at",
"funding_nonce",
"release_policy"
],
"properties": {
"asset": {
"const": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
},
"chain_id": {
"const": 8453
},
"escrow_id": {
"type": "string",
"pattern": "^esc_[0-9a-f]{64}(?![\\s\\S])"
},
"expires_at": {
"type": "integer",
"maximum": 4102444800,
"minimum": 1
},
"payee_wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"payer_wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"amount_atomic": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,77})(?![\\s\\S])"
},
"funding_nonce": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}(?![\\s\\S])"
},
"custody_wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"release_policy": {
"oneOf": [
{
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"const": "payer_signed"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"const": "mutual"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"attestor_wallet",
"delivery_sha256"
],
"properties": {
"kind": {
"const": "delivery_attestation"
},
"attestor_wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"delivery_sha256": {
"type": "string",
"pattern": "^[0-9a-f]{64}(?![\\s\\S])"
}
},
"additionalProperties": false
}
]
}
},
"additionalProperties": false
},
"context": {
"type": "object",
"required": [
"escrow_id",
"payer_wallet",
"payee_wallet",
"custody_wallet",
"chain_id",
"asset",
"amount_atomic",
"expires_at",
"funding_nonce",
"terms_sha256",
"funding_transaction_hash",
"release_nonce"
],
"properties": {
"asset": {
"const": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
},
"chain_id": {
"const": 8453
},
"escrow_id": {
"type": "string",
"pattern": "^esc_[0-9a-f]{64}(?![\\s\\S])"
},
"expires_at": {
"type": "integer",
"maximum": 4102444800,
"minimum": 1
},
"payee_wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"payer_wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"terms_sha256": {
"type": "string",
"pattern": "^[0-9a-f]{64}(?![\\s\\S])"
},
"amount_atomic": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,77})(?![\\s\\S])"
},
"funding_nonce": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}(?![\\s\\S])"
},
"release_nonce": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}(?![\\s\\S])"
},
"custody_wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"funding_transaction_hash": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}(?![\\s\\S])"
}
},
"additionalProperties": false
},
"signatures": {
"oneOf": [
{
"type": "object",
"required": [
"payer_signature"
],
"properties": {
"payer_signature": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{130}(?![\\s\\S])"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"payer_signature",
"payee_signature"
],
"properties": {
"payee_signature": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{130}(?![\\s\\S])"
},
"payer_signature": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{130}(?![\\s\\S])"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"payee_signature",
"attestor_signature"
],
"properties": {
"payee_signature": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{130}(?![\\s\\S])"
},
"attestor_signature": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{130}(?![\\s\\S])"
}
},
"additionalProperties": false
}
]
},
"payer_terms_signature": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{130}(?![\\s\\S])"
}
},
"additionalProperties": false
},
"escrow_id": {
"type": "string",
"pattern": "^esc_[0-9a-f]{64}(?![\\s\\S])"
},
"idempotency_key": {
"type": "string",
"pattern": "^[a-zA-Z0-9_.:-]{1,128}(?![\\s\\S])"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"mode",
"escrow_id",
"idempotency_key"
],
"properties": {
"mode": {
"const": "refund_escrow"
},
"escrow_id": {
"type": "string",
"pattern": "^esc_[0-9a-f]{64}(?![\\s\\S])"
},
"idempotency_key": {
"type": "string",
"pattern": "^[a-zA-Z0-9_.:-]{1,128}(?![\\s\\S])"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"mode",
"escrow_id"
],
"properties": {
"mode": {
"const": "read_escrow"
},
"escrow_id": {
"type": "string",
"pattern": "^esc_[0-9a-f]{64}(?![\\s\\S])"
}
},
"additionalProperties": false
}
],
"required": [
"mode"
],
"properties": {
"mode": {
"enum": [
"prepare_funding",
"fund_escrow",
"release_escrow",
"refund_escrow",
"read_escrow"
]
},
"terms": {
"type": "object",
"required": [
"escrow_id",
"payer_wallet",
"payee_wallet",
"custody_wallet",
"chain_id",
"asset",
"amount_atomic",
"expires_at",
"funding_nonce",
"release_policy"
],
"properties": {
"asset": {
"const": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
},
"chain_id": {
"const": 8453
},
"escrow_id": {
"type": "string",
"pattern": "^esc_[0-9a-f]{64}(?![\\s\\S])"
},
"expires_at": {
"type": "integer",
"maximum": 4102444800,
"minimum": 1
},
"payee_wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"payer_wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"amount_atomic": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,77})(?![\\s\\S])"
},
"funding_nonce": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}(?![\\s\\S])"
},
"custody_wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"release_policy": {
"oneOf": [
{
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"const": "payer_signed"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"const": "mutual"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"attestor_wallet",
"delivery_sha256"
],
"properties": {
"kind": {
"const": "delivery_attestation"
},
"attestor_wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"delivery_sha256": {
"type": "string",
"pattern": "^[0-9a-f]{64}(?![\\s\\S])"
}
},
"additionalProperties": false
}
]
}
},
"additionalProperties": false
},
"mandate": {
"type": "object",
"required": [
"context",
"terms",
"payer_terms_signature",
"signatures"
],
"properties": {
"terms": {
"type": "object",
"required": [
"escrow_id",
"payer_wallet",
"payee_wallet",
"custody_wallet",
"chain_id",
"asset",
"amount_atomic",
"expires_at",
"funding_nonce",
"release_policy"
],
"properties": {
"asset": {
"const": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
},
"chain_id": {
"const": 8453
},
"escrow_id": {
"type": "string",
"pattern": "^esc_[0-9a-f]{64}(?![\\s\\S])"
},
"expires_at": {
"type": "integer",
"maximum": 4102444800,
"minimum": 1
},
"payee_wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"payer_wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"amount_atomic": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,77})(?![\\s\\S])"
},
"funding_nonce": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}(?![\\s\\S])"
},
"custody_wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"release_policy": {
"oneOf": [
{
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"const": "payer_signed"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"const": "mutual"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"attestor_wallet",
"delivery_sha256"
],
"properties": {
"kind": {
"const": "delivery_attestation"
},
"attestor_wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"delivery_sha256": {
"type": "string",
"pattern": "^[0-9a-f]{64}(?![\\s\\S])"
}
},
"additionalProperties": false
}
]
}
},
"additionalProperties": false
},
"context": {
"type": "object",
"required": [
"escrow_id",
"payer_wallet",
"payee_wallet",
"custody_wallet",
"chain_id",
"asset",
"amount_atomic",
"expires_at",
"funding_nonce",
"terms_sha256",
"funding_transaction_hash",
"release_nonce"
],
"properties": {
"asset": {
"const": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
},
"chain_id": {
"const": 8453
},
"escrow_id": {
"type": "string",
"pattern": "^esc_[0-9a-f]{64}(?![\\s\\S])"
},
"expires_at": {
"type": "integer",
"maximum": 4102444800,
"minimum": 1
},
"payee_wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"payer_wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"terms_sha256": {
"type": "string",
"pattern": "^[0-9a-f]{64}(?![\\s\\S])"
},
"amount_atomic": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,77})(?![\\s\\S])"
},
"funding_nonce": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}(?![\\s\\S])"
},
"release_nonce": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}(?![\\s\\S])"
},
"custody_wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"funding_transaction_hash": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}(?![\\s\\S])"
}
},
"additionalProperties": false
},
"signatures": {
"oneOf": [
{
"type": "object",
"required": [
"payer_signature"
],
"properties": {
"payer_signature": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{130}(?![\\s\\S])"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"payer_signature",
"payee_signature"
],
"properties": {
"payee_signature": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{130}(?![\\s\\S])"
},
"payer_signature": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{130}(?![\\s\\S])"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"payee_signature",
"attestor_signature"
],
"properties": {
"payee_signature": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{130}(?![\\s\\S])"
},
"attestor_signature": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{130}(?![\\s\\S])"
}
},
"additionalProperties": false
}
]
},
"payer_terms_signature": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{130}(?![\\s\\S])"
}
},
"additionalProperties": false
},
"escrow_id": {
"type": "string",
"pattern": "^esc_[0-9a-f]{64}(?![\\s\\S])"
},
"funding_payment": {
"anyOf": [
{
"type": "null"
},
{
"type": "object",
"required": [
"x402Version",
"resource",
"accepted",
"payload"
],
"properties": {
"payload": {
"type": "object",
"required": [
"signature",
"authorization"
],
"properties": {
"signature": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{130}(?![\\s\\S])"
},
"authorization": {
"type": "object",
"required": [
"from",
"to",
"value",
"validAfter",
"validBefore",
"nonce"
],
"properties": {
"to": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"from": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"nonce": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}(?![\\s\\S])"
},
"value": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,77})(?![\\s\\S])"
},
"validAfter": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,77})(?![\\s\\S])"
},
"validBefore": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,77})(?![\\s\\S])"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"accepted": {
"type": "object",
"required": [
"scheme",
"network",
"asset",
"amount",
"payTo",
"maxTimeoutSeconds",
"extra"
],
"properties": {
"asset": {
"const": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
},
"extra": {
"type": "object",
"required": [
"name",
"version"
],
"properties": {
"name": {
"const": "USD Coin"
},
"version": {
"const": "2"
}
},
"additionalProperties": false
},
"payTo": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"amount": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,77})(?![\\s\\S])"
},
"scheme": {
"const": "exact"
},
"network": {
"const": "eip155:8453"
},
"maxTimeoutSeconds": {
"type": "integer",
"maximum": 3600,
"minimum": 1
}
},
"additionalProperties": false
},
"resource": {
"type": "object",
"required": [
"url",
"description",
"mimeType"
],
"properties": {
"url": {
"type": "string",
"maxLength": 512,
"minLength": 1
},
"mimeType": {
"const": "application/json"
},
"description": {
"type": "string",
"maxLength": 256
}
},
"additionalProperties": false
},
"x402Version": {
"const": 2
}
},
"additionalProperties": false
}
]
},
"idempotency_key": {
"type": "string",
"pattern": "^[a-zA-Z0-9_.:-]{1,128}(?![\\s\\S])"
},
"payer_terms_signature": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{130}(?![\\s\\S])"
}
},
"additionalProperties": false
}| description | string |
| run_binding | object |
| buyer_wallet | string |
| amount_atomic | string |
| schema_version* | any |
| buyer_reference | string |
| idempotency_key | string |
| expected_version | integer |
{
"type": "object",
"oneOf": [
{
"type": "object",
"required": [
"schema_version",
"mode",
"idempotency_key",
"buyer_reference",
"buyer_wallet",
"rail_key",
"amount_atomic",
"expires_at",
"description",
"usage"
],
"properties": {
"mode": {
"const": "create_invoice_reference"
},
"usage": {
"enum": [
"synthetic",
"operational"
]
},
"rail_key": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}(?![\\s\\S])",
"maxLength": 64,
"minLength": 1
},
"expires_at": {
"type": "integer",
"maximum": 4102444800,
"minimum": 0
},
"description": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f]+(?![\\s\\S])",
"maxLength": 500,
"minLength": 1
},
"buyer_wallet": {
"type": "string",
"pattern": "^0x(?!0{40})[a-fA-F0-9]{40}(?![\\s\\S])"
},
"amount_atomic": {
"type": "string",
"pattern": "^[1-9][0-9]{0,11}(?![\\s\\S])"
},
"schema_version": {
"const": "1.0.0"
},
"buyer_reference": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]{0,127}(?![\\s\\S])",
"maxLength": 128,
"minLength": 1
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}(?![\\s\\S])",
"maxLength": 64,
"minLength": 1
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"schema_version",
"mode",
"invoice_id"
],
"properties": {
"mode": {
"const": "read_invoice"
},
"invoice_id": {
"type": "string",
"pattern": "^inv_[a-f0-9]{64}(?![\\s\\S])"
},
"schema_version": {
"const": "1.0.0"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"schema_version",
"mode",
"idempotency_key",
"invoice_id",
"expected_version",
"run_binding"
],
"properties": {
"mode": {
"const": "bind_invoice_to_run"
},
"invoice_id": {
"type": "string",
"pattern": "^inv_[a-f0-9]{64}(?![\\s\\S])"
},
"run_binding": {
"type": "object",
"required": [
"run_id",
"receipt_reference",
"return_package_reference",
"receipt_sha256",
"return_package_sha256"
],
"properties": {
"run_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]{0,127}(?![\\s\\S])",
"maxLength": 128,
"minLength": 1
},
"receipt_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}(?![\\s\\S])"
},
"receipt_reference": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]{0,127}(?![\\s\\S])",
"maxLength": 128,
"minLength": 1
},
"return_package_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}(?![\\s\\S])"
},
"return_package_reference": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]{0,127}(?![\\s\\S])",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
},
"schema_version": {
"const": "1.0.0"
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}(?![\\s\\S])",
"maxLength": 64,
"minLength": 1
},
"expected_version": {
"type": "integer",
"maximum": 3,
"minimum": 1
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"schema_version",
"mode",
"idempotency_key",
"invoice_id",
"expected_version",
"decision",
"note"
],
"properties": {
"mode": {
"const": "review_invoice"
},
"note": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f]+(?![\\s\\S])",
"maxLength": 500,
"minLength": 1
},
"decision": {
"enum": [
"approve",
"reject"
]
},
"invoice_id": {
"type": "string",
"pattern": "^inv_[a-f0-9]{64}(?![\\s\\S])"
},
"schema_version": {
"const": "1.0.0"
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}(?![\\s\\S])",
"maxLength": 64,
"minLength": 1
},
"expected_version": {
"type": "integer",
"maximum": 3,
"minimum": 1
}
},
"additionalProperties": false
}
],
"required": [
"schema_version",
"mode"
],
"properties": {
"mode": {
"enum": [
"create_invoice_reference",
"read_invoice",
"bind_invoice_to_run",
"review_invoice"
],
"type": "string"
},
"note": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f]+(?![\\s\\S])",
"maxLength": 500,
"minLength": 1
},
"usage": {
"enum": [
"synthetic",
"operational"
]
},
"decision": {
"enum": [
"approve",
"reject"
]
},
"rail_key": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}(?![\\s\\S])",
"maxLength": 64,
"minLength": 1
},
"expires_at": {
"type": "integer",
"maximum": 4102444800,
"minimum": 0
},
"invoice_id": {
"type": "string",
"pattern": "^inv_[a-f0-9]{64}(?![\\s\\S])"
},
"description": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f]+(?![\\s\\S])",
"maxLength": 500,
"minLength": 1
},
"run_binding": {
"type": "object",
"required": [
"run_id",
"receipt_reference",
"return_package_reference",
"receipt_sha256",
"return_package_sha256"
],
"properties": {
"run_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]{0,127}(?![\\s\\S])",
"maxLength": 128,
"minLength": 1
},
"receipt_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}(?![\\s\\S])"
},
"receipt_reference": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]{0,127}(?![\\s\\S])",
"maxLength": 128,
"minLength": 1
},
"return_package_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}(?![\\s\\S])"
},
"return_package_reference": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]{0,127}(?![\\s\\S])",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
},
"buyer_wallet": {
"type": "string",
"pattern": "^0x(?!0{40})[a-fA-F0-9]{40}(?![\\s\\S])"
},
"amount_atomic": {
"type": "string",
"pattern": "^[1-9][0-9]{0,11}(?![\\s\\S])"
},
"schema_version": {
"const": "1.0.0"
},
"buyer_reference": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]{0,127}(?![\\s\\S])",
"maxLength": 128,
"minLength": 1
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}(?![\\s\\S])",
"maxLength": 64,
"minLength": 1
},
"expected_version": {
"type": "integer",
"maximum": 3,
"minimum": 1
}
},
"additionalProperties": false
}| string |
| resource | string |
| resources | array |
| expires_at | integer |
| subject_wallet | string |
| idempotency_key | string |
{
"type": "object",
"oneOf": [
{
"type": "object",
"required": [
"mode",
"idempotency_key",
"subject_wallet",
"actions",
"resources",
"expires_at",
"usage"
],
"properties": {
"mode": {
"const": "grant"
},
"usage": {
"enum": [
"synthetic",
"operational"
]
},
"actions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 96,
"minLength": 1
},
"maxItems": 16,
"minItems": 1,
"uniqueItems": true
},
"resources": {
"type": "array",
"items": {
"type": "string",
"maxLength": 512,
"minLength": 1
},
"maxItems": 16,
"minItems": 1,
"uniqueItems": true
},
"expires_at": {
"type": "integer",
"maximum": 4102444800,
"minimum": 1
},
"subject_wallet": {
"type": "string",
"pattern": "^0x(?!0{40})[a-fA-F0-9]{40}(?![\\s\\S])"
},
"idempotency_key": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,96}(?![\\s\\S])"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"mode",
"idempotency_key",
"grant_id",
"reason",
"usage"
],
"properties": {
"mode": {
"const": "revoke"
},
"usage": {
"enum": [
"synthetic",
"operational"
]
},
"reason": {
"type": "string",
"maxLength": 512,
"minLength": 1
},
"grant_id": {
"type": "string",
"pattern": "^[a-f0-9]{64}(?![\\s\\S])"
},
"idempotency_key": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,96}(?![\\s\\S])"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"mode",
"subject_wallet",
"action",
"resource"
],
"properties": {
"mode": {
"const": "evaluate"
},
"action": {
"type": "string",
"maxLength": 96,
"minLength": 1
},
"resource": {
"type": "string",
"maxLength": 512,
"minLength": 1
},
"subject_wallet": {
"type": "string",
"pattern": "^0x(?!0{40})[a-fA-F0-9]{40}(?![\\s\\S])"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"mode",
"offset",
"limit"
],
"properties": {
"mode": {
"const": "list"
},
"limit": {
"type": "integer",
"maximum": 25,
"minimum": 1
},
"offset": {
"type": "integer",
"maximum": 255,
"minimum": 0
}
},
"additionalProperties": false
}
],
"required": [
"mode"
],
"properties": {
"mode": {
"enum": [
"grant",
"revoke",
"evaluate",
"list"
]
},
"limit": {
"type": "integer",
"maximum": 25,
"minimum": 1
},
"usage": {
"enum": [
"synthetic",
"operational"
]
},
"action": {
"type": "string",
"maxLength": 96,
"minLength": 1
},
"offset": {
"type": "integer",
"maximum": 255,
"minimum": 0
},
"reason": {
"type": "string",
"maxLength": 512,
"minLength": 1
},
"actions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 96,
"minLength": 1
},
"maxItems": 16,
"minItems": 1,
"uniqueItems": true
},
"grant_id": {
"type": "string",
"pattern": "^[a-f0-9]{64}(?![\\s\\S])"
},
"resource": {
"type": "string",
"maxLength": 512,
"minLength": 1
},
"resources": {
"type": "array",
"items": {
"type": "string",
"maxLength": 512,
"minLength": 1
},
"maxItems": 16,
"minItems": 1,
"uniqueItems": true
},
"expires_at": {
"type": "integer",
"maximum": 4102444800,
"minimum": 1
},
"subject_wallet": {
"type": "string",
"pattern": "^0x(?!0{40})[a-fA-F0-9]{40}(?![\\s\\S])"
},
"idempotency_key": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,96}(?![\\s\\S])"
}
},
"additionalProperties": false
}| any |
| idempotency_key | string |
| callback_probe_id | any |
{
"type": "object",
"oneOf": [
{
"type": "object",
"required": [
"mode",
"idempotency_key",
"label",
"expected_work",
"deadline_at",
"callback_url",
"retry_limit",
"usage"
],
"properties": {
"mode": {
"const": "record"
},
"label": {
"type": "string",
"maxLength": 160,
"minLength": 1
},
"usage": {
"enum": [
"synthetic",
"operational"
]
},
"deadline_at": {
"type": "integer",
"maximum": 4102444800,
"minimum": 1
},
"retry_limit": {
"type": "integer",
"maximum": 5,
"minimum": 0
},
"callback_url": {
"anyOf": [
{
"type": "string",
"maxLength": 2048,
"minLength": 1
},
{
"type": "null"
}
]
},
"expected_work": {
"oneOf": [
{
"type": "object",
"required": [
"kind",
"nonce"
],
"properties": {
"kind": {
"const": "wallet_free_call"
},
"nonce": {
"type": "string",
"pattern": "^[a-f0-9]{32,64}(?![\\s\\S])"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"payment_id"
],
"properties": {
"kind": {
"const": "settled_payment"
},
"payment_id": {
"type": "string",
"pattern": "^[a-f0-9]{64}(?![\\s\\S])"
}
},
"additionalProperties": false
}
]
},
"idempotency_key": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,96}(?![\\s\\S])"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"mode",
"idempotency_key",
"sla_id",
"callback_probe_id",
"usage"
],
"properties": {
"mode": {
"const": "evaluate"
},
"usage": {
"enum": [
"synthetic",
"operational"
]
},
"sla_id": {
"type": "string",
"pattern": "^[a-f0-9]{64}(?![\\s\\S])"
},
"idempotency_key": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,96}(?![\\s\\S])"
},
"callback_probe_id": {
"anyOf": [
{
"type": "string",
"pattern": "^[a-f0-9]{64}(?![\\s\\S])"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"mode",
"sla_id"
],
"properties": {
"mode": {
"const": "retrieve"
},
"sla_id": {
"type": "string",
"pattern": "^[a-f0-9]{64}(?![\\s\\S])"
}
},
"additionalProperties": false
}
],
"required": [
"mode"
],
"properties": {
"mode": {
"enum": [
"record",
"evaluate",
"retrieve"
]
},
"label": {
"type": "string",
"maxLength": 160,
"minLength": 1
},
"usage": {
"enum": [
"synthetic",
"operational"
]
},
"sla_id": {
"type": "string",
"pattern": "^[a-f0-9]{64}(?![\\s\\S])"
},
"deadline_at": {
"type": "integer",
"maximum": 4102444800,
"minimum": 1
},
"retry_limit": {
"type": "integer",
"maximum": 5,
"minimum": 0
},
"callback_url": {
"anyOf": [
{
"type": "string",
"maxLength": 2048,
"minLength": 1
},
{
"type": "null"
}
]
},
"expected_work": {
"oneOf": [
{
"type": "object",
"required": [
"kind",
"nonce"
],
"properties": {
"kind": {
"const": "wallet_free_call"
},
"nonce": {
"type": "string",
"pattern": "^[a-f0-9]{32,64}(?![\\s\\S])"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"payment_id"
],
"properties": {
"kind": {
"const": "settled_payment"
},
"payment_id": {
"type": "string",
"pattern": "^[a-f0-9]{64}(?![\\s\\S])"
}
},
"additionalProperties": false
}
]
},
"idempotency_key": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,96}(?![\\s\\S])"
},
"callback_probe_id": {
"anyOf": [
{
"type": "string",
"pattern": "^[a-f0-9]{64}(?![\\s\\S])"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}| idempotency_key |
| string |
| recipient_wallet | string |
{
"type": "object",
"oneOf": [
{
"type": "object",
"required": [
"mode",
"idempotency_key",
"recipient_wallet",
"task",
"permissions",
"state",
"usage"
],
"properties": {
"mode": {
"const": "build"
},
"task": {
"type": "object",
"required": [
"task_id",
"objective",
"context"
],
"properties": {
"context": {
"type": "string",
"maxLength": 4000,
"minLength": 1
},
"task_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,96}(?![\\s\\S])"
},
"objective": {
"type": "string",
"maxLength": 2000,
"minLength": 1
}
},
"additionalProperties": false
},
"state": {
"type": "object",
"required": [
"status",
"checkpoint",
"evidence_sha256"
],
"properties": {
"status": {
"enum": [
"pending",
"in_progress",
"blocked",
"completed"
]
},
"checkpoint": {
"type": "string",
"maxLength": 4000,
"minLength": 1
},
"evidence_sha256": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-f0-9]{64}(?![\\s\\S])"
},
"maxItems": 16,
"uniqueItems": true
}
},
"additionalProperties": false
},
"usage": {
"enum": [
"synthetic",
"operational"
]
},
"permissions": {
"type": "object",
"required": [
"allowed_actions",
"resources",
"expires_at",
"may_redelegate"
],
"properties": {
"resources": {
"type": "array",
"items": {
"type": "string",
"maxLength": 512,
"minLength": 1
},
"maxItems": 16,
"uniqueItems": true
},
"expires_at": {
"type": "integer",
"maximum": 4102444800,
"minimum": 1
},
"may_redelegate": {
"const": false
},
"allowed_actions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 160,
"minLength": 1
},
"maxItems": 16,
"uniqueItems": true
}
},
"additionalProperties": false
},
"idempotency_key": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,96}(?![\\s\\S])"
},
"recipient_wallet": {
"type": "string",
"pattern": "^0x(?!0{40})[a-fA-F0-9]{40}(?![\\s\\S])"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"mode",
"handoff_pack"
],
"properties": {
"mode": {
"const": "verify"
},
"handoff_pack": {
"type": "string",
"maxLength": 24000,
"minLength": 1
}
},
"additionalProperties": false
}
],
"required": [
"mode"
],
"properties": {
"mode": {
"enum": [
"build",
"verify"
]
},
"task": {
"type": "object",
"required": [
"task_id",
"objective",
"context"
],
"properties": {
"context": {
"type": "string",
"maxLength": 4000,
"minLength": 1
},
"task_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,96}(?![\\s\\S])"
},
"objective": {
"type": "string",
"maxLength": 2000,
"minLength": 1
}
},
"additionalProperties": false
},
"state": {
"type": "object",
"required": [
"status",
"checkpoint",
"evidence_sha256"
],
"properties": {
"status": {
"enum": [
"pending",
"in_progress",
"blocked",
"completed"
]
},
"checkpoint": {
"type": "string",
"maxLength": 4000,
"minLength": 1
},
"evidence_sha256": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-f0-9]{64}(?![\\s\\S])"
},
"maxItems": 16,
"uniqueItems": true
}
},
"additionalProperties": false
},
"usage": {
"enum": [
"synthetic",
"operational"
]
},
"permissions": {
"type": "object",
"required": [
"allowed_actions",
"resources",
"expires_at",
"may_redelegate"
],
"properties": {
"resources": {
"type": "array",
"items": {
"type": "string",
"maxLength": 512,
"minLength": 1
},
"maxItems": 16,
"uniqueItems": true
},
"expires_at": {
"type": "integer",
"maximum": 4102444800,
"minimum": 1
},
"may_redelegate": {
"const": false
},
"allowed_actions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 160,
"minLength": 1
},
"maxItems": 16,
"uniqueItems": true
}
},
"additionalProperties": false
},
"handoff_pack": {
"type": "string",
"maxLength": 24000,
"minLength": 1
},
"idempotency_key": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,96}(?![\\s\\S])"
},
"recipient_wallet": {
"type": "string",
"pattern": "^0x(?!0{40})[a-fA-F0-9]{40}(?![\\s\\S])"
}
},
"additionalProperties": false
}| category | string | Case-insensitive exact category id or label from the dataset. |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 50,
"minimum": 1
},
"query": {
"type": "string",
"maxLength": 256,
"minLength": 1,
"description": "Case-insensitive literal text search over sourced asset fields. Combined with category when both are supplied."
},
"stage": {
"enum": [
1,
2,
3
],
"type": "integer",
"description": "Exact taxonomy stage: 1 wrapper, 2 issuer-sponsored, 3 native issuance. All supplied filters are combined."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 10000,
"minimum": 0
},
"rights": {
"type": "object",
"properties": {
"voting": {
"enum": [
"holder votes",
"votes with management",
"none",
"not disclosed"
],
"type": "string"
},
"redemption": {
"enum": [
"redeemable for the underlying",
"not redeemable for the underlying",
"not disclosed"
],
"type": "string"
},
"legal_status": {
"enum": [
"owner of record",
"economic exposure only",
"not disclosed"
],
"type": "string"
},
"distributions": {
"enum": [
"passed through",
"not passed through",
"not disclosed"
],
"type": "string"
},
"custody_backing": {
"type": "string",
"pattern": "\\S",
"maxLength": 256,
"minLength": 1,
"description": "Case-insensitive literal substring in the disclosed backing and custodian description. Use not disclosed for an undisclosed value."
},
"issuer_involvement": {
"enum": [
"sponsored by the issuer",
"not sponsored",
"not disclosed"
],
"type": "string"
}
},
"description": "Combine disclosed rights filters. Enumerated values match exactly. not disclosed matches missing public disclosure, not a negative right.",
"minProperties": 1,
"additionalProperties": false
},
"category": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "Case-insensitive exact category id or label from the dataset."
}
},
"additionalProperties": false
}| idempotency_key |
| string |
| delivery_reference | string |
{
"type": "object",
"allOf": [
{
"if": {
"properties": {
"action": {
"const": "confirm"
}
}
},
"then": {
"required": [
"delivery_reference"
]
}
},
{
"if": {
"required": [
"action"
],
"properties": {
"action": {
"const": "dispute"
}
}
},
"then": {
"required": [
"claim"
]
}
},
{
"if": {
"required": [
"action"
],
"properties": {
"action": {
"const": "dispute-submit-evidence"
}
}
},
"then": {
"required": [
"references",
"idempotency_key"
]
}
}
],
"required": [
"order_id",
"order_token"
],
"properties": {
"claim": {
"type": "object",
"required": [
"reason_code",
"statement_sha256"
],
"properties": {
"uri": {
"type": "string",
"maxLength": 512,
"minLength": 1,
"description": "HTTPS, ipfs, or ar reference. No raw evidence, personal data, credentials, query strings, or fragments."
},
"reason_code": {
"enum": [
"non_delivery",
"quality",
"scope",
"payment",
"other"
]
},
"statement_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}(?![\\s\\S])"
}
},
"additionalProperties": false
},
"action": {
"enum": [
"confirm",
"dispute",
"dispute-status",
"dispute-submit-evidence",
"status"
],
"type": "string",
"default": "confirm"
},
"order_id": {
"type": "string",
"pattern": "^bo_[a-f0-9]{64}$",
"maxLength": 67
},
"references": {
"type": "array",
"items": {
"type": "object",
"required": [
"sha256",
"uri"
],
"properties": {
"uri": {
"type": "string",
"maxLength": 512,
"minLength": 1,
"description": "HTTPS, ipfs, or ar reference. No raw evidence, personal data, credentials, query strings, or fragments."
},
"sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}(?![\\s\\S])"
}
},
"additionalProperties": false
},
"maxItems": 4,
"minItems": 1,
"uniqueItems": true
},
"simulation": {
"type": "boolean",
"const": true,
"default": true
},
"order_token": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"maxLength": 64
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{8,128}(?![\\s\\S])"
},
"delivery_reference": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f]+$",
"maxLength": 256,
"minLength": 1
}
},
"additionalProperties": false
}| string |
{
"type": "object",
"allOf": [
{
"if": {
"required": [
"action"
],
"properties": {
"action": {
"enum": [
"initiate_payment",
"simulate_payment",
"status",
"confirm_fulfillment"
]
}
}
},
"then": {
"required": [
"order_token"
]
}
},
{
"if": {
"required": [
"action"
],
"properties": {
"action": {
"const": "confirm_fulfillment"
}
}
},
"then": {
"required": [
"fulfillment_reference"
]
}
}
],
"required": [
"product_id",
"buyer_wallet"
],
"properties": {
"action": {
"enum": [
"create",
"initiate_payment",
"simulate_payment",
"status",
"confirm_fulfillment"
],
"type": "string",
"default": "create"
},
"product_id": {
"type": "string",
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
"maxLength": 128
},
"simulation": {
"type": "boolean",
"const": true,
"default": true
},
"order_token": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"buyer_wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$"
},
"idempotency_key": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{16,64}$"
},
"fulfillment_reference": {
"type": "string",
"maxLength": 256,
"minLength": 1
}
},
"additionalProperties": false
}| max_price |
| number |
| min_price | number |
| page_size | integer |
| availability | string |
{
"type": "object",
"properties": {
"nwt": {
"type": "boolean"
},
"page": {
"type": "integer",
"maximum": 10000,
"minimum": 1
},
"size": {
"type": "string",
"maxLength": 80
},
"sort": {
"enum": [
"newest",
"price_low",
"price_high",
"most_liked"
],
"type": "string"
},
"brand": {
"type": "string",
"maxLength": 120
},
"query": {
"type": "string",
"maxLength": 120
},
"store": {
"enum": [
"women",
"men",
"kids",
"home"
],
"type": "string"
},
"category": {
"type": "string",
"maxLength": 120
},
"max_price": {
"type": "number",
"maximum": 100000,
"minimum": 0
},
"min_price": {
"type": "number",
"maximum": 100000,
"minimum": 0
},
"page_size": {
"type": "integer",
"maximum": 60,
"minimum": 1
},
"availability": {
"enum": [
"all",
"available",
"sold_out",
"unverified"
],
"type": "string",
"default": "all"
}
},
"additionalProperties": false
}| any |
{
"type": "object",
"$defs": {
"grantRequest": {
"type": "object",
"required": [
"operation",
"action",
"approval_reference",
"ttl_seconds",
"usage"
],
"properties": {
"usage": {
"enum": [
"synthetic",
"operational"
],
"description": "Must match the target agent usage configured on the server. Usage and attribution come from the agent credential."
},
"action": {
"$ref": "#/$defs/workOrderAction"
},
"operation": {
"const": "create_delegated_work_order"
},
"ttl_seconds": {
"type": "integer",
"maximum": 300,
"minimum": 1
},
"approval_reference": {
"type": "string",
"pattern": "^[a-zA-Z0-9_.:-]{1,128}(?![\\s\\S])",
"maxLength": 128,
"minLength": 1
}
},
"description": "The server sets amount_units to 1 and unit to work_order. approval_reference is operator-attested and bound into the grant; the operator supplies this consent record.",
"additionalProperties": false
},
"mandateInput": {
"type": "object",
"required": [
"principal_id",
"agent_id",
"scopes",
"max_runs",
"max_units",
"unit",
"consent_digest",
"not_before",
"expires_at",
"usage"
],
"properties": {
"unit": {
"const": "work_order"
},
"usage": {
"enum": [
"synthetic",
"operational"
],
"description": "Must match the target agent usage configured on the server. Usage and attribution come from the agent credential."
},
"scopes": {
"type": "array",
"items": {
"const": "create_delegated_work_order"
},
"maxItems": 1,
"minItems": 1,
"uniqueItems": true
},
"agent_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9_.:-]{1,128}(?![\\s\\S])",
"maxLength": 128,
"minLength": 1
},
"max_runs": {
"type": "integer",
"maximum": 10000,
"minimum": 1
},
"max_units": {
"type": "integer",
"maximum": 1000000000,
"minimum": 0
},
"expires_at": {
"type": "integer",
"maximum": 4102444800,
"minimum": 0
},
"not_before": {
"type": "integer",
"maximum": 4102444800,
"minimum": 0
},
"principal_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9_.:-]{1,128}(?![\\s\\S])",
"maxLength": 128,
"minLength": 1
},
"consent_digest": {
"type": "string",
"pattern": "^[0-9a-f]{64}(?![\\s\\S])"
}
},
"description": "Only create_delegated_work_order is enabled. max_units counts work-order records, not currency. The server enforces time relationships and configured agent scope/usage. consent_digest records operator-attested consent, not independent verification.",
"additionalProperties": false
},
"mandateClaims": {
"type": "object",
"required": [
"kind",
"audience",
"principal_id",
"agent_id",
"mandate_id",
"version",
"issued_at",
"not_before",
"expires_at",
"usage",
"scopes",
"max_runs",
"max_units",
"unit",
"consent_digest",
"issued_by"
],
"properties": {
"kind": {
"const": "mandate"
},
"unit": {
"const": "work_order"
},
"usage": {
"enum": [
"synthetic",
"operational"
],
"description": "Must match the target agent usage configured on the server. Usage and attribution come from the agent credential."
},
"scopes": {
"type": "array",
"items": {
"const": "create_delegated_work_order"
},
"maxItems": 1,
"minItems": 1,
"uniqueItems": true
},
"version": {
"type": "integer",
"maximum": 1000000000,
"minimum": 1
},
"agent_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9_.:-]{1,128}(?![\\s\\S])",
"maxLength": 128,
"minLength": 1
},
"audience": {
"const": "wever-delegated-authority-v2"
},
"max_runs": {
"type": "integer",
"maximum": 10000,
"minimum": 1
},
"issued_at": {
"type": "integer",
"maximum": 4102444800,
"minimum": 0
},
"issued_by": {
"type": "string",
"pattern": "^[a-zA-Z0-9_.:-]{1,128}(?![\\s\\S])",
"maxLength": 128,
"minLength": 1
},
"max_units": {
"type": "integer",
"maximum": 1000000000,
"minimum": 0
},
"expires_at": {
"type": "integer",
"maximum": 4102444800,
"minimum": 0
},
"mandate_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}(?![\\s\\S])"
},
"not_before": {
"type": "integer",
"maximum": 4102444800,
"minimum": 0
},
"principal_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9_.:-]{1,128}(?![\\s\\S])",
"maxLength": 128,
"minLength": 1
},
"consent_digest": {
"type": "string",
"pattern": "^[0-9a-f]{64}(?![\\s\\S])"
}
},
"additionalProperties": false
},
"signedMandate": {
"type": "object",
"required": [
"context",
"algorithm",
"key_id",
"payload",
"signature"
],
"properties": {
"key_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9_.:-]{1,128}(?![\\s\\S])",
"maxLength": 128,
"minLength": 1
},
"context": {
"const": "wever.authority.v2"
},
"payload": {
"$ref": "#/$defs/mandateClaims"
},
"algorithm": {
"const": "Ed25519"
},
"signature": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{86}(?![\\s\\S])"
}
},
"description": "Use the unmodified envelope returned by the authority API. The backend verifies its signature, active time window, durable record, credentials and claim bindings. Successful runtime verification establishes the accepted authority.",
"additionalProperties": false
},
"workOrderAction": {
"type": "object",
"required": [
"requested_outcome",
"requirements",
"target_product_key"
],
"properties": {
"requirements": {
"type": "array",
"items": {
"type": "string",
"pattern": "^(?!\\s)(?![\\s\\S]*[\\u0000-\\u001f\\u007f-\\u009f])(?:[\\s\\S]*\\S)(?![\\s\\S])",
"maxLength": 256,
"minLength": 1,
"description": "Well-formed Unicode text without surrounding whitespace or control characters, at most 256 UTF-8 bytes. JSON Schema maxLength counts characters; the backend additionally enforces well-formed Unicode and the exact UTF-8 byte limit."
},
"maxItems": 16,
"uniqueItems": true
},
"requested_outcome": {
"type": "string",
"pattern": "^(?!\\s)(?![\\s\\S]*[\\u0000-\\u001f\\u007f-\\u009f])(?:[\\s\\S]*\\S)(?![\\s\\S])",
"maxLength": 1024,
"minLength": 1,
"description": "Well-formed Unicode text without surrounding whitespace or control characters, at most 1024 UTF-8 bytes. JSON Schema maxLength counts characters; the backend additionally enforces well-formed Unicode and the exact UTF-8 byte limit."
},
"target_product_key": {
"enum": [
"diligenceops-paid-run",
"mcp-diligence-rail",
"agent-daily-operator-brief",
"agent-work-order-rail",
null
],
"description": "A maintained computation reference or null. Use its service endpoint to run the computation."
}
},
"description": "The exact approved immutable work-order content. No caller-supplied attribution, identifiers, prices, callback URLs or execution claims are accepted.",
"additionalProperties": false
},
"actionGrantClaims": {
"type": "object",
"required": [
"kind",
"audience",
"principal_id",
"agent_id",
"mandate_id",
"version",
"issued_at",
"not_before",
"expires_at",
"usage",
"grant_id",
"operation",
"action_digest",
"amount_units",
"unit",
"downstream_key",
"approved_by",
"approval_reference_hash"
],
"properties": {
"kind": {
"const": "grant"
},
"unit": {
"const": "work_order"
},
"usage": {
"enum": [
"synthetic",
"operational"
],
"description": "Must match the target agent usage configured on the server. Usage and attribution come from the agent credential."
},
"version": {
"type": "integer",
"maximum": 1000000000,
"minimum": 1
},
"agent_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9_.:-]{1,128}(?![\\s\\S])",
"maxLength": 128,
"minLength": 1
},
"audience": {
"const": "wever-delegated-authority-v2"
},
"grant_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}(?![\\s\\S])"
},
"issued_at": {
"type": "integer",
"maximum": 4102444800,
"minimum": 0
},
"operation": {
"const": "create_delegated_work_order"
},
"expires_at": {
"type": "integer",
"maximum": 4102444800,
"minimum": 0
},
"mandate_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}(?![\\s\\S])"
},
"not_before": {
"type": "integer",
"maximum": 4102444800,
"minimum": 0
},
"approved_by": {
"type": "string",
"pattern": "^[a-zA-Z0-9_.:-]{1,128}(?![\\s\\S])",
"maxLength": 128,
"minLength": 1
},
"amount_units": {
"const": 1
},
"principal_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9_.:-]{1,128}(?![\\s\\S])",
"maxLength": 128,
"minLength": 1
},
"action_digest": {
"type": "string",
"pattern": "^[0-9a-f]{64}(?![\\s\\S])"
},
"downstream_key": {
"type": "string",
"pattern": "^authority-v2:[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}(?![\\s\\S])"
},
"approval_reference_hash": {
"type": "string",
"pattern": "^[0-9a-f]{64}(?![\\s\\S])"
}
},
"additionalProperties": false
},
"signedActionGrant": {
"type": "object",
"required": [
"context",
"algorithm",
"key_id",
"payload",
"signature"
],
"properties": {
"key_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9_.:-]{1,128}(?![\\s\\S])",
"maxLength": 128,
"minLength": 1
},
"context": {
"const": "wever.authority.v2"
},
"payload": {
"$ref": "#/$defs/actionGrantClaims"
},
"algorithm": {
"const": "Ed25519"
},
"signature": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{86}(?![\\s\\S])"
}
},
"description": "Use the unmodified envelope returned by the authority API. The backend verifies its signature, active time window, durable record, credentials and claim bindings. Successful runtime verification establishes the accepted authority.",
"additionalProperties": false
}
},
"oneOf": [
{
"type": "object",
"required": [
"mode"
],
"properties": {
"mode": {
"const": "read_control_plane"
}
},
"description": "Read the public contract. This performs no authority issuance or downstream write.",
"additionalProperties": false
},
{
"type": "object",
"required": [
"mode",
"mandate"
],
"properties": {
"mode": {
"const": "draft_mandate"
},
"mandate": {
"$ref": "#/$defs/mandateInput"
}
},
"description": "Validate a public unsigned_dev draft. It is not signed, persisted or executable. Expiry must follow not_before by no more than 30 days.",
"additionalProperties": false
},
{
"type": "object",
"required": [
"mode",
"mandate"
],
"properties": {
"mode": {
"const": "issue_mandate"
},
"mandate": {
"$ref": "#/$defs/mandateInput"
}
},
"description": "Requires X-Wever-Operator-Key and Idempotency-Key. Issue one durable signed mandate for a configured agent. The active time window is limited to 30 days from issuance.",
"additionalProperties": false
},
{
"type": "object",
"required": [
"mode",
"signed_mandate",
"request"
],
"properties": {
"mode": {
"const": "issue_action_grant"
},
"request": {
"$ref": "#/$defs/grantRequest"
},
"signed_mandate": {
"$ref": "#/$defs/signedMandate"
}
},
"description": "Requires the issuing operator X-Wever-Operator-Key and Idempotency-Key. Reserve one work_order unit and approve this exact action for at most 300 seconds. The issuing operator approves the grant.",
"additionalProperties": false
},
{
"type": "object",
"required": [
"mode",
"signed_action_grant",
"action"
],
"properties": {
"mode": {
"const": "execute_delegated_action"
},
"action": {
"$ref": "#/$defs/workOrderAction"
},
"signed_action_grant": {
"$ref": "#/$defs/signedActionGrant"
}
},
"description": "Requires the target agent X-Wever-Agent-Key. Consume the signed grant once to create its immutable work-order record. Inspect or retry the same grant until record creation is final. Work execution, delivery and payment follow through their own services.",
"additionalProperties": false
},
{
"type": "object",
"required": [
"mode",
"grant_id"
],
"properties": {
"mode": {
"const": "inspect_action_grant"
},
"grant_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}(?![\\s\\S])"
}
},
"description": "Requires the bound agent X-Wever-Agent-Key. Read durable grant state and any finalized result.",
"additionalProperties": false
},
{
"type": "object",
"required": [
"mode",
"mandate_id"
],
"properties": {
"mode": {
"const": "revoke_mandate"
},
"mandate_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}(?![\\s\\S])"
}
},
"description": "Requires the issuing operator X-Wever-Operator-Key. Revoke future authority. Committed records remain in history; in-flight effects keep their existing recovery process.",
"additionalProperties": false
},
{
"type": "object",
"required": [
"mode",
"mandate_id"
],
"properties": {
"mode": {
"const": "read_audit"
},
"after": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"mandate_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}(?![\\s\\S])"
}
},
"description": "Requires the bound agent X-Wever-Agent-Key. Read this mandate audit after the supplied cursor, default 0, with a default limit of 50.",
"additionalProperties": false
},
{
"type": "object",
"required": [
"mode",
"mandate"
],
"properties": {
"mode": {
"const": "issue_mandate"
},
"mandate": {
"type": "object",
"required": [
"profile",
"challenge_token",
"holder_jwk",
"consent_digest",
"expires_at"
],
"properties": {
"profile": {
"const": "com.weverlabs.ap2.direct-checkout.1"
},
"expires_at": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"holder_jwk": {
"type": "object",
"required": [
"kty",
"crv",
"x",
"y"
],
"properties": {
"x": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{43}(?![\\s\\S])"
},
"y": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{43}(?![\\s\\S])"
},
"crv": {
"const": "secp256k1"
},
"kty": {
"const": "EC"
}
},
"additionalProperties": false
},
"consent_digest": {
"type": "string",
"pattern": "^[a-f0-9]{64}(?![\\s\\S])"
},
"challenge_token": {
"type": "string",
"maxLength": 16384,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
],
"required": [
"mode"
],
"properties": {
"mode": {
"enum": [
"read_control_plane",
"draft_mandate",
"issue_mandate",
"issue_action_grant",
"execute_delegated_action",
"inspect_action_grant",
"revoke_mandate",
"read_audit"
]
}
},
"description": "Exact delegated-authority v2 request shapes. Credentials and issuance idempotency keys are HTTP headers, never tool arguments. The backend additionally enforces signed cross-field bindings, active time windows, credential-bound usage, exact approved action digests and durable allowance state."
}| idempotency_key* |
| string |
| payee_amount_atomic | string |
| payer_amount_atomic | string |
| operator_authorization* | string |
{
"type": "object",
"allOf": [
{
"if": {
"properties": {
"action": {
"const": "resolve"
}
}
},
"else": {
"not": {
"anyOf": [
{
"required": [
"outcome"
]
},
{
"required": [
"payee_amount_atomic"
]
},
{
"required": [
"payer_amount_atomic"
]
}
]
}
},
"then": {
"required": [
"outcome",
"payee_amount_atomic",
"payer_amount_atomic"
]
}
}
],
"required": [
"dispute_id",
"idempotency_key",
"action",
"reason_sha256",
"operator_authorization"
],
"properties": {
"action": {
"enum": [
"resolve",
"extend"
]
},
"outcome": {
"enum": [
"release",
"refund",
"split"
]
},
"dispute_id": {
"type": "string",
"pattern": "^dp_[a-f0-9]{64}(?![\\s\\S])"
},
"reason_uri": {
"type": "string",
"maxLength": 512,
"minLength": 1,
"description": "HTTPS, ipfs, or ar reference. No raw evidence, personal data, credentials, query strings, or fragments."
},
"reason_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}(?![\\s\\S])"
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{8,128}(?![\\s\\S])"
},
"payee_amount_atomic": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,8})(?![\\s\\S])"
},
"payer_amount_atomic": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,8})(?![\\s\\S])"
},
"operator_authorization": {
"type": "string",
"maxLength": 8192,
"minLength": 1
}
},
"additionalProperties": false
}| string |
{
"type": "object",
"required": [
"mode",
"transaction_hash",
"payer",
"payee",
"amount_atomic",
"authorization_nonce",
"min_confirmations"
],
"properties": {
"mode": {
"const": "inspect_base_usdc_settlement"
},
"payee": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"payer": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"amount_atomic": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,77})(?![\\s\\S])"
},
"transaction_hash": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}(?![\\s\\S])"
},
"min_confirmations": {
"type": "integer",
"maximum": 100,
"minimum": 2
},
"authorization_nonce": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}(?![\\s\\S])"
}
},
"additionalProperties": false
}| string |
| principal_signature* | string |
{
"type": "object",
"required": [
"payout_id",
"idempotency_key",
"presentation",
"challenge_token",
"expires_at",
"principal_signature"
],
"properties": {
"payout_id": {
"type": "string",
"pattern": "^po_[a-f0-9]{64}(?![\\s\\S])"
},
"expires_at": {
"type": "integer",
"maximum": 4102444800,
"minimum": 1
},
"presentation": {
"type": "string",
"maxLength": 24576,
"minLength": 1
},
"challenge_token": {
"type": "string",
"maxLength": 8192,
"minLength": 1
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,128}(?![\\s\\S])"
},
"principal_signature": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{130}(?![\\s\\S])"
}
},
"additionalProperties": false
}| string |
{
"type": "object",
"required": [
"recipient",
"amount_usdc",
"idempotency_key",
"memo",
"rail_reference"
],
"properties": {
"memo": {
"type": "string",
"maxLength": 1024
},
"usage": {
"enum": [
"synthetic",
"operational",
"unspecified"
]
},
"recipient": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"amount_usdc": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,8})(\\.[0-9]{1,6})?(?![\\s\\S])"
},
"rail_reference": {
"type": "string",
"maxLength": 256
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,128}(?![\\s\\S])"
}
},
"additionalProperties": false
}{
"type": "object",
"oneOf": [
{
"type": "object",
"required": [
"mode",
"idempotency_key",
"proof"
],
"properties": {
"mode": {
"const": "store"
},
"proof": {
"type": "object",
"required": [
"kind",
"content",
"label"
],
"properties": {
"kind": {
"enum": [
"receipt_passport",
"handoff_pack",
"evidence"
]
},
"label": {
"type": "string",
"maxLength": 160,
"minLength": 1
},
"content": {
"type": "string",
"maxLength": 24000,
"minLength": 1
}
},
"additionalProperties": false
},
"idempotency_key": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,96}(?![\\s\\S])"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"mode",
"offset",
"limit"
],
"properties": {
"mode": {
"const": "list"
},
"limit": {
"type": "integer",
"maximum": 25,
"minimum": 1
},
"offset": {
"type": "integer",
"maximum": 255,
"minimum": 0
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"mode",
"proof_id"
],
"properties": {
"mode": {
"const": "retrieve"
},
"proof_id": {
"type": "string",
"pattern": "^[a-f0-9]{64}(?![\\s\\S])"
}
},
"additionalProperties": false
}
],
"required": [
"mode"
],
"properties": {
"mode": {
"enum": [
"store",
"list",
"retrieve"
]
},
"limit": {
"type": "integer",
"maximum": 25,
"minimum": 1
},
"proof": {
"type": "object",
"required": [
"kind",
"content",
"label"
],
"properties": {
"kind": {
"enum": [
"receipt_passport",
"handoff_pack",
"evidence"
]
},
"label": {
"type": "string",
"maxLength": 160,
"minLength": 1
},
"content": {
"type": "string",
"maxLength": 24000,
"minLength": 1
}
},
"additionalProperties": false
},
"offset": {
"type": "integer",
"maximum": 255,
"minimum": 0
},
"proof_id": {
"type": "string",
"pattern": "^[a-f0-9]{64}(?![\\s\\S])"
},
"idempotency_key": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,96}(?![\\s\\S])"
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"wallet_address"
],
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1
},
"end_time": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{3})?Z$",
"maxLength": 24,
"description": "UTC ISO 8601 timestamp, for example 2026-10-01T00:00:00Z. Start is inclusive and end is exclusive; maximum window 366 days. Defaults to the current time."
},
"start_time": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{3})?Z$",
"maxLength": 24,
"description": "UTC ISO 8601 timestamp, for example 2026-10-01T00:00:00Z. Start is inclusive and end is exclusive; maximum window 366 days. Defaults to 30 days before end_time."
},
"wallet_address": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"maxLength": 42,
"minLength": 42,
"description": "Public Base wallet address in its exact EIP-55 checksum spelling. No ownership proof or secrets belong in tool arguments."
}
},
"additionalProperties": false
}| worker_wallet* | string |
| idempotency_key* | string |
| acceptance_criteria* | array |
{
"type": "object",
"required": [
"idempotency_key",
"title",
"description",
"acceptance_criteria",
"price_usdc",
"deadline",
"worker_wallet"
],
"properties": {
"title": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f-\\u009f]+(?![\\s\\S])",
"maxLength": 200,
"minLength": 1,
"description": "At most 200 UTF-8 bytes. Control characters are not allowed."
},
"usage": {
"enum": [
"synthetic",
"operational"
]
},
"deadline": {
"type": "integer",
"maximum": 4102444800,
"minimum": 1
},
"price_usdc": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,2})(\\.[0-9]{1,6})?(?![\\s\\S])"
},
"description": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f-\\u009f]+(?![\\s\\S])",
"maxLength": 4000,
"minLength": 1,
"description": "At most 4000 UTF-8 bytes. Control characters are not allowed."
},
"worker_wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]+(?![\\s\\S])",
"maxLength": 128,
"minLength": 8
},
"acceptance_criteria": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f-\\u009f]+(?![\\s\\S])",
"maxLength": 500,
"minLength": 1,
"description": "At most 500 UTF-8 bytes. Control characters are not allowed."
},
"maxItems": 16,
"minItems": 1,
"uniqueItems": true
}
},
"additionalProperties": false
}| idempotency_key* | string |
{
"type": "object",
"required": [
"order_id",
"idempotency_key",
"mandate",
"presentation",
"challenge_token"
],
"properties": {
"mandate": {
"type": "object",
"required": [
"context",
"terms",
"payer_terms_signature",
"signatures"
],
"properties": {
"terms": {
"type": "object",
"required": [
"escrow_id",
"payer_wallet",
"payee_wallet",
"custody_wallet",
"chain_id",
"asset",
"amount_atomic",
"expires_at",
"funding_nonce",
"release_policy"
],
"properties": {
"asset": {
"const": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
},
"chain_id": {
"const": 8453
},
"escrow_id": {
"type": "string",
"pattern": "^esc_[0-9a-f]{64}(?![\\s\\S])"
},
"expires_at": {
"type": "integer",
"maximum": 4102444800,
"minimum": 1
},
"payee_wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"payer_wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"amount_atomic": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,77})(?![\\s\\S])"
},
"funding_nonce": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}(?![\\s\\S])"
},
"custody_wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"release_policy": {
"oneOf": [
{
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"const": "payer_signed"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"const": "mutual"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"attestor_wallet",
"delivery_sha256"
],
"properties": {
"kind": {
"const": "delivery_attestation"
},
"attestor_wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"delivery_sha256": {
"type": "string",
"pattern": "^[0-9a-f]{64}(?![\\s\\S])"
}
},
"additionalProperties": false
}
]
}
},
"additionalProperties": false
},
"context": {
"type": "object",
"required": [
"escrow_id",
"payer_wallet",
"payee_wallet",
"custody_wallet",
"chain_id",
"asset",
"amount_atomic",
"expires_at",
"funding_nonce",
"terms_sha256",
"funding_transaction_hash",
"release_nonce"
],
"properties": {
"asset": {
"const": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
},
"chain_id": {
"const": 8453
},
"escrow_id": {
"type": "string",
"pattern": "^esc_[0-9a-f]{64}(?![\\s\\S])"
},
"expires_at": {
"type": "integer",
"maximum": 4102444800,
"minimum": 1
},
"payee_wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"payer_wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"terms_sha256": {
"type": "string",
"pattern": "^[0-9a-f]{64}(?![\\s\\S])"
},
"amount_atomic": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,77})(?![\\s\\S])"
},
"funding_nonce": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}(?![\\s\\S])"
},
"release_nonce": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}(?![\\s\\S])"
},
"custody_wallet": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}(?![\\s\\S])"
},
"funding_transaction_hash": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{64}(?![\\s\\S])"
}
},
"additionalProperties": false
},
"signatures": {
"oneOf": [
{
"type": "object",
"required": [
"payer_signature"
],
"properties": {
"payer_signature": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{130}(?![\\s\\S])"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"payer_signature",
"payee_signature"
],
"properties": {
"payee_signature": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{130}(?![\\s\\S])"
},
"payer_signature": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{130}(?![\\s\\S])"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"payee_signature",
"attestor_signature"
],
"properties": {
"payee_signature": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{130}(?![\\s\\S])"
},
"attestor_signature": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{130}(?![\\s\\S])"
}
},
"additionalProperties": false
}
]
},
"payer_terms_signature": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{130}(?![\\s\\S])"
}
},
"additionalProperties": false
},
"order_id": {
"type": "string",
"pattern": "^wo_[a-f0-9]{64}(?![\\s\\S])"
},
"presentation": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f-\\u009f]+(?![\\s\\S])",
"maxLength": 32768,
"minLength": 1,
"description": "At most 32768 UTF-8 bytes. Control characters are not allowed."
},
"challenge_token": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f-\\u009f]+(?![\\s\\S])",
"maxLength": 16384,
"minLength": 1,
"description": "At most 16384 UTF-8 bytes. Control characters are not allowed."
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]+(?![\\s\\S])",
"maxLength": 128,
"minLength": 8
}
},
"additionalProperties": false
}