mppx 0.8.13 → 0.8.15

package/dist/tempo/server/SponsorBudget.js

@@ -0,0 +1,150 @@
+import { VerificationFailedError } from '../../Errors.js';
+const initialPollIntervalMs = 10;
+const maxPollIntervalMs = 250;
+const preparedLeaseMs = 30_000;
+function key(parameters) {
+    return `mppx:charge:sponsor-budget:${parameters.chainId}:${parameters.sponsor.toLowerCase()}`;
+}
+function isState(value) {
+    return value?.version === 1 && typeof value.reservations === 'object';
+}
+async function mutateOwned(store, handle, mutate) {
+    return store.update(key(handle), (current) => {
+        if (!isState(current))
+            return { op: 'noop', result: false };
+        const reservation = current.reservations[handle.id];
+        if (!reservation || reservation.owner !== handle.owner)
+            return { op: 'noop', result: false };
+        const reservations = { ...current.reservations };
+        const next = mutate(reservation);
+        if (next)
+            reservations[handle.id] = next;
+        else
+            delete reservations[handle.id];
+        if (Object.keys(reservations).length === 0)
+            return { op: 'delete', result: true };
+        return {
+            op: 'set',
+            value: { reservations, version: 1 },
+            result: true,
+        };
+    });
+}
+async function reconcile(store, parameters) {
+    const state = await store.get(key(parameters));
+    if (!isState(state))
+        return;
+    const now = Date.now();
+    await Promise.all(Object.entries(state.reservations).map(async ([id, reservation]) => {
+        const handle = {
+            chainId: parameters.chainId,
+            id,
+            owner: reservation.owner,
+            sponsor: parameters.sponsor,
+        };
+        if (reservation.expiresAt <= now ||
+            (reservation.phase === 'prepared' && reservation.leaseUntil <= now)) {
+            await release(store, handle);
+            return;
+        }
+        // The broadcasting owner has submitted (or is about to submit) the
+        // transaction but has not yet published that outcome to this store.
+        // Releasing its reservation here races the owner's transition to
+        // `pending`: the transaction can settle while the owner observes a lost
+        // reservation and reports a retryable payment failure. Only reconcile
+        // receipts after the owner has completed that hand-off.
+        if (reservation.phase !== 'pending')
+            return;
+        try {
+            await parameters.getReceipt(reservation.transactionHash);
+        }
+        catch {
+            return;
+        }
+        await release(store, handle);
+    }));
+}
+/**
+ * Reserves aggregate sponsor fee capacity across processes.
+ *
+ * Pending broadcasts remain charged to the budget until a receipt is observed
+ * or their expiring nonce becomes invalid. Capacity waiters do not rewrite the
+ * shared state while waiting.
+ *
+ * @internal
+ */
+export async function reserve(store, parameters) {
+    if (parameters.fee > parameters.maxTotalFee)
+        throw new VerificationFailedError({
+            reason: 'Sponsored transaction fee exceeds the aggregate sponsor budget',
+        });
+    let pollIntervalMs = initialPollIntervalMs;
+    for (;;) {
+        const now = Date.now();
+        if (now >= parameters.waitUntil)
+            throw new VerificationFailedError({
+                reason: 'Sponsored transaction expired while waiting for sponsor budget',
+            });
+        await reconcile(store, parameters);
+        const result = await store.update(key(parameters), (current) => {
+            if (current !== null && !isState(current))
+                return { op: 'noop', result: 'invalid' };
+            const reservations = { ...(current?.reservations ?? {}) };
+            const existing = reservations[parameters.id];
+            if (existing)
+                return { op: 'noop', result: 'duplicate' };
+            const values = Object.values(reservations);
+            const totalFee = values.reduce((total, reservation) => total + BigInt(reservation.fee), 0n);
+            if (values.length >= parameters.maxReservations ||
+                totalFee + parameters.fee > parameters.maxTotalFee)
+                return { op: 'noop', result: 'wait' };
+            reservations[parameters.id] = {
+                expiresAt: parameters.expiresAt,
+                fee: parameters.fee.toString(),
+                leaseUntil: Math.min(parameters.expiresAt, now + preparedLeaseMs),
+                owner: parameters.owner,
+                phase: 'prepared',
+                transactionHash: parameters.transactionHash,
+            };
+            return {
+                op: 'set',
+                value: { reservations, version: 1 },
+                result: 'reserved',
+            };
+        });
+        if (result === 'reserved')
+            return parameters;
+        if (result === 'invalid')
+            throw new VerificationFailedError({
+                reason: 'Sponsor budget store contains incompatible state',
+            });
+        if (result === 'duplicate')
+            throw new VerificationFailedError({
+                reason: 'Sponsored transaction already has a budget reservation',
+            });
+        await new Promise((resolve) => setTimeout(resolve, Math.min(pollIntervalMs, parameters.waitUntil - now)));
+        pollIntervalMs = Math.min(pollIntervalMs * 2, maxPollIntervalMs);
+    }
+}
+/**
+ * Advances a reservation before and after the broadcast call.
+ *
+ * The owner token fences stale workers from mutating a replacement reservation.
+ *
+ * @internal
+ */
+export async function transition(store, handle, phase) {
+    return mutateOwned(store, handle, (reservation) => ({
+        ...reservation,
+        phase,
+    }));
+}
+/**
+ * Releases a reservation only when the caller still owns it.
+ *
+ * @internal
+ */
+export async function release(store, handle) {
+    return mutateOwned(store, handle, () => null);
+}
+//# sourceMappingURL=SponsorBudget.js.map

package/dist/tempo/server/SponsorBudget.js.map

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