@oobe-protocol-labs/synapse-sap-sdk 0.3.0 → 0.4.1

package/dist/types/modules/vault.d.ts

@@ -15,7 +15,7 @@ import { BaseModule } from "./base";
 import type { MemoryVaultData, SessionLedgerData, EpochPageData, VaultDelegateData, InscribeMemoryArgs, CompactInscribeArgs } from "../types";
 /**
  * @name VaultModule
- * @description Manages encrypted memory vaults for the Solana Agent Protocol.
+ * @description Manages encrypted memory vaults for the Synapse Agent Protocol.
  *   Provides methods to initialise vaults, open/close sessions, inscribe
  *   encrypted data, manage delegates (hot wallets), rotate nonces, and
  *   fetch all related account types.

package/dist/types/pda/index.d.ts

@@ -292,5 +292,84 @@ export declare const deriveLedger: (sessionPda: PublicKey, programId?: PublicKey
  * @see LedgerPage
  */
 export declare const deriveLedgerPage: (ledgerPda: PublicKey, pageIndex: number, programId?: PublicKey) => PdaResult;
+/**
+ * Derive the **MemoryBuffer** PDA for a session at a given page index.
+ *
+ * Seeds: `["sap_buffer", session_pda, page_index_u32_le]`
+ *
+ * @name deriveBuffer
+ * @description Computes the buffer page PDA for chunked memory writes within a session.
+ * @param sessionPda - The parent session's PDA.
+ * @param pageIndex  - Zero-based page index.
+ * @param programId  - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
+ * @returns {PdaResult} `[pda, bump]` tuple.
+ * @category PDA
+ * @since v0.3.1
+ * @see MemoryBuffer
+ */
+export declare const deriveBuffer: (sessionPda: PublicKey, pageIndex: number, programId?: PublicKey) => PdaResult;
+/**
+ * Derive the **SessionDigest** PDA for a session.
+ *
+ * Seeds: `["sap_digest", session_pda]`
+ *
+ * @name deriveDigest
+ * @description Computes the digest PDA that stores a compact hash summary of a session.
+ * @param sessionPda - The parent session's PDA.
+ * @param programId  - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
+ * @returns {PdaResult} `[pda, bump]` tuple.
+ * @category PDA
+ * @since v0.3.1
+ * @see SessionDigest
+ */
+export declare const deriveDigest: (sessionPda: PublicKey, programId?: PublicKey) => PdaResult;
+/**
+ * Derive the **PluginConfig** PDA for an agent and plugin type.
+ *
+ * Seeds: `["sap_plugin", agent_pda, plugin_type_u8]`
+ *
+ * @name derivePlugin
+ * @description Computes the plugin configuration PDA scoped to an agent and plugin type.
+ * @param agentPda   - The owning agent's PDA.
+ * @param pluginType - The `u8` plugin type discriminant.
+ * @param programId  - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
+ * @returns {PdaResult} `[pda, bump]` tuple.
+ * @category PDA
+ * @since v0.3.1
+ * @see PluginConfig
+ */
+export declare const derivePlugin: (agentPda: PublicKey, pluginType: number, programId?: PublicKey) => PdaResult;
+/**
+ * Derive the **MemoryEntry** PDA for an agent and entry hash.
+ *
+ * Seeds: `["sap_memory", agent_pda, entry_hash]`
+ *
+ * @name deriveMemoryEntry
+ * @description Computes the memory entry PDA for legacy key-value memory storage.
+ * @param agentPda  - The owning agent's PDA.
+ * @param entryHash - SHA-256 hash of the entry key (32 bytes).
+ * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
+ * @returns {PdaResult} `[pda, bump]` tuple.
+ * @category PDA
+ * @since v0.3.1
+ * @see MemoryEntry
+ */
+export declare const deriveMemoryEntry: (agentPda: PublicKey, entryHash: Uint8Array, programId?: PublicKey) => PdaResult;
+/**
+ * Derive the **MemoryChunk** PDA for a memory entry at a given chunk index.
+ *
+ * Seeds: `["sap_mem_chunk", memory_entry_pda, chunk_index_u8]`
+ *
+ * @name deriveMemoryChunk
+ * @description Computes the chunk PDA for fragmented memory entry data.
+ * @param memoryEntryPda - The parent memory entry's PDA.
+ * @param chunkIndex     - Zero-based chunk index (0–255).
+ * @param programId      - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
+ * @returns {PdaResult} `[pda, bump]` tuple.
+ * @category PDA
+ * @since v0.3.1
+ * @see MemoryChunk
+ */
+export declare const deriveMemoryChunk: (memoryEntryPda: PublicKey, chunkIndex: number, programId?: PublicKey) => PdaResult;
 export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/types/pda/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/pda/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C;;;;;;;;GAQG;AACH,KAAK,SAAS,GAAG,SAAS,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AAoDzD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,oBAAoB,GAC/B,qBAA0B,KACzB,SAC4C,CAAC;AAEhD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,WAAW,GACtB,QAAQ,SAAS,EACjB,qBAA0B,KACzB,SAC8D,CAAC;AAElE;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,gBAAgB,GAC3B,UAAU,SAAS,EACnB,qBAA0B,KACzB,SACgE,CAAC;AAMpE;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc,GACzB,UAAU,SAAS,EACnB,UAAU,SAAS,EACnB,qBAA0B,KACzB,SAIA,CAAC;AAMJ;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,qBAAqB,GAChC,gBAAgB,UAAU,EAC1B,qBAA0B,KACzB,SAIA,CAAC;AAEJ;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,mBAAmB,GAC9B,cAAc,UAAU,EACxB,qBAA0B,KACzB,SAIA,CAAC;AAEJ;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,uBAAuB,GAClC,UAAU,MAAM,EAChB,qBAA0B,KACzB,SAIA,CAAC;AAMJ;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,WAAW,GACtB,UAAU,SAAS,EACnB,qBAA0B,KACzB,SACgE,CAAC;AAEpE;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,aAAa,GACxB,UAAU,SAAS,EACnB,aAAa,UAAU,EACvB,qBAA0B,KACzB,SAQA,CAAC;AAEJ;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,eAAe,GAC1B,YAAY,SAAS,EACrB,YAAY,MAAM,EAClB,qBAA0B,KACzB,SAIA,CAAC;AAEJ;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,mBAAmB,GAC9B,UAAU,SAAS,EACnB,UAAU,SAAS,EACnB,qBAA0B,KACzB,SAIA,CAAC;AAEJ;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,gBAAgB,GAC3B,YAAY,SAAS,EACrB,iBAAiB,MAAM,EACvB,qBAA0B,KACzB,SAQA,CAAC;AAMJ;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,UAAU,GACrB,UAAU,SAAS,EACnB,cAAc,UAAU,EACxB,qBAA0B,KACzB,SAIA,CAAC;AAMJ;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,YAAY,GACvB,UAAU,SAAS,EACnB,WAAW,SAAS,EACpB,qBAA0B,KACzB,SAIA,CAAC;AAMJ;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,iBAAiB,GAC5B,UAAU,SAAS,EACnB,UAAU,SAAS,EACnB,qBAA0B,KACzB,SAIA,CAAC;AAMJ;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,YAAY,GACvB,YAAY,SAAS,EACrB,qBAA0B,KACzB,SACmE,CAAC;AAEvE;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,gBAAgB,GAC3B,WAAW,SAAS,EACpB,WAAW,MAAM,EACjB,qBAA0B,KACzB,SAIA,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/pda/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oobe-protocol-labs/synapse-sap-sdk",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "TypeScript SDK for the Synapse Agent Protocol (SAP v2) on Solana",
   "license": "MIT",
   "main": "dist/cjs/index.js",

package/src/constants/addresses.ts

@@ -0,0 +1,162 @@
+/**
+ * @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

@@ -42,3 +42,14 @@ export {
   TOOL_CATEGORY_VALUES,
   HTTP_METHOD_VALUES,
 } from "./limits";
+// ── 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";

package/src/constants/programs.ts

@@ -19,7 +19,7 @@ import { PublicKey } from "@solana/web3.js";
 /**
  * SAP v2 program address string (base58).
  *
- * Vanity keypair derived from the `SAPTU7a…` prefix.
+ * Vanity keypair derived from the `SAPpUh…` prefix.
  *
  * @name SAP_PROGRAM_ADDRESS
  * @description The canonical on-chain program address shared by all Solana clusters.

package/src/constants/seeds.ts

@@ -52,6 +52,8 @@ export const SEEDS = {
   ATTESTATION: "sap_attest",
   LEDGER: "sap_ledger",
   LEDGER_PAGE: "sap_page",
+  BUFFER: "sap_buffer",
+  DIGEST: "sap_digest",
 } as const;
 
 /**

package/src/core/client.ts

@@ -50,7 +50,7 @@ type SapProgram = Program<any>;
 
 /**
  * @name SapClient
- * @description Root entry point for the Solana Agent Protocol v2 TypeScript SDK.
+ * @description Root entry point for the Synapse Agent Protocol v2 TypeScript SDK.
  *
  * Each protocol domain is exposed as a lazily-instantiated module:
  * `agent`, `feedback`, `indexing`, `tools`, `vault`, `escrow`,

package/src/core/connection.ts

@@ -31,9 +31,11 @@ import {
   type Commitment,
   Keypair,
   type PublicKey,
+  type Transaction,
+  type VersionedTransaction,
   LAMPORTS_PER_SOL,
 } from "@solana/web3.js";
-import { AnchorProvider, Wallet } from "@coral-xyz/anchor";
+import { AnchorProvider } from "@coral-xyz/anchor";
 import {
   SAP_PROGRAM_ID,
   MAINNET_SAP_PROGRAM_ID,
@@ -42,6 +44,56 @@ import {
 } from "../constants";
 import { SapClient } from "./client";
 
+// ═══════════════════════════════════════════════════════════════════
+//  Wallet interface (replaces Anchor's Wallet which is not
+//  exported from the ESM bundle of @coral-xyz/anchor)
+// ═══════════════════════════════════════════════════════════════════
+
+/**
+ * @interface SapWallet
+ * @description Minimal wallet/signer interface compatible with
+ * Anchor's `AnchorProvider`. Avoids importing `Wallet` from
+ * `@coral-xyz/anchor` which is absent in ESM builds.
+ * @category Core
+ * @since v0.4.1
+ */
+export interface SapWallet {
+  readonly publicKey: PublicKey;
+  signTransaction<T extends Transaction | VersionedTransaction>(tx: T): Promise<T>;
+  signAllTransactions<T extends Transaction | VersionedTransaction>(txs: T[]): Promise<T[]>;
+}
+
+/**
+ * @name KeypairWallet
+ * @description Simple wallet wrapper around a `Keypair`.
+ * Drop-in replacement for Anchor's `NodeWallet` / `Wallet` class.
+ * @category Core
+ * @since v0.4.1
+ */
+export class KeypairWallet implements SapWallet {
+  readonly publicKey: PublicKey;
+
+  constructor(readonly payer: Keypair) {
+    this.publicKey = payer.publicKey;
+  }
+
+  async signTransaction<T extends Transaction | VersionedTransaction>(tx: T): Promise<T> {
+    if ("partialSign" in tx) {
+      (tx as Transaction).partialSign(this.payer);
+    } else {
+      (tx as VersionedTransaction).sign([this.payer]);
+    }
+    return tx;
+  }
+
+  async signAllTransactions<T extends Transaction | VersionedTransaction>(txs: T[]): Promise<T[]> {
+    for (const tx of txs) {
+      await this.signTransaction(tx);
+    }
+    return txs;
+  }
+}
+
 // ═══════════════════════════════════════════════════════════════════
 //  Types
 // ═══════════════════════════════════════════════════════════════════
@@ -261,7 +313,7 @@ export class SapConnection {
       commitment: opts?.commitment,
       cluster: opts?.cluster,
     });
-    const client = conn.createClient(new Wallet(keypair));
+    const client = conn.createClient(new KeypairWallet(keypair));
     return Object.assign(conn, { client });
   }
 
@@ -270,18 +322,18 @@ export class SapConnection {
   // ─────────────────────────────────────────────
 
   /**
-   * Create a {@link SapClient} from an Anchor {@link Wallet} (signer).
+   * Create a {@link SapClient} from a {@link SapWallet} (signer).
    *
-   * @param {Wallet} wallet — An Anchor-compatible wallet/signer.
+   * @param {SapWallet} wallet — A wallet/signer implementing {@link SapWallet}.
    * @returns {SapClient} A fully-configured SAP client.
    * @since v0.1.0
    *
    * @example
    * ```ts
-   * const client = conn.createClient(new Wallet(keypair));
+   * const client = conn.createClient(new KeypairWallet(keypair));
    * ```
    */
-  createClient(wallet: Wallet): SapClient {
+  createClient(wallet: SapWallet): SapClient {
     const provider = new AnchorProvider(this.connection, wallet, {
       commitment: this.commitment,
     });
@@ -301,7 +353,7 @@ export class SapConnection {
    * ```
    */
   fromKeypair(keypair: Keypair): SapClient {
-    return this.createClient(new Wallet(keypair));
+    return this.createClient(new KeypairWallet(keypair));
   }
 
   // ─────────────────────────────────────────────

package/src/core/index.ts

@@ -16,5 +16,5 @@
  */
 
 export { SapClient } from "./client";
-export { SapConnection } from "./connection";
-export type { SapCluster, SapConnectionConfig } from "./connection";
+export { SapConnection, KeypairWallet } from "./connection";
+export type { SapCluster, SapConnectionConfig, SapWallet } from "./connection";

package/src/index.ts

@@ -1,5 +1,5 @@
 /**
- * @synapse-sap/sdk — TypeScript SDK for SAP v2 (Solana Agent Protocol)
+ * @synapse-sap/sdk — TypeScript SDK for SAP v2 (Synapse Agent Protocol)
  *
  * Modular architecture:
  *
@@ -44,8 +44,8 @@
  */
 
 // ── Core ─────────────────────────────────────────────
-export { SapClient, SapConnection } from "./core";
-export type { SapCluster, SapConnectionConfig } from "./core";
+export { SapClient, SapConnection, KeypairWallet } from "./core";
+export type { SapCluster, SapConnectionConfig, SapWallet } from "./core";
 
 // ── Types ────────────────────────────────────────────
 export type {

package/src/modules/agent.ts

@@ -1,6 +1,6 @@
 /**
  * @module agent
- * @description Agent lifecycle operations for the Solana Agent Protocol.
+ * @description Agent lifecycle operations for the Synapse Agent Protocol.
  *
  * Covers: register, update, deactivate, reactivate, close,
  * report calls, update reputation metrics, and account fetching.
@@ -22,7 +22,7 @@ import type {
 
 /**
  * @name AgentModule
- * @description Manages the full agent lifecycle on the Solana Agent Protocol.
+ * @description Manages the full agent lifecycle on the Synapse Agent Protocol.
  *   Provides methods to register, update, deactivate, reactivate, and close
  *   agent identities, as well as self-report call metrics and reputation data.
  *

package/src/modules/attestation.ts

@@ -18,7 +18,7 @@ import type { AgentAttestationData, CreateAttestationArgs } from "../types";
 
 /**
  * @name AttestationModule
- * @description Manages on-chain attestations for the Solana Agent Protocol.
+ * @description Manages on-chain attestations for the Synapse Agent Protocol.
  *   Provides methods to create, revoke, close, and fetch attestation PDAs
  *   that form the web-of-trust layer.
  *

package/src/modules/escrow.ts

@@ -34,7 +34,7 @@ import type {
  * @name EscrowModule
  * @description Manages x402-compatible escrow accounts for agent micropayments.
  *   Provides methods to create, fund, settle, withdraw, batch-settle, close,
- *   and fetch escrow PDAs on the Solana Agent Protocol.
+ *   and fetch escrow PDAs on the Synapse Agent Protocol.
  *
  * @category Modules
  * @since v0.1.0

package/src/modules/feedback.ts

@@ -18,7 +18,7 @@ import type { FeedbackAccountData, GiveFeedbackArgs, UpdateFeedbackArgs } from "
 
 /**
  * @name FeedbackModule
- * @description Manages on-chain feedback entries for the Solana Agent Protocol.
+ * @description Manages on-chain feedback entries for the Synapse Agent Protocol.
  *   Provides methods to give, update, revoke, close, and fetch feedback PDAs
  *   that form the trustless reputation layer.
  *

package/src/modules/indexing.ts

@@ -1,7 +1,7 @@
 /**
  * @module indexing
  * @description Scalable discovery layer — capability indexes, protocol indexes,
- * and tool category indexes for the Solana Agent Protocol.
+ * and tool category indexes for the Synapse Agent Protocol.
  *
  * Indexes are shared PDA-based registries that map agents and tools to
  * discovery dimensions, enabling efficient on-chain lookups.
@@ -29,7 +29,7 @@ import { sha256, hashToArray } from "../utils";
 
 /**
  * @name IndexingModule
- * @description Manages on-chain discovery indexes for the Solana Agent Protocol.
+ * @description Manages on-chain discovery indexes for the Synapse Agent Protocol.
  *   Provides methods to create, populate, prune, close, and fetch capability
  *   indexes, protocol indexes, and tool category indexes.
  *

package/src/modules/tools.ts

@@ -1,7 +1,7 @@
 /**
  * @module tools
  * @description Tool schema registry and session checkpoints for the
- * Solana Agent Protocol.
+ * Synapse Agent Protocol.
  *
  * Covers: publish, inscribe schema, update, deactivate/reactivate,
  * close, report invocations, and session checkpoint management.
@@ -31,7 +31,7 @@ import { sha256, hashToArray } from "../utils";
 /**
  * @name ToolsModule
  * @description Manages tool descriptors and session checkpoints for the
- *   Solana Agent Protocol. Provides methods to publish, update, deactivate,
+ *   Synapse Agent Protocol. Provides methods to publish, update, deactivate,
  *   reactivate, close, and fetch tool descriptors, as well as inscribe
  *   JSON schemas into TX logs and manage session checkpoints.
  *

package/src/modules/vault.ts

@@ -32,7 +32,7 @@ import type {
 
 /**
  * @name VaultModule
- * @description Manages encrypted memory vaults for the Solana Agent Protocol.
+ * @description Manages encrypted memory vaults for the Synapse Agent Protocol.
  *   Provides methods to initialise vaults, open/close sessions, inscribe
  *   encrypted data, manage delegates (hot wallets), rotate nonces, and
  *   fetch all related account types.