tapimo 0.5.3 → 0.7.0

package/dist/apps/data/routes/receipts.d.ts

@@ -4,6 +4,8 @@ import * as z from 'zod/mini';
 import type * as App from '../../../App.js';
 import * as Response from '../../../internal/Response.js';
 import * as Schema from '../../../internal/Schema.js';
+import * as Transactions from './transactions.js';
+import * as Valuation from './valuation.js';
 /** Zod schemas owned by the receipt handlers. */
 export declare namespace schema {
     /** One event log emitted by a transaction (RPC format). */
@@ -56,31 +58,13 @@ export declare namespace schema {
             type: z.ZodMiniPipe<z.ZodMiniString<string>, z.ZodMiniTransform<`0x${string}`, string>>;
         }, z.core.$loose>;
     }
-    /**
-     * Metadata for a receipt: the verbatim JSON-RPC receipt (always present) plus
-     * resources embedded on demand via `include`.
-     */
+    /** Receipt metadata containing valuation provenance and the verbatim JSON-RPC receipt. */
     const ReceiptMeta: z.ZodMiniObject<{
-        feeToken: z.ZodMiniOptional<z.ZodMiniLazy<z.ZodMiniObject<{
-            address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
-            admin: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
-            currency: z.ZodMiniString<string>;
-            createdAt: z.ZodMiniOptional<z.ZodMiniISODateTime>;
-            decimals: z.ZodMiniNumber<number>;
-            holderCount: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
-            id: z.ZodMiniString<string>;
-            logoUri: z.ZodMiniOptional<z.ZodMiniString<string>>;
-            name: z.ZodMiniString<string>;
-            quoteToken: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
-            symbol: z.ZodMiniString<string>;
-            totalSupply: z.ZodMiniOptional<z.ZodMiniString<string>>;
-            transferStats: z.ZodMiniOptional<z.ZodMiniObject<{
-                count: z.ZodMiniNumber<number>;
-                firstAt: z.ZodMiniNullable<z.ZodMiniISODateTime>;
-                lastAt: z.ZodMiniNullable<z.ZodMiniISODateTime>;
-            }, z.core.$strip>>;
-            verified: z.ZodMiniBoolean<boolean>;
-        }, z.core.$strip>>>;
+        pricing: z.ZodMiniOptional<z.ZodMiniObject<{
+            asOf: z.ZodMiniISODateTime;
+            basis: z.ZodMiniLiteral<"nominal">;
+            source: z.ZodMiniString<string>;
+        }, z.core.$strip>>;
         rpc: z.ZodMiniObject<{
             blobGasPrice: z.ZodMiniOptional<z.ZodMiniTemplateLiteral<`0x${string}`>>;
             blobGasUsed: z.ZodMiniOptional<z.ZodMiniTemplateLiteral<`0x${string}`>>;
@@ -115,11 +99,21 @@ export declare namespace schema {
             type: z.ZodMiniPipe<z.ZodMiniString<string>, z.ZodMiniTransform<`0x${string}`, string>>;
         }, z.core.$loose>;
     }, z.core.$strip>;
+    /** The fee charged to the fee payer, carrying its value in the requested denomination. */
+    const FeeAmount: z.ZodMiniObject<{
+        baseUnits: z.ZodMiniString<string>;
+        currency: z.ZodMiniString<string>;
+        decimals: z.ZodMiniNumber<number>;
+        formatted: z.ZodMiniString<string>;
+        valuation: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniObject<{
+            amount: z.ZodMiniString<string>;
+            currency: z.ZodMiniString<string>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
     /**
      * A humanized transaction receipt: decoded `status`/`type`, plain-number gas
-     * and block fields, and decimal-string fee/price values. The raw event logs
-     * are surfaced verbatim under `logs`, and the full JSON-RPC receipt under
-     * `meta.rpc`.
+     * and block fields, a structured fee amount, and a decimal-string gas price.
+     * The raw event logs are surfaced under `logs`, and the RPC receipt under `meta.rpc`.
      */
     const Receipt: z.ZodMiniObject<{
         blockHash: z.ZodMiniNullable<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
@@ -127,9 +121,26 @@ export declare namespace schema {
         contractAddress: z.ZodMiniNullable<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
         cumulativeGasUsed: z.ZodMiniNumber<number>;
         effectiveGasPrice: z.ZodMiniString<string>;
-        feeAmount: z.ZodMiniString<string>;
+        feeAmount: z.ZodMiniObject<{
+            baseUnits: z.ZodMiniString<string>;
+            currency: z.ZodMiniString<string>;
+            decimals: z.ZodMiniNumber<number>;
+            formatted: z.ZodMiniString<string>;
+            valuation: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniObject<{
+                amount: z.ZodMiniString<string>;
+                currency: z.ZodMiniString<string>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>;
         feePayer: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
-        feeToken: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
+        feeToken: z.ZodMiniOptional<z.ZodMiniLazy<z.ZodMiniObject<{
+            address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+            currency: z.ZodMiniString<string>;
+            decimals: z.ZodMiniNumber<number>;
+            logoUri: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniString<string>>>;
+            name: z.ZodMiniString<string>;
+            symbol: z.ZodMiniString<string>;
+            verified: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
+        }, z.core.$strip>>>;
         gasUsed: z.ZodMiniNumber<number>;
         id: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
         logs: z.ZodMiniArray<z.ZodMiniObject<{
@@ -145,26 +156,11 @@ export declare namespace schema {
             transactionIndex: z.ZodMiniNullable<z.ZodMiniTemplateLiteral<`0x${string}`>>;
         }, z.core.$loose>>;
         meta: z.ZodMiniObject<{
-            feeToken: z.ZodMiniOptional<z.ZodMiniLazy<z.ZodMiniObject<{
-                address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
-                admin: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
-                currency: z.ZodMiniString<string>;
-                createdAt: z.ZodMiniOptional<z.ZodMiniISODateTime>;
-                decimals: z.ZodMiniNumber<number>;
-                holderCount: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
-                id: z.ZodMiniString<string>;
-                logoUri: z.ZodMiniOptional<z.ZodMiniString<string>>;
-                name: z.ZodMiniString<string>;
-                quoteToken: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
-                symbol: z.ZodMiniString<string>;
-                totalSupply: z.ZodMiniOptional<z.ZodMiniString<string>>;
-                transferStats: z.ZodMiniOptional<z.ZodMiniObject<{
-                    count: z.ZodMiniNumber<number>;
-                    firstAt: z.ZodMiniNullable<z.ZodMiniISODateTime>;
-                    lastAt: z.ZodMiniNullable<z.ZodMiniISODateTime>;
-                }, z.core.$strip>>;
-                verified: z.ZodMiniBoolean<boolean>;
-            }, z.core.$strip>>>;
+            pricing: z.ZodMiniOptional<z.ZodMiniObject<{
+                asOf: z.ZodMiniISODateTime;
+                basis: z.ZodMiniLiteral<"nominal">;
+                source: z.ZodMiniString<string>;
+            }, z.core.$strip>>;
             rpc: z.ZodMiniObject<{
                 blobGasPrice: z.ZodMiniOptional<z.ZodMiniTemplateLiteral<`0x${string}`>>;
                 blobGasUsed: z.ZodMiniOptional<z.ZodMiniTemplateLiteral<`0x${string}`>>;
@@ -224,17 +220,18 @@ export declare namespace schema {
         const Params: z.ZodMiniObject<{
             transactionHash: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
         }, z.core.$strip>;
-        /** Optional related resource that callers opt into via `include`. */
+        /** Optional curated token fields that callers opt into via `include`. */
         const Include: z.ZodMiniEnum<{
-            feeToken: "feeToken";
+            "feeToken.logoUri": "feeToken.logoUri";
+            "feeToken.verified": "feeToken.verified";
         }>;
         /**
          * Parses a comma-separated `include` query value into a list of optional
-         * resources to embed. Extra lookups (e.g. fee-token metadata) only run when
-         * explicitly requested, keeping the base receipt response fast.
+         * token fields to embed. Curated lookups only run when explicitly requested.
          */
         const includeQuery: z.ZodMiniPipe<z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniUnknown>, z.ZodMiniTransform<string[], unknown>>, z.ZodMiniArray<z.ZodMiniEnum<{
-            feeToken: "feeToken";
+            "feeToken.logoUri": "feeToken.logoUri";
+            "feeToken.verified": "feeToken.verified";
         }>>>;
         /** Query parameters for receipt requests. */
         const Query: z.ZodMiniObject<{
@@ -242,8 +239,10 @@ export declare namespace schema {
                 mainnet: "mainnet";
                 testnet: "testnet";
             }>, z.ZodMiniTransform<4217 | 42431, "mainnet" | "testnet">>, z.ZodMiniNumber<unknown>]>, z.ZodMiniNumber<number>>>;
+            denomination: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniString<string>, z.ZodMiniTransform<string, string>>>;
             include: z.ZodMiniPipe<z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniUnknown>, z.ZodMiniTransform<string[], unknown>>, z.ZodMiniArray<z.ZodMiniEnum<{
-                feeToken: "feeToken";
+                "feeToken.logoUri": "feeToken.logoUri";
+                "feeToken.verified": "feeToken.verified";
             }>>>;
         }, z.core.$strict>;
         /** A humanized receipt, with the verbatim JSON-RPC payload under `meta.rpc`. */
@@ -253,9 +252,26 @@ export declare namespace schema {
             contractAddress: z.ZodMiniNullable<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
             cumulativeGasUsed: z.ZodMiniNumber<number>;
             effectiveGasPrice: z.ZodMiniString<string>;
-            feeAmount: z.ZodMiniString<string>;
+            feeAmount: z.ZodMiniObject<{
+                baseUnits: z.ZodMiniString<string>;
+                currency: z.ZodMiniString<string>;
+                decimals: z.ZodMiniNumber<number>;
+                formatted: z.ZodMiniString<string>;
+                valuation: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniObject<{
+                    amount: z.ZodMiniString<string>;
+                    currency: z.ZodMiniString<string>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>;
             feePayer: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
-            feeToken: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
+            feeToken: z.ZodMiniOptional<z.ZodMiniLazy<z.ZodMiniObject<{
+                address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+                currency: z.ZodMiniString<string>;
+                decimals: z.ZodMiniNumber<number>;
+                logoUri: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniString<string>>>;
+                name: z.ZodMiniString<string>;
+                symbol: z.ZodMiniString<string>;
+                verified: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
+            }, z.core.$strip>>>;
             gasUsed: z.ZodMiniNumber<number>;
             id: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
             logs: z.ZodMiniArray<z.ZodMiniObject<{
@@ -271,26 +287,11 @@ export declare namespace schema {
                 transactionIndex: z.ZodMiniNullable<z.ZodMiniTemplateLiteral<`0x${string}`>>;
             }, z.core.$loose>>;
             meta: z.ZodMiniObject<{
-                feeToken: z.ZodMiniOptional<z.ZodMiniLazy<z.ZodMiniObject<{
-                    address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
-                    admin: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
-                    currency: z.ZodMiniString<string>;
-                    createdAt: z.ZodMiniOptional<z.ZodMiniISODateTime>;
-                    decimals: z.ZodMiniNumber<number>;
-                    holderCount: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
-                    id: z.ZodMiniString<string>;
-                    logoUri: z.ZodMiniOptional<z.ZodMiniString<string>>;
-                    name: z.ZodMiniString<string>;
-                    quoteToken: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
-                    symbol: z.ZodMiniString<string>;
-                    totalSupply: z.ZodMiniOptional<z.ZodMiniString<string>>;
-                    transferStats: z.ZodMiniOptional<z.ZodMiniObject<{
-                        count: z.ZodMiniNumber<number>;
-                        firstAt: z.ZodMiniNullable<z.ZodMiniISODateTime>;
-                        lastAt: z.ZodMiniNullable<z.ZodMiniISODateTime>;
-                    }, z.core.$strip>>;
-                    verified: z.ZodMiniBoolean<boolean>;
-                }, z.core.$strip>>>;
+                pricing: z.ZodMiniOptional<z.ZodMiniObject<{
+                    asOf: z.ZodMiniISODateTime;
+                    basis: z.ZodMiniLiteral<"nominal">;
+                    source: z.ZodMiniString<string>;
+                }, z.core.$strip>>;
                 rpc: z.ZodMiniObject<{
                     blobGasPrice: z.ZodMiniOptional<z.ZodMiniTemplateLiteral<`0x${string}`>>;
                     blobGasUsed: z.ZodMiniOptional<z.ZodMiniTemplateLiteral<`0x${string}`>>;
@@ -347,18 +348,16 @@ export declare namespace schema {
     }
     /** Schemas for the getReceipts (list) operation. */
     namespace getReceipts {
-        /**
-         * Optional resources for the receipt list: the per-row `feeToken` embed
-         * plus the response-wide capped `totalCount`. The detail route keeps its
-         * own `feeToken`-only {@link getReceipt.Include}.
-         */
+        /** Optional fee-token fields and response-wide count metadata. */
         const Include: z.ZodMiniEnum<{
-            feeToken: "feeToken";
+            "feeToken.logoUri": "feeToken.logoUri";
+            "feeToken.verified": "feeToken.verified";
             totalCount: "totalCount";
         }>;
         /** Parses the comma-separated `include` value for the receipt list. */
         const includeQuery: z.ZodMiniPipe<z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniUnknown>, z.ZodMiniTransform<string[], unknown>>, z.ZodMiniArray<z.ZodMiniEnum<{
-            feeToken: "feeToken";
+            "feeToken.logoUri": "feeToken.logoUri";
+            "feeToken.verified": "feeToken.verified";
             totalCount: "totalCount";
         }>>>;
         /** Query parameters for receipt list requests. */
@@ -371,10 +370,12 @@ export declare namespace schema {
                 testnet: "testnet";
             }>, z.ZodMiniTransform<4217 | 42431, "mainnet" | "testnet">>, z.ZodMiniNumber<unknown>]>, z.ZodMiniNumber<number>>>;
             cursor: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            denomination: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniString<string>, z.ZodMiniTransform<string, string>>>;
             feePayer: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
             feeToken: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
             include: z.ZodMiniPipe<z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniUnknown>, z.ZodMiniTransform<string[], unknown>>, z.ZodMiniArray<z.ZodMiniEnum<{
-                feeToken: "feeToken";
+                "feeToken.logoUri": "feeToken.logoUri";
+                "feeToken.verified": "feeToken.verified";
                 totalCount: "totalCount";
             }>>>;
             limit: z.ZodMiniDefault<z.ZodMiniNumber<unknown>>;
@@ -399,6 +400,16 @@ export declare namespace schema {
          * which stores neither the block hash nor the event logs, so those fields are
          * `null`/empty in the list `meta.rpc` payload.
          */
+        /** Page-level resources: opt-in counts plus valuation rate provenance. */
+        const Meta: z.ZodMiniObject<{
+            pricing: z.ZodMiniOptional<z.ZodMiniObject<{
+                asOf: z.ZodMiniISODateTime;
+                basis: z.ZodMiniLiteral<"nominal">;
+                source: z.ZodMiniString<string>;
+            }, z.core.$strip>>;
+            totalCount: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+            totalCountCapped: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
+        }, z.core.$strip>;
         const Response: z.ZodMiniObject<{
             data: z.ZodMiniArray<z.ZodMiniObject<{
                 blockHash: z.ZodMiniNullable<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
@@ -406,9 +417,26 @@ export declare namespace schema {
                 contractAddress: z.ZodMiniNullable<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
                 cumulativeGasUsed: z.ZodMiniNumber<number>;
                 effectiveGasPrice: z.ZodMiniString<string>;
-                feeAmount: z.ZodMiniString<string>;
+                feeAmount: z.ZodMiniObject<{
+                    baseUnits: z.ZodMiniString<string>;
+                    currency: z.ZodMiniString<string>;
+                    decimals: z.ZodMiniNumber<number>;
+                    formatted: z.ZodMiniString<string>;
+                    valuation: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniObject<{
+                        amount: z.ZodMiniString<string>;
+                        currency: z.ZodMiniString<string>;
+                    }, z.core.$strip>>>;
+                }, z.core.$strip>;
                 feePayer: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
-                feeToken: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
+                feeToken: z.ZodMiniOptional<z.ZodMiniLazy<z.ZodMiniObject<{
+                    address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+                    currency: z.ZodMiniString<string>;
+                    decimals: z.ZodMiniNumber<number>;
+                    logoUri: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniString<string>>>;
+                    name: z.ZodMiniString<string>;
+                    symbol: z.ZodMiniString<string>;
+                    verified: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
+                }, z.core.$strip>>>;
                 gasUsed: z.ZodMiniNumber<number>;
                 id: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
                 logs: z.ZodMiniArray<z.ZodMiniObject<{
@@ -424,26 +452,11 @@ export declare namespace schema {
                     transactionIndex: z.ZodMiniNullable<z.ZodMiniTemplateLiteral<`0x${string}`>>;
                 }, z.core.$loose>>;
                 meta: z.ZodMiniObject<{
-                    feeToken: z.ZodMiniOptional<z.ZodMiniLazy<z.ZodMiniObject<{
-                        address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
-                        admin: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
-                        currency: z.ZodMiniString<string>;
-                        createdAt: z.ZodMiniOptional<z.ZodMiniISODateTime>;
-                        decimals: z.ZodMiniNumber<number>;
-                        holderCount: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
-                        id: z.ZodMiniString<string>;
-                        logoUri: z.ZodMiniOptional<z.ZodMiniString<string>>;
-                        name: z.ZodMiniString<string>;
-                        quoteToken: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>>;
-                        symbol: z.ZodMiniString<string>;
-                        totalSupply: z.ZodMiniOptional<z.ZodMiniString<string>>;
-                        transferStats: z.ZodMiniOptional<z.ZodMiniObject<{
-                            count: z.ZodMiniNumber<number>;
-                            firstAt: z.ZodMiniNullable<z.ZodMiniISODateTime>;
-                            lastAt: z.ZodMiniNullable<z.ZodMiniISODateTime>;
-                        }, z.core.$strip>>;
-                        verified: z.ZodMiniBoolean<boolean>;
-                    }, z.core.$strip>>>;
+                    pricing: z.ZodMiniOptional<z.ZodMiniObject<{
+                        asOf: z.ZodMiniISODateTime;
+                        basis: z.ZodMiniLiteral<"nominal">;
+                        source: z.ZodMiniString<string>;
+                    }, z.core.$strip>>;
                     rpc: z.ZodMiniObject<{
                         blobGasPrice: z.ZodMiniOptional<z.ZodMiniTemplateLiteral<`0x${string}`>>;
                         blobGasUsed: z.ZodMiniOptional<z.ZodMiniTemplateLiteral<`0x${string}`>>;
@@ -498,15 +511,20 @@ export declare namespace schema {
                 }>>;
             }, z.core.$strip>>;
             meta: z.ZodMiniOptional<z.ZodMiniObject<{
-                totalCountCapped: z.ZodMiniBoolean<boolean>;
-                totalCount: z.ZodMiniNumber<number>;
+                pricing: z.ZodMiniOptional<z.ZodMiniObject<{
+                    asOf: z.ZodMiniISODateTime;
+                    basis: z.ZodMiniLiteral<"nominal">;
+                    source: z.ZodMiniString<string>;
+                }, z.core.$strip>>;
+                totalCount: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+                totalCountCapped: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
             }, z.core.$strip>>;
             nextCursor: z.ZodMiniNullable<z.ZodMiniString<string>>;
         }, z.core.$strip>;
     }
 }
 /** Creates receipt handlers. */
-export declare function receipts(): import("hono/hono-base").HonoBase<App.Environment, {
+export declare function receipts(options?: receipts.Options): import("hono/hono-base").HonoBase<App.Environment, {
     "/v1/transactions/receipts": {
         $get: {
             output: null;
@@ -519,37 +537,7 @@ export declare function receipts(): import("hono/hono-base").HonoBase<App.Enviro
                     'blockNumber.to'?: string | string[];
                     chainId?: string | string[];
                     cursor?: string | string[];
-                    feePayer?: string | string[];
-                    feeToken?: string | string[];
-                    include?: string | string[];
-                    limit?: string | string[];
-                    order?: string | string[];
-                    page?: string | string[];
-                    recipient?: string | string[];
-                    sender?: string | string[];
-                    status?: string | string[];
-                    'timestamp.from'?: string | string[];
-                    'timestamp.to'?: string | string[];
-                } | undefined;
-            };
-        } | {
-            output: {
-                error: {
-                    code: "upstream_error";
-                    details?: readonly Response.error.Detail[] | undefined;
-                    message: string;
-                };
-                requestId: string;
-            };
-            outputFormat: "json";
-            status: 502;
-            input: {
-                query?: {
-                    address?: string | string[];
-                    'blockNumber.from'?: string | string[];
-                    'blockNumber.to'?: string | string[];
-                    chainId?: string | string[];
-                    cursor?: string | string[];
+                    denomination?: string | string[];
                     feePayer?: string | string[];
                     feeToken?: string | string[];
                     include?: string | string[];
@@ -581,6 +569,7 @@ export declare function receipts(): import("hono/hono-base").HonoBase<App.Enviro
                     'blockNumber.to'?: string | string[];
                     chainId?: string | string[];
                     cursor?: string | string[];
+                    denomination?: string | string[];
                     feePayer?: string | string[];
                     feeToken?: string | string[];
                     include?: string | string[];
@@ -612,6 +601,7 @@ export declare function receipts(): import("hono/hono-base").HonoBase<App.Enviro
                     'blockNumber.to'?: string | string[];
                     chainId?: string | string[];
                     cursor?: string | string[];
+                    denomination?: string | string[];
                     feePayer?: string | string[];
                     feeToken?: string | string[];
                     include?: string | string[];
@@ -643,6 +633,7 @@ export declare function receipts(): import("hono/hono-base").HonoBase<App.Enviro
                     'blockNumber.to'?: string | string[];
                     chainId?: string | string[];
                     cursor?: string | string[];
+                    denomination?: string | string[];
                     feePayer?: string | string[];
                     feeToken?: string | string[];
                     include?: string | string[];
@@ -674,6 +665,7 @@ export declare function receipts(): import("hono/hono-base").HonoBase<App.Enviro
                     'blockNumber.to'?: string | string[];
                     chainId?: string | string[];
                     cursor?: string | string[];
+                    denomination?: string | string[];
                     feePayer?: string | string[];
                     feeToken?: string | string[];
                     include?: string | string[];
@@ -705,6 +697,7 @@ export declare function receipts(): import("hono/hono-base").HonoBase<App.Enviro
                     'blockNumber.to'?: string | string[];
                     chainId?: string | string[];
                     cursor?: string | string[];
+                    denomination?: string | string[];
                     feePayer?: string | string[];
                     feeToken?: string | string[];
                     include?: string | string[];
@@ -726,9 +719,26 @@ export declare function receipts(): import("hono/hono-base").HonoBase<App.Enviro
                     contractAddress: `0x${string}` | null;
                     cumulativeGasUsed: number;
                     effectiveGasPrice: string;
-                    feeAmount: string;
+                    feeAmount: {
+                        baseUnits: string;
+                        currency: string;
+                        decimals: number;
+                        formatted: string;
+                        valuation?: {
+                            amount: string;
+                            currency: string;
+                        } | null | undefined;
+                    };
                     feePayer?: `0x${string}` | undefined;
-                    feeToken?: `0x${string}` | undefined;
+                    feeToken?: {
+                        address: `0x${string}`;
+                        currency: string;
+                        decimals: number;
+                        logoUri?: string | undefined;
+                        name: string;
+                        symbol: string;
+                        verified?: boolean | undefined;
+                    } | undefined;
                     gasUsed: number;
                     id: `0x${string}`;
                     logs: {
@@ -745,25 +755,10 @@ export declare function receipts(): import("hono/hono-base").HonoBase<App.Enviro
                         transactionIndex: `0x${string}` | null;
                     }[];
                     meta: {
-                        feeToken?: {
-                            address: `0x${string}`;
-                            admin?: `0x${string}` | undefined;
-                            currency: string;
-                            createdAt?: string | undefined;
-                            decimals: number;
-                            holderCount?: number | undefined;
-                            id: string;
-                            logoUri?: string | undefined;
-                            name: string;
-                            quoteToken?: `0x${string}` | undefined;
-                            symbol: string;
-                            totalSupply?: string | undefined;
-                            transferStats?: {
-                                count: number;
-                                firstAt: string | null;
-                                lastAt: string | null;
-                            } | undefined;
-                            verified: boolean;
+                        pricing?: {
+                            asOf: string;
+                            basis: "nominal";
+                            source: string;
                         } | undefined;
                         rpc: {
                             [x: string]: import("hono/utils/types").JSONValue;
@@ -810,8 +805,13 @@ export declare function receipts(): import("hono/hono-base").HonoBase<App.Enviro
                     type: "eip1559" | "eip2930" | "eip4844" | "eip7702" | "legacy" | "tempo" | "unknown";
                 }[];
                 meta?: {
-                    totalCountCapped: boolean;
-                    totalCount: number;
+                    pricing?: {
+                        asOf: string;
+                        basis: "nominal";
+                        source: string;
+                    } | undefined;
+                    totalCount?: number | undefined;
+                    totalCountCapped?: boolean | undefined;
                 } | undefined;
                 nextCursor: string | null;
             };
@@ -824,6 +824,39 @@ export declare function receipts(): import("hono/hono-base").HonoBase<App.Enviro
                     'blockNumber.to'?: string | string[];
                     chainId?: string | string[];
                     cursor?: string | string[];
+                    denomination?: string | string[];
+                    feePayer?: string | string[];
+                    feeToken?: string | string[];
+                    include?: string | string[];
+                    limit?: string | string[];
+                    order?: string | string[];
+                    page?: string | string[];
+                    recipient?: string | string[];
+                    sender?: string | string[];
+                    status?: string | string[];
+                    'timestamp.from'?: string | string[];
+                    'timestamp.to'?: string | string[];
+                } | undefined;
+            };
+        } | {
+            output: {
+                error: {
+                    code: "upstream_error";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 502;
+            input: {
+                query?: {
+                    address?: string | string[];
+                    'blockNumber.from'?: string | string[];
+                    'blockNumber.to'?: string | string[];
+                    chainId?: string | string[];
+                    cursor?: string | string[];
+                    denomination?: string | string[];
                     feePayer?: string | string[];
                     feeToken?: string | string[];
                     include?: string | string[];
@@ -852,20 +885,21 @@ export declare function receipts(): import("hono/hono-base").HonoBase<App.Enviro
             } & {
                 query?: {
                     chainId?: string | string[];
+                    denomination?: string | string[];
                     include?: string | string[];
                 } | undefined;
             };
         } | {
             output: {
                 error: {
-                    code: "upstream_error";
+                    code: "api_key_malformed";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 502;
+            status: 400;
             input: {
                 param: {
                     transactionHash: `0x${string}`;
@@ -873,20 +907,21 @@ export declare function receipts(): import("hono/hono-base").HonoBase<App.Enviro
             } & {
                 query?: {
                     chainId?: string | string[];
+                    denomination?: string | string[];
                     include?: string | string[];
                 } | undefined;
             };
         } | {
             output: {
                 error: {
-                    code: "api_key_malformed";
+                    code: "api_key_invalid" | "api_key_missing";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 400;
+            status: 401;
             input: {
                 param: {
                     transactionHash: `0x${string}`;
@@ -894,20 +929,21 @@ export declare function receipts(): import("hono/hono-base").HonoBase<App.Enviro
             } & {
                 query?: {
                     chainId?: string | string[];
+                    denomination?: string | string[];
                     include?: string | string[];
                 } | undefined;
             };
         } | {
             output: {
                 error: {
-                    code: "api_key_invalid" | "api_key_missing";
+                    code: "api_key_forbidden";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 401;
+            status: 403;
             input: {
                 param: {
                     transactionHash: `0x${string}`;
@@ -915,20 +951,21 @@ export declare function receipts(): import("hono/hono-base").HonoBase<App.Enviro
             } & {
                 query?: {
                     chainId?: string | string[];
+                    denomination?: string | string[];
                     include?: string | string[];
                 } | undefined;
             };
         } | {
             output: {
                 error: {
-                    code: "api_key_forbidden";
+                    code: "payment_required" | "rate_limit_exceeded";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 403;
+            status: 429;
             input: {
                 param: {
                     transactionHash: `0x${string}`;
@@ -936,20 +973,21 @@ export declare function receipts(): import("hono/hono-base").HonoBase<App.Enviro
             } & {
                 query?: {
                     chainId?: string | string[];
+                    denomination?: string | string[];
                     include?: string | string[];
                 } | undefined;
             };
         } | {
             output: {
                 error: {
-                    code: "payment_required" | "rate_limit_exceeded";
+                    code: "query_invalid";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 429;
+            status: 400;
             input: {
                 param: {
                     transactionHash: `0x${string}`;
@@ -957,20 +995,21 @@ export declare function receipts(): import("hono/hono-base").HonoBase<App.Enviro
             } & {
                 query?: {
                     chainId?: string | string[];
+                    denomination?: string | string[];
                     include?: string | string[];
                 } | undefined;
             };
         } | {
             output: {
                 error: {
-                    code: "query_invalid";
+                    code: "upstream_error";
                     details?: readonly Response.error.Detail[] | undefined;
                     message: string;
                 };
                 requestId: string;
             };
             outputFormat: "json";
-            status: 400;
+            status: 502;
             input: {
                 param: {
                     transactionHash: `0x${string}`;
@@ -978,6 +1017,7 @@ export declare function receipts(): import("hono/hono-base").HonoBase<App.Enviro
             } & {
                 query?: {
                     chainId?: string | string[];
+                    denomination?: string | string[];
                     include?: string | string[];
                 } | undefined;
             };
@@ -999,6 +1039,7 @@ export declare function receipts(): import("hono/hono-base").HonoBase<App.Enviro
             } & {
                 query?: {
                     chainId?: string | string[];
+                    denomination?: string | string[];
                     include?: string | string[];
                 } | undefined;
             };
@@ -1020,6 +1061,7 @@ export declare function receipts(): import("hono/hono-base").HonoBase<App.Enviro
             } & {
                 query?: {
                     chainId?: string | string[];
+                    denomination?: string | string[];
                     include?: string | string[];
                 } | undefined;
             };
@@ -1030,9 +1072,26 @@ export declare function receipts(): import("hono/hono-base").HonoBase<App.Enviro
                 contractAddress: `0x${string}` | null;
                 cumulativeGasUsed: number;
                 effectiveGasPrice: string;
-                feeAmount: string;
+                feeAmount: {
+                    baseUnits: string;
+                    currency: string;
+                    decimals: number;
+                    formatted: string;
+                    valuation?: {
+                        amount: string;
+                        currency: string;
+                    } | null | undefined;
+                };
                 feePayer?: `0x${string}` | undefined;
-                feeToken?: `0x${string}` | undefined;
+                feeToken?: {
+                    address: `0x${string}`;
+                    currency: string;
+                    decimals: number;
+                    logoUri?: string | undefined;
+                    name: string;
+                    symbol: string;
+                    verified?: boolean | undefined;
+                } | undefined;
                 gasUsed: number;
                 id: `0x${string}`;
                 logs: {
@@ -1049,25 +1108,10 @@ export declare function receipts(): import("hono/hono-base").HonoBase<App.Enviro
                     transactionIndex: `0x${string}` | null;
                 }[];
                 meta: {
-                    feeToken?: {
-                        address: `0x${string}`;
-                        admin?: `0x${string}` | undefined;
-                        currency: string;
-                        createdAt?: string | undefined;
-                        decimals: number;
-                        holderCount?: number | undefined;
-                        id: string;
-                        logoUri?: string | undefined;
-                        name: string;
-                        quoteToken?: `0x${string}` | undefined;
-                        symbol: string;
-                        totalSupply?: string | undefined;
-                        transferStats?: {
-                            count: number;
-                            firstAt: string | null;
-                            lastAt: string | null;
-                        } | undefined;
-                        verified: boolean;
+                    pricing?: {
+                        asOf: string;
+                        basis: "nominal";
+                        source: string;
                     } | undefined;
                     rpc: {
                         [x: string]: import("hono/utils/types").JSONValue;
@@ -1122,26 +1166,50 @@ export declare function receipts(): import("hono/hono-base").HonoBase<App.Enviro
             } & {
                 query?: {
                     chainId?: string | string[];
+                    denomination?: string | string[];
                     include?: string | string[];
                 } | undefined;
             };
         };
     };
 }, "/", "/v1/transactions/:transactionHash/receipt">;
+export declare namespace receipts {
+    /** Options for the receipt handlers. */
+    type Options = {
+        /** FX configuration backing fee valuation. */
+        fx?: Valuation.addresses.Fx | undefined;
+    };
+}
 /**
- * Lists humanized receipts and embeds opt-in `include` resources (currently
- * `feeToken`).
+ * Lists humanized receipts with required fee-token metadata and optional curated fields.
  */
 export declare function listReceipts(c: Context<App.Environment>, options: listReceipts.Options): Promise<{
-    data: {
+    data: Transactions.enrichFeeTokens.Output<Omit<{
         blockHash: `0x${string}` | null;
         blockNumber: number;
         contractAddress: `0x${string}` | null;
         cumulativeGasUsed: number;
         effectiveGasPrice: string;
-        feeAmount: string;
+        feeAmount: {
+            baseUnits: string;
+            currency: string;
+            decimals: number;
+            formatted: string;
+            valuation?: {
+                amount: string;
+                currency: string;
+            } | null | undefined;
+        };
         feePayer?: `0x${string}` | undefined;
-        feeToken?: `0x${string}` | undefined;
+        feeToken?: {
+            address: `0x${string}`;
+            currency: string;
+            decimals: number;
+            logoUri?: string | undefined;
+            name: string;
+            symbol: string;
+            verified?: boolean | undefined;
+        } | undefined;
         gasUsed: number;
         id: `0x${string}`;
         logs: {
@@ -1158,25 +1226,10 @@ export declare function listReceipts(c: Context<App.Environment>, options: listR
             transactionIndex: `0x${string}` | null;
         }[];
         meta: {
-            feeToken?: {
-                address: `0x${string}`;
-                admin?: `0x${string}` | undefined;
-                currency: string;
-                createdAt?: string | undefined;
-                decimals: number;
-                holderCount?: number | undefined;
-                id: string;
-                logoUri?: string | undefined;
-                name: string;
-                quoteToken?: `0x${string}` | undefined;
-                symbol: string;
-                totalSupply?: string | undefined;
-                transferStats?: {
-                    count: number;
-                    firstAt: string | null;
-                    lastAt: string | null;
-                } | undefined;
-                verified: boolean;
+            pricing?: {
+                asOf: string;
+                basis: "nominal";
+                source: string;
             } | undefined;
             rpc: {
                 [x: string]: unknown;
@@ -1221,105 +1274,17 @@ export declare function listReceipts(c: Context<App.Environment>, options: listR
         transactionHash: `0x${string}`;
         transactionIndex: number;
         type: "eip1559" | "eip2930" | "eip4844" | "eip7702" | "legacy" | "tempo" | "unknown";
-    }[];
+    }, "feeToken">>[];
     nextCursor: string | null;
 }>;
 export declare namespace listReceipts {
     type Options = getReceipts.Options & {
-        /** Optional related resources to embed (e.g. `feeToken`). */
+        /** Optional curated fee-token fields to embed. */
         include: readonly z.output<typeof schema.getReceipt.Include>[];
     };
 }
 export declare function getReceipts(c: Context<App.Environment>, options: getReceipts.Options): Promise<{
-    data: {
-        blockHash: `0x${string}` | null;
-        blockNumber: number;
-        contractAddress: `0x${string}` | null;
-        cumulativeGasUsed: number;
-        effectiveGasPrice: string;
-        feeAmount: string;
-        feePayer?: `0x${string}` | undefined;
-        feeToken?: `0x${string}` | undefined;
-        gasUsed: number;
-        id: `0x${string}`;
-        logs: {
-            [x: string]: unknown;
-            address: `0x${string}`;
-            blockHash: `0x${string}` | null;
-            blockNumber: `0x${string}` | null;
-            blockTimestamp?: `0x${string}` | null | undefined;
-            data: `0x${string}`;
-            logIndex: `0x${string}` | null;
-            removed: boolean;
-            topics: `0x${string}`[];
-            transactionHash: `0x${string}` | null;
-            transactionIndex: `0x${string}` | null;
-        }[];
-        meta: {
-            feeToken?: {
-                address: `0x${string}`;
-                admin?: `0x${string}` | undefined;
-                currency: string;
-                createdAt?: string | undefined;
-                decimals: number;
-                holderCount?: number | undefined;
-                id: string;
-                logoUri?: string | undefined;
-                name: string;
-                quoteToken?: `0x${string}` | undefined;
-                symbol: string;
-                totalSupply?: string | undefined;
-                transferStats?: {
-                    count: number;
-                    firstAt: string | null;
-                    lastAt: string | null;
-                } | undefined;
-                verified: boolean;
-            } | undefined;
-            rpc: {
-                [x: string]: unknown;
-                blobGasPrice?: `0x${string}` | undefined;
-                blobGasUsed?: `0x${string}` | undefined;
-                blockHash: `0x${string}` | null;
-                blockNumber: `0x${string}`;
-                blockTimestamp?: `0x${string}` | null | undefined;
-                contractAddress?: `0x${string}` | null | undefined;
-                cumulativeGasUsed: `0x${string}`;
-                effectiveGasPrice: `0x${string}`;
-                feePayer?: `0x${string}` | null | undefined;
-                feeToken?: `0x${string}` | null | undefined;
-                from: `0x${string}`;
-                gasUsed: `0x${string}`;
-                logs: {
-                    [x: string]: unknown;
-                    address: `0x${string}`;
-                    blockHash: `0x${string}` | null;
-                    blockNumber: `0x${string}` | null;
-                    blockTimestamp?: `0x${string}` | null | undefined;
-                    data: `0x${string}`;
-                    logIndex: `0x${string}` | null;
-                    removed: boolean;
-                    topics: `0x${string}`[];
-                    transactionHash: `0x${string}` | null;
-                    transactionIndex: `0x${string}` | null;
-                }[];
-                logsBloom?: `0x${string}` | undefined;
-                root?: `0x${string}` | undefined;
-                status: `0x${string}`;
-                to: `0x${string}` | null;
-                transactionHash: `0x${string}`;
-                transactionIndex: `0x${string}`;
-                type: `0x${string}`;
-            };
-        };
-        recipient: `0x${string}` | null;
-        sender: `0x${string}`;
-        status: "reverted" | "success";
-        timestamp: string | null;
-        transactionHash: `0x${string}`;
-        transactionIndex: number;
-        type: "eip1559" | "eip2930" | "eip4844" | "eip7702" | "legacy" | "tempo" | "unknown";
-    }[];
+    data: humanizeReceipt.Output[];
     nextCursor: string | null;
 }>;
 export declare namespace getReceipts {
@@ -1373,12 +1338,14 @@ export declare namespace embedReceipts {
     type Options = {
         /** Target chain id. */
         chainId: z.output<typeof Schema.ChainId>;
+        /** Optional curated fee-token fields to embed. */
+        include: readonly string[];
         /**
          * Pre-fetched humanized receipts for the page (the `status`-filtered
          * transactions path). When provided, the receipts query is skipped and only
          * the page's event logs are fetched and reattached.
          */
-        receipts?: readonly z.output<typeof schema.Receipt>[] | undefined;
+        receipts?: readonly humanizeReceipt.Output[] | undefined;
         /**
          * The page's humanized transaction rows. Typed structurally (rather than as
          * the transactions schema output) so this module never touches the
@@ -1400,16 +1367,126 @@ export declare namespace embedReceipts {
         }[];
     };
 }
+/** Resolves required RPC fee-token metadata and optional curated fields for receipts. */
+export declare function enrichReceipts(c: Context<App.Environment>, options: enrichReceipts.Options): Promise<Transactions.enrichFeeTokens.Output<Omit<{
+    blockHash: `0x${string}` | null;
+    blockNumber: number;
+    contractAddress: `0x${string}` | null;
+    cumulativeGasUsed: number;
+    effectiveGasPrice: string;
+    feeAmount: {
+        baseUnits: string;
+        currency: string;
+        decimals: number;
+        formatted: string;
+        valuation?: {
+            amount: string;
+            currency: string;
+        } | null | undefined;
+    };
+    feePayer?: `0x${string}` | undefined;
+    feeToken?: {
+        address: `0x${string}`;
+        currency: string;
+        decimals: number;
+        logoUri?: string | undefined;
+        name: string;
+        symbol: string;
+        verified?: boolean | undefined;
+    } | undefined;
+    gasUsed: number;
+    id: `0x${string}`;
+    logs: {
+        [x: string]: unknown;
+        address: `0x${string}`;
+        blockHash: `0x${string}` | null;
+        blockNumber: `0x${string}` | null;
+        blockTimestamp?: `0x${string}` | null | undefined;
+        data: `0x${string}`;
+        logIndex: `0x${string}` | null;
+        removed: boolean;
+        topics: `0x${string}`[];
+        transactionHash: `0x${string}` | null;
+        transactionIndex: `0x${string}` | null;
+    }[];
+    meta: {
+        pricing?: {
+            asOf: string;
+            basis: "nominal";
+            source: string;
+        } | undefined;
+        rpc: {
+            [x: string]: unknown;
+            blobGasPrice?: `0x${string}` | undefined;
+            blobGasUsed?: `0x${string}` | undefined;
+            blockHash: `0x${string}` | null;
+            blockNumber: `0x${string}`;
+            blockTimestamp?: `0x${string}` | null | undefined;
+            contractAddress?: `0x${string}` | null | undefined;
+            cumulativeGasUsed: `0x${string}`;
+            effectiveGasPrice: `0x${string}`;
+            feePayer?: `0x${string}` | null | undefined;
+            feeToken?: `0x${string}` | null | undefined;
+            from: `0x${string}`;
+            gasUsed: `0x${string}`;
+            logs: {
+                [x: string]: unknown;
+                address: `0x${string}`;
+                blockHash: `0x${string}` | null;
+                blockNumber: `0x${string}` | null;
+                blockTimestamp?: `0x${string}` | null | undefined;
+                data: `0x${string}`;
+                logIndex: `0x${string}` | null;
+                removed: boolean;
+                topics: `0x${string}`[];
+                transactionHash: `0x${string}` | null;
+                transactionIndex: `0x${string}` | null;
+            }[];
+            logsBloom?: `0x${string}` | undefined;
+            root?: `0x${string}` | undefined;
+            status: `0x${string}`;
+            to: `0x${string}` | null;
+            transactionHash: `0x${string}`;
+            transactionIndex: `0x${string}`;
+            type: `0x${string}`;
+        };
+    };
+    recipient: `0x${string}` | null;
+    sender: `0x${string}`;
+    status: "reverted" | "success";
+    timestamp: string | null;
+    transactionHash: `0x${string}`;
+    transactionIndex: number;
+    type: "eip1559" | "eip2930" | "eip4844" | "eip7702" | "legacy" | "tempo" | "unknown";
+}, "feeToken">>[]>;
+export declare namespace enrichReceipts {
+    /** Inputs for enriching humanized receipts. */
+    type Options = {
+        /** Target chain id. */
+        chainId: z.output<typeof Schema.ChainId>;
+        /** Optional curated fee-token fields to embed. */
+        include: readonly string[];
+        /** Humanized receipts whose fee token is still an address. */
+        receipts: readonly humanizeReceipt.Output[];
+    };
+}
 /**
  * Humanizes a JSON-RPC transaction receipt: decodes `status`/`type`, converts
- * hex quantities to decimal strings and block fields to numbers, and derives the
+ * gas price and fee values, converts block fields to numbers, and derives the
  * block `timestamp` from the top-level `blockTimestamp` (present when
  * reconstructed from the index) or the (shared) per-log timestamp — `null` when
  * neither is available. The verbatim payload is preserved under `meta.rpc` and
  * the raw logs under `logs`. Shared by the receipt detail (RPC source) and list
  * (reconstructed from the indexer) endpoints, so both expose an identical shape.
  */
-export declare function humanizeReceipt(rpc: z.output<typeof schema.Rpc.Receipt>): z.output<typeof schema.Receipt>;
+export declare function humanizeReceipt(rpc: z.output<typeof schema.Rpc.Receipt>): humanizeReceipt.Output;
+export declare namespace humanizeReceipt {
+    /** Humanized receipt before its fee-token address is resolved to metadata. */
+    type Output = Omit<z.output<typeof schema.Receipt>, 'feeToken'> & {
+        /** Address of the token used to pay the fee. */
+        feeToken?: z.output<typeof Schema.Address> | undefined;
+    };
+}
 /**
  * Re-encodes a TIDX `receipts` row (joined to `txs`) into the JSON-RPC receipt
  * shape, which becomes the `rpc` payload the list endpoint humanizes through the