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

package/dist/esm/constants/payments.js

@@ -1,131 +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 const USDC_MINT_MAINNET = new PublicKey("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v");
-/**
- * USDC mint on Solana devnet (Circle test mint).
- *
- * @name USDC_MINT_DEVNET
- * @category Constants
- * @since v0.10.0
- */
-export const USDC_MINT_DEVNET = new PublicKey("4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU");
-/**
- * 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 const MIN_AGENT_STAKE_LAMPORTS = BigInt(100_000_000);
-/**
- * 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 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 const STAKE_COVERAGE_BPS = SLASH_BPS;
-/**
- * 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 const UNSTAKE_COOLDOWN_SECONDS = 604_800;
-/**
- * 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 function computeRequiredStakeLamports(escrowLamports) {
-    if (escrowLamports < 0n) {
-        throw new RangeError("escrowLamports must be ≥ 0");
-    }
-    const coverage = (escrowLamports * STAKE_COVERAGE_BPS) / 10000n;
-    return coverage > MIN_AGENT_STAKE_LAMPORTS ? coverage : MIN_AGENT_STAKE_LAMPORTS;
-}
-/**
- * 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 const MAX_DELEGATE_DURATION_SECS = 365 * 86_400;
-/**
- * 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 function isAcceptedUsdcMint(mint) {
-    return mint.equals(USDC_MINT_MAINNET) || mint.equals(USDC_MINT_DEVNET);
-}
-/**
- * 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 function isAcceptedPaymentToken(tokenMint) {
-    return tokenMint === null || isAcceptedUsdcMint(tokenMint);
-}
-//# sourceMappingURL=payments.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"payments.js","sourceRoot":"","sources":["../../../src/constants/payments.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,SAAS,CAC5C,8CAA8C,CAC/C,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,SAAS,CAC3C,8CAA8C,CAC/C,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;AAE5D;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,KAAM,CAAC;AAEhC;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,SAAS,CAAC;AAE5C;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,OAAO,CAAC;AAEhD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,4BAA4B,CAAC,cAAsB;IACjE,IAAI,cAAc,GAAG,EAAE,EAAE,CAAC;QACxB,MAAM,IAAI,UAAU,CAAC,4BAA4B,CAAC,CAAC;IACrD,CAAC;IACD,MAAM,QAAQ,GAAG,CAAC,cAAc,GAAG,kBAAkB,CAAC,GAAG,MAAO,CAAC;IACjE,OAAO,QAAQ,GAAG,wBAAwB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,wBAAwB,CAAC;AACnF,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,GAAG,MAAM,CAAC;AAEvD;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAe;IAChD,OAAO,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;AACzE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,SAA2B;IAChE,OAAO,SAAS,KAAK,IAAI,IAAI,kBAAkB,CAAC,SAAS,CAAC,CAAC;AAC7D,CAAC"}

package/dist/esm/constants/programs.js

@@ -1,75 +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";
-// ═══════════════════════════════════════════════════════════════════
-//  Program Address
-// ═══════════════════════════════════════════════════════════════════
-/**
- * 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 const SAP_PROGRAM_ADDRESS = "SAPpUhsWLJG1FfkGRcXagEDMrMsWGjbky7AyhGpFETZ";
-// ═══════════════════════════════════════════════════════════════════
-//  Per-Network PublicKeys
-// ═══════════════════════════════════════════════════════════════════
-/**
- * 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 const MAINNET_SAP_PROGRAM_ID = new PublicKey(SAP_PROGRAM_ADDRESS);
-/**
- * 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 const DEVNET_SAP_PROGRAM_ID = new PublicKey(SAP_PROGRAM_ADDRESS);
-/**
- * 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 const LOCALNET_SAP_PROGRAM_ID = new PublicKey(SAP_PROGRAM_ADDRESS);
-/**
- * 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 const SAP_PROGRAM_ID = MAINNET_SAP_PROGRAM_ID;
-//# sourceMappingURL=programs.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"programs.js","sourceRoot":"","sources":["../../../src/constants/programs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,sEAAsE;AACtE,mBAAmB;AACnB,sEAAsE;AAEtE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAC9B,6CAA6C,CAAC;AAEhD,sEAAsE;AACtE,0BAA0B;AAC1B,sEAAsE;AAEtE;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,SAAS,CAAC,mBAAmB,CAAC,CAAC;AAEzE;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,SAAS,CAAC,mBAAmB,CAAC,CAAC;AAExE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,SAAS,CAAC,mBAAmB,CAAC,CAAC;AAE1E;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,sBAAsB,CAAC"}

package/dist/esm/constants/seeds.js

@@ -1,73 +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 Prefixes
-// ═══════════════════════════════════════════════════════════════════
-/**
- * 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 const SEEDS = {
-    AGENT: "sap_agent",
-    FEEDBACK: "sap_feedback",
-    CAPABILITY_INDEX: "sap_cap_idx",
-    PROTOCOL_INDEX: "sap_proto_idx",
-    GLOBAL: "sap_global",
-    PLUGIN: "sap_plugin",
-    MEMORY: "sap_memory",
-    MEMORY_CHUNK: "sap_mem_chunk",
-    VAULT: "sap_vault",
-    SESSION: "sap_session",
-    EPOCH: "sap_epoch",
-    DELEGATE: "sap_delegate",
-    TOOL: "sap_tool",
-    CHECKPOINT: "sap_checkpoint",
-    ESCROW: "sap_escrow",
-    ESCROW_V2: "sap_escrow_v2",
-    STATS: "sap_stats",
-    TOOL_CATEGORY: "sap_tool_cat",
-    ATTESTATION: "sap_attest",
-    LEDGER: "sap_ledger",
-    LEDGER_PAGE: "sap_page",
-    BUFFER: "sap_buffer",
-    DIGEST: "sap_digest",
-    PENDING: "sap_pending",
-    DISPUTE: "sap_dispute",
-    STAKE: "sap_stake",
-    SUBSCRIPTION: "sap_sub",
-    SHARD: "sap_shard",
-    INDEX_PAGE: "sap_idx_page",
-    /**
-     * @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.
-     */
-    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.
-     */
-    RECEIPT: "sap_receipt",
-};
-//# sourceMappingURL=seeds.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"seeds.js","sourceRoot":"","sources":["../../../src/constants/seeds.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,sEAAsE;AACtE,qBAAqB;AACrB,sEAAsE;AAEtE;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,KAAK,EAAE,WAAW;IAClB,QAAQ,EAAE,cAAc;IACxB,gBAAgB,EAAE,aAAa;IAC/B,cAAc,EAAE,eAAe;IAC/B,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,YAAY;IACpB,YAAY,EAAE,eAAe;IAC7B,KAAK,EAAE,WAAW;IAClB,OAAO,EAAE,aAAa;IACtB,KAAK,EAAE,WAAW;IAClB,QAAQ,EAAE,cAAc;IACxB,IAAI,EAAE,UAAU;IAChB,UAAU,EAAE,gBAAgB;IAC5B,MAAM,EAAE,YAAY;IACpB,SAAS,EAAE,eAAe;IAC1B,KAAK,EAAE,WAAW;IAClB,aAAa,EAAE,cAAc;IAC7B,WAAW,EAAE,YAAY;IACzB,MAAM,EAAE,YAAY;IACpB,WAAW,EAAE,UAAU;IACvB,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,aAAa;IACtB,OAAO,EAAE,aAAa;IACtB,KAAK,EAAE,WAAW;IAClB,YAAY,EAAE,SAAS;IACvB,KAAK,EAAE,WAAW;IAClB,UAAU,EAAE,cAAc;IAC1B;;;OAGG;IACH,kBAAkB,EAAE,UAAU;IAC9B;;;OAGG;IACH,OAAO,EAAE,aAAa;CACd,CAAC"}