tapimo 0.5.2 → 0.6.0

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

@@ -0,0 +1,307 @@
+import { type Context } from 'hono';
+import * as z from 'zod/mini';
+import type * as App from '../../../App.js';
+import * as Response from '../../../internal/Response.js';
+import * as VerifiedTokens from '../../../internal/VerifiedTokens.js';
+import * as FxOracle from '../FxOracle.js';
+/** Zod schemas owned by the valuation handlers. */
+export declare namespace schema {
+    /** A holding's nominal value in the requested denomination. */
+    const Value: z.ZodMiniObject<{
+        amount: z.ZodMiniString<string>;
+        currency: z.ZodMiniString<string>;
+    }, z.core.$strip>;
+    /** Rate provenance for a converted valuation. */
+    const Pricing: z.ZodMiniObject<{
+        asOf: z.ZodMiniString<string>;
+        basis: z.ZodMiniLiteral<"nominal">;
+        source: z.ZodMiniString<string>;
+    }, z.core.$strip>;
+    /** Schemas for the getAddressValuation operation. */
+    namespace getAddressValuation {
+        /** Path parameters for address valuation requests. */
+        const Params: z.ZodMiniObject<{
+            address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+        }, z.core.$strip>;
+        /** Query parameters for address valuation requests. */
+        const Query: z.ZodMiniObject<{
+            chainId: z.ZodMiniOptional<z.ZodMiniPipe<z.ZodMiniUnion<readonly [z.ZodMiniPipe<z.ZodMiniEnum<{
+                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>>>;
+        }, z.core.$strict>;
+        /** The nominal valuation of an account's verified holdings. */
+        const Response: z.ZodMiniObject<{
+            address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+            amount: z.ZodMiniString<string>;
+            currency: z.ZodMiniString<string>;
+            id: z.ZodMiniString<string>;
+            pricing: z.ZodMiniNullable<z.ZodMiniObject<{
+                asOf: z.ZodMiniString<string>;
+                basis: z.ZodMiniLiteral<"nominal">;
+                source: z.ZodMiniString<string>;
+            }, z.core.$strip>>;
+            unpriced: z.ZodMiniArray<z.ZodMiniString<string>>;
+        }, z.core.$strip>;
+    }
+}
+/**
+ * Creates address-scoped valuation handlers, mounted under the `/addresses`
+ * composer. Exposes `GET /:address/valuation`, the holdings valuation.
+ */
+export declare function addresses(options?: addresses.Options): import("hono/hono-base").HonoBase<App.Environment, {
+    "/v1/addresses/:address/valuation": {
+        $get: {
+            output: {
+                address: `0x${string}`;
+                amount: string;
+                currency: string;
+                id: string;
+                pricing: {
+                    asOf: string;
+                    basis: "nominal";
+                    source: string;
+                } | null;
+                unpriced: string[];
+            };
+            outputFormat: "json";
+            status: 200;
+            input: {
+                param: {
+                    address: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                    denomination?: string | string[];
+                } | undefined;
+            };
+        } | {
+            output: {
+                error: {
+                    code: "api_key_malformed";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 400;
+            input: {
+                param: {
+                    address: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                    denomination?: string | string[];
+                } | undefined;
+            };
+        } | {
+            output: {
+                error: {
+                    code: "address_invalid";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 400;
+            input: {
+                param: {
+                    address: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                    denomination?: string | string[];
+                } | undefined;
+            };
+        } | {
+            output: {
+                error: {
+                    code: "query_invalid";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 400;
+            input: {
+                param: {
+                    address: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                    denomination?: string | string[];
+                } | undefined;
+            };
+        } | {
+            output: {
+                error: {
+                    code: "api_key_invalid" | "api_key_missing";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 401;
+            input: {
+                param: {
+                    address: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                    denomination?: string | string[];
+                } | undefined;
+            };
+        } | {
+            output: null;
+            outputFormat: "body";
+            status: 402;
+            input: {
+                param: {
+                    address: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                    denomination?: string | string[];
+                } | undefined;
+            };
+        } | {
+            output: {
+                error: {
+                    code: "api_key_forbidden";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 403;
+            input: {
+                param: {
+                    address: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                    denomination?: string | string[];
+                } | undefined;
+            };
+        } | {
+            output: {
+                error: {
+                    code: "payment_required" | "rate_limit_exceeded";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 429;
+            input: {
+                param: {
+                    address: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                    denomination?: string | string[];
+                } | undefined;
+            };
+        } | {
+            output: {
+                error: {
+                    code: "upstream_error";
+                    details?: readonly Response.error.Detail[] | undefined;
+                    message: string;
+                };
+                requestId: string;
+            };
+            outputFormat: "json";
+            status: 502;
+            input: {
+                param: {
+                    address: `0x${string}`;
+                };
+            } & {
+                query?: {
+                    chainId?: string | string[];
+                    denomination?: string | string[];
+                } | undefined;
+            };
+        };
+    };
+}, "/", "/v1/addresses/:address/valuation">;
+export declare namespace addresses {
+    /** Options for the address-scoped valuation handlers. */
+    type Options = {
+        /** FX configuration backing currency conversion. */
+        fx?: Fx | undefined;
+    };
+    /** FX configuration for valuation handlers. */
+    type Fx = {
+        /** FX rate oracle. Defaults to `FxOracle.ecb()`. */
+        oracle?: FxOracle.Oracle | undefined;
+    };
+}
+/** Loads the oracle's rate set through the request's store cache. */
+export declare function rateSet(c: Context<App.Environment>, oracle: FxOracle.Oracle): Promise<FxOracle.RateSet>;
+/**
+ * Loads rates best-effort to validate the denomination and value a page.
+ * Returns `undefined` when unavailable or unnecessary; a known unsupported denomination still throws.
+ */
+export declare function ratesFor(c: Context<App.Environment>, options: ratesFor.Options): Promise<FxOracle.RateSet | undefined>;
+export declare namespace ratesFor {
+    /** Options for loading a page's valuation rates. */
+    type Options = {
+        /** Display currencies of the curated holdings appearing on the page. */
+        currencies: Iterable<string>;
+        /** Currency values are denominated in (uppercase). */
+        denomination: string;
+        /** FX rate oracle backing currency conversion. */
+        oracle: FxOracle.Oracle;
+    };
+}
+/** Builds the `pricing` provenance block for a consulted rate set. */
+export declare function pricing(rates: FxOracle.RateSet, oracle: FxOracle.Oracle): {
+    asOf: string;
+    basis: 'nominal';
+    source: string;
+};
+/**
+ * Values one holding in the requested denomination via its curated display
+ * currency. Returns `null` when the token is unverified, its currency has no
+ * rate, or the rate set is unavailable.
+ */
+export declare function valuationFor(options: valuationFor.Options): {
+    amount: string;
+    currency: string;
+} | null;
+export declare namespace valuationFor {
+    /** Options for valuing one holding. */
+    type Options = {
+        /** Holding amount in the token's base units. */
+        amount: bigint;
+        /** Currency the value is denominated in (uppercase). */
+        denomination: string;
+        /** Oracle rate set, when loaded. */
+        rates: FxOracle.RateSet | undefined;
+        /** Display currency and decimal scale backing the holding, when known. */
+        token: Pick<VerifiedTokens.Snapshot['list'][number], 'currency' | 'decimals'> | undefined;
+    };
+}
+/** Thrown when the requested denomination is not priced by the FX oracle. */
+export declare class UnsupportedDenominationError extends Error {
+    name: string;
+    constructor(denomination: string, oracle: string);
+}
+//# sourceMappingURL=valuation.d.ts.map

package/dist/apps/data/routes/valuation.d.ts.map

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

package/dist/apps/data/routes/valuation.js

@@ -0,0 +1,292 @@
+import { Hono } from 'hono';
+import { Value as core_Value } from 'ox';
+import { BaseError, ContractFunctionRevertedError, ContractFunctionZeroDataError } from 'viem';
+import { Actions } from 'viem/tempo';
+import * as z from 'zod/mini';
+import * as Auth from '../../../internal/Auth.js';
+import * as Cache from '../../../internal/Cache.js';
+import * as OpenApi from '../../../internal/OpenApi.js';
+import * as Response from '../../../internal/Response.js';
+import * as Schema from '../../../internal/Schema.js';
+import * as Store from '../../../internal/Store.js';
+import * as Timing from '../../../internal/Timing.js';
+import * as VerifiedTokens from '../../../internal/VerifiedTokens.js';
+import * as FxOracle from '../FxOracle.js';
+// How many balance reads to fan out per batch. Concurrent reads in one
+// macrotask collapse into a single deployless multicall; small chunks keep
+// each call under the Tempo RPC's per-call size limit.
+const tokenReadChunkSize = 20;
+/** Zod schemas owned by the valuation handlers. */
+export var schema;
+(function (schema) {
+    /** A holding's nominal value in the requested denomination. */
+    schema.Value = z
+        .object({
+        amount: z
+            .string()
+            .check(z.regex(/^\d+(\.\d+)?$/), z.describe('The holding’s nominal value, as a decimal string in `currency`.'), z.meta({ examples: ['1.50'] })),
+        currency: z
+            .string()
+            .check(z.describe('The denomination currency of this value.'), z.meta({ examples: ['USD'] })),
+    })
+        .check(z.describe('The holding’s nominal value in the requested denomination.'));
+    /** Rate provenance for a converted valuation. */
+    schema.Pricing = z
+        .object({
+        asOf: z
+            .string()
+            .check(z.describe('Publication date of the rate set used for conversion.'), z.meta({ examples: ['2026-07-20'] })),
+        basis: z
+            .literal('nominal')
+            .check(z.describe('Valuation basis: one token unit counts as one unit of its display currency.'), z.meta({ examples: ['nominal'] })),
+        source: z
+            .string()
+            .check(z.describe('FX rate oracle that supplied the conversion rates.'), z.meta({ examples: ['ecb'] })),
+    })
+        .check(z.describe('Rate provenance for a converted valuation.'));
+    /** Schemas for the getAddressValuation operation. */
+    let getAddressValuation;
+    (function (getAddressValuation) {
+        /** Path parameters for address valuation requests. */
+        getAddressValuation.Params = z
+            .object({
+            address: Schema.Address.check(z.describe('The account address whose holdings you want to value.')),
+        })
+            .check(z.describe('Path parameters for valuing an account’s verified holdings.'));
+        /** Query parameters for address valuation requests. */
+        getAddressValuation.Query = z
+            .strictObject({
+            chainId: Schema.ChainIdQuery,
+            denomination: Schema.Denomination,
+        })
+            .check(z.describe('Query parameters for valuing an account’s verified holdings.'));
+        /** The nominal valuation of an account's verified holdings. */
+        getAddressValuation.Response = z
+            .object({
+            address: Schema.Address.check(z.describe('The account address this valuation covers.')),
+            amount: z
+                .string()
+                .check(z.regex(/^\d+(\.\d+)?$/), z.describe('The total value of the account’s verified holdings, as a decimal string in `currency`.'), z.meta({ examples: ['160.50'] })),
+            currency: z
+                .string()
+                .check(z.describe('The denomination currency of `amount`.'), z.meta({ examples: ['USD'] })),
+            id: z
+                .string()
+                .check(z.describe('A stable resource ID for this valuation, equal to the account address.'), z.meta({ examples: ['0xbe058e1c4df8a4366a387bf595b284246a93039e'] })),
+            pricing: z
+                .nullable(schema.Pricing)
+                .check(z.describe('Rate provenance, or `null` when every valued holding was already denominated in `currency`.')),
+            unpriced: z
+                .array(z.string())
+                .check(z.describe('Display currencies excluded from `amount` because the FX oracle has no rate for them.'), z.meta({ examples: [['BTC']] })),
+        })
+            .check(z.describe('The nominal valuation of an account’s verified token holdings.'));
+    })(getAddressValuation = schema.getAddressValuation || (schema.getAddressValuation = {}));
+})(schema || (schema = {}));
+/**
+ * Creates address-scoped valuation handlers, mounted under the `/addresses`
+ * composer. Exposes `GET /:address/valuation`, the holdings valuation.
+ */
+export function addresses(options = {}) {
+    const oracle = options.fx?.oracle ?? FxOracle.ecb();
+    return new Hono().get('/v1/addresses/:address/valuation', Auth.policy({ apiKey: { scopes: ['data:read'] }, mpp: true, public: true }), OpenApi.validate('param', schema.getAddressValuation.Params, {
+        code: 'address_invalid',
+        message: 'Invalid account address',
+    }), OpenApi.validate('query', schema.getAddressValuation.Query, {
+        code: 'query_invalid',
+        message: 'Invalid query parameters',
+    }), OpenApi.describeRoute({
+        description: 'Values every verified TIP-20 token an account holds as one unit of its display currency, converts each currency into the requested denomination using the configured FX rates, and returns the total.',
+        operationId: 'getAddressValuation',
+        responses: OpenApi.responses({
+            errors: { 502: 'Could not read balances or exchange rates from an upstream service.' },
+            success: {
+                description: 'The valuation of this account’s verified holdings.',
+                schema: schema.getAddressValuation.Response,
+            },
+        }),
+        summary: 'Get address valuation',
+        tags: ['Balances'],
+    }), Cache.response({
+        cacheControl: Cache.policies.noStore,
+        name: 'tempo-api:addresses:v1',
+        key: (c) => Cache.urlKey(c, schema.getAddressValuation.Query),
+    }), async (c) => {
+        if (Auth.narrowAccess)
+            return Auth.paidAccessError(c);
+        if (OpenApi.narrowValidation)
+            return OpenApi.validationError(c, {
+                code: 'address_invalid',
+                message: 'Invalid request parameters',
+            });
+        if (OpenApi.narrowValidation)
+            return OpenApi.validationError(c, {
+                code: 'query_invalid',
+                message: 'Invalid request parameters',
+            });
+        const { address } = c.req.valid('param');
+        const query = c.req.valid('query');
+        try {
+            const valuation = await getAddressValuation(c, {
+                address,
+                chainId: query.chainId ?? c.get('chainId'),
+                denomination: query.denomination ?? 'USD',
+                oracle,
+            });
+            return c.json(Response.validated(schema.getAddressValuation.Response, valuation), 200);
+        }
+        catch (cause) {
+            if (cause instanceof UnsupportedDenominationError)
+                return Response.error(c, { code: 'query_invalid', message: cause.message, status: 400 });
+            return Response.upstream(c, cause);
+        }
+    });
+}
+async function getAddressValuation(c, options) {
+    const { address, chainId, denomination, oracle } = options;
+    const [set, ratesCause] = await rateSet(c, oracle).then((set) => [set, undefined], (cause) => [undefined, cause]);
+    if (set && denomination !== set.base && set.rates[denomination] === undefined)
+        throw new UnsupportedDenominationError(denomination, oracle.name);
+    const snapshot = await VerifiedTokens.snapshot(c, chainId);
+    const holdings = await Timing.time(c, 'valuation_balances', async () => {
+        const client = c.get('getClient')(chainId);
+        if (snapshot.list.length === 0)
+            return [];
+        // Pin every chunk to one chain-state snapshot.
+        const blockNumber = await client.getBlockNumber({ cacheTime: 0 });
+        const rows = [];
+        for (let index = 0; index < snapshot.list.length; index += tokenReadChunkSize) {
+            const group = snapshot.list.slice(index, index + tokenReadChunkSize);
+            // Concurrent reads enter viem's shared batch window and become one
+            // deployless multicall. A failed read fails the request rather than
+            // serving a partial total.
+            const results = await Promise.all(group.map(async (token) => {
+                try {
+                    const { amount } = await Actions.token.getBalance(client, {
+                        account: address,
+                        blockNumber,
+                        decimals: token.decimals,
+                        token: token.address,
+                    });
+                    return amount === 0n ? undefined : { amount, token };
+                }
+                catch (error) {
+                    // A verified token that is undeployed (zero data) or uninitialized
+                    // on this chain cannot be held; count it as an empty holding
+                    // rather than failing the valuation.
+                    const empty = error instanceof BaseError &&
+                        error.walk((cause) => cause instanceof ContractFunctionZeroDataError ||
+                            (cause instanceof ContractFunctionRevertedError &&
+                                cause.data?.errorName === 'Uninitialized'));
+                    if (empty)
+                        return undefined;
+                    throw error;
+                }
+            }));
+            rows.push(...results.filter((row) => row !== undefined));
+        }
+        return rows;
+    });
+    const groups = new Map();
+    for (const { amount, token } of holdings) {
+        const group = groups.get(token.currency.toLowerCase()) ?? { currency: token.currency, sum: 0n };
+        group.sum +=
+            token.decimals <= FxOracle.precision
+                ? amount * 10n ** BigInt(FxOracle.precision - token.decimals)
+                : amount / 10n ** BigInt(token.decimals - FxOracle.precision);
+        groups.set(token.currency.toLowerCase(), group);
+    }
+    let total = 0n;
+    const unpriced = [];
+    let pricing = null;
+    const pending = [...groups.values()].filter((group) => group.currency.toUpperCase() !== denomination);
+    for (const group of groups.values())
+        if (group.currency.toUpperCase() === denomination)
+            total += group.sum;
+    if (pending.length > 0) {
+        if (!set)
+            throw ratesCause;
+        for (const group of pending) {
+            const rate = FxOracle.rate(set, { from: group.currency.toUpperCase(), to: denomination });
+            if (rate === undefined)
+                unpriced.push(group.currency);
+            else
+                total += (group.sum * rate) / 10n ** BigInt(FxOracle.precision);
+        }
+        pricing = { asOf: set.asOf, basis: 'nominal', source: oracle.name };
+    }
+    unpriced.sort();
+    return {
+        address,
+        // Floor to 6 dp, the TIP-20 native precision; same-currency sums stay exact.
+        amount: core_Value.format(total / 10n ** BigInt(FxOracle.precision - 6), 6),
+        currency: denomination,
+        id: address,
+        pricing,
+        unpriced,
+    };
+}
+/** Loads the oracle's rate set through the request's store cache. */
+export function rateSet(c, oracle) {
+    return Timing.time(c, 'valuation_rates', () => Store.memoize(() => oracle.rates(), {
+        key: `fx:v1:${oracle.name}`,
+        store: c.get('store'),
+        ttl: oracle.ttl,
+    }));
+}
+/**
+ * Loads rates best-effort to validate the denomination and value a page.
+ * Returns `undefined` when unavailable or unnecessary; a known unsupported denomination still throws.
+ */
+export async function ratesFor(c, options) {
+    const { denomination, oracle } = options;
+    const rates = await rateSet(c, oracle).catch(() => undefined);
+    if (!rates)
+        return undefined;
+    if (denomination !== rates.base && rates.rates[denomination] === undefined)
+        throw new UnsupportedDenominationError(denomination, oracle.name);
+    const conversion = [...options.currencies].some((currency) => currency.toUpperCase() !== denomination);
+    if (!conversion)
+        return undefined;
+    return rates;
+}
+/** Builds the `pricing` provenance block for a consulted rate set. */
+export function pricing(rates, oracle) {
+    return { asOf: rates.asOf, basis: 'nominal', source: oracle.name };
+}
+/**
+ * Values one holding in the requested denomination via its curated display
+ * currency. Returns `null` when the token is unverified, its currency has no
+ * rate, or the rate set is unavailable.
+ */
+export function valuationFor(options) {
+    const { amount, denomination, rates, token } = options;
+    if (!token)
+        return null;
+    const rate = (() => {
+        if (token.currency.toUpperCase() === denomination)
+            return 10n ** BigInt(FxOracle.precision);
+        if (!rates)
+            return undefined;
+        return FxOracle.rate(rates, { from: token.currency.toUpperCase(), to: denomination });
+    })();
+    if (rate === undefined)
+        return null;
+    // Normalize to the shared 18-dp scale, convert, then floor to 6 dp.
+    const scaled = token.decimals <= FxOracle.precision
+        ? amount * 10n ** BigInt(FxOracle.precision - token.decimals)
+        : amount / 10n ** BigInt(token.decimals - FxOracle.precision);
+    const value = (scaled * rate) / 10n ** BigInt(FxOracle.precision);
+    return {
+        amount: core_Value.format(value / 10n ** BigInt(FxOracle.precision - 6), 6),
+        currency: denomination,
+    };
+}
+/** Thrown when the requested denomination is not priced by the FX oracle. */
+export class UnsupportedDenominationError extends Error {
+    name = 'Valuation.UnsupportedDenominationError';
+    constructor(denomination, oracle) {
+        super(`Denomination "${denomination}" is not priced by the "${oracle}" FX oracle`);
+    }
+}
+//# sourceMappingURL=valuation.js.map

package/dist/apps/data/routes/valuation.js.map

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

package/dist/apps/data/routes/verified-tokens.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"verified-tokens.d.ts","sourceRoot":"","sources":["../../../../src/apps/data/routes/verified-tokens.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAA;AAE7B,OAAO,KAAK,KAAK,GAAG,MAAM,iBAAiB,CAAA;AAI3C,OAAO,KAAK,QAAQ,MAAM,+BAA+B,CAAA;AAIzD,yDAAyD;AACzD,yBAAiB,MAAM,CAAC;IAkCtB;;;;OAIG;IACI,MAAM,KAAK;;;;;;;qBAUjB,CAAA;IAED;;;OAGG;IACI,MAAM,KAAK;;;;;;;;qBAOjB,CAAA;IAED,0DAA0D;IACnD,MAAM,MAAM;;qBAIuD,CAAA;IAE1E,oDAAoD;IACpD,UAAiB,kBAAkB,CAAC;QAClC,oDAAoD;QAC7C,MAAM,KAAK;;;;;;0BAQmD,CAAA;QAErE,qDAAqD;QAC9C,MAAM,QAAQ;;;;;;;;;;yBAGpB,CAAA;KACF;IAED,4DAA4D;IAC5D,UAAiB,0BAA0B,CAAC;QAC1C,mEAAmE;QAC5D,MAAM,KAAK;;;;;0BAEsE,CAAA;QAExF,sEAAsE;QAC/D,MAAM,QAAQ;;yBASpB,CAAA;KACF;IAED,kDAAkD;IAClD,UAAiB,gBAAgB,CAAC;QAChC,oDAAoD;QAC7C,MAAM,KAAK;;;;;0BAEyD,CAAA;KAC5E;CACF;AAED;;;;GAIG;AACH,wBAAgB,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wCAqJ7B"}
+{"version":3,"file":"verified-tokens.d.ts","sourceRoot":"","sources":["../../../../src/apps/data/routes/verified-tokens.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAA;AAE7B,OAAO,KAAK,KAAK,GAAG,MAAM,iBAAiB,CAAA;AAI3C,OAAO,KAAK,QAAQ,MAAM,+BAA+B,CAAA;AAIzD,yDAAyD;AACzD,yBAAiB,MAAM,CAAC;IA8CtB;;;;OAIG;IACI,MAAM,KAAK;;;;;;;qBAUjB,CAAA;IAED;;;OAGG;IACI,MAAM,KAAK;;;;;;;;qBAOjB,CAAA;IAED,0DAA0D;IACnD,MAAM,MAAM;;qBAIuD,CAAA;IAE1E,oDAAoD;IACpD,UAAiB,kBAAkB,CAAC;QAClC,oDAAoD;QAC7C,MAAM,KAAK;;;;;;0BAQmD,CAAA;QAErE,qDAAqD;QAC9C,MAAM,QAAQ;;;;;;;;;;yBAGpB,CAAA;KACF;IAED,4DAA4D;IAC5D,UAAiB,0BAA0B,CAAC;QAC1C,mEAAmE;QAC5D,MAAM,KAAK;;;;;0BAEsE,CAAA;QAExF,sEAAsE;QAC/D,MAAM,QAAQ;;yBASpB,CAAA;KACF;IAED,kDAAkD;IAClD,UAAiB,gBAAgB,CAAC;QAChC,oDAAoD;QAC7C,MAAM,KAAK;;;;;0BAEyD,CAAA;KAC5E;CACF;AAED;;;;GAIG;AACH,wBAAgB,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wCAqJ7B"}

package/dist/apps/data/routes/verified-tokens.js

@@ -14,17 +14,19 @@ export var schema;
     const fields = {
         currency: z
             .string()
-            .check(z.minLength(1), z.describe('The currency label for this token, such as `USD` for USD-denominated stablecoins.')),
+            .check(z.minLength(1), z.describe('The currency label for this token, such as `USD` for USD-denominated stablecoins.'), z.meta({ examples: ['USD'] })),
         decimals: z
             .number()
-            .check(z.int(), z.gte(0), z.lte(255), z.describe('The number of decimal places the token uses; Tempo stablecoins typically use 6.')),
+            .check(z.int(), z.gte(0), z.lte(255), z.describe('The number of decimal places the token uses; Tempo stablecoins typically use 6.'), z.meta({ examples: [6] })),
         logoUri: z
             .optional(z.url({ protocol: /^https$/ }))
-            .check(z.describe('The curated HTTPS URL for this token’s logo image, when one is set.')),
-        name: z.string().check(z.minLength(1), z.describe('The token’s human-readable name.')),
+            .check(z.describe('The curated HTTPS URL for this token’s logo image, when one is set.'), z.meta({ examples: ['https://assets.tempo.xyz/icons/usdc.svg'] })),
+        name: z
+            .string()
+            .check(z.minLength(1), z.describe('The token’s human-readable name.'), z.meta({ examples: ['USD Coin'] })),
         symbol: z
             .string()
-            .check(z.minLength(1), z.describe('The short ticker symbol wallets and apps show for this token.')),
+            .check(z.minLength(1), z.describe('The short ticker symbol wallets and apps show for this token.'), z.meta({ examples: ['USDC'] })),
     };
     /**
      * Verified-token write/input fields, without the server-derived `id`. Reused