@absol-labs/agent 0.11.0 → 0.12.0-rc.1

package/src/x402-opener/relayer-queue.ts

@@ -0,0 +1,18 @@
+/**
+ * Serializes every relayer submission (simulate + broadcast) of one facilitator
+ * process, so concurrent requests never race for the relayer account's nonce.
+ *
+ * The opener scheme (`deployAndSettle`) and the refund relay (`closeWithSig`,
+ * `reclaim`, `reclaimUnverifiedWithSig`) share ONE queue when they share one
+ * relayer key: two independent queues would reintroduce the race.
+ */
+export class RelayerQueue {
+  private tail: Promise<unknown> = Promise.resolve();
+
+  /** Runs `task` after every previously queued task settles (success or failure). */
+  run<T>(task: () => Promise<T>): Promise<T> {
+    const next = this.tail.then(task, task);
+    this.tail = next.catch(() => undefined);
+    return next;
+  }
+}