tapimo 0.0.2 → 0.1.0

package/dist/handlers/internal/types.d.ts

@@ -0,0 +1,284 @@
+/** Combines members of an intersection into a readable type. */
+export type Compute<type> = {
+    [key in keyof type]: type[key];
+} & unknown;
+declare const symbol: unique symbol;
+/**
+ * Creates a branded type of `T` with the brand `U`.
+ *
+ * @example
+ * ```ts
+ * type Result = Branded<string, 'foo'>
+ * //   ^? type Result = string & { [symbol]: 'foo' }
+ * ```
+ */
+export type Branded<T, U> = T & {
+    [symbol]: U;
+};
+/**
+ * Filters out all members of `T` that are not `P`
+ *
+ * @example
+ * ```ts
+ * type Result = Filter<['a', 'b', 'c'], 'b'>
+ * //   ^? type Result = ['a', 'c']
+ * ```
+ *
+ * @internal
+ */
+export type Filter<T extends readonly unknown[], P, Acc extends readonly unknown[] = []> = T extends readonly [infer F, ...infer Rest extends readonly unknown[]] ? [F] extends [P] ? Filter<Rest, P, [...Acc, F]> : Filter<Rest, P, Acc> : readonly [...Acc];
+/**
+ * Checks if `T` can be narrowed further than `U`
+ *
+ * @example
+ * ```ts
+ * type Result = IsNarrowable<'foo', string>
+ * //   ^? true
+ * ```
+ */
+export type IsNarrowable<T, U> = IsNever<(T extends U ? true : false) & (U extends T ? false : true)> extends true ? false : true;
+/**
+ * Checks if `T` is `never`
+ *
+ * @example
+ * ```ts
+ * type Result = IsNever<never>
+ * //   ^? type Result = true
+ * ```
+ */
+export type IsNever<T> = [T] extends [never] ? true : false;
+/**
+ * Removes `readonly` from all properties of an object.
+ *
+ * @internal
+ */
+export type Mutable<type extends object> = {
+    -readonly [key in keyof type]: type[key];
+};
+/**
+ * Evaluates boolean "or" condition for `T` properties.
+ *
+ * * @example
+ * ```ts
+ * type Result = Or<[false, true, false]>
+ * //   ^? type Result = true
+ * ```
+ *
+ * @example
+ * ```ts
+ * type Result = Or<[false, false, false]>
+ * //   ^? type Result = false
+ * ```
+ *
+ * @internal
+ */
+export type Or<T extends readonly unknown[]> = T extends readonly [infer Head, ...infer Tail] ? Head extends true ? true : Or<Tail> : false;
+/**
+ * Checks if `T` is `undefined`
+ *
+ * @example
+ * ```ts
+ * type Result = IsUndefined<undefined>
+ * //   ^? type Result = true
+ * ```
+ *
+ * @internal
+ */
+export type IsUndefined<T> = [undefined] extends [T] ? true : false;
+/**
+ * Checks if type `T` is the `unknown` type.
+ *
+ * @internal
+ */
+export type IsUnknown<T> = unknown extends T ? ([T] extends [null] ? false : true) : false;
+/** @internal */
+export type MaybePromise<T> = T | Promise<T>;
+/**
+ * Makes attributes on the type T required if required is true.
+ *
+ * @example
+ * ```ts
+ * MaybeRequired<{ a: string, b?: number }, true>
+ * // { a: string, b: number }
+ *
+ * MaybeRequired<{ a: string, b?: number }, false>
+ * // { a: string, b?: number }
+ * ```
+ *
+ * @internal
+ */
+export type MaybeRequired<T, required extends boolean> = required extends true ? ExactRequired<T> : T;
+/**
+ * Assigns the properties of U onto T.
+ *
+ * @example
+ * ```ts
+ * Assign<{ a: string, b: number }, { a: undefined, c: boolean }>
+ * // { a: undefined, b: number, c: boolean }
+ * ```
+ *
+ * @internal
+ */
+export type Assign<T, U> = Assign_inner<T, U> & U;
+/** @internal */
+export type Assign_inner<T, U> = {
+    [K in keyof T as K extends keyof U ? (U[K] extends void ? never : K) : K]: K extends keyof U ? U[K] : T[K];
+};
+/**
+ * Constructs a type by excluding `undefined` from `T`.
+ *
+ * @example
+ * ```ts
+ * NoUndefined<string | undefined>
+ * // string
+ * ```
+ *
+ * @internal
+ */
+export type NoUndefined<T> = T extends undefined ? never : T;
+/**
+ * Strict version of built-in Omit type
+ *
+ * @internal
+ */
+export type Omit<type, keys extends keyof type> = Pick<type, Exclude<keyof type, keys>>;
+/**
+ * Creates a type that is a partial of T, but with the required keys K.
+ *
+ * @example
+ * ```ts
+ * PartialBy<{ a: string, b: number }, 'a'>
+ * // { a?: string, b: number }
+ * ```
+ *
+ * @internal
+ */
+export type PartialBy<T, K extends keyof T> = Omit<T, K> & ExactPartial<Pick<T, K>>;
+export type RecursiveArray<T> = T | readonly RecursiveArray<T>[];
+/**
+ * Creates a type that is T with the required keys K.
+ *
+ * @example
+ * ```ts
+ * RequiredBy<{ a?: string, b: number }, 'a'>
+ * // { a: string, b: number }
+ * ```
+ *
+ * @internal
+ */
+export type RequiredBy<T, K extends keyof T> = Omit<T, K> & ExactRequired<Pick<T, K>>;
+/**
+ * Returns truthy if `array` contains `value`.
+ *
+ * @example
+ * ```ts
+ * Some<[1, 2, 3], 2>
+ * // true
+ * ```
+ *
+ * @internal
+ */
+export type Some<array extends readonly unknown[], value> = array extends readonly [
+    value,
+    ...unknown[]
+] ? true : array extends readonly [unknown, ...infer rest] ? Some<rest, value> : false;
+/**
+ * Prints custom error message
+ *
+ * @param messages - Error message
+ * @returns Custom error message
+ *
+ * @example
+ * ```ts
+ * type Result = TypeErrorMessage<'Custom error message'>
+ * //   ^? type Result = ['Error: Custom error message']
+ * ```
+ */
+export type TypeErrorMessage<messages extends string | string[]> = messages extends string ? [
+    `Error: ${messages}`
+] : {
+    [key in keyof messages]: messages[key] extends infer message extends string ? `Error: ${message}` : never;
+};
+/** @internal */
+export type UnionToTuple<union, last = LastInUnion<union>> = [union] extends [never] ? [] : [...UnionToTuple<Exclude<union, last>>, last];
+/** @internal */
+export type LastInUnion<U> = UnionToIntersection<U extends unknown ? (x: U) => 0 : never> extends (x: infer l) => 0 ? l : never;
+/** @internal */
+export type UnionToIntersection<union> = (union extends unknown ? (arg: union) => 0 : never) extends (arg: infer i) => 0 ? i : never;
+/** @internal */
+export type IsUnion<union, union2 = union> = union extends union2 ? ([union2] extends [union] ? false : true) : never;
+/** @internal */
+export type MaybePartial<type, enabled extends boolean | undefined> = enabled extends true ? Compute<ExactPartial<type>> : type;
+export type ExactPartial<type> = {
+    [key in keyof type]?: type[key] | undefined;
+};
+/** @internal */
+export type ExactRequired<type> = {
+    [key in keyof type]-?: Exclude<type[key], undefined>;
+};
+export type OneOf<union extends object, fallback extends object | undefined = undefined, keys extends KeyofUnion<union> = KeyofUnion<union>> = union extends infer item ? Compute<item & {
+    [key in Exclude<keys, keyof item>]?: fallback extends object ? key extends keyof fallback ? fallback[key] : undefined : undefined;
+}> : never;
+/** @internal */
+export type KeyofUnion<type> = type extends type ? keyof type : never;
+/** @internal */
+export type Undefined<type> = {
+    [key in keyof type]?: undefined;
+};
+/**
+ * Loose version of {@link Omit}
+ * @internal
+ */
+export type LooseOmit<type, keys extends string> = Pick<type, Exclude<keyof type, keys>>;
+/** @internal */
+export type UnionCompute<type> = type extends object ? Compute<type> : type;
+/** @internal */
+export type UnionLooseOmit<type, keys extends string> = type extends any ? LooseOmit<type, keys> : never;
+/**
+ * Construct a type with the properties of union type T except for those in type K.
+ * @example
+ * ```ts
+ * type Result = UnionOmit<{ a: string, b: number } | { a: string, b: undefined, c: number }, 'a'>
+ * // { b: number } | { b: undefined, c: number }
+ * ```
+ *
+ * @internal
+ */
+export type UnionOmit<type, keys extends keyof type> = type extends any ? Omit<type, keys> : never;
+/**
+ * Construct a type with the properties of union type T except for those in type K.
+ * @example
+ * ```ts
+ * type Result = UnionOmit<{ a: string, b: number } | { a: string, b: undefined, c: number }, 'a'>
+ * // { b: number } | { b: undefined, c: number }
+ * ```
+ *
+ * @internal
+ */
+export type UnionPick<type, keys extends keyof type> = type extends any ? Pick<type, keys> : never;
+/**
+ * Creates a type that is a partial of T, but with the required keys K.
+ *
+ * @example
+ * ```ts
+ * PartialBy<{ a: string, b: number } | { a: string, b: undefined, c: number }, 'a'>
+ * // { a?: string, b: number } | { a?: string, b: undefined, c: number }
+ * ```
+ *
+ * @internal
+ */
+export type UnionPartialBy<T, K extends keyof T> = T extends any ? PartialBy<T, K> : never;
+/**
+ * Creates a type that is T with the required keys K.
+ *
+ * @example
+ * ```ts
+ * RequiredBy<{ a?: string, b: number } | { a?: string, c?: number }, 'a'>
+ * // { a: string, b: number } | { a: string, c?: number }
+ * ```
+ *
+ * @internal
+ */
+export type UnionRequiredBy<T, K extends keyof T> = T extends any ? RequiredBy<T, K> : never;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/handlers/internal/types.d.ts.map

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

package/dist/handlers/internal/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/handlers/internal/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/handlers/internal/types.ts"],"names":[],"mappings":""}

package/dist/handlers/internal/utils.d.ts

@@ -0,0 +1,34 @@
+import { RpcRequest, RpcResponse } from 'ox';
+import { Transaction as core_Transaction } from 'ox/tempo';
+import { type Client } from 'viem';
+import * as z from 'zod/mini';
+export declare function resolveChainId(value: unknown): number | undefined;
+export declare function formatFillTransactionRequest(client: Client, value: Record<string, unknown>): Record<string, unknown>;
+export declare function normalizeFillTransactionRequest(tx: Record<string, unknown>): Record<string, unknown> & {
+    calls: unknown[];
+};
+/** Returns whether a raw transaction uses a Tempo sender or fee-payer wire prefix. */
+export declare function isSerializedTempoTransaction(value: unknown): value is `0x76${string}` | `0x78${string}`;
+export declare function normalizeTempoTransaction(value: Record<string, unknown> | undefined): core_Transaction.Transaction<false, bigint, number>;
+/** Returns a raw JSON-RPC error response object (not wrapped in a `Response`). */
+export declare function rpcErrorJson(request: RpcRequest.RpcRequest, error: unknown): {
+    readonly id: number;
+    readonly jsonrpc: '2.0';
+    readonly error: RpcResponse.InvalidParamsError;
+} | {
+    readonly id: number;
+    readonly jsonrpc: '2.0';
+    readonly error: RpcResponse.MethodNotSupportedError;
+} | {
+    readonly id: number;
+    readonly jsonrpc: '2.0';
+    readonly error: {
+        readonly code: number;
+        readonly message: string;
+        readonly data?: {};
+    };
+};
+export declare function rpcError(request: RpcRequest.RpcRequest, error: unknown): Response;
+export declare function rpcResult(request: RpcRequest.RpcRequest, result: unknown): Response;
+export declare const parseParams: z.ZodMiniReadonly<z.ZodMiniTuple<readonly [z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnknown>], null>>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/handlers/internal/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/handlers/internal/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,UAAU,EAAE,WAAW,EAAE,MAAM,IAAI,CAAA;AACjD,OAAO,EAAoB,WAAW,IAAI,gBAAgB,EAAmB,MAAM,UAAU,CAAA;AAC7F,OAAO,EAAE,KAAK,MAAM,EAAa,MAAM,MAAM,CAAA;AAC7C,OAAO,KAAK,CAAC,MAAM,UAAU,CAAA;AAE7B,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,sBAS5C;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,2BAI1F;AAED,wBAAgB,+BAA+B,CAC7C,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC1B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,KAAK,EAAE,OAAO,EAAE,CAAA;CAAE,CAmBhD;AAoBD,sFAAsF;AACtF,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,OAAO,MAAM,EAAE,GAAG,OAAO,MAAM,EAAE,CAO5C;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,uDAGnF;AAED,kFAAkF;AAClF,wBAAgB,YAAY,CAAC,OAAO,EAAE,UAAU,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO;;;;;;;;;;;;;;;;EA2B1E;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,YAEtE;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,YAExE;AAED,eAAO,MAAM,WAAW,gHAA2D,CAAA"}

package/dist/handlers/internal/utils.js

@@ -0,0 +1,131 @@
+import { Hex, RpcRequest, RpcResponse } from 'ox';
+import { KeyAuthorization, Transaction as core_Transaction, TxEnvelopeTempo } from 'ox/tempo';
+import { BaseError } from 'viem';
+import * as z from 'zod/mini';
+export function resolveChainId(value) {
+    if (typeof value === 'number')
+        return value;
+    if (typeof value === 'bigint')
+        return Number(value);
+    if (typeof value === 'string') {
+        if (Hex.validate(value))
+            return Hex.toNumber(value);
+        const n = Number(value);
+        if (Number.isFinite(n))
+            return n;
+    }
+    return undefined;
+}
+export function formatFillTransactionRequest(client, value) {
+    const format = client.chain?.formatters?.transactionRequest?.format;
+    if (!format)
+        return value;
+    return format({ ...value }, 'fillTransaction');
+}
+export function normalizeFillTransactionRequest(tx) {
+    const { to, data, value, ...rest } = tx;
+    const keyAuthorization = normalizeKeyAuthorization(tx['keyAuthorization']);
+    const withKeyAuthorization = keyAuthorization ? { keyAuthorization } : {};
+    if (Array.isArray(tx['calls']) && tx['calls'].length > 0)
+        return {
+            ...tx,
+            ...withKeyAuthorization,
+            calls: tx['calls'].map((call) => ({
+                ...call,
+                value: normalizeFillValue(call.value),
+            })),
+        };
+    const call = {
+        ...(typeof to !== 'undefined' ? { to } : {}),
+        ...(typeof data !== 'undefined' ? { data } : {}),
+        ...(typeof value !== 'undefined' ? { value: normalizeFillValue(value) } : {}),
+    };
+    return { ...rest, ...withKeyAuthorization, calls: [call] };
+}
+/**
+ * Forwards `keyAuthorization` to the chain in RPC shape. Pass-through
+ * when already RPC; convert via `KeyAuthorization.toRpc` when internal.
+ */
+function normalizeKeyAuthorization(value) {
+    if (!value || typeof value !== 'object')
+        return undefined;
+    const ka = value;
+    const signature = ka['signature'];
+    if (!signature || typeof signature !== 'object')
+        return undefined;
+    const isInternal = typeof signature['signature'] === 'object' && signature['signature'] !== null;
+    return isInternal ? KeyAuthorization.toRpc(value) : value;
+}
+function normalizeFillValue(value) {
+    if (typeof value !== 'string' || !value.startsWith('0x'))
+        return value;
+    return BigInt(value === '0x' ? '0x0' : value);
+}
+/** Returns whether a raw transaction uses a Tempo sender or fee-payer wire prefix. */
+export function isSerializedTempoTransaction(value) {
+    if (typeof value !== 'string')
+        return false;
+    // `0x78` is Tempo's fee-payer handoff magic, not a separate EIP-2718 type.
+    return (value.startsWith(TxEnvelopeTempo.serializedType) ||
+        value.startsWith(TxEnvelopeTempo.feePayerMagic));
+}
+export function normalizeTempoTransaction(value) {
+    if (!value)
+        throw new Error('Expected `tx` in eth_fillTransaction response.');
+    return core_Transaction.fromRpc({ type: '0x76', ...value });
+}
+/** Returns a raw JSON-RPC error response object (not wrapped in a `Response`). */
+export function rpcErrorJson(request, error) {
+    if (error instanceof RpcResponse.InvalidParamsError)
+        return RpcResponse.from({ error }, { request });
+    if (error instanceof RpcResponse.MethodNotSupportedError)
+        return RpcResponse.from({ error }, { request });
+    if (error.name === 'ZodError')
+        return RpcResponse.from({
+            error: new RpcResponse.InvalidParamsError({
+                message: error.message,
+            }),
+        }, { request });
+    const inner = resolveError(error);
+    const message = inner.message ?? error.message;
+    const code = inner.code ?? -32603;
+    const data = inner.data;
+    return RpcResponse.from({
+        error: { code, message, ...(data ? { data } : {}) },
+    }, { request });
+}
+export function rpcError(request, error) {
+    return Response.json(rpcErrorJson(request, error));
+}
+export function rpcResult(request, result) {
+    return Response.json(RpcResponse.from({ result }, { request }));
+}
+export const parseParams = z.readonly(z.tuple([z.record(z.string(), z.unknown())]));
+function resolveError(error) {
+    if (!error || typeof error !== 'object')
+        return {};
+    // Walk the `cause` chain to the deepest object that looks like an upstream
+    // JSON-RPC error (`{ code, message }`). This unwraps viem's
+    // `RpcRequestError`, whose own `message` is the verbose
+    // "RPC Request failed.\nURL: …\nRequest body: …" formatting, and surfaces
+    // the raw upstream error instead.
+    let deepest;
+    let current = error;
+    const seen = new Set();
+    while (current && typeof current === 'object' && !seen.has(current)) {
+        seen.add(current);
+        const e = current;
+        if (typeof e['code'] === 'number' && typeof e['message'] === 'string')
+            deepest = { code: e['code'], message: e['message'], data: e['data'] };
+        current = e['cause'];
+    }
+    if (deepest)
+        return deepest;
+    if (error instanceof BaseError) {
+        const inner = error.walk((e) => typeof e['code'] === 'number');
+        if (inner && typeof inner['code'] === 'number' && typeof inner['message'] === 'string')
+            return { message: inner['message'], code: inner['code'], data: inner['data'] };
+    }
+    return {};
+}
+//# sourceMappingURL=utils.js.map

package/dist/handlers/internal/utils.js.map

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

package/dist/handlers/relay.d.ts

@@ -0,0 +1,119 @@
+import { RpcRequest } from 'ox';
+import { type Address, type Client } from 'viem';
+import type { LocalAccount } from 'viem/accounts';
+import { Transaction } from 'viem/tempo';
+import { type Handler, from } from '../Handler.js';
+import * as Store from '../internal/Store.js';
+import * as Multisig from './internal/multisig.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 'tempo-api/server'
+ *
+ * const handler = Handler.relay({ getClient })
+ *
+ * // 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 'tempo-api/server'
+ *
+ * const handler = Handler.relay({
+ *   getClient,
+ *   feePayer: {
+ *     account: privateKeyToAccount('0x...'),
+ *   },
+ * })
+ * ```
+ *
+ * @param options - Options.
+ * @returns Request handler.
+ */
+export declare function relay(options: relay.Options): Handler;
+export declare namespace relay {
+    type Options = from.Options & {
+        /**
+         * Auto-swap options.
+         */
+        autoSwap?: false | {
+            /** Slippage tolerance (e.g. 0.05 = 5%). @default 0.05 */
+            slippage?: number | undefined;
+        } | undefined;
+        /**
+         * Resolves a viem client for a chain id. The handler resolves the client
+         * from the `chainId` in the incoming transaction (falling back to the
+         * client's default chain). Called with no argument for the default client.
+         */
+        getClient: (chainId?: number) => Client;
+        /**
+         * Fee payer / sponsor configuration. When provided, the relay will
+         * sign `feePayerSignature` on the filled transaction.
+         */
+        feePayer?: {
+            /** Account to use as the fee payer. */
+            account: LocalAccount;
+            /** Preferred fee token the sponsor wants to pay fees in. */
+            feeToken?: Address | 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;
+            /** Sponsor URL returned from `eth_fillTransaction`. */
+            url?: string | undefined;
+        } | undefined;
+        /**
+         * Native multisig configuration. When provided, the relay collects owner
+         * approvals from multisig raw transaction submissions and broadcasts once
+         * collected owner weight meets the configured threshold.
+         */
+        multisig?: Multisig.Options | undefined;
+        /**
+         * Relay features.
+         *
+         * - `'all'` — enables fee token resolution, auto-swap,
+         *   fee payer, and simulation (balance diffs + fee breakdown).
+         * - `undefined` (default) — only fee payers.
+         */
+        features?: 'all' | undefined;
+        /**
+         * Allows app-provided external fee payer URLs to use non-HTTPS protocols
+         * or local/private hosts. Intended only for trusted development setups.
+         * @default false
+         */
+        internal_allowUnsafeUrls?: boolean | undefined;
+        /**
+         * In-process cache backing TIP-20 metadata and user fee-token preference
+         * memoization. Omit to read upstream on every fill.
+         */
+        cache?: Store.Store | 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;
+        /**
+         * Resolves the known fee-token candidates for a chain. The relay checks
+         * the caller's balance for each candidate and picks the highest during
+         * fee-token resolution. Omit to disable fee-token resolution.
+         */
+        resolveTokens?: ((chainId: number) => readonly Address[] | Promise<readonly Address[]>) | undefined;
+    };
+}
+//# sourceMappingURL=relay.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"relay.d.ts","sourceRoot":"","sources":["../../src/handlers/relay.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,UAAU,EAAe,MAAM,IAAI,CAAA;AAE3D,OAAO,EACL,KAAK,OAAO,EAEZ,KAAK,MAAM,EASZ,MAAM,MAAM,CAAA;AACb,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAEjD,OAAO,EAA0C,WAAW,EAAkB,MAAM,YAAY,CAAA;AAIhG,OAAO,EAAE,KAAK,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,KAAK,KAAK,MAAM,sBAAsB,CAAA;AAC7C,OAAO,KAAK,QAAQ,MAAM,wBAAwB,CAAA;AAIlD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,GAAG,OAAO,CAsjBrD;AAED,yBAAiB,KAAK,CAAC;IACrB,KAAY,OAAO,GAAG,IAAI,CAAC,OAAO,GAAG;QACnC;;WAEG;QACH,QAAQ,CAAC,EACL,KAAK,GACL;YACE,yDAAyD;YACzD,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;SAC9B,GACD,SAAS,CAAA;QACb;;;;WAIG;QACH,SAAS,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;QACvC;;;WAGG;QACH,QAAQ,CAAC,EACL;YACE,uCAAuC;YACvC,OAAO,EAAE,YAAY,CAAA;YACrB,4DAA4D;YAC5D,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;YAC9B;;;eAGG;YACH,QAAQ,CAAC,EACL,CAAC,CAAC,OAAO,EAAE,WAAW,CAAC,kBAAkB,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,GACzE,SAAS,CAAA;YACb,gEAAgE;YAChE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;YACzB,uDAAuD;YACvD,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;SACzB,GACD,SAAS,CAAA;QACb;;;;WAIG;QACH,QAAQ,CAAC,EAAE,QAAQ,CAAC,OAAO,GAAG,SAAS,CAAA;QACvC;;;;;;WAMG;QACH,QAAQ,CAAC,EAAE,KAAK,GAAG,SAAS,CAAA;QAC5B;;;;WAIG;QACH,wBAAwB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;QAC9C;;;WAGG;QACH,KAAK,CAAC,EAAE,KAAK,CAAC,KAAK,GAAG,SAAS,CAAA;QAC/B,oDAAoD;QACpD,SAAS,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,UAAU,CAAC,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAA;QAC3E,gDAAgD;QAChD,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QACzB;;;;WAIG;QACH,aAAa,CAAC,EACV,CAAC,CAAC,OAAO,EAAE,MAAM,KAAK,SAAS,OAAO,EAAE,GAAG,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAAC,GACvE,SAAS,CAAA;KACd,CAAA;CACF"}