@oobe-protocol-labs/synapse-sap-sdk 0.13.0 → 0.15.0

package/src/modules/indexing.ts

@@ -1,444 +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 { SystemProgram, type PublicKey, type TransactionSignature } from "@solana/web3.js";
-import { BaseModule } from "./base";
-import {
-  deriveAgent,
-  deriveCapabilityIndex,
-  deriveProtocolIndex,
-  deriveToolCategoryIndex,
-  deriveGlobalRegistry,
-} from "../pda";
-import type {
-  CapabilityIndexData,
-  ProtocolIndexData,
-  ToolCategoryIndexData,
-} from "../types";
-import { sha256, hashToArray } from "../utils";
-
-/**
- * @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 class IndexingModule extends BaseModule {
-  // ── Helpers ──────────────────────────────────────────
-
-  /**
-   * @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 {
-    return sha256(id);
-  }
-
-  // ── Capability Index ─────────────────────────────────
-
-  /**
-   * @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
-   */
-  async initCapabilityIndex(
-    capabilityId: string,
-  ): Promise<TransactionSignature> {
-    const capHash = this.hash(capabilityId);
-    const [agentPda] = deriveAgent(this.walletPubkey);
-    const [capIdxPda] = deriveCapabilityIndex(capHash);
-    const [globalPda] = deriveGlobalRegistry();
-
-    return this.methods
-      .initCapabilityIndex(capabilityId, hashToArray(capHash))
-      .accounts({
-        wallet: this.walletPubkey,
-        agent: agentPda,
-        capabilityIndex: capIdxPda,
-        globalRegistry: globalPda,
-        systemProgram: SystemProgram.programId,
-      })
-      .rpc();
-  }
-
-  /**
-   * @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
-   */
-  async addToCapabilityIndex(
-    capabilityId: string,
-  ): Promise<TransactionSignature> {
-    const capHash = this.hash(capabilityId);
-    const [agentPda] = deriveAgent(this.walletPubkey);
-    const [capIdxPda] = deriveCapabilityIndex(capHash);
-
-    return this.methods
-      .addToCapabilityIndex(hashToArray(capHash))
-      .accounts({
-        wallet: this.walletPubkey,
-        agent: agentPda,
-        capabilityIndex: capIdxPda,
-      })
-      .rpc();
-  }
-
-  /**
-   * @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
-   */
-  async removeFromCapabilityIndex(
-    capabilityId: string,
-  ): Promise<TransactionSignature> {
-    const capHash = this.hash(capabilityId);
-    const [agentPda] = deriveAgent(this.walletPubkey);
-    const [capIdxPda] = deriveCapabilityIndex(capHash);
-
-    return this.methods
-      .removeFromCapabilityIndex(hashToArray(capHash))
-      .accounts({
-        wallet: this.walletPubkey,
-        agent: agentPda,
-        capabilityIndex: capIdxPda,
-      })
-      .rpc();
-  }
-
-  /**
-   * @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
-   */
-  async closeCapabilityIndex(
-    capabilityId: string,
-  ): Promise<TransactionSignature> {
-    const capHash = this.hash(capabilityId);
-    const [capIdxPda] = deriveCapabilityIndex(capHash);
-    const [globalPda] = deriveGlobalRegistry();
-
-    return this.methods
-      .closeCapabilityIndex(hashToArray(capHash))
-      .accounts({
-        wallet: this.walletPubkey,
-        capabilityIndex: capIdxPda,
-        globalRegistry: globalPda,
-      })
-      .rpc();
-  }
-
-  // ── Protocol Index ───────────────────────────────────
-
-  /**
-   * @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
-   */
-  async initProtocolIndex(
-    protocolId: string,
-  ): Promise<TransactionSignature> {
-    const protoHash = this.hash(protocolId);
-    const [agentPda] = deriveAgent(this.walletPubkey);
-    const [protoIdxPda] = deriveProtocolIndex(protoHash);
-    const [globalPda] = deriveGlobalRegistry();
-
-    return this.methods
-      .initProtocolIndex(protocolId, hashToArray(protoHash))
-      .accounts({
-        wallet: this.walletPubkey,
-        agent: agentPda,
-        protocolIndex: protoIdxPda,
-        globalRegistry: globalPda,
-        systemProgram: SystemProgram.programId,
-      })
-      .rpc();
-  }
-
-  /**
-   * @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
-   */
-  async addToProtocolIndex(
-    protocolId: string,
-  ): Promise<TransactionSignature> {
-    const protoHash = this.hash(protocolId);
-    const [agentPda] = deriveAgent(this.walletPubkey);
-    const [protoIdxPda] = deriveProtocolIndex(protoHash);
-
-    return this.methods
-      .addToProtocolIndex(hashToArray(protoHash))
-      .accounts({
-        wallet: this.walletPubkey,
-        agent: agentPda,
-        protocolIndex: protoIdxPda,
-      })
-      .rpc();
-  }
-
-  /**
-   * @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
-   */
-  async removeFromProtocolIndex(
-    protocolId: string,
-  ): Promise<TransactionSignature> {
-    const protoHash = this.hash(protocolId);
-    const [agentPda] = deriveAgent(this.walletPubkey);
-    const [protoIdxPda] = deriveProtocolIndex(protoHash);
-
-    return this.methods
-      .removeFromProtocolIndex(hashToArray(protoHash))
-      .accounts({
-        wallet: this.walletPubkey,
-        agent: agentPda,
-        protocolIndex: protoIdxPda,
-      })
-      .rpc();
-  }
-
-  /**
-   * @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
-   */
-  async closeProtocolIndex(
-    protocolId: string,
-  ): Promise<TransactionSignature> {
-    const protoHash = this.hash(protocolId);
-    const [protoIdxPda] = deriveProtocolIndex(protoHash);
-    const [globalPda] = deriveGlobalRegistry();
-
-    return this.methods
-      .closeProtocolIndex(hashToArray(protoHash))
-      .accounts({
-        wallet: this.walletPubkey,
-        protocolIndex: protoIdxPda,
-        globalRegistry: globalPda,
-      })
-      .rpc();
-  }
-
-  // ── Tool Category Index ──────────────────────────────
-
-  /**
-   * @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
-   */
-  async initToolCategoryIndex(
-    category: number,
-  ): Promise<TransactionSignature> {
-    const [catIdxPda] = deriveToolCategoryIndex(category);
-
-    return this.methods
-      .initToolCategoryIndex(category)
-      .accounts({
-        wallet: this.walletPubkey,
-        toolCategoryIndex: catIdxPda,
-        systemProgram: SystemProgram.programId,
-      })
-      .rpc();
-  }
-
-  /**
-   * @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
-   */
-  async addToToolCategory(
-    category: number,
-    toolPda: PublicKey,
-  ): Promise<TransactionSignature> {
-    const [agentPda] = deriveAgent(this.walletPubkey);
-    const [catIdxPda] = deriveToolCategoryIndex(category);
-
-    return this.methods
-      .addToToolCategory(category)
-      .accounts({
-        wallet: this.walletPubkey,
-        agent: agentPda,
-        tool: toolPda,
-        toolCategoryIndex: catIdxPda,
-      })
-      .rpc();
-  }
-
-  /**
-   * @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
-   */
-  async removeFromToolCategory(
-    category: number,
-    toolPda: PublicKey,
-  ): Promise<TransactionSignature> {
-    const [agentPda] = deriveAgent(this.walletPubkey);
-    const [catIdxPda] = deriveToolCategoryIndex(category);
-
-    return this.methods
-      .removeFromToolCategory(category)
-      .accounts({
-        wallet: this.walletPubkey,
-        agent: agentPda,
-        tool: toolPda,
-        toolCategoryIndex: catIdxPda,
-      })
-      .rpc();
-  }
-
-  /**
-   * @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
-   */
-  async closeToolCategoryIndex(
-    category: number,
-  ): Promise<TransactionSignature> {
-    const [catIdxPda] = deriveToolCategoryIndex(category);
-
-    return this.methods
-      .closeToolCategoryIndex(category)
-      .accounts({
-        wallet: this.walletPubkey,
-        toolCategoryIndex: catIdxPda,
-      })
-      .rpc();
-  }
-
-  // ── Fetchers ─────────────────────────────────────────
-
-  /**
-   * @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
-   */
-  async fetchCapabilityIndex(capabilityId: string): Promise<CapabilityIndexData> {
-    const [pda] = deriveCapabilityIndex(this.hash(capabilityId));
-    return this.fetchAccount<CapabilityIndexData>("capabilityIndex", pda);
-  }
-
-  /**
-   * @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
-   */
-  async fetchCapabilityIndexNullable(capabilityId: string): Promise<CapabilityIndexData | null> {
-    const [pda] = deriveCapabilityIndex(this.hash(capabilityId));
-    return this.fetchAccountNullable<CapabilityIndexData>("capabilityIndex", pda);
-  }
-
-  /**
-   * @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
-   */
-  async fetchProtocolIndex(protocolId: string): Promise<ProtocolIndexData> {
-    const [pda] = deriveProtocolIndex(this.hash(protocolId));
-    return this.fetchAccount<ProtocolIndexData>("protocolIndex", pda);
-  }
-
-  /**
-   * @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
-   */
-  async fetchProtocolIndexNullable(protocolId: string): Promise<ProtocolIndexData | null> {
-    const [pda] = deriveProtocolIndex(this.hash(protocolId));
-    return this.fetchAccountNullable<ProtocolIndexData>("protocolIndex", pda);
-  }
-
-  /**
-   * @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
-   */
-  async fetchToolCategoryIndex(category: number): Promise<ToolCategoryIndexData> {
-    const [pda] = deriveToolCategoryIndex(category);
-    return this.fetchAccount<ToolCategoryIndexData>("toolCategoryIndex", pda);
-  }
-
-  /**
-   * @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
-   */
-  async fetchToolCategoryIndexNullable(category: number): Promise<ToolCategoryIndexData | null> {
-    const [pda] = deriveToolCategoryIndex(category);
-    return this.fetchAccountNullable<ToolCategoryIndexData>("toolCategoryIndex", pda);
-  }
-}

package/src/modules/ledger.ts

@@ -1,262 +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 { SystemProgram, type PublicKey, type TransactionSignature } from "@solana/web3.js";
-import { BaseModule } from "./base";
-import { deriveLedger, deriveLedgerPage } from "../pda";
-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 class LedgerModule extends BaseModule {
-  // ── PDA helpers ──────────────────────────────────────
-
-  /**
-   * @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] {
-    return deriveLedger(sessionPda);
-  }
-
-  /**
-   * @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] {
-    return deriveLedgerPage(ledgerPda, pageIndex);
-  }
-
-  // ── Instructions ─────────────────────────────────────
-
-  /**
-   * @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
-   */
-  async init(sessionPda: PublicKey): Promise<TransactionSignature> {
-    const [ledgerPda] = deriveLedger(sessionPda);
-
-    return this.methods
-      .initLedger()
-      .accounts({
-        wallet: this.walletPubkey,
-        session: sessionPda,
-        ledger: ledgerPda,
-        systemProgram: SystemProgram.programId,
-      })
-      .rpc();
-  }
-
-  /**
-   * @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
-   */
-  async write(
-    sessionPda: PublicKey,
-    data: Buffer | Uint8Array,
-    contentHash: number[],
-  ): Promise<TransactionSignature> {
-    const [ledgerPda] = deriveLedger(sessionPda);
-
-    return this.methods
-      .writeLedger(Buffer.from(data), contentHash)
-      .accounts({
-        wallet: this.walletPubkey,
-        session: sessionPda,
-        ledger: ledgerPda,
-      })
-      .rpc();
-  }
-
-  /**
-   * @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
-   */
-  async seal(sessionPda: PublicKey): Promise<TransactionSignature> {
-    const [ledgerPda] = deriveLedger(sessionPda);
-    // Fetch ledger to get current page index
-    const ledger = await this.fetchLedger(sessionPda);
-    const [pagePda] = deriveLedgerPage(ledgerPda, ledger.numPages);
-
-    return this.methods
-      .sealLedger()
-      .accounts({
-        wallet: this.walletPubkey,
-        session: sessionPda,
-        ledger: ledgerPda,
-        page: pagePda,
-        systemProgram: SystemProgram.programId,
-      })
-      .rpc();
-  }
-
-  /**
-   * @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
-   */
-  async close(sessionPda: PublicKey): Promise<TransactionSignature> {
-    const [ledgerPda] = deriveLedger(sessionPda);
-
-    return this.methods
-      .closeLedger()
-      .accounts({
-        wallet: this.walletPubkey,
-        session: sessionPda,
-        ledger: ledgerPda,
-      })
-      .rpc();
-  }
-
-  // ── Fetchers ─────────────────────────────────────────
-
-  /**
-   * @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
-   */
-  async fetchLedger(sessionPda: PublicKey): Promise<MemoryLedgerData> {
-    const [pda] = deriveLedger(sessionPda);
-    return this.fetchAccount<MemoryLedgerData>("memoryLedger", pda);
-  }
-
-  /**
-   * @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
-   */
-  async fetchLedgerNullable(sessionPda: PublicKey): Promise<MemoryLedgerData | null> {
-    const [pda] = deriveLedger(sessionPda);
-    return this.fetchAccountNullable<MemoryLedgerData>("memoryLedger", pda);
-  }
-
-  /**
-   * @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
-   */
-  async fetchPage(
-    ledgerPda: PublicKey,
-    pageIndex: number,
-  ): Promise<LedgerPageData> {
-    const [pda] = deriveLedgerPage(ledgerPda, pageIndex);
-    return this.fetchAccount<LedgerPageData>("ledgerPage", pda);
-  }
-
-  /**
-   * @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
-   */
-  async fetchPageNullable(
-    ledgerPda: PublicKey,
-    pageIndex: number,
-  ): Promise<LedgerPageData | null> {
-    const [pda] = deriveLedgerPage(ledgerPda, pageIndex);
-    return this.fetchAccountNullable<LedgerPageData>("ledgerPage", pda);
-  }
-
-  /**
-   * @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[] {
-    const buf = Buffer.from(ring);
-    const entries: Uint8Array[] = [];
-    let offset = 0;
-
-    while (offset + 2 <= buf.length) {
-      const len = buf.readUInt16LE(offset);
-      if (len === 0) break; // empty sentinel
-      offset += 2;
-      if (offset + len > buf.length) break;
-      entries.push(new Uint8Array(buf.subarray(offset, offset + len)));
-      offset += len;
-    }
-
-    return entries;
-  }
-}