@oobe-protocol-labs/synapse-sap-sdk 0.13.0 → 0.15.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/seeds.ts

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