xytara 3.1.0 → 3.1.1

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 (370) hide show
  1. package/.env.example +60 -58
  2. package/ADAPTER_START_HERE.md +56 -56
  3. package/CARRIED_HANDOFF_DEMO.md +60 -60
  4. package/EXAMPLE_PATHS.md +53 -53
  5. package/FINAL_CONTRACT.md +498 -498
  6. package/LICENSE +201 -201
  7. package/NOTICE +3 -3
  8. package/PARTNER_READY_PATH.md +71 -71
  9. package/PUBLIC_DEMO_SCRIPT.md +78 -78
  10. package/README.md +2 -1
  11. package/REAL_PAYMENT_SETUP.md +4 -3
  12. package/RELEASE_NOTES.md +17 -14
  13. package/SERVICE_CONTRACT.md +419 -419
  14. package/START_HERE.md +1 -1
  15. package/SUPABASE_RUNTIME_STATE_SETUP.md +61 -61
  16. package/TERMINOLOGY.md +50 -50
  17. package/WHY_XYTARA_XOONYA.md +63 -63
  18. package/XT1_EXECUTION_TRUTH_STANDARD.md +78 -78
  19. package/XYTARA_ADAPTER_PROTOCOL_TRUTH_MODEL.md +75 -75
  20. package/XYTARA_AUTONOMOUS_ENTRY_MODEL.md +124 -124
  21. package/XYTARA_DEFAULT_PATH_MODEL.md +84 -84
  22. package/XYTARA_EXECUTION_TRUTH_MODEL.md +171 -171
  23. package/XYTARA_PAYMENT_RAIL_TRUTH_MODEL.md +68 -68
  24. package/adapters/AUTHORING_GUIDE.md +243 -243
  25. package/adapters/ONBOARDING_POSTURE.md +61 -61
  26. package/adapters/THIRD_PARTY_SUBMISSION_PROCESS.md +84 -84
  27. package/adapters/adapter-manifest.schema.json +283 -283
  28. package/adapters/examples/example-execution-adapter.js +61 -61
  29. package/adapters/examples/example-execution-adapter.manifest.json +81 -81
  30. package/adapters/examples/example-settlement-adapter.js +55 -55
  31. package/adapters/examples/example-settlement-adapter.manifest.json +78 -78
  32. package/adapters/examples/example-third-party-acp-registration.submission-bundle.json +124 -124
  33. package/adapters/examples/example-third-party-erc8004-registration.submission-bundle.json +121 -121
  34. package/adapters/examples/example-third-party-identity-registration.certification-pack.json +22 -22
  35. package/adapters/examples/example-third-party-identity-registration.record.json +26 -26
  36. package/adapters/examples/example-third-party-identity-registration.submission-bundle.json +126 -126
  37. package/adapters/examples/example-third-party-langchain-registration.submission-bundle.json +124 -124
  38. package/adapters/examples/example-third-party-mpp-registration.submission-bundle.json +120 -120
  39. package/adapters/examples/example-third-party-registration.certification-pack.json +22 -22
  40. package/adapters/examples/example-third-party-registration.record.json +28 -28
  41. package/adapters/examples/example-third-party-registration.submission-bundle.json +126 -126
  42. package/adapters/examples/example-third-party-settlement-registration.certification-pack.json +22 -22
  43. package/adapters/examples/example-third-party-settlement-registration.record.json +26 -26
  44. package/adapters/examples/example-third-party-settlement-registration.submission-bundle.json +127 -127
  45. package/adapters/examples/langchain-reference-execution-adapter.js +81 -81
  46. package/adapters/examples/langchain-reference-execution-adapter.manifest.json +79 -79
  47. package/adapters/examples/langgraph-reference-execution-adapter.js +81 -81
  48. package/adapters/examples/langgraph-reference-execution-adapter.manifest.json +79 -79
  49. package/adapters/examples/minimal-third-party-execution-adapter.js +61 -61
  50. package/adapters/examples/minimal-third-party-execution-adapter.manifest.json +79 -79
  51. package/adapters/examples/minimal-third-party-execution-registration.record.json +26 -26
  52. package/adapters/examples/minimal-third-party-execution.certification-pack.json +22 -22
  53. package/adapters/examples/minimal-third-party-execution.submission-bundle.json +126 -126
  54. package/adapters/integration-certification-pack.schema.json +82 -82
  55. package/adapters/integration-registration-record.schema.json +114 -114
  56. package/adapters/integration-submission-bundle-set.schema.json +39 -39
  57. package/adapters/integration-submission-bundle.schema.json +34 -34
  58. package/adapters/interfaces.js +56 -56
  59. package/bin/xytara-first-run.js +244 -244
  60. package/bin/xytara-release.js +1429 -1429
  61. package/bin/xytara-run.js +186 -186
  62. package/bin/xytara.js +80 -80
  63. package/client.js +3 -3
  64. package/examples/_demo_env.js +40 -0
  65. package/examples/adapter_review_walkthrough.js +54 -53
  66. package/examples/export_carried_handoff.js +81 -80
  67. package/examples/funded_runtime_walkthrough.js +71 -70
  68. package/examples/partner_launch_walkthrough.js +44 -43
  69. package/examples/quickstart.js +3256 -3255
  70. package/fixtures/catalog.js +1134 -1134
  71. package/index.js +395 -395
  72. package/integrations/dispatch.js +276 -276
  73. package/integrations/registry-snapshot.schema.json +36 -36
  74. package/integrations/registry.js +2261 -2261
  75. package/integrations/views.js +28 -28
  76. package/lib/a2a_lane_contract.js +104 -104
  77. package/lib/a2c_lane_contract.js +111 -111
  78. package/lib/account_auth.js +518 -518
  79. package/lib/acp_lane_contract.js +54 -54
  80. package/lib/activity_audit_contract.js +322 -322
  81. package/lib/adapter_certification_contract.js +130 -130
  82. package/lib/adapter_depth_contract.js +156 -156
  83. package/lib/adapter_pack.js +118 -118
  84. package/lib/adapter_partner_pack.js +89 -89
  85. package/lib/adapter_promotion_pack.js +89 -89
  86. package/lib/adapter_protocol_truth_contract.js +229 -229
  87. package/lib/announcement_pack.js +61 -61
  88. package/lib/artifact_distribution_lane_contract.js +54 -54
  89. package/lib/asyncapi_contract.js +150 -150
  90. package/lib/auth_interop_contract.js +80 -80
  91. package/lib/authority_binding_lifecycle_contract.js +182 -182
  92. package/lib/autonomous_entry_contract.js +409 -409
  93. package/lib/bolt_lane_contract.js +55 -55
  94. package/lib/bolt_payment_front.js +172 -172
  95. package/lib/business_cockpit.js +378 -378
  96. package/lib/capability_execution_truth.js +272 -272
  97. package/lib/capability_registry.js +633 -633
  98. package/lib/catalog_contract.js +966 -966
  99. package/lib/catalog_family_model.js +193 -193
  100. package/lib/catalog_views.js +55 -55
  101. package/lib/checkout_event_security.js +142 -142
  102. package/lib/cloudevents_contract.js +80 -80
  103. package/lib/command_flow.js +406 -406
  104. package/lib/commerce_artifacts.js +503 -503
  105. package/lib/commerce_authority.js +449 -449
  106. package/lib/commerce_cases.js +317 -317
  107. package/lib/commerce_checkout.js +509 -509
  108. package/lib/commerce_client.js +7687 -7676
  109. package/lib/commerce_coordination.js +346 -346
  110. package/lib/commerce_economics.js +4017 -4016
  111. package/lib/commerce_identity.js +578 -578
  112. package/lib/commerce_quotes.js +237 -237
  113. package/lib/commerce_reports.js +14461 -14461
  114. package/lib/commerce_runtime.js +315 -315
  115. package/lib/commerce_shell.js +257 -257
  116. package/lib/crypto_agility_matrix.js +125 -125
  117. package/lib/default_path_contract.js +412 -412
  118. package/lib/delivery_summary_contract.js +95 -95
  119. package/lib/ecosystem_entry.js +64 -64
  120. package/lib/erc8004_lane_contract.js +65 -65
  121. package/lib/event_system_lane_contract.js +75 -75
  122. package/lib/execution_truth_contract.js +234 -234
  123. package/lib/external_credit_bridge.js +142 -142
  124. package/lib/external_execution_runtime.js +132 -132
  125. package/lib/feature_control_lane_contract.js +54 -54
  126. package/lib/first_run_conversion_contract.js +290 -290
  127. package/lib/framework_lane_contract.js +89 -89
  128. package/lib/framework_provider_promotion.js +235 -235
  129. package/lib/full_catalog_contract.js +525 -525
  130. package/lib/go_live_operator_pack.js +391 -391
  131. package/lib/http_transport.js +73 -73
  132. package/lib/identity_auth.js +175 -175
  133. package/lib/identity_interop_contract.js +82 -82
  134. package/lib/integration_matrix_contract.js +102 -102
  135. package/lib/l402_lane_contract.js +55 -55
  136. package/lib/l402_payment_front.js +192 -192
  137. package/lib/launch_narrative.js +53 -53
  138. package/lib/lifecycle_continuity_contract.js +115 -115
  139. package/lib/machine_identity_registry_contract.js +199 -199
  140. package/lib/major_rails_lane_contract.js +150 -150
  141. package/lib/market_lane_contract.js +467 -467
  142. package/lib/market_lane_depth_contract.js +182 -182
  143. package/lib/market_lane_promotion_contract.js +210 -210
  144. package/lib/market_lane_trace_contract.js +278 -278
  145. package/lib/mcp_lane_contract.js +137 -137
  146. package/lib/network_transport.js +110 -110
  147. package/lib/offline_verifiability_recovery_contract.js +155 -155
  148. package/lib/openapi_contract.js +296 -296
  149. package/lib/operational_receipt_contract.js +165 -165
  150. package/lib/operator_intelligence.js +407 -407
  151. package/lib/outreach_copy_pack.js +51 -51
  152. package/lib/outreach_message_pack.js +71 -71
  153. package/lib/outreach_proof.js +71 -71
  154. package/lib/outreach_target_pack.js +60 -60
  155. package/lib/partner_intelligence.js +105 -105
  156. package/lib/payment_config.js +193 -191
  157. package/lib/payment_front_registry.js +53 -53
  158. package/lib/payment_protocol_contract.js +165 -165
  159. package/lib/payment_rail_truth_contract.js +324 -324
  160. package/lib/payment_verification.js +264 -264
  161. package/lib/phase_10_closeout_pack.js +45 -45
  162. package/lib/phase_10_completion_pack.js +76 -76
  163. package/lib/phase_10_decision_record_pack.js +54 -54
  164. package/lib/phase_10_decision_resolution_pack.js +53 -53
  165. package/lib/phase_10_demand_signal_adapters_runtime_pack.js +74 -74
  166. package/lib/phase_10_ecosystem_backlog_triage_runtime_pack.js +74 -74
  167. package/lib/phase_10_freeze_baseline_pack.js +67 -67
  168. package/lib/phase_10_freeze_review_pack.js +64 -64
  169. package/lib/phase_10_gate_pack.js +57 -57
  170. package/lib/phase_10_long_tail_continuity_pack.js +80 -80
  171. package/lib/phase_10_long_tail_ecosystem_pack.js +66 -66
  172. package/lib/phase_10_niche_extension_registry_runtime_pack.js +74 -74
  173. package/lib/phase_1_claude_mcp_pack.js +60 -60
  174. package/lib/phase_1_claude_mcp_runtime_pack.js +52 -52
  175. package/lib/phase_1_ecosystem_pack.js +67 -67
  176. package/lib/phase_1_openai_codex_pack.js +60 -60
  177. package/lib/phase_1_openai_codex_runtime_pack.js +52 -52
  178. package/lib/phase_2_base_runtime_pack.js +71 -71
  179. package/lib/phase_2_base_usdc_runtime_pack.js +72 -72
  180. package/lib/phase_2_closeout_pack.js +65 -65
  181. package/lib/phase_2_completion_pack.js +113 -113
  182. package/lib/phase_2_decision_record_pack.js +66 -66
  183. package/lib/phase_2_decision_resolution_pack.js +69 -69
  184. package/lib/phase_2_eth_runtime_pack.js +70 -70
  185. package/lib/phase_2_evm_base_runtime_pack.js +73 -73
  186. package/lib/phase_2_evm_runtime_pack.js +71 -71
  187. package/lib/phase_2_flip_preview_pack.js +60 -60
  188. package/lib/phase_2_freeze_review_pack.js +99 -99
  189. package/lib/phase_2_gate_pack.js +77 -77
  190. package/lib/phase_2_payment_rails_pack.js +71 -71
  191. package/lib/phase_2_usdc_runtime_pack.js +71 -71
  192. package/lib/phase_3_brc_runtime_pack.js +81 -81
  193. package/lib/phase_3_bsv_teranode_runtime_pack.js +83 -83
  194. package/lib/phase_3_closeout_pack.js +62 -62
  195. package/lib/phase_3_completion_pack.js +94 -94
  196. package/lib/phase_3_decision_record_pack.js +64 -64
  197. package/lib/phase_3_decision_resolution_pack.js +69 -69
  198. package/lib/phase_3_freeze_baseline_pack.js +67 -67
  199. package/lib/phase_3_freeze_review_pack.js +80 -80
  200. package/lib/phase_3_gate_pack.js +76 -76
  201. package/lib/phase_3_metanet_runtime_pack.js +81 -81
  202. package/lib/phase_3_native_bsv_pack.js +91 -91
  203. package/lib/phase_3_native_continuity_pack.js +82 -82
  204. package/lib/phase_4_attestation_runtime_pack.js +75 -75
  205. package/lib/phase_4_closeout_pack.js +45 -45
  206. package/lib/phase_4_completion_pack.js +94 -94
  207. package/lib/phase_4_decision_record_pack.js +54 -54
  208. package/lib/phase_4_decision_resolution_pack.js +45 -45
  209. package/lib/phase_4_erc8004_runtime_pack.js +76 -76
  210. package/lib/phase_4_freeze_baseline_pack.js +67 -67
  211. package/lib/phase_4_freeze_review_pack.js +68 -68
  212. package/lib/phase_4_gate_pack.js +58 -58
  213. package/lib/phase_4_identity_registry_runtime_pack.js +75 -75
  214. package/lib/phase_4_identity_trust_pack.js +73 -73
  215. package/lib/phase_4_trust_continuity_pack.js +86 -86
  216. package/lib/phase_5_antelope_runtime_pack.js +76 -76
  217. package/lib/phase_5_closeout_pack.js +44 -44
  218. package/lib/phase_5_completion_pack.js +82 -82
  219. package/lib/phase_5_constellation_dag_runtime_pack.js +76 -76
  220. package/lib/phase_5_decision_record_pack.js +54 -54
  221. package/lib/phase_5_decision_resolution_pack.js +45 -45
  222. package/lib/phase_5_digibyte_dgb_runtime_pack.js +76 -76
  223. package/lib/phase_5_freeze_baseline_pack.js +67 -67
  224. package/lib/phase_5_freeze_review_pack.js +68 -68
  225. package/lib/phase_5_gate_pack.js +58 -58
  226. package/lib/phase_5_hedera_hbar_runtime_pack.js +76 -76
  227. package/lib/phase_5_kaspa_kas_runtime_pack.js +76 -76
  228. package/lib/phase_5_major_rails_continuity_pack.js +86 -86
  229. package/lib/phase_5_major_rails_pack.js +110 -110
  230. package/lib/phase_5_metal_runtime_pack.js +76 -76
  231. package/lib/phase_5_polkadot_dot_runtime_pack.js +76 -76
  232. package/lib/phase_5_proton_xpr_runtime_pack.js +76 -76
  233. package/lib/phase_5_solana_runtime_pack.js +76 -76
  234. package/lib/phase_6_autogen_runtime_pack.js +72 -72
  235. package/lib/phase_6_closeout_pack.js +46 -46
  236. package/lib/phase_6_completion_pack.js +77 -77
  237. package/lib/phase_6_decision_record_pack.js +54 -54
  238. package/lib/phase_6_decision_resolution_pack.js +53 -53
  239. package/lib/phase_6_framework_continuity_pack.js +81 -81
  240. package/lib/phase_6_framework_runtime_pack.js +68 -68
  241. package/lib/phase_6_freeze_baseline_pack.js +68 -68
  242. package/lib/phase_6_freeze_review_pack.js +65 -65
  243. package/lib/phase_6_gate_pack.js +59 -59
  244. package/lib/phase_6_langchain_runtime_pack.js +72 -72
  245. package/lib/phase_6_langgraph_runtime_pack.js +72 -72
  246. package/lib/phase_6_semantic_kernel_runtime_pack.js +72 -72
  247. package/lib/phase_7_closeout_pack.js +45 -45
  248. package/lib/phase_7_completion_pack.js +85 -85
  249. package/lib/phase_7_decision_record_pack.js +53 -53
  250. package/lib/phase_7_decision_resolution_pack.js +53 -53
  251. package/lib/phase_7_event_system_continuity_pack.js +89 -89
  252. package/lib/phase_7_event_system_pack.js +76 -76
  253. package/lib/phase_7_freeze_baseline_pack.js +74 -74
  254. package/lib/phase_7_freeze_review_pack.js +65 -65
  255. package/lib/phase_7_gate_pack.js +58 -58
  256. package/lib/phase_7_kafka_runtime_pack.js +74 -74
  257. package/lib/phase_7_mqtt_runtime_pack.js +74 -74
  258. package/lib/phase_7_nats_runtime_pack.js +74 -74
  259. package/lib/phase_7_webhook_event_bus_runtime_pack.js +74 -74
  260. package/lib/phase_8_closeout_pack.js +46 -46
  261. package/lib/phase_8_completion_pack.js +82 -82
  262. package/lib/phase_8_decision_record_pack.js +54 -54
  263. package/lib/phase_8_decision_resolution_pack.js +53 -53
  264. package/lib/phase_8_external_receipt_import_runtime_pack.js +74 -74
  265. package/lib/phase_8_external_result_import_runtime_pack.js +74 -74
  266. package/lib/phase_8_freeze_baseline_pack.js +71 -71
  267. package/lib/phase_8_freeze_review_pack.js +64 -64
  268. package/lib/phase_8_gate_pack.js +58 -58
  269. package/lib/phase_8_proof_bridge_continuity_pack.js +86 -86
  270. package/lib/phase_8_proof_bridges_pack.js +72 -72
  271. package/lib/phase_8_proof_bundle_normalization_runtime_pack.js +74 -74
  272. package/lib/phase_9_closeout_pack.js +46 -46
  273. package/lib/phase_9_completion_pack.js +82 -82
  274. package/lib/phase_9_custody_refs_runtime_pack.js +74 -74
  275. package/lib/phase_9_decision_record_pack.js +54 -54
  276. package/lib/phase_9_decision_resolution_pack.js +53 -53
  277. package/lib/phase_9_freeze_baseline_pack.js +71 -71
  278. package/lib/phase_9_freeze_review_pack.js +64 -64
  279. package/lib/phase_9_gate_pack.js +58 -58
  280. package/lib/phase_9_operator_accounting_bridges_runtime_pack.js +74 -74
  281. package/lib/phase_9_treasury_connectivity_pack.js +72 -72
  282. package/lib/phase_9_treasury_continuity_pack.js +86 -86
  283. package/lib/phase_9_treasury_destinations_runtime_pack.js +74 -74
  284. package/lib/phase_program_pack.js +120 -120
  285. package/lib/pricing_optimization_contract.js +775 -775
  286. package/lib/protocol_lane_contract.js +117 -117
  287. package/lib/provenance_lane_contract.js +54 -54
  288. package/lib/provider_lane_contract.js +240 -240
  289. package/lib/provider_runtime_journey_contract.js +183 -183
  290. package/lib/public_surface_policy_contract.js +111 -111
  291. package/lib/publish_plan.js +51 -51
  292. package/lib/record_queries.js +48 -48
  293. package/lib/release_candidate.js +50 -50
  294. package/lib/release_center.js +1093 -1093
  295. package/lib/release_history.js +205 -205
  296. package/lib/release_manifest.js +113 -113
  297. package/lib/release_pack.js +453 -453
  298. package/lib/request_rate_limit.js +144 -144
  299. package/lib/resource_views.js +31 -31
  300. package/lib/revenue_launch_path_contract.js +326 -326
  301. package/lib/route_matchers.js +34 -34
  302. package/lib/route_params.js +19 -19
  303. package/lib/runtime_bridge.js +124 -124
  304. package/lib/runtime_operations_worker.js +282 -282
  305. package/lib/runtime_state_store.js +354 -354
  306. package/lib/settlement_lane_contract.js +111 -111
  307. package/lib/shared_signals_lane_contract.js +54 -54
  308. package/lib/signed_audit_provenance_contract.js +83 -83
  309. package/lib/soft_launch_pack.js +78 -78
  310. package/lib/stablecoin_lane_contract.js +76 -76
  311. package/lib/stripe_mpp_lane_contract.js +96 -96
  312. package/lib/stripe_mpp_payment_front.js +158 -158
  313. package/lib/telemetry_lane_contract.js +54 -54
  314. package/lib/treasury_destinations_contract.js +764 -764
  315. package/lib/treasury_egress_policy_contract.js +91 -91
  316. package/lib/treasury_lane_contract.js +84 -84
  317. package/lib/trust_portability_boundary_contract.js +72 -72
  318. package/lib/x402_lane_contract.js +118 -118
  319. package/package.json +105 -105
  320. package/scripts/registry_cli.js +275 -275
  321. package/scripts/verify_adapters.js +554 -554
  322. package/scripts/verify_all.js +4962 -4962
  323. package/scripts/verify_control_plane_contracts.js +34 -34
  324. package/scripts/verify_control_plane_routes.js +70 -70
  325. package/scripts/verify_delivery_summary.js +112 -112
  326. package/scripts/verify_examples.js +19 -19
  327. package/scripts/verify_first_run_conversions.js +81 -81
  328. package/scripts/verify_framework_provider_promotion.js +152 -152
  329. package/scripts/verify_full_catalog.js +174 -174
  330. package/scripts/verify_integrations.js +620 -620
  331. package/scripts/verify_lifecycle_continuity.js +96 -96
  332. package/scripts/verify_market_lane_depth.js +94 -94
  333. package/scripts/verify_market_lane_promotion.js +103 -103
  334. package/scripts/verify_market_lane_traces.js +98 -98
  335. package/scripts/verify_market_lanes.js +102 -102
  336. package/scripts/verify_operator_observability_boundary.js +83 -83
  337. package/scripts/verify_pricing_experiment_plan.js +124 -124
  338. package/scripts/verify_provider_runtime_breadth.js +109 -109
  339. package/scripts/verify_provider_runtime_journeys.js +111 -111
  340. package/scripts/verify_revenue_launch_paths.js +105 -105
  341. package/scripts/verify_runtime_durability.js +52 -52
  342. package/scripts/verify_service.js +15410 -15250
  343. package/scripts/verify_tooling.js +1412 -1412
  344. package/scripts/verify_treasury_public_boundary.js +97 -97
  345. package/server.js +11101 -11006
  346. package/.env.production.checklist +0 -77
  347. package/.env.production.template +0 -54
  348. package/.github/workflows/publish-mcp-executor.yml +0 -43
  349. package/ADAPTER_PARTNER_PATH.md +0 -47
  350. package/ADAPTER_PROMOTION_START_HERE.md +0 -44
  351. package/BOLT_BINDINGS.production.worksheet.json +0 -31
  352. package/EXECUTION_TARGETS.production.worksheet.json +0 -73
  353. package/GO_LIVE_OPERATOR_PACK.md +0 -412
  354. package/L402_BINDINGS.production.worksheet.json +0 -30
  355. package/OPERATIONS_RUNBOOK.md +0 -115
  356. package/OPERATOR_START_HERE.md +0 -63
  357. package/OUTREACH_MESSAGES.md +0 -19
  358. package/OUTREACH_START_HERE.md +0 -36
  359. package/PRODUCTION_MANUAL_CLOSEOUT_SEQUENCE.md +0 -172
  360. package/PROGRAM_COMPLETE_RELEASE.md +0 -63
  361. package/PROGRAM_STATUS.md +0 -57
  362. package/PUBLISH_PLAN.md +0 -26
  363. package/RELEASE_CHECKLIST.md +0 -16
  364. package/SOFT_LAUNCH_KIT.md +0 -47
  365. package/services/mcp-execution-target/DISCOVERY_REGISTRY_PLAYBOOK.md +0 -141
  366. package/services/mcp-execution-target/README.md +0 -319
  367. package/services/mcp-execution-target/package.json +0 -14
  368. package/services/mcp-execution-target/server.js +0 -1031
  369. package/services/mcp-execution-target/server.json +0 -16
  370. package/services/mcp-execution-target/verify.js +0 -308
@@ -1,55 +1,55 @@
1
- "use strict";
2
-
3
- function buildBoltLanePack() {
4
- return {
5
- product: "xytara",
6
- category: "machine-commerce-bolt-lane-pack",
7
- pack_version: "xytara-bolt-lane-pack-v1",
8
- lane_state: "adapter_front_contract_present",
9
- posture: "utxo_native_or_spv_provable_payment_front",
10
- settlement_family: "utxo_native_settlement",
11
- proof_family: "spv_or_block_header_verifiable_payment_proof",
12
- role_in_xytara: "optional_permissionless_payment_and_proof_front",
13
- supported_surfaces: {
14
- security_ref: "/v1/bolt/security",
15
- commands_execute_ref: "/bolt/commands/execute",
16
- mcp_invoke_ref: "/bolt/mcp/tools/invoke",
17
- payment_protocols_ref: "/v1/payment-protocols",
18
- payment_protocol_strategy_ref: "/v1/payment-protocols/strategy",
19
- settlement_lane_ref: "/v1/settlement",
20
- execution_truth_ref: "/v1/capability-registry/execution-truth"
21
- },
22
- integration_rules: [
23
- "treat BOLT-style or UTXO-SPV payment fronts as adapter lanes into the same execution core",
24
- "keep settlement proof and runtime proof composable rather than hardwiring one chain ideology into the package",
25
- "bind chain-specific proof verification through explicit adapters or settlement runtimes"
26
- ],
27
- recommended_uses: [
28
- "operators who want stronger peer-to-peer payment properties",
29
- "architectures that value block-header or SPV-verifiable settlement proof",
30
- "ecosystems that prefer native UTXO payment models"
31
- ],
32
- non_claims: [
33
- "not claimed as a first-party launch-default lane",
34
- "not claimed as fully bound unless operator-configured against a real runtime"
35
- ]
36
- };
37
- }
38
-
39
- function summarizeBoltLanePack() {
40
- const pack = buildBoltLanePack();
41
- return {
42
- product: pack.product,
43
- category: pack.category,
44
- summary_version: "xytara-bolt-lane-pack-summary-v1",
45
- lane_state: pack.lane_state,
46
- posture: pack.posture,
47
- supported_surface_count: Object.keys(pack.supported_surfaces).length,
48
- linked_surfaces: pack.supported_surfaces
49
- };
50
- }
51
-
52
- module.exports = {
53
- buildBoltLanePack,
54
- summarizeBoltLanePack
55
- };
1
+ "use strict";
2
+
3
+ function buildBoltLanePack() {
4
+ return {
5
+ product: "xytara",
6
+ category: "machine-commerce-bolt-lane-pack",
7
+ pack_version: "xytara-bolt-lane-pack-v1",
8
+ lane_state: "adapter_front_contract_present",
9
+ posture: "utxo_native_or_spv_provable_payment_front",
10
+ settlement_family: "utxo_native_settlement",
11
+ proof_family: "spv_or_block_header_verifiable_payment_proof",
12
+ role_in_xytara: "optional_permissionless_payment_and_proof_front",
13
+ supported_surfaces: {
14
+ security_ref: "/v1/bolt/security",
15
+ commands_execute_ref: "/bolt/commands/execute",
16
+ mcp_invoke_ref: "/bolt/mcp/tools/invoke",
17
+ payment_protocols_ref: "/v1/payment-protocols",
18
+ payment_protocol_strategy_ref: "/v1/payment-protocols/strategy",
19
+ settlement_lane_ref: "/v1/settlement",
20
+ execution_truth_ref: "/v1/capability-registry/execution-truth"
21
+ },
22
+ integration_rules: [
23
+ "treat BOLT-style or UTXO-SPV payment fronts as adapter lanes into the same execution core",
24
+ "keep settlement proof and runtime proof composable rather than hardwiring one chain ideology into the package",
25
+ "bind chain-specific proof verification through explicit adapters or settlement runtimes"
26
+ ],
27
+ recommended_uses: [
28
+ "operators who want stronger peer-to-peer payment properties",
29
+ "architectures that value block-header or SPV-verifiable settlement proof",
30
+ "ecosystems that prefer native UTXO payment models"
31
+ ],
32
+ non_claims: [
33
+ "not claimed as a first-party launch-default lane",
34
+ "not claimed as fully bound unless operator-configured against a real runtime"
35
+ ]
36
+ };
37
+ }
38
+
39
+ function summarizeBoltLanePack() {
40
+ const pack = buildBoltLanePack();
41
+ return {
42
+ product: pack.product,
43
+ category: pack.category,
44
+ summary_version: "xytara-bolt-lane-pack-summary-v1",
45
+ lane_state: pack.lane_state,
46
+ posture: pack.posture,
47
+ supported_surface_count: Object.keys(pack.supported_surfaces).length,
48
+ linked_surfaces: pack.supported_surfaces
49
+ };
50
+ }
51
+
52
+ module.exports = {
53
+ buildBoltLanePack,
54
+ summarizeBoltLanePack
55
+ };
@@ -1,172 +1,172 @@
1
- "use strict";
2
-
3
- const crypto = require("crypto");
4
-
5
- function normalizeString(value) {
6
- return typeof value === "string" ? value.trim() : "";
7
- }
8
-
9
- function safeEqualHex(left, right) {
10
- const a = Buffer.from(String(left || ""), "hex");
11
- const b = Buffer.from(String(right || ""), "hex");
12
- if (a.length === 0 || b.length === 0 || a.length !== b.length) return false;
13
- return crypto.timingSafeEqual(a, b);
14
- }
15
-
16
- function decodeBase64UrlJson(value) {
17
- try {
18
- return JSON.parse(Buffer.from(String(value || ""), "base64url").toString("utf8"));
19
- } catch (_) {
20
- return null;
21
- }
22
- }
23
-
24
- function loadBoltFrontConfig() {
25
- const sharedSecret = normalizeString(process.env.XYTARA_BOLT_SHARED_SECRET);
26
- return {
27
- enabled: String(process.env.XYTARA_BOLT_ENABLED || (sharedSecret ? "true" : "false")).trim().toLowerCase() !== "false",
28
- shared_secret: sharedSecret || null,
29
- network: normalizeString(process.env.XYTARA_BOLT_NETWORK) || normalizeString(process.env.XYTARA_BSV_TERANODE_NETWORK) || "mainnet",
30
- proof_mode: normalizeString(process.env.XYTARA_BOLT_PROOF_MODE) || "spv_or_block_header_verifiable",
31
- max_age_seconds: Math.max(30, Number(process.env.XYTARA_BOLT_MAX_AGE_SECONDS || 300) || 300),
32
- required_headers: ["authorization"],
33
- auth_scheme: "BOLT",
34
- token_shape: "base64url_json_with_utxo_spv_proof_and_hmac_signed_payload"
35
- };
36
- }
37
-
38
- function parseBoltAuthorization(headers) {
39
- const authorization = headers && typeof headers.authorization === "string"
40
- ? headers.authorization.trim()
41
- : "";
42
- const match = authorization.match(/^BOLT\s+(.+)$/i);
43
- if (!match) return null;
44
- const decoded = decodeBase64UrlJson(match[1]);
45
- if (!decoded || typeof decoded !== "object") return null;
46
- return {
47
- wallet_id: decoded.wallet_id || decoded.gateway_id || "bolt_gateway",
48
- encoded: decoded.payload || null,
49
- signature: decoded.signature || null,
50
- txid: decoded.txid || null,
51
- spv_proof_ref: decoded.spv_proof_ref || null,
52
- merkle_path_ref: decoded.merkle_path_ref || null,
53
- block_header_ref: decoded.block_header_ref || null,
54
- network: decoded.network || null,
55
- proof_bundle_ref: decoded.proof_bundle_ref || null,
56
- scheme: "bolt"
57
- };
58
- }
59
-
60
- function verifyBoltPaymentPayload(paymentPayload, quote, walletId, maxAgeSeconds, config) {
61
- if (!paymentPayload || typeof paymentPayload !== "object") return { ok: false, reason: "bolt_payload_invalid" };
62
- if (!paymentPayload.quote_id || paymentPayload.quote_id !== quote.quote_id) return { ok: false, reason: "bolt_quote_mismatch" };
63
- if (paymentPayload.amount_minor !== quote.amount_minor) return { ok: false, reason: "bolt_amount_mismatch" };
64
- if (paymentPayload.currency !== quote.currency) return { ok: false, reason: "bolt_currency_mismatch" };
65
- if (paymentPayload.account_id && paymentPayload.account_id !== quote.account_id) return { ok: false, reason: "bolt_account_mismatch" };
66
- if (walletId && paymentPayload.wallet_id && paymentPayload.wallet_id !== walletId) return { ok: false, reason: "bolt_wallet_mismatch" };
67
- if (!paymentPayload.nonce || typeof paymentPayload.nonce !== "string") return { ok: false, reason: "bolt_nonce_missing" };
68
- if (!paymentPayload.issued_at_iso || Number.isNaN(Date.parse(paymentPayload.issued_at_iso))) return { ok: false, reason: "bolt_issued_at_invalid" };
69
- const ageSeconds = Math.max(0, Math.floor((Date.now() - Date.parse(paymentPayload.issued_at_iso)) / 1000));
70
- if (ageSeconds > maxAgeSeconds) return { ok: false, reason: "bolt_token_expired" };
71
- if (!normalizeString(paymentPayload.txid || paymentPayload.transaction_id)) return { ok: false, reason: "bolt_txid_missing" };
72
- if (
73
- !normalizeString(paymentPayload.spv_proof_ref || paymentPayload.proof_bundle_ref)
74
- && !normalizeString(paymentPayload.merkle_path_ref)
75
- && !normalizeString(paymentPayload.block_header_ref)
76
- ) {
77
- return { ok: false, reason: "bolt_proof_missing" };
78
- }
79
- if (
80
- normalizeString(paymentPayload.network)
81
- && normalizeString(config && config.network)
82
- && normalizeString(paymentPayload.network) !== normalizeString(config.network)
83
- ) {
84
- return { ok: false, reason: "bolt_network_mismatch" };
85
- }
86
- return { ok: true, age_seconds: ageSeconds };
87
- }
88
-
89
- function verifyBoltAccessToken(headers, quote) {
90
- const config = loadBoltFrontConfig();
91
- if (!config.enabled) return { ok: false, status: 503, reason: "bolt_not_enabled" };
92
- if (!config.shared_secret) return { ok: false, status: 503, reason: "bolt_shared_secret_missing" };
93
- const payment = parseBoltAuthorization(headers || {});
94
- if (!payment || !payment.encoded || !payment.signature) {
95
- return { ok: false, status: 402, reason: "bolt_headers_incomplete" };
96
- }
97
- const expectedSignature = crypto.createHmac("sha256", config.shared_secret).update(payment.encoded).digest("hex");
98
- if (!safeEqualHex(expectedSignature, payment.signature)) {
99
- return { ok: false, status: 403, reason: "bolt_signature_invalid" };
100
- }
101
- const payload = decodeBase64UrlJson(payment.encoded);
102
- const validation = verifyBoltPaymentPayload(payload, quote, payment.wallet_id, config.max_age_seconds, config);
103
- if (!validation.ok) return { ok: false, status: 403, reason: validation.reason };
104
- return {
105
- ok: true,
106
- verification_mode: "bolt_gateway_signed",
107
- wallet_id: payment.wallet_id,
108
- payment_payload: payload,
109
- age_seconds: validation.age_seconds,
110
- bolt: {
111
- txid: payment.txid || payload.txid || payload.transaction_id || null,
112
- spv_proof_ref: payment.spv_proof_ref || payload.spv_proof_ref || payload.proof_bundle_ref || null,
113
- merkle_path_ref: payment.merkle_path_ref || payload.merkle_path_ref || null,
114
- block_header_ref: payment.block_header_ref || payload.block_header_ref || null,
115
- proof_bundle_ref: payment.proof_bundle_ref || payload.proof_bundle_ref || null,
116
- network: payment.network || payload.network || config.network,
117
- proof_mode: config.proof_mode
118
- }
119
- };
120
- }
121
-
122
- function buildBoltSecuritySummary() {
123
- const config = loadBoltFrontConfig();
124
- const blockers = [];
125
- if (config.enabled && !config.shared_secret) blockers.push("bolt_shared_secret_missing");
126
- return {
127
- ok: true,
128
- category: "machine-commerce-bolt-security-summary",
129
- summary_version: "xytara-bolt-security-summary-v1",
130
- enabled: config.enabled,
131
- shared_secret_configured: Boolean(config.shared_secret),
132
- network: config.network,
133
- proof_mode: config.proof_mode,
134
- max_age_seconds: config.max_age_seconds,
135
- auth_scheme: config.auth_scheme,
136
- token_shape: config.token_shape,
137
- ready: config.enabled && blockers.length === 0,
138
- blockers,
139
- linked_surfaces: {
140
- bolt_lane_ref: "/v1/bolt",
141
- commands_execute_ref: "/bolt/commands/execute",
142
- mcp_invoke_ref: "/bolt/mcp/tools/invoke"
143
- }
144
- };
145
- }
146
-
147
- function buildBoltChallengePayload(quote) {
148
- return {
149
- ok: false,
150
- payment_required: {
151
- scheme: "bolt",
152
- quote,
153
- operator_requirements: {
154
- auth_scheme: "BOLT",
155
- token_shape: "base64url_json_with_utxo_spv_proof_and_hmac_signed_payload",
156
- security_ref: "/v1/bolt/security",
157
- proof_requirements: [
158
- "txid",
159
- "one_of:spv_proof_ref|merkle_path_ref|block_header_ref|proof_bundle_ref"
160
- ]
161
- }
162
- }
163
- };
164
- }
165
-
166
- module.exports = {
167
- buildBoltChallengePayload,
168
- buildBoltSecuritySummary,
169
- loadBoltFrontConfig,
170
- parseBoltAuthorization,
171
- verifyBoltAccessToken
172
- };
1
+ "use strict";
2
+
3
+ const crypto = require("crypto");
4
+
5
+ function normalizeString(value) {
6
+ return typeof value === "string" ? value.trim() : "";
7
+ }
8
+
9
+ function safeEqualHex(left, right) {
10
+ const a = Buffer.from(String(left || ""), "hex");
11
+ const b = Buffer.from(String(right || ""), "hex");
12
+ if (a.length === 0 || b.length === 0 || a.length !== b.length) return false;
13
+ return crypto.timingSafeEqual(a, b);
14
+ }
15
+
16
+ function decodeBase64UrlJson(value) {
17
+ try {
18
+ return JSON.parse(Buffer.from(String(value || ""), "base64url").toString("utf8"));
19
+ } catch (_) {
20
+ return null;
21
+ }
22
+ }
23
+
24
+ function loadBoltFrontConfig() {
25
+ const sharedSecret = normalizeString(process.env.XYTARA_BOLT_SHARED_SECRET);
26
+ return {
27
+ enabled: String(process.env.XYTARA_BOLT_ENABLED || (sharedSecret ? "true" : "false")).trim().toLowerCase() !== "false",
28
+ shared_secret: sharedSecret || null,
29
+ network: normalizeString(process.env.XYTARA_BOLT_NETWORK) || normalizeString(process.env.XYTARA_BSV_TERANODE_NETWORK) || "mainnet",
30
+ proof_mode: normalizeString(process.env.XYTARA_BOLT_PROOF_MODE) || "spv_or_block_header_verifiable",
31
+ max_age_seconds: Math.max(30, Number(process.env.XYTARA_BOLT_MAX_AGE_SECONDS || 300) || 300),
32
+ required_headers: ["authorization"],
33
+ auth_scheme: "BOLT",
34
+ token_shape: "base64url_json_with_utxo_spv_proof_and_hmac_signed_payload"
35
+ };
36
+ }
37
+
38
+ function parseBoltAuthorization(headers) {
39
+ const authorization = headers && typeof headers.authorization === "string"
40
+ ? headers.authorization.trim()
41
+ : "";
42
+ const match = authorization.match(/^BOLT\s+(.+)$/i);
43
+ if (!match) return null;
44
+ const decoded = decodeBase64UrlJson(match[1]);
45
+ if (!decoded || typeof decoded !== "object") return null;
46
+ return {
47
+ wallet_id: decoded.wallet_id || decoded.gateway_id || "bolt_gateway",
48
+ encoded: decoded.payload || null,
49
+ signature: decoded.signature || null,
50
+ txid: decoded.txid || null,
51
+ spv_proof_ref: decoded.spv_proof_ref || null,
52
+ merkle_path_ref: decoded.merkle_path_ref || null,
53
+ block_header_ref: decoded.block_header_ref || null,
54
+ network: decoded.network || null,
55
+ proof_bundle_ref: decoded.proof_bundle_ref || null,
56
+ scheme: "bolt"
57
+ };
58
+ }
59
+
60
+ function verifyBoltPaymentPayload(paymentPayload, quote, walletId, maxAgeSeconds, config) {
61
+ if (!paymentPayload || typeof paymentPayload !== "object") return { ok: false, reason: "bolt_payload_invalid" };
62
+ if (!paymentPayload.quote_id || paymentPayload.quote_id !== quote.quote_id) return { ok: false, reason: "bolt_quote_mismatch" };
63
+ if (paymentPayload.amount_minor !== quote.amount_minor) return { ok: false, reason: "bolt_amount_mismatch" };
64
+ if (paymentPayload.currency !== quote.currency) return { ok: false, reason: "bolt_currency_mismatch" };
65
+ if (paymentPayload.account_id && paymentPayload.account_id !== quote.account_id) return { ok: false, reason: "bolt_account_mismatch" };
66
+ if (walletId && paymentPayload.wallet_id && paymentPayload.wallet_id !== walletId) return { ok: false, reason: "bolt_wallet_mismatch" };
67
+ if (!paymentPayload.nonce || typeof paymentPayload.nonce !== "string") return { ok: false, reason: "bolt_nonce_missing" };
68
+ if (!paymentPayload.issued_at_iso || Number.isNaN(Date.parse(paymentPayload.issued_at_iso))) return { ok: false, reason: "bolt_issued_at_invalid" };
69
+ const ageSeconds = Math.max(0, Math.floor((Date.now() - Date.parse(paymentPayload.issued_at_iso)) / 1000));
70
+ if (ageSeconds > maxAgeSeconds) return { ok: false, reason: "bolt_token_expired" };
71
+ if (!normalizeString(paymentPayload.txid || paymentPayload.transaction_id)) return { ok: false, reason: "bolt_txid_missing" };
72
+ if (
73
+ !normalizeString(paymentPayload.spv_proof_ref || paymentPayload.proof_bundle_ref)
74
+ && !normalizeString(paymentPayload.merkle_path_ref)
75
+ && !normalizeString(paymentPayload.block_header_ref)
76
+ ) {
77
+ return { ok: false, reason: "bolt_proof_missing" };
78
+ }
79
+ if (
80
+ normalizeString(paymentPayload.network)
81
+ && normalizeString(config && config.network)
82
+ && normalizeString(paymentPayload.network) !== normalizeString(config.network)
83
+ ) {
84
+ return { ok: false, reason: "bolt_network_mismatch" };
85
+ }
86
+ return { ok: true, age_seconds: ageSeconds };
87
+ }
88
+
89
+ function verifyBoltAccessToken(headers, quote) {
90
+ const config = loadBoltFrontConfig();
91
+ if (!config.enabled) return { ok: false, status: 503, reason: "bolt_not_enabled" };
92
+ if (!config.shared_secret) return { ok: false, status: 503, reason: "bolt_shared_secret_missing" };
93
+ const payment = parseBoltAuthorization(headers || {});
94
+ if (!payment || !payment.encoded || !payment.signature) {
95
+ return { ok: false, status: 402, reason: "bolt_headers_incomplete" };
96
+ }
97
+ const expectedSignature = crypto.createHmac("sha256", config.shared_secret).update(payment.encoded).digest("hex");
98
+ if (!safeEqualHex(expectedSignature, payment.signature)) {
99
+ return { ok: false, status: 403, reason: "bolt_signature_invalid" };
100
+ }
101
+ const payload = decodeBase64UrlJson(payment.encoded);
102
+ const validation = verifyBoltPaymentPayload(payload, quote, payment.wallet_id, config.max_age_seconds, config);
103
+ if (!validation.ok) return { ok: false, status: 403, reason: validation.reason };
104
+ return {
105
+ ok: true,
106
+ verification_mode: "bolt_gateway_signed",
107
+ wallet_id: payment.wallet_id,
108
+ payment_payload: payload,
109
+ age_seconds: validation.age_seconds,
110
+ bolt: {
111
+ txid: payment.txid || payload.txid || payload.transaction_id || null,
112
+ spv_proof_ref: payment.spv_proof_ref || payload.spv_proof_ref || payload.proof_bundle_ref || null,
113
+ merkle_path_ref: payment.merkle_path_ref || payload.merkle_path_ref || null,
114
+ block_header_ref: payment.block_header_ref || payload.block_header_ref || null,
115
+ proof_bundle_ref: payment.proof_bundle_ref || payload.proof_bundle_ref || null,
116
+ network: payment.network || payload.network || config.network,
117
+ proof_mode: config.proof_mode
118
+ }
119
+ };
120
+ }
121
+
122
+ function buildBoltSecuritySummary() {
123
+ const config = loadBoltFrontConfig();
124
+ const blockers = [];
125
+ if (config.enabled && !config.shared_secret) blockers.push("bolt_shared_secret_missing");
126
+ return {
127
+ ok: true,
128
+ category: "machine-commerce-bolt-security-summary",
129
+ summary_version: "xytara-bolt-security-summary-v1",
130
+ enabled: config.enabled,
131
+ shared_secret_configured: Boolean(config.shared_secret),
132
+ network: config.network,
133
+ proof_mode: config.proof_mode,
134
+ max_age_seconds: config.max_age_seconds,
135
+ auth_scheme: config.auth_scheme,
136
+ token_shape: config.token_shape,
137
+ ready: config.enabled && blockers.length === 0,
138
+ blockers,
139
+ linked_surfaces: {
140
+ bolt_lane_ref: "/v1/bolt",
141
+ commands_execute_ref: "/bolt/commands/execute",
142
+ mcp_invoke_ref: "/bolt/mcp/tools/invoke"
143
+ }
144
+ };
145
+ }
146
+
147
+ function buildBoltChallengePayload(quote) {
148
+ return {
149
+ ok: false,
150
+ payment_required: {
151
+ scheme: "bolt",
152
+ quote,
153
+ operator_requirements: {
154
+ auth_scheme: "BOLT",
155
+ token_shape: "base64url_json_with_utxo_spv_proof_and_hmac_signed_payload",
156
+ security_ref: "/v1/bolt/security",
157
+ proof_requirements: [
158
+ "txid",
159
+ "one_of:spv_proof_ref|merkle_path_ref|block_header_ref|proof_bundle_ref"
160
+ ]
161
+ }
162
+ }
163
+ };
164
+ }
165
+
166
+ module.exports = {
167
+ buildBoltChallengePayload,
168
+ buildBoltSecuritySummary,
169
+ loadBoltFrontConfig,
170
+ parseBoltAuthorization,
171
+ verifyBoltAccessToken
172
+ };