@msgboard/relayer 0.0.31 → 0.0.32

package/README.md

@@ -59,7 +59,7 @@ await archive.migrate()
 const recent = await archive.query({ chainId: 943, category: 'lorem', limit: 20 })
 ```
 
-`query()` filters by `chainId`, `category` (hex or decoded text), `since`/`until`, `contains` (substring match on decoded content), `limit`, and `offset`.
+`query()` filters by `chainId`, `category` (hex or decoded text), `since`/`until`, `contains` (substring match on the decoded data text), `limit`, and `offset`.
 
 The storage and query layer lives in [`@msgboard/history`](../history); `postgresArchiveSink` is the adapter that drives it from the relayer heartbeat. Use `@msgboard/history`'s `archiveServer` to expose the same archive over an HTTP query API.
 

package/dist/actions/repricing.d.ts

@@ -0,0 +1,41 @@
+import type { RelayerAction, RelayerContext } from '../types.js';
+import type { PendingTxTracker, TxFees } from '../stores/pending-tx.js';
+/** What the caller's submit fn is handed: the nonce + fees to use, the item, and the runtime ctx. */
+export type SubmitRequest<T> = {
+    item: T;
+    nonce: number;
+    fees: TxFees;
+    context: RelayerContext;
+    /** True when this is a replace-by-fee resubmission of an already-pending nonce. */
+    replacement: boolean;
+};
+export type RepricingActionOptions<T> = {
+    /** Tracks in-flight txs by nonce (window + RBF state). */
+    tracker: PendingTxTracker;
+    /** Pure description for observe-mode logging. */
+    describe: (item: T, context: RelayerContext) => string;
+    /** Build + send ONE tx at the given nonce/fees. Returns the tx hash. */
+    submit: (req: SubmitRequest<T>) => Promise<{
+        hash: string;
+    }>;
+    /** Initial EIP-1559 fees for a fresh settlement (e.g. read from the chain). */
+    initialFees: (item: T, context: RelayerContext) => Promise<TxFees>;
+    /** A pending tx older than this is replaced-by-fee. */
+    staleMs: number;
+    /** Stable per-item key so a re-tick of the same settlement reuses its nonce. Defaults to JSON. */
+    itemKey?: (item: T) => string;
+    /** Injectable clock (tests). */
+    now?: () => number;
+};
+/**
+ * Wraps a single-tx submit fn with a nonce window (pipeline multiple settlements)
+ * and replace-by-fee (bump a stuck tx). Generic — the relayer spec §13 deferred
+ * "nonce-window / repricing Action wrapper". Knows nothing about games.
+ *
+ * Safety: `describe` is pure (observe mode never submits). A submitted nonce is
+ * remembered; a re-tick of the same item before it mines RBFs the SAME nonce
+ * (never a second tx, never a forged state — it only re-sends the same calldata
+ * at a higher fee). When the window is full a new item is a no-op this tick.
+ */
+export declare const repricingAction: <T>(options: RepricingActionOptions<T>) => RelayerAction<T>;
+//# sourceMappingURL=repricing.d.ts.map

package/dist/actions/repricing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repricing.d.ts","sourceRoot":"","sources":["../../src/actions/repricing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAEvE,qGAAqG;AACrG,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;IAC7B,IAAI,EAAE,CAAC,CAAA;IACP,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,cAAc,CAAA;IACvB,mFAAmF;IACnF,WAAW,EAAE,OAAO,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,sBAAsB,CAAC,CAAC,IAAI;IACtC,0DAA0D;IAC1D,OAAO,EAAE,gBAAgB,CAAA;IACzB,iDAAiD;IACjD,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,cAAc,KAAK,MAAM,CAAA;IACtD,wEAAwE;IACxE,MAAM,EAAE,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC5D,+EAA+E;IAC/E,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAClE,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAA;IACf,kGAAkG;IAClG,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAA;IAC7B,gCAAgC;IAChC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CACnB,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,EAAE,SAAS,sBAAsB,CAAC,CAAC,CAAC,KAAG,aAAa,CAAC,CAAC,CAkCtF,CAAA"}

package/dist/actions/repricing.js

@@ -0,0 +1,43 @@
+/**
+ * Wraps a single-tx submit fn with a nonce window (pipeline multiple settlements)
+ * and replace-by-fee (bump a stuck tx). Generic — the relayer spec §13 deferred
+ * "nonce-window / repricing Action wrapper". Knows nothing about games.
+ *
+ * Safety: `describe` is pure (observe mode never submits). A submitted nonce is
+ * remembered; a re-tick of the same item before it mines RBFs the SAME nonce
+ * (never a second tx, never a forged state — it only re-sends the same calldata
+ * at a higher fee). When the window is full a new item is a no-op this tick.
+ */
+export const repricingAction = (options) => {
+    const key = options.itemKey ?? ((item) => JSON.stringify(item));
+    // item-key -> the nonce we assigned it, so a re-tick reuses it for RBF
+    const nonceOf = new Map();
+    return {
+        describe: (item, context) => options.describe(item, context),
+        execute: async (item, context) => {
+            const k = key(item);
+            const existing = nonceOf.get(k);
+            // Already in flight: replace-by-fee iff stale, else leave it.
+            if (existing !== undefined) {
+                if (!options.tracker.isStale(existing, options.staleMs)) {
+                    return { ok: true, ref: `nonce:${existing}`, meta: { skipped: 'still-pending' } };
+                }
+                const fees = options.tracker.bumpFees(existing);
+                const { hash } = await options.submit({ item, nonce: existing, fees, context, replacement: true });
+                options.tracker.recordSubmission(existing, { hash, ...fees });
+                return { ok: true, ref: hash, meta: { replacement: true, nonce: existing } };
+            }
+            // New settlement: claim a nonce from the window.
+            const nonce = options.tracker.claim();
+            if (nonce === undefined) {
+                return { ok: false, meta: { deferred: 'nonce-window-full' } };
+            }
+            const fees = await options.initialFees(item, context);
+            const { hash } = await options.submit({ item, nonce, fees, context, replacement: false });
+            nonceOf.set(k, nonce);
+            options.tracker.recordSubmission(nonce, { hash, ...fees });
+            return { ok: true, ref: hash, meta: { nonce } };
+        },
+    };
+};
+//# sourceMappingURL=repricing.js.map

package/dist/actions/repricing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repricing.js","sourceRoot":"","sources":["../../src/actions/repricing.ts"],"names":[],"mappings":"AA8BA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAI,OAAkC,EAAoB,EAAE;IACzF,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC,IAAO,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAA;IAClE,uEAAuE;IACvE,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAA;IAEzC,OAAO;QACL,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;QAC5D,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;YAC/B,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,CAAA;YACnB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;YAE/B,8DAA8D;YAC9D,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;oBACxD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,QAAQ,EAAE,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,eAAe,EAAE,EAAE,CAAA;gBACnF,CAAC;gBACD,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;gBAC/C,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAA;gBAClG,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC,CAAA;gBAC7D,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAA;YAC9E,CAAC;YAED,iDAAiD;YACjD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;YACrC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,mBAAmB,EAAE,EAAE,CAAA;YAC/D,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;YACrD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAA;YACzF,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;YACrB,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC,CAAA;YAC1D,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,CAAA;QACjD,CAAC;KACF,CAAA;AACH,CAAC,CAAA"}

package/dist/index.d.ts

@@ -18,6 +18,10 @@ export { forwardMessageAction } from './actions/forward-message.js';
 export { sendValueAction } from './actions/send-value.js';
 export { webhookAction } from './actions/webhook.js';
 export { noopAction } from './actions/noop.js';
+export { repricingAction } from './actions/repricing.js';
+export type { RepricingActionOptions, SubmitRequest } from './actions/repricing.js';
+export { createPendingTxTracker } from './stores/pending-tx.js';
+export type { PendingTxTracker, PendingTx, PendingTxTrackerOptions, TxFees } from './stores/pending-tx.js';
 export { httpQueueSource } from './sources/http-queue.js';
 export type { HttpQueueSource, HttpQueueSourceOptions } from './sources/http-queue.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,YAAY,EACV,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,UAAU,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,aAAa,EACb,YAAY,EACZ,UAAU,GACX,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAErD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AACjE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAClG,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAElD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAA;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAA;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAExD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE9C,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AACzD,YAAY,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,YAAY,EACV,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,UAAU,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,aAAa,EACb,YAAY,EACZ,UAAU,GACX,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAErD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AACjE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAClG,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAElD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAA;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAA;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAExD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE9C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,YAAY,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AACnF,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,YAAY,EAAE,gBAAgB,EAAE,SAAS,EAAE,uBAAuB,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AAE1G,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AACzD,YAAY,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA"}

package/dist/index.js

@@ -14,5 +14,7 @@ export { forwardMessageAction } from './actions/forward-message.js';
 export { sendValueAction } from './actions/send-value.js';
 export { webhookAction } from './actions/webhook.js';
 export { noopAction } from './actions/noop.js';
+export { repricingAction } from './actions/repricing.js';
+export { createPendingTxTracker } from './stores/pending-tx.js';
 export { httpQueueSource } from './sources/http-queue.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAgB1C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAGpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AAEjE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAElD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAA;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAA;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAExD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE9C,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAgB1C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAGpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AAEjE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAElD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAA;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAA;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAExD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE9C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAExD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AAG/D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA"}

package/dist/stores/pending-tx.d.ts

@@ -0,0 +1,46 @@
+/** Fee fields for an EIP-1559 settle tx, in wei. */
+export type TxFees = {
+    maxFeePerGas: bigint;
+    maxPriorityFeePerGas: bigint;
+};
+/** What we retain about one in-flight tx, keyed by its nonce. */
+export type PendingTx = {
+    nonce: number;
+    hash: string;
+    fees: TxFees;
+    submittedAt: number;
+};
+export type PendingTxTrackerOptions = {
+    /** Max number of nonces in flight at once (the pipeline depth). */
+    windowSize: number;
+    /** First nonce this worker owns (from `getTransactionCount(account, 'pending')`). */
+    baseNonce: number;
+    /** Injectable clock for tests. Defaults to Date.now. */
+    now?: () => number;
+    /** RBF bump numerator/denominator. Defaults to 1125/1000 (+12.5%, above geth's 10% floor). */
+    bumpNum?: bigint;
+    bumpDen?: bigint;
+};
+/**
+ * Tracks settle txs by nonce so multiple settlements pipeline (a bounded window)
+ * and stuck ones can be replaced-by-fee. Knows nothing about games or settlement —
+ * a generic engine primitive (the relayer spec §13 deferred item). Process-local.
+ */
+export type PendingTxTracker = {
+    /** Reserve the next nonce, or undefined if the window is full. */
+    claim(): number | undefined;
+    /** Record the tx hash + fees we submitted for a claimed nonce. */
+    recordSubmission(nonce: number, tx: {
+        hash: string;
+    } & TxFees): void;
+    /** True if the tx for `nonce` was submitted longer than `staleMs` ago and is still pending. */
+    isStale(nonce: number, staleMs: number): boolean;
+    /** Compute strictly-higher fees for a replace-by-fee resubmission of `nonce`. */
+    bumpFees(nonce: number): TxFees;
+    /** Mark a nonce's tx mined; frees the slot and advances the window. */
+    markMined(nonce: number): void;
+    /** Current pending entries, for observability. */
+    pending(): readonly PendingTx[];
+};
+export declare const createPendingTxTracker: (opts: PendingTxTrackerOptions) => PendingTxTracker;
+//# sourceMappingURL=pending-tx.d.ts.map

package/dist/stores/pending-tx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending-tx.d.ts","sourceRoot":"","sources":["../../src/stores/pending-tx.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,MAAM,MAAM,MAAM,GAAG;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,oBAAoB,EAAE,MAAM,CAAA;CAC7B,CAAA;AAED,iEAAiE;AACjE,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,mEAAmE;IACnE,UAAU,EAAE,MAAM,CAAA;IAClB,qFAAqF;IACrF,SAAS,EAAE,MAAM,CAAA;IACjB,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB,8FAA8F;IAC9F,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,kEAAkE;IAClE,KAAK,IAAI,MAAM,GAAG,SAAS,CAAA;IAC3B,kEAAkE;IAClE,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,GAAG,IAAI,CAAA;IACpE,+FAA+F;IAC/F,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAA;IAChD,iFAAiF;IACjF,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;IAC/B,uEAAuE;IACvE,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,kDAAkD;IAClD,OAAO,IAAI,SAAS,SAAS,EAAE,CAAA;CAChC,CAAA;AAID,eAAO,MAAM,sBAAsB,GAAI,MAAM,uBAAuB,KAAG,gBA2CtE,CAAA"}

package/dist/stores/pending-tx.js

@@ -0,0 +1,47 @@
+const ceilMul = (v, num, den) => (v * num + den - 1n) / den;
+export const createPendingTxTracker = (opts) => {
+    const now = opts.now ?? (() => Date.now());
+    const bumpNum = opts.bumpNum ?? 1125n;
+    const bumpDen = opts.bumpDen ?? 1000n;
+    const inFlight = new Map(); // null = claimed, not yet submitted
+    let nextNonce = opts.baseNonce;
+    const liveCount = () => inFlight.size;
+    return {
+        claim: () => {
+            if (liveCount() >= opts.windowSize)
+                return undefined;
+            const nonce = nextNonce;
+            nextNonce += 1;
+            inFlight.set(nonce, null);
+            return nonce;
+        },
+        recordSubmission: (nonce, tx) => {
+            inFlight.set(nonce, {
+                nonce,
+                hash: tx.hash,
+                fees: { maxFeePerGas: tx.maxFeePerGas, maxPriorityFeePerGas: tx.maxPriorityFeePerGas },
+                submittedAt: now(),
+            });
+        },
+        isStale: (nonce, staleMs) => {
+            const e = inFlight.get(nonce);
+            if (!e)
+                return false;
+            return now() - e.submittedAt > staleMs;
+        },
+        bumpFees: (nonce) => {
+            const e = inFlight.get(nonce);
+            if (!e)
+                throw new Error(`pending-tx: no submission recorded for nonce ${nonce}`);
+            return {
+                maxFeePerGas: ceilMul(e.fees.maxFeePerGas, bumpNum, bumpDen),
+                maxPriorityFeePerGas: ceilMul(e.fees.maxPriorityFeePerGas, bumpNum, bumpDen),
+            };
+        },
+        markMined: (nonce) => {
+            inFlight.delete(nonce);
+        },
+        pending: () => [...inFlight.values()].filter((e) => e !== null),
+    };
+};
+//# sourceMappingURL=pending-tx.js.map

package/dist/stores/pending-tx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending-tx.js","sourceRoot":"","sources":["../../src/stores/pending-tx.ts"],"names":[],"mappings":"AA8CA,MAAM,OAAO,GAAG,CAAC,CAAS,EAAE,GAAW,EAAE,GAAW,EAAU,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,CAAA;AAE3F,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,IAA6B,EAAoB,EAAE;IACxF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAA;IAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,KAAK,CAAA;IACrC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,KAAK,CAAA;IACrC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA4B,CAAA,CAAC,oCAAoC;IACzF,IAAI,SAAS,GAAG,IAAI,CAAC,SAAS,CAAA;IAE9B,MAAM,SAAS,GAAG,GAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAA;IAE7C,OAAO;QACL,KAAK,EAAE,GAAG,EAAE;YACV,IAAI,SAAS,EAAE,IAAI,IAAI,CAAC,UAAU;gBAAE,OAAO,SAAS,CAAA;YACpD,MAAM,KAAK,GAAG,SAAS,CAAA;YACvB,SAAS,IAAI,CAAC,CAAA;YACd,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;YACzB,OAAO,KAAK,CAAA;QACd,CAAC;QACD,gBAAgB,EAAE,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;YAC9B,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE;gBAClB,KAAK;gBACL,IAAI,EAAE,EAAE,CAAC,IAAI;gBACb,IAAI,EAAE,EAAE,YAAY,EAAE,EAAE,CAAC,YAAY,EAAE,oBAAoB,EAAE,EAAE,CAAC,oBAAoB,EAAE;gBACtF,WAAW,EAAE,GAAG,EAAE;aACnB,CAAC,CAAA;QACJ,CAAC;QACD,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;YAC1B,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;YAC7B,IAAI,CAAC,CAAC;gBAAE,OAAO,KAAK,CAAA;YACpB,OAAO,GAAG,EAAE,GAAG,CAAC,CAAC,WAAW,GAAG,OAAO,CAAA;QACxC,CAAC;QACD,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;YAClB,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;YAC7B,IAAI,CAAC,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,KAAK,EAAE,CAAC,CAAA;YAChF,OAAO;gBACL,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC;gBAC5D,oBAAoB,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,oBAAoB,EAAE,OAAO,EAAE,OAAO,CAAC;aAC7E,CAAA;QACH,CAAC;QACD,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE;YACnB,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QACxB,CAAC;QACD,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAkB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC;KAChF,CAAA;AACH,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@msgboard/relayer",
-  "version": "0.0.31",
+  "version": "0.0.32",
   "description": "Controllable, safe-by-default pool-watcher relayer for the msgboard board",
   "repository": "github:valve-tech/msgboard",
   "author": "MsgBoard",
@@ -30,6 +30,7 @@
     "prebuild": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
     "build": "tsc",
     "watch": "tsc -w",
+    "typecheck": "tsc --noEmit -p tsconfig.test.json",
     "test": "vitest run",
     "test:watch": "vitest",
     "lint": "prettier --check ."
@@ -38,8 +39,8 @@
     "dist/"
   ],
   "dependencies": {
-    "@msgboard/history": "^0.0.31",
-    "@msgboard/sdk": "^0.0.31",
+    "@msgboard/history": "^0.0.32",
+    "@msgboard/sdk": "^0.0.32",
     "viem": "^2.25.0"
   },
   "peerDependencies": {