viem 3.0.0-next.10 → 3.0.0-next.13

package/dist/tempo/internal/relay/cache.js

@@ -0,0 +1,72 @@
+import { withTimeout } from '../../../core/internal/promise.js';
+// Scope in-flight work to one request so Workers never share request-owned I/O.
+const flights = new WeakMap();
+const prefix = 'viem:relay:cache:';
+export function scoped(store) {
+    if (!store)
+        return undefined;
+    return {
+        getItem: (key) => store.getItem(key),
+        setItem: (key, value) => store.setItem(key, value),
+        removeItem: (key) => store.removeItem(key),
+    };
+}
+export async function memoize(fetch, options) {
+    const { store, ttl } = options;
+    const key = `${prefix}${options.key}`;
+    let active = true;
+    const timeoutError = new Error('Relay cache operation timed out.');
+    return withTimeout(async () => {
+        const raw = await store.getItem(key);
+        if (!active)
+            throw timeoutError;
+        if (raw) {
+            try {
+                const entry = JSON.parse(raw, (_key, item) => {
+                    if (typeof item !== 'string' || !item.startsWith(prefix))
+                        return item;
+                    if (item.startsWith(`${prefix}string:`))
+                        return item.slice(`${prefix}string:`.length);
+                    if (item.startsWith(`${prefix}bigint:`))
+                        return BigInt(item.slice(`${prefix}bigint:`.length));
+                    throw new TypeError('Invalid relay cache value.');
+                });
+                if (entry.expiresAt > Date.now())
+                    return entry.value;
+            }
+            catch {
+                // Refresh malformed or older entries.
+            }
+        }
+        let pending = flights.get(store);
+        if (!pending) {
+            pending = new Map();
+            flights.set(store, pending);
+        }
+        const existing = pending.get(key);
+        if (existing)
+            return existing;
+        const result = (async () => {
+            const value = await fetch();
+            if (!active)
+                throw timeoutError;
+            if (value !== undefined)
+                await store.setItem(key, JSON.stringify({ value, expiresAt: Date.now() + ttl }, (_key, item) => {
+                    if (typeof item === 'bigint')
+                        return `${prefix}bigint:${item}`;
+                    if (typeof item === 'string' && item.startsWith(prefix))
+                        return `${prefix}string:${item}`;
+                    return item;
+                }));
+            return value;
+        })().finally(() => pending.delete(key));
+        pending.set(key, result);
+        return result;
+    }, {
+        timeout: 30_000,
+        errorInstance: timeoutError,
+    }).finally(() => {
+        active = false;
+    });
+}
+//# sourceMappingURL=cache.js.map

package/dist/tempo/internal/relay/cache.js.map

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

package/dist/tempo/internal/relay/deadline.d.ts

@@ -0,0 +1,4 @@
+import type * as Relay from '../../Relay.js';
+/** Bounds the complete fill, including callbacks that do not observe abort signals. */
+export declare function run(handler: Relay.handleRequest.Handler, request: Relay.handleRequest.Request, options: Relay.handleRequest.RequestOptions, config: Relay.handleRequest.Options): Promise<unknown>;
+//# sourceMappingURL=deadline.d.ts.map

package/dist/tempo/internal/relay/deadline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deadline.d.ts","sourceRoot":"","sources":["../../../../src/tempo/internal/relay/deadline.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,KAAK,MAAM,gBAAgB,CAAA;AAE5C,uFAAuF;AACvF,wBAAsB,GAAG,CACvB,OAAO,EAAE,KAAK,CAAC,aAAa,CAAC,OAAO,EACpC,OAAO,EAAE,KAAK,CAAC,aAAa,CAAC,OAAO,EACpC,OAAO,EAAE,KAAK,CAAC,aAAa,CAAC,cAAc,EAC3C,MAAM,EAAE,KAAK,CAAC,aAAa,CAAC,OAAO,oBAoCpC"}

package/dist/tempo/internal/relay/deadline.js

@@ -0,0 +1,34 @@
+import { RpcResponse } from 'ox';
+/** Bounds the complete fill, including callbacks that do not observe abort signals. */
+export async function run(handler, request, options, config) {
+    const controller = new AbortController();
+    const abort = () => controller.abort(options.signal?.reason);
+    options.signal?.addEventListener('abort', abort, { once: true });
+    if (options.signal?.aborted)
+        abort();
+    const timeout = setTimeout(() => controller.abort(new RpcResponse.LimitExceededError({
+        message: 'Relay fill exceeded its deadline.',
+    })), config.timeout ?? 10_000);
+    const signal = controller.signal;
+    let rejectAbort;
+    const aborted = new Promise((_, reject) => {
+        rejectAbort = reject;
+    });
+    const onAbort = () => rejectAbort(signal.reason);
+    signal.addEventListener('abort', onAbort, { once: true });
+    try {
+        signal.throwIfAborted();
+        return await Promise.race([
+            handler(request, { ...options, signal }),
+            aborted,
+        ]);
+    }
+    finally {
+        clearTimeout(timeout);
+        options.signal?.removeEventListener('abort', abort);
+        signal.removeEventListener('abort', onAbort);
+        // Prevent timed-out hooks from dispatching additional I/O after the response completes.
+        controller.abort();
+    }
+}
+//# sourceMappingURL=deadline.js.map

package/dist/tempo/internal/relay/deadline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deadline.js","sourceRoot":"","sources":["../../../../src/tempo/internal/relay/deadline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,IAAI,CAAA;AAGhC,uFAAuF;AACvF,MAAM,CAAC,KAAK,UAAU,GAAG,CACvB,OAAoC,EACpC,OAAoC,EACpC,OAA2C,EAC3C,MAAmC;IAEnC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;IACxC,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5D,OAAO,CAAC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;IAChE,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO;QAAE,KAAK,EAAE,CAAA;IACpC,MAAM,OAAO,GAAG,UAAU,CACxB,GAAG,EAAE,CACH,UAAU,CAAC,KAAK,CACd,IAAI,WAAW,CAAC,kBAAkB,CAAC;QACjC,OAAO,EAAE,mCAAmC;KAC7C,CAAC,CACH,EACH,MAAM,CAAC,OAAO,IAAI,MAAM,CACzB,CAAA;IACD,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAA;IAEhC,IAAI,WAAuC,CAAA;IAC3C,MAAM,OAAO,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QAC/C,WAAW,GAAG,MAAM,CAAA;IACtB,CAAC,CAAC,CAAA;IACF,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IAChD,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;IACzD,IAAI,CAAC;QACH,MAAM,CAAC,cAAc,EAAE,CAAA;QACvB,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC;YACxB,OAAO,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,CAAC;YACxC,OAAO;SACR,CAAC,CAAA;IACJ,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,OAAO,CAAC,CAAA;QACrB,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QACnD,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAC5C,wFAAwF;QACxF,UAAU,CAAC,KAAK,EAAE,CAAA;IACpB,CAAC;AACH,CAAC"}

package/dist/tempo/internal/relay/error.d.ts

@@ -0,0 +1,47 @@
+import type { Client } from '../../../core/Client.js';
+import * as ExecutionError from '../../ExecutionError.js';
+import type * as Store from './cache.js';
+/** Distinguishes execution reverts from transport and plugin failures. */
+export declare function isExecutionError(error: unknown): error is Error;
+export declare function formatError(error: Error, parameters: Record<string, unknown>, client: Client, simulateStore?: Store.Store): Promise<{
+    tx: {
+        from: unknown;
+        to: {} | null;
+        gas: string;
+        nonce: string;
+        value: string;
+        maxFeePerGas: string;
+        maxPriorityFeePerGas: string;
+    };
+    capabilities: {
+        balanceDiffs: {
+            [x: string]: import("../../Capabilities.js").BalanceDiff[];
+        } | undefined;
+        error: ExecutionError.Rpc;
+        insufficientFunds: {
+            amount: `0x${string}`;
+            decimals: number;
+            formatted: string;
+            token: `0x${string}`;
+            symbol: string;
+        } | undefined;
+        sponsored: boolean;
+        virtualAddresses?: Record<`0x${string}`, `0x${string}` | null>;
+    };
+} | {
+    tx: {
+        from: unknown;
+        to: {} | null;
+        gas: string;
+        nonce: string;
+        value: string;
+        maxFeePerGas: string;
+        maxPriorityFeePerGas: string;
+    };
+    capabilities: {
+        error: ExecutionError.Rpc;
+        sponsored: boolean;
+        virtualAddresses?: Record<`0x${string}`, `0x${string}` | null>;
+    };
+}>;
+//# sourceMappingURL=error.d.ts.map

package/dist/tempo/internal/relay/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../../../src/tempo/internal/relay/error.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAErD,OAAO,KAAK,cAAc,MAAM,yBAAyB,CAAA;AACzD,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAA;AAMxC,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CA0B/D;AAID,wBAAsB,WAAW,CAC/B,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,MAAM,EAAE,MAAM,EACd,aAAa,CAAC,EAAE,KAAK,CAAC,KAAK;;;;;;;;;;;;;;;;oBAsDoB,KAAK,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;GA4B7D"}

package/dist/tempo/internal/relay/error.js

@@ -0,0 +1,101 @@
+import { Hex } from 'ox';
+import { format as formatUnits } from 'ox/Value';
+import * as ExecutionError from '../../ExecutionError.js';
+import { resolveTokenMetadata } from './feeToken.js';
+import { simulateAndParseDiffs } from './simulate.js';
+import * as Utils from './utils.js';
+import { extractCalls, resolveVirtualAddresses } from './virtualAddress.js';
+/** Distinguishes execution reverts from transport and plugin failures. */
+export function isExecutionError(error) {
+    if (!(error instanceof Error))
+        return false;
+    const seen = new Set();
+    const pending = [error];
+    while (pending.length) {
+        const current = pending.pop();
+        if (!current || typeof current !== 'object' || seen.has(current))
+            continue;
+        seen.add(current);
+        const candidate = current;
+        if (candidate.code === 3 ||
+            candidate.name === 'UpstreamRevertError' ||
+            candidate.name === 'ExecutionRevertedError' ||
+            candidate.name === 'ContractFunctionRevertedError' ||
+            [candidate.message, candidate.details].some((message) => typeof message === 'string' && /^execution reverted\b/i.test(message)))
+            return true;
+        pending.push(candidate.cause, candidate.error);
+    }
+    return false;
+}
+const zeroAddress = '0x0000000000000000000000000000000000000000';
+export async function formatError(error, parameters, client, simulateStore) {
+    const revert = ExecutionError.from(error);
+    const stub = {
+        from: parameters.from,
+        to: parameters.to ?? null,
+        gas: '0x0',
+        nonce: '0x0',
+        value: '0x0',
+        maxFeePerGas: '0x0',
+        maxPriorityFeePerGas: '0x0',
+    };
+    if (revert.errorName === 'InsufficientBalance' && revert.args?.length === 3) {
+        const [available, required, token] = revert.args;
+        const normalized = Utils.normalizeFillTransactionRequest(parameters);
+        // Simulate from zero address for optimistic balance diffs.
+        const optimisticCalls = normalized ? extractCalls(normalized) : undefined;
+        const [{ balanceDiffs, tokenMetadata }, virtualAddresses] = optimisticCalls
+            ? await Promise.all([
+                simulateAndParseDiffs(client, {
+                    account: zeroAddress,
+                    calls: optimisticCalls,
+                    store: simulateStore,
+                }),
+                resolveVirtualAddresses(client, { calls: optimisticCalls }).catch(() => undefined),
+            ])
+            : [{ balanceDiffs: undefined, tokenMetadata: undefined }, undefined];
+        // Re-key balance diffs from zero address to the real sender.
+        const senderDiffs = parameters.from && balanceDiffs
+            ? { [parameters.from]: balanceDiffs[zeroAddress] ?? [] }
+            : balanceDiffs;
+        const metadata = await resolveTokenMetadata(client, {
+            token,
+            tokenMetadata,
+            store: simulateStore,
+        }).catch(() => undefined);
+        const deficit = required - available;
+        return {
+            tx: stub,
+            capabilities: {
+                balanceDiffs: senderDiffs,
+                error: ExecutionError.serialize(revert),
+                insufficientFunds: metadata
+                    ? {
+                        amount: Hex.fromNumber(deficit),
+                        decimals: metadata.decimals,
+                        formatted: formatUnits(deficit, metadata.decimals),
+                        token,
+                        symbol: metadata.symbol,
+                    }
+                    : undefined,
+                sponsored: false,
+                ...(virtualAddresses ? { virtualAddresses } : {}),
+            },
+        };
+    }
+    const normalized = Utils.normalizeFillTransactionRequest(parameters);
+    const virtualAddresses = normalized
+        ? await resolveVirtualAddresses(client, {
+            calls: extractCalls(normalized),
+        }).catch(() => undefined)
+        : undefined;
+    return {
+        tx: stub,
+        capabilities: {
+            error: ExecutionError.serialize(revert),
+            sponsored: false,
+            ...(virtualAddresses ? { virtualAddresses } : {}),
+        },
+    };
+}
+//# sourceMappingURL=error.js.map

package/dist/tempo/internal/relay/error.js.map

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

package/dist/tempo/internal/relay/feePayer.d.ts

@@ -0,0 +1,70 @@
+import type { Address } from 'abitype';
+import { type Hex } from 'ox';
+import type { Local as LocalAccount } from '../../../core/Account.js';
+import type * as Relay from '../../Relay.js';
+import type * as TransactionRequest from 'ox/tempo/TransactionRequest';
+export declare function create(options: Relay.feePayer.Options): Relay.Plugin;
+/** Checks a prepared transaction with its chain ID. Rejected fills fall back to sender payment; rejected raw submissions return a refusal. */
+export type Validate = (request: TransactionRequest.TransactionRequest & {
+    chainId?: number | Hex.Hex | undefined;
+}) => Validation | Promise<Validation>;
+/** A sponsorship verdict: `true` sponsors; `false` or a named reason refuses. */
+export type Validation = boolean | 'billing_past_due' | 'billing_required' | 'fee_token_unsupported' | 'spend_limit_exceeded' | 'tx_fee_limit_exceeded';
+/** Details recorded for a sponsored transaction. */
+export type SponsorshipDetails = {
+    /** Whether Tempo subsidizes the sponsorship instead of charging the API-key organization. */
+    subsidized: boolean;
+};
+/** Signs a filled transaction as the fee payer. */
+export declare function sign(options: sign.Options): Promise<{
+    sponsorshipDetails?: SponsorshipDetails;
+    transaction: {
+        from: `0x${string}` | undefined;
+        feePayerSignature: {
+            r: Hex.Hex;
+            s: Hex.Hex;
+            yParity: number;
+        };
+    };
+}>;
+export declare namespace sign {
+    type Options = {
+        /** Abort signal for the enclosing fill. */
+        signal?: AbortSignal | undefined;
+        /** Account used as the fee payer. */
+        account: LocalAccount;
+        /** Called once the fee payer has signed the fill. Awaited: a throw aborts the fill. */
+        onSponsored?: ((event: SponsoredEvent) => SponsorshipDetails | Promise<SponsorshipDetails | void> | void) | undefined;
+        /** Filled transaction to sign. */
+        transaction: Record<string, unknown>;
+        /** Sender address from the original request. */
+        sender?: Address | undefined;
+    };
+}
+/** Facts of one sponsorship commitment, emitted at fee-payer signing time. */
+export type SponsoredEvent = {
+    /** Chain the sponsored transaction targets. */
+    chainId: number;
+    /** Fee token the sponsorship resolved, when known. */
+    feeToken?: Address | undefined;
+    /** Method that triggered sponsorship: a fill (intent) or a raw submission. */
+    method: 'eth_fillTransaction' | 'eth_signRawTransaction' | 'eth_sendRawTransaction' | 'eth_sendRawTransactionSync';
+    /** Transaction sender. */
+    sender: Address;
+    /** Fee-payer sign payload: a stable identity for the sponsored envelope. */
+    signPayload: Hex.Hex;
+    /** Serialized sponsored transaction (sender-unsigned for fill intents). */
+    transaction: Hex.Hex;
+    /** Transaction hash (keccak256 of the signed envelope); absent for fill intents, whose senders have not signed yet. */
+    transactionHash?: Hex.Hex | undefined;
+};
+export declare namespace ExternalFeePayerUrl {
+    type Options = {
+        /** Whether to allow non-HTTPS or local/private external fee payer URLs. */
+        allowUnsafe?: boolean | undefined;
+    };
+    /** Normalizes external fee-payer relay URLs before forwarding fill payloads. */
+    export function normalize(value: string, options?: Options): string;
+    export {};
+}
+//# sourceMappingURL=feePayer.d.ts.map

package/dist/tempo/internal/relay/feePayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feePayer.d.ts","sourceRoot":"","sources":["../../../../src/tempo/internal/relay/feePayer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAQ,KAAK,GAAG,EAA0B,MAAM,IAAI,CAAA;AAE3D,OAAO,KAAK,EAAE,KAAK,IAAI,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAGrE,OAAO,KAAK,KAAK,KAAK,MAAM,gBAAgB,CAAA;AAE5C,OAAO,KAAK,KAAK,kBAAkB,MAAM,6BAA6B,CAAA;AAItE,wBAAgB,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,OAAO,GAAG,KAAK,CAAC,MAAM,CAuNpE;AAED,8IAA8I;AAC9I,MAAM,MAAM,QAAQ,GAAG,CACrB,OAAO,EAAE,kBAAkB,CAAC,kBAAkB,GAAG;IAC/C,OAAO,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,SAAS,CAAA;CACvC,KACE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;AAErC,iFAAiF;AACjF,MAAM,MAAM,UAAU,GAClB,OAAO,GACP,kBAAkB,GAClB,kBAAkB,GAClB,uBAAuB,GACvB,sBAAsB,GACtB,uBAAuB,CAAA;AAE3B,oDAAoD;AACpD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,6FAA6F;IAC7F,UAAU,EAAE,OAAO,CAAA;CACpB,CAAA;AAwFD,mDAAmD;AACnD,wBAAsB,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO;;;;;;;;;;GA4C/C;AAED,MAAM,CAAC,OAAO,WAAW,IAAI,CAAC;IAC5B,KAAK,OAAO,GAAG;QACb,2CAA2C;QAC3C,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;QAChC,qCAAqC;QACrC,OAAO,EAAE,YAAY,CAAA;QACrB,uFAAuF;QACvF,WAAW,CAAC,EACR,CAAC,CACC,KAAK,EAAE,cAAc,KAClB,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,GACpE,SAAS,CAAA;QACb,kCAAkC;QAClC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QACpC,gDAAgD;QAChD,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;KAC7B,CAAA;CACF;AAgID,8EAA8E;AAC9E,MAAM,MAAM,cAAc,GAAG;IAC3B,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAA;IACf,sDAAsD;IACtD,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC9B,8EAA8E;IAC9E,MAAM,EACF,qBAAqB,GACrB,wBAAwB,GACxB,wBAAwB,GACxB,4BAA4B,CAAA;IAChC,0BAA0B;IAC1B,MAAM,EAAE,OAAO,CAAA;IACf,4EAA4E;IAC5E,WAAW,EAAE,GAAG,CAAC,GAAG,CAAA;IACpB,2EAA2E;IAC3E,WAAW,EAAE,GAAG,CAAC,GAAG,CAAA;IACpB,uHAAuH;IACvH,eAAe,CAAC,EAAE,GAAG,CAAC,GAAG,GAAG,SAAS,CAAA;CACtC,CAAA;AAED,yBAAiB,mBAAmB,CAAC;IACnC,KAAK,OAAO,GAAG;QACb,2EAA2E;QAC3E,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;KAClC,CAAA;IAED,gFAAgF;IAChF,MAAM,UAAU,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,OAAY,GAAG,MAAM,CA4BtE;;CA0GF"}