@oobe-protocol-labs/synapse-sap-sdk 0.6.2 → 0.7.0

package/dist/cjs/pda/index.js

@@ -20,7 +20,7 @@
  * ```
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.deriveMemoryChunk = exports.deriveMemoryEntry = exports.derivePlugin = exports.deriveDigest = exports.deriveBuffer = exports.deriveLedgerPage = exports.deriveLedger = exports.deriveAttestation = exports.deriveEscrow = exports.deriveTool = exports.deriveCheckpoint = exports.deriveVaultDelegate = exports.deriveEpochPage = exports.deriveSession = exports.deriveVault = exports.deriveToolCategoryIndex = exports.deriveProtocolIndex = exports.deriveCapabilityIndex = exports.deriveFeedback = exports.deriveAgentStats = exports.deriveAgent = exports.deriveGlobalRegistry = void 0;
+exports.deriveIndexPage = exports.deriveShard = exports.deriveSubscription = exports.deriveStake = exports.deriveDispute = exports.derivePendingSettlement = exports.deriveEscrowV2 = exports.deriveMemoryChunk = exports.deriveMemoryEntry = exports.derivePlugin = exports.deriveDigest = exports.deriveBuffer = exports.deriveLedgerPage = exports.deriveLedger = exports.deriveAttestation = exports.deriveEscrow = exports.deriveTool = exports.deriveCheckpoint = exports.deriveVaultDelegate = exports.deriveEpochPage = exports.deriveSession = exports.deriveVault = exports.deriveToolCategoryIndex = exports.deriveProtocolIndex = exports.deriveCapabilityIndex = exports.deriveFeedback = exports.deriveAgentStats = exports.deriveAgent = exports.deriveGlobalRegistry = void 0;
 const web3_js_1 = require("@solana/web3.js");
 const constants_1 = require("../constants");
 // ── Helpers ──────────────────────────────────────────────────────
@@ -62,6 +62,21 @@ const u32le = (n) => {
     buf.writeUInt32LE(n, 0);
     return buf;
 };
+/**
+ * Encode an unsigned 64-bit integer as a little-endian `Buffer`.
+ *
+ * @name u64le
+ * @description Produces an 8-byte LE buffer for u64 PDA seed segments (e.g., escrow nonce, sub_id).
+ * @param n - The number or bigint to encode.
+ * @returns {Buffer} 8-byte little-endian buffer.
+ * @category PDA
+ * @since v0.5.0
+ */
+const u64le = (n) => {
+    const buf = Buffer.alloc(8);
+    buf.writeBigUInt64LE(BigInt(n), 0);
+    return buf;
+};
 // ═════════════════════════════════════════════
 //  Core PDAs
 // ═════════════════════════════════════════════
@@ -314,6 +329,7 @@ exports.deriveTool = deriveTool;
  * @returns {PdaResult} `[pda, bump]` tuple.
  * @category PDA
  * @since v0.1.0
+ * @deprecated Since v0.7.0 — Use {@link deriveEscrowV2} for V2 escrows with nonce support.
  * @see EscrowAccount
  */
 const deriveEscrow = (agentPda, depositor, programId = constants_1.SAP_PROGRAM_ID) => findPda([toSeedBuf(constants_1.SEEDS.ESCROW), agentPda.toBuffer(), depositor.toBuffer()], programId);
@@ -474,4 +490,130 @@ const deriveMemoryChunk = (memoryEntryPda, chunkIndex, programId = constants_1.S
     Buffer.from([chunkIndex]),
 ], programId);
 exports.deriveMemoryChunk = deriveMemoryChunk;
+// ═════════════════════════════════════════════
+//  Escrow V2
+// ═════════════════════════════════════════════
+/**
+ * Derive the **EscrowAccountV2** PDA.
+ *
+ * Seeds: `["sap_escrow_v2", agent_pda, depositor_wallet, nonce_u64_le]`
+ *
+ * @name deriveEscrowV2
+ * @description Computes the V2 escrow PDA supporting nonce-based multi-escrow.
+ * @param agentPda  - The agent's PDA.
+ * @param depositor - The depositor's wallet.
+ * @param nonce     - Escrow nonce (u64) allowing multiple escrows per pair.
+ * @param programId - Override program ID.
+ * @returns {PdaResult} `[pda, bump]` tuple.
+ * @category PDA
+ * @since v0.5.0
+ */
+const deriveEscrowV2 = (agentPda, depositor, nonce = 0, programId = constants_1.SAP_PROGRAM_ID) => findPda([
+    toSeedBuf(constants_1.SEEDS.ESCROW_V2),
+    agentPda.toBuffer(),
+    depositor.toBuffer(),
+    u64le(nonce),
+], programId);
+exports.deriveEscrowV2 = deriveEscrowV2;
+/**
+ * Derive the **PendingSettlement** PDA.
+ *
+ * Seeds: `["sap_pending", escrow_v2_pda, settlement_index_u64_le]`
+ *
+ * @name derivePendingSettlement
+ * @param escrowV2Pda     - The parent V2 escrow PDA.
+ * @param settlementIndex - The monotonic settlement index (u64).
+ * @param programId       - Override program ID.
+ * @returns {PdaResult} `[pda, bump]` tuple.
+ * @category PDA
+ * @since v0.5.0
+ */
+const derivePendingSettlement = (escrowV2Pda, settlementIndex, programId = constants_1.SAP_PROGRAM_ID) => findPda([
+    toSeedBuf(constants_1.SEEDS.PENDING),
+    escrowV2Pda.toBuffer(),
+    u64le(settlementIndex),
+], programId);
+exports.derivePendingSettlement = derivePendingSettlement;
+/**
+ * Derive the **DisputeRecord** PDA.
+ *
+ * Seeds: `["sap_dispute", pending_settlement_pda]`
+ *
+ * @name deriveDispute
+ * @param pendingSettlementPda - The parent pending settlement PDA.
+ * @param programId            - Override program ID.
+ * @returns {PdaResult} `[pda, bump]` tuple.
+ * @category PDA
+ * @since v0.5.0
+ */
+const deriveDispute = (pendingSettlementPda, programId = constants_1.SAP_PROGRAM_ID) => findPda([toSeedBuf(constants_1.SEEDS.DISPUTE), pendingSettlementPda.toBuffer()], programId);
+exports.deriveDispute = deriveDispute;
+/**
+ * Derive the **AgentStake** PDA.
+ *
+ * Seeds: `["sap_stake", agent_pda]`
+ *
+ * @name deriveStake
+ * @param agentPda  - The agent's PDA.
+ * @param programId - Override program ID.
+ * @returns {PdaResult} `[pda, bump]` tuple.
+ * @category PDA
+ * @since v0.5.0
+ */
+const deriveStake = (agentPda, programId = constants_1.SAP_PROGRAM_ID) => findPda([toSeedBuf(constants_1.SEEDS.STAKE), agentPda.toBuffer()], programId);
+exports.deriveStake = deriveStake;
+/**
+ * Derive the **Subscription** PDA.
+ *
+ * Seeds: `["sap_sub", agent_pda, subscriber_wallet, sub_id_u64_le]`
+ *
+ * @name deriveSubscription
+ * @param agentPda   - The agent's PDA.
+ * @param subscriber - The subscriber's wallet.
+ * @param subId      - Subscription ID (u64).
+ * @param programId  - Override program ID.
+ * @returns {PdaResult} `[pda, bump]` tuple.
+ * @category PDA
+ * @since v0.5.0
+ */
+const deriveSubscription = (agentPda, subscriber, subId = 0, programId = constants_1.SAP_PROGRAM_ID) => findPda([
+    toSeedBuf(constants_1.SEEDS.SUBSCRIPTION),
+    agentPda.toBuffer(),
+    subscriber.toBuffer(),
+    u64le(subId),
+], programId);
+exports.deriveSubscription = deriveSubscription;
+/**
+ * Derive the **CounterShard** PDA.
+ *
+ * Seeds: `["sap_shard", shard_index_u8]`
+ *
+ * @name deriveShard
+ * @param shardIndex - The shard index (0–7).
+ * @param programId  - Override program ID.
+ * @returns {PdaResult} `[pda, bump]` tuple.
+ * @category PDA
+ * @since v0.5.0
+ */
+const deriveShard = (shardIndex, programId = constants_1.SAP_PROGRAM_ID) => findPda([toSeedBuf(constants_1.SEEDS.SHARD), Buffer.from([shardIndex])], programId);
+exports.deriveShard = deriveShard;
+/**
+ * Derive the **IndexPage** PDA.
+ *
+ * Seeds: `["sap_idx_page", parent_index_pda, page_index_u8]`
+ *
+ * @name deriveIndexPage
+ * @param parentIndexPda - The parent index PDA (CapabilityIndex, ProtocolIndex, etc.).
+ * @param pageIndex      - The page index (0–255).
+ * @param programId      - Override program ID.
+ * @returns {PdaResult} `[pda, bump]` tuple.
+ * @category PDA
+ * @since v0.5.0
+ */
+const deriveIndexPage = (parentIndexPda, pageIndex, programId = constants_1.SAP_PROGRAM_ID) => findPda([
+    toSeedBuf(constants_1.SEEDS.INDEX_PAGE),
+    parentIndexPda.toBuffer(),
+    Buffer.from([pageIndex]),
+], programId);
+exports.deriveIndexPage = deriveIndexPage;
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/pda/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/pda/index.ts"],"names":[],"mappings":"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"}

package/dist/cjs/postgres/sync.js

@@ -36,6 +36,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SapSyncEngine = void 0;
 const events_1 = require("../events");
+const geyser_1 = require("../events/geyser");
 // ═══════════════════════════════════════════════════════════════════
 //  Sync Engine
 // ═══════════════════════════════════════════════════════════════════
@@ -63,6 +64,7 @@ class SapSyncEngine {
     debug;
     intervalId = null;
     logSubId = null;
+    geyserStream = null;
     running = false;
     constructor(pg, client, debug = false) {
         this.pg = pg;
@@ -178,7 +180,7 @@ class SapSyncEngine {
     }
     /**
      * @name stopEventStream
-     * @description Unsubscribe from the program log stream.
+     * @description Unsubscribe from the program log stream (WebSocket or Geyser).
      * @since v0.1.0
      */
     async stopEventStream() {
@@ -186,8 +188,74 @@ class SapSyncEngine {
             const connection = this.client.program.provider.connection;
             await connection.removeOnLogsListener(this.logSubId);
             this.logSubId = null;
-            this.log("Event stream stopped");
+            this.log("WebSocket event stream stopped");
         }
+        if (this.geyserStream) {
+            await this.geyserStream.disconnect();
+            this.geyserStream = null;
+            this.log("Geyser event stream stopped");
+        }
+    }
+    // ═════════════════════════════════════════════
+    //  Geyser gRPC Event Stream
+    // ═════════════════════════════════════════════
+    /**
+     * @name startGeyserStream
+     * @description Subscribe to SAP program transactions via Yellowstone gRPC
+     * and insert parsed events into the `sap_events` table in real-time.
+     *
+     * Drop-in replacement for {@link startEventStream} with lower latency,
+     * no missed events, and automatic reconnection.
+     *
+     * Requires `@triton-one/yellowstone-grpc` to be installed.
+     *
+     * @param geyserConfig - Yellowstone gRPC connection config.
+     * @since v0.6.3
+     *
+     * @example
+     * ```ts
+     * await sync.startGeyserStream({
+     *   endpoint: "https://grpc.triton.one",
+     *   token:    process.env.GEYSER_TOKEN!,
+     * });
+     * ```
+     */
+    async startGeyserStream(geyserConfig) {
+        if (this.geyserStream) {
+            this.log("Geyser stream already running");
+            return;
+        }
+        const eventParser = new events_1.EventParser(this.client.program);
+        const stream = new geyser_1.GeyserEventStream(geyserConfig);
+        stream.on("logs", async (logs, signature, slot) => {
+            try {
+                const events = eventParser.parseLogs(logs);
+                for (const event of events) {
+                    const data = event.data;
+                    const agentPda = data.agent ?? data.agentPda ?? undefined;
+                    const wallet = data.wallet ?? data.owner ?? undefined;
+                    await this.pg.syncEvent(event.name, signature, slot, data, agentPda, wallet);
+                }
+            }
+            catch (err) {
+                this.log(`Geyser event parse error: ${err}`);
+            }
+        });
+        stream.on("connected", () => {
+            this.log("Geyser gRPC connected");
+        });
+        stream.on("disconnected", (reason) => {
+            this.log(`Geyser gRPC disconnected: ${reason}`);
+        });
+        stream.on("error", (err) => {
+            this.log(`Geyser error: ${err.message}`);
+        });
+        stream.on("reconnecting", (attempt) => {
+            this.log(`Geyser reconnecting (attempt ${attempt})...`);
+        });
+        await stream.connect();
+        this.geyserStream = stream;
+        this.log("Geyser event stream started");
     }
     // ═════════════════════════════════════════════
     //  Status
@@ -202,11 +270,11 @@ class SapSyncEngine {
     }
     /**
      * @name isStreaming
-     * @description Check whether the event stream is active.
+     * @description Check whether the event stream is active (WebSocket or Geyser).
      * @since v0.1.0
      */
     isStreaming() {
-        return this.logSubId !== null;
+        return this.logSubId !== null || this.geyserStream?.connected === true;
     }
     // ═════════════════════════════════════════════
     //  Internal

package/dist/cjs/postgres/sync.js.map

@@ -1 +1 @@
-{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../../src/postgres/sync.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../../src/postgres/sync.ts"],"names":[],"mappings":"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"}

package/dist/cjs/registries/x402.js

@@ -132,14 +132,13 @@ class X402Registry {
             totalBefore = opts.totalCallsBefore ?? 0;
         }
         else {
-            // Try to read from existing escrow
+            // Try to read from existing escrow (V2 first, then V1)
             const [agentPda] = (0, pda_1.deriveAgent)(agentWallet);
-            const [escrowPda] = (0, pda_1.deriveEscrow)(agentPda, this.wallet);
-            const escrow = await this.fetchNullable("escrowAccount", escrowPda);
-            if (escrow) {
-                pricePerCall = escrow.pricePerCall;
-                volumeCurve = escrow.volumeCurve ?? [];
-                totalBefore = escrow.totalCallsSettled.toNumber();
+            const resolved = await this.resolveEscrow(agentPda, this.wallet);
+            if (resolved) {
+                pricePerCall = resolved.escrow.pricePerCall;
+                volumeCurve = resolved.escrow.volumeCurve ?? [];
+                totalBefore = resolved.escrow.totalCallsSettled.toNumber();
             }
             else {
                 // Fall back to agent's first pricing tier
@@ -231,6 +230,8 @@ class X402Registry {
      * @param opts - Payment options (price, max calls, deposit, etc.).
      * @returns A {@link PaymentContext} with escrow details and transaction signature.
      * @since v0.1.0
+     * @deprecated Since v0.7.0 — Creates a V1 escrow. Use `client.escrowV2.create()` for
+     * V2 escrows with dispute windows, co-signing, and settlement security.
      *
      * @example
      * ```ts
@@ -244,7 +245,6 @@ class X402Registry {
     async preparePayment(agentWallet, opts) {
         const [agentPda] = (0, pda_1.deriveAgent)(agentWallet);
         const [escrowPda] = (0, pda_1.deriveEscrow)(agentPda, this.wallet);
-        const [statsPda] = (0, pda_1.deriveAgentStats)(agentPda);
         const pricePerCall = new anchor_1.BN(opts.pricePerCall.toString());
         const maxCalls = new anchor_1.BN((opts.maxCalls ?? 0).toString());
         const initialDeposit = new anchor_1.BN(opts.deposit.toString());
@@ -258,7 +258,6 @@ class X402Registry {
             .accounts({
             depositor: this.wallet,
             agent: agentPda,
-            agentStats: statsPda,
             escrow: escrowPda,
             systemProgram: web3_js_1.SystemProgram.programId,
         })
@@ -282,6 +281,7 @@ class X402Registry {
      * @param amount - Amount to deposit in smallest token unit.
      * @returns The transaction signature.
      * @since v0.1.0
+     * @deprecated Since v0.7.0 — Operates on V1 escrows only. Use `client.escrowV2.deposit()` instead.
      */
     async addFunds(agentWallet, amount) {
         const [agentPda] = (0, pda_1.deriveAgent)(agentWallet);
@@ -303,6 +303,7 @@ class X402Registry {
      * @param amount - Amount to withdraw in smallest token unit.
      * @returns The transaction signature.
      * @since v0.1.0
+     * @deprecated Since v0.7.0 — Operates on V1 escrows only. Use `client.escrowV2.withdraw()` instead.
      */
     async withdrawFunds(agentWallet, amount) {
         const [agentPda] = (0, pda_1.deriveAgent)(agentWallet);
@@ -324,6 +325,7 @@ class X402Registry {
      * @param agentWallet - Agent wallet of the escrow.
      * @returns The transaction signature.
      * @since v0.1.0
+     * @deprecated Since v0.7.0 — Operates on V1 escrows only. Use `client.escrowV2.close()` instead.
      */
     async closeEscrow(agentWallet) {
         const [agentPda] = (0, pda_1.deriveAgent)(agentWallet);
@@ -376,13 +378,13 @@ class X402Registry {
      */
     async buildPaymentHeadersFromEscrow(agentWallet, opts) {
         const [agentPda] = (0, pda_1.deriveAgent)(agentWallet);
-        const [escrowPda] = (0, pda_1.deriveEscrow)(agentPda, this.wallet);
-        const escrow = await this.fetchNullable("escrowAccount", escrowPda);
-        if (!escrow)
+        const resolved = await this.resolveEscrow(agentPda, this.wallet);
+        if (!resolved)
             return null;
+        const escrow = resolved.escrow;
         return {
             "X-Payment-Protocol": "SAP-x402",
-            "X-Payment-Escrow": escrowPda.toBase58(),
+            "X-Payment-Escrow": resolved.escrowPda.toBase58(),
             "X-Payment-Agent": agentPda.toBase58(),
             "X-Payment-Depositor": this.wallet.toBase58(),
             "X-Payment-MaxCalls": escrow.maxCalls.toString(),
@@ -426,23 +428,42 @@ class X402Registry {
     async settle(depositorWallet, callsToSettle, serviceData, opts) {
         const serviceHash = (0, utils_1.hashToArray)((0, utils_1.sha256)(typeof serviceData === "string" ? serviceData : Buffer.from(serviceData)));
         const [agentPda] = (0, pda_1.deriveAgent)(this.wallet);
-        const [escrowPda] = (0, pda_1.deriveEscrow)(agentPda, depositorWallet);
         const [statsPda] = (0, pda_1.deriveAgentStats)(agentPda);
-        // Prefetch to calculate amount
-        const escrow = await this.fetch("escrowAccount", escrowPda);
+        // Auto-detect escrow version
+        const resolved = await this.resolveEscrow(agentPda, depositorWallet);
+        if (!resolved) {
+            throw new Error("No escrow found for this agent + depositor pair");
+        }
+        const escrow = resolved.escrow;
+        const escrowPda = resolved.escrowPda;
         const estimate = this.calculateCost(escrow.pricePerCall, escrow.volumeCurve, escrow.totalCallsSettled.toNumber(), callsToSettle);
         // Build priority fee instructions (empty array if no opts)
         const preIxs = (0, priority_fee_1.buildPriorityFeeIxs)(opts);
         const rpcOpts = (0, priority_fee_1.buildRpcOptions)(opts);
-        let builder = this.methods
-            .settleCalls(new anchor_1.BN(callsToSettle), serviceHash)
-            .accounts({
-            wallet: this.wallet,
-            agent: agentPda,
-            agentStats: statsPda,
-            escrow: escrowPda,
-            systemProgram: web3_js_1.SystemProgram.programId,
-        });
+        let builder;
+        if (resolved.version === 2) {
+            // V2: settleCallsV2 requires escrow_nonce (default 0)
+            builder = this.methods
+                .settleCallsV2(new anchor_1.BN(0), new anchor_1.BN(callsToSettle), serviceHash)
+                .accounts({
+                wallet: this.wallet,
+                agent: agentPda,
+                agentStats: statsPda,
+                escrow: escrowPda,
+                systemProgram: web3_js_1.SystemProgram.programId,
+            });
+        }
+        else {
+            builder = this.methods
+                .settleCalls(new anchor_1.BN(callsToSettle), serviceHash)
+                .accounts({
+                wallet: this.wallet,
+                agent: agentPda,
+                agentStats: statsPda,
+                escrow: escrowPda,
+                systemProgram: web3_js_1.SystemProgram.programId,
+            });
+        }
         if (preIxs.length > 0) {
             builder = builder.preInstructions(preIxs);
         }
@@ -483,10 +504,14 @@ class X402Registry {
         }));
         const totalCalls = entries.reduce((sum, e) => sum + e.calls, 0);
         const [agentPda] = (0, pda_1.deriveAgent)(this.wallet);
-        const [escrowPda] = (0, pda_1.deriveEscrow)(agentPda, depositorWallet);
         const [statsPda] = (0, pda_1.deriveAgentStats)(agentPda);
-        // Prefetch for amount estimation
-        const escrow = await this.fetch("escrowAccount", escrowPda);
+        // Auto-detect escrow version
+        const resolved = await this.resolveEscrow(agentPda, depositorWallet);
+        if (!resolved) {
+            throw new Error("No escrow found for this agent + depositor pair");
+        }
+        const escrow = resolved.escrow;
+        const escrowPda = resolved.escrowPda;
         const estimate = this.calculateCost(escrow.pricePerCall, escrow.volumeCurve, escrow.totalCallsSettled.toNumber(), totalCalls);
         // Build priority fee instructions (empty array if no opts)
         const preIxs = (0, priority_fee_1.buildPriorityFeeIxs)(opts);
@@ -526,16 +551,15 @@ class X402Registry {
     async getBalance(agentWallet, depositor) {
         const [agentPda] = (0, pda_1.deriveAgent)(agentWallet);
         const dep = depositor ?? this.wallet;
-        const [escrowPda] = (0, pda_1.deriveEscrow)(agentPda, dep);
-        const escrow = await this.fetchNullable("escrowAccount", escrowPda);
-        if (!escrow)
+        const resolved = await this.resolveEscrow(agentPda, dep);
+        if (!resolved)
             return null;
+        const escrow = resolved.escrow;
         const now = Math.floor(Date.now() / 1000);
         const isExpired = escrow.expiresAt.toNumber() > 0 && now >= escrow.expiresAt.toNumber();
         const maxCalls = escrow.maxCalls.toNumber();
         const settled = escrow.totalCallsSettled.toNumber();
         const callsRemaining = maxCalls > 0 ? maxCalls - settled : Infinity;
-        // Estimate affordable calls with current balance
         const pricePerCall = escrow.pricePerCall.toNumber();
         const balance = escrow.balance.toNumber();
         const affordableCalls = pricePerCall > 0
@@ -562,9 +586,17 @@ class X402Registry {
      */
     async hasEscrow(agentWallet, depositor) {
         const [agentPda] = (0, pda_1.deriveAgent)(agentWallet);
-        const [escrowPda] = (0, pda_1.deriveEscrow)(agentPda, depositor ?? this.wallet);
-        const info = await this.program.provider.connection.getAccountInfo(escrowPda);
-        return info !== null;
+        const dep = depositor ?? this.wallet;
+        const conn = this.program.provider.connection;
+        // Check V2 first (nonce=0)
+        const [v2Pda] = (0, pda_1.deriveEscrowV2)(agentPda, dep, 0);
+        const v2Info = await conn.getAccountInfo(v2Pda);
+        if (v2Info !== null)
+            return true;
+        // Fall back to V1
+        const [v1Pda] = (0, pda_1.deriveEscrow)(agentPda, dep);
+        const v1Info = await conn.getAccountInfo(v1Pda);
+        return v1Info !== null;
     }
     /**
      * @name fetchEscrow
@@ -578,8 +610,8 @@ class X402Registry {
     async fetchEscrow(agentWallet, depositor) {
         const [agentPda] = (0, pda_1.deriveAgent)(agentWallet);
         const dep = depositor ?? this.wallet;
-        const [escrowPda] = (0, pda_1.deriveEscrow)(agentPda, dep);
-        return this.fetchNullable("escrowAccount", escrowPda);
+        const resolved = await this.resolveEscrow(agentPda, dep);
+        return resolved?.escrow ?? null;
     }
     // ── Internals ────────────────────────────────────────
     /**
@@ -593,20 +625,6 @@ class X402Registry {
         // eslint-disable-next-line @typescript-eslint/no-unsafe-return
         return this.program.methods;
     }
-    /**
-     * @name fetch
-     * @description Fetch an on-chain account by name and PDA. Throws if not found.
-     * @param name - Anchor account discriminator name.
-     * @param pda - Account public key to fetch.
-     * @returns The deserialized account data.
-     * @throws If the account does not exist.
-     * @private
-     */
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    async fetch(name, pda) {
-        // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-explicit-any
-        return this.program.account[name].fetch(pda);
-    }
     /**
      * @name fetchNullable
      * @description Fetch an on-chain account by name and PDA. Returns `null` if not found.
@@ -620,6 +638,25 @@ class X402Registry {
         // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-explicit-any
         return this.program.account[name].fetchNullable(pda);
     }
+    /**
+     * @name resolveEscrow
+     * @description Try to find an escrow: V2 (nonce=0) first, then V1 fallback.
+     * Returns the escrow data, PDA, and version indicator.
+     * @private
+     */
+    async resolveEscrow(agentPda, depositor) {
+        // Try V2 first (nonce=0 is the default)
+        const [v2Pda] = (0, pda_1.deriveEscrowV2)(agentPda, depositor, 0);
+        const v2 = await this.fetchNullable("escrowAccountV2", v2Pda);
+        if (v2)
+            return { escrow: v2, escrowPda: v2Pda, version: 2 };
+        // Fall back to V1
+        const [v1Pda] = (0, pda_1.deriveEscrow)(agentPda, depositor);
+        const v1 = await this.fetchNullable("escrowAccount", v1Pda);
+        if (v1)
+            return { escrow: v1, escrowPda: v1Pda, version: 1 };
+        return null;
+    }
 }
 exports.X402Registry = X402Registry;
 //# sourceMappingURL=x402.js.map