viem 3.0.0-next.12 → 3.0.0-next.13

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

@@ -0,0 +1,327 @@
+import { RpcResponse } from 'ox';
+import { tempo } from '../../../chains/index.js';
+import { create as createClient } from '../../../core/Client.js';
+import * as Transaction from 'ox/tempo/TxEnvelopeTempo';
+import * as Store from './cache.js';
+import * as Deadline from './deadline.js';
+import { formatError, isExecutionError } from './error.js';
+import { getDefaultTokens } from './feeToken.js';
+import * as Utils from './utils.js';
+import { extractCalls, getVirtualAddressTargets, resolveVirtualAddresses, } from './virtualAddress.js';
+/** Compose middleware and execute post-fill hooks once for the selected result. */
+export function compose(downstream, options = {}, resolveClient) {
+    const options_ = options;
+    const plugins = options.plugins ?? [];
+    if (plugins.length === 0)
+        return downstream;
+    if (plugins.filter((plugin) => plugin.signTransaction).length > 1)
+        throw new Error('Only one relay transaction signer may be configured.');
+    const handle = async (request, requestOptions = {}) => {
+        const stores = new Map();
+        const tokens = new Map();
+        const scoped = (store) => {
+            if (!store)
+                return undefined;
+            let result = stores.get(store);
+            if (!result) {
+                result = Store.scoped(store);
+                stores.set(store, result);
+            }
+            return result;
+        };
+        const execute = async (start, request, options) => {
+            const state = {
+                request,
+                options: { ...options },
+                result: undefined,
+            };
+            const contexts = new Map();
+            const contextAt = (index) => {
+                const existing = contexts.get(index);
+                if (existing)
+                    return existing;
+                const clients = new Map();
+                const chainId = (id = state.options.chainId) => {
+                    if (id === undefined || !Number.isSafeInteger(id) || id <= 0)
+                        throw new RpcResponse.InvalidParamsError({
+                            message: 'A chain ID is required to resolve the downstream client.',
+                        });
+                    return id;
+                };
+                const context = {
+                    get request() {
+                        return state.request;
+                    },
+                    set request(value) {
+                        state.request = value;
+                    },
+                    get result() {
+                        return state.result;
+                    },
+                    set result(value) {
+                        state.result = value;
+                    },
+                    get options() {
+                        return state.options;
+                    },
+                    set options(value) {
+                        state.options = value;
+                    },
+                    get client() {
+                        return context.getClient();
+                    },
+                    getClient(id_) {
+                        const id = chainId(id_);
+                        let client = clients.get(id);
+                        if (client)
+                            return client;
+                        const upstream = resolveClient?.(id);
+                        if (upstream?.chain && upstream.chain.id !== id)
+                            throw new RpcResponse.InvalidParamsError({
+                                message: 'Conflicting chain ids.',
+                            });
+                        client = createClient({
+                            chain: { ...tempo, ...upstream?.chain, id },
+                            batch: { multicall: { deployless: true } },
+                            transport: {
+                                key: 'relay-forward',
+                                name: 'Relay Forwarding',
+                                type: 'relay-forward',
+                                setup: () => ({
+                                    retryCount: 0,
+                                    request: (async (request, options) => {
+                                        const child = await execute(index + 1, request, {
+                                            ...state.options,
+                                            ...options,
+                                            chainId: id,
+                                        });
+                                        return child.state.result;
+                                    }),
+                                }),
+                            },
+                        });
+                        clients.set(id, client);
+                        return client;
+                    },
+                    async resolveTokens(id_) {
+                        const id = chainId(id_);
+                        let result = tokens.get(id);
+                        if (!result) {
+                            result = Promise.resolve().then(() => (options_.resolveTokens ?? getDefaultTokens)(id));
+                            tokens.set(id, result);
+                        }
+                        return result;
+                    },
+                    getStore: scoped,
+                };
+                contexts.set(index, context);
+                return context;
+            };
+            const dispatch = async (index) => {
+                if (index === plugins.length) {
+                    const parameters = state.request.params?.[0];
+                    // The node must estimate unsigned sponsorship independently of the sender's fee-token balance.
+                    const request = state.request.method === 'eth_fillTransaction' &&
+                        parameters?.feePayer === true &&
+                        !parameters.feePayerSignature
+                        ? {
+                            ...state.request,
+                            params: [{ ...parameters, feeToken: undefined }],
+                        }
+                        : state.request;
+                    requestOptions.signal?.throwIfAborted();
+                    state.result = await downstream(request, {
+                        ...state.options,
+                        ...(isFill ? { signal: requestOptions.signal } : {}),
+                    });
+                    return;
+                }
+                const plugin = plugins[index];
+                const context = contextAt(index);
+                if (!plugin.handleRequest)
+                    return dispatch(index + 1);
+                let called = false;
+                const result = await plugin.handleRequest(context, async () => {
+                    if (called)
+                        throw new Error('next() may only be called once per middleware invocation.');
+                    called = true;
+                    await dispatch(index + 1);
+                });
+                if (result !== undefined)
+                    state.result = result;
+            };
+            await dispatch(start);
+            return { state, contextAt };
+        };
+        const isFill = request.method === 'eth_fillTransaction';
+        const isRaw = [
+            'eth_signRawTransaction',
+            'eth_sendRawTransaction',
+            'eth_sendRawTransactionSync',
+        ].includes(request.method);
+        const parameters = request.params?.[0];
+        let root;
+        try {
+            requestOptions.signal?.throwIfAborted();
+            if (isFill &&
+                (!parameters ||
+                    typeof parameters !== 'object' ||
+                    Array.isArray(parameters)))
+                throw new RpcResponse.InvalidParamsError({
+                    message: 'Expected a transaction object.',
+                });
+            if (isFill)
+                Utils.normalizeFillTransactionRequest(parameters);
+            const bodyChainId = (() => {
+                if (isRaw && Utils.isSerializedTempoTransaction(request.params?.[0])) {
+                    try {
+                        return Transaction.deserialize(request.params[0]).chainId;
+                    }
+                    catch {
+                        throw new RpcResponse.InvalidParamsError({
+                            message: 'Invalid serialized Tempo transaction.',
+                        });
+                    }
+                }
+                if (!isFill || parameters.chainId === undefined)
+                    return undefined;
+                const id = Utils.resolveChainId(parameters.chainId);
+                if (id === undefined || !Number.isSafeInteger(id) || id <= 0)
+                    throw new RpcResponse.InvalidParamsError({
+                        message: 'Invalid transaction chain ID.',
+                    });
+                return id;
+            })();
+            if (bodyChainId !== undefined &&
+                requestOptions.chainId !== undefined &&
+                bodyChainId !== requestOptions.chainId)
+                throw new RpcResponse.InvalidParamsError({
+                    message: 'Conflicting chain ids.',
+                });
+            root = await execute(0, request, {
+                ...requestOptions,
+                ...((requestOptions.chainId ?? bodyChainId) !== undefined
+                    ? { chainId: requestOptions.chainId ?? bodyChainId }
+                    : {}),
+            });
+            if (!isFill)
+                return root.state.result;
+            const filled = root.state.result;
+            if (filled.capabilities?.error)
+                return filled;
+            const transaction = Utils.normalizeTempoTransaction(Utils.mergeCallsFromRequest(filled.tx, Utils.normalizeFillTransactionRequest(parameters)));
+            const final = {
+                ...filled,
+                tx: Utils.formatTempoTransaction(transaction),
+            };
+            const snapshot = freeze(structuredClone(final));
+            const targets = getVirtualAddressTargets(extractCalls(transaction));
+            const resolved = final.capabilities?.virtualAddresses;
+            const [patches, signatures, virtualAddresses] = await Promise.all([
+                Promise.all(plugins.map((plugin, index) => plugin.afterFill?.(snapshot, root.contextAt(index)))),
+                Promise.all(plugins.map((plugin, index) => plugin.signTransaction?.(snapshot, root.contextAt(index)))),
+                targets.length > 0 &&
+                    !targets.every((target) => resolved && target in resolved)
+                    ? resolveVirtualAddresses(root.contextAt(-1).client, {
+                        calls: extractCalls(transaction),
+                    }).catch(() => {
+                        requestOptions.signal?.throwIfAborted();
+                        return undefined;
+                    })
+                    : undefined,
+            ]);
+            requestOptions.signal?.throwIfAborted();
+            const capabilities = { ...final.capabilities };
+            const keys = new Set();
+            for (const patch of patches) {
+                for (const [key, value] of Object.entries(patch?.capabilities ?? {})) {
+                    if (keys.has(key))
+                        throw new Error(`Conflicting relay capability: ${key}.`);
+                    keys.add(key);
+                    capabilities[key] = value;
+                }
+            }
+            const signature = signatures.find((signature) => signature !== undefined);
+            if (signature) {
+                delete final.tx.signature;
+                final.tx.feePayerSignature = signature;
+            }
+            const sponsor = capabilities.sponsor ?? final.sponsor;
+            return {
+                ...final,
+                capabilities: {
+                    sponsored: !!sponsor,
+                    ...capabilities,
+                    ...(virtualAddresses ? { virtualAddresses } : {}),
+                },
+            };
+        }
+        catch (error) {
+            requestOptions.signal?.throwIfAborted();
+            if (isFill &&
+                isExecutionError(error) &&
+                parameters.capabilities
+                    ?.errors === true) {
+                // Resolve errors through a downstream-only client; never restart the plugin pipeline.
+                const id = requestOptions.chainId ?? Utils.resolveChainId(parameters.chainId);
+                const client = createClient({
+                    chain: { ...tempo, id: id ?? tempo.id },
+                    transport: {
+                        key: 'relay-error',
+                        name: 'Relay Error Enrichment',
+                        type: 'relay-error',
+                        setup: () => ({
+                            request: ((request, options) => downstream(request, {
+                                ...requestOptions,
+                                ...options,
+                                chainId: id,
+                                signal: requestOptions.signal,
+                            })),
+                        }),
+                    },
+                });
+                return formatError(error, parameters, client);
+            }
+            if (!isFill && !isRaw)
+                throw error;
+            throw Utils.toRpcError(error);
+        }
+    };
+    if (options.timeout !== undefined &&
+        (!Number.isSafeInteger(options.timeout) || options.timeout <= 0))
+        throw new RpcResponse.InvalidParamsError({
+            message: 'Expected a positive integer for timeout.',
+        });
+    if (options.timeout !== undefined && options.timeout > 2_147_483_647)
+        throw new RpcResponse.InvalidParamsError({
+            message: 'The fill timeout cannot exceed 2147483647 milliseconds.',
+        });
+    return (request, requestOptions = {}) => request.method === 'eth_fillTransaction'
+        ? Deadline.run(handle, request, requestOptions, options)
+        : handle(request, requestOptions);
+}
+/** Prevent hooks from mutating the transaction another hook signs. */
+function freeze(value) {
+    if (value && typeof value === 'object') {
+        for (const child of Object.values(value))
+            freeze(child);
+        Object.freeze(value);
+    }
+    return value;
+}
+/** Normalize a downstream fill without discarding capabilities added by other plugins. */
+export async function fill(client, transaction, options = {}) {
+    const formatted = Utils.formatFillTransactionRequest(client, transaction);
+    const result = (await client.request({
+        method: 'eth_fillTransaction',
+        params: [formatted],
+    }, options));
+    const error = result.capabilities?.error;
+    if (error) {
+        const cause = new Error(error.message ?? error.errorName ?? 'UpstreamRevert');
+        Object.assign(cause, { name: 'UpstreamRevertError', data: error.data });
+        throw cause;
+    }
+    return { ...result, tx: Utils.mergeCallsFromRequest(result.tx, transaction) };
+}
+//# sourceMappingURL=request.js.map

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

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

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

@@ -0,0 +1,62 @@
+import type { Address } from 'abitype';
+import type { Client } from '../../../core/Client.js';
+import type { Call } from 'ox/tempo/TxEnvelopeTempo';
+import type { Log } from 'ox/Log';
+import type * as Capabilities from '../../Capabilities.js';
+import type * as Relay from '../../Relay.js';
+import type * as Store from './cache.js';
+export declare function create(options: Relay.simulate.Options): Relay.Plugin;
+export declare function simulateAndParseDiffs(client: Client, options: simulateAndParseDiffs.Options): Promise<{
+    balanceDiffs: {
+        [x: string]: Capabilities.BalanceDiff[];
+    } | undefined;
+    fee: {
+        amount: `0x${string}`;
+        decimals: number;
+        formatted: string;
+        symbol: string;
+    } | undefined;
+    tokenMetadata: Record<string, {
+        name: string;
+        symbol: string;
+        currency: string;
+    }>;
+} | {
+    balanceDiffs: undefined;
+    fee: {
+        amount: `0x${string}`;
+        decimals: number;
+        formatted: string;
+        symbol: string;
+    } | undefined;
+    tokenMetadata: undefined;
+}>;
+export declare namespace simulateAndParseDiffs {
+    type Options = {
+        account?: Address | undefined;
+        calls: readonly Call[];
+        feeToken?: Address | undefined;
+        gas?: bigint | undefined;
+        store?: Store.Store | undefined;
+        signal?: AbortSignal | undefined;
+        maxFeePerGas?: bigint | undefined;
+    };
+}
+/** Builds a complete preview within the metadata lookup budget. @internal */
+export declare function buildBalanceDiffs(client: Client, options: buildBalanceDiffs.Options): Promise<{
+    [x: string]: Capabilities.BalanceDiff[];
+} | undefined>;
+export declare namespace buildBalanceDiffs {
+    type Options = {
+        account: Address;
+        store?: Store.Store | undefined;
+        signal?: AbortSignal | undefined;
+        logs: readonly Log<boolean>[];
+        tokenMetadata: Record<Address, {
+            name: string;
+            symbol: string;
+            currency: string;
+        }>;
+    };
+}
+//# sourceMappingURL=simulate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"simulate.d.ts","sourceRoot":"","sources":["../../../../src/tempo/internal/relay/simulate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAGtC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AACrD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAA;AACpD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAA;AAIjC,OAAO,KAAK,KAAK,YAAY,MAAM,uBAAuB,CAAA;AAC1D,OAAO,KAAK,KAAK,KAAK,MAAM,gBAAgB,CAAA;AAC5C,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAA;AAQxC,wBAAgB,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,OAAO,GAAG,KAAK,CAAC,MAAM,CAuDpE;AAED,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,qBAAqB,CAAC,OAAO;;;;;gBAqSA,KAAK,MAAM,EAAE;;;;;;cAlPpB,MAAM;gBAAU,MAAM;kBAAY,MAAM;;;;;;;;;;;GA4CxE;AAED,MAAM,CAAC,OAAO,WAAW,qBAAqB,CAAC;IAC7C,KAAK,OAAO,GAAG;QACb,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;QAC7B,KAAK,EAAE,SAAS,IAAI,EAAE,CAAA;QACtB,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;QAC9B,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QACxB,KAAK,CAAC,EAAE,KAAK,CAAC,KAAK,GAAG,SAAS,CAAA;QAC/B,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;QAChC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAClC,CAAA;CACF;AAED,6EAA6E;AAC7E,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,iBAAiB,CAAC,OAAO;;eAqJnC;AAED,MAAM,CAAC,OAAO,WAAW,iBAAiB,CAAC;IACzC,KAAK,OAAO,GAAG;QACb,OAAO,EAAE,OAAO,CAAA;QAChB,KAAK,CAAC,EAAE,KAAK,CAAC,KAAK,GAAG,SAAS,CAAA;QAC/B,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;QAChC,IAAI,EAAE,SAAS,GAAG,CAAC,OAAO,CAAC,EAAE,CAAA;QAC7B,aAAa,EAAE,MAAM,CACnB,OAAO,EACP;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,CACnD,CAAA;KACF,CAAA;CACF"}