tapimo 0.0.0 → 0.0.2

package/dist/apps/tokenlist.js

@@ -0,0 +1,153 @@
+import { Hono } from 'hono';
+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 VerifiedTokens from '../internal/VerifiedTokens.js';
+import * as Viem from '../internal/Viem.js';
+import { getTokenLogo } from './tokens.js';
+/** Zod schemas owned by the tokenlist resource. */
+export var schema;
+(function (schema) {
+    /** A single token entry in the verified token list format (no `extensions`). */
+    schema.Token = z
+        .object({
+        chainId: z
+            .number()
+            .check(z.int(), z.positive(), z.describe('The Tempo chain ID where this token lives.'), z.meta({ examples: [4217] })),
+        address: Schema.Address.check(z.describe('The TIP-20 token contract address on Tempo.')),
+        name: z
+            .string()
+            .check(z.describe('The token’s human-readable name.'), z.meta({ examples: ['USD Coin'] })),
+        symbol: z
+            .string()
+            .check(z.describe('The short ticker symbol wallets and apps show for this token.'), z.meta({ examples: ['USDC'] })),
+        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.'), z.meta({ examples: [6] })),
+        logoURI: z.optional(z.string()).check(z.describe('The curated HTTPS URL for this token’s logo image, when one is set.'), z.meta({
+            examples: [
+                'https://api.tempo.xyz/data/4217/icons/0x20c0000000000000000000008f5425160ebe5525.svg',
+            ],
+        })),
+    })
+        .check(z.describe('One token entry in the standard verified token list format.'));
+    /** Semantic version object required by the token-list schema. */
+    schema.Version = z
+        .object({
+        major: z
+            .number()
+            .check(z.int(), z.nonnegative(), z.describe('The major number in the token list’s semantic version.'), z.meta({ examples: [1] })),
+        minor: z
+            .number()
+            .check(z.int(), z.nonnegative(), z.describe('The minor number in the token list’s semantic version.'), z.meta({ examples: [0] })),
+        patch: z
+            .number()
+            .check(z.int(), z.nonnegative(), z.describe('The patch number in the token list’s semantic version.'), z.meta({ examples: [0] })),
+    })
+        .check(z.describe('The token list’s semantic version.'));
+    /** Schemas for the getTokenList operation. */
+    let getTokenList;
+    (function (getTokenList) {
+        /** Query parameters for the token list. */
+        getTokenList.Query = z
+            .strictObject({ chainId: Schema.ChainIdQuery })
+            .check(z.describe('Query parameters for fetching the verified token list.'));
+        /** A Uniswap-compatible token list of all verified tokens on a chain. */
+        getTokenList.Response = z
+            .object({
+            name: z
+                .string()
+                .check(z.describe('The human-readable name of this token list.'), z.meta({ examples: ['Tempo Verified Tokens'] })),
+            timestamp: z.iso
+                .datetime()
+                .check(z.describe('The ISO 8601 timestamp when this token list was last updated.'), z.meta({ examples: ['2024-01-01T00:00:00Z'] })),
+            version: schema.Version.check(z.describe('The token list’s semantic version.')),
+            tokens: z.array(schema.Token).check(z.describe('The verified TIP-20 tokens on this chain.')),
+        })
+            .check(z.describe('A Uniswap Token Lists-compatible list of Tempo’s verified TIP-20 tokens.'));
+    })(getTokenList = schema.getTokenList || (schema.getTokenList = {}));
+})(schema || (schema = {}));
+/**
+ * Mounts the hidden `/tokenlist` resource: every verified token for a chain,
+ * served in the standard Uniswap token-lists format (minus `extensions`) so
+ * wallets and other token-list consumers can load Tempo's verified set
+ * directly. Reads the same verified-token snapshot the `/v1/verified-tokens`
+ * endpoints serve.
+ */
+export function tokenlist() {
+    return new Hono().get('/', Auth.policy({ apiKey: { scopes: ['data:read'] }, mpp: true, public: true }), OpenApi.validate('query', schema.getTokenList.Query, {
+        code: 'query_invalid',
+        message: 'Invalid query parameters',
+    }), OpenApi.describeRoute({
+        description: 'Returns every verified token on a Tempo chain in the standard Uniswap Token Lists format, so wallets and apps can show trusted names, symbols, and logos.',
+        operationId: 'getTokenList',
+        responses: OpenApi.responses({
+            success: {
+                description: 'A standard token list of Tempo’s verified TIP-20 tokens.',
+                example: {
+                    name: 'Tempo',
+                    timestamp: '2026-06-17T00:00:00.000Z',
+                    version: { major: 1, minor: 0, patch: 2 },
+                    tokens: [
+                        {
+                            chainId: 4217,
+                            address: '0x20c0000000000000000000000000000000000000',
+                            name: 'pathUSD',
+                            symbol: 'pathUSD',
+                            decimals: 6,
+                            logoURI: 'https://api.tempo.xyz/assets/4217/tokens/0x20c0000000000000000000000000000000000000/logo',
+                        },
+                    ],
+                },
+                schema: schema.getTokenList.Response,
+            },
+        }),
+        summary: 'Get token list',
+        tags: ['Verified Tokens'],
+    }), Cache.response({
+        cacheControl: Cache.policies.stable,
+        name: 'tempo-api:tokenlist:v1',
+        key: (c) => Cache.urlKey(c, schema.getTokenList.Query),
+    }), async (c) => {
+        if (Auth.narrowAccess)
+            return Auth.paidAccessError(c);
+        if (OpenApi.narrowValidation)
+            return OpenApi.validationError(c, {
+                code: 'query_invalid',
+                message: 'Invalid query parameters',
+            });
+        const query = c.req.valid('query');
+        const chainId = query.chainId ?? c.get('chainId');
+        try {
+            const snapshot = await VerifiedTokens.snapshot(c, chainId);
+            const tokens = await Promise.all(snapshot.list.map(async (token) => {
+                // Prefer the curated icon asset (served by the API), falling back to
+                // the verified entry's stored `logoUri`. Most verified tokens carry
+                // no stored `logoUri` — their logo lives in the asset store.
+                const logoURI = (await getTokenLogo(c, { address: token.address, chainId })) ?? token.logoUri; // prettier-ignore
+                return {
+                    chainId,
+                    address: token.address,
+                    name: token.name,
+                    symbol: token.symbol,
+                    decimals: token.decimals,
+                    ...(logoURI === undefined ? {} : { logoURI }),
+                };
+            }));
+            const list = {
+                name: Viem.chains.find((chain) => chain.id === chainId)?.name ?? `Tempo ${chainId}`,
+                timestamp: snapshot.updatedAt,
+                version: { major: 1, minor: 0, patch: tokens.length },
+                tokens,
+            };
+            return c.json(Response.validated(schema.getTokenList.Response, list), 200);
+        }
+        catch (cause) {
+            return Response.upstream(c, cause);
+        }
+    });
+}
+//# sourceMappingURL=tokenlist.js.map

package/dist/apps/tokenlist.js.map

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