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

package/dist/cjs/types/enums.js

@@ -0,0 +1,174 @@
+"use strict";
+/**
+ * @module types/enums
+ * @description Anchor-compatible enum variant objects for SAP v2.
+ *
+ * Each enum mirrors the Rust discriminant format used by Anchor:
+ * `{ variant: {} }` — e.g. `{ sol: {} }` for `TokenType::Sol`.
+ *
+ * Use the `*Kind` types for function signatures.
+ *
+ * @category Types
+ * @since v0.1.0
+ * @see {@link https://solana.com/docs | Solana Docs}
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolCategory = exports.ToolHttpMethod = exports.SettlementMode = exports.PluginType = exports.TokenType = void 0;
+// ═══════════════════════════════════════════════════════════════════
+//  Token Type
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * @name TokenType
+ * @description Anchor-compatible enum variants for token types accepted by agent pricing and escrow.
+ *
+ * - `Sol` — Native SOL.
+ * - `Usdc` — USDC stablecoin.
+ * - `Spl` — Arbitrary SPL token (requires `tokenMint`).
+ *
+ * @category Types
+ * @since v0.1.0
+ *
+ * @example
+ * ```ts
+ * import { TokenType } from "@synapse-sap/sdk";
+ *
+ * const tier = { tokenType: TokenType.Sol };
+ * ```
+ */
+exports.TokenType = {
+    Sol: { sol: {} },
+    Usdc: { usdc: {} },
+    Spl: { spl: {} },
+};
+// ═══════════════════════════════════════════════════════════════════
+//  Plugin Type
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * @name PluginType
+ * @description Anchor-compatible enum variants for plugin extension types.
+ *
+ * Plugins extend agent functionality and are feature-gated on-chain.
+ *
+ * - `Memory` — Encrypted memory / vault storage.
+ * - `Validation` — Custom validation logic.
+ * - `Delegation` — Hot-wallet delegation.
+ * - `Analytics` — Metrics & analytics.
+ * - `Governance` — DAO / governance participation.
+ * - `Custom` — User-defined plugin type.
+ *
+ * @category Types
+ * @since v0.1.0
+ *
+ * @example
+ * ```ts
+ * import { PluginType } from "@synapse-sap/sdk";
+ *
+ * const ref = { pluginType: PluginType.Memory, pda: vaultPda };
+ * ```
+ */
+exports.PluginType = {
+    Memory: { memory: {} },
+    Validation: { validation: {} },
+    Delegation: { delegation: {} },
+    Analytics: { analytics: {} },
+    Governance: { governance: {} },
+    Custom: { custom: {} },
+};
+// ═══════════════════════════════════════════════════════════════════
+//  Settlement Mode
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * @name SettlementMode
+ * @description Anchor-compatible enum variants for payment settlement strategies.
+ *
+ * - `Instant` — Pay-per-call, settled immediately on invocation.
+ * - `Escrow` — Pre-funded escrow account with per-call drawdown.
+ * - `Batched` — Aggregated settlement at fixed intervals.
+ * - `X402` — HTTP 402-based micropayment protocol settlement.
+ *
+ * @category Types
+ * @since v0.1.0
+ *
+ * @example
+ * ```ts
+ * import { SettlementMode } from "@synapse-sap/sdk";
+ *
+ * const tier = { settlementMode: SettlementMode.Escrow };
+ * ```
+ */
+exports.SettlementMode = {
+    Instant: { instant: {} },
+    Escrow: { escrow: {} },
+    Batched: { batched: {} },
+    X402: { x402: {} },
+};
+// ═══════════════════════════════════════════════════════════════════
+//  Tool HTTP Method
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * @name ToolHttpMethod
+ * @description Anchor-compatible enum variants for the HTTP method exposed by a tool.
+ *
+ * - `Get` / `Post` / `Put` / `Delete` — Standard REST verbs.
+ * - `Compound` — Multi-step tool (calls several sub-operations).
+ *
+ * @category Types
+ * @since v0.1.0
+ *
+ * @example
+ * ```ts
+ * import { ToolHttpMethod } from "@synapse-sap/sdk";
+ *
+ * const args = { httpMethod: ToolHttpMethod.Post };
+ * ```
+ */
+exports.ToolHttpMethod = {
+    Get: { get: {} },
+    Post: { post: {} },
+    Put: { put: {} },
+    Delete: { delete: {} },
+    Compound: { compound: {} },
+};
+// ═══════════════════════════════════════════════════════════════════
+//  Tool Category
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * @name ToolCategory
+ * @description Anchor-compatible enum variants for classifying tools in the on-chain registry.
+ *
+ * Categories power cross-agent tool discovery via the `ToolCategoryIndex` PDA.
+ *
+ * - `Swap` — Token swap / DEX tools.
+ * - `Lend` — Lending protocol tools.
+ * - `Stake` — Staking / validator tools.
+ * - `Nft` — NFT minting / marketplace tools.
+ * - `Payment` — Payment & invoicing tools.
+ * - `Data` — Data feeds / oracles.
+ * - `Governance` — DAO & governance tools.
+ * - `Bridge` — Cross-chain bridge tools.
+ * - `Analytics` — On-chain analytics.
+ * - `Custom` — User-defined category.
+ *
+ * @category Types
+ * @since v0.1.0
+ *
+ * @example
+ * ```ts
+ * import { ToolCategory } from "@synapse-sap/sdk";
+ *
+ * const args = { category: ToolCategory.Swap };
+ * ```
+ */
+exports.ToolCategory = {
+    Swap: { swap: {} },
+    Lend: { lend: {} },
+    Stake: { stake: {} },
+    Nft: { nft: {} },
+    Payment: { payment: {} },
+    Data: { data: {} },
+    Governance: { governance: {} },
+    Bridge: { bridge: {} },
+    Analytics: { analytics: {} },
+    Custom: { custom: {} },
+};
+//# sourceMappingURL=enums.js.map

package/dist/cjs/types/enums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.js","sourceRoot":"","sources":["../../../src/types/enums.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAEH,sEAAsE;AACtE,cAAc;AACd,sEAAsE;AAEtE;;;;;;;;;;;;;;;;;GAiBG;AACU,QAAA,SAAS,GAAG;IACvB,GAAG,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;IAChB,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;IAClB,GAAG,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;CACR,CAAC;AASX,sEAAsE;AACtE,eAAe;AACf,sEAAsE;AAEtE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACU,QAAA,UAAU,GAAG;IACxB,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;IACtB,UAAU,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;IAC9B,UAAU,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;IAC9B,SAAS,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;IAC5B,UAAU,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;IAC9B,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;CACd,CAAC;AAQX,sEAAsE;AACtE,mBAAmB;AACnB,sEAAsE;AAEtE;;;;;;;;;;;;;;;;;;GAkBG;AACU,QAAA,cAAc,GAAG;IAC5B,OAAO,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;IACxB,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;IACtB,OAAO,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;IACxB,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;CACV,CAAC;AASX,sEAAsE;AACtE,oBAAoB;AACpB,sEAAsE;AAEtE;;;;;;;;;;;;;;;;GAgBG;AACU,QAAA,cAAc,GAAG;IAC5B,GAAG,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;IAChB,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;IAClB,GAAG,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;IAChB,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;IACtB,QAAQ,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;CAClB,CAAC;AASX,sEAAsE;AACtE,iBAAiB;AACjB,sEAAsE;AAEtE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACU,QAAA,YAAY,GAAG;IAC1B,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;IAClB,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;IAClB,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;IACpB,GAAG,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;IAChB,OAAO,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;IACxB,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;IAClB,UAAU,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;IAC9B,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;IACtB,SAAS,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;IAC5B,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;CACd,CAAC"}

package/dist/cjs/types/index.js

@@ -0,0 +1,36 @@
+"use strict";
+/**
+ * @module types
+ * @description Strongly-typed domain models for SAP v2.
+ *
+ * Every type mirrors the onchain Rust struct / enum exactly.
+ * Types are organized into four layers:
+ *
+ * - **enums** — Anchor-style enum variant objects (`TokenType`, `ToolCategory`, …)
+ * - **common** — Shared helper structs (`Capability`, `PricingTier`, `Settlement`, …)
+ * - **accounts** — Deserialized on-chain PDA account data (`AgentAccountData`, …)
+ * - **instructions** — Instruction argument DTOs + permission/schema helpers
+ *
+ * @category Types
+ * @since v0.1.0
+ *
+ * @example
+ * ```ts
+ * import type { AgentAccountData, RegisterAgentArgs } from "@synapse-sap/sdk/types";
+ * import { TokenType, SettlementMode } from "@synapse-sap/sdk/types";
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompressionType = exports.SchemaType = exports.DelegatePermission = exports.ToolCategory = exports.ToolHttpMethod = exports.SettlementMode = exports.PluginType = exports.TokenType = void 0;
+// ── Enums ────────────────────────────────────────────
+var enums_1 = require("./enums");
+Object.defineProperty(exports, "TokenType", { enumerable: true, get: function () { return enums_1.TokenType; } });
+Object.defineProperty(exports, "PluginType", { enumerable: true, get: function () { return enums_1.PluginType; } });
+Object.defineProperty(exports, "SettlementMode", { enumerable: true, get: function () { return enums_1.SettlementMode; } });
+Object.defineProperty(exports, "ToolHttpMethod", { enumerable: true, get: function () { return enums_1.ToolHttpMethod; } });
+Object.defineProperty(exports, "ToolCategory", { enumerable: true, get: function () { return enums_1.ToolCategory; } });
+var instructions_1 = require("./instructions");
+Object.defineProperty(exports, "DelegatePermission", { enumerable: true, get: function () { return instructions_1.DelegatePermission; } });
+Object.defineProperty(exports, "SchemaType", { enumerable: true, get: function () { return instructions_1.SchemaType; } });
+Object.defineProperty(exports, "CompressionType", { enumerable: true, get: function () { return instructions_1.CompressionType; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,wDAAwD;AACxD,iCAMiB;AALf,kGAAA,SAAS,OAAA;AACT,mGAAA,UAAU,OAAA;AACV,uGAAA,cAAc,OAAA;AACd,uGAAA,cAAc,OAAA;AACd,qGAAA,YAAY,OAAA;AA2Dd,+CAIwB;AAHtB,kHAAA,kBAAkB,OAAA;AAClB,0GAAA,UAAU,OAAA;AACV,+GAAA,eAAe,OAAA"}

package/dist/cjs/types/instructions.js

@@ -0,0 +1,92 @@
+"use strict";
+/**
+ * @module types/instructions
+ * @description Instruction argument DTOs and helper enumerations.
+ *
+ * These interfaces map 1:1 to the Anchor instruction argument structs.
+ * Use them when calling SDK module methods.
+ *
+ * @category Types
+ * @since v0.1.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompressionType = exports.SchemaType = exports.DelegatePermission = void 0;
+// ═══════════════════════════════════════════════════════════════════
+//  Permission & Schema Helpers
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * @name DelegatePermission
+ * @description Bitmask constants for vault delegate permissions.
+ *
+ * Combine with bitwise OR to grant multiple permissions.
+ *
+ * | Bit | Value | Permission          |
+ * | --- | ----- | ------------------- |
+ * | 0   | 1     | Inscribe memories   |
+ * | 1   | 2     | Close sessions      |
+ * | 2   | 4     | Open sessions       |
+ * | —   | 7     | All permissions     |
+ *
+ * @category Types
+ * @since v0.1.0
+ *
+ * @example
+ * ```ts
+ * import { DelegatePermission } from "@synapse-sap/sdk";
+ *
+ * // Grant inscribe + open session
+ * const perms = DelegatePermission.Inscribe | DelegatePermission.OpenSession;
+ * ```
+ */
+exports.DelegatePermission = {
+    Inscribe: 1,
+    CloseSession: 2,
+    OpenSession: 4,
+    All: 7,
+};
+/**
+ * @name SchemaType
+ * @description Numeric discriminants for tool schema types.
+ *
+ * Used in the `inscribeToolSchema` instruction to specify which schema
+ * is being written on-chain.
+ *
+ * @category Types
+ * @since v0.1.0
+ *
+ * @example
+ * ```ts
+ * import { SchemaType } from "@synapse-sap/sdk";
+ *
+ * const args = { schemaType: SchemaType.Input, ... };
+ * ```
+ */
+exports.SchemaType = {
+    Input: 0,
+    Output: 1,
+    Description: 2,
+};
+/**
+ * @name CompressionType
+ * @description Numeric discriminants for compression algorithms.
+ *
+ * Used in inscription instructions to declare the compression format
+ * of the payload so consumers can decompress correctly.
+ *
+ * @category Types
+ * @since v0.1.0
+ *
+ * @example
+ * ```ts
+ * import { CompressionType } from "@synapse-sap/sdk";
+ *
+ * const args = { compression: CompressionType.Gzip, ... };
+ * ```
+ */
+exports.CompressionType = {
+    None: 0,
+    Deflate: 1,
+    Gzip: 2,
+    Brotli: 3,
+};
+//# sourceMappingURL=instructions.js.map

package/dist/cjs/types/instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../../src/types/instructions.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AA+SH,sEAAsE;AACtE,+BAA+B;AAC/B,sEAAsE;AAEtE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACU,QAAA,kBAAkB,GAAG;IAChC,QAAQ,EAAE,CAAC;IACX,YAAY,EAAE,CAAC;IACf,WAAW,EAAE,CAAC;IACd,GAAG,EAAE,CAAC;CACE,CAAC;AASX;;;;;;;;;;;;;;;;GAgBG;AACU,QAAA,UAAU,GAAG;IACxB,KAAK,EAAE,CAAC;IACR,MAAM,EAAE,CAAC;IACT,WAAW,EAAE,CAAC;CACN,CAAC;AAQX;;;;;;;;;;;;;;;;GAgBG;AACU,QAAA,eAAe,GAAG;IAC7B,IAAI,EAAE,CAAC;IACP,OAAO,EAAE,CAAC;IACV,IAAI,EAAE,CAAC;IACP,MAAM,EAAE,CAAC;CACD,CAAC"}

package/dist/cjs/utils/hash.js

@@ -0,0 +1,58 @@
+"use strict";
+/**
+ * @module utils/hash
+ * @description Cryptographic hashing utilities.
+ *
+ * @category Utils
+ * @since v0.1.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hashToArray = exports.sha256 = void 0;
+const crypto_1 = require("crypto");
+/**
+ * Compute the SHA-256 hash of a UTF-8 string or byte buffer.
+ *
+ * Returns a 32-byte `Uint8Array` suitable for PDA seeds
+ * and Anchor instruction arguments.
+ *
+ * @name sha256
+ * @description Hashes the input using Node’s `crypto.createHash("sha256")`.
+ * @param input - A UTF-8 string, `Buffer`, or `Uint8Array` to hash.
+ * @returns {Uint8Array} 32-byte SHA-256 digest.
+ * @category Utils
+ * @since v0.1.0
+ * @example
+ * ```ts
+ * import { sha256 } from "@synapse-sap/sdk/utils";
+ *
+ * const hash = sha256("jupiter:swap"); // Uint8Array (32 bytes)
+ * ```
+ */
+const sha256 = (input) => {
+    const hash = (0, crypto_1.createHash)("sha256");
+    hash.update(typeof input === "string" ? Buffer.from(input, "utf-8") : input);
+    return new Uint8Array(hash.digest());
+};
+exports.sha256 = sha256;
+/**
+ * Convert a `Uint8Array` hash to a plain `number[]`.
+ *
+ * Anchor instruction argument types expect `number[]` for hash fields
+ * rather than typed arrays.
+ *
+ * @name hashToArray
+ * @description Converts a byte array (typically 32 bytes) to a plain JavaScript `number[]`.
+ * @param hash - The byte array to convert.
+ * @returns {number[]} Shallow copy as a plain array of numbers.
+ * @category Utils
+ * @since v0.1.0
+ * @example
+ * ```ts
+ * import { sha256, hashToArray } from "@synapse-sap/sdk/utils";
+ *
+ * const arr = hashToArray(sha256("jupiter:swap")); // number[]
+ * ```
+ */
+const hashToArray = (hash) => Array.from(hash);
+exports.hashToArray = hashToArray;
+//# sourceMappingURL=hash.js.map

package/dist/cjs/utils/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../../src/utils/hash.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,mCAAoC;AAEpC;;;;;;;;;;;;;;;;;;GAkBG;AACI,MAAM,MAAM,GAAG,CAAC,KAAmC,EAAc,EAAE;IACxE,MAAM,IAAI,GAAG,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM,CACT,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAChE,CAAC;IACF,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;AACvC,CAAC,CAAC;AANW,QAAA,MAAM,UAMjB;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACI,MAAM,WAAW,GAAG,CAAC,IAAgB,EAAY,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAA/D,QAAA,WAAW,eAAoD"}

package/dist/cjs/utils/index.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * @module utils
+ * @description Shared utilities used across SDK modules.
+ *
+ * @category Utils
+ * @since v0.1.0
+ *
+ * @example
+ * ```ts
+ * import { sha256, hashToArray, assert } from "@synapse-sap/sdk/utils";
+ *
+ * const hash = sha256("jupiter:swap");
+ * const arr  = hashToArray(hash);      // number[] for Anchor args
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serializeValue = exports.serializeAccount = exports.assert = exports.hashToArray = exports.sha256 = void 0;
+var hash_1 = require("./hash");
+Object.defineProperty(exports, "sha256", { enumerable: true, get: function () { return hash_1.sha256; } });
+Object.defineProperty(exports, "hashToArray", { enumerable: true, get: function () { return hash_1.hashToArray; } });
+var validation_1 = require("./validation");
+Object.defineProperty(exports, "assert", { enumerable: true, get: function () { return validation_1.assert; } });
+var serialization_1 = require("./serialization");
+Object.defineProperty(exports, "serializeAccount", { enumerable: true, get: function () { return serialization_1.serializeAccount; } });
+Object.defineProperty(exports, "serializeValue", { enumerable: true, get: function () { return serialization_1.serializeValue; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAEH,+BAA6C;AAApC,8FAAA,MAAM,OAAA;AAAE,mGAAA,WAAW,OAAA;AAC5B,2CAAsC;AAA7B,oGAAA,MAAM,OAAA;AACf,iDAAmE;AAA1D,iHAAA,gBAAgB,OAAA;AAAE,+GAAA,cAAc,OAAA"}

package/dist/cjs/utils/serialization.js

@@ -0,0 +1,105 @@
+"use strict";
+/**
+ * @module utils/serialization
+ * @description JSON-safe serialization helpers for on-chain account data.
+ *
+ * On-chain Anchor account objects contain `PublicKey` and `BN` instances
+ * that are not JSON-serializable. These helpers convert them to plain
+ * strings (`base58` and decimal `string`) recursively.
+ *
+ * @category Utils
+ * @since v0.1.0
+ *
+ * @example
+ * ```ts
+ * import { serializeAccount } from "@synapse-sap/sdk/utils";
+ *
+ * const raw = await program.account.agent.fetch(pda);
+ * const json = serializeAccount(raw);
+ * // { authority: "GBL...", totalCalls: "42", ... }
+ * ```
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serializeValue = serializeValue;
+exports.serializeAccount = serializeAccount;
+const web3_js_1 = require("@solana/web3.js");
+const bn_js_1 = __importDefault(require("bn.js"));
+/**
+ * Recursively convert a single value for JSON serialization.
+ *
+ * - `PublicKey` → base58 string
+ * - `BN` → decimal string
+ * - `Uint8Array` / `Buffer` → hex string
+ * - `Array` → recursed
+ * - plain `object` → recursed via {@link serializeAccount}
+ * - primitives → identity
+ *
+ * @name serializeValue
+ * @description Transforms a single Anchor-typed value into its JSON-safe equivalent.
+ * @param value - The value to serialize.
+ * @returns The JSON-safe representation of `value`.
+ * @category Utils
+ * @since v0.1.0
+ * @example
+ * ```ts
+ * import { serializeValue } from "@synapse-sap/sdk/utils";
+ *
+ * serializeValue(new PublicKey("11111111111111111111111111111111")); // "1111..."
+ * serializeValue(new BN(42)); // "42"
+ * ```
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function serializeValue(value) {
+    if (value === null || value === undefined)
+        return null;
+    if (value instanceof web3_js_1.PublicKey)
+        return value.toBase58();
+    if (bn_js_1.default.isBN(value))
+        return value.toString();
+    if (value instanceof Uint8Array || Buffer.isBuffer(value))
+        return Buffer.from(value).toString("hex");
+    if (Array.isArray(value))
+        return value.map(serializeValue);
+    if (typeof value === "object") {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        return serializeAccount(value);
+    }
+    return value;
+}
+/**
+ * Serialize an entire on-chain account object to a JSON-safe shape.
+ *
+ * Iterates over each key and delegates to {@link serializeValue}.
+ * Handles `PublicKey` → base58, `BN` → string, and nested
+ * objects / arrays recursively.
+ *
+ * @name serializeAccount
+ * @description Converts all non-primitive fields in an Anchor account record to JSON-safe strings.
+ * @param obj - The raw account object returned by `program.account.<name>.fetch()`.
+ * @returns A new plain object with all values converted.
+ * @category Utils
+ * @since v0.1.0
+ * @example
+ * ```ts
+ * import { serializeAccount } from "@synapse-sap/sdk/utils";
+ *
+ * const raw = await program.account.agent.fetch(pda);
+ * const safe = serializeAccount(raw);
+ * console.log(JSON.stringify(safe));
+ * ```
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function serializeAccount(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+obj) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        result[key] = serializeValue(value);
+    }
+    return result;
+}
+//# sourceMappingURL=serialization.js.map

package/dist/cjs/utils/serialization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.js","sourceRoot":"","sources":["../../../src/utils/serialization.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;;;;AA8BH,wCAYC;AAyBD,4CAWC;AA5ED,6CAA4C;AAC5C,kDAAuB;AAEvB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,8DAA8D;AAC9D,SAAgB,cAAc,CAAC,KAAc;IAC3C,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACvD,IAAI,KAAK,YAAY,mBAAS;QAAE,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IACxD,IAAI,eAAE,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC5C,IAAI,KAAK,YAAY,UAAU,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QACvD,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC3D,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,8DAA8D;QAC9D,OAAO,gBAAgB,CAAC,KAA4B,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,8DAA8D;AAC9D,SAAgB,gBAAgB;AAC9B,8DAA8D;AAC9D,GAAwB;IAGxB,8DAA8D;IAC9D,MAAM,MAAM,GAAwB,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,MAAM,CAAC,GAAG,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/cjs/utils/validation.js

@@ -0,0 +1,36 @@
+"use strict";
+/**
+ * @module utils/validation
+ * @description Runtime assertion helpers.
+ *
+ * @category Utils
+ * @since v0.1.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assert = assert;
+/**
+ * Assert that a condition holds, throwing a descriptive error otherwise.
+ *
+ * Uses TypeScript’s `asserts condition` return type so the compiler
+ * narrows the guarded value after the call.
+ *
+ * @name assert
+ * @description Runtime guard — throws `RangeError` with a `[SAP SDK]` prefix when the condition is falsy.
+ * @param condition - The boolean expression to verify.
+ * @param message   - Human-readable message included in the thrown error.
+ * @throws {RangeError} When `condition` is `false`.
+ * @category Utils
+ * @since v0.1.0
+ * @example
+ * ```ts
+ * import { assert } from "@synapse-sap/sdk/utils";
+ *
+ * assert(name.length <= 64, "Agent name exceeds MAX_NAME_LEN");
+ * ```
+ */
+function assert(condition, message) {
+    if (!condition) {
+        throw new RangeError(`[SAP SDK] ${message}`);
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/cjs/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/utils/validation.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAsBH,wBAOC;AA3BD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAgB,MAAM,CACpB,SAAkB,EAClB,OAAe;IAEf,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,UAAU,CAAC,aAAa,OAAO,EAAE,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC"}

package/dist/esm/constants/index.js

@@ -0,0 +1,29 @@
+/**
+ * @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";
+// ── Limits & Versions ────────────────────────────────
+export { LIMITS, AGENT_VERSION, VAULT_PROTOCOL_VERSION, TOOL_CATEGORY_VALUES, HTTP_METHOD_VALUES, } from "./limits";
+//# sourceMappingURL=index.js.map

package/dist/esm/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,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,wDAAwD;AACxD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGhC,wDAAwD;AACxD,OAAO,EACL,MAAM,EACN,aAAa,EACb,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,UAAU,CAAC"}