{ "version": "1.0", "name": "Vealth x402 API", "description": "The program of programs that provisions ecological wealth — the work lifecycle as paid x402 endpoints (packet → post → proof → settle → account → retire), USDC on Base", "home": "https://vealth.net", "documentation": "https://vealth.net/llms.txt", "discoveryUrl": "https://vealth.net/.well-known/x402", "mcp": { "endpoint": "https://vealth.net/mcp", "transport": "jsonrpc-2.0-http-post", "toolListCall": "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\"}", "pricing": "Board reads, priority-proof anchoring, and the signed worker path are free and keyless. The provisioning tools return a paid x402 door and the exact call; the MCP server itself never takes payment and holds no wallet.", "documentation": "https://vealth.net/agent.md" }, "resources": [ "https://vealth.net/.well-known/vealth/build-eco-food", "https://vealth.net/.well-known/vealth/build-eco-food-retire", "https://vealth.net/vealth/api/x402/build-eco-food", "https://vealth.net/vealth/api/x402/build-eco-food-retire", "https://vealth.net/.well-known/vealth/klima2-retire", "https://vealth.net/.well-known/vealth/lbc-building-scan", "https://vealth.net/.well-known/vealth/michelin-score", "https://vealth.net/.well-known/vealth/sdg-assessment", "https://vealth.net/vealth/api/x402/michelin/score", "https://vealth.net/.well-known/vealth/agent-kit", "https://vealth.net/.well-known/vealth/agent-readiness", "https://vealth.net/.well-known/vealth/agent-readiness-verify", "https://vealth.net/.well-known/vealth/ai-retire-bundler", "https://vealth.net/.well-known/vealth/bridge-route", "https://vealth.net/.well-known/vealth/carbon-retired", "https://vealth.net/.well-known/vealth/cert-authenticate", "https://vealth.net/.well-known/vealth/cross-verify", "https://vealth.net/.well-known/vealth/ewp-adoption-sim", "https://vealth.net/.well-known/vealth/health-packet", "https://vealth.net/.well-known/vealth/intent-compile", "https://vealth.net/.well-known/vealth/intent-market", "https://vealth.net/.well-known/vealth/method-template", "https://vealth.net/.well-known/vealth/michelin-gap-analyzer", "https://vealth.net/.well-known/vealth/nrel-solar-yield-batch", "https://vealth.net/.well-known/vealth/packet-compile", "https://vealth.net/.well-known/vealth/provisioning-package", "https://vealth.net/.well-known/vealth/regen-class-momentum", "https://vealth.net/.well-known/vealth/regen-methodology-draft", "https://vealth.net/.well-known/vealth/regen-reputation", "https://vealth.net/.well-known/vealth/regen-retirement-builder", "https://vealth.net/.well-known/vealth/regen-rfc-reviewer", "https://vealth.net/.well-known/vealth/retire-attach", "https://vealth.net/.well-known/vealth/settle-on-proof", "https://vealth.net/.well-known/vealth/settlement-attest", "https://vealth.net/.well-known/vealth/site-integrity-verify", "https://vealth.net/.well-known/vealth/site-sweep", "https://vealth.net/.well-known/vealth/standards-classifier", "https://vealth.net/.well-known/vealth/starter-pack", "https://vealth.net/.well-known/vealth/sustainability-disclosure-verify", "https://vealth.net/.well-known/vealth/swarm-strategy", "https://vealth.net/.well-known/vealth/tco2e-oracle", "https://vealth.net/.well-known/vealth/verifiable-work-match", "https://vealth.net/.well-known/vealth/verify-badge", "https://vealth.net/.well-known/vealth/verify-claim", "https://vealth.net/.well-known/vealth/verify-subscription", "https://vealth.net/.well-known/vealth/wallet-reputation", "https://vealth.net/.well-known/vealth/work-near", "https://vealth.net/.well-known/vealth/work-packet", "https://vealth.net/.well-known/vealth/work-proof-check", "https://vealth.net/.well-known/vealth/work-tco2e", "https://vealth.net/.well-known/vealth/x402-fix", "https://vealth.net/.well-known/vealth/x402-readiness" ], "endpoints": [ { "path": "/.well-known/vealth/build-eco-food", "method": "POST", "priceUsd": 0.03, "description": "3-leg mission-only agent bundle — one $0.03 payment runs SDG + Michelin + LBC. No retire leg. For callers who want the three scorecards without retirement", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "address": "123 Main St", "sqft": 500, "budget": 10000, "occupancy": 2, "selectedSDGs": [ "sdg11" ] } }, "output": { "type": "json", "example": { "ok": true, "bundle": "mission-only", "bundle_id": "2026-04-21T20:00:00.000Z", "paid_usdc": 0.03, "all_legs_ok": true, "partial": false, "legs": [ { "name": "sdg", "ok": true, "sdgs": [ "sdg11" ], "methodology_version": "v1" }, { "name": "michelin", "ok": true, "score": 48, "tier": "bib_gourmand" }, { "name": "lbc", "ok": true, "score": 70, "tier": "petal" } ], "ts": "2026-04-21T20:00:00.000Z" } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "address": { "type": "string" }, "sqft": { "type": "number" }, "budget": { "type": "number" }, "occupancy": { "type": "number" }, "selectedSDGs": { "type": "array" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "flagship" }, { "path": "/.well-known/vealth/build-eco-food-retire", "method": "POST", "priceUsd": 0.04, "description": "4-leg agent bundle — one $0.04 payment runs SDG + Michelin + LBC and settles a two-child (wind + solar) retirement through the Bankr retire x402 rail. Honest on_chain / prepared / failed status per child", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "address": "123 Main St", "sqft": 500, "budget": 10000, "occupancy": 2, "selectedSDGs": [ "sdg11" ], "solar_usd": 0.05, "wind_usd": 0.05 } }, "output": { "type": "json", "example": { "ok": true, "bundle": "mission-retire", "bundle_id": "2026-04-21T19:00:00.000Z", "paid_usdc": 0.04, "all_legs_ok": true, "partial": false, "legs": [ { "name": "sdg", "ok": true, "sdgs": [ "sdg11" ], "methodology_version": "v1" }, { "name": "michelin", "ok": true, "score": 48, "tier": "bib_gourmand" }, { "name": "lbc", "ok": true, "score": 70, "tier": "petal" }, { "name": "bankr_retire", "ok": true, "leg_status": "on_chain", "children": { "solar": { "status": "on_chain", "usd_paid": 0.005, "amount_tonnes": 0.01, "tx_hash": "0x...", "tx_url": "https://basescan.org/tx/0x..." }, "wind": { "status": "on_chain", "usd_paid": 0.005, "amount_tonnes": 0.01, "tx_hash": "0x...", "tx_url": "https://basescan.org/tx/0x..." } } } ], "ts": "2026-04-21T19:00:00.000Z" } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "address": { "type": "string" }, "sqft": { "type": "number" }, "budget": { "type": "number" }, "occupancy": { "type": "number" }, "selectedSDGs": { "type": "array" }, "solar_usd": { "type": "number" }, "wind_usd": { "type": "number" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "flagship" }, { "path": "/vealth/api/x402/build-eco-food", "method": "POST", "priceUsd": 0.03, "description": "3-leg mission-only agent bundle — one $0.03 payment runs SDG + Michelin + LBC. No retire leg. For callers who want the three scorecards without retirement", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "address": "123 Main St", "sqft": 500, "budget": 10000, "occupancy": 2, "selectedSDGs": [ "sdg11" ] } }, "output": { "type": "json", "example": { "ok": true, "bundle": "mission-only", "bundle_id": "2026-04-21T20:00:00.000Z", "paid_usdc": 0.03, "all_legs_ok": true, "partial": false, "legs": [ { "name": "sdg", "ok": true, "sdgs": [ "sdg11" ], "methodology_version": "v1" }, { "name": "michelin", "ok": true, "score": 48, "tier": "bib_gourmand" }, { "name": "lbc", "ok": true, "score": 70, "tier": "petal" } ], "ts": "2026-04-21T20:00:00.000Z" } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "address": { "type": "string" }, "sqft": { "type": "number" }, "budget": { "type": "number" }, "occupancy": { "type": "number" }, "selectedSDGs": { "type": "array" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "flagship" }, { "path": "/vealth/api/x402/build-eco-food-retire", "method": "POST", "priceUsd": 0.04, "description": "4-leg agent bundle — one $0.04 payment runs SDG + Michelin + LBC and settles a two-child (wind + solar) retirement through the Bankr retire x402 rail. Honest on_chain / prepared / failed status per child", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "address": "123 Main St", "sqft": 500, "budget": 10000, "occupancy": 2, "selectedSDGs": [ "sdg11" ], "solar_usd": 0.05, "wind_usd": 0.05 } }, "output": { "type": "json", "example": { "ok": true, "bundle": "mission-retire", "bundle_id": "2026-04-21T19:00:00.000Z", "paid_usdc": 0.04, "all_legs_ok": true, "partial": false, "legs": [ { "name": "sdg", "ok": true, "sdgs": [ "sdg11" ], "methodology_version": "v1" }, { "name": "michelin", "ok": true, "score": 48, "tier": "bib_gourmand" }, { "name": "lbc", "ok": true, "score": 70, "tier": "petal" }, { "name": "bankr_retire", "ok": true, "leg_status": "on_chain", "children": { "solar": { "status": "on_chain", "usd_paid": 0.005, "amount_tonnes": 0.01, "tx_hash": "0x...", "tx_url": "https://basescan.org/tx/0x..." }, "wind": { "status": "on_chain", "usd_paid": 0.005, "amount_tonnes": 0.01, "tx_hash": "0x...", "tx_url": "https://basescan.org/tx/0x..." } } } ], "ts": "2026-04-21T19:00:00.000Z" } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "address": { "type": "string" }, "sqft": { "type": "number" }, "budget": { "type": "number" }, "occupancy": { "type": "number" }, "selectedSDGs": { "type": "array" }, "solar_usd": { "type": "number" }, "wind_usd": { "type": "number" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "flagship" }, { "path": "/.well-known/vealth/klima2-retire", "method": "POST", "priceUsd": 0.15, "description": "Real on-chain Klima retirement via Klima Labs x402 — Bankr-signed single-step retire on Base. Lands on the canonical Carbonmark retirement page and returns a confirmed retire_tx + Basescan link. For the 4-leg agent bundle (SDG + Michelin + LBC + retire), call /build-eco-food-retire ($0.04) instead.", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "amount_tonnes": 0.001 } }, "output": { "type": "json", "example": { "ok": true, "version": "k2", "action": "retire", "amount_tonnes": 0.001, "retire_tx": "0x…", "basescan_url": "https://basescan.org/tx/0x…", "cost_usdc": 0.005 } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "amount_tonnes": { "type": "number" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "quiet" }, { "path": "/.well-known/vealth/lbc-building-scan", "method": "POST", "priceUsd": 0.01, "description": "Living Building Challenge feasibility scan — 7-petal scorecard", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "address": "123 Main St", "sqft": 50000, "budget": 5000000, "occupancy": 500 } }, "output": { "type": "json", "example": { "ok": true, "scorecard": { "address": "123 Main St", "petals": { "energy": 85, "water": 72, "materials": 68, "health": 79, "equity": 71, "beauty": 74, "culture": 81 } } } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "address": { "type": "string" }, "sqft": { "type": "number" }, "budget": { "type": "number" }, "occupancy": { "type": "number" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "flagship" }, { "path": "/.well-known/vealth/michelin-score", "method": "POST", "priceUsd": 0.005, "description": "Restaurant + hospital food sustainability score", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "name": "Le Bernardin", "cuisine": "fine_dining" } }, "output": { "type": "json", "example": { "name": "Restaurant Name", "city": "City", "score": 78, "tier": "one_star", "tierLabel": "One Star Range (★)", "greenStarEligible": true } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "name": { "type": "string" }, "cuisine": { "type": "string" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "flagship" }, { "path": "/.well-known/vealth/sdg-assessment", "method": "POST", "priceUsd": 0.02, "description": "Per-SDG site monitoring methodology generator (SSLMP v1.0)", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "orgName": "Org", "projectName": "Project", "selectedSDGs": [ "sdg6", "sdg7" ], "location": "USA" } }, "output": { "type": "json", "example": { "ok": true, "methodology": { "orgName": "Org", "projectName": "Project", "selectedSDGs": [ "sdg6", "sdg7" ] }, "pdfAvailable": true } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "orgName": { "type": "string" }, "projectName": { "type": "string" }, "selectedSDGs": { "type": "array" }, "location": { "type": "string" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "flagship" }, { "path": "/vealth/api/x402/michelin/score", "method": "POST", "priceUsd": 0.005, "description": "Michelin-standard restaurant/hospital food sustainability score", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "name": "Le Bernardin", "cuisine": "fine_dining" } }, "output": { "type": "json", "example": { "name": "Restaurant Name", "city": "City", "score": 78, "tier": "one_star", "tierLabel": "One Star Range (★)", "greenStarEligible": true } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "name": { "type": "string" }, "cuisine": { "type": "string" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "flagship" }, { "path": "/.well-known/vealth/agent-kit", "method": "POST", "priceUsd": 0.5, "description": "Agent Kit generator — POST {url}: starter agent.md + .well-known/agents.json + llms.txt skeletons filled from the site's own public signals.", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "url": "https://example.com" } }, "output": { "type": "json", "example": { "product": "agent-kit", "origin": "https://example.com", "kit": { "agent.md": "# Example — agent guide…", "llms.txt": "# example.com…" } } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "url": { "type": "string" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "quiet" }, { "path": "/.well-known/vealth/agent-readiness", "method": "POST", "priceUsd": 0.25, "description": "Agent-readiness teardown — POST {url}: deterministic public-signal scan (robots, llms.txt, agent manifests, openapi, structured data, sitemap) with a fix per gap. The engagement-playbook teardown as a self-serve call.", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "url": "https://example.com" } }, "output": { "type": "json", "example": { "product": "agent-readiness", "origin": "https://example.com", "score": 57, "findings": [ { "check": "llms.txt", "status": "warn", "detail": "No llms.txt.", "fix": "Publish /llms.txt." } ], "not_claimed": "A document scan of public signals at one moment." } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "url": { "type": "string" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "quiet" }, { "path": "/.well-known/vealth/agent-readiness-verify", "method": "POST", "priceUsd": 0.1, "description": "One call, one signed certificate: is this site discoverable and payable by autonomous agents? Verifies the A2A agent card (/.well-known/agent.json), the x402 payment manifest (/.well-known/x402), the llms.txt guide, and the AI-plugin manifest (/.well-known/ai-plugin.json).", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "target": "https://example.com" } }, "output": { "type": "json", "example": { "ok": true, "door": "agent-readiness-verify", "verdict": "PASS", "machine_checkable": true, "certificate": { "certificate_version": "verify-bundle-v1", "door": "agent-readiness-verify", "standards_summary": { "total": 4, "passed": 4, "failed": 0 }, "standards": [ { "standard": "a2a_agent_card", "verdict": "PASS" }, { "standard": "x402_discovery_manifest", "verdict": "PASS" }, { "standard": "llms_txt_convention", "verdict": "PASS" }, { "standard": "ai_plugin_manifest", "verdict": "PASS" } ] }, "certificate_sha256": "0x…", "signature": { "alg": "EIP-191 personal_sign (secp256k1) over certificate_sha256", "signer": "0x…", "sig": "0x…", "recheck": "ethers.utils.verifyMessage(certificate_sha256, sig) === signer" }, "signed": true } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "target": { "type": "string" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "quiet" }, { "path": "/.well-known/vealth/ai-retire-bundler", "method": "GET", "priceUsd": 0.001, "description": "AI-workload footprint quote (kWh + CO2e) plus a Regen Ledger retirement plan — for AI app builders who want a per-call ecological pass-through", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "input_tokens": 1500, "output_tokens": 600, "model": "claude-opus-4-7" } }, "output": { "type": "json", "example": { "footprint": { "kwh": 0.0042, "co2e_tonnes": 0.0000018 }, "retirement_plan": { "class_id": "C01", "credit_units": 0.0000018, "est_cost_usdc": 0.0001, "marketplace_url": "https://app.regen.network/credits/C01" } } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "input_tokens": { "type": "number" }, "output_tokens": { "type": "number" }, "model": { "type": "string" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "quiet" }, { "path": "/.well-known/vealth/bridge-route", "method": "POST", "priceUsd": 0.1, "description": "Chain-hop route quote for the axlREGEN Base→regen-1 corridor: live Axelar toll, gateway re-proof, and ABI-encoded calldata you sign and send from your own wallet. Read-only — we never touch your funds.", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "amount": 3000, "toAddress": "regen1…" } }, "output": { "type": "json", "example": { "ok": true, "corridor": "axlREGEN(base) -> REGEN(regen-ledger via axelar)", "economics": { "toll_regen_flat_live": 333.3, "lands_regen": 2666.7 }, "calldata": { "to": "0x…gateway", "data": "0x…", "value": "0", "note": "unsigned — the caller signs" }, "after_sending": { "the_confirm_gap": "Axelar GMP does not self-confirm; recovery is permissionless via axelarscan but needs a funded axelar1 account. Our first live send is still unconfirmed — prove confirm on dust first." } } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "amount": { "type": "number" }, "toAddress": { "type": "string" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "quiet" }, { "path": "/.well-known/vealth/carbon-retired", "method": "POST", "priceUsd": 0.02, "description": "Carbon Retired (data oracle) — POST {wallet | entity}: carbon retired with receipt references, from our VERIFIED on-chain retirement ledger. A recognized entity returns the verified rows (retired_count, total_tco2e, and per-row receipts with tx hash and source ledger); any other wallet gets an honest zero. Only literal verified on-chain rows are asserted — never an aggregate offset claim.", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "entity": "ecowealth" } }, "output": { "type": "json", "example": { "ok": true, "found": true, "oracle": "carbon-retired", "resolved_as": "ecowealth_bankr_retire_rail", "retired_count": 7, "total_tco2e": 5.02, "receipts": [ { "date": "2026-04-23", "endpoint": "build-eco-food-retire", "credit_class": "solar-pv-small-scale", "amount_tco2e": 0.01, "retire_tx_hash": "0x…", "retire_tx_url": "https://basescan.org/tx/0x…", "source_ledger": "data/x402/build-eco-food-retire-2026-04-23.jsonl" } ] } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "entity": { "type": "string" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "quiet" }, { "path": "/.well-known/vealth/cert-authenticate", "method": "POST", "priceUsd": 0.02, "description": "Cert Authenticate (the proof notary) — hand back any certificate we issued and we confirm it three ways: INTEGRITY (recompute the sha256 the signature must recover from, so any doctored field breaks it), AUTHENTICITY (the recovered signer must equal our PUBLISHED verifier address; a valid signature from another key is honestly reported NOT_ECOWEALTH, never called fake), and optional FRESHNESS (re-run a URL-mode certificate's public assertions live). Authenticity needs no network.", "authentication": "x402-eip3009", "tier": "quiet" }, { "path": "/.well-known/vealth/cross-verify", "method": "POST", "priceUsd": 0.1, "description": "EcoWealth as the neutral checker of ANOTHER protocol's public claim (curated allowlist, no-auth public endpoints only). Returns an honest CONFIRMED / NOT_FOUND / CANNOT_VERIFY signed certificate.", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "protocol": "litcoin", "claim_ref": "0x538aa4800ae2bd8e90556899514376ab96113a8e" } }, "output": { "type": "json", "example": { "ok": true, "verdict": "CONFIRMED", "neutral_check": true, "protocol": "litcoin", "certificate": { "certificate_version": "cross-verify-v1", "verdict": "CONFIRMED", "protocol": { "key": "litcoin", "label": "Litcoin (proof-of-comprehension / research mining on Base)" }, "claim_ref": "0x538aa4800ae2bd8e90556899514376ab96113a8e", "checked_endpoint": "https://api.litcoin.app/v1/claims/status?wallet=0x538aa4800ae2bd8e90556899514376ab96113a8e", "evidence": { "http_status": 200, "wallet": "0x538aa4800ae2bd8e90556899514376ab96113a8e", "claimable": "…" } }, "certificate_sha256": "0x…", "signature": { "alg": "EIP-191 personal_sign (secp256k1) over certificate_sha256", "signer": "0x…", "sig": "0x…", "recheck": "ethers.utils.verifyMessage(certificate_sha256, sig) === signer" }, "signed": true } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "protocol": { "type": "string" }, "claim_ref": { "type": "string" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "quiet" }, { "path": "/.well-known/vealth/ewp-adoption-sim", "method": "POST", "priceUsd": 0.5, "description": "EWP adoption simulator — POST {url, workforce?}: your company's simulated ecological work program: ladder placement from your own site, real open packets from the live board in your sector, and a 90-day arithmetic simulation. Labeled simulation; no affiliation implied; carbon never projected.", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "url": "https://example.com", "workforce": 500 } }, "output": { "type": "json", "example": { "product": "ewp-adoption-sim", "placement": { "ladder": "Restore (toward the UN SDGs)" }, "simulated_first_90_days": { "day_90_totals": { "packets_completed": 171, "wages_flowed_usd": 116280 } } } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "url": { "type": "string" }, "workforce": { "type": "number" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "quiet" }, { "path": "/.well-known/vealth/health-packet", "method": "POST", "priceUsd": 0.05, "description": "Health Work Packet Builder — same engine over the 37-def health library (12-Hallmarks-tagged). Non-medical measurement packets; findings route to a licensed clinician", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "problem": "measure resting heart rate and blood pressure for a community screening" } }, "output": { "type": "json", "example": { "ok": true, "packet": { "definitionId": "resting-vitals-screen-v1", "method": "standards-registered method template", "proof_requirements": [ "reading", "timestamp" ], "funding_path": "POST /labor ($0.05 x402 write lane — no key)", "boundary": "non-medical measurement; route findings to a licensed clinician" }, "artifact_sha256": "0x…" } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "problem": { "type": "string" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "flagship" }, { "path": "/.well-known/vealth/intent-compile", "method": "POST", "priceUsd": 0.1, "description": "The Ecological Intent Compiler: POST your intent (what ecological outcome, where) and get a compiled work-packet PROPOSAL — scope, method, standards ladder (LBC/Michelin/SDG), tCO2e, and a visible premium wage. Constitutionally an Attestation, never an admitted obligation. Free preview at /intent-compile/preview.", "authentication": "x402-eip3009", "tier": "flagship" }, { "path": "/.well-known/vealth/intent-market", "method": "POST", "priceUsd": 0.05, "description": "Compile AND list: your ecological intent becomes a public, priced, fundable open intent on the intents board (free read at /intents). Listing is representation, not consequence — funding + the canonical posting rail create the obligation.", "authentication": "x402-eip3009", "tier": "quiet" }, { "path": "/.well-known/vealth/method-template", "method": "POST", "priceUsd": 0.02, "description": "Method Template Packet — canonical execution method for any registered standard: reference method, equipment, imperative steps, measurable acceptance criteria, decision rules, plus which definitions inherit it", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "standard": "EPA-180.1" } }, "output": { "type": "json", "example": { "method": { "reference_method": "EPA 180.1", "equipment": [ "turbidimeter" ], "steps": [ "…" ], "acceptance_criteria": [ "±5%" ], "decision_rules": [ "…" ] }, "used_by": { "count": 6, "price_usd": { "min": 0.02, "median": 0.05, "max": 0.1 } } } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "standard": { "type": "string" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "quiet" }, { "path": "/.well-known/vealth/michelin-gap-analyzer", "method": "POST", "priceUsd": 0.006, "description": "Per-criterion gap analysis vs the Michelin Green Star rubric — delta-to-threshold per criterion, action items with cost-to-close ranges, staged upgrade roadmap", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "venueName": "Le Bernardin", "cuisine": "fine_dining", "coversPerDay": 120, "budgetUsd": 40000, "seasonal": true, "sustainableSeafood": true } }, "output": { "type": "json", "example": { "current": { "score": 64, "tier": "bib_gourmand", "green_star_eligible": false }, "gaps": [ { "criterion": "Sustainability & Green Star", "current": 5, "threshold": 10, "delta_to_threshold": 5 } ], "roadmap": [ { "stage": 1, "actions": [ { "flag": "supplierTransparency", "description": "Publish a public supplier directory", "cost_high_usd": 1500 } ], "forecast_score": 70, "green_star_eligible_after": false } ], "forecast": { "max_reachable_score": 91, "max_reachable_tier": "star_candidate", "green_star_reachable": true } } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "venueName": { "type": "string" }, "cuisine": { "type": "string" }, "coversPerDay": { "type": "number" }, "budgetUsd": { "type": "number" }, "seasonal": { "type": "boolean" }, "sustainableSeafood": { "type": "boolean" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "quiet" }, { "path": "/.well-known/vealth/nrel-solar-yield-batch", "method": "POST", "priceUsd": 0.015, "description": "Batch solar yield + avoided-CO2e + Regen C01 credit valuation for 1-10 candidate rooftop sites. Pre-screen for solar credit issuance pipelines", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "sites": [ { "name": "Site A", "location": "Phoenix, AZ", "rooftopKw": 100 }, { "name": "Site B", "location": "Seattle, WA", "rooftopKw": 100 } ] } }, "output": { "type": "json", "example": { "site_count": 2, "c01_floor_usd_per_tonne": 15, "results": [ { "name": "Site A", "state_resolved": "AZ", "capacity_factor": 0.26, "annual_kwh": 227760, "avoided_co2e_tonnes_per_year": 86.55, "c01_value_usd_per_year": 1298.25 }, { "name": "Site B", "state_resolved": "WA", "capacity_factor": 0.13, "annual_kwh": 113880, "avoided_co2e_tonnes_per_year": 12.53, "c01_value_usd_per_year": 187.95 } ], "totals": { "annual_kwh": 341640, "avoided_co2e_tonnes_per_year": 99.08, "c01_value_usd_per_year": 1486.2 } } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "sites": { "type": "array" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "quiet" }, { "path": "/.well-known/vealth/packet-compile", "method": "POST", "priceUsd": 0.05, "description": "Packet Compile (author a portable, signed self-verifying packet) — you send structured acceptance criteria (paths plus expected status / content-type / body / min_bytes over invited machine surfaces); we return a valid, SSRF-safe, portable self-verifying packet in our vocabulary — the same shape our own board consumes — SIGNED so anyone can recover our authoring key, and optionally proven once against a live https host.", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "name": "Publish a security.txt", "standard": "rfc_9116_security_txt", "checks": [ { "path": "/.well-known/security.txt", "assert": { "status": 200, "body_contains": "Contact:", "min_bytes": 20 } } ], "dry_run_target": "https://example.com" } }, "output": { "type": "json", "example": { "ok": true, "certificate_version": "packet-compile-v1", "machine_checkable": true, "packet": { "id": "compiled-…", "vector": "self_contained_worker_target", "verification": { "kind": "http_probe", "pass_rule": "all", "checks": [ { "id": "check-1", "method": "GET", "url": "{{target}}/.well-known/security.txt", "assert": { "status": 200, "body_contains": "Contact:", "min_bytes": 20 } } ] } }, "packet_sha256": "…", "signature": { "alg": "EIP-191 personal_sign (secp256k1) over certificate_sha256", "signer": "0x…", "sig": "0x…", "recheck": "ethers.utils.verifyMessage(packet_sha256, sig) === signer" }, "dry_run": { "ran": true, "target": "https://example.com", "verdict": "FAIL" }, "signed": true } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "name": { "type": "string" }, "standard": { "type": "string" }, "checks": { "type": "array" }, "dry_run_target": { "type": "string" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "quiet" }, { "path": "/.well-known/vealth/provisioning-package", "method": "POST", "priceUsd": 5, "description": "Full provisioning package — POST {url}: agent-readiness teardown + x402-readiness verdict + Agent Kit + prioritized fix plan in one self-serve artifact.", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "url": "https://example.com" } }, "output": { "type": "json", "example": { "product": "provisioning-package", "origin": "https://example.com", "fix_plan": [ { "priority": 1, "area": "x-payment-info", "do": "Declare machine-readable pricing per paid operation." } ] } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "url": { "type": "string" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "quiet" }, { "path": "/.well-known/vealth/regen-class-momentum", "method": "GET", "priceUsd": 0.006, "description": "24h time-series momentum for any Regen credit class — sell-order liquidity, retirement velocity vs prior 6-day daily average, USDC floor", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "class_id": "C01" } }, "output": { "type": "json", "example": { "class_id": "C01", "fetched_at": "2026-04-25T18:00:00.000Z", "liquidity": { "active_orders": 6, "total_quantity": 124.5, "floor_price_usd": 12.4 }, "retirements": { "last_24h": { "count": 3, "total_tonnes": 18 }, "prior_6d_daily_avg": 1.5, "velocity_z": 1 }, "momentum": { "score": 1, "label": "strong_up", "components": { "retirement_velocity_weight": 0.7, "liquidity_baseline_weight": 0.3 } }, "spec_version": "RCM-v0", "scorer_version": "1.0.0" } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "class_id": { "type": "string" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "quiet" }, { "path": "/.well-known/vealth/regen-methodology-draft", "method": "POST", "priceUsd": 0.5, "description": "AI-drafted 10-section Regen Network methodology RFC scaffold (PR #107 graduation lane). Schema deterministic, prose LLM-generated. Human review required", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "project_description": "Mangrove restoration in Mozambique, ~150 ha, blue carbon focus" } }, "output": { "type": "json", "example": { "rfc_markdown": "# Mozambique Mangrove Blue Carbon Methodology\n\n## 1. Scope\n...", "sections": 10, "word_count": 4200, "ready_for_submission": false, "missing_sections": [] } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "project_description": { "type": "string" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "quiet" }, { "path": "/.well-known/vealth/regen-reputation", "method": "GET", "priceUsd": 0.005, "description": "Regen Network reputation score (M010 SPEC §5.3) for credit classes / projects / sellers — on-chain Regen Ledger signals only", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "target_type": "class", "target_id": "C01" } }, "output": { "type": "json", "example": { "target_type": "class", "target_id": "C01", "score": 612, "breakdown": { "liquidity": 180, "retirement_activity": 140, "methodology_depth": 120, "age": 90, "adoption": 82 }, "spec_version": "M010-v0", "scorer_version": "1.1.0" } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "target_type": { "type": "string" }, "target_id": { "type": "string" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "quiet" }, { "path": "/.well-known/vealth/regen-retirement-builder", "method": "POST", "priceUsd": 0.02, "description": "Multi-order retirement planner — fills a target tonnage at minimum cost across IBC-USDC-priced Regen Ledger sell orders, returns blended line list + total", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "target_tonnes": 10, "max_budget_usd": 150, "min_vintage": 2020 } }, "output": { "type": "json", "example": { "lines": [ { "order_id": "1234", "class_id": "C01", "tonnes": 6.5, "usd": 87.75, "marketplace_url": "https://app.regen.network/storefront/1234" }, { "order_id": "1289", "class_id": "C02", "tonnes": 3.5, "usd": 56, "marketplace_url": "https://app.regen.network/storefront/1289" } ], "total_tonnes": 10, "total_usd": 143.75, "avg_per_credit": 14.375 } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "target_tonnes": { "type": "number" }, "max_budget_usd": { "type": "number" }, "min_vintage": { "type": "number" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "quiet" }, { "path": "/.well-known/vealth/regen-rfc-reviewer", "method": "POST", "priceUsd": 0.1, "description": "Structural audit + LLM substantive pass for a Regen RFC. Section presence and citation completeness deterministic; rigour scores LLM-graded", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "rfc_markdown": "# Methodology Title\n\n## 1. Scope\n..." } }, "output": { "type": "json", "example": { "sections_pass": 8, "sections_fail": 2, "ready_to_submit": false, "gaps": [ "Section 4: Baseline missing additionality argument", "Section 7: MRV cadence not specified" ], "rigour": 0.72, "specificity": 0.81, "defensibility": 0.65 } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "rfc_markdown": { "type": "string" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "quiet" }, { "path": "/.well-known/vealth/retire-attach", "method": "POST", "priceUsd": 0.25, "description": "Retirement-as-a-service — one $0.25 payment executes a real on-chain Klima retirement on Base attributed to YOUR beneficiary_address (required). Returns retire_tx + your own Carbonmark retirements URL. Default class Regen-CFC (fractional), hard-capped per call. Built for retire-on-action bots that want execution + receipts without signing/slippage/beneficiary plumbing.", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "beneficiary_address": "0xYourAddress", "amount_tonnes": 0.005 } }, "output": { "type": "json", "example": { "ok": true, "version": "retire-attach-v1", "amount_tonnes": 0.005, "beneficiary_address": "0xYourAddress", "carbonmark_retirements_url": "https://www.carbonmark.com/retirements/…", "retire_tx": "0x…", "basescan_url": "https://basescan.org/tx/0x…", "cost_usdc": 0.15 } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "beneficiary_address": { "type": "string" }, "amount_tonnes": { "type": "number" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "quiet" }, { "path": "/.well-known/vealth/settle-on-proof", "method": "POST", "priceUsd": 0.05, "description": "Escrow release oracle: we run the verification and sign a RELEASE or HOLD attestation your escrow consumes. We never hold your funds. Default-deny — anything we cannot verify is HELD, never released.", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "work_ref": "escrow-deal-42", "standard": "rfc_9116_security_txt", "target": "https://example.com" } }, "output": { "type": "json", "example": { "ok": true, "verdict": "RELEASE", "release": true, "no_custody": true, "work_ref": "escrow-deal-42", "attestation": { "attestation_version": "settle-on-proof-v1", "audience": "vealth.settle-on-proof.v1", "verdict": "RELEASE", "verdict_code": 1, "work_ref": "escrow-deal-42", "expires_at_unix": 1735693200, "verifier": "vealth.net/settle-on-proof" }, "attestation_sha256": "0x…", "signature": { "alg": "EIP-191 personal_sign (secp256k1) over keccak256(abi.encodePacked(audience, keccak256(work_ref), verdict_code, issued_at, expires_at, verifier))", "signer": "0x…", "sig": "0x…", "release_digest": "0x…", "recover_onchain": "ECDSA.recover(ECDSA.toEthSignedMessageHash(release_digest), sig) == signer" }, "signed": true, "escrow_note": "Vealth holds no funds. Your escrow releases its OWN funds only on verdict == RELEASE from your configured oracle." } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "work_ref": { "type": "string" }, "standard": { "type": "string" }, "target": { "type": "string" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "quiet" }, { "path": "/.well-known/vealth/settlement-attest", "method": "POST", "priceUsd": 0.01, "description": "EWP Settlement Attestor — verifies a Base Sepolia tx succeeded, touches the EWP contract, and has confirmations; returns an attestation document with a citable sha256 hash and explorer link", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "txHash": "0x…" } }, "output": { "type": "json", "example": { "verified": true, "attestation": { "tx_status": 1, "contract_log_count": 1, "block": 12345678, "confirmations": 12 }, "artifact_sha256": "0x…", "explorer": "https://basescan.org/tx/0x…" } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "txHash": { "type": "string" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "quiet" }, { "path": "/.well-known/vealth/site-integrity-verify", "method": "POST", "priceUsd": 0.15, "description": "The machine-readable integrity posture of a site in one signed certificate: a robots.txt that names its sitemap (RFC 9309), a valid XML sitemap (sitemaps.org 0.9), an RFC 9116 security.txt with a Contact and Expires, and an MTA-STS policy (RFC 8461) for email transport security.", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "target": "https://example.com" } }, "output": { "type": "json", "example": { "ok": true, "door": "site-integrity-verify", "verdict": "FAIL", "machine_checkable": true, "certificate": { "certificate_version": "verify-bundle-v1", "door": "site-integrity-verify", "standards_summary": { "total": 4, "passed": 3, "failed": 1 }, "standards": [ { "standard": "rfc_9309_robots", "verdict": "PASS" }, { "standard": "sitemaps_org_0_9", "verdict": "PASS" }, { "standard": "rfc_9116_security_txt", "verdict": "PASS" }, { "standard": "mta_sts_policy", "verdict": "FAIL", "reason": "assertion \"mta-sts-served\" failed: status 404, expected 200" } ] }, "certificate_sha256": "0x…", "signature": { "alg": "EIP-191 personal_sign (secp256k1) over certificate_sha256", "signer": "0x…", "sig": "0x…", "recheck": "ethers.utils.verifyMessage(certificate_sha256, sig) === signer" }, "signed": true } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "target": { "type": "string" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "quiet" }, { "path": "/.well-known/vealth/site-sweep", "method": "POST", "priceUsd": 10, "description": "Site sweep — POST {url}: walk up to 60 pages as a visitor (status, title, description, index posture, placeholder leaks). Deterministic, reproducible, bounds stated.", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "url": "https://example.com" } }, "output": { "type": "json", "example": { "product": "site-sweep", "origin": "https://example.com", "pages_walked": 42, "summary": { "clean": 37, "with_issues": 4, "broken": 1 } } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "url": { "type": "string" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "quiet" }, { "path": "/.well-known/vealth/standards-classifier", "method": "POST", "priceUsd": 0.01, "description": "Standards Classifier (data oracle) — POST {activity | work_type | standard}: which of the three crafts a piece of work belongs to (LBC Build / Michelin Grow & Cook / SDG Restore), plus the real standard reference, read from our standards registry across the work-definition libraries. Returns resolved_standard, standard_reference, and the matched frameworks.", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "work_type": "led_lighting_retrofit" } }, "output": { "type": "json", "example": { "ok": true, "found": true, "oracle": "standards-classifier", "resolved_standard": "energy_efficiency", "standard_reference": "ASHRAE Level 1 audit; LBC Energy petal screening", "frameworks": [ { "framework": "LBC", "detail": "Energy Petal" } ], "craft_classifier": { "craft_letter": "b", "sector": "Building & Renovation", "ladder": "LBC (Build)" }, "basis": "work_type" } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "work_type": { "type": "string" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "quiet" }, { "path": "/.well-known/vealth/starter-pack", "method": "POST", "priceUsd": 1, "description": "Ecological Wealth Starter Pack v1 — complete educational artifact bundle. One $1.00 USDC payment returns structured JSON with HTML/PDF/markdown URLs, three lenses (LBC/Michelin/SDG), three first moves, four-rung upgrade ladder, disclaimers, and an x402_paid_artifact receipt. New $1 tier (2026-05-13) above the per-scorer band: the complete artifact is the product", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": {} }, "output": { "type": "json", "example": { "product": "Ecological Wealth Starter Pack", "version": "v1", "price_usd": 1, "currency": "USDC", "network": "base", "artifact_html_url": "https://vealth.net/vealth/starter-pack.html", "artifact_pdf_url": "https://vealth.net/vealth/starter-pack-v1.pdf", "canonical_source_url": "https://vealth.net/vealth/starter-pack-v1.md", "certificate": { "type": "certificate_of_authenticity", "product": "Ecological Wealth Starter Pack", "version": "v1", "issuer": "EcoWealth · Vealth operator surface", "issuer_wallet": "0x538aa4800ae2bd8e90556899514376ab96113a8e", "network": "base", "chain_id": 8453, "authenticity_statement": "This certifies that the named artifact is the version-pinned, canonical Ecological Wealth Starter Pack v1 issued by EcoWealth, addressable at the URLs above. The canonical markdown is the source of truth; the HTML and PDF derive from it. The issuer wallet on Base is the canonical settlement address for any paid call to the x402 endpoint.", "boundary_statement": "This certificate does NOT certify ecological outcomes, savings, or physical execution. It certifies the artifact only — its identity, its canonical address, and its issuance metadata." }, "receipt": { "type": "x402_paid_artifact", "payment": "x402 EIP-3009 USDC on Base", "product": "Ecological Wealth Starter Pack", "version": "v1", "price_usd": 1, "currency": "USDC", "network": "base", "recipient": "0x538aa4800ae2bd8e90556899514376ab96113a8e" } } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": {} } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "flagship" }, { "path": "/.well-known/vealth/sustainability-disclosure-verify", "method": "POST", "priceUsd": 0.05, "description": "Does a published climate/sustainability disclosure actually parse as machine-readable data? Verifies the hosting climate disclosure (/.well-known/carbon.txt) and a schema.org JSON-LD sustainability page (/sustainability.html). Cheap enough for directory-scale re-checking.", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "target": "https://example.com" } }, "output": { "type": "json", "example": { "ok": true, "door": "sustainability-disclosure-verify", "verdict": "PASS", "machine_checkable": true, "certificate": { "certificate_version": "verify-bundle-v1", "door": "sustainability-disclosure-verify", "standards_summary": { "total": 2, "passed": 2, "failed": 0 }, "standards": [ { "standard": "green_web_carbon_txt", "verdict": "PASS" }, { "standard": "schema_org_sustainability", "verdict": "PASS" } ] }, "certificate_sha256": "0x…", "signature": { "alg": "EIP-191 personal_sign (secp256k1) over certificate_sha256", "signer": "0x…", "sig": "0x…", "recheck": "ethers.utils.verifyMessage(certificate_sha256, sig) === signer" }, "signed": true } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "target": { "type": "string" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "quiet" }, { "path": "/.well-known/vealth/swarm-strategy", "method": "POST", "priceUsd": 0.25, "description": "Swarm strategy packet — POST {lat?, lng?, wallet?} (all optional): an arriving agent's ordered plan from idle to earning with receipts. Live Litcoin mining arithmetic with dust stated as dust, the open guild seat and its every-member-boosts-every-member mechanics, real matching rows from the live work board. Live-read or arithmetic, never a forecast.", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "lat": 37.8, "lng": -122.27 } }, "output": { "type": "json", "example": { "product": "swarm-strategy", "motions_to_first_receipt": 4, "litcoin_mining_now": { "reachable": true, "plain_truth": "at current LIT prices this is dust — mine for the identity, the receipts, and the guild boost, not the income" } } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "lat": { "type": "number" }, "lng": { "type": "number" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "quiet" }, { "path": "/.well-known/vealth/tco2e-oracle", "method": "POST", "priceUsd": 0.01, "description": "tCO2e Oracle (data oracle) — POST {work_type, place?, count?}: the carbon value AND its basis for a piece of work, read from our production settle-to-retire mapping (exact library pin / lane default / keyword match / unknown). Returns tco2e_per_unit, the retirement lane, and the basis so you know how firm the number is. Honest found:false when we have no basis, never a fabricated value.", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "work_type": "tree_planting", "place": "Austin, TX", "count": 10 } }, "output": { "type": "json", "example": { "ok": true, "found": true, "oracle": "tco2e-oracle", "work_type": "tree_planting", "lane": "ecosystem_stewardship", "basis": "exact", "tco2e_per_unit": 0.02, "count": 10, "tco2e_total": 0.2 } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "work_type": { "type": "string" }, "place": { "type": "string" }, "count": { "type": "number" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "quiet" }, { "path": "/.well-known/vealth/verifiable-work-match", "method": "POST", "priceUsd": 0.03, "description": "Verifiable Work Match (route an agent to work it can PROVE) — state which machine-checkable standards you can satisfy (plus optional skillLevel / lane) and we return claimable self-verifying work from our library you can both DO and PROVE with no human review: each with its executable definition of done, its three-craft alignment, its tCO2e, and the path to claim it.", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "capabilities": [ "rfc_9116_security_txt", "llms_txt_convention" ], "skillLevel": "entry", "limit": 5 } }, "output": { "type": "json", "example": { "ok": true, "response_version": "verifiable-work-match-v1", "machine_checkable": true, "match_count": 2, "returned": 2, "matches": [ { "id": "selfverify-security-txt-…", "title": "Publish a security.txt …", "standard": "rfc_9116_security_txt", "skill_level": "entry", "tco2e": 0, "standards_alignment": { "sdg": [ "16.10" ], "lbc": "…", "michelin": "n/a" }, "definition_of_done": { "kind": "http_probe", "pass_rule": "all", "checks": [ { "id": "…", "method": "GET", "url": "{{target}}/.well-known/security.txt", "assert": { "status": 200 } } ] } } ], "supported_capabilities": [ "a2a_agent_card", "…" ], "honest_empty": false } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "capabilities": { "type": "array" }, "skillLevel": { "type": "string" }, "limit": { "type": "number" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "quiet" }, { "path": "/.well-known/vealth/verify-badge", "method": "POST", "priceUsd": 0.05, "description": "Mint a signed certificate plus an embeddable, self-contained badge (SVG/HTML) that links to a FREE live re-check. Minting is paid; re-checking is always free.", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "standard": "rfc_9116_security_txt", "target": "https://example.com" } }, "output": { "type": "json", "example": { "ok": true, "verdict": "PASS", "machine_checkable": true, "certificate": { "certificate_version": "verify-badge-v1", "verdict": "PASS", "recheck": { "free": true, "svg": "https://vealth.net/.well-known/vealth/verify-badge/recheck?standard=rfc_9116_security_txt&target=https://example.com&format=svg" } }, "certificate_sha256": "0x…", "signature": { "alg": "EIP-191 personal_sign (secp256k1) over certificate_sha256", "signer": "0x…", "sig": "0x…", "recheck": "ethers.utils.verifyMessage(certificate_sha256, sig) === signer" }, "signed": true, "badge": { "svg": "Verified by EcoWealth | PASS", "html": "\"Verified", "recheck_svg_url": "https://vealth.net/.well-known/vealth/verify-badge/recheck?standard=rfc_9116_security_txt&target=https://example.com&format=svg" } } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "standard": { "type": "string" }, "target": { "type": "string" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "quiet" }, { "path": "/.well-known/vealth/verify-claim", "method": "POST", "priceUsd": 0.1, "description": "Verify one claim against a standard and get back a SIGNED, re-checkable certificate anyone can reproduce — no oracle, no judge. Digital claims only; a physical claim returns ROUTES_TO_HUMAN_REVIEW rather than a guess. Hostile targets are refused free before any fetch.", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "standard": "rfc_9116_security_txt", "target": "https://example.com" } }, "output": { "type": "json", "example": { "ok": true, "verdict": "PASS", "machine_checkable": true, "certificate": { "certificate_version": "verify-claim-v1", "standard": { "key": "rfc_9116_security_txt", "reference": "RFC 9116", "definition_id": "selfverify-security-txt-01" }, "assertions_ran": [ { "check_id": "security-txt-served", "method": "GET", "url": "https://example.com/.well-known/security.txt", "passed": true } ] }, "certificate_sha256": "0x…", "signature": { "alg": "EIP-191 personal_sign (secp256k1) over certificate_sha256", "signer": "0x…", "sig": "0x…", "recheck": "ethers.utils.verifyMessage(certificate_sha256, sig) === signer" }, "signed": true } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "standard": { "type": "string" }, "target": { "type": "string" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "quiet" }, { "path": "/.well-known/vealth/verify-subscription", "method": "POST", "priceUsd": 2, "description": "One monthly payment mints a time-boxed pass that waives the per-call fee on every verify door. If no stable signing secret is configured the door refuses to sell rather than mint a pass a restart would invalidate.", "authentication": "x402-eip3009", "tier": "quiet" }, { "path": "/.well-known/vealth/wallet-reputation", "method": "POST", "priceUsd": 0.02, "description": "Wallet Reputation (data oracle) — POST {wallet}: a wallet's VERIFIED work track record from our settlement stores, the same data /labor/worker/:wallet/record exposes: settled_work_count, verified_work_count, earned_usd, avg_quality_score, tier, last_work_date. Verified settlements only; honest zero when the wallet has no record.", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "wallet": "0x2222222222222222222222222222222222222222" } }, "output": { "type": "json", "example": { "ok": true, "found": true, "oracle": "wallet-reputation", "wallet": "0x2222…2222", "reputation": { "settled_work_count": 1, "verified_work_count": 1, "earned_usd": 85, "avg_quality_score": 96, "quality_source": "settlement_quality_scores", "tier": "intermediate", "qualified_for": [ "water_potability_test", "soil_sampling" ] }, "verify_url": "https://vealth.net/labor/worker/0x2222…2222/record" } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "wallet": { "type": "string" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "quiet" }, { "path": "/.well-known/vealth/work-near", "method": "POST", "priceUsd": 0.02, "description": "Work Near (data oracle) — POST {lat, lng, radiusKm?, limit?}: the real OPEN ecological jobs near a point on our live board (the same geo set /labor/work/advanced-search paginates), as compact rows with workId, title, standard, price_usd, skillLevel, distance_km and ready-to-use claim URLs. Honest found:false, count:0 when nothing is near.", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "lat": 34.05, "lng": -118.24, "radiusKm": 25 } }, "output": { "type": "json", "example": { "ok": true, "found": true, "oracle": "work-near", "count": 1, "works": [ { "workId": "w_123", "title": "Spring potability test near LA", "workType": "water_potability_test", "standard": "who_gdwq", "price_usd": 85, "skillLevel": "entry", "distance_km": 0.3, "claimUrl": "https://vealth.net/labor/claim" } ] } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "lat": { "type": "number" }, "lng": { "type": "number" }, "radiusKm": { "type": "number" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "quiet" }, { "path": "/.well-known/vealth/work-packet", "method": "POST", "priceUsd": 0.1, "description": "Work Packet Builder — place + problem in, bounded ecological work packet out: matched definition from the 163-def library, standards-registered method, proof requirements, tCO2e estimate, funding path and on-chain settlement path", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "problem": "storm drain outfall needs a monthly turbidity + pH reading", "lat": 34.05, "lng": -118.24 } }, "output": { "type": "json", "example": { "ok": true, "packet": { "definitionId": "water-quality-grab-sample-v1", "method": "standards-registered method template", "proof_requirements": [ "photo+GPS", "meter reading", "signature" ], "tco2e_estimate": 0, "funding_path": "POST /labor ($0.05 x402 write lane — no key)", "settlement_path": "on-chain EWP settlement on Base" }, "alternates": [], "artifact_sha256": "0x…" } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "problem": { "type": "string" }, "lat": { "type": "number" }, "lng": { "type": "number" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "flagship" }, { "path": "/.well-known/vealth/work-proof-check", "method": "POST", "priceUsd": 0.01, "description": "Work Proof Checker — deterministic COMPLETENESS verdict for a proof bundle (photos, GPS, readings, notes) against a definition's registered proof requirements, with GPS bounds vs the work-site radius and a citable sha256 artifact that binds the checked evidence. Structural check only — authenticity is judged at approval", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "definitionId": "water-quality-grab-sample-v1", "proof": { "gps": { "lat": 34.05, "lng": -118.24 }, "readings": { "turbidity": 3.1 } } } }, "output": { "type": "json", "example": { "verdict": "incomplete", "missing": [ "photo+GPS", "signature" ], "location_check": "in_bounds", "artifact_sha256": "0x…" } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "definitionId": { "type": "string" }, "proof": { "type": "object" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "quiet" }, { "path": "/.well-known/vealth/work-tco2e", "method": "POST", "priceUsd": 0.005, "description": "Work tCO2e Mapper — maps any library work type to its tCO2e estimate and retirement lane (the same mapping the settle-to-retire trigger uses), scaled by count, with the recommended Klima rail", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "workType": "native-tree-planting", "count": 100 } }, "output": { "type": "json", "example": { "lane": "reforestation", "basis": "exact", "tco2e_per_unit": 0.02, "tco2e_total": 2, "retirement": "Klima rail — settle when threshold crosses" } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "workType": { "type": "string" }, "count": { "type": "number" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "quiet" }, { "path": "/.well-known/vealth/x402-fix", "method": "POST", "priceUsd": 1, "description": "x402 fix generator — POST {url}: your openapi.json and .well-known/x402 corrected to the registry-validator shapes. Deterministic transformation of your own documents; prices never invented.", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "url": "https://example.com" } }, "output": { "type": "json", "example": { "product": "x402-fix", "origin": "https://example.com", "changes_applied": [ "POST /api/tool: protocols \"x402\" (string) -> {\"x402\": {}}" ], "todos": [], "install_note": "Serve fixed_openapi at /openapi.json…" } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "url": { "type": "string" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "quiet" }, { "path": "/.well-known/vealth/x402-readiness", "method": "POST", "priceUsd": 0.1, "description": "x402-readiness check — POST {url}: does the origin's payment surface parse as PAID and DISCOVERABLE to the x402 registries? Static validation only; none of the target's endpoints are called.", "inputSchema": { "info": { "input": { "type": "http", "method": "POST", "bodyType": "json", "body": { "url": "https://example.com" } }, "output": { "type": "json", "example": { "product": "x402-readiness", "origin": "https://example.com", "verdict": "NOT DISCOVERABLE — an x402 registry reading this origin today would index nothing.", "findings": [ { "check": "x-payment-info", "status": "fail", "detail": "23 operation(s), none declare x-payment-info." } ] } } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "input": { "type": "object", "properties": { "type": { "type": "string", "const": "http" }, "method": { "type": "string", "enum": [ "POST", "PUT", "PATCH" ] }, "bodyType": { "type": "string", "enum": [ "json", "form-data", "text" ] }, "body": { "properties": { "url": { "type": "string" } } } }, "required": [ "type", "method", "bodyType", "body" ], "additionalProperties": false }, "output": { "type": "object", "properties": { "type": { "type": "string" }, "example": { "type": "object" } }, "required": [ "type" ] } }, "required": [ "input" ] } }, "authentication": "x402-eip3009", "tier": "quiet" } ], "lastUpdated": "2026-08-18T21:21:51.823Z", "supportedAuthMethods": [ "x402-eip3009", "api-key" ] }