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

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,80 +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";
-    /**
-     * @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;;;OAGG;;IAEH;;;OAGG;;CAEK,CAAC;AAEX;;;;;;;;GAQG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,OAAO,KAAK,CAAC"}