x402-trust-layer 5.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (293) hide show
  1. package/CHANGELOG.md +55 -0
  2. package/DEPLOY.md +53 -0
  3. package/Dockerfile +30 -0
  4. package/LICENSE +21 -0
  5. package/README.md +294 -0
  6. package/dist/agents/a2a-payment.d.ts +37 -0
  7. package/dist/agents/a2a-payment.js +105 -0
  8. package/dist/agents/agent-escrow.d.ts +30 -0
  9. package/dist/agents/agent-escrow.js +23 -0
  10. package/dist/agents/agent-verify.d.ts +15 -0
  11. package/dist/agents/agent-verify.js +112 -0
  12. package/dist/agents/api-router.d.ts +32 -0
  13. package/dist/agents/api-router.js +228 -0
  14. package/dist/agents/attestation-registry.d.ts +35 -0
  15. package/dist/agents/attestation-registry.js +76 -0
  16. package/dist/agents/audition-coach.d.ts +45 -0
  17. package/dist/agents/audition-coach.js +257 -0
  18. package/dist/agents/bedrock-bridge.d.ts +3 -0
  19. package/dist/agents/bedrock-bridge.js +60 -0
  20. package/dist/agents/budget-allocator.d.ts +24 -0
  21. package/dist/agents/budget-allocator.js +31 -0
  22. package/dist/agents/compliance-ledger.d.ts +66 -0
  23. package/dist/agents/compliance-ledger.js +80 -0
  24. package/dist/agents/dispute-resolver.d.ts +62 -0
  25. package/dist/agents/dispute-resolver.js +124 -0
  26. package/dist/agents/evidence-locker.d.ts +30 -0
  27. package/dist/agents/evidence-locker.js +47 -0
  28. package/dist/agents/facilitator-failover.d.ts +15 -0
  29. package/dist/agents/facilitator-failover.js +18 -0
  30. package/dist/agents/identity-gate.d.ts +20 -0
  31. package/dist/agents/identity-gate.js +79 -0
  32. package/dist/agents/mandate-compiler.d.ts +51 -0
  33. package/dist/agents/mandate-compiler.js +73 -0
  34. package/dist/agents/mandate-diff.d.ts +41 -0
  35. package/dist/agents/mandate-diff.js +170 -0
  36. package/dist/agents/market-buy-advisor.d.ts +65 -0
  37. package/dist/agents/market-buy-advisor.js +234 -0
  38. package/dist/agents/merchant-trust.d.ts +38 -0
  39. package/dist/agents/merchant-trust.js +171 -0
  40. package/dist/agents/mpp-session-broker.d.ts +27 -0
  41. package/dist/agents/mpp-session-broker.js +29 -0
  42. package/dist/agents/mpp-session-v2.d.ts +76 -0
  43. package/dist/agents/mpp-session-v2.js +269 -0
  44. package/dist/agents/payment-intent-compiler.d.ts +21 -0
  45. package/dist/agents/payment-intent-compiler.js +45 -0
  46. package/dist/agents/pipeline-execute.d.ts +40 -0
  47. package/dist/agents/pipeline-execute.js +100 -0
  48. package/dist/agents/pipeline-trust-v2.d.ts +31 -0
  49. package/dist/agents/pipeline-trust-v2.js +111 -0
  50. package/dist/agents/pre-x402-guard.d.ts +35 -0
  51. package/dist/agents/pre-x402-guard.js +84 -0
  52. package/dist/agents/quality-escrow-semantic.d.ts +88 -0
  53. package/dist/agents/quality-escrow-semantic.js +137 -0
  54. package/dist/agents/quality-escrow.d.ts +65 -0
  55. package/dist/agents/quality-escrow.js +104 -0
  56. package/dist/agents/quality-monitor.d.ts +32 -0
  57. package/dist/agents/quality-monitor.js +77 -0
  58. package/dist/agents/rail-optimizer.d.ts +33 -0
  59. package/dist/agents/rail-optimizer.js +133 -0
  60. package/dist/agents/receipt-auditor.d.ts +14 -0
  61. package/dist/agents/receipt-auditor.js +145 -0
  62. package/dist/agents/refund-arbiter.d.ts +24 -0
  63. package/dist/agents/refund-arbiter.js +70 -0
  64. package/dist/agents/research-brief.d.ts +14 -0
  65. package/dist/agents/research-brief.js +66 -0
  66. package/dist/agents/risk-gate.d.ts +11 -0
  67. package/dist/agents/risk-gate.js +78 -0
  68. package/dist/agents/settlement-graph.d.ts +16 -0
  69. package/dist/agents/settlement-graph.js +38 -0
  70. package/dist/agents/spend-governor.d.ts +2 -0
  71. package/dist/agents/spend-governor.js +70 -0
  72. package/dist/agents/trust-network.d.ts +138 -0
  73. package/dist/agents/trust-network.js +244 -0
  74. package/dist/agents/x402-proxy.d.ts +32 -0
  75. package/dist/agents/x402-proxy.js +90 -0
  76. package/dist/client/demo-alchemy-live.d.ts +1 -0
  77. package/dist/client/demo-alchemy-live.js +226 -0
  78. package/dist/client/demo-tail.d.ts +1 -0
  79. package/dist/client/demo-tail.js +100 -0
  80. package/dist/client/demo.d.ts +1 -0
  81. package/dist/client/demo.js +293 -0
  82. package/dist/config.d.ts +94 -0
  83. package/dist/config.js +223 -0
  84. package/dist/index.d.ts +1 -0
  85. package/dist/index.js +389 -0
  86. package/dist/lib/agent-response.d.ts +14 -0
  87. package/dist/lib/agent-response.js +13 -0
  88. package/dist/lib/agentic-gateways.d.ts +5 -0
  89. package/dist/lib/agentic-gateways.js +15 -0
  90. package/dist/lib/agentic-probes.d.ts +10 -0
  91. package/dist/lib/agentic-probes.js +49 -0
  92. package/dist/lib/alchemy-x402-fetch.d.ts +16 -0
  93. package/dist/lib/alchemy-x402-fetch.js +95 -0
  94. package/dist/lib/apply-verifier-body.d.ts +7 -0
  95. package/dist/lib/apply-verifier-body.js +179 -0
  96. package/dist/lib/attestation.d.ts +30 -0
  97. package/dist/lib/attestation.js +107 -0
  98. package/dist/lib/bazaar-extension.d.ts +15 -0
  99. package/dist/lib/bazaar-extension.js +265 -0
  100. package/dist/lib/bazaar.d.ts +100 -0
  101. package/dist/lib/bazaar.js +341 -0
  102. package/dist/lib/certified-sellers.d.ts +41 -0
  103. package/dist/lib/certified-sellers.js +129 -0
  104. package/dist/lib/chains.d.ts +20 -0
  105. package/dist/lib/chains.js +78 -0
  106. package/dist/lib/db-persistence.d.ts +7 -0
  107. package/dist/lib/db-persistence.js +65 -0
  108. package/dist/lib/db.d.ts +5 -0
  109. package/dist/lib/db.js +113 -0
  110. package/dist/lib/discovery-page.d.ts +2 -0
  111. package/dist/lib/discovery-page.js +71 -0
  112. package/dist/lib/ecosystem-telemetry.d.ts +20 -0
  113. package/dist/lib/ecosystem-telemetry.js +80 -0
  114. package/dist/lib/erc8004/agent-card.d.ts +34 -0
  115. package/dist/lib/erc8004/agent-card.js +151 -0
  116. package/dist/lib/erc8004/cache.d.ts +3 -0
  117. package/dist/lib/erc8004/cache.js +17 -0
  118. package/dist/lib/erc8004/constants.d.ts +22 -0
  119. package/dist/lib/erc8004/constants.js +35 -0
  120. package/dist/lib/erc8004/registry.d.ts +19 -0
  121. package/dist/lib/erc8004/registry.js +171 -0
  122. package/dist/lib/erc8004/resolve-agent.d.ts +7 -0
  123. package/dist/lib/erc8004/resolve-agent.js +70 -0
  124. package/dist/lib/erc8004/trust-score.d.ts +33 -0
  125. package/dist/lib/erc8004/trust-score.js +136 -0
  126. package/dist/lib/escrow-ledger.d.ts +14 -0
  127. package/dist/lib/escrow-ledger.js +54 -0
  128. package/dist/lib/escrow-unified.d.ts +15 -0
  129. package/dist/lib/escrow-unified.js +28 -0
  130. package/dist/lib/facilitator-extra.d.ts +13 -0
  131. package/dist/lib/facilitator-extra.js +52 -0
  132. package/dist/lib/facilitators.d.ts +20 -0
  133. package/dist/lib/facilitators.js +89 -0
  134. package/dist/lib/host-policy.d.ts +4 -0
  135. package/dist/lib/host-policy.js +20 -0
  136. package/dist/lib/idempotency.d.ts +4 -0
  137. package/dist/lib/idempotency.js +120 -0
  138. package/dist/lib/ledger.d.ts +2 -0
  139. package/dist/lib/ledger.js +17 -0
  140. package/dist/lib/logger.d.ts +6 -0
  141. package/dist/lib/logger.js +24 -0
  142. package/dist/lib/mandate-vc.d.ts +20 -0
  143. package/dist/lib/mandate-vc.js +25 -0
  144. package/dist/lib/mandate.d.ts +44 -0
  145. package/dist/lib/mandate.js +190 -0
  146. package/dist/lib/marketplace.d.ts +7 -0
  147. package/dist/lib/marketplace.js +127 -0
  148. package/dist/lib/migrations.d.ts +2 -0
  149. package/dist/lib/migrations.js +130 -0
  150. package/dist/lib/nonce-store.d.ts +6 -0
  151. package/dist/lib/nonce-store.js +109 -0
  152. package/dist/lib/openapi-agentcash.d.ts +5 -0
  153. package/dist/lib/openapi-agentcash.js +288 -0
  154. package/dist/lib/openapi-meta.d.ts +5 -0
  155. package/dist/lib/openapi-meta.js +235 -0
  156. package/dist/lib/otel.d.ts +2 -0
  157. package/dist/lib/otel.js +25 -0
  158. package/dist/lib/paid-resource-url.d.ts +6 -0
  159. package/dist/lib/paid-resource-url.js +47 -0
  160. package/dist/lib/parse-with-verifier-fallback.d.ts +3 -0
  161. package/dist/lib/parse-with-verifier-fallback.js +13 -0
  162. package/dist/lib/payment-request-context.d.ts +10 -0
  163. package/dist/lib/payment-request-context.js +5 -0
  164. package/dist/lib/payment-response.d.ts +13 -0
  165. package/dist/lib/payment-response.js +39 -0
  166. package/dist/lib/payto-guard.d.ts +10 -0
  167. package/dist/lib/payto-guard.js +20 -0
  168. package/dist/lib/probe.d.ts +29 -0
  169. package/dist/lib/probe.js +157 -0
  170. package/dist/lib/problem-detail.d.ts +10 -0
  171. package/dist/lib/problem-detail.js +14 -0
  172. package/dist/lib/rate-limit.d.ts +12 -0
  173. package/dist/lib/rate-limit.js +126 -0
  174. package/dist/lib/replay-middleware.d.ts +3 -0
  175. package/dist/lib/replay-middleware.js +27 -0
  176. package/dist/lib/response-guard.d.ts +5 -0
  177. package/dist/lib/response-guard.js +40 -0
  178. package/dist/lib/safe-fetch.d.ts +5 -0
  179. package/dist/lib/safe-fetch.js +19 -0
  180. package/dist/lib/security.d.ts +13 -0
  181. package/dist/lib/security.js +61 -0
  182. package/dist/lib/semantic-judge.d.ts +14 -0
  183. package/dist/lib/semantic-judge.js +107 -0
  184. package/dist/lib/semantic-judge.test.d.ts +1 -0
  185. package/dist/lib/semantic-judge.test.js +11 -0
  186. package/dist/lib/ssrf.d.ts +10 -0
  187. package/dist/lib/ssrf.js +130 -0
  188. package/dist/lib/ssrf.test.d.ts +1 -0
  189. package/dist/lib/ssrf.test.js +16 -0
  190. package/dist/lib/suite-catalog.d.ts +83 -0
  191. package/dist/lib/suite-catalog.js +131 -0
  192. package/dist/lib/telemetry.d.ts +5 -0
  193. package/dist/lib/telemetry.js +37 -0
  194. package/dist/lib/verifier-fast-path.d.ts +10 -0
  195. package/dist/lib/verifier-fast-path.js +44 -0
  196. package/dist/lib/verifier-probe-protocol.d.ts +7 -0
  197. package/dist/lib/verifier-probe-protocol.js +115 -0
  198. package/dist/lib/verify-examples.d.ts +2 -0
  199. package/dist/lib/verify-examples.js +438 -0
  200. package/dist/lib/version.d.ts +2 -0
  201. package/dist/lib/version.js +2 -0
  202. package/dist/lib/webhook-auth.d.ts +3 -0
  203. package/dist/lib/webhook-auth.js +34 -0
  204. package/dist/lib/webhook-routes.d.ts +2 -0
  205. package/dist/lib/webhook-routes.js +112 -0
  206. package/dist/lib/webhooks.d.ts +23 -0
  207. package/dist/lib/webhooks.js +123 -0
  208. package/dist/lib/webhooks.test.d.ts +1 -0
  209. package/dist/lib/webhooks.test.js +16 -0
  210. package/dist/lib/x402-client-options.d.ts +28 -0
  211. package/dist/lib/x402-client-options.js +138 -0
  212. package/dist/lib/x402-headers.d.ts +10 -0
  213. package/dist/lib/x402-headers.js +27 -0
  214. package/dist/lib/x402-paid.d.ts +5 -0
  215. package/dist/lib/x402-paid.js +252 -0
  216. package/dist/lib/x402-payment-replay.d.ts +22 -0
  217. package/dist/lib/x402-payment-replay.js +57 -0
  218. package/dist/lib/x402gle-host-verify.d.ts +3 -0
  219. package/dist/lib/x402gle-host-verify.js +27 -0
  220. package/dist/protocol/agent-passport.d.ts +34 -0
  221. package/dist/protocol/agent-passport.js +44 -0
  222. package/dist/protocol/compliance-v2.d.ts +21 -0
  223. package/dist/protocol/compliance-v2.js +19 -0
  224. package/dist/protocol/credit-bureau.d.ts +18 -0
  225. package/dist/protocol/credit-bureau.js +44 -0
  226. package/dist/protocol/crypto.d.ts +6 -0
  227. package/dist/protocol/crypto.js +41 -0
  228. package/dist/protocol/escrow-fsm.d.ts +33 -0
  229. package/dist/protocol/escrow-fsm.js +99 -0
  230. package/dist/protocol/fraud-engine.d.ts +28 -0
  231. package/dist/protocol/fraud-engine.js +77 -0
  232. package/dist/protocol/observability.d.ts +14 -0
  233. package/dist/protocol/observability.js +21 -0
  234. package/dist/protocol/pipeline-full-trust.d.ts +40 -0
  235. package/dist/protocol/pipeline-full-trust.js +96 -0
  236. package/dist/protocol/proof-of-execution.d.ts +36 -0
  237. package/dist/protocol/proof-of-execution.js +48 -0
  238. package/dist/protocol/reasoning-audit.d.ts +27 -0
  239. package/dist/protocol/reasoning-audit.js +51 -0
  240. package/dist/protocol/replay-guard.d.ts +28 -0
  241. package/dist/protocol/replay-guard.js +76 -0
  242. package/dist/protocol/replay-guard.test.d.ts +1 -0
  243. package/dist/protocol/replay-guard.test.js +10 -0
  244. package/dist/protocol/security-audit.d.ts +18 -0
  245. package/dist/protocol/security-audit.js +45 -0
  246. package/dist/protocol/store.d.ts +5 -0
  247. package/dist/protocol/store.js +59 -0
  248. package/dist/protocol/threat-catalog.d.ts +13 -0
  249. package/dist/protocol/threat-catalog.js +75 -0
  250. package/dist/protocol/trust-oracle.d.ts +23 -0
  251. package/dist/protocol/trust-oracle.js +30 -0
  252. package/dist/protocol/trust-score-v2.d.ts +33 -0
  253. package/dist/protocol/trust-score-v2.js +78 -0
  254. package/dist/protocol/zk-proofs.d.ts +24 -0
  255. package/dist/protocol/zk-proofs.js +32 -0
  256. package/dist/routes/a2a-agent-card.d.ts +3 -0
  257. package/dist/routes/a2a-agent-card.js +28 -0
  258. package/dist/routes/catalog.d.ts +5 -0
  259. package/dist/routes/catalog.js +47 -0
  260. package/dist/routes/register-all.d.ts +3 -0
  261. package/dist/routes/register-all.js +1240 -0
  262. package/dist/routes/schemas.d.ts +83 -0
  263. package/dist/routes/schemas.js +38 -0
  264. package/dist/routes/shared.d.ts +16 -0
  265. package/dist/routes/shared.js +27 -0
  266. package/dist/routes-protocol.d.ts +10 -0
  267. package/dist/routes-protocol.js +322 -0
  268. package/dist/routes.d.ts +2 -0
  269. package/dist/routes.js +2 -0
  270. package/dist/types.d.ts +66 -0
  271. package/dist/types.js +1 -0
  272. package/openapi.json +7940 -0
  273. package/package.json +124 -0
  274. package/public/.well-known/ai-plugin.json +12 -0
  275. package/public/assets/aegis-logo-blue.png +0 -0
  276. package/public/assets/aegis-logo-gold.png +0 -0
  277. package/public/assets/aegis-logo-green.png +0 -0
  278. package/public/assets/aegis-logo-purple.png +0 -0
  279. package/public/assets/aegis-logo-red.png +0 -0
  280. package/public/assets/aegis-logo-white.png +0 -0
  281. package/public/assets/aegis-logo.png +0 -0
  282. package/public/assets/x402-trustlayer-logo.png +0 -0
  283. package/public/assets/x402-trustlayer-logo.svg +5 -0
  284. package/public/data/agents.json +1528 -0
  285. package/public/index.html +198 -0
  286. package/public/landing.css +342 -0
  287. package/public/landing.js +405 -0
  288. package/public/llms-full.txt +582 -0
  289. package/public/llms.txt +132 -0
  290. package/public/skill.md +135 -0
  291. package/railway.toml +9 -0
  292. package/scripts/docker-entrypoint.sh +7 -0
  293. package/scripts/patch-facilitator-timeout.mjs +61 -0
@@ -0,0 +1,582 @@
1
+ # x402 Trust Layer — Full Agent Catalog
2
+
3
+ ## 1. Execute
4
+
5
+ - **Route:** POST /api/a2a/execute
6
+ - **Price:** $0.10 USDC
7
+ - **Tier:** Killer APIs
8
+ - **Summary:** Agent-to-agent x402 orchestration: trust preflight then paid call to seller endpoint
9
+ - **Why:** Paid x402 Trust Layer API — see OpenAPI for request schema.
10
+ - **Inputs:** see OpenAPI
11
+ - **Outputs:** see OpenAPI
12
+
13
+ ## 2. Preflight
14
+
15
+ - **Route:** POST /api/bedrock/preflight
16
+ - **Price:** $0.05 USDC
17
+ - **Tier:** Orchestration
18
+ - **Summary:** AWS Bedrock / enterprise agent preflight: guard, mandate, and trust bundle before x402 pay
19
+ - **Why:** Paid x402 Trust Layer API — see OpenAPI for request schema.
20
+ - **Inputs:** see OpenAPI
21
+ - **Outputs:** see OpenAPI
22
+
23
+ ## 3. Market Buy-Advisor
24
+
25
+ - **Route:** POST /api/market/buy-advisor
26
+ - **Price:** $0.08 USDC
27
+ - **Tier:** Killer APIs
28
+ - **Summary:** Jupiter-style buy quote — ranks paid APIs for an intent with policy and MPP advice.
29
+ - **Why:** Stops agents overpaying or buying from low-quality marketplace hosts.
30
+ - **Inputs:** intent, maxPriceUsdc, expectedCalls, policy, dryRunTarget?
31
+ - **Outputs:** recommendation, quotes, mppAdvice, chainAdvisor
32
+
33
+ ## 4. Seller Audition Coach
34
+
35
+ - **Route:** POST /api/seller/audition-coach
36
+ - **Price:** $0.06 USDC
37
+ - **Tier:** Killer APIs
38
+ - **Summary:** Pre-listing QA: audits OpenAPI, discovery manifests and 402 probes.
39
+ - **Why:** Raises verification score before Dexter/x402gle ingest (target ≥75).
40
+ - **Inputs:** origin, maxRoutes?
41
+ - **Outputs:** hostScoreEstimate, routes, globalFixes, discovery
42
+
43
+ ## 5. x402 Proxy
44
+
45
+ - **Route:** POST /api/x402/proxy
46
+ - **Price:** $0.08 USDC
47
+ - **Tier:** Killer APIs
48
+ - **Summary:** All-in-one preflight before any external x402 payment — policy, identity, risk, security grade and optional attestation.
49
+ - **Why:** Replaces 3–4 separate gate calls in one purchase. Default guard for agent fleets.
50
+ - **Inputs:** agentId, walletAddress, targetUrl, estimatedCostUsdc, policy, issueAttestation?
51
+ - **Outputs:** allowed, securityGrade, riskScore, spend, identity, attestation, probe
52
+
53
+ ## 6. MPP Session
54
+
55
+ - **Route:** POST /api/mpp/session
56
+ - **Price:** $0.03 USDC
57
+ - **Tier:** Killer APIs
58
+ - **Summary:** MPP session lifecycle: open, voucher, close — batch settlement on Base/Solana.
59
+ - **Why:** Cuts per-call settlement cost for high-frequency agent workloads.
60
+ - **Inputs:** action, sessionId?, expectedCalls, chain, agentId
61
+ - **Outputs:** session, estimatedSavingsUsdc, nextSteps
62
+
63
+ ## 7. Attestation Issue
64
+
65
+ - **Route:** POST /api/attestation/issue
66
+ - **Price:** $0.04 USDC
67
+ - **Tier:** Killer APIs
68
+ - **Summary:** Issues HMAC-signed preflight attestation for partner agent networks.
69
+ - **Why:** Gate partner interactions on verifiable credential status.
70
+ - **Inputs:** agentId, walletAddress, targetUrl, estimatedCostUsdc, policy
71
+ - **Outputs:** attestationId, signature, securityGrade, expiresAt
72
+
73
+ ## 8. Attestation Verify
74
+
75
+ - **Route:** POST /api/attestation/verify
76
+ - **Price:** $0.02 USDC
77
+ - **Tier:** Killer APIs
78
+ - **Summary:** Verifies attestation signature, expiry and registry lookup.
79
+ - **Why:** Confirm a partner attestation before trusting their response.
80
+ - **Inputs:** attestationId
81
+ - **Outputs:** valid, record, reason, checks_passed
82
+
83
+ ## 9. Attestation Registry
84
+
85
+ - **Route:** GET /api/attestation/registry
86
+ - **Price:** $0.02 USDC
87
+ - **Tier:** Killer APIs
88
+ - **Summary:** Query trust registry of valid agent attestations.
89
+ - **Why:** Fleet controllers reject paid calls without valid X-Suite-Attestation.
90
+ - **Inputs:** minGrade?, agentId?, limit?
91
+ - **Outputs:** count, records, policy
92
+
93
+ ## 10. Pre-x402 Guard
94
+
95
+ - **Route:** POST /api/guard/pre-x402
96
+ - **Price:** $0.05 USDC
97
+ - **Tier:** Bundles
98
+ - **Summary:** Spend governor + identity gate + risk gate in one lightweight call.
99
+ - **Why:** Cheapest allow/deny decision for high-frequency payment loops.
100
+ - **Inputs:** agentId, walletAddress, targetUrl, estimatedCostUsdc, policy, minAgentTier?, minTrustScore?
101
+ - **Outputs:** allowed, securityGrade, spend, identity, risk, agentTrust?
102
+
103
+ ## 11. Agent Verify (ERC-8004)
104
+
105
+ - **Route:** POST /api/agent/verify
106
+ - **Price:** $0.04 USDC
107
+ - **Tier:** Identity
108
+ - **Summary:** ERC-8004 TrustScore on Base mainnet — registration, reputation, wallet binding, agent card, domain.
109
+ - **Why:** On-chain agent identity before high-value x402 spend or fleet onboarding.
110
+ - **Inputs:** walletAddress, agentId?
111
+ - **Outputs:** trustScore, tier, breakdown, registered, recommendation
112
+
113
+ ## 12. Pipeline Execute
114
+
115
+ - **Route:** POST /api/pipeline/execute
116
+ - **Price:** $0.25 USDC
117
+ - **Tier:** Bundles
118
+ - **Summary:** One-shot orchestration: guard, NL plan, facilitator routing and marketplace pick.
119
+ - **Why:** Turns a natural-language task and budget into an executed, audited flow.
120
+ - **Inputs:** agentId, walletAddress, targetUrl, task, maxBudgetUsdc, marketplaceQuery
121
+ - **Outputs:** allowed, plan, facilitator, route, recommendedNextCalls
122
+
123
+ ## 13. Payment-Intent Compiler
124
+
125
+ - **Route:** POST /api/payment-intent/compile
126
+ - **Price:** $0.15 USDC
127
+ - **Tier:** Orchestration
128
+ - **Summary:** Compiles natural-language task + budget into a multi-step x402 execution plan.
129
+ - **Why:** Deterministic planning layer for autonomous spend within budget.
130
+ - **Inputs:** task, maxBudgetUsdc, agentId, externalCallEstimateUsdc?
131
+ - **Outputs:** steps, totalEstimatedUsdc, withinBudget, executionOrder
132
+
133
+ ## 14. Facilitator Failover
134
+
135
+ - **Route:** POST /api/facilitator/failover
136
+ - **Price:** $0.05 USDC
137
+ - **Tier:** Orchestration
138
+ - **Summary:** Ranks x402 facilitators and recommends a healthy failover route.
139
+ - **Why:** Avoids settlement failures when a facilitator degrades.
140
+ - **Inputs:** targetUrl, preferNetwork?
141
+ - **Outputs:** recommendedFacilitator, facilitators, targetProbe
142
+
143
+ ## 15. MPP Session Plan
144
+
145
+ - **Route:** POST /api/mpp/session-plan
146
+ - **Price:** $0.02 USDC
147
+ - **Tier:** Orchestration
148
+ - **Summary:** Estimates MPP batch session savings vs per-call settlement.
149
+ - **Why:** Quantifies when Stripe MPP / Dexter sessions beat individual settlements.
150
+ - **Inputs:** action, expectedCalls, avgPricePerCallUsdc
151
+ - **Outputs:** estimatedSavingsUSDC, recommendation, breakEvenCallCount
152
+
153
+ ## 16. Spend Governor
154
+
155
+ - **Route:** POST /api/spend-governor/check
156
+ - **Price:** $0.03 USDC
157
+ - **Tier:** Core Gates
158
+ - **Summary:** Enforces per-call and daily USDC spend caps per agent.
159
+ - **Why:** Hard budget guardrail — the floor of every preflight decision.
160
+ - **Inputs:** agentId, estimatedCostUsdc, targetUrl, policy
161
+ - **Outputs:** allowed, spentTodayUsdc, remainingDailyUsdc
162
+
163
+ ## 17. Identity Gate
164
+
165
+ - **Route:** POST /api/identity-gate/check
166
+ - **Price:** $0.05 USDC
167
+ - **Tier:** Core Gates
168
+ - **Summary:** Wallet identity tier and risk scoring before paid calls.
169
+ - **Why:** Blocks low-trust or unfunded wallets from mainnet spend.
170
+ - **Inputs:** walletAddress, maxTierSpendUsdc?
171
+ - **Outputs:** allowed, tier, riskScore, maxSpendUsdc
172
+
173
+ ## 18. Risk Gate
174
+
175
+ - **Route:** POST /api/risk-gate/scan
176
+ - **Price:** $0.08 USDC
177
+ - **Tier:** Core Gates
178
+ - **Summary:** Probes URL safety, HTTPS and x402 payment requirements.
179
+ - **Why:** Detects unreachable, mispriced or unsafe endpoints before payment.
180
+ - **Inputs:** targetUrl, estimatedCostUsdc, policy
181
+ - **Outputs:** safe, riskScore, securityGrade, probe
182
+
183
+ ## 19. API Router
184
+
185
+ - **Route:** POST /api/router/route
186
+ - **Price:** $0.02 USDC
187
+ - **Tier:** Core Gates
188
+ - **Summary:** Routes capability queries to the best verified x402 marketplace API.
189
+ - **Why:** Capability-based routing instead of hard-coded endpoints.
190
+ - **Inputs:** query, preferNetwork?, maxPriceUsdc?
191
+ - **Outputs:** selected, alternatives, probedPriceUsdc
192
+
193
+ ## 20. Research Brief
194
+
195
+ - **Route:** POST /api/research/brief
196
+ - **Price:** $0.20 USDC
197
+ - **Tier:** Core Gates
198
+ - **Summary:** Builds a paid-API research pipeline and cost estimate for any topic.
199
+ - **Why:** Turns a research goal into a concrete, budgeted API plan.
200
+ - **Inputs:** topic, includePrice?
201
+ - **Outputs:** brief, sources, pipeline, estimatedCostUsdc
202
+
203
+ ## 21. Receipt Auditor
204
+
205
+ - **Route:** POST /api/receipt-auditor/verify
206
+ - **Price:** $0.05 USDC
207
+ - **Tier:** Core Gates
208
+ - **Summary:** Verifies x402 settlement receipts and on-chain transaction alignment.
209
+ - **Why:** Proof that payment settled for the correct amount on-chain.
210
+ - **Inputs:** transactionHash, network, expectedAmountUsdc, settlement
211
+ - **Outputs:** valid, checks, explorerUrl
212
+
213
+ ## 22. Refund Arbiter
214
+
215
+ - **Route:** POST /api/refund-arbiter/evaluate
216
+ - **Price:** $0.08 USDC
217
+ - **Tier:** Trust & Refunds
218
+ - **Summary:** Evaluates buyer refund eligibility from verification signals.
219
+ - **Why:** Programmatic refund decisions when an API underdelivers.
220
+ - **Inputs:** verificationScore, responseEmpty, endpointReachable
221
+ - **Outputs:** refundEligible, protectionTier, buyerGuidance, grade
222
+
223
+ ## 23. Budget Allocator
224
+
225
+ - **Route:** POST /api/budget-allocator/run
226
+ - **Price:** $0.03 USDC
227
+ - **Tier:** Enterprise
228
+ - **Summary:** Allocates shared USDC pool across agent fleet by priority.
229
+ - **Why:** Fair, priority-weighted budget distribution at fleet scale.
230
+ - **Inputs:** fleetId, poolRemainingUsdc, agents
231
+ - **Outputs:** allocations, poolAfterUsdc
232
+
233
+ ## 24. Settlement Graph
234
+
235
+ - **Route:** POST /api/settlement-graph/next
236
+ - **Price:** $0.02 USDC
237
+ - **Tier:** Intelligence
238
+ - **Summary:** Recommends next paid APIs to call after a settlement receipt.
239
+ - **Why:** Drives multi-step agent journeys and reduces search steps.
240
+ - **Inputs:** lastEndpointPath, lastTopic?
241
+ - **Outputs:** recommendations, graphNote
242
+
243
+ ## 25. Quality Monitor
244
+
245
+ - **Route:** POST /api/quality-monitor/probe
246
+ - **Price:** $0.03 USDC
247
+ - **Tier:** Intelligence
248
+ - **Summary:** Regression-probes up to 10 x402 endpoints and returns quality scores.
249
+ - **Why:** Continuous SLA monitoring of a fleet's API dependencies.
250
+ - **Inputs:** urls
251
+ - **Outputs:** results, averageScore, overall
252
+
253
+ ## 26. Evidence Locker
254
+
255
+ - **Route:** POST /api/evidence-locker/export
256
+ - **Price:** $0.10 USDC
257
+ - **Tier:** Enterprise
258
+ - **Summary:** Exports tamper-evident compliance bundles for x402 settlements.
259
+ - **Why:** Audit-grade evidence export for finance and security review.
260
+ - **Inputs:** organizationId, records
261
+ - **Outputs:** bundleId, checksum, bundleSignature, export
262
+
263
+ ## 27. Agent Escrow
264
+
265
+ - **Route:** POST /api/agent-escrow
266
+ - **Price:** $0.12 USDC
267
+ - **Tier:** Enterprise
268
+ - **Summary:** Create, status or release agent-to-agent USDC escrow records.
269
+ - **Why:** Conditional payment between agents — release on verified condition.
270
+ - **Inputs:** action, payerAgentId, payeeAgentId, amountUsdc, escrowId?
271
+ - **Outputs:** escrow, status, releasedAt?
272
+
273
+ ## 28. Merchant Trust (KYM)
274
+
275
+ - **Route:** POST /api/merchant-trust/score
276
+ - **Price:** $0.06 USDC
277
+ - **Tier:** Tier-1 Enterprise
278
+ - **Summary:** Know-Your-Merchant trust score with wash-trading and verification signals.
279
+ - **Why:** Only public KYM oracle — pay / caution / avoid before any merchant payment.
280
+ - **Inputs:** host, washTradePct, verifiedResources, totalResources, probe?
281
+ - **Outputs:** trustScore, grade, recommendation, penalties
282
+
283
+ ## 29. Mandate Compile
284
+
285
+ - **Route:** POST /api/mandate/compile
286
+ - **Price:** $0.08 USDC
287
+ - **Tier:** Tier-1 Enterprise
288
+ - **Summary:** Compiles AP2-style signed payment mandate from human intent and guardrails.
289
+ - **Why:** Tamper-resistant intent → execution audit trail for Visa CLI / AP2 fleets.
290
+ - **Inputs:** principal, agentId, intent, maxPerTxUsdc, dailyCapUsdc, allowedMerchants
291
+ - **Outputs:** mandate, mandateId, signature, verifyUrl
292
+
293
+ ## 30. Mandate Verify
294
+
295
+ - **Route:** POST /api/mandate/verify
296
+ - **Price:** $0.02 USDC
297
+ - **Tier:** Tier-1 Enterprise
298
+ - **Summary:** Verifies mandate signature and scopes a proposed payment against it.
299
+ - **Why:** Merchants confirm agent payment is within authorized human intent.
300
+ - **Inputs:** mandateId, proposed
301
+ - **Outputs:** valid, withinScope, violations, record
302
+
303
+ ## 31. Rail Optimizer
304
+
305
+ - **Route:** POST /api/rail-optimizer/route
306
+ - **Price:** $0.04 USDC
307
+ - **Tier:** Tier-1 Enterprise
308
+ - **Summary:** Picks best rail: Visa CLI, Stripe MPP, Circle, Base x402 or Solana x402.
309
+ - **Why:** Unifies card and stablecoin rails in one cost + protection decision.
310
+ - **Inputs:** amountUsdc, disputable?, expectedCalls?, latencySensitive?
311
+ - **Outputs:** recommendedRail, ranked, recommendation
312
+
313
+ ## 32. Compliance Ledger
314
+
315
+ - **Route:** POST /api/compliance/ledger
316
+ - **Price:** $0.12 USDC
317
+ - **Tier:** Tier-1 Enterprise
318
+ - **Summary:** SOC2/tax-ready spend reconciliation with policy flags and tamper hash.
319
+ - **Why:** CFO-grade audit trail for autonomous agent spend at enterprise scale.
320
+ - **Inputs:** organizationId, period, records, policy
321
+ - **Outputs:** summary, breakdown, violations, ledgerHash
322
+
323
+ ## 33. Dispute Resolver
324
+
325
+ - **Route:** POST /api/dispute/resolve
326
+ - **Price:** $0.10 USDC
327
+ - **Tier:** Tier-1 Enterprise
328
+ - **Summary:** Visa chargeback dossier or on-chain refund claim builder.
329
+ - **Why:** Automates dispute filing for Visa CLI and refund routes for stablecoin rails.
330
+ - **Inputs:** rail, merchant, amountUsdc, reason, evidence
331
+ - **Outputs:** path, reasonCode, disputeStrength, filingSteps
332
+
333
+ ## 34. Quality Escrow
334
+
335
+ - **Route:** POST /api/quality-escrow/settle
336
+ - **Price:** $0.10 USDC
337
+ - **Tier:** Tier-1 Enterprise
338
+ - **Summary:** Quality-gated escrow — release on pass, auto-refund on response mismatch.
339
+ - **Why:** Closes trust gap on final stablecoin settlements with no chargeback recourse.
340
+ - **Inputs:** action, amountUsdc, expectedProfile, actualResponse, releaseThreshold
341
+ - **Outputs:** decision, qualityScore, status, reasons
342
+
343
+ ## 35. Semantic Delivery Escrow
344
+
345
+ - **Route:** POST /api/quality-escrow/semantic-settle
346
+ - **Price:** $0.12 USDC
347
+ - **Tier:** Tier-1 Enterprise
348
+ - **Summary:** Schema + intent rubric escrow with optional LLM judge and auto bond slash.
349
+ - **Why:** Post-pay delivery guarantee beyond JSON schema — refunds on semantic failure.
350
+ - **Inputs:** deliveryIntent, expectedProfile, actualResponse, amountUsdc
351
+ - **Outputs:** decision, semanticScore, schemaScore, judgeMode, bondSlash
352
+
353
+ ## 36. Mandate Intent Diff
354
+
355
+ - **Route:** POST /api/mandate/diff
356
+ - **Price:** $0.04 USDC
357
+ - **Tier:** Tier-1 Enterprise
358
+ - **Summary:** Compare signed mandate scope to MCP tool trace before payment.
359
+ - **Why:** Blocks prompt-injected routing and out-of-scope merchants before x402 pay.
360
+ - **Inputs:** mandateId, toolCalls, task?
361
+ - **Outputs:** allowed, liabilityTier, violations
362
+
363
+ ## 37. Certified Seller
364
+
365
+ - **Route:** POST /api/merchant-trust/certify
366
+ - **Price:** $0.15 USDC
367
+ - **Tier:** Tier-1 Enterprise
368
+ - **Summary:** Certify seller with KYM pass, badge, buyer policy, optional virtual bond.
369
+ - **Why:** Two-sided trust network — sellers require attested buyers.
370
+ - **Inputs:** host, policy, bondUsdc?, goodResponseProfile?
371
+ - **Outputs:** certified, badgeId, policy, expiresAt
372
+
373
+ ## 38. Certified Buyer Gate
374
+
375
+ - **Route:** POST /api/trust-network/buyer-gate
376
+ - **Price:** $0.03 USDC
377
+ - **Tier:** Tier-1 Enterprise
378
+ - **Summary:** Verify buyer attestation and tier against certified seller policy.
379
+ - **Why:** Premium APIs only accept attested agents with minimum TrustScore.
380
+ - **Inputs:** sellerHost, walletAddress, attestationId?
381
+ - **Outputs:** allowed, violations, requiredHeaders
382
+
383
+ ## 39. Pipeline Trust v2
384
+
385
+ - **Route:** POST /api/pipeline/trust-v2
386
+ - **Price:** $0.35 USDC
387
+ - **Tier:** Tier-1 Enterprise
388
+ - **Summary:** One-shot: mandate diff + KYM ingest + guard + certified buyer gate.
389
+ - **Why:** Default pre-pay bundle for OpenDexter and fleet agents.
390
+ - **Inputs:** agentId, walletAddress, targetUrl, policy, mandateId?, toolCalls?
391
+ - **Outputs:** allowed, steps, recommendedNextCalls
392
+
393
+ ## 40. Seller Bond Slash
394
+
395
+ - **Route:** POST /api/trust-network/bond/slash
396
+ - **Price:** $0.03 USDC
397
+ - **Tier:** Tier-1 Enterprise
398
+ - **Summary:** Slash certified seller virtual bond after failed delivery.
399
+ - **Why:** Economic accountability for certified sellers without on-chain contract yet.
400
+ - **Inputs:** sellerHost, amountUsdc, reason
401
+ - **Outputs:** slashed, bondRemainingUsdc
402
+
403
+ ## 41. Full Trust
404
+
405
+ - **Route:** POST /api/protocol/pipeline/full-trust
406
+ - **Price:** $0.45 USDC
407
+ - **Tier:** Agent Trust Protocol v4
408
+ - **Summary:** Agent Trust Protocol v4 full pipeline before x402 payment
409
+ - **Why:** Paid x402 Trust Layer API — see OpenAPI for request schema.
410
+ - **Inputs:** see OpenAPI
411
+ - **Outputs:** see OpenAPI
412
+
413
+ ## 42. Issue
414
+
415
+ - **Route:** POST /api/protocol/passport/issue
416
+ - **Price:** $0.06 USDC
417
+ - **Tier:** Agent Trust Protocol v4
418
+ - **Summary:** Issue Agent Passport DID verifiable credential
419
+ - **Why:** Paid x402 Trust Layer API — see OpenAPI for request schema.
420
+ - **Inputs:** see OpenAPI
421
+ - **Outputs:** see OpenAPI
422
+
423
+ ## 43. Verify
424
+
425
+ - **Route:** POST /api/protocol/passport/verify
426
+ - **Price:** $0.02 USDC
427
+ - **Tier:** Agent Trust Protocol v4
428
+ - **Summary:** Verify Agent Passport credential signature
429
+ - **Why:** Paid x402 Trust Layer API — see OpenAPI for request schema.
430
+ - **Inputs:** see OpenAPI
431
+ - **Outputs:** see OpenAPI
432
+
433
+ ## 44. V2
434
+
435
+ - **Route:** POST /api/protocol/trust-score/v2
436
+ - **Price:** $0.08 USDC
437
+ - **Tier:** Agent Trust Protocol v4
438
+ - **Summary:** TrustScore v2 with tamper-resistant HMAC proof
439
+ - **Why:** Paid x402 Trust Layer API — see OpenAPI for request schema.
440
+ - **Inputs:** see OpenAPI
441
+ - **Outputs:** see OpenAPI
442
+
443
+ ## 45. Scan
444
+
445
+ - **Route:** POST /api/protocol/fraud/scan
446
+ - **Price:** $0.10 USDC
447
+ - **Tier:** Agent Trust Protocol v4
448
+ - **Summary:** Graph fraud scan for Sybil and wash trading
449
+ - **Why:** Paid x402 Trust Layer API — see OpenAPI for request schema.
450
+ - **Inputs:** see OpenAPI
451
+ - **Outputs:** see OpenAPI
452
+
453
+ ## 46. Consensus
454
+
455
+ - **Route:** POST /api/protocol/oracle/consensus
456
+ - **Price:** $0.12 USDC
457
+ - **Tier:** Agent Trust Protocol v4
458
+ - **Summary:** Trust oracle quorum consensus
459
+ - **Why:** Paid x402 Trust Layer API — see OpenAPI for request schema.
460
+ - **Inputs:** see OpenAPI
461
+ - **Outputs:** see OpenAPI
462
+
463
+ ## 47. Issue
464
+
465
+ - **Route:** POST /api/protocol/execution/issue
466
+ - **Price:** $0.05 USDC
467
+ - **Tier:** Agent Trust Protocol v4
468
+ - **Summary:** Proof of Execution task receipt
469
+ - **Why:** Paid x402 Trust Layer API — see OpenAPI for request schema.
470
+ - **Inputs:** see OpenAPI
471
+ - **Outputs:** see OpenAPI
472
+
473
+ ## 48. Verify
474
+
475
+ - **Route:** POST /api/protocol/execution/verify
476
+ - **Price:** $0.03 USDC
477
+ - **Tier:** Agent Trust Protocol v4
478
+ - **Summary:** Verify Proof of Execution receipt
479
+ - **Why:** Paid x402 Trust Layer API — see OpenAPI for request schema.
480
+ - **Inputs:** see OpenAPI
481
+ - **Outputs:** see OpenAPI
482
+
483
+ ## 49. Commit
484
+
485
+ - **Route:** POST /api/protocol/reasoning/commit
486
+ - **Price:** $0.08 USDC
487
+ - **Tier:** Agent Trust Protocol v4
488
+ - **Summary:** Commit reasoning audit Merkle tree
489
+ - **Why:** Paid x402 Trust Layer API — see OpenAPI for request schema.
490
+ - **Inputs:** see OpenAPI
491
+ - **Outputs:** see OpenAPI
492
+
493
+ ## 50. Disclose
494
+
495
+ - **Route:** POST /api/protocol/reasoning/disclose
496
+ - **Price:** $0.04 USDC
497
+ - **Tier:** Agent Trust Protocol v4
498
+ - **Summary:** Selective disclosure of reasoning audit leaves
499
+ - **Why:** Paid x402 Trust Layer API — see OpenAPI for request schema.
500
+ - **Inputs:** see OpenAPI
501
+ - **Outputs:** see OpenAPI
502
+
503
+ ## 51. Create
504
+
505
+ - **Route:** POST /api/protocol/escrow/create
506
+ - **Price:** $0.08 USDC
507
+ - **Tier:** Agent Trust Protocol v4
508
+ - **Summary:** Create escrow FSM (CREATED)
509
+ - **Why:** Paid x402 Trust Layer API — see OpenAPI for request schema.
510
+ - **Inputs:** see OpenAPI
511
+ - **Outputs:** see OpenAPI
512
+
513
+ ## 52. Transition
514
+
515
+ - **Route:** POST /api/protocol/escrow/transition
516
+ - **Price:** $0.06 USDC
517
+ - **Tier:** Agent Trust Protocol v4
518
+ - **Summary:** Transition escrow FSM state
519
+ - **Why:** Paid x402 Trust Layer API — see OpenAPI for request schema.
520
+ - **Inputs:** see OpenAPI
521
+ - **Outputs:** see OpenAPI
522
+
523
+ ## 53. Status
524
+
525
+ - **Route:** POST /api/protocol/escrow/status
526
+ - **Price:** $0.02 USDC
527
+ - **Tier:** Agent Trust Protocol v4
528
+ - **Summary:** Query escrow FSM status
529
+ - **Why:** Paid x402 Trust Layer API — see OpenAPI for request schema.
530
+ - **Inputs:** see OpenAPI
531
+ - **Outputs:** see OpenAPI
532
+
533
+ ## 54. Bind
534
+
535
+ - **Route:** POST /api/protocol/replay/bind
536
+ - **Price:** $0.02 USDC
537
+ - **Tier:** Agent Trust Protocol v4
538
+ - **Summary:** Replay-safe payment binding
539
+ - **Why:** Paid x402 Trust Layer API — see OpenAPI for request schema.
540
+ - **Inputs:** see OpenAPI
541
+ - **Outputs:** see OpenAPI
542
+
543
+ ## 55. Verify
544
+
545
+ - **Route:** POST /api/protocol/replay/verify
546
+ - **Price:** $0.02 USDC
547
+ - **Tier:** Agent Trust Protocol v4
548
+ - **Summary:** Verify and consume replay binding
549
+ - **Why:** Paid x402 Trust Layer API — see OpenAPI for request schema.
550
+ - **Inputs:** see OpenAPI
551
+ - **Outputs:** see OpenAPI
552
+
553
+ ## 56. Prove
554
+
555
+ - **Route:** POST /api/protocol/zk/prove
556
+ - **Price:** $0.15 USDC
557
+ - **Tier:** Agent Trust Protocol v4
558
+ - **Summary:** ZK-style proof of budget, reputation, or compliance
559
+ - **Why:** Paid x402 Trust Layer API — see OpenAPI for request schema.
560
+ - **Inputs:** see OpenAPI
561
+ - **Outputs:** see OpenAPI
562
+
563
+ ## 57. Score
564
+
565
+ - **Route:** POST /api/protocol/credit/score
566
+ - **Price:** $0.06 USDC
567
+ - **Tier:** Agent Trust Protocol v4
568
+ - **Summary:** AI Agent Credit Bureau 300-900
569
+ - **Why:** Paid x402 Trust Layer API — see OpenAPI for request schema.
570
+ - **Inputs:** see OpenAPI
571
+ - **Outputs:** see OpenAPI
572
+
573
+ ## 58. Assess
574
+
575
+ - **Route:** POST /api/protocol/compliance/assess
576
+ - **Price:** $0.10 USDC
577
+ - **Tier:** Agent Trust Protocol v4
578
+ - **Summary:** Enterprise AML/KYC compliance assess
579
+ - **Why:** Paid x402 Trust Layer API — see OpenAPI for request schema.
580
+ - **Inputs:** see OpenAPI
581
+ - **Outputs:** see OpenAPI
582
+