xytara 2.5.0 → 2.7.0

package/TREASURY_DESTINATIONS.example.json

@@ -0,0 +1,66 @@
+{
+  "bsv_teranode": {
+    "destination_id": "treasury_bsv_main",
+    "destination_kind": "bsv_teranode_address",
+    "external_ref": "1ReplaceWithRealBsvAddressOrPaymail",
+    "custody_ref": "vault.bsv.primary",
+    "reporting_ref": "ledger.bsv.primary",
+    "wallet_ref": "wallet.bsv.primary",
+    "provider_ref": "arc.bsv.primary",
+    "network": "mainnet",
+    "storage_class": "cold_primary"
+  },
+  "evm": {
+    "destination_id": "treasury_evm_main",
+    "destination_kind": "evm_address",
+    "external_ref": "0xReplaceWithRealEvmTreasuryAddress",
+    "chain_id": "1",
+    "custody_ref": "vault.evm.primary",
+    "reporting_ref": "ledger.evm.primary",
+    "wallet_ref": "wallet.evm.primary",
+    "provider_ref": "rpc.evm.primary",
+    "storage_class": "warm_operational"
+  },
+  "base": {
+    "destination_id": "treasury_base_main",
+    "destination_kind": "evm_address",
+    "external_ref": "0xReplaceWithRealBaseTreasuryAddress",
+    "chain_id": "8453",
+    "custody_ref": "vault.base.primary",
+    "reporting_ref": "ledger.base.primary",
+    "wallet_ref": "wallet.base.primary",
+    "provider_ref": "rpc.base.primary",
+    "storage_class": "warm_operational"
+  },
+  "usdc": {
+    "destination_id": "treasury_usdc_primary",
+    "destination_kind": "stablecoin_address",
+    "external_ref": "0xReplaceWithRealUsdcReceivingAddress",
+    "asset_symbol": "USDC",
+    "chain_id": "8453",
+    "custody_ref": "vault.usdc.primary",
+    "reporting_ref": "ledger.usdc.primary",
+    "wallet_ref": "wallet.usdc.primary",
+    "storage_class": "warm_operational"
+  },
+  "dai": {
+    "destination_id": "treasury_dai_primary",
+    "destination_kind": "stablecoin_address",
+    "external_ref": "0xReplaceWithRealDaiReceivingAddress",
+    "asset_symbol": "DAI",
+    "chain_id": "1",
+    "custody_ref": "vault.dai.primary",
+    "reporting_ref": "ledger.dai.primary",
+    "wallet_ref": "wallet.dai.primary",
+    "storage_class": "warm_operational"
+  },
+  "monero": {
+    "destination_id": "treasury_monero_private",
+    "destination_kind": "monero_address",
+    "external_ref": "8ReplaceWithRealMoneroAddress",
+    "policy_scope": "internal_optional_privacy_reserve",
+    "custody_ref": "vault.monero.policy_gated",
+    "reporting_ref": "ledger.monero.internal",
+    "storage_class": "isolated_policy_gated"
+  }
+}

package/TREASURY_DESTINATIONS.production.template.json

@@ -0,0 +1,108 @@
+{
+  "_notes": [
+    "Copy this file to TREASURY_DESTINATIONS.production.json and replace every placeholder before use.",
+    "Only claim a rail as live treasury landing if its entry has a real destination you control.",
+    "external_ref is the real receiving destination: address, paymail, or equivalent custody landing reference.",
+    "monero should remain internal-only and policy-gated."
+  ],
+  "bsv_teranode": {
+    "destination_id": "treasury_bsv_main",
+    "destination_kind": "bsv_teranode_address",
+    "external_ref": "REPLACE_WITH_REAL_BSV_ADDRESS_OR_PAYMAIL",
+    "custody_ref": "vault.bsv.primary",
+    "reporting_ref": "ledger.bsv.primary",
+    "wallet_ref": "wallet.bsv.primary",
+    "provider_ref": "arc.bsv.primary",
+    "network": "mainnet",
+    "storage_class": "cold_primary"
+  },
+  "evm": {
+    "destination_id": "treasury_evm_main",
+    "destination_kind": "evm_address",
+    "external_ref": "REPLACE_WITH_REAL_EVM_MAINNET_ADDRESS",
+    "chain_id": "1",
+    "custody_ref": "vault.evm.primary",
+    "reporting_ref": "ledger.evm.primary",
+    "wallet_ref": "wallet.evm.primary",
+    "provider_ref": "rpc.evm.primary",
+    "storage_class": "warm_operational"
+  },
+  "base": {
+    "destination_id": "treasury_base_main",
+    "destination_kind": "evm_address",
+    "external_ref": "REPLACE_WITH_REAL_BASE_ADDRESS",
+    "chain_id": "8453",
+    "custody_ref": "vault.base.primary",
+    "reporting_ref": "ledger.base.primary",
+    "wallet_ref": "wallet.base.primary",
+    "provider_ref": "rpc.base.primary",
+    "storage_class": "warm_operational"
+  },
+  "solana_payment": {
+    "destination_id": "treasury_solana_main",
+    "destination_kind": "solana_address",
+    "external_ref": "REPLACE_WITH_REAL_SOLANA_ADDRESS",
+    "network": "mainnet-beta",
+    "asset_symbol": "SOL_OR_SPL",
+    "custody_ref": "vault.solana.primary",
+    "reporting_ref": "ledger.solana.primary",
+    "wallet_ref": "wallet.solana.primary",
+    "provider_ref": "rpc.solana.primary",
+    "storage_class": "warm_operational"
+  },
+  "xpr_payment": {
+    "destination_id": "treasury_xpr_main",
+    "destination_kind": "proton_xpr_account",
+    "external_ref": "REPLACE_WITH_REAL_XPR_ACCOUNT",
+    "network": "mainnet",
+    "asset_symbol": "XPR",
+    "custody_ref": "vault.xpr.primary",
+    "reporting_ref": "ledger.xpr.primary",
+    "wallet_ref": "wallet.xpr.primary",
+    "provider_ref": "rpc.xpr.primary",
+    "storage_class": "warm_operational"
+  },
+  "antelope_payment": {
+    "destination_id": "treasury_antelope_main",
+    "destination_kind": "antelope_account",
+    "external_ref": "REPLACE_WITH_REAL_ANTELOPE_ACCOUNT",
+    "network": "mainnet",
+    "asset_symbol": "EOSIO_OR_ANTILOPE",
+    "custody_ref": "vault.antelope.primary",
+    "reporting_ref": "ledger.antelope.primary",
+    "wallet_ref": "wallet.antelope.primary",
+    "provider_ref": "rpc.antelope.primary",
+    "storage_class": "warm_operational"
+  },
+  "usdc": {
+    "destination_id": "treasury_usdc_primary",
+    "destination_kind": "stablecoin_address",
+    "external_ref": "REPLACE_WITH_REAL_USDC_RECEIVING_ADDRESS",
+    "asset_symbol": "USDC",
+    "chain_id": "8453",
+    "custody_ref": "vault.usdc.primary",
+    "reporting_ref": "ledger.usdc.primary",
+    "wallet_ref": "wallet.usdc.primary",
+    "storage_class": "warm_operational"
+  },
+  "dai": {
+    "destination_id": "treasury_dai_primary",
+    "destination_kind": "stablecoin_address",
+    "external_ref": "REPLACE_WITH_REAL_DAI_RECEIVING_ADDRESS",
+    "asset_symbol": "DAI",
+    "chain_id": "1",
+    "custody_ref": "vault.dai.primary",
+    "reporting_ref": "ledger.dai.primary",
+    "wallet_ref": "wallet.dai.primary",
+    "storage_class": "warm_operational"
+  },
+  "monero": {
+    "destination_id": "treasury_monero_private",
+    "destination_kind": "monero_address",
+    "external_ref": "REPLACE_WITH_REAL_MONERO_ADDRESS",
+    "policy_scope": "internal_optional_privacy_reserve",
+    "custody_ref": "vault.monero.policy_gated",
+    "reporting_ref": "ledger.monero.internal",
+    "storage_class": "isolated_policy_gated"
+  }
+}

package/adapters/examples/langchain-reference-execution-adapter.js

@@ -0,0 +1,81 @@
+"use strict";
+
+const fs = require("fs");
+const path = require("path");
+
+const manifest = JSON.parse(
+  fs.readFileSync(path.resolve(__dirname, "langchain-reference-execution-adapter.manifest.json"), "utf8")
+);
+
+function normalizeChainRequest(request) {
+  const body = request && request.body && typeof request.body === "object" ? request.body : {};
+  const chainRef = String(body.chain_ref || body.chain_id || request.task_ref || "langchain.reference.chain").trim();
+  const toolTraceRef = String(body.tool_trace_ref || body.trace_id || "trace.reference").trim();
+  const contextRef = String(body.context_ref || body.session_id || "context.reference").trim();
+  return {
+    chain_ref: chainRef,
+    tool_trace_ref: toolTraceRef,
+    context_ref: contextRef,
+    input: body.input && typeof body.input === "object" ? body.input : {}
+  };
+}
+
+async function getHealth() {
+  return {
+    status: "ok",
+    readiness: "ready",
+    adapter_id: manifest.adapter_id,
+    provider_claim: "reference_local_contract_adapter"
+  };
+}
+
+function describeCapabilities() {
+  return {
+    adapter_id: manifest.adapter_id,
+    adapter_class: manifest.adapter_class,
+    capabilities: manifest.capabilities.slice(),
+    execution_modes: Array.isArray(manifest.execution_modes) ? manifest.execution_modes.slice() : [],
+    claim_boundary: "normalizes_langchain_style_payloads_without_claiming_external_provider_execution"
+  };
+}
+
+async function preview(request) {
+  const normalized = normalizeChainRequest(request || {});
+  return {
+    adapter_id: manifest.adapter_id,
+    accepted: true,
+    preview: {
+      mode: "preview",
+      ...normalized
+    }
+  };
+}
+
+async function execute(request) {
+  const normalized = normalizeChainRequest(request || {});
+  return {
+    adapter_id: manifest.adapter_id,
+    status: "completed",
+    result: {
+      mode: "execute",
+      framework: "langchain",
+      ...normalized
+    },
+    proof_facts: {
+      emits_proof_compatible_facts: true,
+      proof_mode: manifest.proof_contract.proof_mode,
+      framework: "langchain",
+      chain_ref: normalized.chain_ref,
+      tool_trace_ref: normalized.tool_trace_ref,
+      context_ref: normalized.context_ref
+    }
+  };
+}
+
+module.exports = {
+  manifest,
+  getHealth,
+  describeCapabilities,
+  preview,
+  execute
+};

package/adapters/examples/langchain-reference-execution-adapter.manifest.json

@@ -0,0 +1,79 @@
+{
+  "adapter_id": "reference.framework.langchain",
+  "adapter_class": "execution_adapter",
+  "adapter_version": "0.1.0",
+  "interface_version": "commerce-adapter-interface/v1",
+  "display_name": "LangChain Reference Execution Adapter",
+  "description": "Reference execution adapter for LangChain-style chain, tool, and trace payloads without claiming a live external LangChain provider.",
+  "capabilities": [
+    "framework.langchain.preview",
+    "framework.langchain.execute"
+  ],
+  "compatibility": {
+    "node": ">=18",
+    "commerce_contract": "xytara/v1",
+    "proof_contract": "xoonya/v1"
+  },
+  "health_contract": {
+    "check_kind": "self_reported",
+    "supports_readiness": true
+  },
+  "idempotency_contract": {
+    "strategy": "caller_supplied_key",
+    "scope": "framework_execution"
+  },
+  "failure_contract": {
+    "categories": [
+      "invalid_chain_payload",
+      "timeout",
+      "upstream_unavailable"
+    ],
+    "retryable_categories": [
+      "timeout",
+      "upstream_unavailable"
+    ]
+  },
+  "proof_contract": {
+    "emits_proof_compatible_facts": true,
+    "proof_mode": "framework_execution_facts"
+  },
+  "latency_class": "interactive",
+  "pricing_basis": "per_chain_execution",
+  "execution_modes": [
+    "sync"
+  ],
+  "required_secrets": [],
+  "required_permissions": [],
+  "supported_profiles": [
+    "reference",
+    "framework"
+  ],
+  "supported_regions": [
+    "local"
+  ],
+  "supported_settlement_modes": [
+    "credits_first",
+    "bsv_teranode",
+    "x402"
+  ],
+  "registration_contract": {
+    "integration_id": "reference.framework.langchain",
+    "integration_maturity": "reference_example",
+    "bundled": true,
+    "default_selection_enabled": false,
+    "selection_priority": 430,
+    "requires_explicit_selection": true
+  },
+  "certification_contract": {
+    "certification_state": "reference_example",
+    "certification_scope": [
+      "contract_shape",
+      "framework_payload_normalization",
+      "proof_fact_emission"
+    ],
+    "verified_with": [
+      "npm run verify:adapters"
+    ],
+    "last_verified_contract_version": "commerce-adapter-interface/v1"
+  }
+}

package/adapters/examples/langgraph-reference-execution-adapter.js

@@ -0,0 +1,81 @@
+"use strict";
+
+const fs = require("fs");
+const path = require("path");
+
+const manifest = JSON.parse(
+  fs.readFileSync(path.resolve(__dirname, "langgraph-reference-execution-adapter.manifest.json"), "utf8")
+);
+
+function normalizeGraphRequest(request) {
+  const body = request && request.body && typeof request.body === "object" ? request.body : {};
+  const graphRef = String(body.graph_ref || body.graph_id || request.task_ref || "langgraph.reference.graph").trim();
+  const nodeRef = String(body.node_ref || body.node_id || "entry").trim();
+  const checkpointRef = String(body.checkpoint_ref || body.thread_id || "checkpoint.reference").trim();
+  return {
+    graph_ref: graphRef,
+    node_ref: nodeRef,
+    checkpoint_ref: checkpointRef,
+    input: body.input && typeof body.input === "object" ? body.input : {}
+  };
+}
+
+async function getHealth() {
+  return {
+    status: "ok",
+    readiness: "ready",
+    adapter_id: manifest.adapter_id,
+    provider_claim: "reference_local_contract_adapter"
+  };
+}
+
+function describeCapabilities() {
+  return {
+    adapter_id: manifest.adapter_id,
+    adapter_class: manifest.adapter_class,
+    capabilities: manifest.capabilities.slice(),
+    execution_modes: Array.isArray(manifest.execution_modes) ? manifest.execution_modes.slice() : [],
+    claim_boundary: "normalizes_langgraph_style_payloads_without_claiming_external_provider_execution"
+  };
+}
+
+async function preview(request) {
+  const normalized = normalizeGraphRequest(request || {});
+  return {
+    adapter_id: manifest.adapter_id,
+    accepted: true,
+    preview: {
+      mode: "preview",
+      ...normalized
+    }
+  };
+}
+
+async function execute(request) {
+  const normalized = normalizeGraphRequest(request || {});
+  return {
+    adapter_id: manifest.adapter_id,
+    status: "completed",
+    result: {
+      mode: "execute",
+      framework: "langgraph",
+      ...normalized
+    },
+    proof_facts: {
+      emits_proof_compatible_facts: true,
+      proof_mode: manifest.proof_contract.proof_mode,
+      framework: "langgraph",
+      graph_ref: normalized.graph_ref,
+      node_ref: normalized.node_ref,
+      checkpoint_ref: normalized.checkpoint_ref
+    }
+  };
+}
+
+module.exports = {
+  manifest,
+  getHealth,
+  describeCapabilities,
+  preview,
+  execute
+};

package/adapters/examples/langgraph-reference-execution-adapter.manifest.json

@@ -0,0 +1,79 @@
+{
+  "adapter_id": "reference.framework.langgraph",
+  "adapter_class": "execution_adapter",
+  "adapter_version": "0.1.0",
+  "interface_version": "commerce-adapter-interface/v1",
+  "display_name": "LangGraph Reference Execution Adapter",
+  "description": "Reference execution adapter for LangGraph-style graph, node, and checkpoint payloads without claiming a live external LangGraph provider.",
+  "capabilities": [
+    "framework.langgraph.preview",
+    "framework.langgraph.execute"
+  ],
+  "compatibility": {
+    "node": ">=18",
+    "commerce_contract": "xytara/v1",
+    "proof_contract": "xoonya/v1"
+  },
+  "health_contract": {
+    "check_kind": "self_reported",
+    "supports_readiness": true
+  },
+  "idempotency_contract": {
+    "strategy": "caller_supplied_key",
+    "scope": "framework_execution"
+  },
+  "failure_contract": {
+    "categories": [
+      "invalid_graph_payload",
+      "timeout",
+      "upstream_unavailable"
+    ],
+    "retryable_categories": [
+      "timeout",
+      "upstream_unavailable"
+    ]
+  },
+  "proof_contract": {
+    "emits_proof_compatible_facts": true,
+    "proof_mode": "framework_execution_facts"
+  },
+  "latency_class": "interactive",
+  "pricing_basis": "per_graph_execution",
+  "execution_modes": [
+    "sync"
+  ],
+  "required_secrets": [],
+  "required_permissions": [],
+  "supported_profiles": [
+    "reference",
+    "framework"
+  ],
+  "supported_regions": [
+    "local"
+  ],
+  "supported_settlement_modes": [
+    "credits_first",
+    "bsv_teranode",
+    "x402"
+  ],
+  "registration_contract": {
+    "integration_id": "reference.framework.langgraph",
+    "integration_maturity": "reference_example",
+    "bundled": true,
+    "default_selection_enabled": false,
+    "selection_priority": 420,
+    "requires_explicit_selection": true
+  },
+  "certification_contract": {
+    "certification_state": "reference_example",
+    "certification_scope": [
+      "contract_shape",
+      "framework_payload_normalization",
+      "proof_fact_emission"
+    ],
+    "verified_with": [
+      "npm run verify:adapters"
+    ],
+    "last_verified_contract_version": "commerce-adapter-interface/v1"
+  }
+}