xytara 3.1.16 → 3.2.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.
- package/README.md +120 -92
- package/RELEASE_NOTES.md +7 -3
- package/START_HERE.md +56 -224
- package/bin/xytara.js +21 -8
- package/client.js +79 -1
- package/lib/{delivery_receipt.js → delivery_receipt_verify.js} +14 -100
- package/package.json +25 -35
- package/scripts/verify_client.js +418 -0
- package/scripts/verify_release_candidate.js +146 -45
- package/.env.example +0 -173
- package/ADAPTER_START_HERE.md +0 -56
- package/BSV_TERANODE_PLATFORM_DISCONTINUITY_RUNBOOK.md +0 -126
- package/CARRIED_HANDOFF_DEMO.md +0 -60
- package/EXAMPLE_PATHS.md +0 -53
- package/FINAL_CONTRACT.md +0 -498
- package/PARTNER_READY_PATH.md +0 -71
- package/PUBLIC_DEMO_SCRIPT.md +0 -78
- package/REAL_PAYMENT_SETUP.md +0 -320
- package/SERVICE_CONTRACT.md +0 -419
- package/SUPABASE_RUNTIME_STATE_SETUP.md +0 -61
- package/TERMINOLOGY.md +0 -50
- package/WHY_XYTARA_XOONYA.md +0 -63
- package/XT1_EXECUTION_TRUTH_STANDARD.md +0 -78
- package/XYTARA_ADAPTER_PROTOCOL_TRUTH_MODEL.md +0 -75
- package/XYTARA_AUTONOMOUS_ENTRY_MODEL.md +0 -124
- package/XYTARA_DEFAULT_PATH_MODEL.md +0 -84
- package/XYTARA_EXECUTION_TRUTH_MODEL.md +0 -171
- package/XYTARA_PAYMENT_RAIL_TRUTH_MODEL.md +0 -68
- package/adapters/AUTHORING_GUIDE.md +0 -244
- package/adapters/ONBOARDING_POSTURE.md +0 -61
- package/adapters/THIRD_PARTY_SUBMISSION_PROCESS.md +0 -84
- package/adapters/adapter-manifest.schema.json +0 -283
- package/adapters/examples/example-execution-adapter.js +0 -61
- package/adapters/examples/example-execution-adapter.manifest.json +0 -81
- package/adapters/examples/example-settlement-adapter.js +0 -55
- package/adapters/examples/example-settlement-adapter.manifest.json +0 -78
- package/adapters/examples/example-third-party-acp-registration.submission-bundle.json +0 -124
- package/adapters/examples/example-third-party-erc8004-registration.submission-bundle.json +0 -121
- package/adapters/examples/example-third-party-identity-registration.certification-pack.json +0 -22
- package/adapters/examples/example-third-party-identity-registration.record.json +0 -26
- package/adapters/examples/example-third-party-identity-registration.submission-bundle.json +0 -126
- package/adapters/examples/example-third-party-langchain-registration.submission-bundle.json +0 -124
- package/adapters/examples/example-third-party-mpp-registration.submission-bundle.json +0 -120
- package/adapters/examples/example-third-party-registration.certification-pack.json +0 -22
- package/adapters/examples/example-third-party-registration.record.json +0 -28
- package/adapters/examples/example-third-party-registration.submission-bundle.json +0 -126
- package/adapters/examples/example-third-party-settlement-registration.certification-pack.json +0 -22
- package/adapters/examples/example-third-party-settlement-registration.record.json +0 -26
- package/adapters/examples/example-third-party-settlement-registration.submission-bundle.json +0 -127
- package/adapters/examples/langchain-reference-execution-adapter.js +0 -81
- package/adapters/examples/langchain-reference-execution-adapter.manifest.json +0 -79
- package/adapters/examples/langgraph-reference-execution-adapter.js +0 -81
- package/adapters/examples/langgraph-reference-execution-adapter.manifest.json +0 -79
- package/adapters/examples/minimal-third-party-execution-adapter.js +0 -61
- package/adapters/examples/minimal-third-party-execution-adapter.manifest.json +0 -79
- package/adapters/examples/minimal-third-party-execution-registration.record.json +0 -26
- package/adapters/examples/minimal-third-party-execution.certification-pack.json +0 -22
- package/adapters/examples/minimal-third-party-execution.submission-bundle.json +0 -126
- package/adapters/integration-certification-pack.schema.json +0 -82
- package/adapters/integration-registration-record.schema.json +0 -114
- package/adapters/integration-submission-bundle-set.schema.json +0 -39
- package/adapters/integration-submission-bundle.schema.json +0 -34
- package/adapters/interfaces.js +0 -56
- package/bin/xytara-release.js +0 -1429
- package/examples/_demo_env.js +0 -40
- package/examples/adapter_review_walkthrough.js +0 -54
- package/examples/export_carried_handoff.js +0 -81
- package/examples/funded_runtime_walkthrough.js +0 -71
- package/examples/partner_launch_walkthrough.js +0 -44
- package/examples/quickstart.js +0 -3256
- package/fixtures/catalog.js +0 -1156
- package/index.js +0 -395
- package/integrations/dispatch.js +0 -276
- package/integrations/registry-snapshot.schema.json +0 -36
- package/integrations/registry.js +0 -2261
- package/integrations/views.js +0 -28
- package/lib/a2a_lane_contract.js +0 -104
- package/lib/a2a_rpc.js +0 -287
- package/lib/a2c_lane_contract.js +0 -111
- package/lib/account_auth.js +0 -585
- package/lib/acp_lane_contract.js +0 -54
- package/lib/activity_audit_contract.js +0 -322
- package/lib/adapter_certification_contract.js +0 -130
- package/lib/adapter_depth_contract.js +0 -218
- package/lib/adapter_pack.js +0 -118
- package/lib/adapter_partner_pack.js +0 -89
- package/lib/adapter_promotion_pack.js +0 -89
- package/lib/adapter_protocol_truth_contract.js +0 -229
- package/lib/agent_identity.js +0 -162
- package/lib/announcement_pack.js +0 -61
- package/lib/artifact_distribution_lane_contract.js +0 -54
- package/lib/asyncapi_contract.js +0 -150
- package/lib/auth_interop_contract.js +0 -80
- package/lib/authority_binding_lifecycle_contract.js +0 -182
- package/lib/autonomous_entry_contract.js +0 -409
- package/lib/bolt_adapter.js +0 -187
- package/lib/bolt_lane_contract.js +0 -55
- package/lib/bolt_payment_front.js +0 -224
- package/lib/business_cockpit.js +0 -378
- package/lib/buyer_event_log.js +0 -230
- package/lib/buyer_safety_policy.js +0 -132
- package/lib/capability_execution_truth.js +0 -276
- package/lib/capability_registry.js +0 -633
- package/lib/catalog_contract.js +0 -966
- package/lib/catalog_family_model.js +0 -193
- package/lib/catalog_views.js +0 -55
- package/lib/cdp_jwt.js +0 -57
- package/lib/checkout_event_security.js +0 -142
- package/lib/checkout_processor_adapter.js +0 -217
- package/lib/cloudevents_contract.js +0 -80
- package/lib/command_flow.js +0 -911
- package/lib/commerce_artifacts.js +0 -591
- package/lib/commerce_authority.js +0 -449
- package/lib/commerce_bridge.js +0 -274
- package/lib/commerce_cases.js +0 -399
- package/lib/commerce_checkout.js +0 -509
- package/lib/commerce_coordination.js +0 -346
- package/lib/commerce_economics.js +0 -4017
- package/lib/commerce_identity.js +0 -578
- package/lib/commerce_quotes.js +0 -266
- package/lib/commerce_reports.js +0 -14461
- package/lib/commerce_runtime.js +0 -322
- package/lib/commerce_shell.js +0 -257
- package/lib/crypto_agility_matrix.js +0 -125
- package/lib/default_path_contract.js +0 -412
- package/lib/delivery_summary_contract.js +0 -95
- package/lib/ecosystem_entry.js +0 -64
- package/lib/erc8004_lane_contract.js +0 -65
- package/lib/event_system_lane_contract.js +0 -75
- package/lib/execution_dedupe.js +0 -86
- package/lib/execution_truth_contract.js +0 -234
- package/lib/external_credit_bridge.js +0 -142
- package/lib/external_execution_policy.js +0 -143
- package/lib/external_execution_runtime.js +0 -238
- package/lib/feature_control_lane_contract.js +0 -54
- package/lib/first_run_conversion_contract.js +0 -290
- package/lib/framework_lane_contract.js +0 -89
- package/lib/framework_provider_promotion.js +0 -235
- package/lib/full_catalog_contract.js +0 -525
- package/lib/go_live_operator_pack.js +0 -391
- package/lib/http_transport.js +0 -99
- package/lib/identity_auth.js +0 -175
- package/lib/identity_interop_contract.js +0 -82
- package/lib/integration_matrix_contract.js +0 -102
- package/lib/l402_adapter.js +0 -241
- package/lib/l402_lane_contract.js +0 -55
- package/lib/l402_payment_front.js +0 -265
- package/lib/launch_narrative.js +0 -53
- package/lib/lifecycle_continuity_contract.js +0 -115
- package/lib/machine_identity_registry_contract.js +0 -199
- package/lib/major_rails_lane_contract.js +0 -150
- package/lib/market_lane_contract.js +0 -467
- package/lib/market_lane_depth_contract.js +0 -182
- package/lib/market_lane_promotion_contract.js +0 -210
- package/lib/market_lane_trace_contract.js +0 -278
- package/lib/mcp_lane_contract.js +0 -137
- package/lib/mpp_adapter.js +0 -237
- package/lib/network_transport.js +0 -110
- package/lib/offline_verifiability_recovery_contract.js +0 -155
- package/lib/openapi_contract.js +0 -300
- package/lib/operational_receipt_contract.js +0 -165
- package/lib/operator_intelligence.js +0 -407
- package/lib/outreach_copy_pack.js +0 -51
- package/lib/outreach_message_pack.js +0 -71
- package/lib/outreach_proof.js +0 -71
- package/lib/outreach_target_pack.js +0 -60
- package/lib/partner_intelligence.js +0 -105
- package/lib/payment_config.js +0 -257
- package/lib/payment_front_registry.js +0 -53
- package/lib/payment_protocol_contract.js +0 -165
- package/lib/payment_rail_truth_contract.js +0 -324
- package/lib/payment_verification.js +0 -357
- package/lib/phase_10_closeout_pack.js +0 -45
- package/lib/phase_10_completion_pack.js +0 -76
- package/lib/phase_10_decision_record_pack.js +0 -54
- package/lib/phase_10_decision_resolution_pack.js +0 -53
- package/lib/phase_10_demand_signal_adapters_runtime_pack.js +0 -74
- package/lib/phase_10_ecosystem_backlog_triage_runtime_pack.js +0 -74
- package/lib/phase_10_freeze_baseline_pack.js +0 -67
- package/lib/phase_10_freeze_review_pack.js +0 -64
- package/lib/phase_10_gate_pack.js +0 -57
- package/lib/phase_10_long_tail_continuity_pack.js +0 -80
- package/lib/phase_10_long_tail_ecosystem_pack.js +0 -66
- package/lib/phase_10_niche_extension_registry_runtime_pack.js +0 -74
- package/lib/phase_1_claude_mcp_pack.js +0 -60
- package/lib/phase_1_claude_mcp_runtime_pack.js +0 -52
- package/lib/phase_1_ecosystem_pack.js +0 -67
- package/lib/phase_1_openai_codex_pack.js +0 -60
- package/lib/phase_1_openai_codex_runtime_pack.js +0 -52
- package/lib/phase_2_base_runtime_pack.js +0 -71
- package/lib/phase_2_base_usdc_runtime_pack.js +0 -72
- package/lib/phase_2_closeout_pack.js +0 -65
- package/lib/phase_2_completion_pack.js +0 -113
- package/lib/phase_2_decision_record_pack.js +0 -66
- package/lib/phase_2_decision_resolution_pack.js +0 -69
- package/lib/phase_2_eth_runtime_pack.js +0 -70
- package/lib/phase_2_evm_base_runtime_pack.js +0 -73
- package/lib/phase_2_evm_runtime_pack.js +0 -71
- package/lib/phase_2_flip_preview_pack.js +0 -60
- package/lib/phase_2_freeze_review_pack.js +0 -99
- package/lib/phase_2_gate_pack.js +0 -77
- package/lib/phase_2_payment_rails_pack.js +0 -71
- package/lib/phase_2_usdc_runtime_pack.js +0 -71
- package/lib/phase_3_brc_runtime_pack.js +0 -81
- package/lib/phase_3_bsv_teranode_runtime_pack.js +0 -83
- package/lib/phase_3_closeout_pack.js +0 -62
- package/lib/phase_3_completion_pack.js +0 -94
- package/lib/phase_3_decision_record_pack.js +0 -64
- package/lib/phase_3_decision_resolution_pack.js +0 -69
- package/lib/phase_3_freeze_baseline_pack.js +0 -67
- package/lib/phase_3_freeze_review_pack.js +0 -80
- package/lib/phase_3_gate_pack.js +0 -76
- package/lib/phase_3_metanet_runtime_pack.js +0 -81
- package/lib/phase_3_native_bsv_pack.js +0 -91
- package/lib/phase_3_native_continuity_pack.js +0 -82
- package/lib/phase_4_attestation_runtime_pack.js +0 -75
- package/lib/phase_4_closeout_pack.js +0 -45
- package/lib/phase_4_completion_pack.js +0 -94
- package/lib/phase_4_decision_record_pack.js +0 -54
- package/lib/phase_4_decision_resolution_pack.js +0 -45
- package/lib/phase_4_erc8004_runtime_pack.js +0 -76
- package/lib/phase_4_freeze_baseline_pack.js +0 -67
- package/lib/phase_4_freeze_review_pack.js +0 -68
- package/lib/phase_4_gate_pack.js +0 -58
- package/lib/phase_4_identity_registry_runtime_pack.js +0 -75
- package/lib/phase_4_identity_trust_pack.js +0 -73
- package/lib/phase_4_trust_continuity_pack.js +0 -86
- package/lib/phase_5_antelope_runtime_pack.js +0 -76
- package/lib/phase_5_closeout_pack.js +0 -44
- package/lib/phase_5_completion_pack.js +0 -82
- package/lib/phase_5_constellation_dag_runtime_pack.js +0 -76
- package/lib/phase_5_decision_record_pack.js +0 -54
- package/lib/phase_5_decision_resolution_pack.js +0 -45
- package/lib/phase_5_digibyte_dgb_runtime_pack.js +0 -76
- package/lib/phase_5_freeze_baseline_pack.js +0 -67
- package/lib/phase_5_freeze_review_pack.js +0 -68
- package/lib/phase_5_gate_pack.js +0 -58
- package/lib/phase_5_hedera_hbar_runtime_pack.js +0 -76
- package/lib/phase_5_kaspa_kas_runtime_pack.js +0 -76
- package/lib/phase_5_major_rails_continuity_pack.js +0 -86
- package/lib/phase_5_major_rails_pack.js +0 -110
- package/lib/phase_5_metal_runtime_pack.js +0 -76
- package/lib/phase_5_polkadot_dot_runtime_pack.js +0 -76
- package/lib/phase_5_proton_xpr_runtime_pack.js +0 -76
- package/lib/phase_5_solana_runtime_pack.js +0 -76
- package/lib/phase_6_autogen_runtime_pack.js +0 -72
- package/lib/phase_6_closeout_pack.js +0 -46
- package/lib/phase_6_completion_pack.js +0 -77
- package/lib/phase_6_decision_record_pack.js +0 -54
- package/lib/phase_6_decision_resolution_pack.js +0 -53
- package/lib/phase_6_framework_continuity_pack.js +0 -81
- package/lib/phase_6_framework_runtime_pack.js +0 -68
- package/lib/phase_6_freeze_baseline_pack.js +0 -68
- package/lib/phase_6_freeze_review_pack.js +0 -65
- package/lib/phase_6_gate_pack.js +0 -59
- package/lib/phase_6_langchain_runtime_pack.js +0 -72
- package/lib/phase_6_langgraph_runtime_pack.js +0 -72
- package/lib/phase_6_semantic_kernel_runtime_pack.js +0 -72
- package/lib/phase_7_closeout_pack.js +0 -45
- package/lib/phase_7_completion_pack.js +0 -85
- package/lib/phase_7_decision_record_pack.js +0 -53
- package/lib/phase_7_decision_resolution_pack.js +0 -53
- package/lib/phase_7_event_system_continuity_pack.js +0 -89
- package/lib/phase_7_event_system_pack.js +0 -76
- package/lib/phase_7_freeze_baseline_pack.js +0 -74
- package/lib/phase_7_freeze_review_pack.js +0 -65
- package/lib/phase_7_gate_pack.js +0 -58
- package/lib/phase_7_kafka_runtime_pack.js +0 -74
- package/lib/phase_7_mqtt_runtime_pack.js +0 -74
- package/lib/phase_7_nats_runtime_pack.js +0 -74
- package/lib/phase_7_webhook_event_bus_runtime_pack.js +0 -74
- package/lib/phase_8_closeout_pack.js +0 -46
- package/lib/phase_8_completion_pack.js +0 -82
- package/lib/phase_8_decision_record_pack.js +0 -54
- package/lib/phase_8_decision_resolution_pack.js +0 -53
- package/lib/phase_8_external_receipt_import_runtime_pack.js +0 -74
- package/lib/phase_8_external_result_import_runtime_pack.js +0 -74
- package/lib/phase_8_freeze_baseline_pack.js +0 -71
- package/lib/phase_8_freeze_review_pack.js +0 -64
- package/lib/phase_8_gate_pack.js +0 -58
- package/lib/phase_8_proof_bridge_continuity_pack.js +0 -86
- package/lib/phase_8_proof_bridges_pack.js +0 -72
- package/lib/phase_8_proof_bundle_normalization_runtime_pack.js +0 -74
- package/lib/phase_9_closeout_pack.js +0 -46
- package/lib/phase_9_completion_pack.js +0 -82
- package/lib/phase_9_custody_refs_runtime_pack.js +0 -74
- package/lib/phase_9_decision_record_pack.js +0 -54
- package/lib/phase_9_decision_resolution_pack.js +0 -53
- package/lib/phase_9_freeze_baseline_pack.js +0 -71
- package/lib/phase_9_freeze_review_pack.js +0 -64
- package/lib/phase_9_gate_pack.js +0 -58
- package/lib/phase_9_operator_accounting_bridges_runtime_pack.js +0 -74
- package/lib/phase_9_treasury_connectivity_pack.js +0 -72
- package/lib/phase_9_treasury_continuity_pack.js +0 -86
- package/lib/phase_9_treasury_destinations_runtime_pack.js +0 -74
- package/lib/phase_program_pack.js +0 -120
- package/lib/pricing_optimization_contract.js +0 -775
- package/lib/protocol_lane_contract.js +0 -117
- package/lib/provenance_lane_contract.js +0 -54
- package/lib/provider_lane_contract.js +0 -240
- package/lib/provider_network_contract.js +0 -149
- package/lib/provider_payout_execution.js +0 -155
- package/lib/provider_registry.js +0 -852
- package/lib/provider_runtime_journey_contract.js +0 -183
- package/lib/public_surface_policy_contract.js +0 -111
- package/lib/publish_plan.js +0 -51
- package/lib/rate_limiter.js +0 -81
- package/lib/record_queries.js +0 -48
- package/lib/release_candidate.js +0 -50
- package/lib/release_center.js +0 -1093
- package/lib/release_history.js +0 -205
- package/lib/release_manifest.js +0 -113
- package/lib/release_pack.js +0 -453
- package/lib/request_rate_limit.js +0 -144
- package/lib/resource_views.js +0 -31
- package/lib/revenue_launch_path_contract.js +0 -326
- package/lib/route_matchers.js +0 -34
- package/lib/route_params.js +0 -19
- package/lib/runtime_bridge.js +0 -124
- package/lib/runtime_operations_worker.js +0 -282
- package/lib/runtime_state_store.js +0 -495
- package/lib/settlement_bsv_live.js +0 -600
- package/lib/settlement_bsv_teranode.js +0 -117
- package/lib/settlement_lane_contract.js +0 -111
- package/lib/shared_signals_lane_contract.js +0 -54
- package/lib/signed_audit_provenance_contract.js +0 -83
- package/lib/soft_launch_pack.js +0 -78
- package/lib/stablecoin_lane_contract.js +0 -76
- package/lib/stripe_mpp_lane_contract.js +0 -96
- package/lib/stripe_mpp_payment_front.js +0 -258
- package/lib/telemetry_lane_contract.js +0 -54
- package/lib/treasury_destinations_contract.js +0 -764
- package/lib/treasury_egress_policy_contract.js +0 -91
- package/lib/treasury_lane_contract.js +0 -84
- package/lib/trust_portability_boundary_contract.js +0 -72
- package/lib/x402_facilitator.js +0 -198
- package/lib/x402_lane_contract.js +0 -136
- package/lib/x402_settlement_recovery.js +0 -175
- package/scripts/buyer_events_daily_report.js +0 -79
- package/scripts/registry_cli.js +0 -275
- package/scripts/state_backup_offsite.js +0 -196
- package/scripts/verify_a2a_rpc.js +0 -131
- package/scripts/verify_adapters.js +0 -554
- package/scripts/verify_agent_identity.js +0 -153
- package/scripts/verify_all.js +0 -4963
- package/scripts/verify_bolt_adapter.js +0 -128
- package/scripts/verify_buyer_event_log.js +0 -128
- package/scripts/verify_buyer_safety.js +0 -141
- package/scripts/verify_cdp_facilitator.js +0 -110
- package/scripts/verify_checkout_processor.js +0 -109
- package/scripts/verify_commerce_bridge.js +0 -177
- package/scripts/verify_control_plane_contracts.js +0 -34
- package/scripts/verify_control_plane_routes.js +0 -70
- package/scripts/verify_delivery_summary.js +0 -112
- package/scripts/verify_examples.js +0 -19
- package/scripts/verify_execution_dedupe.js +0 -189
- package/scripts/verify_execution_surfacing.js +0 -76
- package/scripts/verify_external_execution_retry.js +0 -140
- package/scripts/verify_final_activation.js +0 -191
- package/scripts/verify_first_run_conversions.js +0 -81
- package/scripts/verify_framework_provider_promotion.js +0 -152
- package/scripts/verify_full_catalog.js +0 -174
- package/scripts/verify_integrations.js +0 -620
- package/scripts/verify_l402_adapter.js +0 -86
- package/scripts/verify_lifecycle_continuity.js +0 -96
- package/scripts/verify_lifecycle_spend_binding.js +0 -88
- package/scripts/verify_market_lane_depth.js +0 -94
- package/scripts/verify_market_lane_promotion.js +0 -103
- package/scripts/verify_market_lane_traces.js +0 -98
- package/scripts/verify_market_lanes.js +0 -102
- package/scripts/verify_mpp_adapter.js +0 -128
- package/scripts/verify_operator_observability_boundary.js +0 -83
- package/scripts/verify_pricing_experiment_plan.js +0 -124
- package/scripts/verify_production_readiness.js +0 -268
- package/scripts/verify_provider_network.js +0 -819
- package/scripts/verify_provider_runtime_breadth.js +0 -109
- package/scripts/verify_provider_runtime_journeys.js +0 -111
- package/scripts/verify_rate_limiter.js +0 -52
- package/scripts/verify_refund_credit.js +0 -106
- package/scripts/verify_revenue_launch_paths.js +0 -105
- package/scripts/verify_runtime_durability.js +0 -52
- package/scripts/verify_runtime_state_guard.js +0 -117
- package/scripts/verify_service.js +0 -15421
- package/scripts/verify_settlement.js +0 -116
- package/scripts/verify_tooling.js +0 -1412
- package/scripts/verify_treasury_public_boundary.js +0 -97
- package/scripts/verify_verify_execute_settle.js +0 -209
- package/scripts/verify_x402_facilitator.js +0 -307
- package/scripts/verify_x402_settlement_recovery.js +0 -153
- package/server.js +0 -12245
|
@@ -1,193 +0,0 @@
|
|
|
1
|
-
"use strict";
|
|
2
|
-
|
|
3
|
-
const FAMILY_DEFINITIONS = Object.freeze([
|
|
4
|
-
{ family_id: "identity", label: "identity" },
|
|
5
|
-
{ family_id: "discovery", label: "discovery" },
|
|
6
|
-
{ family_id: "negotiation", label: "negotiation" },
|
|
7
|
-
{ family_id: "invocation", label: "invocation" },
|
|
8
|
-
{ family_id: "sessions_messaging", label: "sessions/messaging" },
|
|
9
|
-
{ family_id: "payments_metering", label: "payments/metering" },
|
|
10
|
-
{ family_id: "delivery", label: "delivery" },
|
|
11
|
-
{ family_id: "disputes", label: "disputes" },
|
|
12
|
-
{ family_id: "anchoring_finality", label: "anchoring/finality" }
|
|
13
|
-
]);
|
|
14
|
-
|
|
15
|
-
const LIFECYCLE_STAGE_DEFINITIONS = Object.freeze([
|
|
16
|
-
{ lifecycle_stage: "discover", label: "discover" },
|
|
17
|
-
{ lifecycle_stage: "negotiate", label: "negotiate" },
|
|
18
|
-
{ lifecycle_stage: "quote_commit", label: "quote/commit" },
|
|
19
|
-
{ lifecycle_stage: "invoke", label: "invoke" },
|
|
20
|
-
{ lifecycle_stage: "session_send_close", label: "session/send/close" },
|
|
21
|
-
{ lifecycle_stage: "meter", label: "meter" },
|
|
22
|
-
{ lifecycle_stage: "deliver", label: "deliver" },
|
|
23
|
-
{ lifecycle_stage: "settlement_intent", label: "settlement-intent" },
|
|
24
|
-
{ lifecycle_stage: "settle_reconcile", label: "settle/reconcile" },
|
|
25
|
-
{ lifecycle_stage: "anchor", label: "anchor" },
|
|
26
|
-
{ lifecycle_stage: "dispute_open", label: "dispute-open" },
|
|
27
|
-
{ lifecycle_stage: "dispute_fetch", label: "dispute-fetch" },
|
|
28
|
-
{ lifecycle_stage: "verify", label: "verify" }
|
|
29
|
-
]);
|
|
30
|
-
|
|
31
|
-
const MARKET_CLASS_DEFINITIONS = Object.freeze([
|
|
32
|
-
{ market_class: "compute", label: "compute" },
|
|
33
|
-
{ market_class: "data", label: "data" },
|
|
34
|
-
{ market_class: "storage", label: "storage" },
|
|
35
|
-
{ market_class: "messaging", label: "messaging" },
|
|
36
|
-
{ market_class: "device_robotics", label: "device/robotics" },
|
|
37
|
-
{ market_class: "treasury_payments", label: "treasury/payments" }
|
|
38
|
-
]);
|
|
39
|
-
|
|
40
|
-
function mapCategoryDefaults(publicCategory) {
|
|
41
|
-
switch (String(publicCategory || "").trim()) {
|
|
42
|
-
case "trust":
|
|
43
|
-
return { task_family: "identity", lifecycle_stage: "verify", market_class: "data" };
|
|
44
|
-
case "receipt":
|
|
45
|
-
return { task_family: "delivery", lifecycle_stage: "verify", market_class: "data" };
|
|
46
|
-
case "runtime":
|
|
47
|
-
return { task_family: "delivery", lifecycle_stage: "deliver", market_class: "compute" };
|
|
48
|
-
case "jobs":
|
|
49
|
-
return { task_family: "invocation", lifecycle_stage: "quote_commit", market_class: "compute" };
|
|
50
|
-
case "credits":
|
|
51
|
-
return { task_family: "payments_metering", lifecycle_stage: "meter", market_class: "treasury_payments" };
|
|
52
|
-
case "a2a":
|
|
53
|
-
return { task_family: "negotiation", lifecycle_stage: "negotiate", market_class: "messaging" };
|
|
54
|
-
case "a2c":
|
|
55
|
-
return { task_family: "sessions_messaging", lifecycle_stage: "session_send_close", market_class: "messaging" };
|
|
56
|
-
case "policy":
|
|
57
|
-
return { task_family: "payments_metering", lifecycle_stage: "settlement_intent", market_class: "treasury_payments" };
|
|
58
|
-
case "identity":
|
|
59
|
-
return { task_family: "identity", lifecycle_stage: "verify", market_class: "data" };
|
|
60
|
-
case "registry":
|
|
61
|
-
return { task_family: "identity", lifecycle_stage: "deliver", market_class: "storage" };
|
|
62
|
-
case "anchoring":
|
|
63
|
-
return { task_family: "anchoring_finality", lifecycle_stage: "anchor", market_class: "storage" };
|
|
64
|
-
case "discovery":
|
|
65
|
-
return { task_family: "discovery", lifecycle_stage: "discover", market_class: "data" };
|
|
66
|
-
case "admission":
|
|
67
|
-
return { task_family: "negotiation", lifecycle_stage: "settlement_intent", market_class: "treasury_payments" };
|
|
68
|
-
case "settlement":
|
|
69
|
-
return { task_family: "payments_metering", lifecycle_stage: "settle_reconcile", market_class: "treasury_payments" };
|
|
70
|
-
case "adapter":
|
|
71
|
-
return { task_family: "invocation", lifecycle_stage: "invoke", market_class: "compute" };
|
|
72
|
-
default:
|
|
73
|
-
return { task_family: "discovery", lifecycle_stage: "discover", market_class: "data" };
|
|
74
|
-
}
|
|
75
|
-
}
|
|
76
|
-
|
|
77
|
-
function decorateTaskMetadata(definition = {}) {
|
|
78
|
-
const defaults = mapCategoryDefaults(definition.public_category);
|
|
79
|
-
const publicTaskRef = String(definition.public_task_ref || "").trim();
|
|
80
|
-
let task_family = defaults.task_family;
|
|
81
|
-
let lifecycle_stage = defaults.lifecycle_stage;
|
|
82
|
-
let market_class = defaults.market_class;
|
|
83
|
-
let claim_status = "bounded_live";
|
|
84
|
-
let evidence_status = "first_party_runtime";
|
|
85
|
-
|
|
86
|
-
switch (publicTaskRef) {
|
|
87
|
-
case "trust.handoff.emit":
|
|
88
|
-
case "execution_receipt.handoff.emit":
|
|
89
|
-
case "receipt_ledger.handoff.emit":
|
|
90
|
-
case "identity.registry.link":
|
|
91
|
-
case "registry.pack.bundle":
|
|
92
|
-
case "jobs.release":
|
|
93
|
-
lifecycle_stage = "deliver";
|
|
94
|
-
evidence_status = "proof_handoff_ready";
|
|
95
|
-
break;
|
|
96
|
-
case "trust.handoff.validate":
|
|
97
|
-
case "execution_receipt.handoff.validate":
|
|
98
|
-
case "receipt_ledger.handoff.validate":
|
|
99
|
-
case "receipt.validate":
|
|
100
|
-
lifecycle_stage = "verify";
|
|
101
|
-
break;
|
|
102
|
-
case "runtime.anchor":
|
|
103
|
-
case "runtime.emit_anchor":
|
|
104
|
-
task_family = "anchoring_finality";
|
|
105
|
-
lifecycle_stage = "anchor";
|
|
106
|
-
break;
|
|
107
|
-
case "jobs.quote":
|
|
108
|
-
lifecycle_stage = "quote_commit";
|
|
109
|
-
break;
|
|
110
|
-
case "jobs.reserve":
|
|
111
|
-
case "jobs.commit":
|
|
112
|
-
task_family = "invocation";
|
|
113
|
-
lifecycle_stage = "quote_commit";
|
|
114
|
-
break;
|
|
115
|
-
case "credits.apply":
|
|
116
|
-
lifecycle_stage = "settle_reconcile";
|
|
117
|
-
evidence_status = "first_party_ledger";
|
|
118
|
-
break;
|
|
119
|
-
case "a2a.commit":
|
|
120
|
-
lifecycle_stage = "quote_commit";
|
|
121
|
-
break;
|
|
122
|
-
case "policy.simulate":
|
|
123
|
-
case "admission.preview":
|
|
124
|
-
lifecycle_stage = "settlement_intent";
|
|
125
|
-
evidence_status = "first_party_policy_preview";
|
|
126
|
-
break;
|
|
127
|
-
case "settlement.submit":
|
|
128
|
-
lifecycle_stage = "settle_reconcile";
|
|
129
|
-
evidence_status = "first_party_settlement";
|
|
130
|
-
break;
|
|
131
|
-
case "adapter.mcp.invoke":
|
|
132
|
-
case "adapter.mcp.catalog":
|
|
133
|
-
case "adapter.mcp.reply.draft":
|
|
134
|
-
case "adapter.mcp.json.validate":
|
|
135
|
-
claim_status = "live";
|
|
136
|
-
evidence_status = "provider_live";
|
|
137
|
-
break;
|
|
138
|
-
default:
|
|
139
|
-
break;
|
|
140
|
-
}
|
|
141
|
-
|
|
142
|
-
return {
|
|
143
|
-
task_family,
|
|
144
|
-
lifecycle_stage,
|
|
145
|
-
market_class,
|
|
146
|
-
claim_status,
|
|
147
|
-
evidence_status
|
|
148
|
-
};
|
|
149
|
-
}
|
|
150
|
-
|
|
151
|
-
function decorateAdapterMetadata(adapterId) {
|
|
152
|
-
switch (String(adapterId || "").trim()) {
|
|
153
|
-
case "mcp":
|
|
154
|
-
return {
|
|
155
|
-
task_family: "invocation",
|
|
156
|
-
lifecycle_stage: "invoke",
|
|
157
|
-
market_class: "compute",
|
|
158
|
-
claim_status: "live",
|
|
159
|
-
evidence_status: "provider_live"
|
|
160
|
-
};
|
|
161
|
-
case "chain":
|
|
162
|
-
return {
|
|
163
|
-
task_family: "payments_metering",
|
|
164
|
-
lifecycle_stage: "settle_reconcile",
|
|
165
|
-
market_class: "treasury_payments",
|
|
166
|
-
claim_status: "bounded_live",
|
|
167
|
-
evidence_status: "first_party_settlement"
|
|
168
|
-
};
|
|
169
|
-
case "http":
|
|
170
|
-
default:
|
|
171
|
-
return {
|
|
172
|
-
task_family: "discovery",
|
|
173
|
-
lifecycle_stage: "discover",
|
|
174
|
-
market_class: "data",
|
|
175
|
-
claim_status: "bounded_live",
|
|
176
|
-
evidence_status: "first_party_runtime"
|
|
177
|
-
};
|
|
178
|
-
}
|
|
179
|
-
}
|
|
180
|
-
|
|
181
|
-
function definitionLabel(definitions, field, value) {
|
|
182
|
-
const entry = definitions.find((item) => item[field] === value);
|
|
183
|
-
return entry ? entry.label : value;
|
|
184
|
-
}
|
|
185
|
-
|
|
186
|
-
module.exports = {
|
|
187
|
-
FAMILY_DEFINITIONS,
|
|
188
|
-
LIFECYCLE_STAGE_DEFINITIONS,
|
|
189
|
-
MARKET_CLASS_DEFINITIONS,
|
|
190
|
-
decorateAdapterMetadata,
|
|
191
|
-
decorateTaskMetadata,
|
|
192
|
-
definitionLabel
|
|
193
|
-
};
|
package/lib/catalog_views.js
DELETED
|
@@ -1,55 +0,0 @@
|
|
|
1
|
-
"use strict";
|
|
2
|
-
|
|
3
|
-
const { buildMissingResponse } = require("./resource_views");
|
|
4
|
-
|
|
5
|
-
function buildTaskDetailResponse(task) {
|
|
6
|
-
if (!task) {
|
|
7
|
-
return buildMissingResponse("task_not_found");
|
|
8
|
-
}
|
|
9
|
-
return {
|
|
10
|
-
status: 200,
|
|
11
|
-
payload: { ok: true, task }
|
|
12
|
-
};
|
|
13
|
-
}
|
|
14
|
-
|
|
15
|
-
function buildWorkflowListResponse(workflows) {
|
|
16
|
-
return {
|
|
17
|
-
status: 200,
|
|
18
|
-
payload: { ok: true, workflows }
|
|
19
|
-
};
|
|
20
|
-
}
|
|
21
|
-
|
|
22
|
-
function buildWorkflowDetailResponse(workflow) {
|
|
23
|
-
if (!workflow) {
|
|
24
|
-
return buildMissingResponse("workflow_not_found");
|
|
25
|
-
}
|
|
26
|
-
return {
|
|
27
|
-
status: 200,
|
|
28
|
-
payload: { ok: true, workflow }
|
|
29
|
-
};
|
|
30
|
-
}
|
|
31
|
-
|
|
32
|
-
function buildCreditPackListResponse(creditPacks) {
|
|
33
|
-
return {
|
|
34
|
-
status: 200,
|
|
35
|
-
payload: { ok: true, credit_packs: creditPacks }
|
|
36
|
-
};
|
|
37
|
-
}
|
|
38
|
-
|
|
39
|
-
function buildCreditPackDetailResponse(creditPack) {
|
|
40
|
-
if (!creditPack) {
|
|
41
|
-
return buildMissingResponse("credit_pack_not_found");
|
|
42
|
-
}
|
|
43
|
-
return {
|
|
44
|
-
status: 200,
|
|
45
|
-
payload: { ok: true, credit_pack: creditPack }
|
|
46
|
-
};
|
|
47
|
-
}
|
|
48
|
-
|
|
49
|
-
module.exports = {
|
|
50
|
-
buildCreditPackDetailResponse,
|
|
51
|
-
buildCreditPackListResponse,
|
|
52
|
-
buildTaskDetailResponse,
|
|
53
|
-
buildWorkflowDetailResponse,
|
|
54
|
-
buildWorkflowListResponse
|
|
55
|
-
};
|
package/lib/cdp_jwt.js
DELETED
|
@@ -1,57 +0,0 @@
|
|
|
1
|
-
"use strict";
|
|
2
|
-
|
|
3
|
-
// Zero-dependency Coinbase CDP Bearer JWT signer, used to authenticate requests to the
|
|
4
|
-
// CDP-hosted x402 facilitator (https://api.cdp.coinbase.com/platform/v2/x402), which
|
|
5
|
-
// settles Base mainnet. CDP authenticates each request with a short-lived (<=120s) EdDSA
|
|
6
|
-
// (Ed25519) JWT generated from a CDP Secret API Key, so a static Authorization header is
|
|
7
|
-
// not usable; a fresh token is minted per request with a `uri` claim bound to that request.
|
|
8
|
-
//
|
|
9
|
-
// Secret format: base64-encoded Ed25519, 64 bytes (first 32 = seed, last 32 = public key).
|
|
10
|
-
// Reference: https://docs.cdp.coinbase.com/get-started/docs/cdp-api-keys
|
|
11
|
-
|
|
12
|
-
const crypto = require("crypto");
|
|
13
|
-
|
|
14
|
-
// DER PKCS#8 prefix for an Ed25519 private key carrying a 32-byte seed.
|
|
15
|
-
const ED25519_PKCS8_PREFIX = Buffer.from("302e020100300506032b657004220420", "hex");
|
|
16
|
-
|
|
17
|
-
function base64url(input) {
|
|
18
|
-
const buf = Buffer.isBuffer(input) ? input : Buffer.from(input);
|
|
19
|
-
return buf.toString("base64").replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
|
|
20
|
-
}
|
|
21
|
-
|
|
22
|
-
function privateKeyFromSecret(keySecret) {
|
|
23
|
-
const decoded = Buffer.from(String(keySecret || "").trim(), "base64");
|
|
24
|
-
if (decoded.length !== 64) {
|
|
25
|
-
throw new Error("cdp_key_secret_invalid: expected a base64 Ed25519 key of 64 bytes");
|
|
26
|
-
}
|
|
27
|
-
const seed = decoded.subarray(0, 32);
|
|
28
|
-
const pkcs8 = Buffer.concat([ED25519_PKCS8_PREFIX, seed]);
|
|
29
|
-
return crypto.createPrivateKey({ key: pkcs8, format: "der", type: "pkcs8" });
|
|
30
|
-
}
|
|
31
|
-
|
|
32
|
-
// Build a CDP Bearer JWT for a single request.
|
|
33
|
-
// keyId CDP API key id (UUID)
|
|
34
|
-
// keySecret base64 Ed25519 secret (64 bytes)
|
|
35
|
-
// method HTTP method, e.g. "POST"
|
|
36
|
-
// host request host, e.g. "api.cdp.coinbase.com"
|
|
37
|
-
// path request path, e.g. "/platform/v2/x402/verify"
|
|
38
|
-
function buildCdpBearerToken({ keyId, keySecret, method, host, path }) {
|
|
39
|
-
const id = String(keyId || "").trim();
|
|
40
|
-
if (!id) throw new Error("cdp_key_id_missing");
|
|
41
|
-
const privateKey = privateKeyFromSecret(keySecret);
|
|
42
|
-
const now = Math.floor(Date.now() / 1000);
|
|
43
|
-
const header = { alg: "EdDSA", typ: "JWT", kid: id, nonce: crypto.randomBytes(16).toString("hex") };
|
|
44
|
-
const claims = {
|
|
45
|
-
sub: id,
|
|
46
|
-
iss: "cdp",
|
|
47
|
-
aud: ["cdp_service"],
|
|
48
|
-
nbf: now,
|
|
49
|
-
exp: now + 120,
|
|
50
|
-
uri: `${String(method || "POST").toUpperCase()} ${host}${path}`
|
|
51
|
-
};
|
|
52
|
-
const signingInput = `${base64url(JSON.stringify(header))}.${base64url(JSON.stringify(claims))}`;
|
|
53
|
-
const signature = crypto.sign(null, Buffer.from(signingInput), privateKey);
|
|
54
|
-
return `${signingInput}.${base64url(signature)}`;
|
|
55
|
-
}
|
|
56
|
-
|
|
57
|
-
module.exports = { buildCdpBearerToken, base64url };
|
|
@@ -1,142 +0,0 @@
|
|
|
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 parseBoolean(value, fallback) {
|
|
10
|
-
const normalized = normalizeString(value).toLowerCase();
|
|
11
|
-
if (!normalized) return fallback;
|
|
12
|
-
if (["1", "true", "yes", "on"].includes(normalized)) return true;
|
|
13
|
-
if (["0", "false", "no", "off"].includes(normalized)) return false;
|
|
14
|
-
return fallback;
|
|
15
|
-
}
|
|
16
|
-
|
|
17
|
-
function safeEqualHex(left, right) {
|
|
18
|
-
const leftNormalized = normalizeString(left).toLowerCase();
|
|
19
|
-
const rightNormalized = normalizeString(right).toLowerCase();
|
|
20
|
-
if (!leftNormalized || !rightNormalized || leftNormalized.length !== rightNormalized.length) return false;
|
|
21
|
-
try {
|
|
22
|
-
return crypto.timingSafeEqual(Buffer.from(leftNormalized, "hex"), Buffer.from(rightNormalized, "hex"));
|
|
23
|
-
} catch (_error) {
|
|
24
|
-
return false;
|
|
25
|
-
}
|
|
26
|
-
}
|
|
27
|
-
|
|
28
|
-
function loadCheckoutEventSecurityConfig() {
|
|
29
|
-
const secret = normalizeString(process.env.XYTARA_CHECKOUT_WEBHOOK_SECRET || process.env.XYTARA_HOSTED_CHECKOUT_WEBHOOK_SECRET);
|
|
30
|
-
const verificationRequired = parseBoolean(
|
|
31
|
-
process.env.XYTARA_CHECKOUT_WEBHOOK_VERIFICATION_REQUIRED,
|
|
32
|
-
secret.length > 0
|
|
33
|
-
);
|
|
34
|
-
const maxAgeSeconds = Math.max(30, Number(process.env.XYTARA_CHECKOUT_WEBHOOK_MAX_AGE_SECONDS || 300) || 300);
|
|
35
|
-
return {
|
|
36
|
-
secret: secret || null,
|
|
37
|
-
verification_required: verificationRequired,
|
|
38
|
-
max_age_seconds: maxAgeSeconds,
|
|
39
|
-
signature_header: "x-xytara-checkout-signature",
|
|
40
|
-
timestamp_header: "x-xytara-checkout-timestamp",
|
|
41
|
-
signature_mode: "hmac_sha256_timestamped"
|
|
42
|
-
};
|
|
43
|
-
}
|
|
44
|
-
|
|
45
|
-
function buildCheckoutEventSecuritySummary() {
|
|
46
|
-
const config = loadCheckoutEventSecurityConfig();
|
|
47
|
-
const blockers = [];
|
|
48
|
-
if (config.verification_required && !config.secret) blockers.push("checkout_webhook_secret_missing");
|
|
49
|
-
return {
|
|
50
|
-
ok: true,
|
|
51
|
-
category: "machine-commerce-checkout-event-security-summary",
|
|
52
|
-
summary_version: "xytara-checkout-event-security-summary-v1",
|
|
53
|
-
verification_required: config.verification_required,
|
|
54
|
-
secret_configured: Boolean(config.secret),
|
|
55
|
-
max_age_seconds: config.max_age_seconds,
|
|
56
|
-
signature_header: config.signature_header,
|
|
57
|
-
timestamp_header: config.timestamp_header,
|
|
58
|
-
signature_mode: config.signature_mode,
|
|
59
|
-
ready: Boolean(config.secret),
|
|
60
|
-
blockers,
|
|
61
|
-
operator_guidance: config.verification_required
|
|
62
|
-
? "sign checkout event payloads with the configured webhook secret before forwarding them into xytara"
|
|
63
|
-
: "configure XYTARA_CHECKOUT_WEBHOOK_SECRET and keep verification required when hosted checkout is live"
|
|
64
|
-
};
|
|
65
|
-
}
|
|
66
|
-
|
|
67
|
-
function buildCheckoutEventSignature(rawBody, secret, timestamp) {
|
|
68
|
-
return crypto.createHmac("sha256", secret).update(`${timestamp}.${rawBody}`).digest("hex");
|
|
69
|
-
}
|
|
70
|
-
|
|
71
|
-
function verifyCheckoutEventRequest(headers, rawBody) {
|
|
72
|
-
const config = loadCheckoutEventSecurityConfig();
|
|
73
|
-
const headerMap = headers && typeof headers === "object" ? headers : {};
|
|
74
|
-
const signature = normalizeString(headerMap[config.signature_header]);
|
|
75
|
-
const timestamp = normalizeString(headerMap[config.timestamp_header]);
|
|
76
|
-
|
|
77
|
-
if (!config.verification_required && !config.secret) {
|
|
78
|
-
return {
|
|
79
|
-
ok: true,
|
|
80
|
-
verification_mode: "verification_not_required",
|
|
81
|
-
signature_mode: config.signature_mode
|
|
82
|
-
};
|
|
83
|
-
}
|
|
84
|
-
|
|
85
|
-
if (!config.secret) {
|
|
86
|
-
return {
|
|
87
|
-
ok: false,
|
|
88
|
-
reason: "checkout_webhook_secret_missing"
|
|
89
|
-
};
|
|
90
|
-
}
|
|
91
|
-
|
|
92
|
-
if (!signature) {
|
|
93
|
-
return {
|
|
94
|
-
ok: false,
|
|
95
|
-
reason: "checkout_webhook_signature_missing"
|
|
96
|
-
};
|
|
97
|
-
}
|
|
98
|
-
|
|
99
|
-
if (!timestamp) {
|
|
100
|
-
return {
|
|
101
|
-
ok: false,
|
|
102
|
-
reason: "checkout_webhook_timestamp_missing"
|
|
103
|
-
};
|
|
104
|
-
}
|
|
105
|
-
|
|
106
|
-
const timestampMs = Date.parse(timestamp);
|
|
107
|
-
if (!Number.isFinite(timestampMs)) {
|
|
108
|
-
return {
|
|
109
|
-
ok: false,
|
|
110
|
-
reason: "checkout_webhook_timestamp_invalid"
|
|
111
|
-
};
|
|
112
|
-
}
|
|
113
|
-
|
|
114
|
-
const ageSeconds = Math.abs(Date.now() - timestampMs) / 1000;
|
|
115
|
-
if (ageSeconds > config.max_age_seconds) {
|
|
116
|
-
return {
|
|
117
|
-
ok: false,
|
|
118
|
-
reason: "checkout_webhook_timestamp_expired"
|
|
119
|
-
};
|
|
120
|
-
}
|
|
121
|
-
|
|
122
|
-
const expected = buildCheckoutEventSignature(rawBody, config.secret, timestamp);
|
|
123
|
-
if (!safeEqualHex(expected, signature)) {
|
|
124
|
-
return {
|
|
125
|
-
ok: false,
|
|
126
|
-
reason: "checkout_webhook_signature_invalid"
|
|
127
|
-
};
|
|
128
|
-
}
|
|
129
|
-
|
|
130
|
-
return {
|
|
131
|
-
ok: true,
|
|
132
|
-
verification_mode: "timestamped_hmac",
|
|
133
|
-
signature_mode: config.signature_mode
|
|
134
|
-
};
|
|
135
|
-
}
|
|
136
|
-
|
|
137
|
-
module.exports = {
|
|
138
|
-
buildCheckoutEventSecuritySummary,
|
|
139
|
-
buildCheckoutEventSignature,
|
|
140
|
-
loadCheckoutEventSecurityConfig,
|
|
141
|
-
verifyCheckoutEventRequest
|
|
142
|
-
};
|
|
@@ -1,217 +0,0 @@
|
|
|
1
|
-
"use strict";
|
|
2
|
-
|
|
3
|
-
// Provider-agnostic hosted-checkout processor adapter (fiat money-in).
|
|
4
|
-
//
|
|
5
|
-
// Turns the synthetic hosted-checkout scaffold into a real fiat rail WITHOUT
|
|
6
|
-
// provider lock-in and WITHOUT changing existing behavior: it engages only when
|
|
7
|
-
// env configures a processor. When unconfigured, every function reports
|
|
8
|
-
// "not configured" and the caller preserves the current synthetic flow.
|
|
9
|
-
//
|
|
10
|
-
// First provider: Stripe (Checkout Sessions + webhooks). Dependency-free
|
|
11
|
-
// (node https + crypto). To add another processor, extend the provider
|
|
12
|
-
// switches below; nothing else changes.
|
|
13
|
-
//
|
|
14
|
-
// Env:
|
|
15
|
-
// XYTARA_CHECKOUT_PROCESSOR = "stripe" (unset/empty => not configured)
|
|
16
|
-
// STRIPE_SECRET_KEY, STRIPE_WEBHOOK_SECRET
|
|
17
|
-
// XYTARA_CHECKOUT_SUCCESS_URL, XYTARA_CHECKOUT_CANCEL_URL
|
|
18
|
-
// XYTARA_CHECKOUT_PRODUCT_NAME (optional), STRIPE_WEBHOOK_TOLERANCE_SECONDS (optional)
|
|
19
|
-
|
|
20
|
-
const https = require("https");
|
|
21
|
-
const crypto = require("crypto");
|
|
22
|
-
|
|
23
|
-
function env(name) {
|
|
24
|
-
const v = process.env[name];
|
|
25
|
-
return typeof v === "string" && v.trim() ? v.trim() : "";
|
|
26
|
-
}
|
|
27
|
-
|
|
28
|
-
function loadCheckoutProcessorConfig() {
|
|
29
|
-
const provider = env("XYTARA_CHECKOUT_PROCESSOR").toLowerCase();
|
|
30
|
-
if (provider === "stripe") {
|
|
31
|
-
return {
|
|
32
|
-
provider: "stripe",
|
|
33
|
-
secretKey: env("STRIPE_SECRET_KEY"),
|
|
34
|
-
webhookSecret: env("STRIPE_WEBHOOK_SECRET"),
|
|
35
|
-
successUrl: env("XYTARA_CHECKOUT_SUCCESS_URL") || env("STRIPE_SUCCESS_URL"),
|
|
36
|
-
cancelUrl: env("XYTARA_CHECKOUT_CANCEL_URL") || env("STRIPE_CANCEL_URL"),
|
|
37
|
-
productName: env("XYTARA_CHECKOUT_PRODUCT_NAME") || "naxytra runtime credits",
|
|
38
|
-
webhookToleranceSeconds: Math.max(60, Number(env("STRIPE_WEBHOOK_TOLERANCE_SECONDS") || 300) || 300)
|
|
39
|
-
};
|
|
40
|
-
}
|
|
41
|
-
return { provider: null };
|
|
42
|
-
}
|
|
43
|
-
|
|
44
|
-
function isConfigured(config) {
|
|
45
|
-
return Boolean(config && config.provider);
|
|
46
|
-
}
|
|
47
|
-
|
|
48
|
-
function normalizeCurrency(currency) {
|
|
49
|
-
const c = String(currency || "usd").toLowerCase();
|
|
50
|
-
// The runtime books some prices as USD_CENTS; the minor-unit amount is already
|
|
51
|
-
// in cents, so the processor currency is plain "usd".
|
|
52
|
-
return c === "usd_cents" ? "usd" : c;
|
|
53
|
-
}
|
|
54
|
-
|
|
55
|
-
// Minimal form-encoded POST to Stripe. Resolves { status, json, raw }.
|
|
56
|
-
function stripePost(path, formParams, secretKey, timeoutMs) {
|
|
57
|
-
const body = new URLSearchParams(formParams).toString();
|
|
58
|
-
return new Promise((resolve, reject) => {
|
|
59
|
-
const req = https.request(
|
|
60
|
-
{
|
|
61
|
-
method: "POST",
|
|
62
|
-
hostname: "api.stripe.com",
|
|
63
|
-
path,
|
|
64
|
-
headers: {
|
|
65
|
-
Authorization: "Bearer " + secretKey,
|
|
66
|
-
"Content-Type": "application/x-www-form-urlencoded",
|
|
67
|
-
"Content-Length": Buffer.byteLength(body)
|
|
68
|
-
}
|
|
69
|
-
},
|
|
70
|
-
(res) => {
|
|
71
|
-
let data = "";
|
|
72
|
-
res.on("data", (chunk) => {
|
|
73
|
-
data += chunk;
|
|
74
|
-
});
|
|
75
|
-
res.on("end", () => {
|
|
76
|
-
let json = null;
|
|
77
|
-
try {
|
|
78
|
-
json = data ? JSON.parse(data) : null;
|
|
79
|
-
} catch (_) {
|
|
80
|
-
json = null;
|
|
81
|
-
}
|
|
82
|
-
resolve({ status: res.statusCode, json, raw: data });
|
|
83
|
-
});
|
|
84
|
-
}
|
|
85
|
-
);
|
|
86
|
-
req.on("error", reject);
|
|
87
|
-
req.setTimeout(timeoutMs || 15000, () => {
|
|
88
|
-
req.destroy(new Error("stripe_request_timeout"));
|
|
89
|
-
});
|
|
90
|
-
req.write(body);
|
|
91
|
-
req.end();
|
|
92
|
-
});
|
|
93
|
-
}
|
|
94
|
-
|
|
95
|
-
// Create a real processor checkout session for a purchase intent.
|
|
96
|
-
// `intent` = { amountMinor, currency, units, accountId, purchaseIntentId, successUrl?, cancelUrl? }
|
|
97
|
-
// Returns { ok, checkout_url, checkout_reference, checkout_provider } | { ok:false, reason, detail? }.
|
|
98
|
-
async function createProcessorCheckoutSession(config, intent) {
|
|
99
|
-
if (!isConfigured(config)) return { ok: false, reason: "processor_not_configured" };
|
|
100
|
-
if (config.provider === "stripe") {
|
|
101
|
-
if (!config.secretKey) return { ok: false, reason: "stripe_secret_key_missing" };
|
|
102
|
-
const amountMinor = Number(intent && intent.amountMinor);
|
|
103
|
-
if (!Number.isFinite(amountMinor) || amountMinor <= 0) return { ok: false, reason: "invalid_amount" };
|
|
104
|
-
const successUrl = (intent && intent.successUrl) || config.successUrl;
|
|
105
|
-
const cancelUrl = (intent && intent.cancelUrl) || config.cancelUrl;
|
|
106
|
-
if (!successUrl || !cancelUrl) return { ok: false, reason: "success_or_cancel_url_missing" };
|
|
107
|
-
const params = {
|
|
108
|
-
mode: "payment",
|
|
109
|
-
success_url: successUrl,
|
|
110
|
-
cancel_url: cancelUrl,
|
|
111
|
-
"line_items[0][quantity]": "1",
|
|
112
|
-
"line_items[0][price_data][currency]": normalizeCurrency(intent.currency),
|
|
113
|
-
"line_items[0][price_data][unit_amount]": String(Math.round(amountMinor)),
|
|
114
|
-
"line_items[0][price_data][product_data][name]": config.productName,
|
|
115
|
-
"metadata[purchase_intent_id]": String((intent && intent.purchaseIntentId) || ""),
|
|
116
|
-
"metadata[account_id]": String((intent && intent.accountId) || ""),
|
|
117
|
-
"metadata[credits_units]": String((intent && intent.units) || "")
|
|
118
|
-
};
|
|
119
|
-
let res;
|
|
120
|
-
try {
|
|
121
|
-
res = await stripePost("/v1/checkout/sessions", params, config.secretKey, 15000);
|
|
122
|
-
} catch (e) {
|
|
123
|
-
return { ok: false, reason: "stripe_unreachable", detail: e && e.message ? e.message : "request_error" };
|
|
124
|
-
}
|
|
125
|
-
if (!res.json || res.status >= 400) {
|
|
126
|
-
const detail = res.json && res.json.error ? res.json.error.message : `HTTP ${res.status}`;
|
|
127
|
-
return { ok: false, reason: "stripe_session_create_failed", detail };
|
|
128
|
-
}
|
|
129
|
-
return { ok: true, checkout_url: res.json.url, checkout_reference: res.json.id, checkout_provider: "stripe" };
|
|
130
|
-
}
|
|
131
|
-
return { ok: false, reason: "unsupported_processor" };
|
|
132
|
-
}
|
|
133
|
-
|
|
134
|
-
// Verify a processor webhook request. Returns { ok, event } | { ok:false, reason }.
|
|
135
|
-
// Uses the PROCESSOR's own signature scheme (Stripe: Stripe-Signature "t=,v1=").
|
|
136
|
-
function verifyProcessorWebhook(config, headers, rawBody) {
|
|
137
|
-
if (!isConfigured(config)) return { ok: false, reason: "processor_not_configured" };
|
|
138
|
-
if (config.provider === "stripe") {
|
|
139
|
-
if (!config.webhookSecret) return { ok: false, reason: "stripe_webhook_secret_missing" };
|
|
140
|
-
const lower = {};
|
|
141
|
-
for (const k in headers || {}) lower[k.toLowerCase()] = headers[k];
|
|
142
|
-
const sigHeader = String(lower["stripe-signature"] || "");
|
|
143
|
-
const parts = {};
|
|
144
|
-
sigHeader.split(",").forEach((piece) => {
|
|
145
|
-
const idx = piece.indexOf("=");
|
|
146
|
-
if (idx === -1) return;
|
|
147
|
-
const k = piece.slice(0, idx).trim();
|
|
148
|
-
const v = piece.slice(idx + 1).trim();
|
|
149
|
-
(parts[k] = parts[k] || []).push(v);
|
|
150
|
-
});
|
|
151
|
-
const t = parts.t && parts.t[0];
|
|
152
|
-
const v1s = parts.v1 || [];
|
|
153
|
-
if (!t || !v1s.length) return { ok: false, reason: "stripe_signature_malformed" };
|
|
154
|
-
const ageSeconds = Math.abs(Date.now() / 1000 - Number(t));
|
|
155
|
-
if (!Number.isFinite(ageSeconds) || ageSeconds > config.webhookToleranceSeconds) {
|
|
156
|
-
return { ok: false, reason: "stripe_timestamp_out_of_tolerance" };
|
|
157
|
-
}
|
|
158
|
-
const expected = crypto.createHmac("sha256", config.webhookSecret).update(`${t}.${rawBody}`, "utf8").digest("hex");
|
|
159
|
-
const match = v1s.some((v) => {
|
|
160
|
-
try {
|
|
161
|
-
return v.length === expected.length && crypto.timingSafeEqual(Buffer.from(v, "hex"), Buffer.from(expected, "hex"));
|
|
162
|
-
} catch (_) {
|
|
163
|
-
return false;
|
|
164
|
-
}
|
|
165
|
-
});
|
|
166
|
-
if (!match) return { ok: false, reason: "stripe_signature_invalid" };
|
|
167
|
-
let event = null;
|
|
168
|
-
try {
|
|
169
|
-
event = JSON.parse(rawBody);
|
|
170
|
-
} catch (_) {
|
|
171
|
-
return { ok: false, reason: "stripe_body_not_json" };
|
|
172
|
-
}
|
|
173
|
-
return { ok: true, event };
|
|
174
|
-
}
|
|
175
|
-
return { ok: false, reason: "unsupported_processor" };
|
|
176
|
-
}
|
|
177
|
-
|
|
178
|
-
// Build the Stripe-Signature header value for a raw body (used by tests and by
|
|
179
|
-
// anyone generating a signed event). Not used in production verification.
|
|
180
|
-
function buildStripeSignatureHeader(webhookSecret, rawBody, timestampSeconds) {
|
|
181
|
-
const t = String(timestampSeconds || Math.floor(Date.now() / 1000));
|
|
182
|
-
const v1 = crypto.createHmac("sha256", webhookSecret).update(`${t}.${rawBody}`, "utf8").digest("hex");
|
|
183
|
-
return `t=${t},v1=${v1}`;
|
|
184
|
-
}
|
|
185
|
-
|
|
186
|
-
// Translate a verified webhook event into a credit-grant body (matches
|
|
187
|
-
// createExternalCreditGrant), or null when it is not a completed payment.
|
|
188
|
-
function mapProcessorEventToGrant(config, event) {
|
|
189
|
-
if (!isConfigured(config) || !event || typeof event !== "object") return null;
|
|
190
|
-
if (config.provider === "stripe") {
|
|
191
|
-
if (event.type !== "checkout.session.completed") return null;
|
|
192
|
-
const s = (event.data && event.data.object) || {};
|
|
193
|
-
if (s.payment_status !== "paid") return null;
|
|
194
|
-
const md = s.metadata || {};
|
|
195
|
-
return {
|
|
196
|
-
account_id: md.account_id || null,
|
|
197
|
-
units: Number(md.credits_units) || null,
|
|
198
|
-
source: "stripe",
|
|
199
|
-
provider_reference: s.payment_intent || s.id || null,
|
|
200
|
-
idempotency_key: "stripe:" + (event.id || s.id),
|
|
201
|
-
amount_minor: Number(s.amount_total),
|
|
202
|
-
currency: String(s.currency || "usd").toUpperCase(),
|
|
203
|
-
purchase_intent_id: md.purchase_intent_id || null,
|
|
204
|
-
metadata: { processor: "stripe", checkout_session_id: s.id, event_id: event.id }
|
|
205
|
-
};
|
|
206
|
-
}
|
|
207
|
-
return null;
|
|
208
|
-
}
|
|
209
|
-
|
|
210
|
-
module.exports = {
|
|
211
|
-
loadCheckoutProcessorConfig,
|
|
212
|
-
isConfigured,
|
|
213
|
-
createProcessorCheckoutSession,
|
|
214
|
-
verifyProcessorWebhook,
|
|
215
|
-
buildStripeSignatureHeader,
|
|
216
|
-
mapProcessorEventToGrant
|
|
217
|
-
};
|