@avail-project/widgets 0.0.1

package/dist/common/tx/useTransactionSteps.js

@@ -0,0 +1,40 @@
+import { useMemo, useRef, useState } from "react";
+import { getStepKey } from "./types";
+import { computeAllCompleted, mergeStepComplete, mergeStepsList, seedSteps, } from "./steps";
+/**
+ * Manages transaction steps with utilities to seed from expected steps,
+ * replace the list on "steps list" events, and mark individual steps complete.
+ */
+export function useTransactionSteps(options = {}) {
+    const { expected } = options;
+    const [steps, setSteps] = useState(() => expected ? seedSteps(expected) : []);
+    const lastSignatureRef = useRef("");
+    const onStepsList = (list) => {
+        const signature = list.map((step) => getStepKey(step)).join("|");
+        if (lastSignatureRef.current === signature) {
+            setSteps((prev) => mergeStepsList(prev, list));
+            return;
+        }
+        lastSignatureRef.current = signature;
+        setSteps((prev) => mergeStepsList(prev, list));
+    };
+    const onStepComplete = (step) => {
+        setSteps((prev) => mergeStepComplete(prev, step));
+    };
+    const seed = (expectedSteps) => {
+        setSteps(seedSteps(expectedSteps));
+    };
+    const reset = () => {
+        setSteps(expected ? seedSteps(expected) : []);
+        lastSignatureRef.current = "";
+    };
+    const allCompleted = useMemo(() => computeAllCompleted(steps), [steps]);
+    return {
+        steps,
+        allCompleted,
+        onStepsList,
+        onStepComplete,
+        seed,
+        reset,
+    };
+}

package/dist/common/types/transaction-flow.d.ts

@@ -0,0 +1,48 @@
+import { type BridgeEvent } from "@avail-project/nexus-core";
+import { type Address } from "viem";
+export type TransactionFlowType = "bridge" | "transfer";
+export type BridgeStepType = {
+    type: string;
+    typeID: string;
+    completed?: boolean;
+    [key: string]: any;
+};
+export type SwapStepType = {
+    type: string;
+    typeID: string;
+    completed?: boolean;
+    [key: string]: any;
+};
+export interface TransactionFlowInputs {
+    chain: number;
+    token: string;
+    amount?: string;
+    recipient?: `0x${string}`;
+}
+export interface TransactionFlowPrefill {
+    token: string;
+    chainId: number;
+    amount?: string;
+    recipient?: Address;
+}
+export type TransactionFlowEvent = BridgeEvent;
+export type TransactionFlowOnEvent = (event: BridgeEvent) => void;
+export interface TransactionFlowExecuteParams {
+    token: string;
+    amount: bigint;
+    toChainId: number;
+    recipient: `0x${string}`;
+    sourceChains?: number[];
+    onEvent: TransactionFlowOnEvent;
+}
+export type TransactionFlowExecutor = (params: TransactionFlowExecuteParams) => Promise<{
+    explorerUrl: string;
+} | null>;
+export type SourceCoverageState = "healthy" | "warning" | "error";
+export interface SourceSelectionValidation {
+    coverageState: SourceCoverageState;
+    isBelowRequired: boolean;
+    missingToProceed: string;
+    missingToSafety: string;
+}
+//# sourceMappingURL=transaction-flow.d.ts.map

package/dist/common/types/transaction-flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-flow.d.ts","sourceRoot":"","sources":["../../../.build-src/common/types/transaction-flow.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,WAAW,EACjB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,UAAU,CAAC;AAExD,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,MAAM,oBAAoB,GAAG,WAAW,CAAC;AAE/C,MAAM,MAAM,sBAAsB,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;AAElE,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,KAAK,MAAM,EAAE,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,EAAE,sBAAsB,CAAC;CACjC;AAED,MAAM,MAAM,uBAAuB,GAAG,CACpC,MAAM,EAAE,4BAA4B,KACjC,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAAC;AAE7C,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAElE,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,mBAAmB,CAAC;IACnC,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;CACzB"}

package/dist/common/types/transaction-flow.js

@@ -0,0 +1,2 @@
+import {} from "@avail-project/nexus-core";
+import {} from "viem";

package/dist/common/utils/constant.d.ts

@@ -0,0 +1,99 @@
+export declare const SUPPORTED_CHAINS: {
+    readonly ETHEREUM: 1;
+    readonly BASE: 8453;
+    readonly ARBITRUM: 42161;
+    readonly OPTIMISM: 10;
+    readonly POLYGON: 137;
+    readonly AVALANCHE: 43114;
+    readonly SCROLL: 534352;
+    readonly MEGAETH: 4326;
+    readonly KAIA: 8217;
+    readonly BNB: 56;
+    readonly MONAD: 143;
+    readonly HYPEREVM: 999;
+    readonly CITREA: 4114;
+    readonly SEPOLIA: 11155111;
+    readonly BASE_SEPOLIA: 84532;
+    readonly ARBITRUM_SEPOLIA: 421614;
+    readonly OPTIMISM_SEPOLIA: 11155420;
+    readonly POLYGON_AMOY: 80002;
+    readonly MONAD_TESTNET: 10143;
+};
+interface ChainMetadata {
+    blockExplorerUrls: string[];
+    logo: string;
+    name: string;
+    nativeCurrency: {
+        decimals: number;
+        name: string;
+        symbol: string;
+    };
+    rpcUrls?: string[];
+}
+export declare const CHAIN_METADATA: Record<number, ChainMetadata>;
+export declare const TOKEN_METADATA: {
+    readonly ETH: {
+        readonly decimals: 18;
+        readonly name: "Ethereum";
+        readonly symbol: "ETH";
+        readonly logo: "https://raw.githubusercontent.com/availproject/nexus-assets/main/tokens/eth/logo.png";
+    };
+    readonly USDC: {
+        readonly decimals: 6;
+        readonly name: "USD Coin";
+        readonly symbol: "USDC";
+        readonly logo: "https://raw.githubusercontent.com/availproject/nexus-assets/main/tokens/usdc/logo.png";
+    };
+    readonly USDT: {
+        readonly decimals: 6;
+        readonly name: "Tether USD";
+        readonly symbol: "USDT";
+        readonly logo: "https://raw.githubusercontent.com/availproject/nexus-assets/main/tokens/usdt/logo.png";
+    };
+    readonly DAI: {
+        readonly decimals: 18;
+        readonly name: "Dai Stablecoin";
+        readonly symbol: "DAI";
+        readonly logo: "https://raw.githubusercontent.com/availproject/nexus-assets/main/tokens/dai/logo.png";
+    };
+    readonly WBTC: {
+        readonly decimals: 8;
+        readonly name: "Wrapped BTC";
+        readonly symbol: "WBTC";
+        readonly logo: "https://raw.githubusercontent.com/availproject/nexus-assets/main/tokens/wbtc/logo.png";
+    };
+};
+export declare const SHORT_CHAIN_NAME: Record<number, string>;
+export type SdkChainWithSwapSupport = {
+    chain?: {
+        id?: number | null;
+    } | null;
+    id?: number | null;
+    swapSupported?: boolean | null;
+};
+export type SdkChainListWithSwapSupport = readonly SdkChainWithSwapSupport[] | null | undefined;
+export declare function getSdkSwapSupportedChainIds(chains: SdkChainListWithSwapSupport): Set<number> | null;
+export declare function isSwapSupportedBySdkChainList(chainId: number | null | undefined, chains: SdkChainListWithSwapSupport): boolean;
+export declare function getShortChainName(chainId?: number, fallbackName?: string): string;
+export declare const TOKEN_IMAGES: Record<string, string>;
+/**
+ * Compute an amount string for fraction buttons (25%, 50%, 75%, 100%).
+ *
+ * @param balanceStr - user's balance as a human decimal string (e.g. "12.345") OR as base-unit integer string if `balanceIsBaseUnits` true
+ * @param fraction - fraction e.g. 0.25, 0.5, 0.75, 1
+ * @param decimals - token decimals (6 for USDC/USDT, 18 for ETH)
+ * @param safetyMargin - 0.01 for 1% default
+ * @param balanceIsBaseUnits - if true, balanceStr is already base units integer string (wei / smallest unit)
+ * @returns decimal string clipped to token decimals (rounded down)
+ */
+export declare function computeAmountFromFraction(balanceStr: string, fraction: number, decimals: number, safetyMargin?: number, balanceIsBaseUnits?: boolean): string;
+export declare const usdFormatter: Intl.NumberFormat;
+/**
+ * Formats USD values for UI.
+ * Values between 0 and 0.001 are shown as "< $0.001".
+ * Values between 0.001 and 0.01 are shown with 3 decimals.
+ */
+export declare function formatUsdForDisplay(value: number): string;
+export declare const TOKEN_CONTRACT_ADDRESSES: Record<string, Record<number, `0x${string}`>>;
+export {};
+//# sourceMappingURL=constant.d.ts.map

package/dist/common/utils/constant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constant.d.ts","sourceRoot":"","sources":["../../../.build-src/common/utils/constant.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;CAoBnB,CAAC;AAEX,UAAU,aAAa;IACrB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAkHxD,CAAC;AAEF,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BjB,CAAC;AAEX,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAsB1C,CAAC;AAEX,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IACtC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,2BAA2B,GACnC,SAAS,uBAAuB,EAAE,GAClC,IAAI,GACJ,SAAS,CAAC;AAYd,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,2BAA2B,GAClC,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAyBpB;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAClC,MAAM,EAAE,2BAA2B,GAClC,OAAO,CAWT;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,CAAC,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,CAKR;AAED,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAW/C,CAAC;AAOF;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,YAAY,SAAwB,EACpC,kBAAkB,UAAQ,GACzB,MAAM,CAyCR;AAED,eAAO,MAAM,YAAY,mBAKvB,CAAC;AASH;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAiBzD;AAED,eAAO,MAAM,wBAAwB,EAwChC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC"}

package/dist/common/utils/constant.js

@@ -0,0 +1,370 @@
+import { formatUnits, parseUnits } from "viem";
+export const SUPPORTED_CHAINS = {
+    ETHEREUM: 1,
+    BASE: 8453,
+    ARBITRUM: 42_161,
+    OPTIMISM: 10,
+    POLYGON: 137,
+    AVALANCHE: 43_114,
+    SCROLL: 534_352,
+    MEGAETH: 4326,
+    KAIA: 8217,
+    BNB: 56,
+    MONAD: 143,
+    HYPEREVM: 999,
+    CITREA: 4114,
+    SEPOLIA: 11_155_111,
+    BASE_SEPOLIA: 84_532,
+    ARBITRUM_SEPOLIA: 421_614,
+    OPTIMISM_SEPOLIA: 11_155_420,
+    POLYGON_AMOY: 80_002,
+    MONAD_TESTNET: 10_143,
+};
+export const CHAIN_METADATA = {
+    [SUPPORTED_CHAINS.ETHEREUM]: {
+        logo: "https://raw.githubusercontent.com/availproject/nexus-assets/main/chains/ethereum/logo.png",
+        name: "Ethereum",
+        nativeCurrency: { name: "Ether", symbol: "ETH", decimals: 18 },
+        blockExplorerUrls: ["https://etherscan.io"],
+    },
+    [SUPPORTED_CHAINS.BASE]: {
+        logo: "https://raw.githubusercontent.com/availproject/nexus-assets/main/chains/base/logo.png",
+        name: "Base",
+        nativeCurrency: { name: "Ether", symbol: "ETH", decimals: 18 },
+        blockExplorerUrls: ["https://basescan.org"],
+    },
+    [SUPPORTED_CHAINS.ARBITRUM]: {
+        logo: "https://raw.githubusercontent.com/availproject/nexus-assets/main/chains/arbitrum/logo.png",
+        name: "Arbitrum",
+        nativeCurrency: { name: "Ether", symbol: "ETH", decimals: 18 },
+        blockExplorerUrls: ["https://arbiscan.io"],
+    },
+    [SUPPORTED_CHAINS.OPTIMISM]: {
+        logo: "https://raw.githubusercontent.com/availproject/nexus-assets/main/chains/optimism/logo.png",
+        name: "Optimism",
+        nativeCurrency: { name: "Ether", symbol: "ETH", decimals: 18 },
+        blockExplorerUrls: ["https://optimistic.etherscan.io"],
+    },
+    [SUPPORTED_CHAINS.POLYGON]: {
+        logo: "https://raw.githubusercontent.com/availproject/nexus-assets/main/chains/polygon/logo.png",
+        name: "Polygon",
+        nativeCurrency: { name: "POL", symbol: "POL", decimals: 18 },
+        blockExplorerUrls: ["https://polygonscan.com"],
+    },
+    [SUPPORTED_CHAINS.AVALANCHE]: {
+        logo: "https://raw.githubusercontent.com/availproject/nexus-assets/main/chains/avalanche/logo.png",
+        name: "Avalanche",
+        nativeCurrency: { name: "AVAX", symbol: "AVAX", decimals: 18 },
+        blockExplorerUrls: ["https://snowtrace.io"],
+    },
+    [SUPPORTED_CHAINS.SCROLL]: {
+        logo: "https://raw.githubusercontent.com/availproject/nexus-assets/main/chains/scroll/logo.png",
+        name: "Scroll",
+        nativeCurrency: { name: "Ether", symbol: "ETH", decimals: 18 },
+        blockExplorerUrls: ["https://scrollscan.com"],
+    },
+    [SUPPORTED_CHAINS.MEGAETH]: {
+        logo: "https://files.availproject.org/fastbridge/megaeth/megaeth-favicon.svg",
+        name: "MegaETH",
+        nativeCurrency: { name: "Ether", symbol: "ETH", decimals: 18 },
+        blockExplorerUrls: ["https://mega.etherscan.io"],
+        rpcUrls: ["https://rpcs.avail.so/megaeth"],
+    },
+    [SUPPORTED_CHAINS.KAIA]: {
+        logo: "https://raw.githubusercontent.com/availproject/nexus-assets/main/chains/kaia/logo.png",
+        name: "Kaia",
+        nativeCurrency: { name: "KAIA", symbol: "KAIA", decimals: 18 },
+        blockExplorerUrls: ["https://kaiascan.io"],
+        rpcUrls: ["https://rpcs.avail.so/kaia"],
+    },
+    [SUPPORTED_CHAINS.MONAD]: {
+        logo: "https://files.availproject.org/fastbridge/monad/monad-favicon.svg",
+        name: "Monad",
+        nativeCurrency: { name: "Monad", symbol: "MON", decimals: 18 },
+        blockExplorerUrls: ["https://monadscan.com"],
+        rpcUrls: ["https://rpcs.avail.so/monad"],
+    },
+    [SUPPORTED_CHAINS.HYPEREVM]: {
+        logo: "https://raw.githubusercontent.com/availproject/nexus-assets/main/chains/hyperevm/logo.png",
+        name: "HyperEVM",
+        nativeCurrency: { name: "Hype", symbol: "HYPE", decimals: 18 },
+        blockExplorerUrls: ["https://hyperevmscan.io"],
+        rpcUrls: ["https://rpcs.avail.so/hyperevm"],
+    },
+    [SUPPORTED_CHAINS.BNB]: {
+        logo: "https://raw.githubusercontent.com/availproject/nexus-assets/main/chains/bnb/logo.png",
+        name: "BNB Smart Chain",
+        nativeCurrency: { name: "BNB", symbol: "BNB", decimals: 18 },
+        blockExplorerUrls: ["https://bscscan.com"],
+    },
+    [SUPPORTED_CHAINS.CITREA]: {
+        logo: "https://raw.githubusercontent.com/availproject/nexus-assets/main/chains/citrea/logo.png",
+        name: "Citrea",
+        nativeCurrency: { name: "cBTC", symbol: "cBTC", decimals: 18 },
+        blockExplorerUrls: ["https://explorer.citrea.xyz"],
+    },
+    // Testnets
+    [SUPPORTED_CHAINS.SEPOLIA]: {
+        logo: "https://raw.githubusercontent.com/availproject/nexus-assets/main/chains/ethereum/logo.png",
+        name: "Sepolia",
+        nativeCurrency: { name: "Ether", symbol: "ETH", decimals: 18 },
+        blockExplorerUrls: ["https://sepolia.etherscan.io"],
+    },
+    [SUPPORTED_CHAINS.BASE_SEPOLIA]: {
+        logo: "https://raw.githubusercontent.com/availproject/nexus-assets/main/chains/base/logo.png",
+        name: "Base Sepolia",
+        nativeCurrency: { name: "Ether", symbol: "ETH", decimals: 18 },
+        blockExplorerUrls: ["https://sepolia.basescan.org"],
+    },
+    [SUPPORTED_CHAINS.ARBITRUM_SEPOLIA]: {
+        logo: "https://raw.githubusercontent.com/availproject/nexus-assets/main/chains/arbitrum/logo.png",
+        name: "Arbitrum Sepolia",
+        nativeCurrency: { name: "Ether", symbol: "ETH", decimals: 18 },
+        blockExplorerUrls: ["https://sepolia.arbiscan.io"],
+    },
+    [SUPPORTED_CHAINS.OPTIMISM_SEPOLIA]: {
+        logo: "https://raw.githubusercontent.com/availproject/nexus-assets/main/chains/optimism/logo.png",
+        name: "Optimism Sepolia",
+        nativeCurrency: { name: "Ether", symbol: "ETH", decimals: 18 },
+        blockExplorerUrls: ["https://sepolia-optimism.etherscan.io"],
+    },
+    [SUPPORTED_CHAINS.POLYGON_AMOY]: {
+        logo: "https://raw.githubusercontent.com/availproject/nexus-assets/main/chains/polygon/logo.png",
+        name: "Polygon Amoy",
+        nativeCurrency: { name: "POL", symbol: "POL", decimals: 18 },
+        blockExplorerUrls: ["https://amoy.polygonscan.com"],
+    },
+};
+export const TOKEN_METADATA = {
+    ETH: {
+        decimals: 18,
+        name: "Ethereum",
+        symbol: "ETH",
+        logo: "https://raw.githubusercontent.com/availproject/nexus-assets/main/tokens/eth/logo.png",
+    },
+    USDC: {
+        decimals: 6,
+        name: "USD Coin",
+        symbol: "USDC",
+        logo: "https://raw.githubusercontent.com/availproject/nexus-assets/main/tokens/usdc/logo.png",
+    },
+    USDT: {
+        decimals: 6,
+        name: "Tether USD",
+        symbol: "USDT",
+        logo: "https://raw.githubusercontent.com/availproject/nexus-assets/main/tokens/usdt/logo.png",
+    },
+    DAI: {
+        decimals: 18,
+        name: "Dai Stablecoin",
+        symbol: "DAI",
+        logo: "https://raw.githubusercontent.com/availproject/nexus-assets/main/tokens/dai/logo.png",
+    },
+    WBTC: {
+        decimals: 8,
+        name: "Wrapped BTC",
+        symbol: "WBTC",
+        logo: "https://raw.githubusercontent.com/availproject/nexus-assets/main/tokens/wbtc/logo.png",
+    },
+};
+export const SHORT_CHAIN_NAME = {
+    [SUPPORTED_CHAINS.ETHEREUM]: "Ethereum",
+    [SUPPORTED_CHAINS.BASE]: "Base",
+    [SUPPORTED_CHAINS.ARBITRUM]: "Arbitrum",
+    [SUPPORTED_CHAINS.OPTIMISM]: "Optimism",
+    [SUPPORTED_CHAINS.POLYGON]: "Polygon",
+    [SUPPORTED_CHAINS.AVALANCHE]: "Avalanche",
+    [SUPPORTED_CHAINS.SCROLL]: "Scroll",
+    [SUPPORTED_CHAINS.MEGAETH]: "MegaETH",
+    [SUPPORTED_CHAINS.KAIA]: "Kaia",
+    [SUPPORTED_CHAINS.BNB]: "BNB",
+    [SUPPORTED_CHAINS.MONAD]: "Monad",
+    [SUPPORTED_CHAINS.HYPEREVM]: "HyperEVM",
+    [SUPPORTED_CHAINS.CITREA]: "Citrea",
+    // [SUPPORTED_CHAINS.TRON]: "Tron",
+    [SUPPORTED_CHAINS.SEPOLIA]: "Sepolia",
+    [SUPPORTED_CHAINS.BASE_SEPOLIA]: "Base Sepolia",
+    [SUPPORTED_CHAINS.ARBITRUM_SEPOLIA]: "Arbitrum Sepolia",
+    [SUPPORTED_CHAINS.OPTIMISM_SEPOLIA]: "Optimism Sepolia",
+    [SUPPORTED_CHAINS.POLYGON_AMOY]: "Polygon Amoy",
+    [SUPPORTED_CHAINS.MONAD_TESTNET]: "Monad Testnet",
+    // [SUPPORTED_CHAINS.TRON_SHASTA]: "Tron Shasta",
+};
+const getSdkChainId = (chain) => {
+    const rawId = chain.id ?? chain.chain?.id;
+    if (rawId == null) {
+        return undefined;
+    }
+    const chainId = Number(rawId);
+    return Number.isInteger(chainId) && chainId > 0 ? chainId : undefined;
+};
+export function getSdkSwapSupportedChainIds(chains) {
+    if (!chains?.length) {
+        return null;
+    }
+    const hasExplicitSwapSupport = chains.some((chain) => typeof chain.swapSupported === "boolean");
+    if (!hasExplicitSwapSupport) {
+        return null;
+    }
+    const supportedIds = new Set();
+    for (const chain of chains) {
+        if (chain.swapSupported !== true) {
+            continue;
+        }
+        const chainId = getSdkChainId(chain);
+        if (chainId) {
+            supportedIds.add(chainId);
+        }
+    }
+    return supportedIds;
+}
+export function isSwapSupportedBySdkChainList(chainId, chains) {
+    if (!chainId) {
+        return false;
+    }
+    const sdkSupportedIds = getSdkSwapSupportedChainIds(chains);
+    if (sdkSupportedIds) {
+        return sdkSupportedIds.has(Number(chainId));
+    }
+    return true;
+}
+export function getShortChainName(chainId, fallbackName) {
+    if (!chainId) {
+        return fallbackName ?? "";
+    }
+    return SHORT_CHAIN_NAME[chainId] ?? fallbackName ?? String(chainId);
+}
+export const TOKEN_IMAGES = {
+    BNB: "https://assets.coingecko.com/coins/images/825/large/bnb-icon2_2x.png",
+    KAIA: "https://assets.coingecko.com/asset_platforms/images/9672/large/kaia.png",
+    SOPH: "https://assets.coingecko.com/coins/images/38680/large/sophon_logo_200.png",
+    USDC: "https://coin-images.coingecko.com/coins/images/6319/large/usdc.png",
+    USDM: "https://raw.githubusercontent.com/availproject/nexus-assets/refs/heads/main/tokens/usdm/logo.png",
+    USDS: "https://assets.coingecko.com/coins/images/39926/standard/usds.webp?1726666683",
+    USDT: "https://coin-images.coingecko.com/coins/images/35023/large/USDT.png",
+    "USD₮0": "https://coin-images.coingecko.com/coins/images/35023/large/USDT.png",
+    WETH: "https://assets.coingecko.com/coins/images/279/large/ethereum.png?1595348880",
+};
+const DEFAULT_SAFETY_MARGIN = 0.01; // 1%
+const TRAILING_DECIMAL_ZERO_REGEX = /(\.\d*?[1-9])0+$/u;
+const ZERO_DECIMAL_REGEX = /\.0+$/u;
+const LONE_DECIMAL_POINT_REGEX = /^\.$/u;
+/**
+ * Compute an amount string for fraction buttons (25%, 50%, 75%, 100%).
+ *
+ * @param balanceStr - user's balance as a human decimal string (e.g. "12.345") OR as base-unit integer string if `balanceIsBaseUnits` true
+ * @param fraction - fraction e.g. 0.25, 0.5, 0.75, 1
+ * @param decimals - token decimals (6 for USDC/USDT, 18 for ETH)
+ * @param safetyMargin - 0.01 for 1% default
+ * @param balanceIsBaseUnits - if true, balanceStr is already base units integer string (wei / smallest unit)
+ * @returns decimal string clipped to token decimals (rounded down)
+ */
+export function computeAmountFromFraction(balanceStr, fraction, decimals, safetyMargin = DEFAULT_SAFETY_MARGIN, balanceIsBaseUnits = false) {
+    if (!balanceStr) {
+        return "0";
+    }
+    // parse balance into base units (BigInt)
+    const balanceUnits = balanceIsBaseUnits
+        ? BigInt(balanceStr)
+        : parseUnits(balanceStr, decimals);
+    if (balanceUnits === BigInt(0)) {
+        return "0";
+    }
+    // Use an integer precision multiplier to avoid FP issues
+    const PREC = 1_000_000; // 1e6 precision for fraction & safety margin
+    const safetyMul = BigInt(Math.max(0, Math.floor((1 - safetyMargin) * PREC))); // (1 - safetyMargin) * PREC
+    const fractionMul = BigInt(Math.max(0, Math.floor(fraction * PREC))); // fraction * PREC
+    // Apply safety margin: floor(balance * (1 - safetyMargin))
+    const maxAfterSafety = (balanceUnits * safetyMul) / BigInt(PREC);
+    // Apply fraction and floor: floor(maxAfterSafety * fraction)
+    let desiredUnits = (maxAfterSafety * fractionMul) / BigInt(PREC);
+    // Extra clamp just in case
+    if (desiredUnits > balanceUnits) {
+        desiredUnits = balanceUnits;
+    }
+    if (desiredUnits < BigInt(0)) {
+        desiredUnits = BigInt(0);
+    }
+    // format back to human readable decimal string with token decimals (formatUnits truncates/keeps decimals)
+    // formatUnits will produce exactly decimals digits if fractional part exists; we'll strip trailing zeros.
+    const raw = formatUnits(desiredUnits, decimals);
+    // strip trailing zeros and possible trailing dot
+    return raw
+        .replace(TRAILING_DECIMAL_ZERO_REGEX, "$1")
+        .replace(ZERO_DECIMAL_REGEX, "")
+        .replace(LONE_DECIMAL_POINT_REGEX, "0");
+}
+export const usdFormatter = new Intl.NumberFormat("en-US", {
+    style: "currency",
+    currency: "USD",
+    minimumFractionDigits: 2,
+    maximumFractionDigits: 2,
+});
+const usdFormatterPrecise = new Intl.NumberFormat("en-US", {
+    style: "currency",
+    currency: "USD",
+    minimumFractionDigits: 3,
+    maximumFractionDigits: 3,
+});
+/**
+ * Formats USD values for UI.
+ * Values between 0 and 0.001 are shown as "< $0.001".
+ * Values between 0.001 and 0.01 are shown with 3 decimals.
+ */
+export function formatUsdForDisplay(value) {
+    if (!Number.isFinite(value)) {
+        return usdFormatter.format(0);
+    }
+    const absValue = Math.abs(value);
+    if (absValue === 0) {
+        return usdFormatter.format(0);
+    }
+    if (absValue < 0.001) {
+        return "< $0.001";
+    }
+    if (absValue < 0.01) {
+        return usdFormatterPrecise.format(value);
+    }
+    return usdFormatter.format(value);
+}
+export const TOKEN_CONTRACT_ADDRESSES = {
+    USDC: {
+        1: "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
+        8453: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+        137: "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359",
+        42161: "0xaf88d065e77c8cc2239327c5edb3a432268e5831",
+        10: "0x0b2c639c533813f4aa9d7837caf62653d097ff85",
+        534352: "0x06efdbff2a14a7c8e15944d1f4a48f9f95f663a4",
+        43114: "0xb97ef9ef8734c71904d8002f8b6bc66dd9c48a6e",
+        56: "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d",
+        999: "0xb88339CB7199b77E23DB6E890353E22632Ba630f",
+        143: "0x754704Bc059F8C67012fEd69BC8A327a5aafb603",
+        4114: "0xE045e6c36cF77FAA2CfB54466D71A3aEF7bbE839",
+        11155111: "0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238",
+        84532: "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
+        421614: "0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d",
+        11155420: "0x5fd84259d66Cd46123540766Be93DFE6D43130D7",
+        80002: "0x41E94Eb019C0762f9Bfcf9Fb1E58725BfB0e7582",
+        10143: "0xf817257fed379853cDe0fa4F97AB987181B1E5Ea",
+        5115: "0xb669dC8cC6D044307Ba45366C0c836eC3c7e31AA",
+    },
+    USDT: {
+        1: "0xdac17f958d2ee523a2206206994597c13d831ec7",
+        137: "0xc2132d05d31c914a87c6611c10748aeb04b58e8f",
+        42161: "0xfd086bc7cd5c481dcc9c85ebe478a1c0b69fcbb9",
+        8217: "0xd077a400968890eacc75cdc901f0356c943e4fdb",
+        10: "0x94b008aa00579c1307b0ef2c499ad98a8ce58e58",
+        534352: "0xf55bec9cafdbe8730f096aa55dad6d22d44099df",
+        43114: "0x9702230a8ea53601f5cd2dc00fdbc13d4df4a8c7",
+        56: "0x55d398326f99059fF775485246999027B3197955",
+        999: "0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb",
+        4114: "0x9f3096Bac87e7F03DC09b0B416eB0DF837304dc4",
+        4326: "0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb",
+        421614: "0xF954d4A5859b37De88a91bdbb8Ad309056FB04B1",
+        11155420: "0x6462693c2F21AC0E517f12641D404895030F7426",
+        10143: "0x1c56F176D6735888fbB6f8bD9ADAd8Ad7a023a0b",
+    },
+    USDM: {
+        4326: "0xFAfDdbb3FC7688494971a79cc65DCa3EF82079E7",
+    },
+};

package/dist/common/utils/token-pricing.d.ts

@@ -0,0 +1,33 @@
+import type { SupportedChainsAndTokensResult } from "@avail-project/nexus-core";
+export declare const DEFAULT_COINBASE_PRICE_REQUEST_TIMEOUT_MS = 4000;
+export declare const USD_PEGGED_FALLBACK_RATE = 1;
+export declare const DEFAULT_USD_PEGGED_TOKEN_SYMBOLS: readonly ["USDT", "USDC", "USDC.E", "USDT.E", "USDS", "DAI", "CTUSD", "JUSD", "USDM", "FDUSD", "BUSD", "TUSD", "PYUSD", "GUSD", "SVJUSD", "LUSD", "USDE", "USDP"];
+/**
+ * Wrapped / derivative token → base token pegging map.
+ * When Coinbase has no direct price for a token, we resolve the price
+ * of the base symbol and treat it as 1:1.
+ *
+ * Keys and values are UPPERCASE (normalised).
+ */
+export declare const TOKEN_PRICE_PEGS: Readonly<Record<string, string>>;
+/**
+ * Custom error thrown when a token's USD price cannot be determined
+ * through any resolution path (SDK rates, Coinbase API, or pegging fallback).
+ */
+export declare class TokenPricingError extends Error {
+    readonly tokenSymbol: string;
+    constructor(tokenSymbol: string);
+}
+/**
+ * Resolve the base symbol for a given token via the pegging map.
+ * Returns `null` if no peg is defined.
+ */
+export declare function resolveBaseSymbol(tokenSymbol: string): string | null;
+export declare function normalizeTokenSymbol(tokenSymbol: string): string;
+export declare function getUsdRatePegSymbol(tokenSymbol: string): string | null;
+export declare function toFinitePositiveNumber(value: unknown): number | null;
+export declare function getCoinbaseSymbolCandidates(tokenSymbol: string): string[];
+export declare function buildUsdPeggedSymbolSet(supportedChains: SupportedChainsAndTokensResult | null, baseSymbols?: Iterable<string>): Set<string>;
+export declare function fetchCoinbaseUsdRate(tokenSymbol: string, requestTimeoutMs?: number): Promise<number | null>;
+export declare function fetchCoinGeckoUsdRate(tokenSymbol: string, requestTimeoutMs?: number): Promise<number | null>;
+//# sourceMappingURL=token-pricing.d.ts.map

package/dist/common/utils/token-pricing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-pricing.d.ts","sourceRoot":"","sources":["../../../.build-src/common/utils/token-pricing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,2BAA2B,CAAC;AAShF,eAAO,MAAM,yCAAyC,OAAQ,CAAC;AAC/D,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C,eAAO,MAAM,gCAAgC,mKAmBnC,CAAC;AAEX;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA6CpD,CAAC;AAEX;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,SAAgB,WAAW,EAAE,MAAM,CAAC;gBAExB,WAAW,EAAE,MAAM;CAKhC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGpE;AAuCD,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEhE;AAeD,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKtE;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAMpE;AAED,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAkBzE;AA8CD,wBAAgB,uBAAuB,CACrC,eAAe,EAAE,8BAA8B,GAAG,IAAI,EACtD,WAAW,GAAE,QAAQ,CAAC,MAAM,CAAoC,GAC/D,GAAG,CAAC,MAAM,CAAC,CAqBb;AAqBD,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,gBAAgB,SAA4C,GAC3D,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAwBxB;AAuBD,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,gBAAgB,SAA4C,GAC3D,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA+BxB"}