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

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

@@ -1,81 +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,
- * });
- * ```
- */
-/**
- * @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/types/constants/network.d.ts.map

@@ -1 +0,0 @@
-{"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/types/constants/payments.d.ts

@@ -1,121 +0,0 @@
-/**
- * @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/types/constants/payments.d.ts.map

@@ -1 +0,0 @@
-{"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"}

package/dist/types/constants/programs.d.ts

@@ -1,69 +0,0 @@
-/**
- * @module constants/programs
- * @description SAP v2 program IDs for each Solana cluster.
- *
- * The canonical program address is shared across mainnet, devnet,
- * and localnet. If you deploy a custom instance, override the
- * program ID in `SapClient.from(provider, customProgramId)`.
- *
- * @category Constants
- * @since v0.1.0
- */
-import { PublicKey } from "@solana/web3.js";
-/**
- * SAP v2 program address string (base58).
- *
- * Vanity keypair derived from the `SAPpUh…` prefix.
- *
- * @name SAP_PROGRAM_ADDRESS
- * @description The canonical on-chain program address shared by all Solana clusters.
- * @category Constants
- * @since v0.1.0
- * @see {@link SAP_PROGRAM_ID}
- */
-export declare const SAP_PROGRAM_ADDRESS = "SAPpUhsWLJG1FfkGRcXagEDMrMsWGjbky7AyhGpFETZ";
-/**
- * SAP v2 mainnet-beta program ID.
- *
- * @name MAINNET_SAP_PROGRAM_ID
- * @description `PublicKey` instance of {@link SAP_PROGRAM_ADDRESS} for mainnet-beta.
- * @category Constants
- * @since v0.1.0
- * @see {@link SAP_PROGRAM_ADDRESS}
- */
-export declare const MAINNET_SAP_PROGRAM_ID: PublicKey;
-/**
- * SAP v2 devnet program ID.
- *
- * @name DEVNET_SAP_PROGRAM_ID
- * @description `PublicKey` instance of {@link SAP_PROGRAM_ADDRESS} for devnet.
- * @category Constants
- * @since v0.1.0
- * @see {@link SAP_PROGRAM_ADDRESS}
- */
-export declare const DEVNET_SAP_PROGRAM_ID: PublicKey;
-/**
- * Localnet / solana-test-validator program ID.
- *
- * Override with your own keypair if deploying locally at a different address.
- *
- * @name LOCALNET_SAP_PROGRAM_ID
- * @description `PublicKey` instance of {@link SAP_PROGRAM_ADDRESS} for localnet / `solana-test-validator`.
- * @category Constants
- * @since v0.1.0
- * @see {@link SAP_PROGRAM_ADDRESS}
- */
-export declare const LOCALNET_SAP_PROGRAM_ID: PublicKey;
-/**
- * Default program ID used by `SapClient.from()` when no explicit ID is provided.
- *
- * Alias for {@link MAINNET_SAP_PROGRAM_ID}.
- *
- * @name SAP_PROGRAM_ID
- * @description Convenience alias pointing to the mainnet-beta program ID.
- * @category Constants
- * @since v0.1.0
- * @see {@link MAINNET_SAP_PROGRAM_ID}
- */
-export declare const SAP_PROGRAM_ID: PublicKey;
-//# sourceMappingURL=programs.d.ts.map

package/dist/types/constants/programs.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"programs.d.ts","sourceRoot":"","sources":["../../../src/constants/programs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAM5C;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,gDACe,CAAC;AAMhD;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,WAAqC,CAAC;AAEzE;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,WAAqC,CAAC;AAExE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,uBAAuB,WAAqC,CAAC;AAE1E;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,WAAyB,CAAC"}

package/dist/types/constants/seeds.d.ts

@@ -1,82 +0,0 @@
-/**
- * @module constants/seeds
- * @description PDA seed prefix constants.
- *
- * Every seed string mirrors the Rust `#[account(seeds = [...])]` definitions.
- *
- * @category Constants
- * @since v0.1.0
- */
-/**
- * PDA seed prefix lookup table.
- *
- * Each key corresponds to an on-chain account type, and the value is the
- * UTF-8 string used as the first seed segment in
- * `PublicKey.findProgramAddressSync`.
- *
- * @name SEEDS
- * @description Maps logical account names to their Rust-defined PDA seed prefix strings.
- * @category Constants
- * @since v0.1.0
- * @example
- * ```ts
- * import { SEEDS } from "@synapse-sap/sdk/constants";
- *
- * Buffer.from(SEEDS.AGENT); // => "sap_agent"
- * ```
- * @see {@link SeedKey}
- */
-export declare const SEEDS: {
-    readonly AGENT: "sap_agent";
-    readonly FEEDBACK: "sap_feedback";
-    readonly CAPABILITY_INDEX: "sap_cap_idx";
-    readonly PROTOCOL_INDEX: "sap_proto_idx";
-    readonly GLOBAL: "sap_global";
-    readonly PLUGIN: "sap_plugin";
-    readonly MEMORY: "sap_memory";
-    readonly MEMORY_CHUNK: "sap_mem_chunk";
-    readonly VAULT: "sap_vault";
-    readonly SESSION: "sap_session";
-    readonly EPOCH: "sap_epoch";
-    readonly DELEGATE: "sap_delegate";
-    readonly TOOL: "sap_tool";
-    readonly CHECKPOINT: "sap_checkpoint";
-    readonly ESCROW: "sap_escrow";
-    readonly ESCROW_V2: "sap_escrow_v2";
-    readonly STATS: "sap_stats";
-    readonly TOOL_CATEGORY: "sap_tool_cat";
-    readonly ATTESTATION: "sap_attest";
-    readonly LEDGER: "sap_ledger";
-    readonly LEDGER_PAGE: "sap_page";
-    readonly BUFFER: "sap_buffer";
-    readonly DIGEST: "sap_digest";
-    readonly PENDING: "sap_pending";
-    readonly DISPUTE: "sap_dispute";
-    readonly STAKE: "sap_stake";
-    readonly SUBSCRIPTION: "sap_sub";
-    readonly SHARD: "sap_shard";
-    readonly INDEX_PAGE: "sap_idx_page";
-    /** v0.12 — On-chain pricing menu for escrow price validation. Seeds: `["sap_pricing", agent_pda]`. */
-    readonly PRICING: "sap_pricing";
-    /**
-     * @since v0.10.0 — Anti-replay receipt PDA bound to (escrow, service_hash) or (escrow, batch_root).
-     * Created via `init` on every settle_calls / settle_batch / settle_calls_v2; replays fail.
-     */
-    readonly SETTLEMENT_RECEIPT: "sap_recv";
-    /**
-     * @deprecated v0.10.0 — Was reserved for receipt batch merkle root (never used on-chain).
-     * Use {@link SEEDS.SETTLEMENT_RECEIPT} (`sap_recv`) instead. Will be removed in v0.11.0.
-     */
-    readonly RECEIPT: "sap_receipt";
-};
-/**
- * Union type of all valid keys in the {@link SEEDS} object.
- *
- * @name SeedKey
- * @description String literal union derived from `keyof typeof SEEDS`.
- * @category Constants
- * @since v0.1.0
- * @see {@link SEEDS}
- */
-export type SeedKey = keyof typeof SEEDS;
-//# sourceMappingURL=seeds.d.ts.map

package/dist/types/constants/seeds.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"seeds.d.ts","sourceRoot":"","sources":["../../../src/constants/seeds.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA8BhB,sGAAsG;;IAEtG;;;OAGG;;IAEH;;;OAGG;;CAEK,CAAC;AAEX;;;;;;;;GAQG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,OAAO,KAAK,CAAC"}