@oobe-protocol-labs/synapse-sap-sdk 0.14.0 → 0.15.0

package/dist/esm/constants/index.js

@@ -0,0 +1,35 @@
+/**
+ * @module constants
+ * @description Protocol constants mirroring the on-chain Rust program.
+ *
+ * Organized into:
+ * - **programs** — Network-specific program IDs
+ * - **seeds** — PDA seed prefix strings
+ * - **limits** — Size constraints, versions, enum numeric values
+ *
+ * @category Constants
+ * @since v0.1.0
+ *
+ * @example
+ * ```ts
+ * import {
+ *   MAINNET_SAP_PROGRAM_ID,
+ *   DEVNET_SAP_PROGRAM_ID,
+ *   SEEDS,
+ *   LIMITS,
+ * } from "@synapse-sap/sdk/constants";
+ * ```
+ */
+// ── Program IDs ──────────────────────────────────────
+export { SAP_PROGRAM_ADDRESS, MAINNET_SAP_PROGRAM_ID, DEVNET_SAP_PROGRAM_ID, LOCALNET_SAP_PROGRAM_ID, SAP_PROGRAM_ID, } from "./programs";
+// ── PDA Seeds ────────────────────────────────────────
+export { SEEDS } from "./seeds";
+// ── Limits & Versions ────────────────────────────────
+export { LIMITS, AGENT_VERSION, VAULT_PROTOCOL_VERSION, TOOL_CATEGORY_VALUES, HTTP_METHOD_VALUES, } from "./limits";
+// ── Network Identifiers (x402) ───────────────────────────────
+export { SapNetwork } from "./network";
+// ── Mainnet Addresses ────────────────────────────────────────
+export { SAP_PROGRAM, SAP_UPGRADE_AUTHORITY, GLOBAL_REGISTRY_ADDRESS, GLOBAL_REGISTRY_BUMP, IDL_ACCOUNT_ADDRESS, PROGRAM_METADATA_PROGRAM, TOOL_CATEGORY_ADDRESSES, TOOL_CATEGORY_ADDRESS_LIST, } from "./addresses";
+// ── Payment-token allowlist & stake collateral (v0.10.0) ─────
+export { USDC_MINT_MAINNET, USDC_MINT_DEVNET, MIN_AGENT_STAKE_LAMPORTS, MAX_DELEGATE_DURATION_SECS, isAcceptedUsdcMint, isAcceptedPaymentToken, } from "./payments";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/constants/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,wDAAwD;AACxD,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,wDAAwD;AACxD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGhC,wDAAwD;AACxD,OAAO,EACL,MAAM,EACN,aAAa,EACb,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAClB,gEAAgE;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAGvC,gEAAgE;AAChE,OAAO,EACL,WAAW,EACX,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,aAAa,CAAC;AAErB,gEAAgE;AAChE,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,0BAA0B,EAC1B,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,YAAY,CAAC"}

package/dist/esm/constants/limits.d.ts

@@ -0,0 +1,149 @@
+/**
+ * @module constants/limits
+ * @description Protocol size limits, version constants, and enum numeric values.
+ *
+ * All values mirror the on-chain Rust constraints exactly.
+ * Used for client-side validation before sending transactions.
+ *
+ * @category Constants
+ * @since v0.1.0
+ */
+/**
+ * Protocol size constraints mirroring the Rust `impl` blocks.
+ *
+ * Use these values for client-side validation before submitting
+ * transactions — exceeding any limit will cause an on-chain error.
+ *
+ * @name LIMITS
+ * @description A frozen object containing all protocol-enforced size and length bounds.
+ * @category Constants
+ * @since v0.1.0
+ * @example
+ * ```ts
+ * import { LIMITS } from "@synapse-sap/sdk/constants";
+ *
+ * if (name.length > LIMITS.MAX_NAME_LEN) {
+ *   throw new Error("Agent name too long");
+ * }
+ * ```
+ */
+export declare const LIMITS: {
+    /** Max agent name length in bytes. */
+    readonly MAX_NAME_LEN: 64;
+    /** Max agent description length in bytes. */
+    readonly MAX_DESC_LEN: 256;
+    /** Max URI length (agent_uri, x402_endpoint). */
+    readonly MAX_URI_LEN: 256;
+    /** Max agent DID-style identifier length. */
+    readonly MAX_AGENT_ID_LEN: 128;
+    /** Max capabilities per agent. */
+    readonly MAX_CAPABILITIES: 10;
+    /** Max pricing tiers per agent. */
+    readonly MAX_PRICING_TIERS: 5;
+    /** Max protocol strings per agent. */
+    readonly MAX_PROTOCOLS: 5;
+    /** Max active plugins per agent. */
+    readonly MAX_PLUGINS: 5;
+    /** Max volume curve breakpoints per tier. */
+    readonly MAX_VOLUME_CURVE_POINTS: 5;
+    /** Max feedback tag length. */
+    readonly MAX_TAG_LEN: 32;
+    /** Max agents in a capability/protocol index. */
+    readonly MAX_AGENTS_PER_INDEX: 100;
+    /** Max tool name length. */
+    readonly MAX_TOOL_NAME_LEN: 32;
+    /** Max tools in a category index. */
+    readonly MAX_TOOLS_PER_CATEGORY: 100;
+    /** Max attestation type length. */
+    readonly MAX_ATTESTATION_TYPE_LEN: 32;
+    /** Max inscription size (encrypted_data per fragment). */
+    readonly MAX_INSCRIPTION_SIZE: 750;
+    /** Inscriptions per epoch page. */
+    readonly INSCRIPTIONS_PER_EPOCH: 1000;
+    /** Max memory chunk size (legacy). */
+    readonly MAX_CHUNK_SIZE: 900;
+    /** Max write size per buffer append (legacy). */
+    readonly MAX_BUFFER_WRITE_SIZE: 750;
+    /** Max total buffer page size (legacy). */
+    readonly MAX_BUFFER_TOTAL_SIZE: 10000;
+    /** Ring buffer capacity for MemoryLedger. */
+    readonly RING_CAPACITY: 4096;
+    /** Max ledger write size per call. */
+    readonly MAX_LEDGER_WRITE_SIZE: 750;
+    /** Max settlements in a batch. */
+    readonly MAX_BATCH_SETTLEMENTS: 10;
+    /** Feedback score range: 0–1000. */
+    readonly MAX_FEEDBACK_SCORE: 1000;
+};
+/**
+ * Current on-chain protocol version for `AgentAccount`.
+ *
+ * @name AGENT_VERSION
+ * @description Integer version stamped into every agent account on registration.
+ * @category Constants
+ * @since v0.1.0
+ */
+export declare const AGENT_VERSION = 1;
+/**
+ * Current on-chain protocol version for `MemoryVault`.
+ *
+ * @name VAULT_PROTOCOL_VERSION
+ * @description Integer version stamped into every vault account on initialisation.
+ * @category Constants
+ * @since v0.1.0
+ */
+export declare const VAULT_PROTOCOL_VERSION = 1;
+/**
+ * Tool category to `u8` discriminant mapping.
+ *
+ * Mirrors the Rust `ToolCategory` enum ordinals. Use these values
+ * when constructing or filtering tool-related instructions.
+ *
+ * @name TOOL_CATEGORY_VALUES
+ * @description Frozen mapping of tool category names to their on-chain `u8` discriminants.
+ * @category Constants
+ * @since v0.1.0
+ * @example
+ * ```ts
+ * import { TOOL_CATEGORY_VALUES } from "@synapse-sap/sdk/constants";
+ *
+ * const categoryByte = TOOL_CATEGORY_VALUES.Swap; // 0
+ * ```
+ */
+export declare const TOOL_CATEGORY_VALUES: {
+    readonly Swap: 0;
+    readonly Lend: 1;
+    readonly Stake: 2;
+    readonly Nft: 3;
+    readonly Payment: 4;
+    readonly Data: 5;
+    readonly Governance: 6;
+    readonly Bridge: 7;
+    readonly Analytics: 8;
+    readonly Custom: 9;
+};
+/**
+ * HTTP method to `u8` discriminant mapping.
+ *
+ * Mirrors the Rust `HttpMethod` enum ordinals. Used when publishing
+ * or filtering tool endpoints.
+ *
+ * @name HTTP_METHOD_VALUES
+ * @description Frozen mapping of HTTP method names to their on-chain `u8` discriminants.
+ * @category Constants
+ * @since v0.1.0
+ * @example
+ * ```ts
+ * import { HTTP_METHOD_VALUES } from "@synapse-sap/sdk/constants";
+ *
+ * const method = HTTP_METHOD_VALUES.Post; // 1
+ * ```
+ */
+export declare const HTTP_METHOD_VALUES: {
+    readonly Get: 0;
+    readonly Post: 1;
+    readonly Put: 2;
+    readonly Delete: 3;
+    readonly Compound: 4;
+};
+//# sourceMappingURL=limits.d.ts.map

package/dist/esm/constants/limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../../../src/constants/limits.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,MAAM;IACjB,sCAAsC;;IAEtC,6CAA6C;;IAE7C,iDAAiD;;IAEjD,6CAA6C;;IAE7C,kCAAkC;;IAElC,mCAAmC;;IAEnC,sCAAsC;;IAEtC,oCAAoC;;IAEpC,6CAA6C;;IAE7C,+BAA+B;;IAE/B,iDAAiD;;IAEjD,4BAA4B;;IAE5B,qCAAqC;;IAErC,mCAAmC;;IAEnC,0DAA0D;;IAE1D,mCAAmC;;IAEnC,sCAAsC;;IAEtC,iDAAiD;;IAEjD,2CAA2C;;IAE3C,6CAA6C;;IAE7C,sCAAsC;;IAEtC,kCAAkC;;IAElC,oCAAoC;;CAE5B,CAAC;AAMX;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,IAAI,CAAC;AAE/B;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAMxC;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;CAWvB,CAAC;AAEX;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,kBAAkB;;;;;;CAMrB,CAAC"}

package/dist/esm/constants/limits.js

@@ -0,0 +1,158 @@
+/**
+ * @module constants/limits
+ * @description Protocol size limits, version constants, and enum numeric values.
+ *
+ * All values mirror the on-chain Rust constraints exactly.
+ * Used for client-side validation before sending transactions.
+ *
+ * @category Constants
+ * @since v0.1.0
+ */
+// ═══════════════════════════════════════════════════════════════════
+//  Size Limits (mirrors Rust impl blocks)
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * Protocol size constraints mirroring the Rust `impl` blocks.
+ *
+ * Use these values for client-side validation before submitting
+ * transactions — exceeding any limit will cause an on-chain error.
+ *
+ * @name LIMITS
+ * @description A frozen object containing all protocol-enforced size and length bounds.
+ * @category Constants
+ * @since v0.1.0
+ * @example
+ * ```ts
+ * import { LIMITS } from "@synapse-sap/sdk/constants";
+ *
+ * if (name.length > LIMITS.MAX_NAME_LEN) {
+ *   throw new Error("Agent name too long");
+ * }
+ * ```
+ */
+export const LIMITS = {
+    /** Max agent name length in bytes. */
+    MAX_NAME_LEN: 64,
+    /** Max agent description length in bytes. */
+    MAX_DESC_LEN: 256,
+    /** Max URI length (agent_uri, x402_endpoint). */
+    MAX_URI_LEN: 256,
+    /** Max agent DID-style identifier length. */
+    MAX_AGENT_ID_LEN: 128,
+    /** Max capabilities per agent. */
+    MAX_CAPABILITIES: 10,
+    /** Max pricing tiers per agent. */
+    MAX_PRICING_TIERS: 5,
+    /** Max protocol strings per agent. */
+    MAX_PROTOCOLS: 5,
+    /** Max active plugins per agent. */
+    MAX_PLUGINS: 5,
+    /** Max volume curve breakpoints per tier. */
+    MAX_VOLUME_CURVE_POINTS: 5,
+    /** Max feedback tag length. */
+    MAX_TAG_LEN: 32,
+    /** Max agents in a capability/protocol index. */
+    MAX_AGENTS_PER_INDEX: 100,
+    /** Max tool name length. */
+    MAX_TOOL_NAME_LEN: 32,
+    /** Max tools in a category index. */
+    MAX_TOOLS_PER_CATEGORY: 100,
+    /** Max attestation type length. */
+    MAX_ATTESTATION_TYPE_LEN: 32,
+    /** Max inscription size (encrypted_data per fragment). */
+    MAX_INSCRIPTION_SIZE: 750,
+    /** Inscriptions per epoch page. */
+    INSCRIPTIONS_PER_EPOCH: 1000,
+    /** Max memory chunk size (legacy). */
+    MAX_CHUNK_SIZE: 900,
+    /** Max write size per buffer append (legacy). */
+    MAX_BUFFER_WRITE_SIZE: 750,
+    /** Max total buffer page size (legacy). */
+    MAX_BUFFER_TOTAL_SIZE: 10_000,
+    /** Ring buffer capacity for MemoryLedger. */
+    RING_CAPACITY: 4096,
+    /** Max ledger write size per call. */
+    MAX_LEDGER_WRITE_SIZE: 750,
+    /** Max settlements in a batch. */
+    MAX_BATCH_SETTLEMENTS: 10,
+    /** Feedback score range: 0–1000. */
+    MAX_FEEDBACK_SCORE: 1000,
+};
+// ═══════════════════════════════════════════════════════════════════
+//  Protocol Versions
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * Current on-chain protocol version for `AgentAccount`.
+ *
+ * @name AGENT_VERSION
+ * @description Integer version stamped into every agent account on registration.
+ * @category Constants
+ * @since v0.1.0
+ */
+export const AGENT_VERSION = 1;
+/**
+ * Current on-chain protocol version for `MemoryVault`.
+ *
+ * @name VAULT_PROTOCOL_VERSION
+ * @description Integer version stamped into every vault account on initialisation.
+ * @category Constants
+ * @since v0.1.0
+ */
+export const VAULT_PROTOCOL_VERSION = 1;
+// ═══════════════════════════════════════════════════════════════════
+//  Numeric Enum Values
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * Tool category to `u8` discriminant mapping.
+ *
+ * Mirrors the Rust `ToolCategory` enum ordinals. Use these values
+ * when constructing or filtering tool-related instructions.
+ *
+ * @name TOOL_CATEGORY_VALUES
+ * @description Frozen mapping of tool category names to their on-chain `u8` discriminants.
+ * @category Constants
+ * @since v0.1.0
+ * @example
+ * ```ts
+ * import { TOOL_CATEGORY_VALUES } from "@synapse-sap/sdk/constants";
+ *
+ * const categoryByte = TOOL_CATEGORY_VALUES.Swap; // 0
+ * ```
+ */
+export const TOOL_CATEGORY_VALUES = {
+    Swap: 0,
+    Lend: 1,
+    Stake: 2,
+    Nft: 3,
+    Payment: 4,
+    Data: 5,
+    Governance: 6,
+    Bridge: 7,
+    Analytics: 8,
+    Custom: 9,
+};
+/**
+ * HTTP method to `u8` discriminant mapping.
+ *
+ * Mirrors the Rust `HttpMethod` enum ordinals. Used when publishing
+ * or filtering tool endpoints.
+ *
+ * @name HTTP_METHOD_VALUES
+ * @description Frozen mapping of HTTP method names to their on-chain `u8` discriminants.
+ * @category Constants
+ * @since v0.1.0
+ * @example
+ * ```ts
+ * import { HTTP_METHOD_VALUES } from "@synapse-sap/sdk/constants";
+ *
+ * const method = HTTP_METHOD_VALUES.Post; // 1
+ * ```
+ */
+export const HTTP_METHOD_VALUES = {
+    Get: 0,
+    Post: 1,
+    Put: 2,
+    Delete: 3,
+    Compound: 4,
+};
+//# sourceMappingURL=limits.js.map

package/dist/esm/constants/limits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.js","sourceRoot":"","sources":["../../../src/constants/limits.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,sEAAsE;AACtE,0CAA0C;AAC1C,sEAAsE;AAEtE;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,sCAAsC;IACtC,YAAY,EAAE,EAAE;IAChB,6CAA6C;IAC7C,YAAY,EAAE,GAAG;IACjB,iDAAiD;IACjD,WAAW,EAAE,GAAG;IAChB,6CAA6C;IAC7C,gBAAgB,EAAE,GAAG;IACrB,kCAAkC;IAClC,gBAAgB,EAAE,EAAE;IACpB,mCAAmC;IACnC,iBAAiB,EAAE,CAAC;IACpB,sCAAsC;IACtC,aAAa,EAAE,CAAC;IAChB,oCAAoC;IACpC,WAAW,EAAE,CAAC;IACd,6CAA6C;IAC7C,uBAAuB,EAAE,CAAC;IAC1B,+BAA+B;IAC/B,WAAW,EAAE,EAAE;IACf,iDAAiD;IACjD,oBAAoB,EAAE,GAAG;IACzB,4BAA4B;IAC5B,iBAAiB,EAAE,EAAE;IACrB,qCAAqC;IACrC,sBAAsB,EAAE,GAAG;IAC3B,mCAAmC;IACnC,wBAAwB,EAAE,EAAE;IAC5B,0DAA0D;IAC1D,oBAAoB,EAAE,GAAG;IACzB,mCAAmC;IACnC,sBAAsB,EAAE,IAAI;IAC5B,sCAAsC;IACtC,cAAc,EAAE,GAAG;IACnB,iDAAiD;IACjD,qBAAqB,EAAE,GAAG;IAC1B,2CAA2C;IAC3C,qBAAqB,EAAE,MAAM;IAC7B,6CAA6C;IAC7C,aAAa,EAAE,IAAI;IACnB,sCAAsC;IACtC,qBAAqB,EAAE,GAAG;IAC1B,kCAAkC;IAClC,qBAAqB,EAAE,EAAE;IACzB,oCAAoC;IACpC,kBAAkB,EAAE,IAAI;CAChB,CAAC;AAEX,sEAAsE;AACtE,qBAAqB;AACrB,sEAAsE;AAEtE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC;AAE/B;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AAExC,sEAAsE;AACtE,uBAAuB;AACvB,sEAAsE;AAEtE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,GAAG,EAAE,CAAC;IACN,OAAO,EAAE,CAAC;IACV,IAAI,EAAE,CAAC;IACP,UAAU,EAAE,CAAC;IACb,MAAM,EAAE,CAAC;IACT,SAAS,EAAE,CAAC;IACZ,MAAM,EAAE,CAAC;CACD,CAAC;AAEX;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,GAAG,EAAE,CAAC;IACN,IAAI,EAAE,CAAC;IACP,GAAG,EAAE,CAAC;IACN,MAAM,EAAE,CAAC;IACT,QAAQ,EAAE,CAAC;CACH,CAAC"}

package/dist/esm/constants/network.d.ts

@@ -0,0 +1,81 @@
+/**
+ * @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,
+ * });
+ * ```
+ */
+/**
+ * @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
+ */
+export declare const SapNetwork: {
+    /**
+     * Mainnet-beta, human-readable cluster name.
+     * Default value used by the SDK prior to v0.4.3.
+     */
+    readonly 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.
+     */
+    readonly SOLANA_MAINNET_GENESIS: "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
+    /**
+     * Devnet, genesis-hash form (CAIP-2 compliant).
+     */
+    readonly SOLANA_DEVNET: "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1";
+    /**
+     * Devnet, human-readable cluster name.
+     * Useful for local development and test validators.
+     */
+    readonly SOLANA_DEVNET_NAMED: "solana:devnet";
+};
+/**
+ * @name SapNetworkId
+ * @description Union type of all known {@link SapNetwork} values.
+ * Accept `SapNetworkId | string` where custom identifiers are allowed.
+ */
+export type SapNetworkId = (typeof SapNetwork)[keyof typeof SapNetwork];
+//# sourceMappingURL=network.d.ts.map

package/dist/esm/constants/network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../../src/constants/network.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAMH;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,UAAU;IACrB;;;OAGG;;IAGH;;;;OAIG;;IAGH;;OAEG;;IAGH;;;OAGG;;CAEK,CAAC;AAEX;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC"}

package/dist/esm/constants/network.js

@@ -0,0 +1,78 @@
+/**
+ * @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,
+ * });
+ * ```
+ */
+// ═══════════════════════════════════════════════════════════════════
+//  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
+ */
+export const 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/esm/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;AACH,MAAM,CAAC,MAAM,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/esm/constants/payments.d.ts

@@ -0,0 +1,121 @@
+/**
+ * @module constants/payments
+ * @description Payment-token allowlist + agent stake collateral constants
+ *   mirroring the on-chain v0.10.0 hardening.
+ *
+ *   The on-chain program now accepts only:
+ *   - **Native SOL** — signalled by `tokenMint = null` on escrow creation.
+ *   - **USDC mainnet** — `EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`.
+ *   - **USDC devnet**  — `4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU`.
+ *
+ *   Any other SPL mint passed to `createEscrow` / `createEscrowV2` is
+ *   rejected on-chain with `PaymentTokenNotAllowed` (error code 6093).
+ *
+ *   Additionally, the agent owner MUST have an `AgentStake` PDA with
+ *   `staked_amount >= MIN_AGENT_STAKE_LAMPORTS` (0.1 SOL) BEFORE any
+ *   client can create a new escrow against that agent. Use
+ *   {@link StakingModule.initStake} + {@link StakingModule.deposit}
+ *   to satisfy the requirement.
+ *
+ * @category Constants
+ * @since v0.10.0
+ */
+import { PublicKey } from "@solana/web3.js";
+/**
+ * USDC mint on Solana mainnet-beta (Circle).
+ *
+ * @name USDC_MINT_MAINNET
+ * @category Constants
+ * @since v0.10.0
+ */
+export declare const USDC_MINT_MAINNET: PublicKey;
+/**
+ * USDC mint on Solana devnet (Circle test mint).
+ *
+ * @name USDC_MINT_DEVNET
+ * @category Constants
+ * @since v0.10.0
+ */
+export declare const USDC_MINT_DEVNET: PublicKey;
+/**
+ * Minimum agent stake required to gate escrow creation, expressed in lamports.
+ * Mirrors `AgentStake::MIN_STAKE` on-chain (`100_000_000` = 0.1 SOL).
+ *
+ * @name MIN_AGENT_STAKE_LAMPORTS
+ * @category Constants
+ * @since v0.10.0
+ */
+export declare const MIN_AGENT_STAKE_LAMPORTS: bigint;
+/**
+ * Slash share applied on a lost dispute, in basis points.
+ * Mirrors `AgentStake::SLASH_BPS` on-chain (`5_000` = 50%).
+ *
+ * @name SLASH_BPS
+ * @category Constants
+ * @since v0.11.0
+ */
+export declare const SLASH_BPS = 5000n;
+/**
+ * Stake coverage ratio enforced at `createEscrowV2` (basis points).
+ * Mirrors `AgentStake::STAKE_COVERAGE_BPS` on-chain. Currently equal to
+ * {@link SLASH_BPS} so the slash on a lost dispute is fully collateralised.
+ *
+ * @name STAKE_COVERAGE_BPS
+ * @category Constants
+ * @since v0.11.0
+ */
+export declare const STAKE_COVERAGE_BPS = 5000n;
+/**
+ * Unstake cooldown in seconds. Mirrors `AgentStake::UNSTAKE_COOLDOWN_SECONDS`
+ * on-chain (`604_800` = 7 days). Replaces the misnamed pre-v0.11
+ * `UNSTAKE_COOLDOWN_SLOTS` constant which was never used by handlers.
+ *
+ * @name UNSTAKE_COOLDOWN_SECONDS
+ * @category Constants
+ * @since v0.11.0
+ */
+export declare const UNSTAKE_COOLDOWN_SECONDS = 604800;
+/**
+ * Required `staked_amount` (lamports) for an agent to accept an escrow of
+ * `escrowLamports`. Equal to `max(MIN_AGENT_STAKE_LAMPORTS,
+ *  escrowLamports * STAKE_COVERAGE_BPS / 10_000)`.
+ *
+ * Mirrors the on-chain check enforced in `create_escrow_v2` (v0.11 H-1).
+ * Use this to preflight an escrow create call and surface an actionable
+ * error before paying tx fees.
+ *
+ * @name computeRequiredStakeLamports
+ * @category Constants
+ * @since v0.11.0
+ */
+export declare function computeRequiredStakeLamports(escrowLamports: bigint): bigint;
+/**
+ * Maximum delegate duration (seconds) accepted by `add_vault_delegate`.
+ * Mirrors `VaultDelegate::MAX_DELEGATE_DURATION_SECS` on-chain
+ * (`365 * 86_400` = 1 year).
+ *
+ * @name MAX_DELEGATE_DURATION_SECS
+ * @category Constants
+ * @since v0.10.0
+ */
+export declare const MAX_DELEGATE_DURATION_SECS: number;
+/**
+ * Returns true when `mint` is an accepted USDC mint (mainnet or devnet).
+ *
+ * @name isAcceptedUsdcMint
+ * @param mint - Candidate SPL token mint.
+ * @category Constants
+ * @since v0.10.0
+ */
+export declare function isAcceptedUsdcMint(mint: PublicKey): boolean;
+/**
+ * Returns true when the (optional) `tokenMint` is acceptable as escrow payment.
+ * `null` represents native SOL and is always accepted.
+ *
+ * @name isAcceptedPaymentToken
+ * @param tokenMint - The mint passed to `createEscrow*`. `null` = SOL.
+ * @category Constants
+ * @since v0.10.0
+ */
+export declare function isAcceptedPaymentToken(tokenMint: PublicKey | null): boolean;
+//# sourceMappingURL=payments.d.ts.map

package/dist/esm/constants/payments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payments.d.ts","sourceRoot":"","sources":["../../../src/constants/payments.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,WAE7B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,WAE5B,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,QAAsB,CAAC;AAE5D;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,QAAS,CAAC;AAEhC;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,QAAY,CAAC;AAE5C;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB,SAAU,CAAC;AAEhD;;;;;;;;;;;;GAYG;AACH,wBAAgB,4BAA4B,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAM3E;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,QAAe,CAAC;AAEvD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAE3D;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,GAAG,OAAO,CAE3E"}