@defuse-protocol/nearintents-mpp-sdk 0.0.0 → 0.1.0

package/dist/internal/OneClick.d.ts

@@ -0,0 +1,243 @@
+import { Errors } from 'mppx';
+/**
+ * 1Click Swap API settlement core.
+ *
+ * Thin, dependency-free client for the three endpoints this method uses
+ * (`POST /v0/quote`, `POST /v0/deposit/submit`, `GET /v0/status`) plus the
+ * token-list-driven CAIP-19 ↔ 1Click asset mapping and the terminal-state →
+ * MPP problem-type mapping. Everything is injectable (`fetch`, `baseUrl`) so
+ * tests run against the in-process mock — never live 1Click.
+ *
+ * Designed to be shared with the x402 1CS Gateway workstream: one settlement
+ * core, two protocol adapters.
+ */
+export declare const defaultBaseUrl = "https://1click.chaindefuser.com";
+export type Config = {
+    /** API base URL. @default "https://1click.chaindefuser.com" */
+    baseUrl?: string | undefined;
+    /**
+     * Partner JWT (env `ONE_CLICK_JWT`). Server-side only — MUST never appear
+     * in any challenge field. Unauthenticated requests incur a 0.2% fee.
+     */
+    jwt?: string | undefined;
+    /** Fetch implementation. @default globalThis.fetch */
+    fetch?: typeof globalThis.fetch | undefined;
+    /** Per-request timeout in milliseconds. @default 30000 */
+    requestTimeoutMs?: number | undefined;
+    /** Additional CAIP-2 → 1Click blockchain-code entries, merged over {@link defaultNetworks}. */
+    networks?: Record<string, string> | undefined;
+    /** Additional blockchain-code → SLIP-44 coin-type entries, merged over {@link defaultNativeCoinTypes}. */
+    nativeCoinTypes?: Record<string, number> | undefined;
+};
+/**
+ * The 1Click API request failed (application error or unusable response).
+ * Note {@link OneClickUnavailableError} (network failure / 5xx) is a subclass —
+ * narrow on it first when the distinction matters.
+ */
+export declare class OneClickError extends Error {
+    readonly name: string;
+    readonly status: number;
+    readonly body: unknown;
+    constructor(message: string, options?: {
+        status?: number;
+        body?: unknown;
+        cause?: unknown;
+    });
+}
+/**
+ * The 1Click API was unreachable or returned a server error (network failure
+ * or HTTP 5xx). Per the spec, callers MUST surface this as an HTTP 5xx —
+ * never as `verification-failed` — and MUST NOT settle the credential.
+ */
+export declare class OneClickUnavailableError extends OneClickError {
+    readonly name = "OneClickUnavailableError";
+}
+/** `pollToTerminal` exceeded its time budget without reaching a terminal status. */
+export declare class PollTimeoutError extends Error {
+    readonly name = "PollTimeoutError";
+    /** Last successfully observed status, if any poll succeeded. */
+    readonly lastStatus: SwapStatus | undefined;
+    /** Last transport error, if polling was failing when the budget ran out. */
+    readonly lastError: unknown;
+    constructor(options: {
+        timeoutMs: number;
+        lastStatus?: SwapStatus;
+        lastError?: unknown;
+    });
+}
+export type TokenInfo = {
+    /** 1Click-native asset id (e.g. `nep141:arb-0xaf88….omft.near`). */
+    assetId: string;
+    decimals: number;
+    /** 1Click blockchain code (e.g. "arb", "btc", "near"). */
+    blockchain: string;
+    symbol: string;
+    /** Absent for chain-native assets (e.g. BTC). */
+    contractAddress?: string | undefined;
+};
+export type Quote = {
+    /** Unique single-use deposit address on the origin chain. */
+    depositAddress: string;
+    /** Required alongside the deposit on memo-based chains (e.g. Stellar). */
+    depositMemo?: string | undefined;
+    /** Input amount with slippage buffer baked in — the challenge `amount`. */
+    amountIn: string;
+    /** Minimum input that still guarantees `amountOut` — the verification threshold. */
+    minAmountIn: string;
+    /** Exact output amount the merchant receives (EXACT_OUTPUT). */
+    amountOut: string;
+    minAmountOut?: string | undefined;
+    /** Deposit deadline (ISO 8601) — the challenge `expires` upper bound. */
+    deadline: string;
+    timeWhenInactive?: string | undefined;
+    /** Estimated swap completion time in seconds after deposit confirmation. */
+    timeEstimate: number;
+};
+export type QuoteResult = {
+    quote: Quote;
+    /** Echo of the quote request. */
+    quoteRequest: Record<string, unknown>;
+    /** 1Click service signature over the quote — persist for dispute resolution. */
+    signature?: string | undefined;
+    timestamp?: string | undefined;
+};
+export type SwapStatus = 'KNOWN_DEPOSIT_TX' | 'PENDING_DEPOSIT' | 'INCOMPLETE_DEPOSIT' | 'PROCESSING' | 'SUCCESS' | 'REFUNDED' | 'FAILED';
+export type TransactionDetails = {
+    hash: string;
+    explorerUrl?: string | undefined;
+};
+export type SwapDetails = {
+    originChainTxHashes?: TransactionDetails[] | undefined;
+    destinationChainTxHashes?: TransactionDetails[] | undefined;
+    intentHashes?: string[] | undefined;
+    nearTxHashes?: string[] | undefined;
+    amountIn?: string | undefined;
+    amountOut?: string | undefined;
+    depositedAmount?: string | undefined;
+    refundedAmount?: string | undefined;
+    refundReason?: string | undefined;
+};
+export type StatusResult = {
+    status: SwapStatus;
+    updatedAt?: string | undefined;
+    swapDetails?: SwapDetails | undefined;
+    quoteResponse?: Record<string, unknown> | undefined;
+};
+/**
+ * Terminal settlement statuses per the spec (§Settlement Procedure): the swap
+ * either delivered (`SUCCESS`) or the deposit is refunded to `refundTo`.
+ * `INCOMPLETE_DEPOSIT` is treated as terminal for settlement even though the
+ * backend may still accept top-ups before the deadline.
+ */
+export declare const terminalStatuses: readonly ["SUCCESS", "FAILED", "REFUNDED", "INCOMPLETE_DEPOSIT"];
+export declare function isTerminal(status: SwapStatus): boolean;
+/** Fetches the supported token list (`GET /v0/tokens`). No auth required. */
+export declare function getTokens(config: Config): Promise<TokenInfo[]>;
+export type QuoteParameters = {
+    /** Origin asset as a 1Click asset id (map from CAIP-19 via {@link AssetMap}). */
+    originAsset: string;
+    /** Destination asset as a 1Click asset id. */
+    destinationAsset: string;
+    /** Exact output amount the merchant must receive, in base units (EXACT_OUTPUT). */
+    amountOut: string;
+    /** Merchant address on the destination chain. */
+    recipient: string;
+    /** Merchant-configured refund address on the origin chain. */
+    refundTo: string;
+    /** Slippage tolerance in basis points (applied to the input side). */
+    slippageTolerance: number;
+    /** Quote/deposit deadline (ISO 8601). Size to the origin chain (BTC ≈ 45–60 min). */
+    deadline: string;
+    /** `SIMPLE` (default) or `MEMO` for memo-based chains. */
+    depositMode?: 'SIMPLE' | 'MEMO' | undefined;
+    referral?: string | undefined;
+    sessionId?: string | undefined;
+    quoteWaitingTimeMs?: number | undefined;
+    /** Escape hatch merged last into the raw request body. */
+    overrides?: Record<string, unknown> | undefined;
+};
+/**
+ * Requests a wet (`dry: false`) EXACT_OUTPUT quote (`POST /v0/quote`),
+ * yielding the unique single-use deposit address for one challenge.
+ */
+export declare function quote(config: Config, parameters: QuoteParameters): Promise<QuoteResult>;
+/**
+ * Notifies 1Click of a sent deposit (`POST /v0/deposit/submit`). Optional but
+ * recommended after verification — it accelerates deposit detection.
+ */
+export declare function submitDeposit(config: Config, parameters: {
+    txHash: string;
+    depositAddress: string;
+    memo?: string | undefined;
+}): Promise<StatusResult>;
+/** Fetches the swap status for a deposit address (`GET /v0/status`). */
+export declare function getStatus(config: Config, parameters: {
+    depositAddress: string;
+    depositMemo?: string | undefined;
+}): Promise<StatusResult>;
+export type PollParameters = {
+    depositAddress: string;
+    depositMemo?: string | undefined;
+    /** Total time budget. Derive from the challenge window + `timeEstimate` + margin. */
+    timeoutMs: number;
+    /** Delay between polls. @default 2000 */
+    intervalMs?: number | undefined;
+    /** Invoked once per observed status change (not per poll tick). */
+    onStatus?: ((status: SwapStatus) => void) | undefined;
+    signal?: AbortSignal | undefined;
+};
+/**
+ * Polls the status endpoint until a terminal status ({@link terminalStatuses})
+ * or the time budget is exceeded.
+ *
+ * Transient transport failures ({@link OneClickUnavailableError}) are retried
+ * until the budget runs out; if the budget ends on a failing endpoint the last
+ * error is rethrown (so callers surface 5xx, not a false timeout). A budget
+ * that ends while the swap is still in flight throws {@link PollTimeoutError}.
+ */
+export declare function pollToTerminal(config: Config, parameters: PollParameters): Promise<StatusResult>;
+/**
+ * Maps a non-success terminal status to its MPP problem type:
+ * `INCOMPLETE_DEPOSIT` → `payment-insufficient`; `FAILED`/`REFUNDED` →
+ * `settlement-failed`. Returns `undefined` for `SUCCESS`. Throws if the
+ * status is not terminal.
+ */
+export declare function terminalError(result: StatusResult): Errors.PaymentError | undefined;
+/** Extracts the destination-chain delivery tx hash (the receipt `reference`). */
+export declare function destinationTxHash(result: StatusResult): string | undefined;
+/**
+ * Checks whether the credential's `payload.hash` is among the origin-chain
+ * transactions the backend observed for this deposit address — the spec's
+ * status-observation deposit confirmation. Hex hashes compare
+ * case-insensitively; other formats (base58, …) compare exactly.
+ */
+export declare function matchesOriginTx(result: StatusResult, hash: string): boolean;
+/**
+ * CAIP-2 chain identifier → 1Click blockchain code, for chains whose CAIP-2
+ * form is well established. Extensible per-instance via `Config.networks` —
+ * unsupported chains need a config entry, not a package release.
+ */
+export declare const defaultNetworks: Record<string, string>;
+/**
+ * 1Click blockchain code → SLIP-44 coin type used to render chain-native
+ * assets (`<caip2>/slip44:<coinType>`). Extensible via `Config.nativeCoinTypes`.
+ */
+export declare const defaultNativeCoinTypes: Record<string, number>;
+export type AssetMap = {
+    /** Resolves a CAIP-19 asset id to the matching 1Click token, or `undefined`. */
+    tokenOf(caip19Id: string): TokenInfo | undefined;
+    /** Resolves a CAIP-19 asset id to a 1Click asset id, or `undefined`. */
+    toAssetId(caip19Id: string): string | undefined;
+    /** Renders a 1Click asset id as a CAIP-19 asset id, or `undefined` when unmapped. */
+    toCaip19(assetId: string): string | undefined;
+};
+/**
+ * Builds a bidirectional CAIP-19 ↔ 1Click asset map from the `/v0/tokens`
+ * list. Contract assets match on `contractAddress` (case-insensitively for
+ * `eip155` chains); `slip44` assets match the chain's token that has no
+ * `contractAddress` (chain-native), and only for the chain's canonical coin
+ * type — a wrong coin type resolves to nothing rather than silently mapping
+ * to the native asset.
+ */
+export declare function createAssetMap(tokens: TokenInfo[], config?: Config): AssetMap;
+//# sourceMappingURL=OneClick.d.ts.map

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

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

package/dist/internal/OneClick.js

@@ -0,0 +1,422 @@
+import { Errors } from 'mppx';
+import { SettlementFailedError } from '../Errors.js';
+import * as Types from '../Types.js';
+/**
+ * 1Click Swap API settlement core.
+ *
+ * Thin, dependency-free client for the three endpoints this method uses
+ * (`POST /v0/quote`, `POST /v0/deposit/submit`, `GET /v0/status`) plus the
+ * token-list-driven CAIP-19 ↔ 1Click asset mapping and the terminal-state →
+ * MPP problem-type mapping. Everything is injectable (`fetch`, `baseUrl`) so
+ * tests run against the in-process mock — never live 1Click.
+ *
+ * Designed to be shared with the x402 1CS Gateway workstream: one settlement
+ * core, two protocol adapters.
+ */
+export const defaultBaseUrl = 'https://1click.chaindefuser.com';
+// ---------------------------------------------------------------------------
+// Errors
+// ---------------------------------------------------------------------------
+/**
+ * The 1Click API request failed (application error or unusable response).
+ * Note {@link OneClickUnavailableError} (network failure / 5xx) is a subclass —
+ * narrow on it first when the distinction matters.
+ */
+export class OneClickError extends Error {
+    name = 'OneClickError';
+    status;
+    body;
+    constructor(message, options = {}) {
+        super(message, options.cause !== undefined ? { cause: options.cause } : undefined);
+        this.status = options.status ?? 0;
+        this.body = options.body;
+    }
+}
+/**
+ * The 1Click API was unreachable or returned a server error (network failure
+ * or HTTP 5xx). Per the spec, callers MUST surface this as an HTTP 5xx —
+ * never as `verification-failed` — and MUST NOT settle the credential.
+ */
+export class OneClickUnavailableError extends OneClickError {
+    name = 'OneClickUnavailableError';
+}
+/** `pollToTerminal` exceeded its time budget without reaching a terminal status. */
+export class PollTimeoutError extends Error {
+    name = 'PollTimeoutError';
+    /** Last successfully observed status, if any poll succeeded. */
+    lastStatus;
+    /** Last transport error, if polling was failing when the budget ran out. */
+    lastError;
+    constructor(options) {
+        super(`1Click status polling timed out after ${options.timeoutMs}ms` +
+            (options.lastStatus ? ` (last status: ${options.lastStatus})` : ''));
+        this.lastStatus = options.lastStatus;
+        this.lastError = options.lastError;
+    }
+}
+/**
+ * Terminal settlement statuses per the spec (§Settlement Procedure): the swap
+ * either delivered (`SUCCESS`) or the deposit is refunded to `refundTo`.
+ * `INCOMPLETE_DEPOSIT` is treated as terminal for settlement even though the
+ * backend may still accept top-ups before the deadline.
+ */
+export const terminalStatuses = ['SUCCESS', 'FAILED', 'REFUNDED', 'INCOMPLETE_DEPOSIT'];
+export function isTerminal(status) {
+    return terminalStatuses.includes(status);
+}
+// ---------------------------------------------------------------------------
+// HTTP core
+// ---------------------------------------------------------------------------
+async function request(config, path, init) {
+    const baseUrl = config.baseUrl ?? defaultBaseUrl;
+    const fetchFn = config.fetch ?? globalThis.fetch;
+    const url = new URL(path, baseUrl);
+    for (const [key, value] of Object.entries(init.searchParams ?? {})) {
+        url.searchParams.set(key, value);
+    }
+    let response;
+    try {
+        response = await fetchFn(url, {
+            method: init.method,
+            headers: {
+                accept: 'application/json',
+                ...(init.body !== undefined && { 'content-type': 'application/json' }),
+                ...(config.jwt && { authorization: `Bearer ${config.jwt}` }),
+            },
+            ...(init.body !== undefined && { body: JSON.stringify(init.body) }),
+            signal: AbortSignal.timeout(config.requestTimeoutMs ?? 30_000),
+        });
+    }
+    catch (error) {
+        throw new OneClickUnavailableError(`1Click request failed: ${init.method} ${path}`, {
+            cause: error,
+        });
+    }
+    const body = await response.json().catch(() => undefined);
+    if (response.status >= 500)
+        throw new OneClickUnavailableError(`1Click returned ${response.status} for ${init.method} ${path}`, { status: response.status, body });
+    if (!response.ok)
+        throw new OneClickError(`1Click returned ${response.status} for ${init.method} ${path}: ${detailOf(body)}`, { status: response.status, body });
+    return body;
+}
+function detailOf(body) {
+    if (body && typeof body === 'object' && 'message' in body)
+        return String(body.message);
+    return body === undefined ? 'no response body' : JSON.stringify(body);
+}
+// ---------------------------------------------------------------------------
+// Endpoints
+// ---------------------------------------------------------------------------
+/** Fetches the supported token list (`GET /v0/tokens`). No auth required. */
+export async function getTokens(config) {
+    const tokens = await request(config, '/v0/tokens', { method: 'GET' });
+    if (!Array.isArray(tokens))
+        throw new OneClickError('1Click token list response is not an array.', { body: tokens });
+    return tokens;
+}
+/**
+ * Requests a wet (`dry: false`) EXACT_OUTPUT quote (`POST /v0/quote`),
+ * yielding the unique single-use deposit address for one challenge.
+ */
+export async function quote(config, parameters) {
+    const { amountOut, deadline, depositMode, destinationAsset, originAsset, overrides, quoteWaitingTimeMs, recipient, referral, refundTo, sessionId, slippageTolerance, } = parameters;
+    const body = {
+        dry: false,
+        swapType: 'EXACT_OUTPUT',
+        depositType: 'ORIGIN_CHAIN',
+        recipientType: 'DESTINATION_CHAIN',
+        refundType: 'ORIGIN_CHAIN',
+        amount: amountOut,
+        originAsset,
+        destinationAsset,
+        recipient,
+        refundTo,
+        slippageTolerance,
+        deadline,
+        ...(depositMode !== undefined && { depositMode }),
+        ...(referral !== undefined && { referral }),
+        ...(sessionId !== undefined && { sessionId }),
+        ...(quoteWaitingTimeMs !== undefined && { quoteWaitingTimeMs }),
+        ...overrides,
+    };
+    const result = await request(config, '/v0/quote', { method: 'POST', body });
+    const quote_ = result?.quote;
+    for (const field of ['depositAddress', 'amountIn', 'minAmountIn', 'deadline']) {
+        if (!quote_?.[field])
+            throw new OneClickError(`1Click quote response is missing "quote.${field}".`, {
+                body: result,
+            });
+    }
+    return {
+        quote: quote_,
+        quoteRequest: result.quoteRequest ?? body,
+        ...(hasString(result, 'signature') && { signature: result.signature }),
+        ...(hasString(result, 'timestamp') && { timestamp: result.timestamp }),
+    };
+}
+function hasString(value, key) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        typeof value[key] === 'string');
+}
+/**
+ * Notifies 1Click of a sent deposit (`POST /v0/deposit/submit`). Optional but
+ * recommended after verification — it accelerates deposit detection.
+ */
+export async function submitDeposit(config, parameters) {
+    const { depositAddress, memo, txHash } = parameters;
+    return request(config, '/v0/deposit/submit', {
+        method: 'POST',
+        body: { txHash, depositAddress, ...(memo !== undefined && { memo }) },
+    });
+}
+/** Fetches the swap status for a deposit address (`GET /v0/status`). */
+export async function getStatus(config, parameters) {
+    const { depositAddress, depositMemo } = parameters;
+    return request(config, '/v0/status', {
+        method: 'GET',
+        searchParams: {
+            depositAddress,
+            ...(depositMemo !== undefined && { depositMemo }),
+        },
+    });
+}
+/**
+ * Polls the status endpoint until a terminal status ({@link terminalStatuses})
+ * or the time budget is exceeded.
+ *
+ * Transient transport failures ({@link OneClickUnavailableError}) are retried
+ * until the budget runs out; if the budget ends on a failing endpoint the last
+ * error is rethrown (so callers surface 5xx, not a false timeout). A budget
+ * that ends while the swap is still in flight throws {@link PollTimeoutError}.
+ */
+export async function pollToTerminal(config, parameters) {
+    const { depositAddress, depositMemo, onStatus, signal, timeoutMs } = parameters;
+    const intervalMs = parameters.intervalMs ?? 2000;
+    const deadline = Date.now() + timeoutMs;
+    let lastStatus;
+    let lastError;
+    while (true) {
+        signal?.throwIfAborted();
+        try {
+            const result = await getStatus(config, { depositAddress, depositMemo });
+            if (result.status !== lastStatus)
+                onStatus?.(result.status);
+            lastStatus = result.status;
+            lastError = undefined;
+            if (isTerminal(result.status))
+                return result;
+        }
+        catch (error) {
+            if (!(error instanceof OneClickUnavailableError))
+                throw error;
+            lastError = error;
+        }
+        if (Date.now() + intervalMs > deadline) {
+            if (lastError !== undefined)
+                throw lastError;
+            throw new PollTimeoutError({
+                timeoutMs,
+                ...(lastStatus !== undefined && { lastStatus }),
+            });
+        }
+        await sleep(intervalMs, signal);
+    }
+}
+function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(signal.reason ?? new Error('Aborted.'));
+            return;
+        }
+        const timer = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(signal?.reason ?? new Error('Aborted.'));
+        };
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+// ---------------------------------------------------------------------------
+// Terminal-state → MPP problem mapping (spec §Error Codes)
+// ---------------------------------------------------------------------------
+/**
+ * Maps a non-success terminal status to its MPP problem type:
+ * `INCOMPLETE_DEPOSIT` → `payment-insufficient`; `FAILED`/`REFUNDED` →
+ * `settlement-failed`. Returns `undefined` for `SUCCESS`. Throws if the
+ * status is not terminal.
+ */
+export function terminalError(result) {
+    const { status, swapDetails } = result;
+    switch (status) {
+        case 'SUCCESS':
+            return undefined;
+        case 'INCOMPLETE_DEPOSIT':
+            return new Errors.PaymentInsufficientError({
+                reason: swapDetails?.depositedAmount
+                    ? `deposit of ${swapDetails.depositedAmount} is below the required minimum`
+                    : 'deposit is below the required minimum',
+            });
+        case 'FAILED':
+        case 'REFUNDED':
+            return new SettlementFailedError({
+                reason: swapDetails?.refundReason ?? `1Click terminal status ${status}`,
+            });
+        default:
+            throw new Error(`Status "${status}" is not terminal.`);
+    }
+}
+/** Extracts the destination-chain delivery tx hash (the receipt `reference`). */
+export function destinationTxHash(result) {
+    return result.swapDetails?.destinationChainTxHashes?.[0]?.hash;
+}
+/**
+ * Checks whether the credential's `payload.hash` is among the origin-chain
+ * transactions the backend observed for this deposit address — the spec's
+ * status-observation deposit confirmation. Hex hashes compare
+ * case-insensitively; other formats (base58, …) compare exactly.
+ */
+export function matchesOriginTx(result, hash) {
+    const hashes = result.swapDetails?.originChainTxHashes ?? [];
+    return hashes.some((tx) => txHashEqual(tx.hash, hash));
+}
+function txHashEqual(a, b) {
+    const hexLike = /^(0x)?[0-9a-fA-F]{16,}$/;
+    if (hexLike.test(a) && hexLike.test(b))
+        return normalizeHex(a) === normalizeHex(b);
+    return a === b;
+}
+function normalizeHex(hash) {
+    return hash.toLowerCase().replace(/^0x/, '');
+}
+// ---------------------------------------------------------------------------
+// CAIP-19 ↔ 1Click asset mapping (token-list driven)
+// ---------------------------------------------------------------------------
+/**
+ * CAIP-2 chain identifier → 1Click blockchain code, for chains whose CAIP-2
+ * form is well established. Extensible per-instance via `Config.networks` —
+ * unsupported chains need a config entry, not a package release.
+ */
+export const defaultNetworks = {
+    'near:mainnet': 'near',
+    'eip155:1': 'eth',
+    'eip155:10': 'op',
+    'eip155:56': 'bsc',
+    'eip155:100': 'gnosis',
+    'eip155:137': 'pol',
+    'eip155:143': 'monad',
+    'eip155:196': 'xlayer',
+    'eip155:8453': 'base',
+    'eip155:42161': 'arb',
+    'eip155:43114': 'avax',
+    'eip155:80094': 'bera',
+    'eip155:534352': 'scroll',
+    'bip122:000000000019d6689c085ae165831e93': 'btc',
+    'bip122:12a765e31ffd4059bada1e25190f6e98': 'ltc',
+    'bip122:1a91e3dace36e2be3bf030a65679fe82': 'doge',
+    'bip122:000000000000000000651ef99cb9fcbe': 'bch',
+    'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp': 'sol',
+    'ton:-239': 'ton',
+    'sui:mainnet': 'sui',
+    'stellar:pubnet': 'stellar',
+    'xrpl:0': 'xrp',
+    'starknet:SN_MAIN': 'starknet',
+};
+/**
+ * 1Click blockchain code → SLIP-44 coin type used to render chain-native
+ * assets (`<caip2>/slip44:<coinType>`). Extensible via `Config.nativeCoinTypes`.
+ */
+export const defaultNativeCoinTypes = {
+    btc: 0,
+    ltc: 2,
+    doge: 3,
+    bch: 145,
+    eth: 60,
+    base: 60,
+    arb: 60,
+    op: 60,
+    scroll: 60,
+    bsc: 714,
+    pol: 966,
+    gnosis: 700,
+    avax: 9000,
+    xrp: 144,
+    sol: 501,
+    ton: 607,
+    stellar: 148,
+    sui: 784,
+};
+/** CAIP-19 asset-namespace used when rendering a contract asset for a chain namespace. */
+const contractAssetNamespaces = {
+    eip155: 'erc20',
+    near: 'nep141',
+    solana: 'token',
+};
+/**
+ * Builds a bidirectional CAIP-19 ↔ 1Click asset map from the `/v0/tokens`
+ * list. Contract assets match on `contractAddress` (case-insensitively for
+ * `eip155` chains); `slip44` assets match the chain's token that has no
+ * `contractAddress` (chain-native), and only for the chain's canonical coin
+ * type — a wrong coin type resolves to nothing rather than silently mapping
+ * to the native asset.
+ */
+export function createAssetMap(tokens, config = {}) {
+    const networks = { ...defaultNetworks, ...config.networks };
+    const nativeCoinTypes = { ...defaultNativeCoinTypes, ...config.nativeCoinTypes };
+    const blockchainToCaip2 = new Map();
+    for (const [caip2Id, code] of Object.entries(networks)) {
+        if (!blockchainToCaip2.has(code))
+            blockchainToCaip2.set(code, caip2Id);
+    }
+    function blockchainOf(caip19Id) {
+        const chain = Types.chainOf(caip19Id);
+        return Object.entries(networks).find(([caip2Id]) => Types.networkEqual(caip2Id, chain))?.[1];
+    }
+    function tokenOf(caip19Id) {
+        const parsed = Types.parseCaip19(caip19Id);
+        const blockchain = blockchainOf(caip19Id);
+        if (!blockchain)
+            return undefined;
+        if (parsed.assetNamespace === 'slip44') {
+            const coinType = nativeCoinTypes[blockchain];
+            if (coinType === undefined || parsed.assetReference !== String(coinType))
+                return undefined;
+            return tokens.find((token) => token.blockchain === blockchain && !token.contractAddress);
+        }
+        const caseInsensitive = parsed.chain.namespace === 'eip155';
+        const reference = caseInsensitive ? parsed.assetReference.toLowerCase() : parsed.assetReference;
+        return tokens.find((token) => {
+            if (token.blockchain !== blockchain || !token.contractAddress)
+                return false;
+            const address = caseInsensitive ? token.contractAddress.toLowerCase() : token.contractAddress;
+            return address === reference;
+        });
+    }
+    return {
+        tokenOf,
+        toAssetId(caip19Id) {
+            return tokenOf(caip19Id)?.assetId;
+        },
+        toCaip19(assetId) {
+            const token = tokens.find((entry) => entry.assetId === assetId);
+            if (!token)
+                return undefined;
+            const caip2Id = blockchainToCaip2.get(token.blockchain);
+            if (!caip2Id)
+                return undefined;
+            if (token.contractAddress) {
+                const namespace = Types.parseCaip2(caip2Id).namespace;
+                const assetNamespace = contractAssetNamespaces[namespace] ?? 'token';
+                return `${caip2Id}/${assetNamespace}:${token.contractAddress}`;
+            }
+            const coinType = nativeCoinTypes[token.blockchain];
+            if (coinType === undefined)
+                return undefined;
+            return `${caip2Id}/slip44:${coinType}`;
+        },
+    };
+}
+//# sourceMappingURL=OneClick.js.map