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

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

@@ -1,168 +0,0 @@
-/**
- * @module escrow
- * @description x402 escrow settlement layer — create, deposit,
- * settle, withdraw, batch settle, and close escrow accounts.
- *
- * Supports both SOL and SPL token escrows. SPL operations require
- * passing additional `AccountMeta[]` via the `splAccounts` parameter.
- *
- * @category Modules
- * @since v0.1.0
- * @packageDocumentation
- */
-import { type PublicKey, type TransactionSignature, type AccountMeta } from "@solana/web3.js";
-import { BN } from "@coral-xyz/anchor";
-import { BaseModule } from "./base";
-import type { EscrowAccountData, CreateEscrowArgs, Settlement } from "../types";
-import type { SettleOptions } from "../utils/priority-fee";
-/**
- * @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 Synapse Agent Protocol.
- *
- * @category Modules
- * @since v0.1.0
- * @extends BaseModule
- *
- * @example
- * ```ts
- * const sap = new SapClient(provider);
- * // Create a SOL escrow for an agent
- * const sig = await sap.escrow.create(agentWallet, {
- *   pricePerCall: new BN(1_000_000),
- *   maxCalls: new BN(100),
- *   initialDeposit: new BN(100_000_000),
- *   expiresAt: null,
- *   volumeCurve: null,
- *   tokenMint: null,
- *   tokenDecimals: null,
- * });
- * ```
- *
- * @deprecated Since v0.7.0 — Use {@link EscrowV2Module} (`client.escrowV2`) instead.
- * V1 escrows lack settlement security, dispute resolution, and staking integration.
- * Existing V1 escrows can be migrated via `client.escrowV2.migrateFromV1()`.
- */
-export declare class EscrowModule extends BaseModule {
-    /**
-     * @name deriveEscrow
-     * @description Derive the `EscrowAccount` PDA for a given agent and depositor.
-     * @param agentPda - The agent account PDA.
-     * @param depositor - The depositor wallet. Defaults to the connected wallet.
-     * @returns A tuple of `[PublicKey, bump]` for the escrow PDA.
-     * @see {@link deriveEscrow} from `pda/` module for the underlying derivation.
-     * @since v0.1.0
-     */
-    deriveEscrow(agentPda: PublicKey, depositor?: PublicKey): readonly [PublicKey, number];
-    /**
-     * @name create
-     * @description Create a new escrow for agent micropayments.
-     *
-     *   For **SOL escrow**: pass `tokenMint: null` and leave `splAccounts` empty.
-     *   For **SPL escrow**: pass `tokenMint`, `tokenDecimals`, and provide
-     *   `splAccounts` with `[depositorAta, escrowAta, tokenMint, tokenProgram]`.
-     *
-     * @param agentWallet - The wallet of the agent to pay.
-     * @param args - Escrow creation parameters (price, max calls, deposit, expiry, volume curve, token info).
-     * @param splAccounts - Remaining accounts for SPL token transfers:
-     *   `[depositorAta, escrowAta, tokenMint, tokenProgram]`. Defaults to `[]`.
-     * @returns {Promise<TransactionSignature>} The transaction signature.
-     * @since v0.1.0
-     */
-    create(agentWallet: PublicKey, args: CreateEscrowArgs, splAccounts?: AccountMeta[]): Promise<TransactionSignature>;
-    /**
-     * @name deposit
-     * @description Deposit additional funds into an existing escrow.
-     * @param agentWallet - The wallet of the agent associated with the escrow.
-     * @param amount - The amount to deposit (lamports for SOL, smallest unit for SPL).
-     * @param splAccounts - Remaining accounts for SPL token transfers. Defaults to `[]`.
-     * @returns {Promise<TransactionSignature>} The transaction signature.
-     * @since v0.1.0
-     */
-    deposit(agentWallet: PublicKey, amount: BN | number | bigint, splAccounts?: AccountMeta[]): Promise<TransactionSignature>;
-    /**
-     * @name settle
-     * @description Agent settles calls — claims earned funds from the escrow.
-     *   Must be called by the agent owner wallet.
-     * @param depositorWallet - The wallet of the client who funded the escrow.
-     * @param callsToSettle - Number of calls to settle payment for.
-     * @param serviceHash - A 32-byte SHA-256 hash identifying the service rendered.
-     * @param splAccounts - Remaining accounts for SPL token transfers. Defaults to `[]`.
-     * @param opts - Optional {@link SettleOptions} for priority fees and RPC tuning.
-     * @returns {Promise<TransactionSignature>} The transaction signature.
-     * @since v0.1.0
-     * @updated v0.6.2 — Added optional `opts` parameter for priority fees.
-     */
-    settle(depositorWallet: PublicKey, callsToSettle: BN | number | bigint, serviceHash: number[], splAccounts?: AccountMeta[], opts?: SettleOptions): Promise<TransactionSignature>;
-    /**
-     * @name withdraw
-     * @description Client withdraws un-settled funds from their escrow.
-     * @param agentWallet - The wallet of the agent associated with the escrow.
-     * @param amount - The amount to withdraw (lamports for SOL, smallest unit for SPL).
-     * @param splAccounts - Remaining accounts for SPL token transfers. Defaults to `[]`.
-     * @returns {Promise<TransactionSignature>} The transaction signature.
-     * @since v0.1.0
-     */
-    withdraw(agentWallet: PublicKey, amount: BN | number | bigint, splAccounts?: AccountMeta[]): Promise<TransactionSignature>;
-    /**
-     * @name close
-     * @description Close an empty escrow PDA (balance must be 0) and reclaim rent.
-     * @param agentWallet - The wallet of the agent associated with the escrow.
-     * @returns {Promise<TransactionSignature>} The transaction signature.
-     * @since v0.1.0
-     */
-    close(agentWallet: PublicKey): Promise<TransactionSignature>;
-    /**
-     * @name settleBatch
-     * @description Batch settlement — process up to 10 settlements in a single
-     *   transaction. Must be called by the agent owner wallet.
-     *
-     * @param depositorWallet - The wallet of the client who funded the escrow.
-     * @param settlements - Array of settlement entries (up to 10).
-     * @param batchRoot - Optional pre-computed batch root
-     *   (`sha256(s_0 || s_1 || ... || s_{N-1})`). When omitted the SDK
-     *   computes it from `settlements[*].serviceHash`. **Required on-chain
-     *   since v0.10.0** to seed the anti-replay receipt PDA.
-     * @param splAccounts - Remaining accounts for SPL token transfers. Defaults to `[]`.
-     * @param opts - Optional {@link SettleOptions} for priority fees and RPC tuning.
-     * @returns {Promise<TransactionSignature>} The transaction signature.
-     *
-     * @since v0.1.0
-     * @updated v0.6.2 — Added optional `opts` parameter for priority fees.
-     * @updated v0.10.0 — Added `batchRoot` argument and required
-     *   `settlementReceipt` PDA on-chain (anti-replay).
-     */
-    settleBatch(depositorWallet: PublicKey, settlements: Settlement[], batchRoot?: Uint8Array | number[] | null, splAccounts?: AccountMeta[], opts?: SettleOptions): Promise<TransactionSignature>;
-    /**
-     * @name fetch
-     * @description Fetch a deserialized `EscrowAccount`.
-     * @param agentPda - The agent account PDA.
-     * @param depositor - The depositor wallet. Defaults to the connected wallet.
-     * @returns {Promise<EscrowAccountData>} The escrow account data.
-     * @throws Will throw if the escrow account does not exist.
-     * @since v0.1.0
-     */
-    fetch(agentPda: PublicKey, depositor?: PublicKey): Promise<EscrowAccountData>;
-    /**
-     * @name fetchNullable
-     * @description Fetch a deserialized `EscrowAccount`, or `null` if it
-     *   does not exist on-chain.
-     * @param agentPda - The agent account PDA.
-     * @param depositor - The depositor wallet. Defaults to the connected wallet.
-     * @returns {Promise<EscrowAccountData | null>} The escrow data or `null`.
-     * @since v0.1.0
-     */
-    fetchNullable(agentPda: PublicKey, depositor?: PublicKey): Promise<EscrowAccountData | null>;
-    /**
-     * @name fetchByPda
-     * @description Fetch an escrow account by its PDA address directly,
-     *   bypassing PDA derivation.
-     * @param escrowPda - The escrow PDA public key.
-     * @returns {Promise<EscrowAccountData>} The escrow account data.
-     * @throws Will throw if the escrow account does not exist.
-     * @since v0.1.0
-     */
-    fetchByPda(escrowPda: PublicKey): Promise<EscrowAccountData>;
-}
-//# sourceMappingURL=escrow.d.ts.map

package/dist/types/modules/escrow.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"escrow.d.ts","sourceRoot":"","sources":["../../../src/modules/escrow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,oBAAoB,EACzB,KAAK,WAAW,EACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,EAAE,EAAE,MAAM,mBAAmB,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAQpC,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,UAAU,EACX,MAAM,UAAU,CAAC;AAMlB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAI3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,YAAa,SAAQ,UAAU;IAG1C;;;;;;;;OAQG;IACH,YAAY,CACV,QAAQ,EAAE,SAAS,EACnB,SAAS,CAAC,EAAE,SAAS,GACpB,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC;IAM/B;;;;;;;;;;;;;;OAcG;IACG,MAAM,CACV,WAAW,EAAE,SAAS,EACtB,IAAI,EAAE,gBAAgB,EACtB,WAAW,GAAE,WAAW,EAAO,GAC9B,OAAO,CAAC,oBAAoB,CAAC;IAkChC;;;;;;;;OAQG;IACG,OAAO,CACX,WAAW,EAAE,SAAS,EACtB,MAAM,EAAE,EAAE,GAAG,MAAM,GAAG,MAAM,EAC5B,WAAW,GAAE,WAAW,EAAO,GAC9B,OAAO,CAAC,oBAAoB,CAAC;IAehC;;;;;;;;;;;;OAYG;IACG,MAAM,CACV,eAAe,EAAE,SAAS,EAC1B,aAAa,EAAE,EAAE,GAAG,MAAM,GAAG,MAAM,EACnC,WAAW,EAAE,MAAM,EAAE,EACrB,WAAW,GAAE,WAAW,EAAO,EAC/B,IAAI,CAAC,EAAE,aAAa,GACnB,OAAO,CAAC,oBAAoB,CAAC;IA4BhC;;;;;;;;OAQG;IACG,QAAQ,CACZ,WAAW,EAAE,SAAS,EACtB,MAAM,EAAE,EAAE,GAAG,MAAM,GAAG,MAAM,EAC5B,WAAW,GAAE,WAAW,EAAO,GAC9B,OAAO,CAAC,oBAAoB,CAAC;IAehC;;;;;;OAMG;IACG,KAAK,CAAC,WAAW,EAAE,SAAS,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAalE;;;;;;;;;;;;;;;;;;;OAmBG;IACG,WAAW,CACf,eAAe,EAAE,SAAS,EAC1B,WAAW,EAAE,UAAU,EAAE,EACzB,SAAS,CAAC,EAAE,UAAU,GAAG,MAAM,EAAE,GAAG,IAAI,EACxC,WAAW,GAAE,WAAW,EAAO,EAC/B,IAAI,CAAC,EAAE,aAAa,GACnB,OAAO,CAAC,oBAAoB,CAAC;IAgDhC;;;;;;;;OAQG;IACG,KAAK,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAKnF;;;;;;;;OAQG;IACG,aAAa,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAKlG;;;;;;;;OAQG;IACG,UAAU,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAGnE"}

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

@@ -1,105 +0,0 @@
-/**
- * @module feedback
- * @description Trustless reputation system — give, update, revoke, and close
- *   on-chain feedback entries for agents.
- *
- * Feedback entries are PDA-based reviews tied to an agent and a reviewer wallet,
- * enabling permissionless, verifiable reputation on Solana.
- *
- * @category Modules
- * @since v0.1.0
- * @packageDocumentation
- */
-import { type PublicKey, type TransactionSignature } from "@solana/web3.js";
-import { BaseModule } from "./base";
-import type { FeedbackAccountData, GiveFeedbackArgs, UpdateFeedbackArgs } from "../types";
-/**
- * @name FeedbackModule
- * @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.
- *
- * @category Modules
- * @since v0.1.0
- * @extends BaseModule
- *
- * @example
- * ```ts
- * const sap = new SapClient(provider);
- * const sig = await sap.feedback.give(agentWallet, {
- *   score: 5,
- *   tag: { quality: {} },
- *   commentHash: null,
- * });
- * ```
- */
-export declare class FeedbackModule extends BaseModule {
-    /**
-     * @name deriveFeedback
-     * @description Derive the `FeedbackAccount` PDA for a given agent and reviewer.
-     * @param agentPda - The agent account PDA to review.
-     * @param reviewer - The reviewer wallet. Defaults to the connected wallet.
-     * @returns A tuple of `[PublicKey, bump]` for the feedback PDA.
-     * @see {@link deriveFeedback} from `pda/` module for the underlying derivation.
-     * @since v0.1.0
-     */
-    deriveFeedback(agentPda: PublicKey, reviewer?: PublicKey): readonly [PublicKey, number];
-    /**
-     * @name give
-     * @description Leave on-chain feedback for an agent. Creates a new
-     *   `FeedbackAccount` PDA owned by the reviewer.
-     * @param agentWallet - The wallet that owns the target agent.
-     * @param args - Feedback parameters (score, tag, optional comment hash).
-     * @returns {Promise<TransactionSignature>} The transaction signature.
-     * @since v0.1.0
-     */
-    give(agentWallet: PublicKey, args: GiveFeedbackArgs): Promise<TransactionSignature>;
-    /**
-     * @name update
-     * @description Update an existing feedback entry. Only the original reviewer
-     *   may update their feedback.
-     * @param agentWallet - The wallet that owns the target agent.
-     * @param args - Updated feedback parameters (new score, optional new tag, optional comment hash).
-     * @returns {Promise<TransactionSignature>} The transaction signature.
-     * @since v0.1.0
-     */
-    update(agentWallet: PublicKey, args: UpdateFeedbackArgs): Promise<TransactionSignature>;
-    /**
-     * @name revoke
-     * @description Revoke a feedback entry, marking it as revoked and excluding
-     *   it from reputation calculations.
-     * @param agentWallet - The wallet that owns the target agent.
-     * @returns {Promise<TransactionSignature>} The transaction signature.
-     * @since v0.1.0
-     */
-    revoke(agentWallet: PublicKey): Promise<TransactionSignature>;
-    /**
-     * @name close
-     * @description Close a revoked feedback PDA and reclaim rent to the reviewer.
-     * @param agentWallet - The wallet that owns the target agent.
-     * @returns {Promise<TransactionSignature>} The transaction signature.
-     * @since v0.1.0
-     */
-    close(agentWallet: PublicKey): Promise<TransactionSignature>;
-    /**
-     * @name fetch
-     * @description Fetch a deserialized `FeedbackAccount`.
-     * @param agentPda - The agent account PDA.
-     * @param reviewer - The reviewer wallet. Defaults to the connected wallet.
-     * @returns {Promise<FeedbackAccountData>} The feedback account data.
-     * @throws Will throw if the feedback account does not exist.
-     * @since v0.1.0
-     */
-    fetch(agentPda: PublicKey, reviewer?: PublicKey): Promise<FeedbackAccountData>;
-    /**
-     * @name fetchNullable
-     * @description Fetch a deserialized `FeedbackAccount`, or `null` if it
-     *   does not exist on-chain.
-     * @param agentPda - The agent account PDA.
-     * @param reviewer - The reviewer wallet. Defaults to the connected wallet.
-     * @returns {Promise<FeedbackAccountData | null>} The feedback data or `null`.
-     * @since v0.1.0
-     */
-    fetchNullable(agentPda: PublicKey, reviewer?: PublicKey): Promise<FeedbackAccountData | null>;
-}
-//# sourceMappingURL=feedback.d.ts.map

package/dist/types/modules/feedback.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"feedback.d.ts","sourceRoot":"","sources":["../../../src/modules/feedback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAiB,KAAK,SAAS,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC3F,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE1F;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,cAAe,SAAQ,UAAU;IAG5C;;;;;;;;OAQG;IACH,cAAc,CACZ,QAAQ,EAAE,SAAS,EACnB,QAAQ,CAAC,EAAE,SAAS,GACnB,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC;IAM/B;;;;;;;;OAQG;IACG,IAAI,CACR,WAAW,EAAE,SAAS,EACtB,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,oBAAoB,CAAC;IAiBhC;;;;;;;;OAQG;IACG,MAAM,CACV,WAAW,EAAE,SAAS,EACtB,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,oBAAoB,CAAC;IAchC;;;;;;;OAOG;IACG,MAAM,CAAC,WAAW,EAAE,SAAS,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAcnE;;;;;;OAMG;IACG,KAAK,CAAC,WAAW,EAAE,SAAS,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAelE;;;;;;;;OAQG;IACG,KAAK,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAKpF;;;;;;;;OAQG;IACG,aAAa,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;CAIpG"}

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

@@ -1,28 +0,0 @@
-/**
- * @module modules
- * @description Barrel export for all domain modules of the `@synapse-sap/sdk`.
- *
- * Re-exports every module class so consumers can import from a single entry point:
- * ```ts
- * import { AgentModule, VaultModule } from "@synapse-sap/sdk/modules";
- * ```
- *
- * @category Modules
- * @since v0.1.0
- * @packageDocumentation
- */
-export { AgentModule } from "./agent";
-export { FeedbackModule } from "./feedback";
-export { IndexingModule } from "./indexing";
-export { ToolsModule } from "./tools";
-export { VaultModule } from "./vault";
-export { EscrowModule } from "./escrow";
-export { EscrowV2Module } from "./escrow-v2";
-export { ReceiptModule } from "./receipt";
-export { StakingModule } from "./staking";
-export { SubscriptionModule } from "./subscription";
-export { AttestationModule } from "./attestation";
-export { LedgerModule } from "./ledger";
-export { BaseModule } from "./base";
-export type { SapProgram, SapTransactionResult } from "./base";
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,YAAY,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC"}

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

@@ -1,200 +0,0 @@
-/**
- * @module indexing
- * @description Scalable discovery layer — capability indexes, protocol indexes,
- * 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.
- *
- * @category Modules
- * @since v0.1.0
- * @packageDocumentation
- */
-import { type PublicKey, type TransactionSignature } from "@solana/web3.js";
-import { BaseModule } from "./base";
-import type { CapabilityIndexData, ProtocolIndexData, ToolCategoryIndexData } from "../types";
-/**
- * @name IndexingModule
- * @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.
- *
- * @category Modules
- * @since v0.1.0
- * @extends BaseModule
- *
- * @example
- * ```ts
- * const sap = new SapClient(provider);
- * // Create a capability index and add your agent
- * await sap.indexing.initCapabilityIndex("text-generation");
- * // Query agents by capability
- * const idx = await sap.indexing.fetchCapabilityIndex("text-generation");
- * ```
- */
-export declare class IndexingModule extends BaseModule {
-    /**
-     * @name hash
-     * @description Hash a capability or protocol ID string for use as a PDA seed.
-     *   Uses SHA-256 internally.
-     * @param id - The capability or protocol identifier string.
-     * @returns {Uint8Array} The 32-byte SHA-256 hash.
-     * @since v0.1.0
-     */
-    hash(id: string): Uint8Array;
-    /**
-     * @name initCapabilityIndex
-     * @description Create a new capability index and register the caller’s agent.
-     *   The capability ID is hashed to derive the PDA.
-     * @param capabilityId - Human-readable capability identifier (e.g. `"text-generation"`).
-     * @returns {Promise<TransactionSignature>} The transaction signature.
-     * @since v0.1.0
-     */
-    initCapabilityIndex(capabilityId: string): Promise<TransactionSignature>;
-    /**
-     * @name addToCapabilityIndex
-     * @description Add the caller’s agent to an existing capability index.
-     * @param capabilityId - The capability identifier string.
-     * @returns {Promise<TransactionSignature>} The transaction signature.
-     * @since v0.1.0
-     */
-    addToCapabilityIndex(capabilityId: string): Promise<TransactionSignature>;
-    /**
-     * @name removeFromCapabilityIndex
-     * @description Remove the caller’s agent from a capability index.
-     * @param capabilityId - The capability identifier string.
-     * @returns {Promise<TransactionSignature>} The transaction signature.
-     * @since v0.1.0
-     */
-    removeFromCapabilityIndex(capabilityId: string): Promise<TransactionSignature>;
-    /**
-     * @name closeCapabilityIndex
-     * @description Close an empty capability index PDA and reclaim rent.
-     * @param capabilityId - The capability identifier string.
-     * @returns {Promise<TransactionSignature>} The transaction signature.
-     * @since v0.1.0
-     */
-    closeCapabilityIndex(capabilityId: string): Promise<TransactionSignature>;
-    /**
-     * @name initProtocolIndex
-     * @description Create a new protocol index and register the caller’s agent.
-     *   The protocol ID is hashed to derive the PDA.
-     * @param protocolId - Human-readable protocol identifier (e.g. `"mcp-v1"`).
-     * @returns {Promise<TransactionSignature>} The transaction signature.
-     * @since v0.1.0
-     */
-    initProtocolIndex(protocolId: string): Promise<TransactionSignature>;
-    /**
-     * @name addToProtocolIndex
-     * @description Add the caller’s agent to an existing protocol index.
-     * @param protocolId - The protocol identifier string.
-     * @returns {Promise<TransactionSignature>} The transaction signature.
-     * @since v0.1.0
-     */
-    addToProtocolIndex(protocolId: string): Promise<TransactionSignature>;
-    /**
-     * @name removeFromProtocolIndex
-     * @description Remove the caller’s agent from a protocol index.
-     * @param protocolId - The protocol identifier string.
-     * @returns {Promise<TransactionSignature>} The transaction signature.
-     * @since v0.1.0
-     */
-    removeFromProtocolIndex(protocolId: string): Promise<TransactionSignature>;
-    /**
-     * @name closeProtocolIndex
-     * @description Close an empty protocol index PDA and reclaim rent.
-     * @param protocolId - The protocol identifier string.
-     * @returns {Promise<TransactionSignature>} The transaction signature.
-     * @since v0.1.0
-     */
-    closeProtocolIndex(protocolId: string): Promise<TransactionSignature>;
-    /**
-     * @name initToolCategoryIndex
-     * @description Create a new tool category index PDA.
-     * @param category - Numeric tool category enum value.
-     * @returns {Promise<TransactionSignature>} The transaction signature.
-     * @since v0.1.0
-     */
-    initToolCategoryIndex(category: number): Promise<TransactionSignature>;
-    /**
-     * @name addToToolCategory
-     * @description Add a tool to its matching category index.
-     * @param category - Numeric tool category enum value.
-     * @param toolPda - The tool descriptor PDA to add.
-     * @returns {Promise<TransactionSignature>} The transaction signature.
-     * @since v0.1.0
-     */
-    addToToolCategory(category: number, toolPda: PublicKey): Promise<TransactionSignature>;
-    /**
-     * @name removeFromToolCategory
-     * @description Remove a tool from a category index.
-     * @param category - Numeric tool category enum value.
-     * @param toolPda - The tool descriptor PDA to remove.
-     * @returns {Promise<TransactionSignature>} The transaction signature.
-     * @since v0.1.0
-     */
-    removeFromToolCategory(category: number, toolPda: PublicKey): Promise<TransactionSignature>;
-    /**
-     * @name closeToolCategoryIndex
-     * @description Close an empty tool category index PDA and reclaim rent.
-     * @param category - Numeric tool category enum value.
-     * @returns {Promise<TransactionSignature>} The transaction signature.
-     * @since v0.1.0
-     */
-    closeToolCategoryIndex(category: number): Promise<TransactionSignature>;
-    /**
-     * @name fetchCapabilityIndex
-     * @description Fetch a deserialized `CapabilityIndex` account by capability ID.
-     * @param capabilityId - The capability identifier string.
-     * @returns {Promise<CapabilityIndexData>} The capability index data.
-     * @throws Will throw if the capability index does not exist.
-     * @since v0.1.0
-     */
-    fetchCapabilityIndex(capabilityId: string): Promise<CapabilityIndexData>;
-    /**
-     * @name fetchCapabilityIndexNullable
-     * @description Fetch a deserialized `CapabilityIndex` account, or `null`
-     *   if it does not exist on-chain.
-     * @param capabilityId - The capability identifier string.
-     * @returns {Promise<CapabilityIndexData | null>} The capability index data or `null`.
-     * @since v0.1.0
-     */
-    fetchCapabilityIndexNullable(capabilityId: string): Promise<CapabilityIndexData | null>;
-    /**
-     * @name fetchProtocolIndex
-     * @description Fetch a deserialized `ProtocolIndex` account by protocol ID.
-     * @param protocolId - The protocol identifier string.
-     * @returns {Promise<ProtocolIndexData>} The protocol index data.
-     * @throws Will throw if the protocol index does not exist.
-     * @since v0.1.0
-     */
-    fetchProtocolIndex(protocolId: string): Promise<ProtocolIndexData>;
-    /**
-     * @name fetchProtocolIndexNullable
-     * @description Fetch a deserialized `ProtocolIndex` account, or `null`
-     *   if it does not exist on-chain.
-     * @param protocolId - The protocol identifier string.
-     * @returns {Promise<ProtocolIndexData | null>} The protocol index data or `null`.
-     * @since v0.1.0
-     */
-    fetchProtocolIndexNullable(protocolId: string): Promise<ProtocolIndexData | null>;
-    /**
-     * @name fetchToolCategoryIndex
-     * @description Fetch a deserialized `ToolCategoryIndex` account by category number.
-     * @param category - Numeric tool category enum value.
-     * @returns {Promise<ToolCategoryIndexData>} The tool category index data.
-     * @throws Will throw if the tool category index does not exist.
-     * @since v0.1.0
-     */
-    fetchToolCategoryIndex(category: number): Promise<ToolCategoryIndexData>;
-    /**
-     * @name fetchToolCategoryIndexNullable
-     * @description Fetch a deserialized `ToolCategoryIndex` account, or `null`
-     *   if it does not exist on-chain.
-     * @param category - Numeric tool category enum value.
-     * @returns {Promise<ToolCategoryIndexData | null>} The tool category index data or `null`.
-     * @since v0.1.0
-     */
-    fetchToolCategoryIndexNullable(category: number): Promise<ToolCategoryIndexData | null>;
-}
-//# sourceMappingURL=indexing.d.ts.map

package/dist/types/modules/indexing.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"indexing.d.ts","sourceRoot":"","sources":["../../../src/modules/indexing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAiB,KAAK,SAAS,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC3F,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAQpC,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACtB,MAAM,UAAU,CAAC;AAGlB;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,cAAe,SAAQ,UAAU;IAG5C;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU;IAM5B;;;;;;;OAOG;IACG,mBAAmB,CACvB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,oBAAoB,CAAC;IAkBhC;;;;;;OAMG;IACG,oBAAoB,CACxB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,oBAAoB,CAAC;IAehC;;;;;;OAMG;IACG,yBAAyB,CAC7B,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,oBAAoB,CAAC;IAehC;;;;;;OAMG;IACG,oBAAoB,CACxB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,oBAAoB,CAAC;IAiBhC;;;;;;;OAOG;IACG,iBAAiB,CACrB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,oBAAoB,CAAC;IAkBhC;;;;;;OAMG;IACG,kBAAkB,CACtB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,oBAAoB,CAAC;IAehC;;;;;;OAMG;IACG,uBAAuB,CAC3B,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,oBAAoB,CAAC;IAehC;;;;;;OAMG;IACG,kBAAkB,CACtB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,oBAAoB,CAAC;IAiBhC;;;;;;OAMG;IACG,qBAAqB,CACzB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,oBAAoB,CAAC;IAahC;;;;;;;OAOG;IACG,iBAAiB,CACrB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,SAAS,GACjB,OAAO,CAAC,oBAAoB,CAAC;IAehC;;;;;;;OAOG;IACG,sBAAsB,CAC1B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,SAAS,GACjB,OAAO,CAAC,oBAAoB,CAAC;IAehC;;;;;;OAMG;IACG,sBAAsB,CAC1B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,oBAAoB,CAAC;IAchC;;;;;;;OAOG;IACG,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAK9E;;;;;;;OAOG;IACG,4BAA4B,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAK7F;;;;;;;OAOG;IACG,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAKxE;;;;;;;OAOG;IACG,0BAA0B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAKvF;;;;;;;OAOG;IACG,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAK9E;;;;;;;OAOG;IACG,8BAA8B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;CAI9F"}

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

@@ -1,150 +0,0 @@
-/**
- * @module ledger
- * @description Unified on-chain memory — init, write, seal, and close ledger.
- *
- * The recommended memory system: fixed-cost PDA with 4 KB ring buffer,
- * automatic TX log persistence, and rolling merkle proof.
- * Write cost is TX fee only (~0.000005 SOL). ZERO additional rent.
- *
- * @category Modules
- * @since v0.1.0
- * @packageDocumentation
- */
-import { type PublicKey, type TransactionSignature } from "@solana/web3.js";
-import { BaseModule } from "./base";
-import type { MemoryLedgerData, LedgerPageData } from "../types";
-/**
- * @name LedgerModule
- * @description Manage on-chain memory ledgers for sessions.
- * Each session can have one MemoryLedger PDA with a 4KB ring buffer for recent entries.
- * When the ring buffer fills, it can be sealed into a permanent LedgerPage.
- * Ledgers are designed for high-frequency writes with minimal cost (~0.000005 SOL per write).
- * Sealed pages are immutable and stored on-chain (~0.031 SOL per page).
- */
-/**
- * @name LedgerModule
- * @description Manages the unified on-chain memory ledger for the Solana Agent
- *   Protocol. Provides methods to initialise a ledger with a 4 KB ring buffer,
- *   write data (TX fee only), seal pages permanently, close ledgers, and
- *   decode ring buffer contents.
- *
- * @category Modules
- * @since v0.1.0
- * @extends BaseModule
- *
- * @example
- * ```ts
- * const sap = new SapClient(provider);
- * // Init ledger, write data, seal
- * await sap.ledger.init(sessionPda);
- * await sap.ledger.write(sessionPda, data, contentHash);
- * await sap.ledger.seal(sessionPda);
- * ```
- */
-export declare class LedgerModule extends BaseModule {
-    /**
-     * @name deriveLedger
-     * @description Derive the `MemoryLedger` PDA for a given session.
-     * @param sessionPda - The session ledger PDA.
-     * @returns A tuple of `[PublicKey, bump]` for the ledger PDA.
-     * @see {@link deriveLedger} from `pda/` module for the underlying derivation.
-     * @since v0.1.0
-     */
-    deriveLedger(sessionPda: PublicKey): readonly [PublicKey, number];
-    /**
-     * @name deriveLedgerPage
-     * @description Derive a `LedgerPage` PDA for a given ledger and page index.
-     * @param ledgerPda - The memory ledger PDA.
-     * @param pageIndex - The zero-based page index.
-     * @returns A tuple of `[PublicKey, bump]` for the page PDA.
-     * @see {@link deriveLedgerPage} from `pda/` module for the underlying derivation.
-     * @since v0.1.0
-     */
-    deriveLedgerPage(ledgerPda: PublicKey, pageIndex: number): readonly [PublicKey, number];
-    /**
-     * @name init
-     * @description Create a `MemoryLedger` with a 4 KB ring buffer (~0.032 SOL rent).
-     * @param sessionPda - The session ledger PDA to attach the ledger to.
-     * @returns {Promise<TransactionSignature>} The transaction signature.
-     * @since v0.1.0
-     */
-    init(sessionPda: PublicKey): Promise<TransactionSignature>;
-    /**
-     * @name write
-     * @description Write data to the ledger (ring buffer + TX log simultaneously).
-     *   Cost: TX fee only (~0.000005 SOL). ZERO additional rent.
-     * @param sessionPda - The session ledger PDA.
-     * @param data - The data payload to write (Buffer or Uint8Array).
-     * @param contentHash - A 32-byte SHA-256 content hash for verification.
-     * @returns {Promise<TransactionSignature>} The transaction signature.
-     * @since v0.1.0
-     */
-    write(sessionPda: PublicKey, data: Buffer | Uint8Array, contentHash: number[]): Promise<TransactionSignature>;
-    /**
-     * @name seal
-     * @description Seal the ring buffer into a permanent `LedgerPage`.
-     *   Pages are WRITE-ONCE, NEVER-DELETE: ~0.031 SOL per page.
-     *   Automatically fetches the current page index from the ledger.
-     * @param sessionPda - The session ledger PDA.
-     * @returns {Promise<TransactionSignature>} The transaction signature.
-     * @since v0.1.0
-     */
-    seal(sessionPda: PublicKey): Promise<TransactionSignature>;
-    /**
-     * @name close
-     * @description Close a ledger PDA and reclaim ~0.032 SOL rent.
-     * @param sessionPda - The session ledger PDA.
-     * @returns {Promise<TransactionSignature>} The transaction signature.
-     * @since v0.1.0
-     */
-    close(sessionPda: PublicKey): Promise<TransactionSignature>;
-    /**
-     * @name fetchLedger
-     * @description Fetch a deserialized `MemoryLedger` account.
-     * @param sessionPda - The session ledger PDA.
-     * @returns {Promise<MemoryLedgerData>} The memory ledger data.
-     * @throws Will throw if the ledger does not exist.
-     * @since v0.1.0
-     */
-    fetchLedger(sessionPda: PublicKey): Promise<MemoryLedgerData>;
-    /**
-     * @name fetchLedgerNullable
-     * @description Fetch a deserialized `MemoryLedger` account, or `null`
-     *   if it does not exist on-chain.
-     * @param sessionPda - The session ledger PDA.
-     * @returns {Promise<MemoryLedgerData | null>} The ledger data or `null`.
-     * @since v0.1.0
-     */
-    fetchLedgerNullable(sessionPda: PublicKey): Promise<MemoryLedgerData | null>;
-    /**
-     * @name fetchPage
-     * @description Fetch a deserialized sealed `LedgerPage` account.
-     * @param ledgerPda - The memory ledger PDA.
-     * @param pageIndex - The zero-based page index.
-     * @returns {Promise<LedgerPageData>} The ledger page data.
-     * @throws Will throw if the page does not exist.
-     * @since v0.1.0
-     */
-    fetchPage(ledgerPda: PublicKey, pageIndex: number): Promise<LedgerPageData>;
-    /**
-     * @name fetchPageNullable
-     * @description Fetch a deserialized sealed `LedgerPage` account, or `null`
-     *   if it does not exist on-chain.
-     * @param ledgerPda - The memory ledger PDA.
-     * @param pageIndex - The zero-based page index.
-     * @returns {Promise<LedgerPageData | null>} The page data or `null`.
-     * @since v0.1.0
-     */
-    fetchPageNullable(ledgerPda: PublicKey, pageIndex: number): Promise<LedgerPageData | null>;
-    /**
-     * @name decodeRingBuffer
-     * @description Decode the ring buffer into individual entries.
-     *   Each entry is stored as `[u16 LE data_len][data bytes]`.
-     *   An entry with `data_len === 0` acts as the empty sentinel.
-     * @param ring - Raw ring buffer data (byte array or Uint8Array).
-     * @returns {Uint8Array[]} Array of decoded data entries.
-     * @since v0.1.0
-     */
-    decodeRingBuffer(ring: number[] | Uint8Array): Uint8Array[];
-}
-//# sourceMappingURL=ledger.d.ts.map