@oobe-protocol-labs/synapse-sap-sdk 0.4.2 → 0.6.0

package/dist/cjs/constants/index.js

@@ -22,7 +22,7 @@
  * ```
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TOOL_CATEGORY_ADDRESS_LIST = exports.TOOL_CATEGORY_ADDRESSES = exports.PROGRAM_METADATA_PROGRAM = exports.IDL_ACCOUNT_ADDRESS = exports.GLOBAL_REGISTRY_BUMP = exports.GLOBAL_REGISTRY_ADDRESS = exports.SAP_UPGRADE_AUTHORITY = exports.SAP_PROGRAM = exports.HTTP_METHOD_VALUES = exports.TOOL_CATEGORY_VALUES = exports.VAULT_PROTOCOL_VERSION = exports.AGENT_VERSION = exports.LIMITS = exports.SEEDS = exports.SAP_PROGRAM_ID = exports.LOCALNET_SAP_PROGRAM_ID = exports.DEVNET_SAP_PROGRAM_ID = exports.MAINNET_SAP_PROGRAM_ID = exports.SAP_PROGRAM_ADDRESS = void 0;
+exports.TOOL_CATEGORY_ADDRESS_LIST = exports.TOOL_CATEGORY_ADDRESSES = exports.PROGRAM_METADATA_PROGRAM = exports.IDL_ACCOUNT_ADDRESS = exports.GLOBAL_REGISTRY_BUMP = exports.GLOBAL_REGISTRY_ADDRESS = exports.SAP_UPGRADE_AUTHORITY = exports.SAP_PROGRAM = exports.SapNetwork = exports.HTTP_METHOD_VALUES = exports.TOOL_CATEGORY_VALUES = exports.VAULT_PROTOCOL_VERSION = exports.AGENT_VERSION = exports.LIMITS = exports.SEEDS = exports.SAP_PROGRAM_ID = exports.LOCALNET_SAP_PROGRAM_ID = exports.DEVNET_SAP_PROGRAM_ID = exports.MAINNET_SAP_PROGRAM_ID = exports.SAP_PROGRAM_ADDRESS = void 0;
 // ── Program IDs ──────────────────────────────────────
 var programs_1 = require("./programs");
 Object.defineProperty(exports, "SAP_PROGRAM_ADDRESS", { enumerable: true, get: function () { return programs_1.SAP_PROGRAM_ADDRESS; } });
@@ -40,6 +40,9 @@ Object.defineProperty(exports, "AGENT_VERSION", { enumerable: true, get: functio
 Object.defineProperty(exports, "VAULT_PROTOCOL_VERSION", { enumerable: true, get: function () { return limits_1.VAULT_PROTOCOL_VERSION; } });
 Object.defineProperty(exports, "TOOL_CATEGORY_VALUES", { enumerable: true, get: function () { return limits_1.TOOL_CATEGORY_VALUES; } });
 Object.defineProperty(exports, "HTTP_METHOD_VALUES", { enumerable: true, get: function () { return limits_1.HTTP_METHOD_VALUES; } });
+// ── Network Identifiers (x402) ───────────────────────────────
+var network_1 = require("./network");
+Object.defineProperty(exports, "SapNetwork", { enumerable: true, get: function () { return network_1.SapNetwork; } });
 // ── Mainnet Addresses ────────────────────────────────────────
 var addresses_1 = require("./addresses");
 Object.defineProperty(exports, "SAP_PROGRAM", { enumerable: true, get: function () { return addresses_1.SAP_PROGRAM; } });

package/dist/cjs/constants/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/constants/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;AAEH,wDAAwD;AACxD,uCAMoB;AALlB,+GAAA,mBAAmB,OAAA;AACnB,kHAAA,sBAAsB,OAAA;AACtB,iHAAA,qBAAqB,OAAA;AACrB,mHAAA,uBAAuB,OAAA;AACvB,0GAAA,cAAc,OAAA;AAGhB,wDAAwD;AACxD,iCAAgC;AAAvB,8FAAA,KAAK,OAAA;AAGd,wDAAwD;AACxD,mCAMkB;AALhB,gGAAA,MAAM,OAAA;AACN,uGAAA,aAAa,OAAA;AACb,gHAAA,sBAAsB,OAAA;AACtB,8GAAA,oBAAoB,OAAA;AACpB,4GAAA,kBAAkB,OAAA;AAEpB,gEAAgE;AAChE,yCASqB;AARnB,wGAAA,WAAW,OAAA;AACX,kHAAA,qBAAqB,OAAA;AACrB,oHAAA,uBAAuB,OAAA;AACvB,iHAAA,oBAAoB,OAAA;AACpB,gHAAA,mBAAmB,OAAA;AACnB,qHAAA,wBAAwB,OAAA;AACxB,oHAAA,uBAAuB,OAAA;AACvB,uHAAA,0BAA0B,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/constants/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;AAEH,wDAAwD;AACxD,uCAMoB;AALlB,+GAAA,mBAAmB,OAAA;AACnB,kHAAA,sBAAsB,OAAA;AACtB,iHAAA,qBAAqB,OAAA;AACrB,mHAAA,uBAAuB,OAAA;AACvB,0GAAA,cAAc,OAAA;AAGhB,wDAAwD;AACxD,iCAAgC;AAAvB,8FAAA,KAAK,OAAA;AAGd,wDAAwD;AACxD,mCAMkB;AALhB,gGAAA,MAAM,OAAA;AACN,uGAAA,aAAa,OAAA;AACb,gHAAA,sBAAsB,OAAA;AACtB,8GAAA,oBAAoB,OAAA;AACpB,4GAAA,kBAAkB,OAAA;AAEpB,gEAAgE;AAChE,qCAAuC;AAA9B,qGAAA,UAAU,OAAA;AAGnB,gEAAgE;AAChE,yCASqB;AARnB,wGAAA,WAAW,OAAA;AACX,kHAAA,qBAAqB,OAAA;AACrB,oHAAA,uBAAuB,OAAA;AACvB,iHAAA,oBAAoB,OAAA;AACpB,gHAAA,mBAAmB,OAAA;AACnB,qHAAA,wBAAwB,OAAA;AACxB,oHAAA,uBAAuB,OAAA;AACvB,uHAAA,0BAA0B,OAAA"}

package/dist/cjs/constants/network.js

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * @module constants/network
+ * @description Solana network identifiers for x402 payment headers.
+ *
+ * x402 providers validate the `X-Payment-Network` header against their
+ * own network identifier. Some providers (e.g. Coinbase, Phantom) accept
+ * the human-readable cluster name (`solana:mainnet-beta`), while others
+ * (e.g. Kamiyo, Helius x402) require the Solana genesis-hash form
+ * (`solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp`).
+ *
+ * Use {@link SapNetwork} to select the correct format, or pass any
+ * custom string where needed.
+ *
+ * @category Constants
+ * @since v0.4.3
+ *
+ * @example
+ * ```ts
+ * import { SapNetwork } from "@synapse-sap/sdk";
+ *
+ * // Standard cluster name (default)
+ * const ctx = await x402.preparePayment(agentWallet, {
+ *   pricePerCall: 1000, deposit: 100_000,
+ *   networkIdentifier: SapNetwork.SOLANA_MAINNET,
+ * });
+ *
+ * // Genesis-hash form for providers that require it
+ * const ctx2 = await x402.preparePayment(agentWallet, {
+ *   pricePerCall: 1000, deposit: 100_000,
+ *   networkIdentifier: SapNetwork.SOLANA_MAINNET_GENESIS,
+ * });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SapNetwork = void 0;
+// ═══════════════════════════════════════════════════════════════════
+//  SAP Network Identifiers
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * @name SapNetwork
+ * @description Network identifier strings for x402 `X-Payment-Network` headers.
+ *
+ * Two mainnet forms exist because x402 providers disagree on the canonical
+ * identifier:
+ *
+ * | Constant                | Value                                        | Accepted by          |
+ * |-------------------------|----------------------------------------------|----------------------|
+ * | `SOLANA_MAINNET`        | `solana:mainnet-beta`                        | Coinbase, Phantom    |
+ * | `SOLANA_MAINNET_GENESIS`| `solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp`   | Kamiyo, Helius x402  |
+ * | `SOLANA_DEVNET`         | `solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1`   | Devnet providers     |
+ * | `SOLANA_DEVNET_NAMED`   | `solana:devnet`                              | Local / test flows   |
+ *
+ * If your provider requires a different format, pass a raw string instead.
+ *
+ * @category Constants
+ * @since v0.4.3
+ */
+exports.SapNetwork = {
+    /**
+     * Mainnet-beta, human-readable cluster name.
+     * Default value used by the SDK prior to v0.4.3.
+     */
+    SOLANA_MAINNET: "solana:mainnet-beta",
+    /**
+     * Mainnet-beta, genesis-hash form (CAIP-2 compliant).
+     * Required by Kamiyo, Helius x402, and other providers that validate
+     * against the Solana genesis hash.
+     */
+    SOLANA_MAINNET_GENESIS: "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
+    /**
+     * Devnet, genesis-hash form (CAIP-2 compliant).
+     */
+    SOLANA_DEVNET: "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1",
+    /**
+     * Devnet, human-readable cluster name.
+     * Useful for local development and test validators.
+     */
+    SOLANA_DEVNET_NAMED: "solana:devnet",
+};
+//# sourceMappingURL=network.js.map

package/dist/cjs/constants/network.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.js","sourceRoot":"","sources":["../../../src/constants/network.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;;;AAEH,sEAAsE;AACtE,2BAA2B;AAC3B,sEAAsE;AAEtE;;;;;;;;;;;;;;;;;;GAkBG;AACU,QAAA,UAAU,GAAG;IACxB;;;OAGG;IACH,cAAc,EAAE,qBAAqB;IAErC;;;;OAIG;IACH,sBAAsB,EAAE,yCAAyC;IAEjE;;OAEG;IACH,aAAa,EAAE,yCAAyC;IAExD;;;OAGG;IACH,mBAAmB,EAAE,eAAe;CAC5B,CAAC"}

package/dist/cjs/index.js

@@ -45,8 +45,9 @@
  * @since v0.1.0
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SapRpcError = exports.SapValidationError = exports.SapError = exports.serializeValue = exports.serializeAccount = exports.assert = exports.hashToArray = exports.sha256 = exports.deriveLedgerPage = exports.deriveLedger = exports.deriveAttestation = exports.deriveEscrow = exports.deriveTool = exports.deriveCheckpoint = exports.deriveVaultDelegate = exports.deriveEpochPage = exports.deriveSession = exports.deriveVault = exports.deriveToolCategoryIndex = exports.deriveProtocolIndex = exports.deriveCapabilityIndex = exports.deriveFeedback = exports.deriveAgentStats = exports.deriveAgent = exports.deriveGlobalRegistry = exports.IDL_METADATA = exports.IDL_PROGRAM_ADDRESS = exports.SAP_IDL = exports.HTTP_METHOD_VALUES = exports.TOOL_CATEGORY_VALUES = exports.VAULT_PROTOCOL_VERSION = exports.AGENT_VERSION = exports.LIMITS = exports.SEEDS = exports.LOCALNET_SAP_PROGRAM_ID = exports.DEVNET_SAP_PROGRAM_ID = exports.MAINNET_SAP_PROGRAM_ID = exports.SAP_PROGRAM_ID = exports.SAP_PROGRAM_ADDRESS = exports.CompressionType = exports.SchemaType = exports.DelegatePermission = exports.ToolCategory = exports.ToolHttpMethod = exports.SettlementMode = exports.PluginType = exports.TokenType = exports.KeypairWallet = exports.SapConnection = exports.SapClient = void 0;
-exports.AgentBuilder = exports.SessionManager = exports.X402Registry = exports.DiscoveryRegistry = exports.TransactionParser = exports.extractAccountKeys = exports.filterSapInnerInstructions = exports.decodeInnerInstructions = exports.parseSapTransactionBatch = exports.parseSapTransactionComplete = exports.containsSapInstruction = exports.parseSapInstructionNamesFromList = exports.parseSapInstructionsFromList = exports.parseSapInstructionNamesFromTransaction = exports.parseSapInstructionsFromTransaction = exports.SAP_TABLE_MAP = exports.SapSyncEngine = exports.SapPostgres = exports.SAP_PROTOCOLS = exports.SAPPlugin = exports.createSAPPlugin = exports.BaseModule = exports.LedgerModule = exports.AttestationModule = exports.EscrowModule = exports.VaultModule = exports.ToolsModule = exports.IndexingModule = exports.FeedbackModule = exports.AgentModule = exports.SAP_EVENT_NAMES = exports.EventParser = exports.SapPermissionError = exports.SapTimeoutError = exports.SapAccountNotFoundError = void 0;
+exports.isNetworkEquivalent = exports.normalizeNetworkId = exports.serializeValue = exports.serializeAccount = exports.assert = exports.hashToArray = exports.sha256 = exports.deriveLedgerPage = exports.deriveLedger = exports.deriveAttestation = exports.deriveEscrow = exports.deriveTool = exports.deriveCheckpoint = exports.deriveVaultDelegate = exports.deriveEpochPage = exports.deriveSession = exports.deriveVault = exports.deriveToolCategoryIndex = exports.deriveProtocolIndex = exports.deriveCapabilityIndex = exports.deriveFeedback = exports.deriveAgentStats = exports.deriveAgent = exports.deriveGlobalRegistry = exports.IDL_METADATA = exports.IDL_PROGRAM_ADDRESS = exports.SAP_IDL = exports.SapNetwork = exports.HTTP_METHOD_VALUES = exports.TOOL_CATEGORY_VALUES = exports.VAULT_PROTOCOL_VERSION = exports.AGENT_VERSION = exports.LIMITS = exports.SEEDS = exports.LOCALNET_SAP_PROGRAM_ID = exports.DEVNET_SAP_PROGRAM_ID = exports.MAINNET_SAP_PROGRAM_ID = exports.SAP_PROGRAM_ID = exports.SAP_PROGRAM_ADDRESS = exports.CompressionType = exports.SchemaType = exports.DelegatePermission = exports.ToolCategory = exports.ToolHttpMethod = exports.SettlementMode = exports.PluginType = exports.TokenType = exports.KeypairWallet = exports.SapConnection = exports.SapClient = void 0;
+exports.containsSapInstruction = exports.parseSapInstructionNamesFromList = exports.parseSapInstructionsFromList = exports.parseSapInstructionNamesFromTransaction = exports.parseSapInstructionsFromTransaction = exports.SAP_TABLE_MAP = exports.SapSyncEngine = exports.SapPostgres = exports.SAP_PROTOCOLS = exports.SAPPlugin = exports.createSAPPlugin = exports.BaseModule = exports.LedgerModule = exports.AttestationModule = exports.EscrowModule = exports.VaultModule = exports.ToolsModule = exports.IndexingModule = exports.FeedbackModule = exports.AgentModule = exports.SAP_EVENT_NAMES = exports.EventParser = exports.SapPermissionError = exports.SapTimeoutError = exports.SapAccountNotFoundError = exports.SapRpcError = exports.SapValidationError = exports.SapError = exports.validateOrThrow = exports.createCallArgsSchema = exports.createRegisterAgentSchema = exports.createPreparePaymentSchema = exports.createAgentManifestSchema = exports.createToolManifestEntrySchema = exports.createHealthCheckSchema = exports.createEndpointDescriptorSchema = exports.createEnvSchema = exports.extractAnchorErrorCode = exports.classifyAnchorError = exports.findATA = exports.createDualConnection = exports.getFallbackRpcUrl = exports.getRpcUrl = exports.validateAgentEndpoints = exports.validateHealthCheck = exports.validateEndpointDescriptor = exports.validateEndpoint = exports.isKnownNetwork = exports.getNetworkClusterName = exports.getNetworkGenesisHash = void 0;
+exports.AgentBuilder = exports.SessionManager = exports.X402Registry = exports.DiscoveryRegistry = exports.TransactionParser = exports.extractAccountKeys = exports.filterSapInnerInstructions = exports.decodeInnerInstructions = exports.parseSapTransactionBatch = exports.parseSapTransactionComplete = void 0;
 // ── Core ─────────────────────────────────────────────
 var core_1 = require("./core");
 Object.defineProperty(exports, "SapClient", { enumerable: true, get: function () { return core_1.SapClient; } });
@@ -74,6 +75,7 @@ Object.defineProperty(exports, "AGENT_VERSION", { enumerable: true, get: functio
 Object.defineProperty(exports, "VAULT_PROTOCOL_VERSION", { enumerable: true, get: function () { return constants_1.VAULT_PROTOCOL_VERSION; } });
 Object.defineProperty(exports, "TOOL_CATEGORY_VALUES", { enumerable: true, get: function () { return constants_1.TOOL_CATEGORY_VALUES; } });
 Object.defineProperty(exports, "HTTP_METHOD_VALUES", { enumerable: true, get: function () { return constants_1.HTTP_METHOD_VALUES; } });
+Object.defineProperty(exports, "SapNetwork", { enumerable: true, get: function () { return constants_1.SapNetwork; } });
 // ── IDL ──────────────────────────────────────────────
 var index_1 = require("./idl/index");
 Object.defineProperty(exports, "SAP_IDL", { enumerable: true, get: function () { return index_1.SAP_IDL; } });
@@ -106,6 +108,38 @@ Object.defineProperty(exports, "assert", { enumerable: true, get: function () {
 var utils_2 = require("./utils");
 Object.defineProperty(exports, "serializeAccount", { enumerable: true, get: function () { return utils_2.serializeAccount; } });
 Object.defineProperty(exports, "serializeValue", { enumerable: true, get: function () { return utils_2.serializeValue; } });
+// v0.6.0 — Network normalizer
+var utils_3 = require("./utils");
+Object.defineProperty(exports, "normalizeNetworkId", { enumerable: true, get: function () { return utils_3.normalizeNetworkId; } });
+Object.defineProperty(exports, "isNetworkEquivalent", { enumerable: true, get: function () { return utils_3.isNetworkEquivalent; } });
+Object.defineProperty(exports, "getNetworkGenesisHash", { enumerable: true, get: function () { return utils_3.getNetworkGenesisHash; } });
+Object.defineProperty(exports, "getNetworkClusterName", { enumerable: true, get: function () { return utils_3.getNetworkClusterName; } });
+Object.defineProperty(exports, "isKnownNetwork", { enumerable: true, get: function () { return utils_3.isKnownNetwork; } });
+// v0.6.0 — Endpoint validation
+var utils_4 = require("./utils");
+Object.defineProperty(exports, "validateEndpoint", { enumerable: true, get: function () { return utils_4.validateEndpoint; } });
+Object.defineProperty(exports, "validateEndpointDescriptor", { enumerable: true, get: function () { return utils_4.validateEndpointDescriptor; } });
+Object.defineProperty(exports, "validateHealthCheck", { enumerable: true, get: function () { return utils_4.validateHealthCheck; } });
+Object.defineProperty(exports, "validateAgentEndpoints", { enumerable: true, get: function () { return utils_4.validateAgentEndpoints; } });
+// v0.6.0 — RPC strategy & error classification
+var utils_5 = require("./utils");
+Object.defineProperty(exports, "getRpcUrl", { enumerable: true, get: function () { return utils_5.getRpcUrl; } });
+Object.defineProperty(exports, "getFallbackRpcUrl", { enumerable: true, get: function () { return utils_5.getFallbackRpcUrl; } });
+Object.defineProperty(exports, "createDualConnection", { enumerable: true, get: function () { return utils_5.createDualConnection; } });
+Object.defineProperty(exports, "findATA", { enumerable: true, get: function () { return utils_5.findATA; } });
+Object.defineProperty(exports, "classifyAnchorError", { enumerable: true, get: function () { return utils_5.classifyAnchorError; } });
+Object.defineProperty(exports, "extractAnchorErrorCode", { enumerable: true, get: function () { return utils_5.extractAnchorErrorCode; } });
+// v0.6.0 — Zod runtime schemas
+var utils_6 = require("./utils");
+Object.defineProperty(exports, "createEnvSchema", { enumerable: true, get: function () { return utils_6.createEnvSchema; } });
+Object.defineProperty(exports, "createEndpointDescriptorSchema", { enumerable: true, get: function () { return utils_6.createEndpointDescriptorSchema; } });
+Object.defineProperty(exports, "createHealthCheckSchema", { enumerable: true, get: function () { return utils_6.createHealthCheckSchema; } });
+Object.defineProperty(exports, "createToolManifestEntrySchema", { enumerable: true, get: function () { return utils_6.createToolManifestEntrySchema; } });
+Object.defineProperty(exports, "createAgentManifestSchema", { enumerable: true, get: function () { return utils_6.createAgentManifestSchema; } });
+Object.defineProperty(exports, "createPreparePaymentSchema", { enumerable: true, get: function () { return utils_6.createPreparePaymentSchema; } });
+Object.defineProperty(exports, "createRegisterAgentSchema", { enumerable: true, get: function () { return utils_6.createRegisterAgentSchema; } });
+Object.defineProperty(exports, "createCallArgsSchema", { enumerable: true, get: function () { return utils_6.createCallArgsSchema; } });
+Object.defineProperty(exports, "validateOrThrow", { enumerable: true, get: function () { return utils_6.validateOrThrow; } });
 // ── Errors ───────────────────────────────────────────
 var errors_1 = require("./errors");
 Object.defineProperty(exports, "SapError", { enumerable: true, get: function () { return errors_1.SapError; } });

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/cjs/registries/x402.js

@@ -69,6 +69,7 @@ const web3_js_1 = require("@solana/web3.js");
 const anchor_1 = require("@coral-xyz/anchor");
 const pda_1 = require("../pda");
 const utils_1 = require("../utils");
+const network_1 = require("../constants/network");
 // ═══════════════════════════════════════════════════════════════════
 //  x402 Registry
 // ═══════════════════════════════════════════════════════════════════
@@ -269,6 +270,7 @@ class X402Registry {
             pricePerCall,
             maxCalls,
             txSignature,
+            networkIdentifier: opts.networkIdentifier ?? network_1.SapNetwork.SOLANA_MAINNET,
         };
     }
     /**
@@ -346,6 +348,8 @@ class X402Registry {
      * @since v0.1.0
      */
     buildPaymentHeaders(ctx, opts) {
+        // Prefer: explicit override → ctx.networkIdentifier → default
+        const rawNetwork = opts?.network ?? ctx.networkIdentifier ?? network_1.SapNetwork.SOLANA_MAINNET;
         return {
             "X-Payment-Protocol": "SAP-x402",
             "X-Payment-Escrow": ctx.escrowPda.toBase58(),
@@ -354,7 +358,7 @@ class X402Registry {
             "X-Payment-MaxCalls": ctx.maxCalls.toString(),
             "X-Payment-PricePerCall": ctx.pricePerCall.toString(),
             "X-Payment-Program": this.program.programId.toBase58(),
-            "X-Payment-Network": opts?.network ?? "mainnet-beta",
+            "X-Payment-Network": rawNetwork,
         };
     }
     /**
@@ -364,7 +368,8 @@ class X402Registry {
      *
      * @param agentWallet - Agent wallet to look up the escrow for.
      * @param opts - Optional settings.
-     * @param opts.network - Solana cluster name (defaults to `"mainnet-beta"`).
+     * @param opts.network - Network identifier for the `X-Payment-Network` header.
+     *   Defaults to `SapNetwork.SOLANA_MAINNET`.
      * @returns An {@link X402Headers} object, or `null` if no escrow exists.
      * @since v0.1.0
      */
@@ -382,7 +387,7 @@ class X402Registry {
             "X-Payment-MaxCalls": escrow.maxCalls.toString(),
             "X-Payment-PricePerCall": escrow.pricePerCall.toString(),
             "X-Payment-Program": this.program.programId.toBase58(),
-            "X-Payment-Network": opts?.network ?? "mainnet-beta",
+            "X-Payment-Network": opts?.network ?? network_1.SapNetwork.SOLANA_MAINNET,
         };
     }
     // ── Settlement (Agent Side) ──────────────────────────

package/dist/cjs/registries/x402.js.map

@@ -1 +1 @@
-{"version":3,"file":"x402.js","sourceRoot":"","sources":["../../../src/registries/x402.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"x402.js","sourceRoot":"","sources":["../../../src/registries/x402.ts"],"names":[],"mappings":"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"}

package/dist/cjs/types/endpoint.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * @module types/endpoint
+ * @description Typed endpoint metadata for SAP agent discovery.
+ *
+ * Provides machine-verifiable descriptions of an agent's HTTP endpoints,
+ * authentication requirements, health-check expectations, and CORS/CSRF
+ * needs. These types solve the "guess the endpoint" interoperability
+ * problem highlighted by Kamiyo and AceDataCloud integrations.
+ *
+ * @category Types
+ * @since v0.6.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=endpoint.js.map

package/dist/cjs/types/endpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint.js","sourceRoot":"","sources":["../../../src/types/endpoint.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG"}

package/dist/cjs/utils/endpoint-validator.js

@@ -0,0 +1,232 @@
+"use strict";
+/**
+ * @module utils/endpoint-validator
+ * @description Endpoint validation utilities for SAP agent discovery.
+ *
+ * Fetches advertised endpoints and verifies they respond with JSON,
+ * proper CORS headers, and SAP-compatible behavior. Designed to
+ * fail fast when an endpoint 404s, requires CSRF tokens, or
+ * serves HTML instead of JSON.
+ *
+ * Used by:
+ *   - CLI `discovery validate` command
+ *   - SDK programmatic validation before x402 calls
+ *   - Integration test harnesses
+ *
+ * @category Utils
+ * @since v0.6.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateEndpoint = validateEndpoint;
+exports.validateEndpointDescriptor = validateEndpointDescriptor;
+exports.validateHealthCheck = validateHealthCheck;
+exports.validateAgentEndpoints = validateAgentEndpoints;
+// ═══════════════════════════════════════════════════════════════════
+//  Core Validator
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * @name validateEndpoint
+ * @description Validate a single endpoint URL for SAP compatibility.
+ *
+ * Performs the following checks:
+ *   1. URL is reachable (no 4xx/5xx)
+ *   2. Response Content-Type is JSON
+ *   3. CORS headers are present (if checkCors enabled)
+ *   4. No redirect to HTML login pages
+ *   5. Measures response latency
+ *
+ * @param url - The endpoint URL to validate.
+ * @param opts - Validation options.
+ * @returns An {@link EndpointValidationResult} with detailed check results.
+ *
+ * @category Utils
+ * @since v0.6.0
+ *
+ * @example
+ * ```ts
+ * const result = await validateEndpoint("https://api.example.com/x402");
+ * if (!result.reachable) console.error(result.error);
+ * ```
+ */
+async function validateEndpoint(url, opts = {}) {
+    const timeoutMs = opts.timeoutMs ?? 10_000;
+    const retries = opts.retries ?? 1;
+    const method = opts.method ?? "HEAD";
+    const warnings = [];
+    let lastError;
+    for (let attempt = 0; attempt <= retries; attempt++) {
+        try {
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), timeoutMs);
+            const start = Date.now();
+            const response = await fetch(url, {
+                method,
+                signal: controller.signal,
+                headers: {
+                    Accept: "application/json",
+                    ...(opts.headers ?? {}),
+                },
+                redirect: "follow",
+            });
+            clearTimeout(timer);
+            const latencyMs = Date.now() - start;
+            const contentType = response.headers.get("content-type") ?? "";
+            const isJson = contentType.includes("application/json") || contentType.includes("text/json");
+            const hasCors = !!response.headers.get("access-control-allow-origin");
+            // Check for HTML responses (login pages, CSRF gates)
+            if (contentType.includes("text/html")) {
+                warnings.push("Endpoint returns HTML — may require CSRF or browser session");
+            }
+            // Check for redirect chains
+            if (response.redirected) {
+                warnings.push(`Endpoint redirected to ${response.url}`);
+            }
+            // Check for common error statuses
+            if (response.status === 403) {
+                warnings.push("403 Forbidden — may require authentication or CSRF tokens");
+            }
+            if (response.status === 404) {
+                warnings.push("404 Not Found — endpoint URL may be incorrect");
+            }
+            if (response.status === 405) {
+                warnings.push(`405 Method Not Allowed — endpoint may not accept ${method}`);
+            }
+            // Determine SAP capability
+            const isSapCapable = isJson &&
+                response.status < 400 &&
+                !contentType.includes("text/html");
+            // CORS check if requested
+            if (opts.checkCors && !hasCors) {
+                warnings.push("No CORS headers — cross-origin requests will fail");
+            }
+            return {
+                url,
+                reachable: response.status < 500,
+                statusCode: response.status,
+                latencyMs,
+                isJson,
+                hasCors,
+                isSapCapable,
+                error: response.status >= 400
+                    ? `HTTP ${response.status}: ${response.statusText}`
+                    : undefined,
+                warnings,
+            };
+        }
+        catch (err) {
+            lastError =
+                err instanceof Error ? err.message : String(err);
+            if (attempt < retries)
+                continue;
+        }
+    }
+    return {
+        url,
+        reachable: false,
+        statusCode: 0,
+        latencyMs: 0,
+        isJson: false,
+        hasCors: false,
+        isSapCapable: false,
+        error: lastError ?? "Unknown error",
+        warnings,
+    };
+}
+/**
+ * @name validateEndpointDescriptor
+ * @description Validate an {@link EndpointDescriptor} with context-aware checks.
+ *
+ * Uses the descriptor's method, auth requirements, and other metadata to
+ * perform a more targeted validation than raw URL checking.
+ *
+ * @param descriptor - The endpoint descriptor to validate.
+ * @param opts - Additional options.
+ * @returns An {@link EndpointValidationResult}.
+ *
+ * @category Utils
+ * @since v0.6.0
+ */
+async function validateEndpointDescriptor(descriptor, opts = {}) {
+    const headers = {
+        ...(opts.headers ?? {}),
+        ...(descriptor.requiredHeaders ?? {}),
+    };
+    // Use the descriptor's method, falling back to HEAD for safety
+    const method = opts.method ?? (descriptor.method === "GET" ? "GET" : "HEAD");
+    const result = await validateEndpoint(descriptor.url, {
+        ...opts,
+        method,
+        headers,
+    });
+    // Add descriptor-specific warnings
+    const warnings = [...result.warnings];
+    if (descriptor.requiresCSRF) {
+        warnings.push("Endpoint declares requiresCSRF — automated calls may need token management");
+    }
+    if (descriptor.requiresCookies) {
+        warnings.push("Endpoint declares requiresCookies — stateless calls may fail");
+    }
+    if (descriptor.requiresAuth && !descriptor.authType) {
+        warnings.push("Endpoint requires auth but no authType specified");
+    }
+    return { ...result, warnings };
+}
+/**
+ * @name validateHealthCheck
+ * @description Validate an agent's health-check endpoint.
+ *
+ * @param health - The health-check descriptor.
+ * @returns An {@link EndpointValidationResult}.
+ *
+ * @category Utils
+ * @since v0.6.0
+ */
+async function validateHealthCheck(health) {
+    const result = await validateEndpoint(health.url, {
+        timeoutMs: health.timeoutMs,
+        method: health.method ?? "GET",
+    });
+    const warnings = [...result.warnings];
+    if (result.reachable && result.statusCode !== health.expectedStatus) {
+        warnings.push(`Expected status ${health.expectedStatus}, got ${result.statusCode}`);
+    }
+    return {
+        ...result,
+        isSapCapable: result.reachable && result.statusCode === health.expectedStatus,
+        warnings,
+    };
+}
+/**
+ * @name validateAgentEndpoints
+ * @description Validate all endpoints for an agent (primary + health + tool overrides).
+ *
+ * @param params - Object containing the endpoints to validate.
+ * @param params.endpoint - Primary endpoint descriptor.
+ * @param params.healthCheck - Optional health-check descriptor.
+ * @param params.toolEndpoints - Optional array of tool-specific endpoint overrides.
+ * @param opts - Validation options.
+ * @returns A map of `label → EndpointValidationResult`.
+ *
+ * @category Utils
+ * @since v0.6.0
+ */
+async function validateAgentEndpoints(params, opts = {}) {
+    const results = new Map();
+    // Validate primary endpoint
+    const primary = await validateEndpointDescriptor(params.endpoint, opts);
+    results.set("primary", primary);
+    // Validate health check
+    if (params.healthCheck) {
+        const health = await validateHealthCheck(params.healthCheck);
+        results.set("health", health);
+    }
+    // Validate tool-specific endpoints
+    if (params.toolEndpoints) {
+        for (const { name, endpoint } of params.toolEndpoints) {
+            const toolResult = await validateEndpointDescriptor(endpoint, opts);
+            results.set(`tool:${name}`, toolResult);
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=endpoint-validator.js.map

package/dist/cjs/utils/endpoint-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint-validator.js","sourceRoot":"","sources":["../../../src/utils/endpoint-validator.ts"],"names":[],"mappings":"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"}

package/dist/cjs/utils/index.js

@@ -15,7 +15,7 @@
  * ```
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.serializeValue = exports.serializeAccount = exports.assert = exports.hashToArray = exports.sha256 = void 0;
+exports.validateOrThrow = exports.createCallArgsSchema = exports.createRegisterAgentSchema = exports.createPreparePaymentSchema = exports.createAgentManifestSchema = exports.createToolManifestEntrySchema = exports.createHealthCheckSchema = exports.createEndpointDescriptorSchema = exports.createEnvSchema = exports.extractAnchorErrorCode = exports.classifyAnchorError = exports.findATA = exports.createDualConnection = exports.getFallbackRpcUrl = exports.getRpcUrl = exports.validateAgentEndpoints = exports.validateHealthCheck = exports.validateEndpointDescriptor = exports.validateEndpoint = exports.isKnownNetwork = exports.getNetworkClusterName = exports.getNetworkGenesisHash = exports.isNetworkEquivalent = exports.normalizeNetworkId = exports.serializeValue = exports.serializeAccount = exports.assert = exports.hashToArray = exports.sha256 = void 0;
 var hash_1 = require("./hash");
 Object.defineProperty(exports, "sha256", { enumerable: true, get: function () { return hash_1.sha256; } });
 Object.defineProperty(exports, "hashToArray", { enumerable: true, get: function () { return hash_1.hashToArray; } });
@@ -24,4 +24,33 @@ Object.defineProperty(exports, "assert", { enumerable: true, get: function () {
 var serialization_1 = require("./serialization");
 Object.defineProperty(exports, "serializeAccount", { enumerable: true, get: function () { return serialization_1.serializeAccount; } });
 Object.defineProperty(exports, "serializeValue", { enumerable: true, get: function () { return serialization_1.serializeValue; } });
+// ── v0.6.0  Hardening utilities ─────────────────────
+var network_normalizer_1 = require("./network-normalizer");
+Object.defineProperty(exports, "normalizeNetworkId", { enumerable: true, get: function () { return network_normalizer_1.normalizeNetworkId; } });
+Object.defineProperty(exports, "isNetworkEquivalent", { enumerable: true, get: function () { return network_normalizer_1.isNetworkEquivalent; } });
+Object.defineProperty(exports, "getNetworkGenesisHash", { enumerable: true, get: function () { return network_normalizer_1.getNetworkGenesisHash; } });
+Object.defineProperty(exports, "getNetworkClusterName", { enumerable: true, get: function () { return network_normalizer_1.getNetworkClusterName; } });
+Object.defineProperty(exports, "isKnownNetwork", { enumerable: true, get: function () { return network_normalizer_1.isKnownNetwork; } });
+var endpoint_validator_1 = require("./endpoint-validator");
+Object.defineProperty(exports, "validateEndpoint", { enumerable: true, get: function () { return endpoint_validator_1.validateEndpoint; } });
+Object.defineProperty(exports, "validateEndpointDescriptor", { enumerable: true, get: function () { return endpoint_validator_1.validateEndpointDescriptor; } });
+Object.defineProperty(exports, "validateHealthCheck", { enumerable: true, get: function () { return endpoint_validator_1.validateHealthCheck; } });
+Object.defineProperty(exports, "validateAgentEndpoints", { enumerable: true, get: function () { return endpoint_validator_1.validateAgentEndpoints; } });
+var rpc_strategy_1 = require("./rpc-strategy");
+Object.defineProperty(exports, "getRpcUrl", { enumerable: true, get: function () { return rpc_strategy_1.getRpcUrl; } });
+Object.defineProperty(exports, "getFallbackRpcUrl", { enumerable: true, get: function () { return rpc_strategy_1.getFallbackRpcUrl; } });
+Object.defineProperty(exports, "createDualConnection", { enumerable: true, get: function () { return rpc_strategy_1.createDualConnection; } });
+Object.defineProperty(exports, "findATA", { enumerable: true, get: function () { return rpc_strategy_1.findATA; } });
+Object.defineProperty(exports, "classifyAnchorError", { enumerable: true, get: function () { return rpc_strategy_1.classifyAnchorError; } });
+Object.defineProperty(exports, "extractAnchorErrorCode", { enumerable: true, get: function () { return rpc_strategy_1.extractAnchorErrorCode; } });
+var schemas_1 = require("./schemas");
+Object.defineProperty(exports, "createEnvSchema", { enumerable: true, get: function () { return schemas_1.createEnvSchema; } });
+Object.defineProperty(exports, "createEndpointDescriptorSchema", { enumerable: true, get: function () { return schemas_1.createEndpointDescriptorSchema; } });
+Object.defineProperty(exports, "createHealthCheckSchema", { enumerable: true, get: function () { return schemas_1.createHealthCheckSchema; } });
+Object.defineProperty(exports, "createToolManifestEntrySchema", { enumerable: true, get: function () { return schemas_1.createToolManifestEntrySchema; } });
+Object.defineProperty(exports, "createAgentManifestSchema", { enumerable: true, get: function () { return schemas_1.createAgentManifestSchema; } });
+Object.defineProperty(exports, "createPreparePaymentSchema", { enumerable: true, get: function () { return schemas_1.createPreparePaymentSchema; } });
+Object.defineProperty(exports, "createRegisterAgentSchema", { enumerable: true, get: function () { return schemas_1.createRegisterAgentSchema; } });
+Object.defineProperty(exports, "createCallArgsSchema", { enumerable: true, get: function () { return schemas_1.createCallArgsSchema; } });
+Object.defineProperty(exports, "validateOrThrow", { enumerable: true, get: function () { return schemas_1.validateOrThrow; } });
 //# sourceMappingURL=index.js.map

package/dist/cjs/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAEH,+BAA6C;AAApC,8FAAA,MAAM,OAAA;AAAE,mGAAA,WAAW,OAAA;AAC5B,2CAAsC;AAA7B,oGAAA,MAAM,OAAA;AACf,iDAAmE;AAA1D,iHAAA,gBAAgB,OAAA;AAAE,+GAAA,cAAc,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAEH,+BAA6C;AAApC,8FAAA,MAAM,OAAA;AAAE,mGAAA,WAAW,OAAA;AAC5B,2CAAsC;AAA7B,oGAAA,MAAM,OAAA;AACf,iDAAmE;AAA1D,iHAAA,gBAAgB,OAAA;AAAE,+GAAA,cAAc,OAAA;AAEzC,uDAAuD;AACvD,2DAM8B;AAL5B,wHAAA,kBAAkB,OAAA;AAClB,yHAAA,mBAAmB,OAAA;AACnB,2HAAA,qBAAqB,OAAA;AACrB,2HAAA,qBAAqB,OAAA;AACrB,oHAAA,cAAc,OAAA;AAGhB,2DAK8B;AAJ5B,sHAAA,gBAAgB,OAAA;AAChB,gIAAA,0BAA0B,OAAA;AAC1B,yHAAA,mBAAmB,OAAA;AACnB,4HAAA,sBAAsB,OAAA;AAIxB,+CAOwB;AANtB,yGAAA,SAAS,OAAA;AACT,iHAAA,iBAAiB,OAAA;AACjB,oHAAA,oBAAoB,OAAA;AACpB,uGAAA,OAAO,OAAA;AACP,mHAAA,mBAAmB,OAAA;AACnB,sHAAA,sBAAsB,OAAA;AAIxB,qCAUmB;AATjB,0GAAA,eAAe,OAAA;AACf,yHAAA,8BAA8B,OAAA;AAC9B,kHAAA,uBAAuB,OAAA;AACvB,wHAAA,6BAA6B,OAAA;AAC7B,oHAAA,yBAAyB,OAAA;AACzB,qHAAA,0BAA0B,OAAA;AAC1B,oHAAA,yBAAyB,OAAA;AACzB,+GAAA,oBAAoB,OAAA;AACpB,0GAAA,eAAe,OAAA"}