tapimo 0.7.1 → 0.8.0

package/dist/internal/funding/Action.js

@@ -0,0 +1,74 @@
+import { AbiFunction, Address, Solidity } from 'ox';
+import * as z from 'zod/mini';
+/**
+ * Executable source-chain actions returned by funding transfer creation. A
+ * strict discriminated union: transfer reads never include an action.
+ */
+const approve = AbiFunction.from('function approve(address spender, uint256 amount)');
+const approveSelector = AbiFunction.getSelector(approve);
+/** Zod schemas owned by funding actions. */
+export var schema;
+(function (schema) {
+    /** One unsigned EVM call, in the exchange quote API's call shape. */
+    schema.Call = z
+        .object({
+        data: z
+            .string()
+            .check(z.regex(/^0x(?:[0-9a-fA-F]{2})*$/), z.describe('ABI-encoded calldata.'), z.meta({ examples: ['0x095ea7b3'] })),
+        to: z
+            .string()
+            .check(z.regex(/^0x[0-9a-fA-F]{40}$/), z.describe('Contract the call targets.'), z.meta({ examples: [`0x${'44'.repeat(20)}`] })),
+        value: z
+            .string()
+            .check(z.regex(/^0x[0-9a-fA-F]+$/), z.describe('Native value to send, as hex.'), z.meta({ examples: ['0x0'] })),
+    })
+        .check(z.describe('One unsigned EVM call.'));
+    /** Ordered unsigned EVM calls the caller signs and submits on the source chain. */
+    schema.EvmCalls = z
+        .object({
+        calls: z
+            .array(schema.Call)
+            .check(z.minLength(1), z.describe('Calls in submission order; they may require separate transactions.')),
+        type: z.literal('evm:calls').check(z.describe('Action kind.')),
+    })
+        .check(z.describe('Ordered unsigned EVM calls to sign and submit on the source chain.'));
+    /** Executable source-chain action attached to a creation response. */
+    schema.Action = z
+        .discriminatedUnion('type', [schema.EvmCalls])
+        .check(z.describe('Executable source-chain action. Never returned by transfer reads.'));
+})(schema || (schema = {}));
+/**
+ * Validates prepared EVM calls before persistence. Token calls, approval
+ * targets, spenders, amounts, selectors, and native value must match the route.
+ */
+export function validateEvmCalls(options) {
+    const action = schema.EvmCalls.safeParse(options.action);
+    if (!action.success)
+        throw new InvalidActionError('Malformed EVM calls.');
+    for (const [index, call] of action.data.calls.entries()) {
+        if (BigInt(call.value) !== 0n)
+            throw new InvalidActionError('Stablecoin funding calls must not carry native value.');
+        const targetsSourceToken = Address.isEqual(call.to, options.sourceTokenAddress);
+        const selector = call.data.slice(0, approveSelector.length).toLowerCase();
+        if (targetsSourceToken && selector !== approveSelector)
+            throw new InvalidActionError('Unsupported source token call.');
+        if (selector !== approveSelector)
+            continue;
+        if (!targetsSourceToken)
+            throw new InvalidActionError('Approval must target the source token.');
+        if (call.data.length !== approveSelector.length + 128)
+            throw new InvalidActionError('Malformed approval calldata.');
+        const [spender, amount] = AbiFunction.decodeData(approve, call.data);
+        if (!action.data.calls
+            .slice(index + 1)
+            .some((next) => Address.isEqual(next.to, spender)))
+            throw new InvalidActionError('Approval spender must match a later prepared executor.');
+        if (amount >= Solidity.maxUint256 || amount > BigInt(options.sourceAmount))
+            throw new InvalidActionError('Approval must stay bounded to the route amount.');
+    }
+}
+/** Error thrown when a provider returns an action outside the route's bounds. */
+export class InvalidActionError extends Error {
+    name = 'Funding.Action.InvalidActionError';
+}
+//# sourceMappingURL=Action.js.map

package/dist/internal/funding/Action.js.map

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

package/dist/internal/funding/Catalog.d.ts

@@ -0,0 +1,107 @@
+import type { Context } from 'hono';
+import * as z from 'zod/mini';
+import type * as App from '../../App.js';
+import * as Db from '../../db/Db.js';
+import * as core_Catalog from '../../db/tables/fundingCatalog.js';
+import * as Chain from './Chain.js';
+import * as Route from './Route.js';
+import * as Token from './Token.js';
+/** Funding catalog schemas. */
+export declare namespace schema {
+    /** Funding capabilities enabled on one provider route. */
+    const Capabilities: z.ZodMiniObject<{
+        depositAddress: z.ZodMiniOptional<z.ZodMiniLiteral<true>>;
+        transfer: z.ZodMiniOptional<z.ZodMiniObject<{
+            modes: z.ZodMiniReadonly<z.ZodMiniArray<z.ZodMiniEnum<{
+                exactDestination: "exactDestination";
+                exactSource: "exactSource";
+            }>>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    /** Complete funding catalog content accepted by the publish boundary. */
+    const Data: z.ZodMiniObject<{
+        chainTokens: z.ZodMiniReadonly<z.ZodMiniArray<z.ZodMiniObject<{
+            address: z.ZodMiniString<string>;
+            chainId: z.ZodMiniString<string>;
+            decimals: z.ZodMiniNumber<number>;
+            name: z.ZodMiniNullable<z.ZodMiniString<string>>;
+            standard: z.ZodMiniString<string>;
+            tokenId: z.ZodMiniString<string>;
+        }, z.core.$strip>>>;
+        chains: z.ZodMiniReadonly<z.ZodMiniArray<z.ZodMiniObject<{
+            id: z.ZodMiniString<string>;
+            parentChainId: z.ZodMiniNullable<z.ZodMiniString<string>>;
+            aliases: z.ZodMiniReadonly<z.ZodMiniArray<z.ZodMiniString<string>>>;
+            name: z.ZodMiniString<string>;
+            rpcUrls: z.ZodMiniDefault<z.ZodMiniReadonly<z.ZodMiniArray<z.ZodMiniURL>>>;
+            slug: z.ZodMiniString<string>;
+        }, z.core.$strip>>>;
+        routes: z.ZodMiniReadonly<z.ZodMiniArray<z.ZodMiniObject<{
+            capabilities: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniObject<{
+                depositAddress: z.ZodMiniOptional<z.ZodMiniLiteral<true>>;
+                transfer: z.ZodMiniOptional<z.ZodMiniObject<{
+                    modes: z.ZodMiniReadonly<z.ZodMiniArray<z.ZodMiniEnum<{
+                        exactDestination: "exactDestination";
+                        exactSource: "exactSource";
+                    }>>>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>>;
+            destinationChainId: z.ZodMiniString<string>;
+            destinationTokenId: z.ZodMiniString<string>;
+            providerId: z.ZodMiniString<string>;
+            sourceChainId: z.ZodMiniString<string>;
+            sourceTokenId: z.ZodMiniString<string>;
+        }, z.core.$strip>>>;
+        tokens: z.ZodMiniReadonly<z.ZodMiniArray<z.ZodMiniObject<{
+            currency: z.ZodMiniString<string>;
+            id: z.ZodMiniString<string>;
+            name: z.ZodMiniString<string>;
+            symbol: z.ZodMiniString<string>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
+}
+/** Funding capabilities enabled on one provider route. */
+export type Capabilities = z.output<typeof schema.Capabilities>;
+/** One hydrated provider route in a funding catalog snapshot. */
+export type ProviderRoute = {
+    /** Funding capabilities; absent means the route is quote-only. */
+    capabilities?: Capabilities | undefined;
+    /** Funding provider that supports the route. */
+    providerId: string;
+    /** Hydrated source-to-destination funding route. */
+    route: Route.Route;
+};
+/** Compiled and indexed funding catalog. */
+export type Snapshot = {
+    /** Funding chains indexed by CAIP-2 id, slug, and alias. */
+    chainsByKey: ReadonlyMap<string, Chain.Chain>;
+    /** Hydrated provider routes in stable catalog order. */
+    routes: readonly ProviderRoute[];
+    /** Hydrated routes grouped by provider id. */
+    routesByProvider: ReadonlyMap<string, readonly Route.Route[]>;
+    /** Canonical funding tokens indexed by stable id. */
+    tokensById: ReadonlyMap<string, Token.Token>;
+    /** ISO timestamp of the catalog's last publish. */
+    updatedAt: string;
+    /** Opaque catalog version. */
+    version: string;
+};
+/** Compiles stored funding catalog rows into a validated snapshot. */
+export declare function compile(rows: core_Catalog.Rows): Snapshot;
+/** Reads and compiles the current funding catalog from Postgres. */
+export declare function read(db: Db.Db): Promise<Snapshot>;
+/** Publishes a complete funding catalog and primes the current isolate. */
+export declare function publish(db: Db.Db, input: publish.Input): Promise<Snapshot>;
+export declare namespace publish {
+    /** Complete funding catalog content. */
+    type Input = z.input<typeof schema.Data>;
+}
+/** Replaces the current isolate's compiled catalog snapshot. */
+export declare function prime(source: Db.Source, snapshot: Snapshot): Snapshot;
+/** Returns the current funding catalog snapshot with soft background refresh. */
+export declare function snapshot(c: Context<App.Environment>): Promise<Snapshot>;
+/** Error thrown when funding catalog references cannot be compiled. */
+export declare class InvalidCatalogError extends Error {
+    name: string;
+}
+//# sourceMappingURL=Catalog.d.ts.map

package/dist/internal/funding/Catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Catalog.d.ts","sourceRoot":"","sources":["../../../src/internal/funding/Catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AACnC,OAAO,KAAK,CAAC,MAAM,UAAU,CAAA;AAE7B,OAAO,KAAK,KAAK,GAAG,MAAM,cAAc,CAAA;AACxC,OAAO,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAEpC,OAAO,KAAK,YAAY,MAAM,mCAAmC,CAAA;AAEjE,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AAOnC,+BAA+B;AAC/B,yBAAiB,MAAM,CAAC;IAqBtB,0DAA0D;IACnD,MAAM,YAAY;;;;;;;;qBAetB,CAAA;IAQH,yEAAyE;IAClE,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBASwC,CAAA;CAC1D;AAED,0DAA0D;AAC1D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,MAAM,CAAC,YAAY,CAAC,CAAA;AAE/D,iEAAiE;AACjE,MAAM,MAAM,aAAa,GAAG;IAC1B,kEAAkE;IAClE,YAAY,CAAC,EAAE,YAAY,GAAG,SAAS,CAAA;IACvC,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAA;IAClB,oDAAoD;IACpD,KAAK,EAAE,KAAK,CAAC,KAAK,CAAA;CACnB,CAAA;AAED,4CAA4C;AAC5C,MAAM,MAAM,QAAQ,GAAG;IACrB,4DAA4D;IAC5D,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IAC7C,wDAAwD;IACxD,MAAM,EAAE,SAAS,aAAa,EAAE,CAAA;IAChC,8CAA8C;IAC9C,gBAAgB,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,KAAK,CAAC,KAAK,EAAE,CAAC,CAAA;IAC7D,qDAAqD;IACrD,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IAC5C,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAA;IACjB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,sEAAsE;AACtE,wBAAgB,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,IAAI,GAAG,QAAQ,CAqGzD;AAED,oEAAoE;AACpE,wBAAsB,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,CAEvD;AAED,2EAA2E;AAC3E,wBAAsB,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,CAYhF;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,wCAAwC;IACxC,KAAK,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,IAAI,CAAC,CAAA;CACzC;AAED,gEAAgE;AAChE,wBAAgB,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAGrE;AAED,iFAAiF;AACjF,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAgBvE;AAsFD,uEAAuE;AACvE,qBAAa,mBAAoB,SAAQ,KAAK;IACnC,IAAI,SAAwC;CACtD"}

package/dist/internal/funding/Catalog.js

@@ -0,0 +1,270 @@
+import * as z from 'zod/mini';
+import * as Db from '../../db/Db.js';
+import * as db_Schema from '../../db/Schema.js';
+import * as core_Catalog from '../../db/tables/fundingCatalog.js';
+import * as Timing from '../Timing.js';
+import * as Chain from './Chain.js';
+import * as Route from './Route.js';
+import * as Token from './Token.js';
+import * as Transfer from './Transfer.js';
+const defaultRefreshMs = 10_000;
+const emptyUpdatedAt = '1970-01-01T00:00:00.000Z';
+const emptyVersion = 'empty';
+/** Funding catalog schemas. */
+export var schema;
+(function (schema) {
+    const ChainId = z
+        .string()
+        .check(z.regex(/^(?:eip155:\d+|solana:[^:]+|tron:[^:]+)$/), z.describe('CAIP-2 funding chain identifier.'));
+    const Chain = z.extend(db_Schema.FundingChain, {
+        id: ChainId,
+        parentChainId: z.nullable(ChainId),
+    });
+    const TransferCapability = z
+        .object({
+        modes: z
+            .readonly(z.array(z.enum(Transfer.modes)))
+            .check(z.minLength(1), z.describe('Amount modes enabled for funding transfers.')),
+    })
+        .check(z.describe('Funding transfer capability enabled on one provider route.'));
+    /** Funding capabilities enabled on one provider route. */
+    schema.Capabilities = z
+        .object({
+        depositAddress: z
+            .optional(z.literal(true))
+            .check(z.describe('Deposit-address funding support enabled on the route.')),
+        transfer: z
+            .optional(TransferCapability)
+            .check(z.describe('Funding transfer support enabled on the route.')),
+    })
+        .check(z.refine((capabilities) => capabilities.depositAddress !== undefined || capabilities.transfer !== undefined), z.describe('Funding capabilities enabled on one provider route.'));
+    // Absent or null `capabilities` keeps a route quote-only, so transfer and
+    // deposit-address support enable through reviewed seed edits.
+    const Route = z.extend(db_Schema.FundingRoute, {
+        capabilities: z.optional(z.nullable(schema.Capabilities)),
+    });
+    /** Complete funding catalog content accepted by the publish boundary. */
+    schema.Data = z
+        .object({
+        chainTokens: z
+            .readonly(z.array(db_Schema.FundingChainToken))
+            .check(z.describe('Chain-scoped funding tokens.')),
+        chains: z.readonly(z.array(Chain)).check(z.describe('Funding chains.')),
+        routes: z.readonly(z.array(Route)).check(z.describe('Funding provider routes.')),
+        tokens: z.readonly(z.array(db_Schema.FundingToken)).check(z.describe('Funding tokens.')),
+    })
+        .check(z.describe('Complete funding catalog content.'));
+})(schema || (schema = {}));
+/** Compiles stored funding catalog rows into a validated snapshot. */
+export function compile(rows) {
+    const data = normalize({
+        chainTokens: rows.chainTokens,
+        chains: rows.chains,
+        routes: rows.routes,
+        tokens: rows.tokens,
+    });
+    if (!rows.catalog && hasContent(data))
+        throw new InvalidCatalogError('Catalog content exists without a version head.');
+    const chainIds = new Set(data.chains.map((chain) => chain.id));
+    const chainsById = new Map();
+    const chainsByKey = new Map();
+    for (const row of data.chains) {
+        if (row.parentChainId && !chainIds.has(row.parentChainId))
+            throw new InvalidCatalogError(`Unknown parent chain "${row.parentChainId}".`);
+        const chain = Chain.from({
+            aliases: row.aliases,
+            id: row.id,
+            name: row.name,
+            ...(row.parentChainId ? { parentChainId: row.parentChainId } : {}),
+            rpcUrls: row.rpcUrls,
+            slug: row.slug,
+        });
+        if (chainsById.has(chain.id))
+            throw new InvalidCatalogError(`Duplicate chain "${chain.id}".`);
+        chainsById.set(chain.id, chain);
+        for (const key of [chain.id, chain.slug, ...chain.aliases]) {
+            const normalized = normalizeKey(key);
+            if (chainsByKey.has(normalized))
+                throw new InvalidCatalogError(`Duplicate chain key "${key}".`);
+            chainsByKey.set(normalized, chain);
+        }
+    }
+    const configs = new Map();
+    const placements = new Set();
+    const tokenIds = new Set(data.tokens.map((token) => token.id));
+    for (const row of data.chainTokens) {
+        const chain = chainsById.get(row.chainId);
+        if (!chain)
+            throw new InvalidCatalogError(`Unknown chain "${row.chainId}" for token placement.`);
+        if (!tokenIds.has(row.tokenId))
+            throw new InvalidCatalogError(`Unknown token "${row.tokenId}" for token placement.`);
+        const placement = placementKey(row.chainId, row.tokenId);
+        if (placements.has(placement))
+            throw new InvalidCatalogError(`Duplicate token placement "${placement}".`);
+        placements.add(placement);
+        const chains = configs.get(row.tokenId) ?? {};
+        chains[chain.id] = {
+            address: row.address,
+            decimals: row.decimals,
+            ...(row.name ? { name: row.name } : {}),
+            standard: row.standard,
+        };
+        configs.set(row.tokenId, chains);
+    }
+    const tokensById = new Map();
+    for (const row of data.tokens) {
+        if (tokensById.has(row.id))
+            throw new InvalidCatalogError(`Duplicate token "${row.id}".`);
+        tokensById.set(row.id, Token.from({
+            chains: configs.get(row.id) ?? {},
+            currency: row.currency,
+            name: row.name,
+            slug: row.id,
+            symbol: row.symbol,
+        }));
+    }
+    const routes = [];
+    const routesByProvider = new Map();
+    for (const row of data.routes) {
+        const route = {
+            destination: resolvePlacement(chainsById, tokensById, row.destinationChainId, row.destinationTokenId),
+            source: resolvePlacement(chainsById, tokensById, row.sourceChainId, row.sourceTokenId),
+        };
+        routes.push({
+            ...(row.capabilities ? { capabilities: row.capabilities } : {}),
+            providerId: row.providerId,
+            route,
+        });
+        const providerRoutes = routesByProvider.get(row.providerId);
+        if (providerRoutes)
+            providerRoutes.push(route);
+        else
+            routesByProvider.set(row.providerId, [route]);
+    }
+    return {
+        chainsByKey,
+        routes,
+        routesByProvider,
+        tokensById,
+        updatedAt: rows.catalog?.updatedAt ?? emptyUpdatedAt,
+        version: rows.catalog?.version ?? emptyVersion,
+    };
+}
+/** Reads and compiles the current funding catalog from Postgres. */
+export async function read(db) {
+    return compile(await core_Catalog.read(db));
+}
+/** Publishes a complete funding catalog and primes the current isolate. */
+export async function publish(db, input) {
+    const data = normalize(input);
+    compile({
+        catalog: { id: 'default', updatedAt: emptyUpdatedAt, version: 'validation' },
+        ...data,
+    });
+    // Absent `capabilities` persists as null; both mean indicative-only.
+    await core_Catalog.publish(db, {
+        ...data,
+        routes: data.routes.map((route) => ({ ...route, capabilities: route.capabilities ?? null })),
+    });
+    return prime(db, await read(db));
+}
+/** Replaces the current isolate's compiled catalog snapshot. */
+export function prime(source, snapshot) {
+    cells.set(source, { checkedAt: Date.now(), snapshot });
+    return snapshot;
+}
+/** Returns the current funding catalog snapshot with soft background refresh. */
+export function snapshot(c) {
+    return Timing.time(c, 'funding_catalog', async () => {
+        const source = c.get('dbCached');
+        const cell = cells.get(source);
+        if (cell && Date.now() - cell.checkedAt < defaultRefreshMs)
+            return cell.snapshot;
+        if (cell) {
+            const pending = refresh(c, source, cell);
+            try {
+                c.executionCtx.waitUntil(pending);
+            }
+            catch {
+                void pending;
+            }
+            return cell.snapshot;
+        }
+        return refresh(c, source, undefined);
+    });
+}
+const cells = new WeakMap();
+const refreshing = new WeakMap();
+function refresh(c, source, current) {
+    const existing = refreshing.get(source);
+    if (existing)
+        return existing;
+    const pending = (async () => {
+        try {
+            const db = Db.get(source);
+            if (current) {
+                const head = await Timing.time(c, 'funding_catalog_head', () => core_Catalog.head(db));
+                if (!head || head.version === current.snapshot.version) {
+                    cells.set(source, { checkedAt: Date.now(), snapshot: current.snapshot });
+                    return current.snapshot;
+                }
+            }
+            const next = await read(db);
+            cells.set(source, { checkedAt: Date.now(), snapshot: next });
+            return next;
+        }
+        catch (error) {
+            if (!current)
+                throw error;
+            console.error('[funding-catalog] refresh failed; serving last good snapshot', error);
+            cells.set(source, { checkedAt: Date.now(), snapshot: current.snapshot });
+            return current.snapshot;
+        }
+        finally {
+            refreshing.delete(source);
+        }
+    })();
+    refreshing.set(source, pending);
+    return pending;
+}
+function hasContent(data) {
+    return (data.chains.length > 0 ||
+        data.tokens.length > 0 ||
+        data.chainTokens.length > 0 ||
+        data.routes.length > 0);
+}
+function normalize(input) {
+    const data = schema.Data.parse(input);
+    return {
+        ...data,
+        chainTokens: data.chainTokens.map((token) => ({
+            ...token,
+            address: token.chainId.startsWith('eip155:') ? token.address.toLowerCase() : token.address,
+        })),
+    };
+}
+function normalizeKey(key) {
+    return key.trim().toLowerCase();
+}
+function placementKey(chainId, tokenId) {
+    return `${chainId}:${tokenId}`;
+}
+function resolvePlacement(chains, tokens, chainId, tokenId) {
+    const chain = chains.get(chainId);
+    if (!chain)
+        throw new InvalidCatalogError(`Unknown route chain "${chainId}".`);
+    const token = tokens.get(tokenId);
+    if (!token)
+        throw new InvalidCatalogError(`Unknown route token "${tokenId}".`);
+    try {
+        return Token.resolve(token, chain);
+    }
+    catch {
+        throw new InvalidCatalogError(`Unknown route token placement "${placementKey(chainId, tokenId)}".`);
+    }
+}
+/** Error thrown when funding catalog references cannot be compiled. */
+export class InvalidCatalogError extends Error {
+    name = 'Funding.Catalog.InvalidCatalogError';
+}
+//# sourceMappingURL=Catalog.js.map

package/dist/internal/funding/Catalog.js.map

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

package/dist/internal/funding/Chain.d.ts

@@ -0,0 +1,76 @@
+import * as Token from './Token.js';
+/** Canonical identifier for a funding chain. */
+export type Id = `eip155:${number}` | `solana:${string}` | `tron:${string}`;
+/** Chain metadata for a funding token. */
+export type Chain = Callable & ((Base & {
+    /** Address encoding used by accounts and tokens on the chain. */
+    addressFormat: 'hex';
+    /** Chain execution family. */
+    kind: 'evm';
+}) | (Base & {
+    /** Address encoding used by accounts and tokens on the chain. */
+    addressFormat: 'base58';
+    /** Chain execution family. */
+    kind: 'solana';
+}) | (Base & {
+    /** Address encoding used by accounts and tokens on the chain. */
+    addressFormat: 'base58check';
+    /** Chain execution family. */
+    kind: 'tron';
+}));
+type Callable = (options: Callable.Options) => Selection;
+declare namespace Callable {
+    /** Tokens selected for a funding route on this chain. */
+    type Options = {
+        /** Token definitions to resolve on the chain. */
+        tokens: readonly Token.Token[];
+    };
+}
+/** Tokens resolved for one funding chain. */
+export type Selection = {
+    /** Chain shared by every selected token. */
+    chain: Chain;
+    /** Chain-scoped funding tokens. */
+    tokens: readonly Token.Resolved[];
+};
+type Base = {
+    /** Caller-facing aliases accepted for this chain. */
+    aliases: readonly string[];
+    /** CAIP-2 chain identifier. */
+    id: Id;
+    /** Human-readable chain name. */
+    name: string;
+    /** Parent chain identifier when this chain is a Zone. */
+    parentChainId?: Id | undefined;
+    /** Public RPC endpoints used for funding-chain evidence. */
+    rpcUrls: readonly string[];
+    /** Stable chain segment used in quote identifiers. */
+    slug: string;
+};
+/** Creates funding chain metadata from a CAIP-2 identifier. */
+export declare function from(options: from.Options): Chain;
+export declare namespace from {
+    /** Funding chain definition. */
+    type Options = {
+        /** Additional caller-facing aliases accepted for this chain. */
+        aliases?: readonly string[] | undefined;
+        /** CAIP-2 chain identifier. */
+        id: Id;
+        /** Human-readable chain name. */
+        name: string;
+        /** Parent chain identifier when this chain is a Zone. */
+        parentChainId?: Id | undefined;
+        /** Public RPC endpoints used for funding-chain evidence. */
+        rpcUrls?: readonly string[] | undefined;
+        /** Stable chain segment used in quote identifiers. */
+        slug: string;
+    };
+}
+/** Returns the numeric portion of an EIP-155 CAIP-2 chain identifier. */
+export declare function eip155Id(chain: Chain): string;
+/** Error thrown when a funding chain identifier is invalid for an operation. */
+export declare class InvalidIdError extends Error {
+    name: string;
+}
+export {};
+//# sourceMappingURL=Chain.d.ts.map

package/dist/internal/funding/Chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Chain.d.ts","sourceRoot":"","sources":["../../../src/internal/funding/Chain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AAEnC,gDAAgD;AAChD,MAAM,MAAM,EAAE,GAAG,UAAU,MAAM,EAAE,GAAG,UAAU,MAAM,EAAE,GAAG,QAAQ,MAAM,EAAE,CAAA;AAE3E,0CAA0C;AAC1C,MAAM,MAAM,KAAK,GAAG,QAAQ,GAC1B,CACI,CAAC,IAAI,GAAG;IACN,iEAAiE;IACjE,aAAa,EAAE,KAAK,CAAA;IACpB,8BAA8B;IAC9B,IAAI,EAAE,KAAK,CAAA;CACZ,CAAC,GACF,CAAC,IAAI,GAAG;IACN,iEAAiE;IACjE,aAAa,EAAE,QAAQ,CAAA;IACvB,8BAA8B;IAC9B,IAAI,EAAE,QAAQ,CAAA;CACf,CAAC,GACF,CAAC,IAAI,GAAG;IACN,iEAAiE;IACjE,aAAa,EAAE,aAAa,CAAA;IAC5B,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAA;CACb,CAAC,CACL,CAAA;AAEH,KAAK,QAAQ,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,KAAK,SAAS,CAAA;AAExD,OAAO,WAAW,QAAQ,CAAC;IACzB,yDAAyD;IACzD,KAAK,OAAO,GAAG;QACb,iDAAiD;QACjD,MAAM,EAAE,SAAS,KAAK,CAAC,KAAK,EAAE,CAAA;KAC/B,CAAA;CACF;AAED,6CAA6C;AAC7C,MAAM,MAAM,SAAS,GAAG;IACtB,4CAA4C;IAC5C,KAAK,EAAE,KAAK,CAAA;IACZ,mCAAmC;IACnC,MAAM,EAAE,SAAS,KAAK,CAAC,QAAQ,EAAE,CAAA;CAClC,CAAA;AAED,KAAK,IAAI,GAAG;IACV,qDAAqD;IACrD,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1B,+BAA+B;IAC/B,EAAE,EAAE,EAAE,CAAA;IACN,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,yDAAyD;IACzD,aAAa,CAAC,EAAE,EAAE,GAAG,SAAS,CAAA;IAC9B,4DAA4D;IAC5D,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1B,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,+DAA+D;AAC/D,wBAAgB,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,GAAG,KAAK,CA2BjD;AAED,MAAM,CAAC,OAAO,WAAW,IAAI,CAAC;IAC5B,gCAAgC;IAChC,KAAK,OAAO,GAAG;QACb,gEAAgE;QAChE,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;QACvC,+BAA+B;QAC/B,EAAE,EAAE,EAAE,CAAA;QACN,iCAAiC;QACjC,IAAI,EAAE,MAAM,CAAA;QACZ,yDAAyD;QACzD,aAAa,CAAC,EAAE,EAAE,GAAG,SAAS,CAAA;QAC9B,4DAA4D;QAC5D,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;QACvC,sDAAsD;QACtD,IAAI,EAAE,MAAM,CAAA;KACb,CAAA;CACF;AAED,yEAAyE;AACzE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAI7C;AAED,gFAAgF;AAChF,qBAAa,cAAe,SAAQ,KAAK;IAC9B,IAAI,SAAiC;CAC/C"}

package/dist/internal/funding/Chain.js

@@ -0,0 +1,38 @@
+import * as Token from './Token.js';
+/** Creates funding chain metadata from a CAIP-2 identifier. */
+export function from(options) {
+    const { aliases = [], id, name, parentChainId, rpcUrls = [], slug } = options;
+    const base = { aliases, id, name, ...(parentChainId ? { parentChainId } : {}), rpcUrls, slug };
+    const metadata = (() => {
+        if (id.startsWith('eip155:'))
+            return { ...base, addressFormat: 'hex', kind: 'evm' };
+        if (id.startsWith('solana:'))
+            return { ...base, addressFormat: 'base58', kind: 'solana' };
+        if (id.startsWith('tron:'))
+            return { ...base, addressFormat: 'base58check', kind: 'tron' };
+        throw new InvalidIdError();
+    })();
+    function select(parameters) {
+        const chain = select;
+        return {
+            chain,
+            tokens: parameters.tokens.map((token) => Token.resolve(token, chain)),
+        };
+    }
+    return Object.defineProperties(select, Object.fromEntries(Object.entries(metadata).map(([key, value]) => [
+        key,
+        { configurable: true, enumerable: true, value },
+    ])));
+}
+/** Returns the numeric portion of an EIP-155 CAIP-2 chain identifier. */
+export function eip155Id(chain) {
+    const match = /^eip155:(\d+)$/.exec(chain.id);
+    if (!match?.[1])
+        throw new InvalidIdError();
+    return match[1];
+}
+/** Error thrown when a funding chain identifier is invalid for an operation. */
+export class InvalidIdError extends Error {
+    name = 'Funding.Chain.InvalidIdError';
+}
+//# sourceMappingURL=Chain.js.map

package/dist/internal/funding/Chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Chain.js","sourceRoot":"","sources":["../../../src/internal/funding/Chain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AA6DnC,+DAA+D;AAC/D,MAAM,UAAU,IAAI,CAAC,OAAqB;IACxC,MAAM,EAAE,OAAO,GAAG,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,GAAG,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,CAAA;IAC7E,MAAM,IAAI,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IAC9F,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE;QACrB,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,EAAE,GAAG,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAW,CAAA;QAC5F,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;YAC1B,OAAO,EAAE,GAAG,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAW,CAAA;QACtE,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;YACxB,OAAO,EAAE,GAAG,IAAI,EAAE,aAAa,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAW,CAAA;QACzE,MAAM,IAAI,cAAc,EAAE,CAAA;IAC5B,CAAC,CAAC,EAAE,CAAA;IACJ,SAAS,MAAM,CAAC,UAA4B;QAC1C,MAAM,KAAK,GAAG,MAAe,CAAA;QAC7B,OAAO;YACL,KAAK;YACL,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;SACtE,CAAA;IACH,CAAC;IACD,OAAO,MAAM,CAAC,gBAAgB,CAC5B,MAAM,EACN,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;QAC7C,GAAG;QACH,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE;KAChD,CAAC,CACH,CACO,CAAA;AACZ,CAAC;AAoBD,yEAAyE;AACzE,MAAM,UAAU,QAAQ,CAAC,KAAY;IACnC,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAC7C,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAAE,MAAM,IAAI,cAAc,EAAE,CAAA;IAC3C,OAAO,KAAK,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC;AAED,gFAAgF;AAChF,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC9B,IAAI,GAAG,8BAA8B,CAAA;CAC/C"}