accounts 0.6.1 → 0.6.2

package/dist/server/internal/handlers/codeAuth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codeAuth.d.ts","sourceRoot":"","sources":["../../../../src/server/internal/handlers/codeAuth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAU,SAAS,EAAE,MAAM,MAAM,CAAA;AAKpD,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,KAAK,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAErD;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,OAAO,GAAE,QAAQ,CAAC,OAAY,GAAG,OAAO,CAsGhE;AAED,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,KAAY,OAAO,GAAG,IAAI,CAAC,OAAO,GAAG;QACnC;;;;WAIG;QACH,MAAM,CAAC,EAAE,SAAS,CAAC,KAAK,EAAE,GAAG,KAAK,EAAE,CAAC,GAAG,SAAS,CAAA;QACjD,2CAA2C;QAC3C,GAAG,CAAC,EAAE,CAAC,MAAM,MAAM,CAAC,GAAG,SAAS,CAAA;QAChC,qEAAqE;QACrE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QACzB,qEAAqE;QACrE,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,GAAG,SAAS,CAAA;QACnC,6DAA6D;QAC7D,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,UAAU,CAAC,GAAG,SAAS,CAAA;QACnD,yBAAyB;QACzB,KAAK,CAAC,EAAE,OAAO,CAAC,KAAK,GAAG,SAAS,CAAA;QACjC,yEAAyE;QACzE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,SAAS,CAAA;QAClD,yDAAyD;QACzD,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAC3B,CAAA;CACF"}

package/dist/server/internal/handlers/codeAuth.js

@@ -0,0 +1,104 @@
+import { createClient, http } from 'viem';
+import { tempo, tempoModerato } from 'viem/chains';
+import * as z from 'zod/mini';
+import * as CliAuth from '../../CliAuth.js';
+import { from } from '../../Handler.js';
+/**
+ * Instantiates a generic device-code handler for access-key bootstrap.
+ *
+ * Exposes 4 endpoints:
+ * - `GET /auth/pkce/pending/:code`
+ * - `POST /auth/pkce/code`
+ * - `POST /auth/pkce/poll/:code`
+ * - `POST /auth/pkce`
+ *
+ * @param options - Options.
+ * @returns Request handler.
+ */
+export function codeAuth(options = {}) {
+    const { chains = [tempo, tempoModerato], now, path = '/auth/pkce', policy, random, store = CliAuth.Store.memory(), transports = {}, ttlMs, ...rest } = options;
+    const clients = new Map();
+    for (const chain of chains) {
+        const transport = transports[chain.id] ?? http();
+        clients.set(chain.id, createClient({ chain, transport }));
+    }
+    function getClient(chainId) {
+        if (typeof chainId !== 'undefined') {
+            const id = Number(chainId);
+            const client = clients.get(id);
+            if (!client)
+                throw new Error(`Chain ${id} not configured`);
+            return client;
+        }
+        return clients.get(chains[0].id);
+    }
+    const router = from(rest);
+    router.get(`${path}/pending/:code`, async (c) => {
+        try {
+            const code = c.req.param('code');
+            const result = await CliAuth.pending({
+                code,
+                ...(now ? { now } : {}),
+                store,
+            });
+            return Response.json(z.encode(CliAuth.pendingResponse, result));
+        }
+        catch (error) {
+            const status = error instanceof CliAuth.PendingError ? error.status : 400;
+            return Response.json({ error: error.message }, { status });
+        }
+    });
+    router.post(`${path}/code`, async (c) => {
+        try {
+            const request = z.decode(CliAuth.createRequest, await c.req.raw.json());
+            const chainId = request.chainId ?? chains[0].id;
+            getClient(chainId);
+            const result = await CliAuth.createDeviceCode({
+                chainId,
+                ...(now ? { now } : {}),
+                ...(policy ? { policy } : {}),
+                ...(random ? { random } : {}),
+                request,
+                store,
+                ...(typeof ttlMs !== 'undefined' ? { ttlMs } : {}),
+            });
+            return Response.json(z.encode(CliAuth.createResponse, result));
+        }
+        catch (error) {
+            return Response.json({ error: error.message }, { status: 400 });
+        }
+    });
+    router.post(`${path}/poll/:code`, async (c) => {
+        try {
+            const request = z.decode(CliAuth.pollRequest, await c.req.raw.json());
+            const code = c.req.param('code');
+            const result = await CliAuth.poll({
+                code,
+                ...(now ? { now } : {}),
+                request,
+                store,
+            });
+            return Response.json(z.encode(CliAuth.pollResponse, result));
+        }
+        catch (error) {
+            return Response.json({ error: error.message }, { status: 400 });
+        }
+    });
+    router.post(path, async (c) => {
+        try {
+            const request = z.decode(CliAuth.authorizeRequest, await c.req.raw.json());
+            const result = await CliAuth.authorize({
+                client: getClient(request.keyAuthorization.chainId),
+                ...(now ? { now } : {}),
+                request,
+                store,
+            });
+            return Response.json(z.encode(CliAuth.authorizeResponse, result));
+        }
+        catch (error) {
+            return Response.json({ error: error.message }, { status: 400 });
+        }
+    });
+    return router;
+}
+//# sourceMappingURL=codeAuth.js.map

package/dist/server/internal/handlers/codeAuth.js.map

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

package/dist/server/internal/handlers/feePayer.d.ts

@@ -0,0 +1,73 @@
+import { RpcRequest } from 'ox';
+import type { Chain, Transport } from 'viem';
+import type { LocalAccount } from 'viem/accounts';
+import { Transaction } from 'viem/tempo';
+import { type Handler, from } from '../../Handler.js';
+/**
+ * Instantiates a fee payer service request handler that can be used to
+ * sponsor the fee for user transactions.
+ *
+ * @example
+ * ```ts
+ * import { privateKeyToAccount } from 'viem/accounts'
+ * import { Handler } from 'accounts/server'
+ *
+ * const handler = Handler.feePayer({
+ *   account: privateKeyToAccount('0x...'),
+ * })
+ *
+ * // Plug handler into your server framework of choice:
+ * createServer(handler.listener)              // Node.js
+ * Bun.serve(handler)                          // Bun
+ * Deno.serve(handler)                         // Deno
+ * app.use(handler.listener)                   // Express
+ * app.all('*', c => handler.fetch(c.req.raw)) // Hono
+ * export const GET = handler.fetch            // Next.js
+ * export const POST = handler.fetch           // Next.js
+ * ```
+ *
+ * @param options - Options.
+ * @returns Request handler.
+ */
+export declare function feePayer(options: feePayer.Options): Handler;
+export declare namespace feePayer {
+    type Options = from.Options & {
+        /** Account to use as the fee payer. */
+        account: LocalAccount;
+        /**
+         * Supported chains. The handler resolves the client based on the
+         * `chainId` in the incoming transaction.
+         * @default [tempo, tempoModerato]
+         */
+        chains?: readonly [Chain, ...Chain[]] | undefined;
+        /** Function to call before handling the request. */
+        onRequest?: (request: RpcRequest.RpcRequest) => Promise<void>;
+        /** Path to use for the handler. */
+        path?: string | undefined;
+        /**
+         * Validates whether to sponsor the transaction. When omitted, all
+         * transactions are sponsored. Return `false` to reject sponsorship.
+         */
+        validate?: ((request: Transaction.TransactionRequest) => boolean | Promise<boolean>) | undefined;
+        /** Sponsor display name returned from `eth_fillTransaction`. */
+        name?: string | undefined;
+        /** Transports keyed by chain ID. Defaults to `http()` for each chain. */
+        transports?: Record<number, Transport> | undefined;
+        /** Sponsor URL returned from `eth_fillTransaction`. */
+        url?: string | undefined;
+    };
+}
+/** Signs a filled transaction as the fee payer. */
+export declare function sign(options: {
+    account: LocalAccount;
+    transaction: Record<string, unknown>;
+    sender?: `0x${string}` | undefined;
+}): Promise<{
+    feePayerSignature: {
+        r: bigint;
+        s: bigint;
+        yParity: number;
+    };
+    from: `0x${string}` | undefined;
+}>;
+//# sourceMappingURL=feePayer.d.ts.map

package/dist/server/internal/handlers/feePayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feePayer.d.ts","sourceRoot":"","sources":["../../../../src/server/internal/handlers/feePayer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA0B,MAAM,IAAI,CAAA;AAEvD,OAAO,KAAK,EAAW,KAAK,EAAU,SAAS,EAAE,MAAM,MAAM,CAAA;AAE7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAGjD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAExC,OAAO,EAAE,KAAK,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAGrD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,GAAG,OAAO,CA+J3D;AAED,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,KAAK,OAAO,GAAG,IAAI,CAAC,OAAO,GAAG;QAC5B,uCAAuC;QACvC,OAAO,EAAE,YAAY,CAAA;QACrB;;;;WAIG;QACH,MAAM,CAAC,EAAE,SAAS,CAAC,KAAK,EAAE,GAAG,KAAK,EAAE,CAAC,GAAG,SAAS,CAAA;QACjD,oDAAoD;QACpD,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;QAC7D,mCAAmC;QACnC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QACzB;;;WAGG;QACH,QAAQ,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,WAAW,CAAC,kBAAkB,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,SAAS,CAAA;QAChG,gEAAgE;QAChE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QACzB,yEAAyE;QACzE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,SAAS,CAAA;QAClD,uDAAuD;QACvD,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KACzB,CAAA;CACF;AAED,mDAAmD;AACnD,wBAAsB,IAAI,CAAC,OAAO,EAAE;IAClC,OAAO,EAAE,YAAY,CAAA;IACrB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,MAAM,CAAC,EAAE,KAAK,MAAM,EAAE,GAAG,SAAS,CAAA;CACnC;;;;;;;GAqBA"}

package/dist/server/internal/handlers/feePayer.js

@@ -0,0 +1,184 @@
+import { RpcRequest, RpcResponse, Signature } from 'ox';
+import { Transaction as core_Transaction, TxEnvelopeTempo } from 'ox/tempo';
+import { createClient, http } from 'viem';
+import { signTransaction } from 'viem/actions';
+import { tempo, tempoModerato } from 'viem/chains';
+import { Transaction } from 'viem/tempo';
+import { from } from '../../Handler.js';
+import * as Utils from './utils.js';
+/**
+ * Instantiates a fee payer service request handler that can be used to
+ * sponsor the fee for user transactions.
+ *
+ * @example
+ * ```ts
+ * import { privateKeyToAccount } from 'viem/accounts'
+ * import { Handler } from 'accounts/server'
+ *
+ * const handler = Handler.feePayer({
+ *   account: privateKeyToAccount('0x...'),
+ * })
+ *
+ * // Plug handler into your server framework of choice:
+ * createServer(handler.listener)              // Node.js
+ * Bun.serve(handler)                          // Bun
+ * Deno.serve(handler)                         // Deno
+ * app.use(handler.listener)                   // Express
+ * app.all('*', c => handler.fetch(c.req.raw)) // Hono
+ * export const GET = handler.fetch            // Next.js
+ * export const POST = handler.fetch           // Next.js
+ * ```
+ *
+ * @param options - Options.
+ * @returns Request handler.
+ */
+export function feePayer(options) {
+    const { account, chains = [tempo, tempoModerato], name, onRequest, path = '/', validate, transports = {}, url, ...rest } = options;
+    const clients = new Map();
+    for (const chain of chains) {
+        const transport = transports[chain.id] ?? http();
+        clients.set(chain.id, createClient({ chain, transport }));
+    }
+    function getClient(chainId) {
+        if (chainId) {
+            const client = clients.get(chainId);
+            if (!client)
+                throw new Error(`Chain ${chainId} not configured`);
+            return client;
+        }
+        return clients.get(chains[0].id);
+    }
+    const sponsor = {
+        address: account.address,
+        ...(name ? { name } : {}),
+        ...(url ? { url } : {}),
+    };
+    const router = from(rest);
+    router.post(path, async (c) => {
+        const request = RpcRequest.from((await c.req.raw.json()));
+        try {
+            await onRequest?.(request);
+            const method = request.method;
+            if (method !== 'eth_fillTransaction' &&
+                method !== 'eth_signRawTransaction' &&
+                method !== 'eth_sendRawTransaction' &&
+                method !== 'eth_sendRawTransactionSync')
+                return Response.json(RpcResponse.from({
+                    error: new RpcResponse.MethodNotSupportedError({
+                        message: `Method not supported: ${request.method}`,
+                    }),
+                }, { request }));
+            if (method === 'eth_fillTransaction') {
+                const [parameters] = Utils.parseParams.parse(request.params);
+                const chainId = Utils.resolveChainId(parameters.chainId);
+                const client = getClient(chainId);
+                const normalized = Utils.normalizeFillTransactionRequest(parameters);
+                const sender = typeof parameters.from === 'string' ? parameters.from : undefined;
+                let transaction = await (async () => {
+                    if (isPreparedFeePayerTransaction(parameters))
+                        return Utils.normalizeTempoTransaction(parameters);
+                    const fillRequest = Utils.formatFillTransactionRequest(client, {
+                        ...normalized,
+                        ...(typeof chainId !== 'undefined' ? { chainId } : {}),
+                        feePayer: true,
+                    });
+                    const result = (await client.request({
+                        method: 'eth_fillTransaction',
+                        params: [fillRequest],
+                    }));
+                    return Utils.normalizeTempoTransaction(result.tx);
+                })();
+                if (validate &&
+                    // @ts-expect-error - TODO: Convert to `TransactionRequest` properly.
+                    !(await validate({
+                        ...transaction,
+                        from: sender,
+                    }))) {
+                    // Re-fill without feePayer so gas/nonce are correct for self-payment.
+                    const fillRequest = Utils.formatFillTransactionRequest(client, {
+                        ...normalized,
+                        ...(typeof chainId !== 'undefined' ? { chainId } : {}),
+                    });
+                    const result = (await client.request({
+                        method: 'eth_fillTransaction',
+                        params: [fillRequest],
+                    }));
+                    transaction = Utils.normalizeTempoTransaction(result.tx);
+                    return Utils.rpcResult(request, {
+                        tx: core_Transaction.toRpc(transaction),
+                    });
+                }
+                const signed = await sign({ account, transaction, sender });
+                return Utils.rpcResult(request, {
+                    sponsor,
+                    tx: core_Transaction.toRpc(signed),
+                });
+            }
+            const serialized = request.params?.[0];
+            if (!serialized?.startsWith('0x76') && !serialized?.startsWith('0x78'))
+                throw new RpcResponse.InvalidParamsError({
+                    message: 'Only Tempo (0x76/0x78) transactions are supported.',
+                });
+            const transaction = Transaction.deserialize(serialized);
+            if (!transaction.signature || !transaction.from)
+                throw new RpcResponse.InvalidParamsError({
+                    message: 'Transaction must be signed by the sender before fee payer signing.',
+                });
+            if (validate && !(await validate(transaction)))
+                throw new RpcResponse.InvalidParamsError({
+                    message: 'Sponsorship rejected.',
+                });
+            const client = getClient(transaction.chainId);
+            const serializedTransaction = toSerializedTransaction(await signTransaction(client, {
+                ...transaction,
+                account,
+                feePayer: account,
+            }));
+            if (method === 'eth_signRawTransaction')
+                return Response.json(RpcResponse.from({ result: serializedTransaction }, { request }));
+            const result = await client.request({
+                method: method,
+                params: [serializedTransaction],
+            });
+            return Response.json(RpcResponse.from({ result }, { request }));
+        }
+        catch (error) {
+            return Utils.rpcError(request, error);
+        }
+    });
+    return router;
+}
+/** 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 feePayerSignature = Signature.from(await account.sign({
+        hash: TxEnvelopeTempo.getFeePayerSignPayload(TxEnvelopeTempo.from(prepared), {
+            sender: prepared.from,
+        }),
+    }));
+    return { ...prepared, feePayerSignature };
+}
+function isPreparedFeePayerTransaction(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'));
+}
+function toSerializedTransaction(value) {
+    if (typeof value === 'string')
+        return value;
+    if (value && typeof value === 'object' && 'raw' in value && typeof value.raw === 'string')
+        return value.raw;
+    throw new Error('Expected a serialized transaction result.');
+}
+//# sourceMappingURL=feePayer.js.map

package/dist/server/internal/handlers/feePayer.js.map

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

package/dist/server/internal/handlers/relay.d.ts

@@ -0,0 +1,148 @@
+import { Hex, RpcRequest } from 'ox';
+import { type Address, type Chain, type Transport } from 'viem';
+import { type Handler, from } from '../../Handler.js';
+import * as FeePayer from './feePayer.js';
+/**
+ * Instantiates a relay handler that proxies `eth_fillTransaction`
+ * with wallet-aware enrichment (fee token resolution, simulation,
+ * sponsorship, AMM resolution).
+ *
+ * @example
+ * ```ts
+ * import { Handler } from 'accounts/server'
+ *
+ * const handler = Handler.relay()
+ *
+ * // Plug handler into your server framework of choice:
+ * createServer(handler.listener)              // Node.js
+ * Bun.serve(handler)                          // Bun
+ * Deno.serve(handler)                         // Deno
+ * app.use(handler.listener)                   // Express
+ * app.all('*', c => handler.fetch(c.req.raw)) // Hono
+ * export const GET = handler.fetch            // Next.js
+ * export const POST = handler.fetch           // Next.js
+ * ```
+ *
+ * @example
+ * With sponsorship
+ *
+ * ```ts
+ * import { privateKeyToAccount } from 'viem/accounts'
+ * import { Handler } from 'accounts/server'
+ *
+ * // With sponsorship — signs as fee payer when `validate` approves.
+ * const handler = Handler.relay({
+ *   feePayer: {
+ *     account: privateKeyToAccount('0x...'),
+ *     // Optional: validate sponsorship approval.
+ *     // validate: (request) => request.from !== BLOCKED_ADDRESS,
+ *   },
+ * })
+ * ```
+ *
+ * @param options - Options.
+ * @returns Request handler.
+ */
+export declare function relay(options?: relay.Options): Handler;
+export declare namespace relay {
+    /** Default token lists per chain ID for fee token resolution. */
+    const defaultTokens: {
+        readonly 4217: readonly ["0x20c0000000000000000000000000000000000000", "0x20c000000000000000000000b9537d11c60e8b50", "0x20c0000000000000000000001621e21f71cf12fb", "0x20c00000000000000000000014f22ca97301eb73", "0x20c0000000000000000000003554d28269e0f3c2", "0x20c0000000000000000000000520792dcccccccc", "0x20c0000000000000000000008ee4fcff88888888", "0x20c0000000000000000000005c0bac7cef389a11", "0x20c0000000000000000000007f7ba549dd0251b9", "0x20c000000000000000000000aeed2ec36a54d0e5", "0x20c0000000000000000000009a4a4b17e0dc6651", "0x20c000000000000000000000383a23bacb546ab9"];
+        readonly 42431: readonly ["0x20c0000000000000000000000000000000000000", "0x20c0000000000000000000000000000000000001", "0x20c0000000000000000000000000000000000002", "0x20c0000000000000000000000000000000000003", "0x20c0000000000000000000009e8d7eb59b783726", "0x20c000000000000000000000d72572838bbee59c"];
+        readonly 1337: readonly ["0x20c0000000000000000000000000000000000000", "0x20c0000000000000000000000000000000000001", "0x20c0000000000000000000000000000000000002", "0x20c0000000000000000000000000000000000003"];
+    };
+    type Options = from.Options & {
+        /**
+         * Supported chains. The handler resolves the client based on the
+         * `chainId` in the incoming transaction.
+         * @default [tempo, tempoModerato]
+         */
+        chains?: readonly [Chain, ...Chain[]] | undefined;
+        /**
+         * Fee payer / sponsor configuration. When provided, the relay will
+         * sign `feePayerSignature` on the filled transaction.
+         */
+        feePayer?: Omit<FeePayer.feePayer.Options, 'chains' | 'transports' | 'path' | 'onRequest'> | undefined;
+        /** AMM swap options for automatic InsufficientBalance resolution. */
+        feeSwap?: {
+            /** Slippage tolerance (e.g. 0.05 = 5%). @default 0.05 */
+            slippage?: number | undefined;
+        } | undefined;
+        /**
+         * Returns token addresses to check balances for during fee token resolution.
+         * The relay checks `balanceOf` for each token and picks the one with the
+         * highest balance.
+         */
+        resolveTokens?: ((chainId?: number | undefined) => readonly Address[]) | undefined;
+        /** Function to call before handling the request. */
+        onRequest?: ((request: RpcRequest.RpcRequest) => Promise<void>) | undefined;
+        /** Path to use for the handler. @default "/" */
+        path?: string | undefined;
+        /** Transports keyed by chain ID. Defaults to `http()` for each chain. */
+        transports?: Record<number, Transport> | undefined;
+    };
+    /** Metadata returned alongside the filled transaction. */
+    type Meta = {
+        /** Per-account balance diffs keyed by address. */
+        balanceDiffs?: Record<Address, readonly BalanceDiff[]> | undefined;
+        /** Fee estimate for the transaction. */
+        fee: {
+            amount: Hex.Hex;
+            decimals: number;
+            formatted: string;
+            symbol: string;
+        } | null;
+        /** Whether the transaction is sponsored by a fee payer. */
+        sponsored: boolean;
+        /** Sponsor details (when sponsored). */
+        sponsor?: {
+            address: Address;
+            name: string;
+            url: string;
+        } | undefined;
+        /** AMM swap injected by the relay to cover an InsufficientBalance. */
+        feeSwap?: {
+            /** Max input amount with slippage. */
+            maxIn: SwapAmount;
+            /** Deficit amount that triggered the swap. */
+            minOut: SwapAmount;
+            /** Slippage tolerance (e.g. 0.1 = 10%). */
+            slippage: number;
+        } | undefined;
+    };
+    /** Token amount in a fee swap. */
+    type SwapAmount = {
+        /** Token address. */
+        token: Address;
+        /** Amount (hex-encoded). */
+        value: Hex.Hex;
+        /** Human-readable formatted amount. */
+        formatted: string;
+        /** Token decimals. */
+        decimals: number;
+        /** Token symbol (e.g. "USDC.e"). */
+        symbol: string;
+        /** Token name (e.g. "USDC.e"). */
+        name: string;
+    };
+    /** Balance diff for a single token relative to the user account. */
+    type BalanceDiff = {
+        /** Token address. */
+        address: Address;
+        /** Token decimals (e.g. 6). */
+        decimals: number;
+        /** Direction relative to the user. */
+        direction: 'incoming' | 'outgoing';
+        /** Human-readable formatted currency value (e.g. "100.00"). */
+        formatted: string;
+        /** Token name (e.g. "USDC.e"). */
+        name: string;
+        /** Addresses receiving this asset. */
+        recipients: readonly Address[];
+        /** Token symbol (e.g. "USDC.e"). */
+        symbol: string;
+        /** Token amount (hex-encoded). */
+        value: Hex.Hex;
+    };
+}
+//# sourceMappingURL=relay.d.ts.map

package/dist/server/internal/handlers/relay.d.ts.map

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