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

package/dist/types/utils/x402-direct.d.ts

@@ -1,114 +0,0 @@
-/**
- * @module utils/x402-direct
- * @description Recognize x402 direct SPL token payments on an agent's ATA
- * by scanning transaction history and filtering for x402 patterns.
- *
- * @category Utils
- * @since v0.6.4
- */
-import { type Connection, PublicKey } from "@solana/web3.js";
-/**
- * @interface SettlementPayload
- * @description Settlement metadata from the merchant's PAYMENT-RESPONSE.
- * @category Utils
- * @since v0.6.4
- */
-export interface SettlementPayload {
-    /** SHA-256 service hash. */
-    readonly serviceHash: string;
-    /** Resource identifier. */
-    readonly resource: string;
-    /** Agent wallet (base58). */
-    readonly agentWallet: string;
-    /** Depositor wallet (base58). */
-    readonly depositorWallet: string;
-    /** Amount in smallest unit. */
-    readonly amount: string;
-    /** Service timestamp. */
-    readonly timestamp: number;
-}
-/**
- * @interface X402DirectPayment
- * @description A recognized x402 direct SPL transfer on an agent's ATA.
- * @category Utils
- * @since v0.6.4
- */
-export interface X402DirectPayment {
-    /** Transaction signature. */
-    readonly signature: string;
-    /** Transfer amount (in smallest token unit). */
-    readonly amount: bigint;
-    /** Source ATA (payer). */
-    readonly payerAta: PublicKey;
-    /** Destination ATA (payTo / agent). */
-    readonly payeeAta: PublicKey;
-    /** Token mint used for transfer. */
-    readonly mint: PublicKey;
-    /** Memo data (if a Memo instruction was included). */
-    readonly memo: string | null;
-    /** Matched settlement payload (if server-side verification is available). */
-    readonly settlement: SettlementPayload | null;
-    /** Block time (unix seconds). */
-    readonly blockTime: number | null;
-    /** Slot number. */
-    readonly slot: number;
-}
-/**
- * @interface GetX402DirectOptions
- * @description Options for {@link getX402DirectPayments}.
- * @category Utils
- * @since v0.6.4
- */
-export interface GetX402DirectOptions {
-    /** Max signatures to scan (default: 100). */
-    readonly limit?: number;
-    /** Only return transfers from this specific payer. */
-    readonly filterPayer?: PublicKey;
-    /** Known settlements from server-side PAYMENT-RESPONSE logs.
-     *  Used for deterministic hash matching. */
-    readonly knownSettlements?: SettlementPayload[];
-    /** Only include payments that match x402 memo prefix. Default: false. */
-    readonly requireMemo?: boolean;
-    /** Scan before this TX signature (pagination). */
-    readonly before?: string;
-    /** Scan after this TX signature (pagination). */
-    readonly until?: string;
-}
-/**
- * @name getX402DirectPayments
- * @description Scan an agent's ATA for x402 direct payments.
- *
- * Fetches recent transaction signatures for the given `payTo` ATA,
- * inspects each transaction for SPL token transfers, and filters
- * for x402 payment patterns (memo prefix, settlement hash match, etc.).
- *
- * @param connection - Solana RPC connection.
- * @param payToAta   - The agent's receiving ATA (e.g. USDC ATA of Syra).
- * @param opts       - Filter and pagination options.
- * @returns Array of recognized x402 direct payments, newest first.
- *
- * @category Utils
- * @since v0.6.4
- *
- * @example
- * ```ts
- * import { getX402DirectPayments, findATA } from "@oobe-protocol-labs/synapse-sap-sdk";
- *
- * const USDC_MINT = new PublicKey("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v");
- * const payToAta = findATA(agentWallet, USDC_MINT);
- *
- * const payments = await getX402DirectPayments(connection, payToAta, {
- *   limit: 50,
- *   knownSettlements: savedSettlements, // from your API PAYMENT-RESPONSE logs
- * });
- *
- * for (const p of payments) {
- *   console.log(`${p.signature}: ${p.amount} from ${p.payerAta.toBase58()}`);
- *   if (p.settlement) {
- *     console.log(`  Matched settlement: ${p.settlement.serviceHash}`);
- *   }
- * }
- * ```
- */
-export declare function getX402DirectPayments(connection: Connection, payToAta: PublicKey, opts?: GetX402DirectOptions): Promise<X402DirectPayment[]>;
-//# sourceMappingURL=x402-direct.d.ts.map

package/dist/types/utils/x402-direct.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"x402-direct.d.ts","sourceRoot":"","sources":["../../../src/utils/x402-direct.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,KAAK,UAAU,EACf,SAAS,EAGV,MAAM,iBAAiB,CAAC;AAOzB;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,4BAA4B;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,2BAA2B;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,6BAA6B;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,iCAAiC;IACjC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,+BAA+B;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,yBAAyB;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,6BAA6B;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,0BAA0B;IAC1B,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,uCAAuC;IACvC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,oCAAoC;IACpC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC9C,iCAAiC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,mBAAmB;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,sDAAsD;IACtD,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC;IACjC;gDAC4C;IAC5C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAChD,yEAAyE;IACzE,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,kDAAkD;IAClD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,iDAAiD;IACjD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AA6KD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,SAAS,EACnB,IAAI,CAAC,EAAE,oBAAoB,GAC1B,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAmE9B"}

package/src/constants/addresses.ts

@@ -1,162 +0,0 @@
-/**
- * @module constants/addresses
- * @description Pre-computed mainnet addresses for singleton PDAs and protocol infrastructure.
- *
- * These addresses are deterministic — derived from the canonical program ID
- * and fixed seeds. They are provided for convenience so consumers can
- * reference well-known accounts without re-deriving them.
- *
- * @category Constants
- * @since v0.3.1
- */
-
-import { PublicKey } from "@solana/web3.js";
-
-// ═══════════════════════════════════════════════════════════════════
-//  Program & Authority
-// ═══════════════════════════════════════════════════════════════════
-
-/**
- * SAP v2 program ID on mainnet-beta (base58).
- *
- * @name SAP_PROGRAM
- * @description The deployed and verified SAP v2 program address.
- * @category Constants
- * @since v0.3.1
- */
-export const SAP_PROGRAM = new PublicKey(
-  "SAPpUhsWLJG1FfkGRcXagEDMrMsWGjbky7AyhGpFETZ",
-);
-
-/**
- * Upgrade authority for the SAP v2 program.
- *
- * @name SAP_UPGRADE_AUTHORITY
- * @description The wallet that holds upgrade authority over the deployed program.
- * @category Constants
- * @since v0.3.1
- */
-export const SAP_UPGRADE_AUTHORITY = new PublicKey(
-  "GBLQznn1QMnx64zHXcDguP9yNW9ZfYCVdrY8eDovBvPk",
-);
-
-// ═══════════════════════════════════════════════════════════════════
-//  Singleton PDAs
-// ═══════════════════════════════════════════════════════════════════
-
-/**
- * **GlobalRegistry** PDA — the protocol singleton.
- *
- * Seeds: `["sap_global"]` · Bump: `255`
- *
- * Tracks total agent count, active agent count, and protocol-level
- * counters. Must be initialized once before any agent can register.
- *
- * @name GLOBAL_REGISTRY_ADDRESS
- * @category Constants
- * @since v0.3.1
- */
-export const GLOBAL_REGISTRY_ADDRESS = new PublicKey(
-  "9odFrYBBZq6UQC6aGyzMPNXWJQn55kMtfigzhLg6S6L5",
-);
-
-/**
- * Bump seed for the GlobalRegistry PDA.
- * @name GLOBAL_REGISTRY_BUMP
- * @category Constants
- * @since v0.3.1
- */
-export const GLOBAL_REGISTRY_BUMP = 255;
-
-// ═══════════════════════════════════════════════════════════════════
-//  IDL Account (program-metadata format)
-// ═══════════════════════════════════════════════════════════════════
-
-/**
- * IDL metadata account derived via the `program-metadata` standard.
- *
- * Seeds: `["idl", program_id]` under `pmetaypqG6SiB47xMigYVMAkuHDWeSDXcv3zzDrJJvA`.
- *
- * Contains the Anchor IDL JSON, queryable by explorers like Solscan.
- *
- * @name IDL_ACCOUNT_ADDRESS
- * @category Constants
- * @since v0.3.1
- */
-export const IDL_ACCOUNT_ADDRESS = new PublicKey(
-  "ENs7L1NFuoP7dur8cqGGE6b98CQHfNeDZPWPSjRzhc4f",
-);
-
-/**
- * The `program-metadata` program used to store the IDL.
- *
- * @name PROGRAM_METADATA_PROGRAM
- * @category Constants
- * @since v0.3.1
- */
-export const PROGRAM_METADATA_PROGRAM = new PublicKey(
-  "pmetaypqG6SiB47xMigYVMAkuHDWeSDXcv3zzDrJJvA",
-);
-
-// ═══════════════════════════════════════════════════════════════════
-//  Tool Category Index PDAs (pre-computed for categories 0–9)
-// ═══════════════════════════════════════════════════════════════════
-
-/**
- * Pre-computed Tool Category Index PDAs for each `ToolCategory` variant.
- *
- * Seeds: `["sap_tool_cat", category_byte]`
- *
- * Each entry corresponds to a `ToolCategory` enum discriminant:
- *
- * | Index | Category   | Address                                            |
- * |-------|------------|----------------------------------------------------|
- * | 0     | Swap       | `5H8yn9RuRgZWqkDiWbKNaCHzTMjqSpwbNQKMPLtUXx2G`   |
- * | 1     | Lend       | `5Lqqk6VtFWnYq3h4Ae4FuUAKnFzw1Nm1DaSdt2cjcTDj`   |
- * | 2     | Stake      | `kC8oAiVUcFMXEnmMNu1h2sdAc3dWKcwV5qVKRFYMmQD`    |
- * | 3     | Nft        | `2zNWR9J3znvGQ5J6xDfJyZkd12Gi66mjErRDkgPeKbyF`   |
- * | 4     | Payment    | `Eh7MwxJYWRN8bzAmY3ZPTRXYjWpWypokBf1STixu2dy9`   |
- * | 5     | Data       | `AwpVxehQUZCVTAJ9icZfS6oRbF66jNo32duXaL11B5df`   |
- * | 6     | Governance | `2573WjZzV9QtbqtM6Z86YGivkk1kdvJa4gK3tZRQ2jkN`   |
- * | 7     | Bridge     | `664nyr6kBeeFiE1ij5gtdncNCVHrXqrk2uBhnKmUREvK`   |
- * | 8     | Analytics  | `4DFsiTZ6h6RoCZuUeMTpaoQguepnPUMJBLJuwwjKg5GL`   |
- * | 9     | Custom     | `3Nk5dvFWEyWPEArdG9cCdab6C6ym36mSWUSB8HzN35ZM`   |
- *
- * @name TOOL_CATEGORY_ADDRESSES
- * @category Constants
- * @since v0.3.1
- */
-export const TOOL_CATEGORY_ADDRESSES = {
-  Swap: new PublicKey("5H8yn9RuRgZWqkDiWbKNaCHzTMjqSpwbNQKMPLtUXx2G"),
-  Lend: new PublicKey("5Lqqk6VtFWnYq3h4Ae4FuUAKnFzw1Nm1DaSdt2cjcTDj"),
-  Stake: new PublicKey("kC8oAiVUcFMXEnmMNu1h2sdAc3dWKcwV5qVKRFYMmQD"),
-  Nft: new PublicKey("2zNWR9J3znvGQ5J6xDfJyZkd12Gi66mjErRDkgPeKbyF"),
-  Payment: new PublicKey("Eh7MwxJYWRN8bzAmY3ZPTRXYjWpWypokBf1STixu2dy9"),
-  Data: new PublicKey("AwpVxehQUZCVTAJ9icZfS6oRbF66jNo32duXaL11B5df"),
-  Governance: new PublicKey("2573WjZzV9QtbqtM6Z86YGivkk1kdvJa4gK3tZRQ2jkN"),
-  Bridge: new PublicKey("664nyr6kBeeFiE1ij5gtdncNCVHrXqrk2uBhnKmUREvK"),
-  Analytics: new PublicKey("4DFsiTZ6h6RoCZuUeMTpaoQguepnPUMJBLJuwwjKg5GL"),
-  Custom: new PublicKey("3Nk5dvFWEyWPEArdG9cCdab6C6ym36mSWUSB8HzN35ZM"),
-} as const;
-
-/**
- * Array-indexed version of {@link TOOL_CATEGORY_ADDRESSES}.
- *
- * `TOOL_CATEGORY_ADDRESS_LIST[0]` = Swap, `[1]` = Lend, etc.
- *
- * @name TOOL_CATEGORY_ADDRESS_LIST
- * @category Constants
- * @since v0.3.1
- */
-export const TOOL_CATEGORY_ADDRESS_LIST: readonly PublicKey[] = [
-  TOOL_CATEGORY_ADDRESSES.Swap,
-  TOOL_CATEGORY_ADDRESSES.Lend,
-  TOOL_CATEGORY_ADDRESSES.Stake,
-  TOOL_CATEGORY_ADDRESSES.Nft,
-  TOOL_CATEGORY_ADDRESSES.Payment,
-  TOOL_CATEGORY_ADDRESSES.Data,
-  TOOL_CATEGORY_ADDRESSES.Governance,
-  TOOL_CATEGORY_ADDRESSES.Bridge,
-  TOOL_CATEGORY_ADDRESSES.Analytics,
-  TOOL_CATEGORY_ADDRESSES.Custom,
-] as const;

package/src/constants/index.ts

@@ -1,69 +0,0 @@
-/**
- * @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";
-export type { SeedKey } 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";
-export type { SapNetworkId } 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";

package/src/constants/limits.ts

@@ -1,165 +0,0 @@
-/**
- * @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,
-} as const;
-
-// ═══════════════════════════════════════════════════════════════════
-//  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,
-} as const;
-
-/**
- * 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,
-} as const;

package/src/constants/network.ts

@@ -1,89 +0,0 @@
-/**
- * @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",
-} as const;
-
-/**
- * @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];