tapimo 0.0.0 → 0.0.2

package/dist/internal/Timing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Timing.js","sourceRoot":"","sources":["../../src/internal/Timing.ts"],"names":[],"mappings":"AAqBA,iEAAiE;AACjE,MAAM,UAAU,UAAU;IAGxB,OAAO,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE;QACvB,MAAM,OAAO,GAAa,EAAE,CAAA;QAC5B,CAAC,CAAC,GAAG,CAAC,cAAc,EAAE,OAAO,CAAC,CAAA;QAE9B,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAA;QAC/B,MAAM,IAAI,EAAE,CAAA;QACZ,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAA;QAEtE,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;QAC7B,MAAM,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAA;QACnD,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;IAChF,CAAC,CAAA;AACH,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,IAAI,CACxB,CAAuB,EACvB,IAAY,EACZ,EAAgC;IAEhC,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAA;IAC/B,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAA;IACnB,CAAC;YAAS,CAAC;QACT,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,IAAI,CAAC,EAAE,QAAQ,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IAC5E,CAAC;AACH,CAAC;AAED,SAAS,MAAM,CAAC,OAA0B;IACxC,OAAO,OAAO;SACX,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;SACzE,IAAI,CAAC,IAAI,CAAC,CAAA;AACf,CAAC;AAED,SAAS,IAAI,CAAC,KAAa;IACzB,OAAO,KAAK,CAAC,OAAO,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAA;AAChD,CAAC"}

package/dist/internal/Ttl.d.ts

@@ -0,0 +1,25 @@
+/** Returns milliseconds from milliseconds. */
+export declare function milliseconds(value: number): number;
+/** Returns milliseconds from seconds. */
+export declare function seconds(value: number): number;
+/** Returns milliseconds from minutes. */
+export declare function minutes(value: number): number;
+/** Returns milliseconds from hours. */
+export declare function hours(value: number): number;
+/** Returns milliseconds from days. */
+export declare function days(value: number): number;
+/** Returns milliseconds from weeks. */
+export declare function weeks(value: number): number;
+/** Returns milliseconds from milliseconds. */
+export declare function millisecond(value: number): number;
+/** Returns milliseconds from seconds. */
+export declare function second(value: number): number;
+/** Returns milliseconds from minutes. */
+export declare function minute(value: number): number;
+/** Returns milliseconds from hours. */
+export declare function hour(value: number): number;
+/** Returns milliseconds from days. */
+export declare function day(value: number): number;
+/** Returns milliseconds from weeks. */
+export declare function week(value: number): number;
+//# sourceMappingURL=Ttl.d.ts.map

package/dist/internal/Ttl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Ttl.d.ts","sourceRoot":"","sources":["../../src/internal/Ttl.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,UAEzC;AAED,yCAAyC;AACzC,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,UAEpC;AAED,yCAAyC;AACzC,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,UAEpC;AAED,uCAAuC;AACvC,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,UAElC;AAED,sCAAsC;AACtC,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,UAEjC;AAED,uCAAuC;AACvC,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,UAElC;AAED,8CAA8C;AAC9C,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,UAExC;AAED,yCAAyC;AACzC,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,UAEnC;AAED,yCAAyC;AACzC,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,UAEnC;AAED,uCAAuC;AACvC,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,UAEjC;AAED,sCAAsC;AACtC,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,UAEhC;AAED,uCAAuC;AACvC,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,UAEjC"}

package/dist/internal/Ttl.js

@@ -0,0 +1,49 @@
+/** Returns milliseconds from milliseconds. */
+export function milliseconds(value) {
+    return value;
+}
+/** Returns milliseconds from seconds. */
+export function seconds(value) {
+    return value * 1_000;
+}
+/** Returns milliseconds from minutes. */
+export function minutes(value) {
+    return seconds(value) * 60;
+}
+/** Returns milliseconds from hours. */
+export function hours(value) {
+    return minutes(value) * 60;
+}
+/** Returns milliseconds from days. */
+export function days(value) {
+    return hours(value) * 24;
+}
+/** Returns milliseconds from weeks. */
+export function weeks(value) {
+    return days(value) * 7;
+}
+/** Returns milliseconds from milliseconds. */
+export function millisecond(value) {
+    return milliseconds(value);
+}
+/** Returns milliseconds from seconds. */
+export function second(value) {
+    return seconds(value);
+}
+/** Returns milliseconds from minutes. */
+export function minute(value) {
+    return minutes(value);
+}
+/** Returns milliseconds from hours. */
+export function hour(value) {
+    return hours(value);
+}
+/** Returns milliseconds from days. */
+export function day(value) {
+    return days(value);
+}
+/** Returns milliseconds from weeks. */
+export function week(value) {
+    return weeks(value);
+}
+//# sourceMappingURL=Ttl.js.map

package/dist/internal/Ttl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Ttl.js","sourceRoot":"","sources":["../../src/internal/Ttl.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,KAAK,CAAA;AACd,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,OAAO,KAAK,GAAG,KAAK,CAAA;AACtB,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,OAAO,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAA;AAC5B,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,KAAK,CAAC,KAAa;IACjC,OAAO,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAA;AAC5B,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,IAAI,CAAC,KAAa;IAChC,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAA;AAC1B,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,KAAK,CAAC,KAAa;IACjC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;AACxB,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,YAAY,CAAC,KAAK,CAAC,CAAA;AAC5B,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,MAAM,CAAC,KAAa;IAClC,OAAO,OAAO,CAAC,KAAK,CAAC,CAAA;AACvB,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,MAAM,CAAC,KAAa;IAClC,OAAO,OAAO,CAAC,KAAK,CAAC,CAAA;AACvB,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,IAAI,CAAC,KAAa;IAChC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAA;AACrB,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,GAAG,CAAC,KAAa;IAC/B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAA;AACpB,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,IAAI,CAAC,KAAa;IAChC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAA;AACrB,CAAC"}

package/dist/internal/Value.d.ts

@@ -0,0 +1,47 @@
+import { Hex } from 'ox';
+/** Coerce a TIDX numeric column (bigint / number / string) to a JS number. */
+export declare function toNumber(value: unknown): number | undefined;
+/**
+ * Coerce a TIDX text column (address / hash / topic / hex data) to a string.
+ * TIDX already returns these columns as strings; this narrows the `unknown`
+ * row value without an unsafe `String(...)` on a possible object. Returns
+ * undefined for null/non-string values.
+ */
+export declare function toText(value: unknown): string | undefined;
+/**
+ * Coerce a TIDX numeric column (bigint / number / string) to a non-negative
+ * decimal integer string, preserving precision for values beyond
+ * `Number.MAX_SAFE_INTEGER` (e.g. token balances). Returns undefined when the
+ * value cannot be interpreted as a non-negative integer.
+ */
+export declare function toIntegerString(value: unknown): string | undefined;
+/**
+ * Coerce a TIDX numeric column (bigint / number / decimal string) to a minimal
+ * `0x`-prefixed hex quantity (`0x0` for zero), matching the JSON-RPC wire
+ * format. Returns undefined when the value is null/undefined or cannot be
+ * interpreted as a non-negative integer.
+ */
+export declare function toHex(value: unknown): Hex.Hex | undefined;
+/**
+ * Parse a `0x`-prefixed hex quantity into a non-negative decimal integer string,
+ * preserving precision beyond `Number.MAX_SAFE_INTEGER`. Returns undefined when
+ * the value is not a valid hex quantity.
+ */
+export declare function fromHex(value: unknown): string | undefined;
+/**
+ * Parse a `0x`-prefixed hex quantity into a JS number. Returns undefined when
+ * the value is not a valid hex quantity.
+ */
+export declare function hexToNumber(value: unknown): number | undefined;
+/**
+ * Convert a `0x`-prefixed hex Unix-seconds timestamp into an ISO 8601 datetime
+ * string. Returns undefined when the value is not a valid hex quantity.
+ */
+export declare function hexSecondsToIso(value: unknown): string | undefined;
+/**
+ * Coerce a TIDX timestamp column (Date / epoch seconds / epoch ms / ISO string)
+ * to an ISO 8601 datetime string. Returns undefined when the value cannot be
+ * interpreted as a timestamp.
+ */
+export declare function toIsoDateTime(value: unknown): string | undefined;
+//# sourceMappingURL=Value.d.ts.map

package/dist/internal/Value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Value.d.ts","sourceRoot":"","sources":["../../src/internal/Value.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,IAAI,CAAA;AAExB,8EAA8E;AAC9E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,sBAKtC;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAEzD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,sBAa7C;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,GAAG,CAAC,GAAG,GAAG,SAAS,CAazD;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAG1D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAG9D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAGlE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,sBAkB3C"}

package/dist/internal/Value.js

@@ -0,0 +1,122 @@
+import { Hex } from 'ox';
+/** Coerce a TIDX numeric column (bigint / number / string) to a JS number. */
+export function toNumber(value) {
+    if (typeof value === 'bigint')
+        return Number(value);
+    if (typeof value === 'number')
+        return value;
+    if (typeof value === 'string')
+        return Number(value);
+    return undefined;
+}
+/**
+ * Coerce a TIDX text column (address / hash / topic / hex data) to a string.
+ * TIDX already returns these columns as strings; this narrows the `unknown`
+ * row value without an unsafe `String(...)` on a possible object. Returns
+ * undefined for null/non-string values.
+ */
+export function toText(value) {
+    return typeof value === 'string' ? value : undefined;
+}
+/**
+ * Coerce a TIDX numeric column (bigint / number / string) to a non-negative
+ * decimal integer string, preserving precision for values beyond
+ * `Number.MAX_SAFE_INTEGER` (e.g. token balances). Returns undefined when the
+ * value cannot be interpreted as a non-negative integer.
+ */
+export function toIntegerString(value) {
+    if (typeof value === 'bigint')
+        return value >= 0n ? value.toString() : undefined;
+    if (typeof value === 'number') {
+        if (!Number.isFinite(value) || value < 0 || !Number.isInteger(value))
+            return undefined;
+        // Route through BigInt so large integers serialize as plain decimals rather
+        // than exponential notation (e.g. `1e+21`).
+        return BigInt(value).toString();
+    }
+    if (typeof value === 'string') {
+        const trimmed = value.trim();
+        return /^\d+$/.test(trimmed) ? trimmed : undefined;
+    }
+    return undefined;
+}
+/**
+ * Coerce a TIDX numeric column (bigint / number / decimal string) to a minimal
+ * `0x`-prefixed hex quantity (`0x0` for zero), matching the JSON-RPC wire
+ * format. Returns undefined when the value is null/undefined or cannot be
+ * interpreted as a non-negative integer.
+ */
+export function toHex(value) {
+    let big;
+    if (typeof value === 'bigint')
+        big = value;
+    else if (typeof value === 'number') {
+        if (!Number.isFinite(value) || !Number.isInteger(value))
+            return undefined;
+        big = BigInt(value);
+    }
+    else if (typeof value === 'string') {
+        const trimmed = value.trim();
+        if (!/^\d+$/.test(trimmed))
+            return undefined;
+        big = BigInt(trimmed);
+    }
+    else
+        return undefined;
+    if (big < 0n)
+        return undefined;
+    return Hex.fromNumber(big);
+}
+/**
+ * Parse a `0x`-prefixed hex quantity into a non-negative decimal integer string,
+ * preserving precision beyond `Number.MAX_SAFE_INTEGER`. Returns undefined when
+ * the value is not a valid hex quantity.
+ */
+export function fromHex(value) {
+    if (typeof value !== 'string' || !/^0x[0-9a-fA-F]+$/.test(value))
+        return undefined;
+    return BigInt(value).toString();
+}
+/**
+ * Parse a `0x`-prefixed hex quantity into a JS number. Returns undefined when
+ * the value is not a valid hex quantity.
+ */
+export function hexToNumber(value) {
+    const decimal = fromHex(value);
+    return decimal === undefined ? undefined : Number(decimal);
+}
+/**
+ * Convert a `0x`-prefixed hex Unix-seconds timestamp into an ISO 8601 datetime
+ * string. Returns undefined when the value is not a valid hex quantity.
+ */
+export function hexSecondsToIso(value) {
+    const seconds = hexToNumber(value);
+    return seconds === undefined ? undefined : new Date(seconds * 1000).toISOString();
+}
+/**
+ * Coerce a TIDX timestamp column (Date / epoch seconds / epoch ms / ISO string)
+ * to an ISO 8601 datetime string. Returns undefined when the value cannot be
+ * interpreted as a timestamp.
+ */
+export function toIsoDateTime(value) {
+    if (value instanceof Date)
+        return value.toISOString();
+    // TIDX can surface timestamps as either decoded date strings or numeric
+    // epochs depending on the query engine and transport codec.
+    if (typeof value === 'number')
+        return new Date(value > 1_000_000_000_000 ? value : value * 1000).toISOString();
+    if (typeof value !== 'string')
+        return undefined;
+    // ClickHouse formats `DateTime`/`DateTime64` as `YYYY-MM-DD HH:MM:SS[.sss]`
+    // (UTC), which V8's Date parser treats as *local* time. Normalize to a
+    // strict ISO 8601 UTC string so both engines hit the same `new Date(...)`
+    // path.
+    const normalized = /^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}(\.\d+)?$/.test(value)
+        ? `${value.replace(' ', 'T')}Z`
+        : value;
+    const date = new Date(normalized);
+    if (Number.isNaN(date.getTime()))
+        return undefined;
+    return date.toISOString();
+}
+//# sourceMappingURL=Value.js.map

package/dist/internal/Value.js.map

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

package/dist/internal/VerifiedTokens.d.ts

@@ -0,0 +1,228 @@
+import type { Context } from 'hono';
+import * as z from 'zod/mini';
+import type * as App from '../App.js';
+import * as Schema from './Schema.js';
+import * as Store from './Store.js';
+/** Chain id covered by the curated verified-token lists. */
+export type ChainId = z.output<typeof Schema.ChainId>;
+/** Schema for a chain's verified token list (the value stored in KV). */
+export declare const Data: z.ZodMiniArray<z.ZodMiniObject<{
+    address: z.ZodMiniPipe<z.ZodMiniTemplateLiteral<`0x${string}`>, z.ZodMiniTransform<`0x${string}`, `0x${string}`>>;
+    currency: z.ZodMiniString<string>;
+    decimals: z.ZodMiniNumber<number>;
+    id: z.ZodMiniString<string>;
+    logoUri: z.ZodMiniOptional<z.ZodMiniURL>;
+    name: z.ZodMiniString<string>;
+    symbol: z.ZodMiniString<string>;
+}, z.core.$strip>>;
+type SnapshotToken = z.output<typeof Data>[number];
+/** A single curated verified TIP-20 token accepted by write/compile APIs. */
+export type Token = Omit<SnapshotToken, 'id'> & {
+    id?: string | undefined;
+};
+/** Verified-token input accepted before the stable resource id is derived. */
+export type TokenInput = Token;
+/**
+ * A compiled, indexed snapshot of one chain's curated verified-token list.
+ * Fetched once per request and threaded into per-row enrichment so lookups are
+ * plain in-memory map reads rather than repeated array scans.
+ */
+export type Snapshot = {
+    /** Tokens indexed by lowercased contract address (membership + lookup). */
+    byAddress: ReadonlyMap<string, SnapshotToken>;
+    /** Tokens grouped by lowercased display currency, preserving list order. */
+    byCurrency: ReadonlyMap<string, readonly SnapshotToken[]>;
+    /** Tokens indexed by lowercased ticker symbol. */
+    bySymbol: ReadonlyMap<string, SnapshotToken>;
+    /** Chain the snapshot belongs to. */
+    chainId: number;
+    /** Sorted, distinct display currencies present in the list. */
+    currencies: readonly string[];
+    /** The curated tokens in their canonical order. */
+    list: readonly SnapshotToken[];
+    /** ISO timestamp of the snapshot's last update. */
+    updatedAt: string;
+    /** Opaque snapshot version; changes whenever the list changes. */
+    version: string;
+};
+/** Compiles a raw token list into an indexed {@link Snapshot}. */
+export declare function compile(options: compile.Options): Snapshot;
+export declare namespace compile {
+    /** Options for {@link compile}. */
+    type Options = {
+        /** Chain the tokens belong to. */
+        chainId: number;
+        /** Curated tokens in canonical order. */
+        tokens: readonly TokenInput[];
+        /** ISO timestamp of the snapshot's last update. */
+        updatedAt: string;
+        /** Opaque snapshot version. */
+        version: string;
+    };
+}
+declare const Head: z.ZodMiniObject<{
+    chainId: z.ZodMiniNumber<number>;
+    count: z.ZodMiniNumber<number>;
+    schema: z.ZodMiniNumber<number>;
+    updatedAt: z.ZodMiniString<string>;
+    version: z.ZodMiniString<string>;
+}, z.core.$strip>;
+/** Parsed head pointer for a chain. */
+export type Head = z.output<typeof Head>;
+/**
+ * Reads and compiles the snapshot a chain's head points at. Returns `null` when
+ * the chain has no head. Throws {@link TornStateError} when `head` references a
+ * missing snapshot blob.
+ */
+export declare function read(store: Store.State, chainId: ChainId): Promise<Snapshot | null>;
+/**
+ * Appends a verified token to a chain's list and publishes a new snapshot.
+ * Throws on a duplicate address or (case-insensitive) symbol.
+ */
+export declare function create(store: Store.State, input: create.Input): Promise<create.Result>;
+export declare namespace create {
+    /** Input for {@link create}. */
+    type Input = {
+        /** TIP-20 token contract address (normalized to lowercase). */
+        address: string;
+        /** Chain the token belongs to. */
+        chainId: ChainId;
+        /** Display currency, e.g. `USD`. */
+        currency: string;
+        /** Decimal precision. */
+        decimals: number;
+        /** Curated HTTPS logo URL. Omit when no curated logo is set. */
+        logoUri?: string | undefined;
+        /** Display name. */
+        name: string;
+        /** Ticker symbol. */
+        symbol: string;
+    };
+    /** Result of {@link create}. */
+    type Result = {
+        /** The published snapshot reflecting the new token. */
+        snapshot: Snapshot;
+        /** The created token. */
+        token: Token;
+    };
+}
+/**
+ * Partially updates a verified token in place (preserving list order) and
+ * publishes a new snapshot. Throws {@link NotFoundError} when the address is
+ * absent, and the uniqueness errors when an edit collides with another entry.
+ */
+export declare function patch(store: Store.State, chainId: ChainId, address: string, input: patch.Input, options?: patch.Options): Promise<create.Result>;
+export declare namespace patch {
+    /** Patchable fields for {@link patch} (address and chain are immutable). */
+    type Input = {
+        /** Display currency, e.g. `USD`. */
+        currency?: string | undefined;
+        /** Decimal precision. */
+        decimals?: number | undefined;
+        /** Curated HTTPS logo URL. Omitting keeps the current value (use `replace` to clear). */
+        logoUri?: string | undefined;
+        /** Display name. */
+        name?: string | undefined;
+        /** Ticker symbol. */
+        symbol?: string | undefined;
+    };
+    /** Options for {@link patch}. */
+    type Options = {
+        /** Expected current version for optimistic concurrency (best-effort). */
+        ifMatch?: string | undefined;
+    };
+}
+/**
+ * Removes a verified token from a chain's list and publishes a new snapshot.
+ * Throws {@link NotFoundError} when the address is absent.
+ */
+export declare function remove(store: Store.State, chainId: ChainId, address: string, options?: patch.Options): Promise<remove.Result>;
+export declare namespace remove {
+    /** Result of {@link remove}. */
+    type Result = {
+        /** The published snapshot reflecting the removal. */
+        snapshot: Snapshot;
+    };
+}
+/**
+ * Replaces a chain's entire verified list and publishes a new snapshot. Used to
+ * bulk-load the initial list and to roll back to a previous one.
+ */
+export declare function replace(store: Store.State, chainId: ChainId, tokens: readonly TokenInput[], options?: patch.Options): Promise<remove.Result>;
+/**
+ * Primes this isolate's in-memory snapshot for a chain. The writer isolate calls
+ * this after a successful publish so the next read reflects the write without
+ * waiting on store propagation (read-your-write).
+ */
+export declare function prime(chainId: ChainId, snapshot: Snapshot): void;
+/**
+ * Returns the compiled verified-token {@link Snapshot} for a chain.
+ *
+ * When the verified-tokens feature is unconfigured, serves an empty snapshot.
+ * When configured with a {@link Store.State}, serves a per-isolate snapshot
+ * refreshed on a soft TTL: fresh lookups do zero store I/O; soft-stale
+ * lookups return the current snapshot immediately and refresh in the background
+ * (single-flight, head-only unless the version changed); a cold isolate loads
+ * from the store (an empty snapshot when no head exists).
+ */
+export declare function snapshot(c: Context<App.Environment>, chainId: ChainId): Promise<Snapshot>;
+/**
+ * Well-known display currencies surfaced as an OpenAPI `examples` hint on
+ * filters that accept any currency string but want to populate the well-known
+ * ones in Swagger/Stoplight/Scalar dropdowns. Static hint only — the
+ * authoritative set is `Snapshot.currencies` from the live store.
+ */
+export declare const currencies: string[];
+/**
+ * Thrown when a chain's `head` points at a snapshot version whose blob is
+ * missing from the store. The write path always writes the blob before flipping
+ * the head, so this indicates a torn write or external tampering.
+ */
+export declare class TornStateError extends Error {
+    name: string;
+    constructor(options: {
+        chainId: number;
+        version: string;
+    });
+}
+/** Thrown when a write would introduce a duplicate address on a chain. */
+export declare class DuplicateAddressError extends Error {
+    name: string;
+    constructor(options: {
+        address: string;
+        chainId: number;
+    });
+}
+/**
+ * Thrown when a write would introduce a duplicate (case-insensitive) symbol on a
+ * chain — which would make `GET /tokens/:symbol` ambiguous.
+ */
+export declare class DuplicateSymbolError extends Error {
+    name: string;
+    constructor(options: {
+        chainId: number;
+        symbol: string;
+    });
+}
+/** Thrown when a patch/delete targets an address not in a chain's verified list. */
+export declare class NotFoundError extends Error {
+    name: string;
+    constructor(options: {
+        address: string;
+        chainId: number;
+    });
+}
+/**
+ * Thrown when an `If-Match` precondition does not equal the current head version
+ * (best-effort optimistic concurrency).
+ */
+export declare class VersionMismatchError extends Error {
+    name: string;
+    constructor(options: {
+        actual: string;
+        chainId: number;
+        expected: string;
+    });
+}
+export {};
+//# sourceMappingURL=VerifiedTokens.d.ts.map

package/dist/internal/VerifiedTokens.d.ts.map

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