@oobe-protocol-labs/synapse-sap-sdk 0.6.3 → 0.8.0

package/src/index.ts

@@ -59,6 +59,11 @@ export type {
   DelegatePermissionBit,
   SchemaTypeValue,
   CompressionTypeValue,
+  SettlementSecurityKind,
+  DisputeOutcomeKind,
+  BillingIntervalKind,
+  DisputeTypeValue,
+  ResolutionLayerKind,
   // Helper structs
   Capability,
   VolumeCurveBreakpoint,
@@ -83,6 +88,15 @@ export type {
   AgentAttestationData,
   MemoryLedgerData,
   LedgerPageData,
+  // V2.1 account data
+  EscrowAccountV2Data,
+  PendingSettlementData,
+  DisputeRecordData,
+  ReceiptBatchData,
+  AgentStakeData,
+  SubscriptionData,
+  CounterShardData,
+  IndexPageData,
   // Instruction args
   RegisterAgentArgs,
   UpdateAgentArgs,
@@ -95,6 +109,9 @@ export type {
   CreateEscrowArgs,
   CreateAttestationArgs,
   InscribeToolSchemaArgs,
+  // V2.1 instruction args
+  CreateEscrowV2Args,
+  CreateSubscriptionArgs,
   // v0.6.0 — Endpoint & Manifest types
   EndpointDescriptor,
   HealthCheckDescriptor,
@@ -112,6 +129,11 @@ export {
   DelegatePermission,
   SchemaType,
   CompressionType,
+  SettlementSecurity,
+  DisputeOutcome,
+  BillingInterval,
+  DisputeType,
+  ResolutionLayer,
 } from "./types";
 
 // ── Constants ────────────────────────────────────────
@@ -151,9 +173,17 @@ export {
   deriveCheckpoint,
   deriveTool,
   deriveEscrow,
+  deriveEscrowV2,
+  derivePendingSettlement,
+  deriveDispute,
+  deriveStake,
+  deriveSubscription,
+  deriveShard,
+  deriveIndexPage,
   deriveAttestation,
   deriveLedger,
   deriveLedgerPage,
+  deriveReceiptBatch,
 } from "./pda";
 
 // ── Utilities ────────────────────────────────────────
@@ -216,6 +246,26 @@ export type {
   PriorityFeeConfig,
 } from "./utils";
 
+// v0.6.4 — Escrow validation, merchant middleware, x402 direct
+export {
+  validateEscrowState,
+  attachSplAccounts,
+  toAccountMetas,
+  MissingEscrowAtaError,
+  SapMerchantValidator,
+  parseX402Headers,
+  getX402DirectPayments,
+} from "./utils";
+export type {
+  SplAccountMeta,
+  EscrowValidationResult,
+  ParsedX402Headers,
+  MerchantValidationResult,
+  X402DirectPayment,
+  SettlementPayload,
+  GetX402DirectOptions,
+} from "./utils";
+
 // ── Errors ───────────────────────────────────────────
 export {
   SapError,
@@ -252,6 +302,10 @@ export {
   ToolsModule,
   VaultModule,
   EscrowModule,
+  EscrowV2Module,
+  ReceiptModule,
+  StakingModule,
+  SubscriptionModule,
   AttestationModule,
   LedgerModule,
   BaseModule,

package/src/modules/escrow-v2.ts

@@ -0,0 +1,375 @@
+/**
+ * @module escrow-v2
+ * @description V2 escrow settlement layer — supports settlement security
+ * modes (CoSigned, DisputeWindow), receipt-based dispute resolution,
+ * pending settlements, and automatic resolution via merkle proofs.
+ *
+ * @category Modules
+ * @since v0.7.0
+ * @packageDocumentation
+ */
+
+import {
+  SystemProgram,
+  type PublicKey,
+  type TransactionSignature,
+  type AccountMeta,
+} from "@solana/web3.js";
+import { BN } from "@coral-xyz/anchor";
+import { BaseModule } from "./base";
+import {
+  deriveAgent,
+  deriveAgentStats,
+  deriveEscrowV2,
+  derivePendingSettlement as derivePendingPda,
+  deriveDispute as deriveDisputePda,
+} from "../pda";
+import type {
+  EscrowAccountV2Data,
+  PendingSettlementData,
+  DisputeRecordData,
+  CreateEscrowV2Args,
+} from "../types";
+import {
+  buildPriorityFeeIxs,
+  buildRpcOptions,
+} from "../utils/priority-fee";
+import type { SettleOptions } from "../utils/priority-fee";
+
+/**
+ * @name EscrowV2Module
+ * @description Manages V2 escrow accounts with settlement security modes,
+ * dispute windows, and pending settlement flows.
+ *
+ * @category Modules
+ * @since v0.7.0
+ * @extends BaseModule
+ */
+export class EscrowV2Module extends BaseModule {
+  // ── Helpers ──────────────────────────────────────────
+
+  /** Convert BN | number | bigint → number for PDA seed functions. */
+  private toNum(v: BN | number | bigint): number {
+    return BN.isBN(v) ? v.toNumber() : Number(v);
+  }
+
+  // ── PDA helpers ──────────────────────────────────────
+
+  deriveEscrow(
+    agentPda: PublicKey,
+    depositor?: PublicKey,
+    nonce: BN | number | bigint = 0,
+  ): readonly [PublicKey, number] {
+    return deriveEscrowV2(agentPda, depositor ?? this.walletPubkey, this.toNum(nonce));
+  }
+
+  derivePendingSettlement(
+    escrowV2Pda: PublicKey,
+    settlementIndex: BN | number | bigint,
+  ): readonly [PublicKey, number] {
+    return derivePendingPda(escrowV2Pda, this.toNum(settlementIndex));
+  }
+
+  deriveDispute(
+    pendingSettlementPda: PublicKey,
+  ): readonly [PublicKey, number] {
+    return deriveDisputePda(pendingSettlementPda);
+  }
+
+  // ── Instructions ─────────────────────────────────────
+
+  async create(
+    agentWallet: PublicKey,
+    args: CreateEscrowV2Args,
+    splAccounts: AccountMeta[] = [],
+  ): Promise<TransactionSignature> {
+    const [agentPda] = deriveAgent(agentWallet);
+    const [escrowPda] = this.deriveEscrow(agentPda, undefined, args.escrowNonce);
+
+    return this.methods
+      .createEscrowV2(
+        this.bn(args.escrowNonce),
+        this.bn(args.pricePerCall),
+        this.bn(args.maxCalls),
+        this.bn(args.initialDeposit),
+        args.expiresAt,
+        args.volumeCurve,
+        args.tokenMint,
+        args.tokenDecimals,
+        args.settlementSecurity,
+        this.bn(args.disputeWindowSlots),
+        args.coSigner,
+        args.arbiter,
+      )
+      .accounts({
+        depositor: this.walletPubkey,
+        agent: agentPda,
+        escrow: escrowPda,
+        systemProgram: SystemProgram.programId,
+      })
+      .remainingAccounts(splAccounts)
+      .rpc();
+  }
+
+  async deposit(
+    agentWallet: PublicKey,
+    nonce: BN | number | bigint,
+    amount: BN | number | bigint,
+    splAccounts: AccountMeta[] = [],
+  ): Promise<TransactionSignature> {
+    const [agentPda] = deriveAgent(agentWallet);
+    const [escrowPda] = this.deriveEscrow(agentPda, undefined, nonce);
+
+    return this.methods
+      .depositEscrowV2(this.bn(nonce), this.bn(amount))
+      .accounts({
+        depositor: this.walletPubkey,
+        escrow: escrowPda,
+        systemProgram: SystemProgram.programId,
+      })
+      .remainingAccounts(splAccounts)
+      .rpc();
+  }
+
+  async settle(
+    depositorWallet: PublicKey,
+    nonce: BN | number | bigint,
+    callsToSettle: BN | number | bigint,
+    serviceHash: number[],
+    splAccounts: AccountMeta[] = [],
+    opts?: SettleOptions,
+  ): Promise<TransactionSignature> {
+    const [agentPda] = deriveAgent(this.walletPubkey);
+    const [escrowPda] = this.deriveEscrow(agentPda, depositorWallet, nonce);
+    const [statsPda] = deriveAgentStats(agentPda);
+
+    const preIxs = buildPriorityFeeIxs(opts);
+    const rpcOpts = buildRpcOptions(opts);
+
+    let builder = this.methods
+      .settleCallsV2(this.bn(nonce), this.bn(callsToSettle), serviceHash)
+      .accounts({
+        wallet: this.walletPubkey,
+        agent: agentPda,
+        agentStats: statsPda,
+        escrow: escrowPda,
+        systemProgram: SystemProgram.programId,
+      })
+      .remainingAccounts(splAccounts);
+
+    if (preIxs.length > 0) {
+      builder = builder.preInstructions(preIxs);
+    }
+
+    return builder.rpc(rpcOpts);
+  }
+
+  async createPendingSettlement(
+    agentWallet: PublicKey,
+    depositorWallet: PublicKey,
+    nonce: BN | number | bigint,
+    settlementIndex: BN | number | bigint,
+    callsToSettle: BN | number | bigint,
+    amount: BN | number | bigint,
+    serviceHash: number[],
+    receiptMerkleRoot: number[] = new Array(32).fill(0),
+  ): Promise<TransactionSignature> {
+    const [agentPda] = deriveAgent(agentWallet);
+    const [escrowPda] = this.deriveEscrow(agentPda, depositorWallet, nonce);
+    const [pendingPda] = this.derivePendingSettlement(escrowPda, settlementIndex);
+
+    return this.methods
+      .createPendingSettlement(
+        this.bn(settlementIndex),
+        this.bn(callsToSettle),
+        this.bn(amount),
+        serviceHash,
+        receiptMerkleRoot,
+      )
+      .accounts({
+        wallet: this.walletPubkey,
+        agent: agentPda,
+        escrow: escrowPda,
+        pendingSettlement: pendingPda,
+        systemProgram: SystemProgram.programId,
+      })
+      .rpc();
+  }
+
+  async finalizeSettlement(
+    agentWallet: PublicKey,
+    depositorWallet: PublicKey,
+    nonce: BN | number | bigint,
+    settlementIndex: BN | number | bigint,
+  ): Promise<TransactionSignature> {
+    const [agentPda] = deriveAgent(agentWallet);
+    const [escrowPda] = this.deriveEscrow(agentPda, depositorWallet, nonce);
+    const [pendingPda] = this.derivePendingSettlement(escrowPda, settlementIndex);
+    const [statsPda] = deriveAgentStats(agentPda);
+
+    return this.methods
+      .finalizeSettlement()
+      .accounts({
+        payer: this.walletPubkey,
+        agentWallet,
+        escrow: escrowPda,
+        pendingSettlement: pendingPda,
+        agentStats: statsPda,
+      })
+      .rpc();
+  }
+
+  async fileDispute(
+    agentWallet: PublicKey,
+    nonce: BN | number | bigint,
+    settlementIndex: BN | number | bigint,
+    evidenceHash: number[],
+    disputeType: number = 0,
+  ): Promise<TransactionSignature> {
+    const [agentPda] = deriveAgent(agentWallet);
+    const [escrowPda] = this.deriveEscrow(agentPda, undefined, nonce);
+    const [pendingPda] = this.derivePendingSettlement(escrowPda, settlementIndex);
+    const [disputePda] = this.deriveDispute(pendingPda);
+
+    return this.methods
+      .fileDispute(evidenceHash, disputeType)
+      .accounts({
+        depositor: this.walletPubkey,
+        escrow: escrowPda,
+        pendingSettlement: pendingPda,
+        dispute: disputePda,
+        systemProgram: SystemProgram.programId,
+      })
+      .rpc();
+  }
+
+  /**
+   * @deprecated Since v0.7.0 — Arbiter-based resolution removed.
+   * Use {@link ReceiptModule.submitReceiptProof} + {@link ReceiptModule.autoResolveDispute} instead.
+   */
+  async resolveDispute(
+    _depositorWallet: PublicKey,
+    _agentWallet: PublicKey,
+    _nonce: BN | number | bigint,
+    _settlementIndex: BN | number | bigint,
+    _outcome: number,
+  ): Promise<TransactionSignature> {
+    throw new Error("resolveDispute removed in v0.7.0 — use ReceiptModule.autoResolveDispute");
+  }
+
+  async closeDispute(
+    pendingSettlementPda: PublicKey,
+  ): Promise<TransactionSignature> {
+    const [disputePda] = this.deriveDispute(pendingSettlementPda);
+
+    return this.methods
+      .closeDispute()
+      .accounts({
+        depositor: this.walletPubkey,
+        dispute: disputePda,
+      })
+      .rpc();
+  }
+
+  async closePendingSettlement(
+    pendingSettlementPda: PublicKey,
+  ): Promise<TransactionSignature> {
+    return this.methods
+      .closePendingSettlement()
+      .accounts({
+        payer: this.walletPubkey,
+        pendingSettlement: pendingSettlementPda,
+      })
+      .rpc();
+  }
+
+  async withdraw(
+    agentWallet: PublicKey,
+    nonce: BN | number | bigint,
+    amount: BN | number | bigint,
+  ): Promise<TransactionSignature> {
+    const [agentPda] = deriveAgent(agentWallet);
+    const [escrowPda] = this.deriveEscrow(agentPda, undefined, nonce);
+
+    return this.methods
+      .withdrawEscrowV2(this.bn(amount))
+      .accounts({
+        depositor: this.walletPubkey,
+        escrow: escrowPda,
+      })
+      .rpc();
+  }
+
+  async close(
+    agentWallet: PublicKey,
+    nonce: BN | number | bigint = 0,
+  ): Promise<TransactionSignature> {
+    const [agentPda] = deriveAgent(agentWallet);
+    const [escrowPda] = this.deriveEscrow(agentPda, undefined, nonce);
+
+    return this.methods
+      .closeEscrowV2()
+      .accounts({
+        depositor: this.walletPubkey,
+        escrow: escrowPda,
+      })
+      .rpc();
+  }
+
+  /**
+   * @deprecated Since v0.7.0 — Migration instruction removed from program.
+   */
+  async migrateFromV1(
+    _agentWallet: PublicKey,
+  ): Promise<TransactionSignature> {
+    throw new Error("migrateFromV1 removed in v0.7.0 — migration instruction was deleted");
+  }
+
+  // ── Fetchers ─────────────────────────────────────────
+
+  async fetch(
+    agentPda: PublicKey,
+    depositor?: PublicKey,
+    nonce: BN | number | bigint = 0,
+  ): Promise<EscrowAccountV2Data> {
+    const [pda] = this.deriveEscrow(agentPda, depositor, nonce);
+    return this.fetchAccount<EscrowAccountV2Data>("escrowAccountV2", pda);
+  }
+
+  async fetchNullable(
+    agentPda: PublicKey,
+    depositor?: PublicKey,
+    nonce: BN | number | bigint = 0,
+  ): Promise<EscrowAccountV2Data | null> {
+    const [pda] = this.deriveEscrow(agentPda, depositor, nonce);
+    return this.fetchAccountNullable<EscrowAccountV2Data>("escrowAccountV2", pda);
+  }
+
+  async fetchByPda(escrowPda: PublicKey): Promise<EscrowAccountV2Data> {
+    return this.fetchAccount<EscrowAccountV2Data>("escrowAccountV2", escrowPda);
+  }
+
+  async fetchPendingSettlement(
+    pendingPda: PublicKey,
+  ): Promise<PendingSettlementData> {
+    return this.fetchAccount<PendingSettlementData>("pendingSettlement", pendingPda);
+  }
+
+  async fetchPendingSettlementNullable(
+    pendingPda: PublicKey,
+  ): Promise<PendingSettlementData | null> {
+    return this.fetchAccountNullable<PendingSettlementData>("pendingSettlement", pendingPda);
+  }
+
+  async fetchDispute(
+    disputePda: PublicKey,
+  ): Promise<DisputeRecordData> {
+    return this.fetchAccount<DisputeRecordData>("disputeRecord", disputePda);
+  }
+
+  async fetchDisputeNullable(
+    disputePda: PublicKey,
+  ): Promise<DisputeRecordData | null> {
+    return this.fetchAccountNullable<DisputeRecordData>("disputeRecord", disputePda);
+  }
+}

package/src/modules/escrow.ts

@@ -59,6 +59,10 @@ import type { SettleOptions } from "../utils/priority-fee";
  *   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 class EscrowModule extends BaseModule {
   // ── PDA helpers ──────────────────────────────────────

package/src/modules/index.ts

@@ -18,6 +18,10 @@ 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";

package/src/modules/receipt.ts

@@ -0,0 +1,207 @@
+/**
+ * @module receipt
+ * @description Receipt-based trustless dispute resolution (v0.7).
+ *
+ * Agents inscribe merkle roots of call receipt batches on-chain.
+ * During disputes, agents submit merkle inclusion proofs to prove delivery.
+ * After the proof deadline, anyone can trigger automatic proportional resolution.
+ *
+ * @category Modules
+ * @since v0.7.0
+ * @packageDocumentation
+ */
+
+import {
+  SystemProgram,
+  type PublicKey,
+  type TransactionSignature,
+} from "@solana/web3.js";
+import { BN } from "@coral-xyz/anchor";
+import { BaseModule } from "./base";
+import {
+  deriveAgent,
+  deriveAgentStats,
+  deriveEscrowV2,
+  derivePendingSettlement as derivePendingPda,
+  deriveDispute as deriveDisputePda,
+  deriveReceiptBatch as deriveReceiptPda,
+} from "../pda";
+import type { ReceiptBatchData } from "../types";
+
+/**
+ * @name ReceiptModule
+ * @description Manages receipt batch inscriptions, merkle proof submissions,
+ * and automatic dispute resolution for the v0.7 trustless settlement layer.
+ *
+ * @category Modules
+ * @since v0.7.0
+ * @extends BaseModule
+ */
+export class ReceiptModule extends BaseModule {
+  // ── Helpers ──────────────────────────────────────────
+
+  private toNum(v: BN | number | bigint): number {
+    return BN.isBN(v) ? v.toNumber() : Number(v);
+  }
+
+  // ── PDA helpers ──────────────────────────────────────
+
+  deriveReceiptBatch(
+    escrowV2Pda: PublicKey,
+    batchIndex: number,
+  ): readonly [PublicKey, number] {
+    return deriveReceiptPda(escrowV2Pda, batchIndex);
+  }
+
+  // ── Instructions ─────────────────────────────────────
+
+  /**
+   * Inscribe a receipt batch merkle root on-chain.
+   *
+   * Called by the **agent** to commit a cryptographic proof of calls delivered.
+   * The `merkleRoot` is the root of a merkle tree whose leaves are individual
+   * call receipt hashes.
+   *
+   * @param depositorWallet - The depositor's wallet (needed for escrow PDA derivation).
+   * @param nonce           - Escrow nonce.
+   * @param batchIndex      - Zero-based batch index (must equal escrow.receipt_batch_count).
+   * @param merkleRoot      - 32-byte merkle root of the receipt batch.
+   * @param callCount       - Number of calls in the batch.
+   * @param periodStart     - Unix timestamp for the start of the covered period.
+   * @param periodEnd       - Unix timestamp for the end of the covered period.
+   */
+  async inscribeReceiptBatch(
+    depositorWallet: PublicKey,
+    nonce: BN | number | bigint,
+    batchIndex: number,
+    merkleRoot: number[],
+    callCount: BN | number | bigint,
+    periodStart: BN | number | bigint,
+    periodEnd: BN | number | bigint,
+  ): Promise<TransactionSignature> {
+    const [agentPda] = deriveAgent(this.walletPubkey);
+    const [escrowPda] = deriveEscrowV2(agentPda, depositorWallet, this.toNum(nonce));
+    const [receiptPda] = this.deriveReceiptBatch(escrowPda, batchIndex);
+
+    return this.methods
+      .inscribeReceiptBatch(
+        batchIndex,
+        merkleRoot,
+        this.bn(callCount),
+        this.bn(periodStart),
+        this.bn(periodEnd),
+      )
+      .accounts({
+        wallet: this.walletPubkey,
+        agent: agentPda,
+        escrow: escrowPda,
+        receiptBatch: receiptPda,
+        systemProgram: SystemProgram.programId,
+      })
+      .rpc();
+  }
+
+  /**
+   * Submit a merkle inclusion proof during a dispute.
+   *
+   * Called by the **agent** to prove delivery of specific calls.
+   * Each proof verifies that a set of receipt hashes are included
+   * in the previously inscribed merkle root.
+   *
+   * @param depositorWallet - The depositor's wallet.
+   * @param nonce           - Escrow nonce.
+   * @param settlementIndex - Index of the disputed pending settlement.
+   * @param batchIndex      - Receipt batch index containing the proof.
+   * @param provenCount     - Number of calls proven in this proof submission.
+   * @param proof           - Array of 32-byte merkle proof hashes.
+   * @param leaf            - The 32-byte leaf hash being proven.
+   */
+  async submitReceiptProof(
+    depositorWallet: PublicKey,
+    nonce: BN | number | bigint,
+    settlementIndex: BN | number | bigint,
+    batchIndex: number,
+    provenCount: BN | number | bigint,
+    proof: number[][],
+    leaf: number[],
+  ): Promise<TransactionSignature> {
+    const [agentPda] = deriveAgent(this.walletPubkey);
+    const [escrowPda] = deriveEscrowV2(agentPda, depositorWallet, this.toNum(nonce));
+    const [pendingPda] = derivePendingPda(escrowPda, this.toNum(settlementIndex));
+    const [disputePda] = deriveDisputePda(pendingPda);
+    const [receiptPda] = this.deriveReceiptBatch(escrowPda, batchIndex);
+
+    return this.methods
+      .submitReceiptProof(
+        batchIndex,
+        this.bn(provenCount),
+        proof,
+        leaf,
+      )
+      .accounts({
+        wallet: this.walletPubkey,
+        agent: agentPda,
+        escrow: escrowPda,
+        pendingSettlement: pendingPda,
+        dispute: disputePda,
+        receiptBatch: receiptPda,
+      })
+      .rpc();
+  }
+
+  /**
+   * Trigger automatic dispute resolution after the proof deadline.
+   *
+   * Permissionless crank — anyone can call this once the deadline has passed.
+   * Resolution is proportional: if the agent proved N of M claimed calls,
+   * N/M of the settlement amount goes to the agent, the rest is refunded.
+   *
+   * @param agentWallet     - The agent's wallet.
+   * @param depositorWallet - The depositor's wallet.
+   * @param nonce           - Escrow nonce.
+   * @param settlementIndex - Index of the disputed pending settlement.
+   */
+  async autoResolveDispute(
+    agentWallet: PublicKey,
+    depositorWallet: PublicKey,
+    nonce: BN | number | bigint,
+    settlementIndex: BN | number | bigint,
+  ): Promise<TransactionSignature> {
+    const [agentPda] = deriveAgent(agentWallet);
+    const [escrowPda] = deriveEscrowV2(agentPda, depositorWallet, this.toNum(nonce));
+    const [pendingPda] = derivePendingPda(escrowPda, this.toNum(settlementIndex));
+    const [disputePda] = deriveDisputePda(pendingPda);
+    const [statsPda] = deriveAgentStats(agentPda);
+
+    return this.methods
+      .autoResolveDispute()
+      .accounts({
+        payer: this.walletPubkey,
+        depositor: depositorWallet,
+        agentWallet,
+        escrow: escrowPda,
+        pendingSettlement: pendingPda,
+        dispute: disputePda,
+        agentStats: statsPda,
+      })
+      .rpc();
+  }
+
+  // ── Fetchers ─────────────────────────────────────────
+
+  async fetchReceiptBatch(
+    escrowV2Pda: PublicKey,
+    batchIndex: number,
+  ): Promise<ReceiptBatchData> {
+    const [pda] = this.deriveReceiptBatch(escrowV2Pda, batchIndex);
+    return this.fetchAccount<ReceiptBatchData>("receiptBatch", pda);
+  }
+
+  async fetchReceiptBatchNullable(
+    escrowV2Pda: PublicKey,
+    batchIndex: number,
+  ): Promise<ReceiptBatchData | null> {
+    const [pda] = this.deriveReceiptBatch(escrowV2Pda, batchIndex);
+    return this.fetchAccountNullable<ReceiptBatchData>("receiptBatch", pda);
+  }
+}