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,819 +0,0 @@
|
|
|
1
|
-
"use strict";
|
|
2
|
-
|
|
3
|
-
// Verifies the open execution-provider network (lib/provider_registry.js + /v1/provider-network/*):
|
|
4
|
-
// self-registration lands pending, only ACTIVE providers resolve for routing, re-registering an
|
|
5
|
-
// active provider with a changed endpoint reverts it to pending (anti-hijack), the revenue-share
|
|
6
|
-
// split is correct, routing/settlement accounting rolls up, the public view never leaks the auth
|
|
7
|
-
// token, and the routes are fail-closed (register) / operator-gated (activate, revenue views).
|
|
8
|
-
|
|
9
|
-
const assert = require("assert");
|
|
10
|
-
|
|
11
|
-
async function req(baseUrl, method, path, body, headers = {}) {
|
|
12
|
-
const res = await fetch(`${baseUrl}${path}`, {
|
|
13
|
-
method,
|
|
14
|
-
headers: { "content-type": "application/json", ...headers },
|
|
15
|
-
...(body !== undefined ? { body: JSON.stringify(body) } : {})
|
|
16
|
-
});
|
|
17
|
-
let json = null; try { json = await res.json(); } catch (_) { json = null; }
|
|
18
|
-
return { status: res.status, json };
|
|
19
|
-
}
|
|
20
|
-
|
|
21
|
-
function libChecks() {
|
|
22
|
-
const reg = require("../lib/provider_registry");
|
|
23
|
-
const state = {};
|
|
24
|
-
|
|
25
|
-
// 1. Validation.
|
|
26
|
-
assert.strictEqual(reg.registerProvider(state, { task_refs: ["t"], revenue_share_bps: 1000 }).reason, "endpoint_url_required", "endpoint required");
|
|
27
|
-
assert.strictEqual(reg.registerProvider(state, { endpoint_url: "https://p/x", revenue_share_bps: 1000 }).reason, "capability_selector_required", "selector required");
|
|
28
|
-
assert.strictEqual(reg.registerProvider(state, { endpoint_url: "https://p/x", task_refs: ["t"], revenue_share_bps: 20000 }).reason, "revenue_share_bps_invalid", "share bounded 0..10000");
|
|
29
|
-
|
|
30
|
-
// 1b. Revenue share is capped by an operator-set max.
|
|
31
|
-
const prevMax = process.env.XYTARA_PROVIDER_MAX_REVENUE_SHARE_BPS;
|
|
32
|
-
process.env.XYTARA_PROVIDER_MAX_REVENUE_SHARE_BPS = "3000";
|
|
33
|
-
try {
|
|
34
|
-
assert.strictEqual(reg.registerProvider(state, { provider_id: "prov_cap", endpoint_url: "https://c/x", task_refs: ["t"], revenue_share_bps: 5000 }).reason, "revenue_share_bps_exceeds_max", "share above operator max rejected");
|
|
35
|
-
} finally {
|
|
36
|
-
if (prevMax === undefined) delete process.env.XYTARA_PROVIDER_MAX_REVENUE_SHARE_BPS; else process.env.XYTARA_PROVIDER_MAX_REVENUE_SHARE_BPS = prevMax;
|
|
37
|
-
}
|
|
38
|
-
|
|
39
|
-
// 2. Register -> pending, auth + owner_secret never leaked; owner_secret returned once.
|
|
40
|
-
let r = reg.registerProvider(state, { provider_id: "prov_a", endpoint_url: "https://a.example/execute", task_refs: ["adapter.demo.invoke"], tool_names: ["keccak256"], revenue_share_bps: 2000, auth_token: "secret-a" });
|
|
41
|
-
assert.strictEqual(r.ok, true, "register ok");
|
|
42
|
-
assert.strictEqual(r.status, "pending", "new provider is pending");
|
|
43
|
-
const ownerA = r.owner_secret;
|
|
44
|
-
assert.ok(typeof ownerA === "string" && ownerA.startsWith("prvown_"), "owner_secret returned once at first registration");
|
|
45
|
-
assert.strictEqual(r.provider.owner_secret, undefined, "public view NEVER exposes owner_secret");
|
|
46
|
-
assert.strictEqual(r.provider.auth_bound, true, "auth bound");
|
|
47
|
-
assert.strictEqual(r.provider.auth_token, undefined, "public view NEVER exposes auth_token");
|
|
48
|
-
assert.deepStrictEqual(r.provider.rollup, { routed_calls: 0, settled_calls: 0, gross_minor: 0, provider_share_minor: 0, platform_take_minor: 0, paid_out_minor: 0 }, "rollup zeroed");
|
|
49
|
-
|
|
50
|
-
// 3. A pending provider does NOT resolve for routing.
|
|
51
|
-
assert.strictEqual(reg.resolveRegisteredTarget(state, { task_ref: "adapter.demo.invoke" }, {}), null, "pending provider not routable");
|
|
52
|
-
|
|
53
|
-
// 4. Activate -> now resolves by task_ref, tool_name, and integration_id.
|
|
54
|
-
assert.strictEqual(reg.setProviderStatus(state, "prov_a", "bogus").reason, "invalid_status", "invalid status rejected");
|
|
55
|
-
assert.strictEqual(reg.setProviderStatus(state, "nope", "active").reason, "provider_not_found", "unknown provider");
|
|
56
|
-
assert.strictEqual(reg.setProviderStatus(state, "prov_a", "active").provider.status, "active", "activated");
|
|
57
|
-
let target = reg.resolveRegisteredTarget(state, { task_ref: "adapter.demo.invoke" }, {});
|
|
58
|
-
assert.ok(target && target.registered_provider_id === "prov_a", "resolves by task_ref");
|
|
59
|
-
assert.strictEqual(target.auth_token, "secret-a", "resolved target carries the auth token for calling the provider");
|
|
60
|
-
assert.ok(reg.resolveRegisteredTarget(state, { body: { tool_name: "keccak256" } }, {}), "resolves by tool_name");
|
|
61
|
-
|
|
62
|
-
// 5. Ownership + re-approval on material change (anti-hijack / anti-DoS).
|
|
63
|
-
// 5a. Re-registration WITHOUT the owner secret is rejected — no cross-provider mutation.
|
|
64
|
-
assert.strictEqual(
|
|
65
|
-
reg.registerProvider(state, { provider_id: "prov_a", endpoint_url: "https://evil.example/execute", task_refs: ["adapter.demo.invoke"], revenue_share_bps: 2000 }).reason,
|
|
66
|
-
"provider_owner_mismatch", "re-register without owner secret rejected");
|
|
67
|
-
assert.ok(reg.resolveRegisteredTarget(state, { task_ref: "adapter.demo.invoke" }, {}), "unchanged + still active after a rejected re-register");
|
|
68
|
-
// 5b. Owner re-registration that changes the ENDPOINT reverts to pending (anti-redirect).
|
|
69
|
-
r = reg.registerProvider(state, { provider_id: "prov_a", owner_secret: ownerA, endpoint_url: "https://a2.example/execute", task_refs: ["adapter.demo.invoke"], tool_names: ["keccak256"], revenue_share_bps: 2000, auth_token: "secret-a" });
|
|
70
|
-
assert.strictEqual(r.status, "pending", "endpoint change reverts to pending");
|
|
71
|
-
assert.strictEqual(r.owner_secret, undefined, "owner_secret not re-issued on update");
|
|
72
|
-
reg.setProviderStatus(state, "prov_a", "active");
|
|
73
|
-
// 5c. Owner re-registration that EXPANDS CAPABILITIES reverts to pending — the activation
|
|
74
|
-
// gate cannot be bypassed by adding an unreviewed task to an already-active provider.
|
|
75
|
-
r = reg.registerProvider(state, { provider_id: "prov_a", owner_secret: ownerA, endpoint_url: "https://a2.example/execute", task_refs: ["adapter.demo.invoke", "adapter.highvalue.invoke"], tool_names: ["keccak256"], revenue_share_bps: 2000, auth_token: "secret-a" });
|
|
76
|
-
assert.strictEqual(r.status, "pending", "capability expansion reverts to pending");
|
|
77
|
-
assert.strictEqual(reg.resolveRegisteredTarget(state, { task_ref: "adapter.highvalue.invoke" }, {}), null, "expanded capability not routable until re-activated");
|
|
78
|
-
reg.setProviderStatus(state, "prov_a", "active");
|
|
79
|
-
// 5d. A metadata-only re-registration (label) keeps the provider active.
|
|
80
|
-
r = reg.registerProvider(state, { provider_id: "prov_a", owner_secret: ownerA, label: "Renamed", endpoint_url: "https://a2.example/execute", task_refs: ["adapter.demo.invoke", "adapter.highvalue.invoke"], tool_names: ["keccak256"], revenue_share_bps: 2000, auth_token: "secret-a" });
|
|
81
|
-
assert.strictEqual(r.status, "active", "metadata-only change keeps active");
|
|
82
|
-
|
|
83
|
-
// 6. Routing + settlement accounting + the revenue-share split.
|
|
84
|
-
reg.recordProviderRouting(state, "prov_a");
|
|
85
|
-
assert.strictEqual(reg.getProvider(state, "prov_a").rollup.routed_calls, 1, "routed_calls incremented");
|
|
86
|
-
const s = reg.recordProviderSettlement(state, { provider_id: "prov_a", amount_minor: 1000, currency: "USD_CENTS", task_ref: "adapter.demo.invoke" });
|
|
87
|
-
assert.strictEqual(s.ok, true, "settlement recorded");
|
|
88
|
-
assert.strictEqual(s.settlement.provider_share_minor, 200, "2000bps of 1000 => provider 200");
|
|
89
|
-
assert.strictEqual(s.settlement.platform_take_minor, 800, "platform keeps 800 (incl. rounding remainder)");
|
|
90
|
-
// rounding remainder goes to platform: 2000bps of 999 => floor(199.8)=199 provider, 800 platform
|
|
91
|
-
const s2 = reg.recordProviderSettlement(state, { provider_id: "prov_a", amount_minor: 999 });
|
|
92
|
-
assert.strictEqual(s2.settlement.provider_share_minor, 199, "floor split");
|
|
93
|
-
assert.strictEqual(s2.settlement.provider_share_minor + s2.settlement.platform_take_minor, 999, "split sums to gross");
|
|
94
|
-
assert.strictEqual(reg.recordProviderSettlement(state, { provider_id: "nope", amount_minor: 1 }).reason, "provider_not_found", "settle unknown provider");
|
|
95
|
-
|
|
96
|
-
const roll = reg.getProvider(state, "prov_a").rollup;
|
|
97
|
-
assert.strictEqual(roll.settled_calls, 2, "two settlements");
|
|
98
|
-
assert.strictEqual(roll.gross_minor, 1999, "gross rolled up");
|
|
99
|
-
assert.strictEqual(roll.provider_share_minor, 399, "provider share rolled up");
|
|
100
|
-
|
|
101
|
-
// 7. Summary + ledger.
|
|
102
|
-
const sum = reg.summarizeProviderNetwork(state);
|
|
103
|
-
assert.strictEqual(sum.by_status.active, 1, "one active in summary");
|
|
104
|
-
assert.strictEqual(sum.totals.gross_minor, 1999, "summary gross");
|
|
105
|
-
assert.strictEqual(sum.settlement_ledger_entries, 2, "ledger has 2 entries");
|
|
106
|
-
assert.strictEqual(reg.listProviderSettlements(state, { provider_id: "prov_a" }).length, 2, "ledger filter");
|
|
107
|
-
|
|
108
|
-
// 8. Collections are the snapshot-friendly shapes.
|
|
109
|
-
assert.ok(state.providerRegistry instanceof Map, "providerRegistry is a Map");
|
|
110
|
-
assert.ok(Array.isArray(state.providerSettlementLedger), "providerSettlementLedger is an array");
|
|
111
|
-
|
|
112
|
-
// 9. PAYOUTS: accrue -> create (reserved) -> confirm (paid), idempotent, reservation caps.
|
|
113
|
-
// A provider with no payout address cannot be paid out.
|
|
114
|
-
assert.strictEqual(reg.createProviderPayout(state, "prov_a", {}).reason, "payout_address_not_set", "no payout address -> cannot pay out");
|
|
115
|
-
// A malformed eip155 payout address is rejected at register.
|
|
116
|
-
assert.strictEqual(reg.registerProvider(state, { provider_id: "prov_bad", endpoint_url: "https://b/x", task_refs: ["t"], revenue_share_bps: 5000, payout_address: "0xnothex" }).reason, "payout_address_invalid", "bad eip155 payout address rejected");
|
|
117
|
-
|
|
118
|
-
let rp = reg.registerProvider(state, { provider_id: "prov_pay", endpoint_url: "https://pay.example/execute", task_refs: ["adapter.pay.invoke"], revenue_share_bps: 7000, payout_address: "0x" + "a".repeat(40) });
|
|
119
|
-
const ownerPay = rp.owner_secret;
|
|
120
|
-
reg.setProviderStatus(state, "prov_pay", "active");
|
|
121
|
-
reg.recordProviderSettlement(state, { provider_id: "prov_pay", amount_minor: 1000 }); // accrue 700
|
|
122
|
-
let ps = reg.computeProviderPayoutState(state, "prov_pay");
|
|
123
|
-
assert.strictEqual(ps.accrued_minor, 700, "accrued 700");
|
|
124
|
-
assert.strictEqual(ps.available_minor, 700, "available 700");
|
|
125
|
-
|
|
126
|
-
// Partial payout reserves against available.
|
|
127
|
-
const pay = reg.createProviderPayout(state, "prov_pay", { amount_minor: 300 });
|
|
128
|
-
assert.strictEqual(pay.ok, true, "payout created");
|
|
129
|
-
assert.strictEqual(pay.payout.status, "pending", "pending");
|
|
130
|
-
ps = reg.computeProviderPayoutState(state, "prov_pay");
|
|
131
|
-
assert.strictEqual(ps.pending_minor, 300, "pending reserved");
|
|
132
|
-
assert.strictEqual(ps.available_minor, 400, "available reduced to 400");
|
|
133
|
-
assert.strictEqual(ps.owed_minor, 700, "owed still 700 (incl pending)");
|
|
134
|
-
|
|
135
|
-
// Cannot create a payout exceeding available (concurrent pending can't over-draw).
|
|
136
|
-
assert.strictEqual(reg.createProviderPayout(state, "prov_pay", { amount_minor: 500 }).reason, "amount_exceeds_available", "over-available rejected");
|
|
137
|
-
|
|
138
|
-
// Confirm requires a tx_ref; settling credits paid_out.
|
|
139
|
-
assert.strictEqual(reg.confirmProviderPayout(state, pay.payout.payout_id, {}).reason, "tx_ref_required", "confirm needs tx_ref");
|
|
140
|
-
const conf = reg.confirmProviderPayout(state, pay.payout.payout_id, { tx_ref: "0xdeadbeef" });
|
|
141
|
-
assert.strictEqual(conf.payout.status, "settled", "settled");
|
|
142
|
-
ps = reg.computeProviderPayoutState(state, "prov_pay");
|
|
143
|
-
assert.strictEqual(ps.paid_out_minor, 300, "paid 300");
|
|
144
|
-
assert.strictEqual(ps.pending_minor, 0, "no pending after confirm");
|
|
145
|
-
assert.strictEqual(ps.owed_minor, 400, "owed 400 after payout");
|
|
146
|
-
|
|
147
|
-
// Idempotent confirm -> no double credit.
|
|
148
|
-
assert.strictEqual(reg.confirmProviderPayout(state, pay.payout.payout_id, { tx_ref: "0xdeadbeef" }).idempotent, true, "re-confirm idempotent");
|
|
149
|
-
assert.strictEqual(reg.computeProviderPayoutState(state, "prov_pay").paid_out_minor, 300, "no double credit");
|
|
150
|
-
|
|
151
|
-
// Reusing a tx_ref across two settled payouts is rejected (would silently under-pay).
|
|
152
|
-
const payDup = reg.createProviderPayout(state, "prov_pay", { amount_minor: 100 });
|
|
153
|
-
assert.strictEqual(reg.confirmProviderPayout(state, payDup.payout.payout_id, { tx_ref: "0xdeadbeef" }).reason, "duplicate_tx_ref", "duplicate tx_ref rejected");
|
|
154
|
-
assert.strictEqual(reg.getProviderPayout(state, payDup.payout.payout_id).status, "pending", "rejected confirm leaves it pending");
|
|
155
|
-
reg.cancelProviderPayout(state, payDup.payout.payout_id);
|
|
156
|
-
|
|
157
|
-
// Full remaining payout, then cancel -> available restored.
|
|
158
|
-
const pay2 = reg.createProviderPayout(state, "prov_pay", {});
|
|
159
|
-
assert.strictEqual(pay2.payout.amount_minor, 400, "full remaining 400");
|
|
160
|
-
assert.strictEqual(reg.cancelProviderPayout(state, pay2.payout.payout_id).ok, true, "cancelled");
|
|
161
|
-
assert.strictEqual(reg.computeProviderPayoutState(state, "prov_pay").available_minor, 400, "available restored after cancel");
|
|
162
|
-
|
|
163
|
-
// Changing ONLY the payout address keeps the provider active (not routing-material).
|
|
164
|
-
rp = reg.registerProvider(state, { provider_id: "prov_pay", owner_secret: ownerPay, endpoint_url: "https://pay.example/execute", task_refs: ["adapter.pay.invoke"], revenue_share_bps: 7000, payout_address: "0x" + "b".repeat(40) });
|
|
165
|
-
assert.strictEqual(rp.status, "active", "payout-address change keeps active");
|
|
166
|
-
|
|
167
|
-
// Public view HIDES the payout address (operator-only), shows payout_bound, hides
|
|
168
|
-
// owner_secret, carries paid_out_minor; the address is readable via the operator payout-state.
|
|
169
|
-
const pv = reg.buildProviderPublicView(reg.getProvider(state, "prov_pay"));
|
|
170
|
-
assert.strictEqual(pv.payout_address, undefined, "public view hides payout_address");
|
|
171
|
-
assert.strictEqual(pv.payout_bound, true, "public view shows payout_bound");
|
|
172
|
-
assert.strictEqual(pv.owner_secret, undefined, "public view hides owner_secret");
|
|
173
|
-
assert.ok(Number.isFinite(pv.rollup.paid_out_minor), "rollup carries paid_out_minor");
|
|
174
|
-
assert.ok(/^0x/.test(reg.computeProviderPayoutState(state, "prov_pay").payout_address), "operator payout-state exposes the address");
|
|
175
|
-
|
|
176
|
-
// 9b. Provider self-service earnings: owner_secret auth (constant-time) + read-only composed view.
|
|
177
|
-
assert.strictEqual(reg.authenticateProviderOwner(state, "prov_pay", "wrong").reason, "provider_owner_mismatch", "earnings auth rejects a wrong owner_secret");
|
|
178
|
-
assert.strictEqual(reg.authenticateProviderOwner(state, "nope", ownerPay).reason, "provider_not_found", "earnings auth unknown provider");
|
|
179
|
-
assert.strictEqual(reg.authenticateProviderOwner(state, "prov_pay", ownerPay).ok, true, "earnings auth accepts the provider's own owner_secret");
|
|
180
|
-
const earn = reg.buildProviderEarningsView(state, "prov_pay");
|
|
181
|
-
assert.strictEqual(earn.provider.owner_secret, undefined, "earnings view NEVER exposes owner_secret");
|
|
182
|
-
assert.strictEqual(earn.provider.auth_token, undefined, "earnings view NEVER exposes auth_token");
|
|
183
|
-
assert.strictEqual(earn.payout_state.accrued_minor, 700, "earnings payout_state accrued");
|
|
184
|
-
assert.strictEqual(earn.payout_state.paid_out_minor, 300, "earnings payout_state paid");
|
|
185
|
-
assert.strictEqual(earn.settlements.length, 1, "earnings carries the provider's own settlement rows");
|
|
186
|
-
assert.ok(earn.settlements.every((e) => e.provider_id === "prov_pay"), "earnings settlements scoped to the provider");
|
|
187
|
-
assert.ok(earn.payouts.length >= 1 && earn.payouts.every((p) => p.provider_id === "prov_pay"), "earnings payouts scoped to the provider");
|
|
188
|
-
|
|
189
|
-
// 10. HEALTH: failures accumulate -> unhealthy (excluded) -> cooldown -> half-open -> reset.
|
|
190
|
-
const prevThresh = process.env.XYTARA_PROVIDER_UNHEALTHY_THRESHOLD;
|
|
191
|
-
const prevCool = process.env.XYTARA_PROVIDER_UNHEALTHY_COOLDOWN_MS;
|
|
192
|
-
process.env.XYTARA_PROVIDER_UNHEALTHY_THRESHOLD = "3";
|
|
193
|
-
process.env.XYTARA_PROVIDER_UNHEALTHY_COOLDOWN_MS = "60000";
|
|
194
|
-
try {
|
|
195
|
-
const hs = {};
|
|
196
|
-
reg.registerProvider(hs, { provider_id: "h_a", endpoint_url: "https://a/execute", task_refs: ["cap.x"], revenue_share_bps: 5000 });
|
|
197
|
-
reg.registerProvider(hs, { provider_id: "h_b", endpoint_url: "https://b/execute", task_refs: ["cap.x"], revenue_share_bps: 5000 });
|
|
198
|
-
reg.setProviderStatus(hs, "h_a", "active");
|
|
199
|
-
reg.setProviderStatus(hs, "h_b", "active");
|
|
200
|
-
|
|
201
|
-
assert.strictEqual(reg.resolveRegisteredTargets(hs, { task_ref: "cap.x" }, {}).length, 2, "both healthy -> 2 candidates");
|
|
202
|
-
|
|
203
|
-
reg.recordProviderHealth(hs, "h_a", { ok: false });
|
|
204
|
-
reg.recordProviderHealth(hs, "h_a", { ok: false });
|
|
205
|
-
assert.strictEqual(reg.getProvider(hs, "h_a").health.status, "healthy", "below threshold stays healthy");
|
|
206
|
-
reg.recordProviderHealth(hs, "h_a", { ok: false }); // 3rd -> unhealthy
|
|
207
|
-
assert.strictEqual(reg.getProvider(hs, "h_a").health.status, "unhealthy", "threshold -> unhealthy");
|
|
208
|
-
assert.ok(reg.getProvider(hs, "h_a").health.unhealthy_until_iso, "cooldown set");
|
|
209
|
-
|
|
210
|
-
let c = reg.resolveRegisteredTargets(hs, { task_ref: "cap.x" }, {});
|
|
211
|
-
assert.strictEqual(c.length, 1, "unhealthy excluded -> 1 candidate");
|
|
212
|
-
assert.strictEqual(c[0].registered_provider_id, "h_b", "only healthy h_b routes");
|
|
213
|
-
|
|
214
|
-
// Elapse the cooldown -> h_a becomes half-open (routable, ordered AFTER healthy).
|
|
215
|
-
const ra = reg.getProvider(hs, "h_a");
|
|
216
|
-
hs.providerRegistry.set("h_a", { ...ra, health: { ...ra.health, unhealthy_until_iso: new Date(Date.now() - 1000).toISOString() } });
|
|
217
|
-
c = reg.resolveRegisteredTargets(hs, { task_ref: "cap.x" }, {});
|
|
218
|
-
assert.strictEqual(c.length, 2, "cooldown elapsed -> 2 candidates");
|
|
219
|
-
assert.strictEqual(c[0].registered_provider_id, "h_b", "healthy ordered first");
|
|
220
|
-
assert.strictEqual(c[1].registered_provider_id, "h_a", "half-open ordered after healthy");
|
|
221
|
-
|
|
222
|
-
reg.recordProviderHealth(hs, "h_a", { ok: true });
|
|
223
|
-
assert.strictEqual(reg.getProvider(hs, "h_a").health.status, "healthy", "success resets to healthy");
|
|
224
|
-
assert.strictEqual(reg.getProvider(hs, "h_a").health.consecutive_failures, 0, "failures reset");
|
|
225
|
-
|
|
226
|
-
assert.strictEqual(reg.buildProviderPublicView(reg.getProvider(hs, "h_a")).health.status, "healthy", "public view carries health");
|
|
227
|
-
assert.strictEqual(reg.summarizeProviderNetwork(hs).health.routable, 2, "summary routable count");
|
|
228
|
-
} finally {
|
|
229
|
-
if (prevThresh === undefined) delete process.env.XYTARA_PROVIDER_UNHEALTHY_THRESHOLD; else process.env.XYTARA_PROVIDER_UNHEALTHY_THRESHOLD = prevThresh;
|
|
230
|
-
if (prevCool === undefined) delete process.env.XYTARA_PROVIDER_UNHEALTHY_COOLDOWN_MS; else process.env.XYTARA_PROVIDER_UNHEALTHY_COOLDOWN_MS = prevCool;
|
|
231
|
-
}
|
|
232
|
-
|
|
233
|
-
// 11. REMOVE: operator purge; refuses a provider still owed an unpaid balance unless forced.
|
|
234
|
-
const rm = {};
|
|
235
|
-
reg.registerProvider(rm, { provider_id: "rm_1", endpoint_url: "https://r/x", task_refs: ["t"], revenue_share_bps: 5000, payout_address: "0x" + "d".repeat(40) });
|
|
236
|
-
reg.setProviderStatus(rm, "rm_1", "active");
|
|
237
|
-
assert.strictEqual(reg.removeProvider(rm, "nope").reason, "provider_not_found", "remove unknown -> not_found");
|
|
238
|
-
assert.strictEqual(reg.removeProvider(rm, "rm_1").ok, true, "remove with no owed balance ok");
|
|
239
|
-
assert.strictEqual(reg.getProvider(rm, "rm_1"), null, "provider gone after remove");
|
|
240
|
-
reg.registerProvider(rm, { provider_id: "rm_2", endpoint_url: "https://r2/x", task_refs: ["t"], revenue_share_bps: 7000, payout_address: "0x" + "e".repeat(40) });
|
|
241
|
-
reg.recordProviderSettlement(rm, { provider_id: "rm_2", amount_minor: 100 }); // owed 70
|
|
242
|
-
assert.strictEqual(reg.removeProvider(rm, "rm_2").reason, "provider_has_unpaid_balance", "owed balance -> refused");
|
|
243
|
-
assert.strictEqual(reg.removeProvider(rm, "rm_2", { force: true }).ok, true, "force removes anyway");
|
|
244
|
-
assert.strictEqual(reg.getProvider(rm, "rm_2"), null, "forced provider gone");
|
|
245
|
-
|
|
246
|
-
// 12. REPUTATION: tracked per execution, surfaced, orders routing within the healthy tier,
|
|
247
|
-
// optimistic cold-start (a new provider is not starved behind proven ones).
|
|
248
|
-
const repState = {};
|
|
249
|
-
reg.registerProvider(repState, { provider_id: "rep_hi", endpoint_url: "https://hi/x", task_refs: ["cap.rep"], revenue_share_bps: 5000 });
|
|
250
|
-
reg.registerProvider(repState, { provider_id: "rep_lo", endpoint_url: "https://lo/x", task_refs: ["cap.rep"], revenue_share_bps: 5000 });
|
|
251
|
-
reg.setProviderStatus(repState, "rep_hi", "active");
|
|
252
|
-
reg.setProviderStatus(repState, "rep_lo", "active");
|
|
253
|
-
const prevT = process.env.XYTARA_PROVIDER_UNHEALTHY_THRESHOLD;
|
|
254
|
-
process.env.XYTARA_PROVIDER_UNHEALTHY_THRESHOLD = "100"; // keep rep_lo routable despite a failure
|
|
255
|
-
try {
|
|
256
|
-
reg.recordProviderHealth(repState, "rep_hi", { ok: true });
|
|
257
|
-
reg.recordProviderHealth(repState, "rep_hi", { ok: true }); // hi 2/2 = 1.0
|
|
258
|
-
reg.recordProviderHealth(repState, "rep_lo", { ok: true });
|
|
259
|
-
reg.recordProviderHealth(repState, "rep_lo", { ok: false }); // lo 1/2 = 0.5
|
|
260
|
-
assert.strictEqual(reg.getProvider(repState, "rep_hi").reputation.success_count, 2, "hi successes tracked");
|
|
261
|
-
assert.strictEqual(reg.getProvider(repState, "rep_lo").reputation.failure_count, 1, "lo failure tracked");
|
|
262
|
-
let c = reg.resolveRegisteredTargets(repState, { task_ref: "cap.rep" }, {});
|
|
263
|
-
assert.strictEqual(c[0].registered_provider_id, "rep_hi", "higher reputation routed first");
|
|
264
|
-
assert.strictEqual(c[1].registered_provider_id, "rep_lo", "lower reputation second");
|
|
265
|
-
const pv = reg.buildProviderPublicView(reg.getProvider(repState, "rep_lo"));
|
|
266
|
-
assert.strictEqual(pv.reputation.success_rate, 0.5, "public view success_rate");
|
|
267
|
-
assert.strictEqual(pv.reputation.total_calls, 2, "public view total_calls");
|
|
268
|
-
// Cold-start: a brand-new provider (score 1.0) ties at the top, not starved; rep_lo stays last.
|
|
269
|
-
reg.registerProvider(repState, { provider_id: "rep_new", endpoint_url: "https://new/x", task_refs: ["cap.rep"], revenue_share_bps: 5000 });
|
|
270
|
-
reg.setProviderStatus(repState, "rep_new", "active");
|
|
271
|
-
c = reg.resolveRegisteredTargets(repState, { task_ref: "cap.rep" }, {});
|
|
272
|
-
assert.strictEqual(c[c.length - 1].registered_provider_id, "rep_lo", "lowest reputation last");
|
|
273
|
-
assert.ok(c.slice(0, 2).some((t) => t.registered_provider_id === "rep_new"), "new provider not starved (top tier, optimistic)");
|
|
274
|
-
} finally {
|
|
275
|
-
if (prevT === undefined) delete process.env.XYTARA_PROVIDER_UNHEALTHY_THRESHOLD; else process.env.XYTARA_PROVIDER_UNHEALTHY_THRESHOLD = prevT;
|
|
276
|
-
}
|
|
277
|
-
|
|
278
|
-
// 12b. REPUTATION RECENCY DECAY (routing-only, env-tunable; default 1.0 = no change). With decay
|
|
279
|
-
// on, recent performance outweighs stale history: a provider whose LIFETIME counts look
|
|
280
|
-
// better but who regressed recently is routed AFTER one that recently recovered. Raw
|
|
281
|
-
// lifetime counts are preserved for display regardless.
|
|
282
|
-
const decState = {};
|
|
283
|
-
reg.registerProvider(decState, { provider_id: "dec_fade", endpoint_url: "https://fade/x", task_refs: ["cap.dec"], revenue_share_bps: 5000 });
|
|
284
|
-
reg.registerProvider(decState, { provider_id: "dec_rise", endpoint_url: "https://rise/x", task_refs: ["cap.dec"], revenue_share_bps: 5000 });
|
|
285
|
-
reg.setProviderStatus(decState, "dec_fade", "active");
|
|
286
|
-
reg.setProviderStatus(decState, "dec_rise", "active");
|
|
287
|
-
const prevDecay = process.env.XYTARA_PROVIDER_REPUTATION_DECAY;
|
|
288
|
-
const prevThr = process.env.XYTARA_PROVIDER_UNHEALTHY_THRESHOLD;
|
|
289
|
-
process.env.XYTARA_PROVIDER_REPUTATION_DECAY = "0.5";
|
|
290
|
-
process.env.XYTARA_PROVIDER_UNHEALTHY_THRESHOLD = "100"; // keep both routable despite failures
|
|
291
|
-
try {
|
|
292
|
-
for (let i = 0; i < 6; i++) reg.recordProviderHealth(decState, "dec_fade", { ok: true }); // strong early history
|
|
293
|
-
for (let i = 0; i < 3; i++) reg.recordProviderHealth(decState, "dec_fade", { ok: false }); // recent regression
|
|
294
|
-
for (let i = 0; i < 2; i++) reg.recordProviderHealth(decState, "dec_rise", { ok: false }); // weak early history
|
|
295
|
-
for (let i = 0; i < 3; i++) reg.recordProviderHealth(decState, "dec_rise", { ok: true }); // recent recovery
|
|
296
|
-
// Lifetime raw counts favor dec_fade (6-3 vs 3-2); recency decay must rank dec_rise first.
|
|
297
|
-
const dc = reg.resolveRegisteredTargets(decState, { task_ref: "cap.dec" }, {});
|
|
298
|
-
assert.strictEqual(dc[0].registered_provider_id, "dec_rise", "recency decay routes the recently-recovered provider first");
|
|
299
|
-
assert.strictEqual(dc[1].registered_provider_id, "dec_fade", "recently-regressed provider routed second despite better lifetime counts");
|
|
300
|
-
// Raw lifetime counts are untouched by decay (display integrity).
|
|
301
|
-
assert.strictEqual(reg.getProvider(decState, "dec_fade").reputation.success_count, 6, "raw lifetime success_count intact under decay");
|
|
302
|
-
assert.strictEqual(reg.getProvider(decState, "dec_fade").reputation.failure_count, 3, "raw lifetime failure_count intact under decay");
|
|
303
|
-
assert.strictEqual(reg.buildProviderPublicView(reg.getProvider(decState, "dec_fade")).reputation.total_calls, 9, "public view still reports lifetime total under decay");
|
|
304
|
-
} finally {
|
|
305
|
-
if (prevDecay === undefined) delete process.env.XYTARA_PROVIDER_REPUTATION_DECAY; else process.env.XYTARA_PROVIDER_REPUTATION_DECAY = prevDecay;
|
|
306
|
-
if (prevThr === undefined) delete process.env.XYTARA_PROVIDER_UNHEALTHY_THRESHOLD; else process.env.XYTARA_PROVIDER_UNHEALTHY_THRESHOLD = prevThr;
|
|
307
|
-
}
|
|
308
|
-
}
|
|
309
|
-
|
|
310
|
-
async function httpChecks() {
|
|
311
|
-
const prev = {
|
|
312
|
-
reg: process.env.XYTARA_PROVIDER_REGISTRY_BEARER_TOKEN,
|
|
313
|
-
op: process.env.XYTARA_ACCOUNT_AUTH_BEARER_TOKEN,
|
|
314
|
-
open: process.env.XYTARA_PROVIDER_OPEN_REGISTRATION,
|
|
315
|
-
rate: process.env.XYTARA_PROVIDER_REGISTRATION_RATE_PER_MIN,
|
|
316
|
-
maxPending: process.env.XYTARA_PROVIDER_MAX_PENDING
|
|
317
|
-
};
|
|
318
|
-
const REG = "test-provider-registry-token";
|
|
319
|
-
const OP = "test-operator-token";
|
|
320
|
-
process.env.XYTARA_PROVIDER_REGISTRY_BEARER_TOKEN = REG;
|
|
321
|
-
process.env.XYTARA_ACCOUNT_AUTH_BEARER_TOKEN = OP;
|
|
322
|
-
// Open-registration anti-abuse limits (read at createServer time for the rate limiter).
|
|
323
|
-
// Open mode itself is toggled per-request below; the bearer-mode tests run with it OFF.
|
|
324
|
-
delete process.env.XYTARA_PROVIDER_OPEN_REGISTRATION;
|
|
325
|
-
process.env.XYTARA_PROVIDER_REGISTRATION_RATE_PER_MIN = "3";
|
|
326
|
-
process.env.XYTARA_PROVIDER_MAX_PENDING = "2";
|
|
327
|
-
const regAuth = { authorization: `Bearer ${REG}` };
|
|
328
|
-
const opAuth = { authorization: `Bearer ${OP}` };
|
|
329
|
-
|
|
330
|
-
delete require.cache[require.resolve("../server")];
|
|
331
|
-
const { createServer } = require("../server");
|
|
332
|
-
const server = createServer();
|
|
333
|
-
await new Promise((resolve) => server.listen(0, "127.0.0.1", resolve));
|
|
334
|
-
const baseUrl = `http://127.0.0.1:${server.address().port}`;
|
|
335
|
-
|
|
336
|
-
try {
|
|
337
|
-
const prov = { provider_id: "prov_http", endpoint_url: "https://http.example/execute", task_refs: ["adapter.http.invoke"], revenue_share_bps: 1500, auth_token: "secret-http", payout_address: "0x" + "c".repeat(40) };
|
|
338
|
-
|
|
339
|
-
// Register: no bearer -> 403 forbidden (token IS configured here), wrong -> 403.
|
|
340
|
-
let r = await req(baseUrl, "POST", "/v1/provider-network/register", prov);
|
|
341
|
-
assert.strictEqual(r.status, 403, "register without bearer -> 403");
|
|
342
|
-
r = await req(baseUrl, "POST", "/v1/provider-network/register", prov, { authorization: "Bearer wrong" });
|
|
343
|
-
assert.strictEqual(r.status, 403, "register wrong bearer -> 403");
|
|
344
|
-
|
|
345
|
-
// Register with bearer -> 200 pending.
|
|
346
|
-
r = await req(baseUrl, "POST", "/v1/provider-network/register", prov, regAuth);
|
|
347
|
-
assert.strictEqual(r.status, 200, "register ok");
|
|
348
|
-
assert.strictEqual(r.json.status, "pending", "lands pending");
|
|
349
|
-
const ownerHttp = r.json.owner_secret; // minted once at first registration; used for self-service earnings
|
|
350
|
-
|
|
351
|
-
// Public discovery (no auth) lists ACTIVE providers only — a pending (unvetted) endpoint is not
|
|
352
|
-
// enumerable publicly; the operator bearer sees every status. No token leaks either way.
|
|
353
|
-
r = await req(baseUrl, "GET", "/v1/provider-network/providers");
|
|
354
|
-
assert.strictEqual(r.status, 200, "discovery public");
|
|
355
|
-
assert.strictEqual(r.json.scope, "active_only", "public discovery scope is active_only");
|
|
356
|
-
assert.ok(!r.json.providers.some((p) => p.provider_id === "prov_http"), "pending provider hidden from public discovery");
|
|
357
|
-
r = await req(baseUrl, "GET", "/v1/provider-network/providers", undefined, opAuth);
|
|
358
|
-
assert.strictEqual(r.json.scope, "all_statuses", "operator discovery sees all statuses");
|
|
359
|
-
const found = r.json.providers.find((p) => p.provider_id === "prov_http");
|
|
360
|
-
assert.ok(found && found.status === "pending" && found.auth_token === undefined && found.owner_secret === undefined && found.payout_address === undefined && found.auth_bound === true, "operator discovery shows pending + hides token + owner_secret + payout address");
|
|
361
|
-
|
|
362
|
-
// Public integration contract (no auth).
|
|
363
|
-
r = await req(baseUrl, "GET", "/v1/provider-network/contract");
|
|
364
|
-
assert.strictEqual(r.status, 200, "contract public 200");
|
|
365
|
-
assert.strictEqual(r.json.contract_version, "provider-network/v1", "contract version via HTTP");
|
|
366
|
-
|
|
367
|
-
// Activate: operator-gated.
|
|
368
|
-
r = await req(baseUrl, "POST", "/v1/provider-network/providers/prov_http/status", { status: "active" });
|
|
369
|
-
assert.strictEqual(r.status, 403, "activate without operator -> 403");
|
|
370
|
-
r = await req(baseUrl, "POST", "/v1/provider-network/providers/prov_http/status", { status: "active" }, opAuth);
|
|
371
|
-
assert.strictEqual(r.status, 200, "operator activates");
|
|
372
|
-
assert.strictEqual(r.json.provider.status, "active", "now active");
|
|
373
|
-
r = await req(baseUrl, "GET", "/v1/provider-network/providers");
|
|
374
|
-
assert.ok(r.json.providers.some((p) => p.provider_id === "prov_http"), "active provider visible in public discovery");
|
|
375
|
-
|
|
376
|
-
// Summary: operator-gated.
|
|
377
|
-
r = await req(baseUrl, "GET", "/v1/provider-network/summary");
|
|
378
|
-
assert.strictEqual(r.status, 403, "summary operator-gated");
|
|
379
|
-
r = await req(baseUrl, "GET", "/v1/provider-network/summary", undefined, opAuth);
|
|
380
|
-
assert.strictEqual(r.status, 200, "operator summary");
|
|
381
|
-
assert.strictEqual(r.json.by_status.active, 1, "one active");
|
|
382
|
-
|
|
383
|
-
// Payout routes move real money -> operator-gated.
|
|
384
|
-
r = await req(baseUrl, "POST", "/v1/provider-network/providers/prov_http/payouts", {});
|
|
385
|
-
assert.strictEqual(r.status, 403, "create payout without operator -> 403");
|
|
386
|
-
r = await req(baseUrl, "GET", "/v1/provider-network/payouts");
|
|
387
|
-
assert.strictEqual(r.status, 403, "list payouts without operator -> 403");
|
|
388
|
-
r = await req(baseUrl, "GET", "/v1/provider-network/providers/prov_http/payout-state", undefined, opAuth);
|
|
389
|
-
assert.strictEqual(r.status, 200, "operator reads payout-state");
|
|
390
|
-
assert.strictEqual(r.json.available_minor, 0, "no accrual yet -> 0 available");
|
|
391
|
-
assert.strictEqual(r.json.payout_address, "0x" + "c".repeat(40), "payout-state echoes address");
|
|
392
|
-
r = await req(baseUrl, "POST", "/v1/provider-network/providers/prov_http/payouts", {}, opAuth);
|
|
393
|
-
assert.strictEqual(r.status, 400, "no accrual -> 400");
|
|
394
|
-
assert.strictEqual(r.json.reason, "nothing_payable", "nothing payable");
|
|
395
|
-
r = await req(baseUrl, "POST", "/v1/provider-network/payouts/nope/confirm", { tx_ref: "0x1" }, opAuth);
|
|
396
|
-
assert.strictEqual(r.status, 404, "confirm unknown payout -> 404");
|
|
397
|
-
// Remove route is operator-gated.
|
|
398
|
-
r = await req(baseUrl, "POST", "/v1/provider-network/providers/prov_http/remove", {});
|
|
399
|
-
assert.strictEqual(r.status, 403, "remove without operator -> 403");
|
|
400
|
-
|
|
401
|
-
// Provider self-service earnings: READ-ONLY, authenticated by the provider's OWN owner_secret
|
|
402
|
-
// (not the operator bearer). Absent/wrong secret -> 403; unknown provider -> 404; own secret -> 200.
|
|
403
|
-
r = await req(baseUrl, "GET", "/v1/provider-network/providers/prov_http/earnings");
|
|
404
|
-
assert.strictEqual(r.status, 403, "earnings without owner_secret -> 403");
|
|
405
|
-
r = await req(baseUrl, "GET", "/v1/provider-network/providers/prov_http/earnings", undefined, { "x-provider-owner-secret": "wrong" });
|
|
406
|
-
assert.strictEqual(r.status, 403, "earnings wrong owner_secret -> 403");
|
|
407
|
-
r = await req(baseUrl, "GET", "/v1/provider-network/providers/prov_http/earnings", undefined, opAuth);
|
|
408
|
-
assert.strictEqual(r.status, 403, "operator bearer is NOT the provider owner_secret -> 403");
|
|
409
|
-
r = await req(baseUrl, "GET", "/v1/provider-network/providers/nope/earnings", undefined, { "x-provider-owner-secret": ownerHttp });
|
|
410
|
-
assert.strictEqual(r.status, 404, "earnings unknown provider -> 404");
|
|
411
|
-
r = await req(baseUrl, "GET", "/v1/provider-network/providers/prov_http/earnings", undefined, { "x-provider-owner-secret": ownerHttp });
|
|
412
|
-
assert.strictEqual(r.status, 200, "earnings with the provider's own owner_secret -> 200");
|
|
413
|
-
assert.ok(r.json.payout_state && Array.isArray(r.json.settlements) && Array.isArray(r.json.payouts), "earnings returns payout_state + settlements + payouts");
|
|
414
|
-
assert.strictEqual(r.json.provider.owner_secret, undefined, "earnings HTTP view hides owner_secret");
|
|
415
|
-
assert.strictEqual(r.json.provider.auth_token, undefined, "earnings HTTP view hides auth_token");
|
|
416
|
-
r = await req(baseUrl, "GET", "/v1/provider-network/providers/prov_http/earnings", undefined, { authorization: `Bearer ${ownerHttp}` });
|
|
417
|
-
assert.strictEqual(r.status, 200, "earnings accepts the owner_secret via Bearer too");
|
|
418
|
-
|
|
419
|
-
// Permissionless (open) registration: no operator bearer, still lands pending, rate-limited
|
|
420
|
-
// (3/min) + pending-capped (2). (Bearer mode above already confirmed no-bearer -> 403.)
|
|
421
|
-
process.env.XYTARA_PROVIDER_OPEN_REGISTRATION = "1";
|
|
422
|
-
const openProv = (id) => ({ provider_id: id, endpoint_url: "https://open.example/execute", task_refs: ["cap.open"], revenue_share_bps: 1000 });
|
|
423
|
-
r = await req(baseUrl, "POST", "/v1/provider-network/register", openProv("open_1"));
|
|
424
|
-
assert.strictEqual(r.status, 200, "open mode: no-bearer registration accepted");
|
|
425
|
-
assert.strictEqual(r.json.status, "pending", "open registration lands pending");
|
|
426
|
-
r = await req(baseUrl, "POST", "/v1/provider-network/register", openProv("open_2"));
|
|
427
|
-
assert.strictEqual(r.status, 200, "open #2 accepted");
|
|
428
|
-
r = await req(baseUrl, "POST", "/v1/provider-network/register", openProv("open_3"));
|
|
429
|
-
assert.strictEqual(r.status, 429, "open #3 hits pending cap");
|
|
430
|
-
assert.strictEqual(r.json.reason, "too_many_pending_providers", "pending cap reason");
|
|
431
|
-
r = await req(baseUrl, "POST", "/v1/provider-network/register", openProv("open_4"));
|
|
432
|
-
assert.strictEqual(r.status, 429, "open #4 rate-limited");
|
|
433
|
-
assert.strictEqual(r.json.reason, "provider_registration_rate_limited", "rate-limit reason");
|
|
434
|
-
delete process.env.XYTARA_PROVIDER_OPEN_REGISTRATION; // back to bearer mode for the next check
|
|
435
|
-
|
|
436
|
-
// Fail-closed: unset the registry token -> registration refuses with the config reason.
|
|
437
|
-
delete process.env.XYTARA_PROVIDER_REGISTRY_BEARER_TOKEN;
|
|
438
|
-
r = await req(baseUrl, "POST", "/v1/provider-network/register", prov, regAuth);
|
|
439
|
-
assert.strictEqual(r.status, 403, "unset token fails closed");
|
|
440
|
-
assert.strictEqual(r.json.reason, "provider_registry_auth_not_configured", "fail-closed reason");
|
|
441
|
-
} finally {
|
|
442
|
-
await new Promise((resolve) => server.close(resolve));
|
|
443
|
-
const restore = (k, v) => { if (v === undefined) delete process.env[k]; else process.env[k] = v; };
|
|
444
|
-
restore("XYTARA_PROVIDER_REGISTRY_BEARER_TOKEN", prev.reg);
|
|
445
|
-
restore("XYTARA_ACCOUNT_AUTH_BEARER_TOKEN", prev.op);
|
|
446
|
-
restore("XYTARA_PROVIDER_OPEN_REGISTRATION", prev.open);
|
|
447
|
-
restore("XYTARA_PROVIDER_REGISTRATION_RATE_PER_MIN", prev.rate);
|
|
448
|
-
restore("XYTARA_PROVIDER_MAX_PENDING", prev.maxPending);
|
|
449
|
-
}
|
|
450
|
-
}
|
|
451
|
-
|
|
452
|
-
// FAILOVER semantics: fail over ONLY on provably-not-processed failures (never double-execute);
|
|
453
|
-
// fail CLOSED when all matching providers are unhealthy (don't charge for undelivered work);
|
|
454
|
-
// keep the legacy local path when nothing serves the capability. Mocks fetch; retries off.
|
|
455
|
-
async function failoverChecks() {
|
|
456
|
-
const reg = require("../lib/provider_registry");
|
|
457
|
-
delete require.cache[require.resolve("../lib/command_flow")];
|
|
458
|
-
const { buildExternalExecutionOptions } = require("../lib/command_flow");
|
|
459
|
-
const prevRetries = process.env.XYTARA_EXTERNAL_EXECUTION_MAX_RETRIES;
|
|
460
|
-
process.env.XYTARA_EXTERNAL_EXECUTION_MAX_RETRIES = "0";
|
|
461
|
-
const orig = global.fetch;
|
|
462
|
-
|
|
463
|
-
const mkState = () => {
|
|
464
|
-
const s = {};
|
|
465
|
-
reg.registerProvider(s, { provider_id: "fo_a", endpoint_url: "https://fo-a.example/execute", task_refs: ["cap.fo"], revenue_share_bps: 5000, auth_token: "ta" });
|
|
466
|
-
reg.registerProvider(s, { provider_id: "fo_b", endpoint_url: "https://fo-b.example/execute", task_refs: ["cap.fo"], revenue_share_bps: 5000, auth_token: "tb" });
|
|
467
|
-
reg.setProviderStatus(s, "fo_a", "active");
|
|
468
|
-
reg.setProviderStatus(s, "fo_b", "active");
|
|
469
|
-
return s;
|
|
470
|
-
};
|
|
471
|
-
const okBody = async () => JSON.stringify({ result: { output: { ok: true } } });
|
|
472
|
-
const stubAStatus = (status) => {
|
|
473
|
-
global.fetch = async (url) => String(url).includes("fo-a.example")
|
|
474
|
-
? { ok: false, status, headers: { get: () => null }, text: async () => "err" }
|
|
475
|
-
: { ok: true, status: 200, headers: { get: () => null }, text: okBody };
|
|
476
|
-
};
|
|
477
|
-
const payload = { command: "x", task_ref: "cap.fo", body: {} };
|
|
478
|
-
|
|
479
|
-
try {
|
|
480
|
-
// Case 1: A=503 (provably not processed) -> FAIL OVER to B.
|
|
481
|
-
let s = mkState(); stubAStatus(503);
|
|
482
|
-
let r = await buildExternalExecutionOptions(s, payload, {}, {});
|
|
483
|
-
assert.ok(r.externalExecution && r.externalExecution.registered_provider_id === "fo_b", "503 -> failover to fo_b");
|
|
484
|
-
assert.strictEqual(reg.getProvider(s, "fo_a").rollup.routed_calls, 1, "fo_a attempted");
|
|
485
|
-
assert.strictEqual(reg.getProvider(s, "fo_b").rollup.routed_calls, 1, "fo_b served");
|
|
486
|
-
assert.strictEqual(reg.getProvider(s, "fo_a").health.consecutive_failures, 1, "fo_a failure recorded");
|
|
487
|
-
|
|
488
|
-
// Case 2: A=500 (AMBIGUOUS - may have executed) -> NO failover; B is never tried.
|
|
489
|
-
s = mkState(); stubAStatus(500);
|
|
490
|
-
r = await buildExternalExecutionOptions(s, payload, {}, {});
|
|
491
|
-
assert.ok(r.error, "ambiguous 500 -> error (no failover)");
|
|
492
|
-
assert.strictEqual(reg.getProvider(s, "fo_b").rollup.routed_calls, 0, "fo_b NOT tried on an ambiguous failure (no double-execute)");
|
|
493
|
-
|
|
494
|
-
// Case 3: all matching providers unhealthy -> no_healthy_provider error (buyer NOT charged).
|
|
495
|
-
s = mkState();
|
|
496
|
-
for (let i = 0; i < 4; i++) { reg.recordProviderHealth(s, "fo_a", { ok: false }); reg.recordProviderHealth(s, "fo_b", { ok: false }); }
|
|
497
|
-
r = await buildExternalExecutionOptions(s, payload, {}, {});
|
|
498
|
-
assert.ok(r.error && r.error.reason === "no_healthy_provider", "all unhealthy -> no_healthy_provider (not a synthetic charge)");
|
|
499
|
-
|
|
500
|
-
// Case 4: a capability NO provider serves -> {} (legacy local path, unchanged).
|
|
501
|
-
s = mkState();
|
|
502
|
-
r = await buildExternalExecutionOptions(s, { command: "x", task_ref: "cap.unserved", body: {} }, {}, {});
|
|
503
|
-
assert.deepStrictEqual(r, {}, "no matching provider -> {} (legacy)");
|
|
504
|
-
|
|
505
|
-
// Case 5: the provider receives a SANITIZED authorization context — never the buyer's signed
|
|
506
|
-
// x402 authorization / deferred-settlement material, never signature-like keys or nested objects.
|
|
507
|
-
s = mkState();
|
|
508
|
-
let sentBody = null;
|
|
509
|
-
global.fetch = async (url, init) => { sentBody = JSON.parse(init.body); return { ok: true, status: 200, headers: { get: () => null }, text: okBody }; };
|
|
510
|
-
r = await buildExternalExecutionOptions(s, payload, { quote_id: "q1" }, {
|
|
511
|
-
ok: true, verification_mode: "x402_facilitator", wallet_id: "0xpayer", age_seconds: 0,
|
|
512
|
-
payment_payload: { x402_payer: "0xpayer", x402_amount: "10000", signature: "0xsig", nested: { a: 1 } },
|
|
513
|
-
deferred_settlement: { authorization: { payload: { signature: "0xsig" } } }, settlement: null
|
|
514
|
-
});
|
|
515
|
-
assert.ok(r.externalExecution, "case 5 executed");
|
|
516
|
-
assert.strictEqual(sentBody.authorization_context.deferred_settlement, undefined, "deferred settlement never forwarded to a provider");
|
|
517
|
-
assert.strictEqual(sentBody.authorization_context.payment_payload.signature, undefined, "signature never forwarded");
|
|
518
|
-
assert.strictEqual(sentBody.authorization_context.payment_payload.nested, undefined, "nested material dropped");
|
|
519
|
-
assert.strictEqual(sentBody.authorization_context.payment_payload.x402_payer, "0xpayer", "scalar payment facts kept");
|
|
520
|
-
assert.strictEqual(sentBody.authorization_context.verification_mode, "x402_facilitator", "verification mode kept");
|
|
521
|
-
|
|
522
|
-
console.log(" failover: 503->B | 500 no-failover | all-unhealthy->503 | no-match->{} | sanitized context");
|
|
523
|
-
} finally {
|
|
524
|
-
global.fetch = orig;
|
|
525
|
-
if (prevRetries === undefined) delete process.env.XYTARA_EXTERNAL_EXECUTION_MAX_RETRIES; else process.env.XYTARA_EXTERNAL_EXECUTION_MAX_RETRIES = prevRetries;
|
|
526
|
-
}
|
|
527
|
-
}
|
|
528
|
-
|
|
529
|
-
// Auto-execute payouts via an external signer (runtime key-less): success settles with the
|
|
530
|
-
// returned tx; an explicit signer rejection cancels + frees the reservation; an AMBIGUOUS
|
|
531
|
-
// network failure leaves the payout PENDING (never auto-cancels funds that may have been sent).
|
|
532
|
-
async function payoutDispatchChecks() {
|
|
533
|
-
const reg = require("../lib/provider_registry");
|
|
534
|
-
const { loadPayoutSignerConfig, dispatchProviderPayout } = require("../lib/provider_payout_execution");
|
|
535
|
-
const prevUrl = process.env.XYTARA_PAYOUT_SIGNER_URL;
|
|
536
|
-
const orig = global.fetch;
|
|
537
|
-
const signer = { url: "https://signer.example/pay", bearer: null, timeout_ms: 2000 };
|
|
538
|
-
const mk = () => {
|
|
539
|
-
const s = {};
|
|
540
|
-
reg.registerProvider(s, { provider_id: "pd", endpoint_url: "https://pd/x", task_refs: ["t"], revenue_share_bps: 5000, payout_address: "0x" + "a".repeat(40) });
|
|
541
|
-
reg.setProviderStatus(s, "pd", "active");
|
|
542
|
-
reg.recordProviderSettlement(s, { provider_id: "pd", amount_minor: 1000 }); // accrue 500
|
|
543
|
-
return s;
|
|
544
|
-
};
|
|
545
|
-
try {
|
|
546
|
-
// 1. No signer configured -> refused, no payout created.
|
|
547
|
-
delete process.env.XYTARA_PAYOUT_SIGNER_URL;
|
|
548
|
-
let s = mk();
|
|
549
|
-
let r = await dispatchProviderPayout(s, "pd", { amount_minor: 100 }, loadPayoutSignerConfig());
|
|
550
|
-
assert.strictEqual(r.reason, "payout_signer_not_configured", "no signer -> refused");
|
|
551
|
-
assert.strictEqual(reg.listProviderPayouts(s).length, 0, "no payout created when signer unset");
|
|
552
|
-
|
|
553
|
-
// 2. Signer success -> payout settled with the returned tx, paid_out credited.
|
|
554
|
-
s = mk();
|
|
555
|
-
global.fetch = async () => ({ ok: true, status: 200, text: async () => JSON.stringify({ ok: true, tx_ref: "0xsent1" }) });
|
|
556
|
-
r = await dispatchProviderPayout(s, "pd", { amount_minor: 200 }, signer);
|
|
557
|
-
assert.strictEqual(r.ok, true, "dispatch ok");
|
|
558
|
-
assert.strictEqual(r.payout.status, "settled", "payout settled");
|
|
559
|
-
assert.strictEqual(r.payout.tx_ref, "0xsent1", "tx recorded");
|
|
560
|
-
assert.strictEqual(reg.computeProviderPayoutState(s, "pd").paid_out_minor, 200, "paid_out credited");
|
|
561
|
-
|
|
562
|
-
// 3. Signer explicit failure -> payout cancelled, reservation freed.
|
|
563
|
-
s = mk();
|
|
564
|
-
global.fetch = async () => ({ ok: true, status: 200, text: async () => JSON.stringify({ ok: false, reason: "insufficient_treasury" }) });
|
|
565
|
-
r = await dispatchProviderPayout(s, "pd", { amount_minor: 300 }, signer);
|
|
566
|
-
assert.strictEqual(r.reason, "payout_signer_rejected", "signer rejected");
|
|
567
|
-
assert.strictEqual(reg.listProviderPayouts(s, { provider_id: "pd" })[0].status, "cancelled", "rejected payout cancelled");
|
|
568
|
-
assert.strictEqual(reg.computeProviderPayoutState(s, "pd").available_minor, 500, "reservation freed");
|
|
569
|
-
assert.strictEqual(reg.computeProviderPayoutState(s, "pd").paid_out_minor, 0, "nothing paid");
|
|
570
|
-
|
|
571
|
-
// 4. Signer network error -> payout LEFT PENDING (ambiguous), reservation held.
|
|
572
|
-
s = mk();
|
|
573
|
-
global.fetch = async () => { throw new Error("socket hang up"); };
|
|
574
|
-
r = await dispatchProviderPayout(s, "pd", { amount_minor: 400 }, signer);
|
|
575
|
-
assert.strictEqual(r.reason, "payout_dispatch_unconfirmed", "ambiguous -> unconfirmed");
|
|
576
|
-
assert.strictEqual(reg.listProviderPayouts(s, { provider_id: "pd" })[0].status, "pending", "ambiguous payout LEFT PENDING");
|
|
577
|
-
assert.strictEqual(reg.computeProviderPayoutState(s, "pd").available_minor, 100, "reservation still held");
|
|
578
|
-
|
|
579
|
-
// 5. HTTP 200 ok:true but NO tx_ref -> AMBIGUOUS -> LEFT PENDING (never cancel a possible send).
|
|
580
|
-
s = mk();
|
|
581
|
-
global.fetch = async () => ({ ok: true, status: 200, text: async () => JSON.stringify({ ok: true }) });
|
|
582
|
-
r = await dispatchProviderPayout(s, "pd", { amount_minor: 100 }, signer);
|
|
583
|
-
assert.strictEqual(r.reason, "payout_dispatch_unconfirmed", "ok:true w/o tx_ref -> unconfirmed");
|
|
584
|
-
assert.strictEqual(reg.listProviderPayouts(s, { provider_id: "pd" })[0].status, "pending", "left pending (not cancelled)");
|
|
585
|
-
|
|
586
|
-
// 6. HTTP 5xx (even with a tx body = 5xx-after-send) -> AMBIGUOUS -> LEFT PENDING.
|
|
587
|
-
s = mk();
|
|
588
|
-
global.fetch = async () => ({ ok: false, status: 503, text: async () => JSON.stringify({ ok: true, tx_ref: "0xmaybe" }) });
|
|
589
|
-
r = await dispatchProviderPayout(s, "pd", { amount_minor: 100 }, signer);
|
|
590
|
-
assert.strictEqual(r.reason, "payout_dispatch_unconfirmed", "5xx -> unconfirmed");
|
|
591
|
-
assert.strictEqual(reg.listProviderPayouts(s, { provider_id: "pd" })[0].status, "pending", "5xx left pending (not cancelled)");
|
|
592
|
-
|
|
593
|
-
// 7. Non-JSON 200 body -> AMBIGUOUS -> LEFT PENDING.
|
|
594
|
-
s = mk();
|
|
595
|
-
global.fetch = async () => ({ ok: true, status: 200, text: async () => "oops not json" });
|
|
596
|
-
r = await dispatchProviderPayout(s, "pd", { amount_minor: 100 }, signer);
|
|
597
|
-
assert.strictEqual(r.reason, "payout_dispatch_unconfirmed", "non-JSON -> unconfirmed");
|
|
598
|
-
assert.strictEqual(reg.listProviderPayouts(s, { provider_id: "pd" })[0].status, "pending", "non-JSON left pending");
|
|
599
|
-
|
|
600
|
-
// 8. Buggy signer reuses a tx_ref -> confirm fails -> payout_confirm_failed (NOT false-success).
|
|
601
|
-
s = mk();
|
|
602
|
-
global.fetch = async () => ({ ok: true, status: 200, text: async () => JSON.stringify({ ok: true, tx_ref: "0xreuse" }) });
|
|
603
|
-
r = await dispatchProviderPayout(s, "pd", { amount_minor: 100 }, signer);
|
|
604
|
-
assert.strictEqual(r.ok, true, "first dispatch settles");
|
|
605
|
-
r = await dispatchProviderPayout(s, "pd", { amount_minor: 100 }, signer);
|
|
606
|
-
assert.strictEqual(r.reason, "payout_confirm_failed", "duplicate tx_ref -> confirm_failed, not ok");
|
|
607
|
-
assert.strictEqual(r.confirm_reason, "duplicate_tx_ref", "surfaces duplicate_tx_ref");
|
|
608
|
-
const pdp = reg.listProviderPayouts(s, { provider_id: "pd" });
|
|
609
|
-
assert.strictEqual(pdp[pdp.length - 1].status, "pending", "2nd payout left pending (not falsely settled)");
|
|
610
|
-
assert.strictEqual(reg.computeProviderPayoutState(s, "pd").paid_out_minor, 100, "only the first payout credited");
|
|
611
|
-
|
|
612
|
-
// 9. A cancel attempted WHILE the signer call is in flight is refused (the funds may be moving);
|
|
613
|
-
// the dispatch then settles normally and nothing was freed for a second send.
|
|
614
|
-
s = mk();
|
|
615
|
-
let cancelDuringFlight = null;
|
|
616
|
-
global.fetch = async () => {
|
|
617
|
-
const inFlight = reg.listProviderPayouts(s, { provider_id: "pd" }).find((p) => p.status === "pending");
|
|
618
|
-
cancelDuringFlight = reg.cancelProviderPayout(s, inFlight.payout_id);
|
|
619
|
-
return { ok: true, status: 200, text: async () => JSON.stringify({ ok: true, tx_ref: "0xinflight" }) };
|
|
620
|
-
};
|
|
621
|
-
r = await dispatchProviderPayout(s, "pd", { amount_minor: 100 }, signer);
|
|
622
|
-
assert.strictEqual(cancelDuringFlight && cancelDuringFlight.reason, "payout_in_flight", "cancel during dispatch refused");
|
|
623
|
-
assert.strictEqual(r.ok, true, "dispatch still settles after the refused cancel");
|
|
624
|
-
assert.strictEqual(reg.computeProviderPayoutState(s, "pd").paid_out_minor, 100, "paid_out credited once; no reservation was freed for a re-send");
|
|
625
|
-
assert.strictEqual(reg.computeProviderPayoutState(s, "pd").available_minor, 400, "available reflects exactly one payout");
|
|
626
|
-
} finally {
|
|
627
|
-
global.fetch = orig;
|
|
628
|
-
if (prevUrl === undefined) delete process.env.XYTARA_PAYOUT_SIGNER_URL; else process.env.XYTARA_PAYOUT_SIGNER_URL = prevUrl;
|
|
629
|
-
}
|
|
630
|
-
console.log(" payout-dispatch: unset->refused | ok->settled | rejected->cancelled | network->pending");
|
|
631
|
-
}
|
|
632
|
-
|
|
633
|
-
// Public integration contract: correct structure, reflects live limits, leaks no secrets.
|
|
634
|
-
function contractChecks() {
|
|
635
|
-
const { buildProviderNetworkContract } = require("../lib/provider_network_contract");
|
|
636
|
-
const c = buildProviderNetworkContract();
|
|
637
|
-
assert.strictEqual(c.ok, true, "contract ok");
|
|
638
|
-
assert.strictEqual(c.contract_version, "provider-network/v1", "contract version");
|
|
639
|
-
assert.strictEqual(c.registration.endpoint, "POST /v1/provider-network/register", "registration endpoint");
|
|
640
|
-
assert.ok(c.execution_contract.request.body.task_ref, "execution request shape present");
|
|
641
|
-
assert.deepStrictEqual(c.execution_contract.response.failure_semantics.failover_safe_statuses, [408, 429, 503], "failover-safe statuses documented");
|
|
642
|
-
assert.ok(c.routing.reputation.routing_score && c.economics.revenue_share, "routing + economics present");
|
|
643
|
-
// No secrets leak into the public contract.
|
|
644
|
-
const s = JSON.stringify(c).toLowerCase();
|
|
645
|
-
assert.ok(!/prvown_[0-9a-f]{12,}/.test(s), "no REAL owner_secret value in contract (format example is fine)");
|
|
646
|
-
assert.ok(!/bearer\s+[a-z0-9]{16,}/.test(s), "no concrete bearer token in contract");
|
|
647
|
-
// Reflects the live revenue-share cap.
|
|
648
|
-
const prevMax = process.env.XYTARA_PROVIDER_MAX_REVENUE_SHARE_BPS;
|
|
649
|
-
process.env.XYTARA_PROVIDER_MAX_REVENUE_SHARE_BPS = "8000";
|
|
650
|
-
try {
|
|
651
|
-
assert.ok(buildProviderNetworkContract().registration.body.revenue_share_bps.includes("8000"), "contract reflects the live max revenue-share cap");
|
|
652
|
-
} finally {
|
|
653
|
-
if (prevMax === undefined) delete process.env.XYTARA_PROVIDER_MAX_REVENUE_SHARE_BPS; else process.env.XYTARA_PROVIDER_MAX_REVENUE_SHARE_BPS = prevMax;
|
|
654
|
-
}
|
|
655
|
-
}
|
|
656
|
-
|
|
657
|
-
// Ledger + routing hardening: registration-epoch isolation on provider_id re-use, the in-flight
|
|
658
|
-
// cancel guard, the per-target timeout cap, settlement-basis bookkeeping and the quote-vs-settled
|
|
659
|
-
// reconciliation rule, the endpoint policy, and the shared execution budget.
|
|
660
|
-
async function hardeningChecks() {
|
|
661
|
-
const reg = require("../lib/provider_registry");
|
|
662
|
-
|
|
663
|
-
// 13. EPOCH ISOLATION: rows belong to a registration, not to the id. Force-removing a provider
|
|
664
|
-
// cancels its (not in-flight) pending payouts; re-registering the same id mints a fresh owner
|
|
665
|
-
// and sees NONE of the previous owner's settlements / payouts / reservations.
|
|
666
|
-
const ep = {};
|
|
667
|
-
const first = reg.registerProvider(ep, { provider_id: "ep_1", endpoint_url: "https://ep/x", task_refs: ["t"], revenue_share_bps: 7000, payout_address: "0x" + "1".repeat(40) });
|
|
668
|
-
reg.setProviderStatus(ep, "ep_1", "active");
|
|
669
|
-
reg.recordProviderSettlement(ep, { provider_id: "ep_1", amount_minor: 100 }); // owed 70
|
|
670
|
-
const epPay = reg.createProviderPayout(ep, "ep_1", { amount_minor: 50 });
|
|
671
|
-
const removed = reg.removeProvider(ep, "ep_1", { force: true });
|
|
672
|
-
assert.strictEqual(removed.ok, true, "force remove ok");
|
|
673
|
-
assert.deepStrictEqual(removed.cancelled_pending_payouts, [epPay.payout.payout_id], "remove cancels the orphaned pending payout");
|
|
674
|
-
assert.strictEqual(reg.getProviderPayout(ep, epPay.payout.payout_id).status, "cancelled", "orphaned pending payout cancelled");
|
|
675
|
-
const second = reg.registerProvider(ep, { provider_id: "ep_1", endpoint_url: "https://ep2/x", task_refs: ["t"], revenue_share_bps: 7000, payout_address: "0x" + "2".repeat(40) });
|
|
676
|
-
assert.ok(second.owner_secret && second.owner_secret !== first.owner_secret, "re-registered id gets a fresh owner_secret");
|
|
677
|
-
const view = reg.buildProviderEarningsView(ep, "ep_1");
|
|
678
|
-
assert.strictEqual(view.settlements.length, 0, "new registration sees none of the previous owner's settlements");
|
|
679
|
-
assert.strictEqual(view.payouts.length, 0, "new registration sees none of the previous owner's payouts");
|
|
680
|
-
assert.strictEqual(view.payout_state.accrued_minor, 0, "fresh accrued");
|
|
681
|
-
assert.strictEqual(view.payout_state.available_minor, 0, "no inherited reservation");
|
|
682
|
-
assert.strictEqual(reg.listProviderSettlements(ep, { provider_id: "ep_1" }).length, 1, "operator audit trail of the old registration is retained");
|
|
683
|
-
// Confirming an OLD-epoch payout is recorded but can never credit the NEW registration's rollup.
|
|
684
|
-
reg.setProviderStatus(ep, "ep_1", "active");
|
|
685
|
-
reg.recordProviderSettlement(ep, { provider_id: "ep_1", amount_minor: 100 });
|
|
686
|
-
ep.providerPayouts.push({ ...epPay.payout, payout_id: "provpay_oldepoch", status: "pending", cancelled_at_iso: null, amount_minor: 10 });
|
|
687
|
-
const oldConf = reg.confirmProviderPayout(ep, "provpay_oldepoch", { tx_ref: "0xold" });
|
|
688
|
-
assert.strictEqual(oldConf.ok, true, "old-epoch payout can still be confirmed for the record");
|
|
689
|
-
assert.strictEqual(oldConf.rollup_credited, false, "but it is NOT credited to the new registration");
|
|
690
|
-
assert.strictEqual(reg.computeProviderPayoutState(ep, "ep_1").paid_out_minor, 0, "new registration paid_out untouched by an old-epoch confirm");
|
|
691
|
-
|
|
692
|
-
// 14. IN-FLIGHT GUARD: a payout mid-dispatch cannot be cancelled; once dispatch completes it can;
|
|
693
|
-
// a cancelled payout whose signer later reports a tx is reinstated for reconciliation.
|
|
694
|
-
const inf = {};
|
|
695
|
-
reg.registerProvider(inf, { provider_id: "inf", endpoint_url: "https://inf/x", task_refs: ["t"], revenue_share_bps: 5000, payout_address: "0x" + "3".repeat(40) });
|
|
696
|
-
reg.setProviderStatus(inf, "inf", "active");
|
|
697
|
-
reg.recordProviderSettlement(inf, { provider_id: "inf", amount_minor: 1000 });
|
|
698
|
-
const infPay = reg.createProviderPayout(inf, "inf", { amount_minor: 100 });
|
|
699
|
-
reg.markProviderPayoutDispatch(inf, infPay.payout.payout_id, "in_flight");
|
|
700
|
-
assert.strictEqual(reg.cancelProviderPayout(inf, infPay.payout.payout_id).reason, "payout_in_flight", "in-flight payout cannot be cancelled");
|
|
701
|
-
assert.strictEqual(reg.computeProviderPayoutState(inf, "inf").pending_minor, 100, "reservation still held while in flight");
|
|
702
|
-
reg.markProviderPayoutDispatch(inf, infPay.payout.payout_id, null);
|
|
703
|
-
assert.strictEqual(reg.cancelProviderPayout(inf, infPay.payout.payout_id).ok, true, "cancellable once dispatch completed");
|
|
704
|
-
const re = reg.reinstateCancelledPayoutForReconciliation(inf, infPay.payout.payout_id, "0xlate");
|
|
705
|
-
assert.strictEqual(re.ok, true, "reinstated");
|
|
706
|
-
assert.strictEqual(reg.getProviderPayout(inf, infPay.payout.payout_id).status, "pending", "reinstated payout is pending again");
|
|
707
|
-
assert.strictEqual(reg.getProviderPayout(inf, infPay.payout.payout_id).reconcile_required, true, "flagged for reconciliation");
|
|
708
|
-
assert.strictEqual(reg.computeProviderPayoutState(inf, "inf").pending_minor, 100, "reservation re-held");
|
|
709
|
-
|
|
710
|
-
// 15. TIMEOUT CAP: a provider cannot register a timeout the x402 window could not settle behind.
|
|
711
|
-
const tc = {};
|
|
712
|
-
const tcr = reg.registerProvider(tc, { provider_id: "tc", endpoint_url: "https://tc/x", task_refs: ["t"], revenue_share_bps: 5000, timeout_ms: 999999 });
|
|
713
|
-
assert.strictEqual(tcr.provider.timeout_ms, 30000, "timeout_ms capped at 30000");
|
|
714
|
-
|
|
715
|
-
// 16. SETTLEMENT BASIS: the ledger records what the accrual was based on.
|
|
716
|
-
const sb = reg.recordProviderSettlement(tc, { provider_id: "tc", amount_minor: 1, quoted_minor: 500, settled_minor: 1, settlement_basis: "x402_settled_min_quote" });
|
|
717
|
-
assert.strictEqual(sb.settlement.quoted_minor, 500, "quoted_minor recorded");
|
|
718
|
-
assert.strictEqual(sb.settlement.settlement_basis, "x402_settled_min_quote", "settlement_basis recorded");
|
|
719
|
-
assert.strictEqual(sb.settlement.gross_minor, 1, "accrues on the reconciled amount, not the quote");
|
|
720
|
-
|
|
721
|
-
// 16b. RECONCILIATION RULE (command_flow): x402 settles USDC base units; accrual = min(quote, settled).
|
|
722
|
-
delete require.cache[require.resolve("../lib/command_flow")];
|
|
723
|
-
const { reconcileProviderSettlementAmount } = require("../lib/command_flow");
|
|
724
|
-
const usdc = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
|
|
725
|
-
let rc = reconcileProviderSettlementAmount({ amount_minor: 500, currency: "USD_CENTS" }, { verification_mode: "x402_facilitator", payment_payload: { x402_asset: usdc, x402_amount: "10000" } });
|
|
726
|
-
assert.strictEqual(rc.amount_minor, 1, "quote 500c but only 1c ($0.01 USDC) settled -> accrue 1c");
|
|
727
|
-
assert.strictEqual(rc.settlement_basis, "x402_settled_min_quote", "basis recorded");
|
|
728
|
-
rc = reconcileProviderSettlementAmount({ amount_minor: 1, currency: "USD_CENTS" }, { verification_mode: "x402_facilitator", payment_payload: { x402_asset: usdc, x402_amount: "50000" } });
|
|
729
|
-
assert.strictEqual(rc.amount_minor, 1, "settled more than quoted -> accrue the quote (never above it)");
|
|
730
|
-
rc = reconcileProviderSettlementAmount({ amount_minor: 500, currency: "USD_CENTS" }, { verification_mode: "x402_facilitator", payment_payload: { x402_asset: "0x" + "9".repeat(40), x402_amount: "10000" } });
|
|
731
|
-
assert.strictEqual(rc.amount_minor, 0, "unknown asset -> unreconciled -> nothing accrues on the quote");
|
|
732
|
-
assert.strictEqual(rc.reconciled, false, "flagged unreconciled");
|
|
733
|
-
rc = reconcileProviderSettlementAmount({ amount_minor: 500, currency: "USD_CENTS" }, { verification_mode: "local_signed", payment_payload: { amount_minor: 500 } });
|
|
734
|
-
assert.strictEqual(rc.amount_minor, 500, "non-x402 lanes bind the paid amount to the quote at verification -> quote basis");
|
|
735
|
-
|
|
736
|
-
// 17. ENDPOINT POLICY (strict): https only, no loopback/private/link-local/metadata hosts, no creds.
|
|
737
|
-
const prevPol = process.env.XYTARA_PROVIDER_ENDPOINT_POLICY;
|
|
738
|
-
process.env.XYTARA_PROVIDER_ENDPOINT_POLICY = "strict";
|
|
739
|
-
try {
|
|
740
|
-
const pol = {};
|
|
741
|
-
const bad = (url) => reg.registerProvider(pol, { endpoint_url: url, task_refs: ["t"], revenue_share_bps: 1000 }).reason;
|
|
742
|
-
assert.strictEqual(bad("http://provider.example/x"), "endpoint_url_insecure", "strict: http refused");
|
|
743
|
-
assert.strictEqual(bad("https://127.0.0.1/x"), "endpoint_url_not_public", "strict: loopback refused");
|
|
744
|
-
assert.strictEqual(bad("https://10.0.0.5/x"), "endpoint_url_not_public", "strict: private range refused");
|
|
745
|
-
assert.strictEqual(bad("https://169.254.169.254/latest/meta-data"), "endpoint_url_not_public", "strict: metadata address refused");
|
|
746
|
-
assert.strictEqual(bad("https://localhost/x"), "endpoint_url_not_public", "strict: localhost refused");
|
|
747
|
-
assert.strictEqual(bad("https://[::1]/x"), "endpoint_url_not_public", "strict: IPv6 loopback refused");
|
|
748
|
-
assert.strictEqual(bad("https://user:pw@provider.example/x"), "endpoint_url_credentials_not_allowed", "credentials in the URL refused");
|
|
749
|
-
assert.strictEqual(reg.registerProvider(pol, { endpoint_url: "https://provider.example/x", task_refs: ["t"], revenue_share_bps: 1000 }).ok, true, "strict: public https accepted");
|
|
750
|
-
} finally {
|
|
751
|
-
if (prevPol === undefined) delete process.env.XYTARA_PROVIDER_ENDPOINT_POLICY; else process.env.XYTARA_PROVIDER_ENDPOINT_POLICY = prevPol;
|
|
752
|
-
}
|
|
753
|
-
|
|
754
|
-
// 18. SHARED EXECUTION BUDGET: an exhausted budget never sends anything and stops the chain.
|
|
755
|
-
delete require.cache[require.resolve("../lib/external_execution_runtime")];
|
|
756
|
-
const { executeExternalTarget } = require("../lib/external_execution_runtime");
|
|
757
|
-
const orig = global.fetch;
|
|
758
|
-
let fetched = 0;
|
|
759
|
-
global.fetch = async () => { fetched++; return { ok: true, status: 200, headers: { get: () => null }, text: async () => "{}" }; };
|
|
760
|
-
try {
|
|
761
|
-
const t = { target_id: "b", endpoint_url: "https://b.example/x", provider: "p", timeout_ms: 1000 };
|
|
762
|
-
const r = await executeExternalTarget(t, { task_ref: "t" }, {}, null, { deadline_ms: Date.now() - 1 });
|
|
763
|
-
assert.strictEqual(r.reason, "external_execution_budget_exhausted", "exhausted budget -> no execution");
|
|
764
|
-
assert.strictEqual(r.failover_safe, false, "exhausted budget stops the failover chain");
|
|
765
|
-
assert.strictEqual(fetched, 0, "nothing was sent");
|
|
766
|
-
const ok = await executeExternalTarget(t, { task_ref: "t" }, {}, null, { deadline_ms: Date.now() + 5000 });
|
|
767
|
-
assert.strictEqual(ok.ok, true, "within budget executes normally");
|
|
768
|
-
assert.strictEqual(fetched, 1, "exactly one send within budget");
|
|
769
|
-
} finally {
|
|
770
|
-
global.fetch = orig;
|
|
771
|
-
}
|
|
772
|
-
// 19. ADAPTER DEPTH counts active open-network providers (labelled registry-routed) when given
|
|
773
|
-
// state; without state it stays env-target-only; a whole-lane env pin shadows the registry.
|
|
774
|
-
const { buildAdapterDepthPack, summarizeAdapterDepthPack } = require("../lib/adapter_depth_contract");
|
|
775
|
-
const prevTargets = process.env.XYTARA_EXECUTION_TARGETS_JSON;
|
|
776
|
-
delete process.env.XYTARA_EXECUTION_TARGETS_JSON;
|
|
777
|
-
try {
|
|
778
|
-
const ad = {};
|
|
779
|
-
assert.strictEqual(summarizeAdapterDepthPack(ad).adapter_depth_state, "provider_wiring_required", "no env targets + no providers -> wiring required");
|
|
780
|
-
reg.registerProvider(ad, { provider_id: "ad_mcp", endpoint_url: "https://ad.example/execute", task_refs: ["adapter.mcp.invoke"], tool_names: ["keccak256"], revenue_share_bps: 7000, auth_token: "t" });
|
|
781
|
-
assert.strictEqual(summarizeAdapterDepthPack(ad).adapter_depth_state, "provider_wiring_required", "a PENDING provider is not a live path");
|
|
782
|
-
reg.setProviderStatus(ad, "ad_mcp", "active");
|
|
783
|
-
let pack = buildAdapterDepthPack(ad);
|
|
784
|
-
assert.strictEqual(pack.adapter_depth_state, "initial_provider_live_path", "one active registry provider -> initial live path");
|
|
785
|
-
const invoke = pack.adapter_tasks.find((t) => t.task_ref === "adapter.mcp.invoke");
|
|
786
|
-
assert.strictEqual(invoke.registry_provider_count, 1, "registry provider counted on its declared task");
|
|
787
|
-
assert.strictEqual(invoke.execution_targets[0].routing, "open_provider_registry", "labelled registry-routed");
|
|
788
|
-
assert.strictEqual(invoke.execution_targets[0].auth_token, undefined, "no auth_token leaks into the depth pack");
|
|
789
|
-
assert.deepStrictEqual(pack.public_claim_boundary.live_task_refs, ["adapter.mcp.invoke"], "claim limited to the declared task");
|
|
790
|
-
assert.strictEqual(buildAdapterDepthPack().adapter_depth_state, "provider_wiring_required", "no state -> env-only (unchanged for internal callers)");
|
|
791
|
-
reg.registerProvider(ad, { provider_id: "ad_mcp2", endpoint_url: "https://ad2.example/execute", task_refs: ["adapter.mcp.invoke"], revenue_share_bps: 7000 });
|
|
792
|
-
reg.setProviderStatus(ad, "ad_mcp2", "active");
|
|
793
|
-
assert.strictEqual(summarizeAdapterDepthPack(ad).adapter_depth_state, "provider_live_path_deepened", "two covered live paths -> deepened");
|
|
794
|
-
process.env.XYTARA_EXECUTION_TARGETS_JSON = JSON.stringify([{ target_id: "pin", task_ref: "adapter.mcp.invoke", endpoint_url: "https://pin.example/execute", provider: "pin_provider", enabled: true }]);
|
|
795
|
-
pack = buildAdapterDepthPack(ad);
|
|
796
|
-
const pinned = pack.adapter_tasks.find((t) => t.task_ref === "adapter.mcp.invoke");
|
|
797
|
-
assert.ok(pinned.execution_targets.filter((t) => t.routing === "open_provider_registry").every((t) => t.shadowed_by_env_target && !t.enabled), "whole-lane env pin shadows registry providers");
|
|
798
|
-
assert.strictEqual(pinned.registry_provider_count, 0, "shadowed providers are not counted");
|
|
799
|
-
} finally {
|
|
800
|
-
if (prevTargets === undefined) delete process.env.XYTARA_EXECUTION_TARGETS_JSON; else process.env.XYTARA_EXECUTION_TARGETS_JSON = prevTargets;
|
|
801
|
-
}
|
|
802
|
-
|
|
803
|
-
console.log(" hardening: epoch-isolation | in-flight guard | timeout cap | settlement basis | endpoint policy | budget | adapter-depth registry");
|
|
804
|
-
}
|
|
805
|
-
|
|
806
|
-
async function main() {
|
|
807
|
-
libChecks();
|
|
808
|
-
contractChecks();
|
|
809
|
-
await hardeningChecks();
|
|
810
|
-
await httpChecks();
|
|
811
|
-
await failoverChecks();
|
|
812
|
-
await payoutDispatchChecks();
|
|
813
|
-
console.log("xytara verify:provider-network passed");
|
|
814
|
-
}
|
|
815
|
-
|
|
816
|
-
main().catch((error) => {
|
|
817
|
-
console.error(error && error.message ? error.message : error);
|
|
818
|
-
process.exitCode = 1;
|
|
819
|
-
});
|