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

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];

package/src/constants/payments.ts

@@ -1,145 +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 = 5_000n;
-
-/**
- * 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: bigint): bigint {
-  if (escrowLamports < 0n) {
-    throw new RangeError("escrowLamports must be ≥ 0");
-  }
-  const coverage = (escrowLamports * STAKE_COVERAGE_BPS) / 10_000n;
-  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: PublicKey): boolean {
-  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: PublicKey | null): boolean {
-  return tokenMint === null || isAcceptedUsdcMint(tokenMint);
-}