@oobe-protocol-labs/synapse-sap-sdk 0.1.0

package/dist/cjs/constants/index.js

@@ -0,0 +1,43 @@
+"use strict";
+/**
+ * @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";
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HTTP_METHOD_VALUES = exports.TOOL_CATEGORY_VALUES = exports.VAULT_PROTOCOL_VERSION = exports.AGENT_VERSION = exports.LIMITS = exports.SEEDS = exports.SAP_PROGRAM_ID = exports.LOCALNET_SAP_PROGRAM_ID = exports.DEVNET_SAP_PROGRAM_ID = exports.MAINNET_SAP_PROGRAM_ID = exports.SAP_PROGRAM_ADDRESS = void 0;
+// ── Program IDs ──────────────────────────────────────
+var programs_1 = require("./programs");
+Object.defineProperty(exports, "SAP_PROGRAM_ADDRESS", { enumerable: true, get: function () { return programs_1.SAP_PROGRAM_ADDRESS; } });
+Object.defineProperty(exports, "MAINNET_SAP_PROGRAM_ID", { enumerable: true, get: function () { return programs_1.MAINNET_SAP_PROGRAM_ID; } });
+Object.defineProperty(exports, "DEVNET_SAP_PROGRAM_ID", { enumerable: true, get: function () { return programs_1.DEVNET_SAP_PROGRAM_ID; } });
+Object.defineProperty(exports, "LOCALNET_SAP_PROGRAM_ID", { enumerable: true, get: function () { return programs_1.LOCALNET_SAP_PROGRAM_ID; } });
+Object.defineProperty(exports, "SAP_PROGRAM_ID", { enumerable: true, get: function () { return programs_1.SAP_PROGRAM_ID; } });
+// ── PDA Seeds ────────────────────────────────────────
+var seeds_1 = require("./seeds");
+Object.defineProperty(exports, "SEEDS", { enumerable: true, get: function () { return seeds_1.SEEDS; } });
+// ── Limits & Versions ────────────────────────────────
+var limits_1 = require("./limits");
+Object.defineProperty(exports, "LIMITS", { enumerable: true, get: function () { return limits_1.LIMITS; } });
+Object.defineProperty(exports, "AGENT_VERSION", { enumerable: true, get: function () { return limits_1.AGENT_VERSION; } });
+Object.defineProperty(exports, "VAULT_PROTOCOL_VERSION", { enumerable: true, get: function () { return limits_1.VAULT_PROTOCOL_VERSION; } });
+Object.defineProperty(exports, "TOOL_CATEGORY_VALUES", { enumerable: true, get: function () { return limits_1.TOOL_CATEGORY_VALUES; } });
+Object.defineProperty(exports, "HTTP_METHOD_VALUES", { enumerable: true, get: function () { return limits_1.HTTP_METHOD_VALUES; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/constants/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/constants/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;AAEH,wDAAwD;AACxD,uCAMoB;AALlB,+GAAA,mBAAmB,OAAA;AACnB,kHAAA,sBAAsB,OAAA;AACtB,iHAAA,qBAAqB,OAAA;AACrB,mHAAA,uBAAuB,OAAA;AACvB,0GAAA,cAAc,OAAA;AAGhB,wDAAwD;AACxD,iCAAgC;AAAvB,8FAAA,KAAK,OAAA;AAGd,wDAAwD;AACxD,mCAMkB;AALhB,gGAAA,MAAM,OAAA;AACN,uGAAA,aAAa,OAAA;AACb,gHAAA,sBAAsB,OAAA;AACtB,8GAAA,oBAAoB,OAAA;AACpB,4GAAA,kBAAkB,OAAA"}

package/dist/cjs/constants/limits.js

@@ -0,0 +1,161 @@
+"use strict";
+/**
+ * @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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HTTP_METHOD_VALUES = exports.TOOL_CATEGORY_VALUES = exports.VAULT_PROTOCOL_VERSION = exports.AGENT_VERSION = exports.LIMITS = void 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");
+ * }
+ * ```
+ */
+exports.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,
+};
+// ═══════════════════════════════════════════════════════════════════
+//  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
+ */
+exports.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
+ */
+exports.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
+ * ```
+ */
+exports.TOOL_CATEGORY_VALUES = {
+    Swap: 0,
+    Lend: 1,
+    Stake: 2,
+    Nft: 3,
+    Payment: 4,
+    Data: 5,
+    Governance: 6,
+    Bridge: 7,
+    Analytics: 8,
+    Custom: 9,
+};
+/**
+ * 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
+ * ```
+ */
+exports.HTTP_METHOD_VALUES = {
+    Get: 0,
+    Post: 1,
+    Put: 2,
+    Delete: 3,
+    Compound: 4,
+};
+//# sourceMappingURL=limits.js.map

package/dist/cjs/constants/limits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.js","sourceRoot":"","sources":["../../../src/constants/limits.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAEH,sEAAsE;AACtE,0CAA0C;AAC1C,sEAAsE;AAEtE;;;;;;;;;;;;;;;;;;GAkBG;AACU,QAAA,MAAM,GAAG;IACpB,sCAAsC;IACtC,YAAY,EAAE,EAAE;IAChB,6CAA6C;IAC7C,YAAY,EAAE,GAAG;IACjB,iDAAiD;IACjD,WAAW,EAAE,GAAG;IAChB,6CAA6C;IAC7C,gBAAgB,EAAE,GAAG;IACrB,kCAAkC;IAClC,gBAAgB,EAAE,EAAE;IACpB,mCAAmC;IACnC,iBAAiB,EAAE,CAAC;IACpB,sCAAsC;IACtC,aAAa,EAAE,CAAC;IAChB,oCAAoC;IACpC,WAAW,EAAE,CAAC;IACd,6CAA6C;IAC7C,uBAAuB,EAAE,CAAC;IAC1B,+BAA+B;IAC/B,WAAW,EAAE,EAAE;IACf,iDAAiD;IACjD,oBAAoB,EAAE,GAAG;IACzB,4BAA4B;IAC5B,iBAAiB,EAAE,EAAE;IACrB,qCAAqC;IACrC,sBAAsB,EAAE,GAAG;IAC3B,mCAAmC;IACnC,wBAAwB,EAAE,EAAE;IAC5B,0DAA0D;IAC1D,oBAAoB,EAAE,GAAG;IACzB,mCAAmC;IACnC,sBAAsB,EAAE,IAAI;IAC5B,sCAAsC;IACtC,cAAc,EAAE,GAAG;IACnB,iDAAiD;IACjD,qBAAqB,EAAE,GAAG;IAC1B,2CAA2C;IAC3C,qBAAqB,EAAE,MAAM;IAC7B,6CAA6C;IAC7C,aAAa,EAAE,IAAI;IACnB,sCAAsC;IACtC,qBAAqB,EAAE,GAAG;IAC1B,kCAAkC;IAClC,qBAAqB,EAAE,EAAE;IACzB,oCAAoC;IACpC,kBAAkB,EAAE,IAAI;CAChB,CAAC;AAEX,sEAAsE;AACtE,qBAAqB;AACrB,sEAAsE;AAEtE;;;;;;;GAOG;AACU,QAAA,aAAa,GAAG,CAAC,CAAC;AAE/B;;;;;;;GAOG;AACU,QAAA,sBAAsB,GAAG,CAAC,CAAC;AAExC,sEAAsE;AACtE,uBAAuB;AACvB,sEAAsE;AAEtE;;;;;;;;;;;;;;;;GAgBG;AACU,QAAA,oBAAoB,GAAG;IAClC,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,GAAG,EAAE,CAAC;IACN,OAAO,EAAE,CAAC;IACV,IAAI,EAAE,CAAC;IACP,UAAU,EAAE,CAAC;IACb,MAAM,EAAE,CAAC;IACT,SAAS,EAAE,CAAC;IACZ,MAAM,EAAE,CAAC;CACD,CAAC;AAEX;;;;;;;;;;;;;;;;GAgBG;AACU,QAAA,kBAAkB,GAAG;IAChC,GAAG,EAAE,CAAC;IACN,IAAI,EAAE,CAAC;IACP,GAAG,EAAE,CAAC;IACN,MAAM,EAAE,CAAC;IACT,QAAQ,EAAE,CAAC;CACH,CAAC"}

package/dist/cjs/constants/programs.js

@@ -0,0 +1,78 @@
+"use strict";
+/**
+ * @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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SAP_PROGRAM_ID = exports.LOCALNET_SAP_PROGRAM_ID = exports.DEVNET_SAP_PROGRAM_ID = exports.MAINNET_SAP_PROGRAM_ID = exports.SAP_PROGRAM_ADDRESS = void 0;
+const web3_js_1 = require("@solana/web3.js");
+// ═══════════════════════════════════════════════════════════════════
+//  Program Address
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * SAP v2 program address string (base58).
+ *
+ * Vanity keypair derived from the `SAPTU7a…` 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}
+ */
+exports.SAP_PROGRAM_ADDRESS = "SAPTU7aUXk2AaAdktexae1iuxXpokxzNDBAYYhaVyQL";
+// ═══════════════════════════════════════════════════════════════════
+//  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}
+ */
+exports.MAINNET_SAP_PROGRAM_ID = new web3_js_1.PublicKey(exports.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}
+ */
+exports.DEVNET_SAP_PROGRAM_ID = new web3_js_1.PublicKey(exports.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}
+ */
+exports.LOCALNET_SAP_PROGRAM_ID = new web3_js_1.PublicKey(exports.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}
+ */
+exports.SAP_PROGRAM_ID = exports.MAINNET_SAP_PROGRAM_ID;
+//# sourceMappingURL=programs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"programs.js","sourceRoot":"","sources":["../../../src/constants/programs.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAEH,6CAA4C;AAE5C,sEAAsE;AACtE,mBAAmB;AACnB,sEAAsE;AAEtE;;;;;;;;;;GAUG;AACU,QAAA,mBAAmB,GAC9B,6CAA6C,CAAC;AAEhD,sEAAsE;AACtE,0BAA0B;AAC1B,sEAAsE;AAEtE;;;;;;;;GAQG;AACU,QAAA,sBAAsB,GAAG,IAAI,mBAAS,CAAC,2BAAmB,CAAC,CAAC;AAEzE;;;;;;;;GAQG;AACU,QAAA,qBAAqB,GAAG,IAAI,mBAAS,CAAC,2BAAmB,CAAC,CAAC;AAExE;;;;;;;;;;GAUG;AACU,QAAA,uBAAuB,GAAG,IAAI,mBAAS,CAAC,2BAAmB,CAAC,CAAC;AAE1E;;;;;;;;;;GAUG;AACU,QAAA,cAAc,GAAG,8BAAsB,CAAC"}

package/dist/cjs/constants/seeds.js

@@ -0,0 +1,57 @@
+"use strict";
+/**
+ * @module constants/seeds
+ * @description PDA seed prefix constants.
+ *
+ * Every seed string mirrors the Rust `#[account(seeds = [...])]` definitions.
+ *
+ * @category Constants
+ * @since v0.1.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SEEDS = void 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}
+ */
+exports.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",
+    STATS: "sap_stats",
+    TOOL_CATEGORY: "sap_tool_cat",
+    ATTESTATION: "sap_attest",
+    LEDGER: "sap_ledger",
+    LEDGER_PAGE: "sap_page",
+};
+//# sourceMappingURL=seeds.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"seeds.js","sourceRoot":"","sources":["../../../src/constants/seeds.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,sEAAsE;AACtE,qBAAqB;AACrB,sEAAsE;AAEtE;;;;;;;;;;;;;;;;;;GAkBG;AACU,QAAA,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,KAAK,EAAE,WAAW;IAClB,aAAa,EAAE,cAAc;IAC7B,WAAW,EAAE,YAAY;IACzB,MAAM,EAAE,YAAY;IACpB,WAAW,EAAE,UAAU;CACf,CAAC"}