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

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

@@ -0,0 +1,442 @@
+import { Hash, RpcResponse, Signature } from 'ox';
+import { TxEnvelopeTempo } from 'ox/tempo';
+import { create as createClient } from '../../../core/Client.js';
+import { http } from '../../../core/transports/http.js';
+import * as Transaction from 'ox/tempo/TxEnvelopeTempo';
+import * as Request from './request.js';
+import * as Utils from './utils.js';
+export function create(options) {
+    // Bind signing permission to the middleware invocation and its validated payload.
+    const authorized = new WeakMap();
+    const allowedFeePayers = new Set(options.allowedFeePayers?.map((url) => ExternalFeePayerUrl.normalize(url, {
+        allowUnsafe: options.internal_allowUnsafeUrls,
+    })));
+    return {
+        async handleRequest(context, next) {
+            const { request } = context;
+            if (![
+                'eth_fillTransaction',
+                'eth_signRawTransaction',
+                'eth_sendRawTransaction',
+                'eth_sendRawTransactionSync',
+            ].includes(request.method))
+                return next();
+            const { client, getClient, options: requestOptions } = context;
+            const chainId = requestOptions.chainId;
+            const getTokens = (id) => context.resolveTokens(id);
+            const record = (details) => {
+                if (details && requestOptions.response)
+                    requestOptions.response.sponsorship_details = details;
+            };
+            if (request.method !== 'eth_fillTransaction') {
+                if (!options.account) {
+                    if (request.method === 'eth_signRawTransaction')
+                        throw new RpcResponse.MethodNotFoundError({
+                            message: 'eth_signRawTransaction requires a fee payer to be configured on the relay. Add `Relay.feePayer({ account })` to enable transaction sponsorship.',
+                        });
+                    return next();
+                }
+                const serialized = request.params?.[0];
+                if (typeof serialized !== 'string' ||
+                    !requestsRawSponsorship(serialized))
+                    return next();
+                const result = await handleRawTransaction({
+                    ...options,
+                    account: options.account,
+                    getClient,
+                    getFeeToken: async (id) => (await getTokens(id))[0],
+                    method: request.method,
+                    request,
+                });
+                record(result.sponsorshipDetails);
+                return result.result;
+            }
+            const parameters = request.params[0];
+            const { feePayer: _, ...normalized } = Utils.normalizeFillTransactionRequest(parameters);
+            const external = typeof parameters.feePayer === 'string'
+                ? ExternalFeePayerUrl.normalize(parameters.feePayer, {
+                    allowUnsafe: options.internal_allowUnsafeUrls ?? false,
+                })
+                : undefined;
+            if (external && !allowedFeePayers.has(external))
+                throw new RpcResponse.InvalidParamsError({
+                    message: 'External fee payer URL is not allowed.',
+                });
+            const wantsSponsorship = (!!options.account || !!external) && parameters.feePayer !== false;
+            if (options.account && !external)
+                delete normalized.feePayerSignature;
+            const base = { ...normalized, chainId };
+            if (!wantsSponsorship)
+                return Request.fill(client, base);
+            const token = options.feeToken ??
+                parameters.feeToken ??
+                (!options.validate || external
+                    ? (await getTokens(chainId))[0]
+                    : undefined);
+            const transaction = {
+                ...base,
+                feePayer: true,
+                ...(token ? { feeToken: token } : {}),
+            };
+            const prepared = isPreparedTransaction(transaction);
+            const fillClient = external
+                ? createClient({
+                    chain: client.chain,
+                    transport: http(external, {
+                        fetchOptions: { redirect: 'error' },
+                        retryCount: 0,
+                    }),
+                })
+                : client;
+            const result = prepared && !external
+                ? { tx: transaction }
+                : await Request.fill(fillClient, transaction, external ? { ...requestOptions, retryCount: 0 } : requestOptions);
+            const filled = Utils.normalizeTempoTransaction(result.tx);
+            // Reserve intrinsic gas for larger signatures before validating and signing the candidate.
+            if ((!prepared || parameters.feePayer !== true) &&
+                filled.gas &&
+                !filled.feePayerSignature)
+                filled.gas += 20000n;
+            if (token && (!external || filled.feeToken == null))
+                Object.assign(filled, { feeToken: token });
+            const sponsored = external ||
+                !options.validate ||
+                (await shouldSponsor({
+                    sender: parameters.from,
+                    transaction: filled,
+                    validate: options.validate,
+                }));
+            if (!sponsored)
+                return Request.fill(client, { ...base, feePayer: false });
+            const defer = typeof normalized.multisigSimulation === 'object' &&
+                normalized.multisigSimulation !== null;
+            const sponsor = sponsored
+                ? external
+                    ? (result.capabilities?.sponsor ?? result.sponsor)
+                    : options.account
+                        ? getSponsor({ ...options, account: options.account })
+                        : undefined
+                : undefined;
+            if (options.account && !external && !defer) {
+                delete filled.signature;
+                if (!filled.from)
+                    filled.from = parameters.from;
+                authorized.set(context, TxEnvelopeTempo.getFeePayerSignPayload(TxEnvelopeTempo.from(filled), { sender: filled.from }));
+            }
+            return {
+                ...result,
+                ...(sponsor ? { sponsor } : {}),
+                tx: Utils.formatTempoTransaction(filled),
+                capabilities: {
+                    ...result.capabilities,
+                    sponsored: external
+                        ? (result.capabilities?.sponsored ?? !!sponsor)
+                        : !!sponsor,
+                    ...(sponsor ? { sponsor } : {}),
+                },
+            };
+        },
+        async signTransaction(result, context) {
+            const approved = authorized.get(context);
+            authorized.delete(context);
+            const parameters = context.request.params[0];
+            if (!approved ||
+                !options.account ||
+                typeof parameters.feePayer === 'string' ||
+                parameters.feePayer === false ||
+                !result.capabilities?.sponsored ||
+                (typeof parameters.multisigSimulation === 'object' &&
+                    parameters.multisigSimulation !== null))
+                return undefined;
+            const transaction = Utils.normalizeTempoTransaction(result.tx);
+            const payload = TxEnvelopeTempo.getFeePayerSignPayload(TxEnvelopeTempo.from(transaction), { sender: (transaction.from ?? parameters.from) });
+            if (payload !== approved)
+                throw new RpcResponse.InvalidParamsError({
+                    message: 'Sponsored transaction changed after validation.',
+                });
+            const signed = await sign({
+                account: options.account,
+                onSponsored: options.onSponsored,
+                sender: parameters.from,
+                transaction,
+                signal: context.options.signal,
+            });
+            if (signed.sponsorshipDetails && context.options.response)
+                context.options.response.sponsorship_details = signed.sponsorshipDetails;
+            const tx = Utils.formatTempoTransaction(signed.transaction);
+            return tx.feePayerSignature;
+        },
+    };
+}
+/** Refusal messages keyed by named validation reason. */
+const refusalMessages = {
+    billing_past_due: 'Billing past due.',
+    billing_required: 'Billing required.',
+    fee_token_unsupported: 'Fee token unsupported.',
+    spend_limit_exceeded: 'Spend limit exceeded.',
+    tx_fee_limit_exceeded: 'Transaction fee limit exceeded.',
+};
+/** Returns sponsor metadata for `eth_fillTransaction` responses. */
+// biome-ignore lint/correctness/noUnusedVariables: declaration merge
+function getSponsor(options) {
+    const { account, name, url } = options;
+    return {
+        address: account.address,
+        ...(name ? { name } : {}),
+        ...(url ? { url } : {}),
+    };
+}
+/** Returns whether the fee payer approves a filled transaction. */
+// biome-ignore lint/correctness/noUnusedVariables: declaration merge
+async function shouldSponsor(options) {
+    const { sender, transaction, validate } = options;
+    if (!validate)
+        return true;
+    // Named refusal reasons collapse to false: fills fall back to an
+    // unsponsored fill instead of surfacing the reason.
+    const verdict = await validate({
+        ...transaction,
+        from: sender,
+    });
+    return verdict === true;
+}
+/** Returns whether a raw Tempo transaction is explicitly requesting sponsorship. */
+function requestsRawSponsorship(serialized) {
+    if (!Utils.isSerializedTempoTransaction(serialized))
+        return false;
+    const transaction = Transaction.deserialize(serialized);
+    return ('feePayerSignature' in transaction && transaction.feePayerSignature === null);
+}
+/** Returns `true` when a fill request already has the fields needed for sponsorship signing. */
+function isPreparedTransaction(value) {
+    return (typeof value.from === 'string' &&
+        typeof Utils.resolveChainId(value.chainId) === 'number' &&
+        typeof value.gas !== 'undefined' &&
+        typeof value.nonce !== 'undefined' &&
+        (typeof value.maxFeePerGas !== 'undefined' ||
+            typeof value.gasPrice !== 'undefined'));
+}
+/** Signs a filled transaction as the fee payer. */
+export async function sign(options) {
+    const { account, transaction, sender } = options;
+    const from = transaction.from ?? sender;
+    const { signature: _, ...withoutSenderSig } = transaction;
+    const prepared = { ...withoutSenderSig, from };
+    if (!prepared.from)
+        throw new RpcResponse.InvalidParamsError({
+            message: 'Transaction sender must be provided before fee payer signing.',
+        });
+    if (!account.sign)
+        throw new Error('Fee payer account cannot sign transactions.');
+    const chainId = Utils.resolveChainId(transaction.chainId);
+    if (chainId === undefined)
+        throw new RpcResponse.InvalidParamsError({
+            message: 'Transaction chainId must be provided before fee payer signing.',
+        });
+    const envelope = TxEnvelopeTempo.from(prepared);
+    const signPayload = TxEnvelopeTempo.getFeePayerSignPayload(envelope, {
+        sender: prepared.from,
+    });
+    options.signal?.throwIfAborted();
+    const feePayerSignature = Signature.from(await account.sign({ hash: signPayload }));
+    options.signal?.throwIfAborted();
+    // Record the commitment before releasing the signature, since the signed fill can be broadcast through another endpoint.
+    const feeToken = transaction.feeToken;
+    const sponsorshipDetails = await options.onSponsored?.({
+        chainId,
+        ...(feeToken ? { feeToken } : {}),
+        method: 'eth_fillTransaction',
+        sender: prepared.from,
+        signPayload,
+        transaction: TxEnvelopeTempo.serialize(envelope, { feePayerSignature }),
+    });
+    return {
+        ...(sponsorshipDetails ? { sponsorshipDetails } : {}),
+        transaction: { ...prepared, feePayerSignature },
+    };
+}
+/** Handles `eth_signRawTransaction` and broadcast methods for sponsored Tempo transactions. */
+// biome-ignore lint/correctness/noUnusedVariables: declaration merge
+async function handleRawTransaction(options) {
+    const { account, feeToken: sponsorFeeToken, getClient, method, request, validate, } = options;
+    const serialized = request.params?.[0];
+    if (!Utils.isSerializedTempoTransaction(serialized))
+        throw new RpcResponse.InvalidParamsError({
+            message: 'Only Tempo (0x76/0x78) transactions are supported.',
+        });
+    const transaction = Transaction.deserialize(serialized);
+    // Prefer sender recovered from raw envelope; multisig finalize path supplies fallback sender.
+    const sender = transaction.from ?? options.sender;
+    // Sponsorship only applies after sender has signed original transaction.
+    if (!transaction.signature || !sender)
+        throw new RpcResponse.InvalidParamsError({
+            message: 'Transaction must be signed by the sender before fee payer signing.',
+        });
+    if (!account.sign)
+        throw new Error('Fee payer account cannot sign transactions.');
+    const client = getClient(transaction.chainId);
+    const feeToken_chain = client.chain?.feeToken;
+    const feeToken = transaction.feeToken ??
+        sponsorFeeToken ??
+        (await options.getFeeToken?.(transaction.chainId)) ??
+        feeToken_chain;
+    const transaction_sponsored = feeToken
+        ? { ...transaction, feeToken }
+        : transaction;
+    if (validate) {
+        const verdict = await validate(transaction_sponsored);
+        if (verdict !== true)
+            throw new RpcResponse.InvalidParamsError(verdict === false
+                ? { message: 'Sponsorship rejected.' }
+                : { data: { code: verdict }, message: refusalMessages[verdict] });
+    }
+    const envelope = TxEnvelopeTempo.from(transaction_sponsored);
+    const signPayload = TxEnvelopeTempo.getFeePayerSignPayload(envelope, {
+        sender,
+    });
+    const feePayerSignature = Signature.from(await account.sign({ hash: signPayload }));
+    const serializedTransaction = TxEnvelopeTempo.serialize(envelope, {
+        feePayerSignature,
+        signature: transaction.signature,
+    });
+    // Awaited before any broadcast so a recording failure refuses sponsorship;
+    // no sponsored transaction ever reaches the chain unrecorded.
+    const sponsorshipDetails = await options.onSponsored?.({
+        chainId: transaction.chainId,
+        ...(feeToken ? { feeToken } : {}),
+        method,
+        sender,
+        signPayload,
+        transaction: serializedTransaction,
+        transactionHash: Hash.keccak256(serializedTransaction),
+    });
+    // Raw-sign requests stop after fee-payer signature is added; send methods broadcast it.
+    const result = method === 'eth_signRawTransaction'
+        ? serializedTransaction
+        : await client.request({
+            method: method,
+            params: [
+                serializedTransaction,
+                ...(request.params?.slice(1) ?? []),
+            ],
+        });
+    return { result, ...(sponsorshipDetails ? { sponsorshipDetails } : {}) };
+}
+export var ExternalFeePayerUrl;
+(function (ExternalFeePayerUrl) {
+    /** Normalizes external fee-payer relay URLs before forwarding fill payloads. */
+    function normalize(value, options = {}) {
+        let url;
+        try {
+            url = new URL(value);
+        }
+        catch {
+            throw new RpcResponse.InvalidParamsError({
+                message: 'Invalid fee payer URL.',
+            });
+        }
+        const allowUnsafe = options.allowUnsafe === true;
+        if (url.protocol !== 'http:' && url.protocol !== 'https:')
+            throw new RpcResponse.InvalidParamsError({
+                message: 'Invalid fee payer URL protocol.',
+            });
+        if (!allowUnsafe && url.protocol !== 'https:')
+            throw new RpcResponse.InvalidParamsError({
+                message: 'Invalid fee payer URL protocol.',
+            });
+        if (!allowUnsafe && isUnsafeHostname(url.hostname))
+            throw new RpcResponse.InvalidParamsError({
+                message: 'Invalid fee payer URL host.',
+            });
+        url.username = '';
+        url.password = '';
+        url.hash = '';
+        return url.href;
+    }
+    ExternalFeePayerUrl.normalize = normalize;
+    function isUnsafeHostname(hostname) {
+        const host = normalizeHostname(hostname);
+        if (host === 'localhost' || host.endsWith('.localhost'))
+            return true;
+        const ipv4 = parseIpv4(host);
+        if (ipv4)
+            return isUnsafeIpv4(ipv4);
+        if (!host.includes(':'))
+            return false;
+        const ipv6 = parseIpv6(host);
+        if (!ipv6)
+            return true;
+        return isUnsafeIpv6(ipv6);
+    }
+    function normalizeHostname(hostname) {
+        return hostname
+            .toLowerCase()
+            .replace(/^\[|\]$/g, '')
+            .split('%')[0];
+    }
+    function parseIpv4(value) {
+        const parts = value.split('.');
+        if (parts.length !== 4 || parts.some((part) => !/^\d+$/.test(part)))
+            return undefined;
+        const numbers = parts.map((part) => Number(part));
+        if (numbers.some((part) => !Number.isInteger(part) || part < 0 || part > 255))
+            return undefined;
+        return numbers;
+    }
+    function isUnsafeIpv4(parts) {
+        const [a, b] = parts;
+        if (a === 0 || a === 10 || a === 127)
+            return true;
+        if (a === 100 && b >= 64 && b <= 127)
+            return true;
+        if (a === 169 && b === 254)
+            return true;
+        if (a === 172 && b >= 16 && b <= 31)
+            return true;
+        if (a === 192 && b === 168)
+            return true;
+        return a >= 224;
+    }
+    function parseIpv6(value) {
+        const halves = value.split('::');
+        if (halves.length > 2)
+            return undefined;
+        const left = halves[0] ? halves[0].split(':') : [];
+        const right = halves[1] ? halves[1].split(':') : [];
+        const missing = halves.length === 2 ? 8 - left.length - right.length : 0;
+        if (missing < 0)
+            return undefined;
+        const parts = [...left, ...Array(missing).fill('0'), ...right];
+        if (parts.length !== 8)
+            return undefined;
+        const numbers = parts.map((part) => /^[\da-f]{1,4}$/i.test(part) ? Number.parseInt(part, 16) : NaN);
+        if (numbers.some((part) => !Number.isInteger(part) || part < 0 || part > 0xffff))
+            return undefined;
+        return numbers;
+    }
+    function isUnsafeIpv6(parts) {
+        const [a] = parts;
+        if (parts.every((part) => part === 0))
+            return true;
+        if (parts.slice(0, 7).every((part) => part === 0) && parts[7] === 1)
+            return true;
+        if ((a & 0xfe00) === 0xfc00)
+            return true;
+        if ((a & 0xffc0) === 0xfe80)
+            return true;
+        if ((a & 0xffc0) === 0xfec0)
+            return true;
+        if ((a & 0xff00) === 0xff00)
+            return true;
+        const ipv4 = ipv4FromIpv6(parts);
+        return ipv4 ? isUnsafeIpv4(ipv4) : false;
+    }
+    function ipv4FromIpv6(parts) {
+        const mapped = parts.slice(0, 5).every((part) => part === 0) && parts[5] === 0xffff;
+        const compatible = parts.slice(0, 6).every((part) => part === 0);
+        if (!mapped && !compatible)
+            return undefined;
+        return [parts[6] >> 8, parts[6] & 0xff, parts[7] >> 8, parts[7] & 0xff];
+    }
+})(ExternalFeePayerUrl || (ExternalFeePayerUrl = {}));
+//# sourceMappingURL=feePayer.js.map

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

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

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

@@ -0,0 +1,38 @@
+import type { Address } from 'abitype';
+import type { Client } from '../../../core/Client.js';
+import type * as Relay from '../../Relay.js';
+import * as Store from './cache.js';
+export declare function create(): Relay.Plugin;
+export declare function getDefaultTokens(chainId: number): Promise<readonly Address[]>;
+/** Resolves a funded fee-token candidate with fee AMM liquidity. @internal */
+export declare function resolveFeeToken(client: Client, options: resolveFeeToken.Options): Promise<{
+    feeToken: `0x${string}` | undefined;
+    virtualAddresses: Record<`0x${string}`, `0x${string}` | null> | undefined;
+}>;
+export declare namespace resolveFeeToken {
+    type Options = {
+        minimumBalance?: bigint | undefined;
+        exclude?: Address | undefined;
+        feeToken?: Address | undefined;
+        account?: Address | undefined;
+        tokens?: readonly Address[] | undefined;
+        targets?: readonly Address[] | undefined;
+    };
+}
+export declare function resolveTokenMetadata(client: Client, options: resolveTokenMetadata.Options): Promise<{
+    decimals: number;
+    symbol: string;
+    name: string;
+}>;
+export declare namespace resolveTokenMetadata {
+    type Options = {
+        token: Address;
+        tokenMetadata?: Record<Address, {
+            name: string;
+            symbol: string;
+            currency: string;
+        }> | undefined;
+        store?: Store.Store | undefined;
+    };
+}
+//# sourceMappingURL=feeToken.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"feeToken.d.ts","sourceRoot":"","sources":["../../../../src/tempo/internal/relay/feeToken.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEtC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAGrD,OAAO,KAAK,KAAK,KAAK,MAAM,gBAAgB,CAAA;AAC5C,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AAKnC,wBAAgB,MAAM,IAAI,KAAK,CAAC,MAAM,CA2DrC;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAK7B;AAED,8EAA8E;AAC9E,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,eAAe,CAAC,OAAO;;;GAkCjC;AAED,MAAM,CAAC,OAAO,WAAW,eAAe,CAAC;IACvC,KAAK,OAAO,GAAG;QACb,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QACnC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;QAC7B,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;QAC9B,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;QAC7B,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,CAAA;QACvC,OAAO,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,CAAA;KACzC,CAAA;CACF;AAyBD,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,oBAAoB,CAAC,OAAO;;;;GAuBtC;AAED,MAAM,CAAC,OAAO,WAAW,oBAAoB,CAAC;IAC5C,KAAK,OAAO,GAAG;QACb,KAAK,EAAE,OAAO,CAAA;QACd,aAAa,CAAC,EACV,MAAM,CAAC,OAAO,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAC,GACnE,SAAS,CAAA;QACb,KAAK,CAAC,EAAE,KAAK,CAAC,KAAK,GAAG,SAAS,CAAA;KAChC,CAAA;CACF"}

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

@@ -0,0 +1,143 @@
+import { RpcResponse } from 'ox';
+import { tokens as tokenSets } from '../../../tokens/sets.js';
+import * as Actions from '../../actions/index.js';
+import * as Store from './cache.js';
+import * as Preflight from './preflight.js';
+import * as Utils from './utils.js';
+import { extractCalls, getVirtualAddressTargets } from './virtualAddress.js';
+export function create() {
+    return {
+        async handleRequest(context, next) {
+            const { request } = context;
+            if (request.method !== 'eth_fillTransaction')
+                return next();
+            const parameters = request.params[0];
+            const transaction = Utils.normalizeFillTransactionRequest(parameters);
+            if (transaction.feeToken) {
+                context.request = {
+                    ...request,
+                    params: [
+                        Utils.formatFillTransactionRequest(context.client, transaction),
+                    ],
+                };
+                return next();
+            }
+            const tokens = await context.resolveTokens();
+            const candidates = [
+                ...tokens,
+                ...callTargetTokens(transaction).filter((token) => !tokens.some((candidate) => candidate.toLowerCase() === token.toLowerCase())),
+            ];
+            const resolved = transaction.feePayer
+                ? { feeToken: tokens[0], virtualAddresses: undefined }
+                : await resolveFeeToken(context.client, {
+                    account: transaction.from,
+                    feeToken: transaction.feeToken,
+                    targets: getVirtualAddressTargets(extractCalls(transaction)),
+                    tokens: candidates,
+                });
+            const { feeToken, virtualAddresses } = resolved;
+            const selected = { ...transaction, ...(feeToken ? { feeToken } : {}) };
+            context.request = {
+                ...request,
+                params: [Utils.formatFillTransactionRequest(context.client, selected)],
+            };
+            await next();
+            const result = context.result;
+            context.result = {
+                ...result,
+                // Unsigned sponsored estimates can omit the fee token selected by this plugin.
+                tx: {
+                    ...result.tx,
+                    ...(!result.tx.feeToken && feeToken ? { feeToken } : {}),
+                },
+                ...(virtualAddresses
+                    ? { capabilities: { ...result.capabilities, virtualAddresses } }
+                    : {}),
+            };
+        },
+    };
+}
+export async function getDefaultTokens(chainId) {
+    return tokenSets.tempo.flatMap((token) => {
+        const address = token.addresses[chainId];
+        return address ? [address] : [];
+    });
+}
+/** Resolves a funded fee-token candidate with fee AMM liquidity. @internal */
+export async function resolveFeeToken(client, options) {
+    const { feeToken, account, exclude, tokens } = options;
+    if (feeToken || !account)
+        return { feeToken, virtualAddresses: undefined };
+    const candidates = [
+        ...new Set(tokens?.map((token) => token.toLowerCase())),
+    ];
+    if (candidates.length > 100)
+        throw new RpcResponse.InvalidParamsError({
+            message: 'Fee-token candidates exceed the limit of 100 tokens.',
+        });
+    const { preferredToken, preferredBalance, balances, virtualAddresses } = await Preflight.read(client, {
+        account,
+        tokens: candidates,
+        targets: options.targets,
+    });
+    const minimumBalance = options.minimumBalance ?? 1n;
+    if (preferredToken.toLowerCase() !== exclude?.toLowerCase() &&
+        preferredBalance >= minimumBalance)
+        return { feeToken: preferredToken, virtualAddresses };
+    let best;
+    for (const asset of balances) {
+        if (asset.balance < minimumBalance ||
+            asset.address.toLowerCase() === exclude?.toLowerCase())
+            continue;
+        if (!best || asset.balance > best.balance)
+            best = asset;
+    }
+    return { feeToken: best?.address, virtualAddresses };
+}
+/** Includes call-target TIP20 tokens as fee candidates, allowing transfers to pay fees with the transferred token. */
+function callTargetTokens(transaction) {
+    const calls = transaction.calls;
+    if (!calls)
+        return [];
+    const out = [];
+    const seen = new Set();
+    for (const c of calls) {
+        if (!c.to)
+            continue;
+        const lower = c.to.toLowerCase();
+        if (!lower.startsWith('0x20c0'))
+            continue;
+        if (seen.has(lower))
+            continue;
+        seen.add(lower);
+        out.push(c.to);
+        if (out.length > 100)
+            throw new RpcResponse.InvalidParamsError({
+                message: 'Fee-token candidates exceed the limit of 100 tokens.',
+            });
+    }
+    return out;
+}
+export async function resolveTokenMetadata(client, options) {
+    const { token, tokenMetadata, store } = options;
+    const meta = tokenMetadata?.[token] ?? tokenMetadata?.[token.toLowerCase()];
+    // Tempo simulation metadata covers TIP-20 tokens, whose decimals are always six.
+    if (token.toLowerCase().startsWith('0x20c0') && meta)
+        return { decimals: 6, symbol: meta.symbol, name: meta.name };
+    // TIP-20 metadata (decimals/symbol/name) is immutable per token, so cache
+    // long-term. Skips the multicall RPC on cache hits.
+    const fetcher = () => Actions.token.getMetadata(client, { token });
+    const fallback = store
+        ? await Store.memoize(fetcher, {
+            key: `tokenMetadata:${client.chain?.id ?? 0}:${token.toLowerCase()}`,
+            store,
+            ttl: 24 * 60 * 60 * 1000,
+        })
+        : await fetcher();
+    return {
+        decimals: fallback.decimals ?? 6,
+        symbol: meta?.symbol || fallback.symbol,
+        name: meta?.name || fallback.name,
+    };
+}
+//# sourceMappingURL=feeToken.js.map