@pushchain/core 1.1.36 → 1.1.38

package/src/lib/push-chain/push-chain.d.ts

@@ -4,6 +4,7 @@ import { UniversalAccount, UniversalSigner } from '../universal/universal.types'
 import { Utils } from '../utils';
 import { TypedData, TypedDataDomain } from 'viem';
 import { ProgressEvent } from '../progress-hook/progress-hook.types';
+import { MoveableToken, PayableToken, ConversionQuote, MoveableTokenAccessor, PayableTokenAccessor } from '../constants/tokens';
 /**
  * @class PushChain
  *
@@ -61,6 +62,22 @@ export declare class PushChain {
         getTransactionUrl: (txHash: string) => string;
         listUrls: () => string[];
     };
+    /**
+     * Moveable and payable token registries exposed on the client instance.
+     * These are derived from the origin chain and only include tokens available for that chain.
+     */
+    moveable: {
+        token: MoveableTokenAccessor;
+    };
+    payable: {
+        token: PayableTokenAccessor;
+    };
+    funds: {
+        getConversionQuote: (amountIn: bigint, options: {
+            from: PayableToken | undefined;
+            to: MoveableToken | undefined;
+        }) => Promise<ConversionQuote>;
+    };
     private constructor();
     /**
      * @private

package/src/lib/push-chain/push-chain.js

@@ -11,6 +11,8 @@ const signer_1 = require("../universal/signer");
 const utils_1 = require("../utils");
 const anchor_1 = require("@coral-xyz/anchor");
 const viem_1 = require("viem");
+const evm_client_1 = require("../vm-client/evm-client");
+const tokens_1 = require("../constants/tokens");
 /**
  * @class PushChain
  *
@@ -25,6 +27,7 @@ class PushChain {
         return !('signMessage' in input) && !('signAndSendTransaction' in input);
     }
     constructor(orchestrator, universalSigner, blockExplorers, isReadMode) {
+        var _b, _c, _d, _e, _f, _g;
         this.orchestrator = orchestrator;
         this.universalSigner = universalSigner;
         this.blockExplorers = blockExplorers;
@@ -97,6 +100,193 @@ class PushChain {
                 return (_b = blockExplorers[enums_1.CHAIN.PUSH_TESTNET_DONUT]) !== null && _b !== void 0 ? _b : [];
             },
         };
+        // Derive moveable/payable tokens for the current origin chain
+        const originChain = universalSigner.account.chain;
+        const toTokenMap = (arr) => (arr !== null && arr !== void 0 ? arr : []).reduce((acc, t) => {
+            acc[t.symbol] = t;
+            return acc;
+        }, {});
+        const moveableList = (_d = (_c = (_b = tokens_1.MOVEABLE_TOKENS[originChain]) !== null && _b !== void 0 ? _b : tokens_1.MOVEABLE_TOKENS[enums_1.CHAIN.ETHEREUM_MAINNET]) !== null && _c !== void 0 ? _c : tokens_1.MOVEABLE_TOKENS[enums_1.CHAIN.ETHEREUM_SEPOLIA]) !== null && _d !== void 0 ? _d : [];
+        const payableList = (_g = (_f = (_e = tokens_1.PAYABLE_TOKENS[originChain]) !== null && _e !== void 0 ? _e : tokens_1.PAYABLE_TOKENS[enums_1.CHAIN.ETHEREUM_MAINNET]) !== null && _f !== void 0 ? _f : tokens_1.PAYABLE_TOKENS[enums_1.CHAIN.ETHEREUM_SEPOLIA]) !== null && _g !== void 0 ? _g : [];
+        this.moveable = {
+            token: new tokens_1.MoveableTokenAccessor(toTokenMap(moveableList)),
+        };
+        this.payable = {
+            token: new tokens_1.PayableTokenAccessor(toTokenMap(payableList)),
+        };
+        this.funds = {
+            getConversionQuote: (amountIn_1, _b) => tslib_1.__awaiter(this, [amountIn_1, _b], void 0, function* (amountIn, { from, to, }) {
+                var _c, _d;
+                const originChain = universalSigner.account.chain;
+                if (originChain !== enums_1.CHAIN.ETHEREUM_MAINNET &&
+                    originChain !== enums_1.CHAIN.ETHEREUM_SEPOLIA) {
+                    throw new Error('getConversionQuote is only supported on Ethereum Mainnet and Sepolia for now');
+                }
+                if (!from) {
+                    throw new Error('from token is required');
+                }
+                if (!to) {
+                    throw new Error('to token is required');
+                }
+                // Sepolia-only override: if quoting USDT -> WETH, use Chainlink ETH/USD to match UniversalGatewayV0.sol
+                if (originChain === enums_1.CHAIN.ETHEREUM_SEPOLIA &&
+                    from.symbol === 'USDT' &&
+                    to.symbol === 'WETH') {
+                    // Resolve RPCs from client config, falling back to defaults
+                    const rpcUrls = orchestrator.getRpcUrls()[originChain] ||
+                        chain_1.CHAIN_INFO[originChain].defaultRPC;
+                    const evm = new evm_client_1.EvmClient({ rpcUrls });
+                    // Chainlink AggregatorV3Interface (ETH/USD) on Sepolia
+                    const aggregatorAbi = (0, viem_1.parseAbi)([
+                        'function latestRoundData() view returns (uint80 roundId, int256 answer, uint256 startedAt, uint256 updatedAt, uint80 answeredInRound)',
+                        'function decimals() view returns (uint8)',
+                    ]);
+                    const ETH_USD_FEED_SEPOLIA = '0x694AA1769357215DE4FAC081bf1f309aDC325306';
+                    // Get price and decimals
+                    const [latest, dec] = yield Promise.all([
+                        evm.readContract({
+                            abi: aggregatorAbi,
+                            address: ETH_USD_FEED_SEPOLIA,
+                            functionName: 'latestRoundData',
+                            args: [],
+                        }),
+                        evm.readContract({
+                            abi: aggregatorAbi,
+                            address: ETH_USD_FEED_SEPOLIA,
+                            functionName: 'decimals',
+                            args: [],
+                        }),
+                    ]);
+                    const answer = (_c = latest === null || latest === void 0 ? void 0 : latest[1]) !== null && _c !== void 0 ? _c : BigInt(0); // USD price per ETH with "dec" decimals
+                    if (answer <= BigInt(0)) {
+                        throw new Error('Chainlink ETH/USD price is invalid');
+                    }
+                    // Scale price to 1e18 without using bigint exponent operator (target constraints)
+                    if (dec > 18) {
+                        throw new Error('Unexpected Chainlink decimals');
+                    }
+                    const pow10 = (exp) => {
+                        if (exp <= 0)
+                            return BigInt(1);
+                        let result = BigInt(1);
+                        for (let i = 0; i < exp; i++)
+                            result *= BigInt(10);
+                        return result;
+                    };
+                    const priceScale = pow10(18 - dec);
+                    const price1e18 = answer * priceScale; // USD(1e18) per 1 ETH
+                    // Convert USDT amount to USD(1e18) using token decimals (default 6)
+                    const fromDecimals = typeof from.decimals === 'number' ? from.decimals : 6;
+                    const usd1e18 = fromDecimals <= 18
+                        ? amountIn * pow10(18 - fromDecimals)
+                        : amountIn / pow10(fromDecimals - 18);
+                    // ETH(wei) = (USD(1e18) * 1e18) / price1e18
+                    const amountOutWei = (usd1e18 * pow10(18)) / price1e18;
+                    const amountInHuman = parseFloat(utils_1.Utils.helpers.formatUnits(amountIn, { decimals: from.decimals }));
+                    const amountOutHuman = parseFloat(utils_1.Utils.helpers.formatUnits(amountOutWei, { decimals: to.decimals }));
+                    const rate = amountInHuman > 0 ? amountOutHuman / amountInHuman : 0;
+                    return {
+                        amountIn: amountIn.toString(),
+                        amountOut: amountOutWei.toString(),
+                        rate,
+                        route: [from.symbol, to.symbol],
+                        timestamp: Date.now(),
+                    };
+                }
+                // Resolve RPCs from client config, falling back to defaults
+                const rpcUrls = orchestrator.getRpcUrls()[originChain] ||
+                    chain_1.CHAIN_INFO[originChain].defaultRPC;
+                const evm = new evm_client_1.EvmClient({ rpcUrls });
+                // Minimal ABIs and known Uniswap V3 addresses (per network)
+                const UNISWAP_V3_FACTORY = originChain === enums_1.CHAIN.ETHEREUM_SEPOLIA
+                    ? '0x0227628f3F023bb0B980b67D528571c95c6DaC1c'
+                    : '0x1F98431c8aD98523631AE4a59f267346ea31F984';
+                const UNISWAP_V3_QUOTER_V2 = originChain === enums_1.CHAIN.ETHEREUM_SEPOLIA
+                    ? '0xEd1f6473345F45b75F8179591dd5bA1888cf2FB3'
+                    : '0x61fFE014bA17989E743c5F6cB21bF9697530B21e';
+                const factoryAbi = (0, viem_1.parseAbi)([
+                    'function getPool(address tokenA, address tokenB, uint24 fee) view returns (address)',
+                ]);
+                const quoterAbi = (0, viem_1.parseAbi)([
+                    'function quoteExactInputSingle((address tokenIn, address tokenOut, uint256 amountIn, uint24 fee, uint160 sqrtPriceLimitX96) params) returns (uint256 amountOut, uint160 sqrtPriceX96After, uint32 initializedTicksCrossed, uint256 gasEstimate)',
+                ]);
+                const poolAbi = (0, viem_1.parseAbi)([
+                    'function liquidity() view returns (uint128)',
+                ]);
+                const feeTiers = [100, 500, 3000, 10000];
+                let bestAmountOut = BigInt(0);
+                let bestFee = null;
+                for (const fee of feeTiers) {
+                    // Find pool address for this fee tier
+                    const poolAddress = yield evm.readContract({
+                        abi: factoryAbi,
+                        address: UNISWAP_V3_FACTORY,
+                        functionName: 'getPool',
+                        args: [from.address, to.address, fee],
+                    });
+                    const isZero = !poolAddress ||
+                        poolAddress.toLowerCase() ===
+                            '0x0000000000000000000000000000000000000000';
+                    if (isZero)
+                        continue;
+                    // Skip uninitialized/empty pools to avoid Quoter reverts
+                    try {
+                        const liquidity = yield evm.readContract({
+                            abi: poolAbi,
+                            address: poolAddress,
+                            functionName: 'liquidity',
+                            args: [],
+                        });
+                        if (!liquidity || liquidity === BigInt(0)) {
+                            continue;
+                        }
+                    }
+                    catch (_e) {
+                        // If we can't read liquidity, skip this pool/fee tier
+                        continue;
+                    }
+                    // Quote exact input single for this fee tier; catch reverts due to empty/uninitialized pools
+                    try {
+                        const result = yield evm.readContract({
+                            abi: quoterAbi,
+                            address: UNISWAP_V3_QUOTER_V2,
+                            functionName: 'quoteExactInputSingle',
+                            args: [
+                                {
+                                    tokenIn: from.address,
+                                    tokenOut: to.address,
+                                    amountIn,
+                                    fee,
+                                    sqrtPriceLimitX96: BigInt(0),
+                                },
+                            ],
+                        });
+                        const amountOut = (_d = result === null || result === void 0 ? void 0 : result[0]) !== null && _d !== void 0 ? _d : BigInt(0);
+                        if (amountOut > bestAmountOut) {
+                            bestAmountOut = amountOut;
+                            bestFee = fee;
+                        }
+                    }
+                    catch (_f) {
+                        // try next fee
+                    }
+                }
+                if (!bestFee) {
+                    throw new Error('No direct Uniswap V3 pool found for the given token pair on common fee tiers');
+                }
+                // Compute normalized rate: tokenOut per tokenIn
+                const amountInHuman = parseFloat(utils_1.Utils.helpers.formatUnits(amountIn, { decimals: from.decimals }));
+                const amountOutHuman = parseFloat(utils_1.Utils.helpers.formatUnits(bestAmountOut, { decimals: to.decimals }));
+                const rate = amountInHuman > 0 ? amountOutHuman / amountInHuman : 0;
+                return {
+                    amountIn: amountIn.toString(),
+                    amountOut: bestAmountOut.toString(),
+                    rate,
+                    route: [from.symbol, to.symbol],
+                    timestamp: Date.now(),
+                };
+            }),
+        };
     }
     /**
      * @private

package/src/lib/push-chain/push-chain.js.map

@@ -1 +1 @@
-{"version":3,"file":"push-chain.js","sourceRoot":"","sources":["../../../../../../packages/core/src/lib/push-chain/push-chain.ts"],"names":[],"mappings":";;;;;AAAA,4CAAyC;AACzC,8CAA6D;AAC7D,8CAAgD;AAChD,+DAA4D;AAC5D,gDAA4D;AAK5D,oCAAiC;AACjC,8CAA0C;AAC1C,+BAA8D;AAG9D;;;;;GAKG;AACH,MAAa,SAAS;IAapB;;OAEG;IACK,MAAM,CAAC,kBAAkB,CAC/B,KAAyC;QAEzC,OAAO,CAAC,CAAC,aAAa,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,wBAAwB,IAAI,KAAK,CAAC,CAAC;IAC3E,CAAC;IAuCD,YACU,YAA0B,EAC1B,eAAgC,EAChC,cAAgD,EACjD,UAAmB;QAHlB,iBAAY,GAAZ,YAAY,CAAc;QAC1B,oBAAe,GAAf,eAAe,CAAiB;QAChC,mBAAc,GAAd,cAAc,CAAkC;QACjD,eAAU,GAAV,UAAU,CAAS;QAiI5B;;;;;;;;;;;WAWG;QACH,iBAAY,GAAG,CACb,eAAmD,EACnD,OAMC,EACmB,EAAE;;YACtB,MAAM,aAAa,GAAG;gBACpB,OAAO,EAAE,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO,mCAAI,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE;gBAC3D,OAAO,EAAE,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO,mCAAI,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE;gBAC3D,cAAc,EAAE,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,cAAc,mCAAI,IAAI,CAAC,cAAc;gBAC9D,WAAW,EAAE,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,WAAW,mCAAI,IAAI,CAAC,YAAY,CAAC,cAAc,EAAE;gBACvE,YAAY,EACV,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,YAAY,mCAAI,IAAI,CAAC,YAAY,CAAC,eAAe,EAAE;aAO/D,CAAC;YACF,OAAO,EAAS,CAAC,cAAc,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;QAClE,CAAC,CAAA,CAAC;QApKA,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QAEjC,IAAI,CAAC,SAAS,GAAG;YACf,IAAI,MAAM;gBACR,OAAO,YAAY,CAAC,MAAM,EAAE,CAAC;YAC/B,CAAC;YACD,IAAI,OAAO;gBACT,OAAO,YAAY,CAAC,kBAAkB,EAAE,CAAC;YAC3C,CAAC;YACD,eAAe,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE;gBAC3B,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;oBACpB,MAAM,IAAI,KAAK,CACb,qDAAqD,CACtD,CAAC;gBACJ,CAAC;gBACD,OAAO,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;YAC1D,CAAC;YACD,WAAW,EAAE,CAAO,IAAgB,EAAE,EAAE;gBACtC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;oBACpB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;gBACrE,CAAC;gBACD,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;gBACzD,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC;gBAC5C,IAAI,kBAAU,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,UAAE,CAAC,GAAG,EAAE,CAAC;oBACpC,OAAO,IAAA,iBAAU,EAAC,QAAQ,CAAC,CAAC;gBAC9B,CAAC;qBAAM,IAAI,kBAAU,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,UAAE,CAAC,GAAG,EAAE,CAAC;oBAC3C,OAAO,cAAK,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAC3C,CAAC;gBACD,OAAO,IAAA,iBAAU,EAAC,QAAQ,CAAC,CAAC;YAC9B,CAAC,CAAA;YACD,aAAa,EAAE,CAAO,GAAG,IAAI,EAAE,EAAE;gBAC/B,IAAI,OAAO,eAAe,CAAC,aAAa,KAAK,UAAU,EAAE,CAAC;oBACxD,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;gBACtD,CAAC;gBACD,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,CAAC;gBAC/D,OAAO,IAAA,iBAAU,EAAC,SAAS,CAAC,CAAC;YAC/B,CAAC,CAAA;SACF,CAAC;QAEF,IAAI,CAAC,QAAQ,GAAG;YACd,iBAAiB,EAAE,CAAC,MAAc,EAAE,EAAE;gBACpC,OAAO,iCAAiC,MAAM,EAAE,CAAC;YACnD,CAAC;YACD,QAAQ,EAAE,GAAG,EAAE;;gBACb,OAAO,MAAA,cAAc,CAAC,aAAK,CAAC,kBAAkB,CAAC,mCAAI,EAAE,CAAC;YACxD,CAAC;SACF,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACK,MAAM,CAAO,cAAc,CACjC,eAAmD,EACnD,OAMC;;;YAED,MAAM,UAAU,GAAG,EAAS,CAAC,kBAAkB,CAAC,eAAe,CAAC,CAAC;YAEjE,qFAAqF;YACrF,MAAM,wBAAwB,GAAG,UAAU;gBACzC,CAAC,CAAC,IAAA,8BAAqB,EAAC;oBACpB,OAAO,EAAE,eAAe;oBACxB,WAAW,EAAE,GAAS,EAAE;wBACtB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;oBACrE,CAAC,CAAA;oBACD,sBAAsB,EAAE,GAAS,EAAE;wBACjC,MAAM,IAAI,KAAK,CACb,4DAA4D,CAC7D,CAAC;oBACJ,CAAC,CAAA;iBACF,CAAC;gBACJ,CAAC,CAAC,IAAA,8BAAqB,EAAC,eAAkC,CAAC,CAAC;YAE9D,MAAM,cAAc,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,cAAc,mCAAI;gBAChD,CAAC,aAAK,CAAC,kBAAkB,CAAC,EAAE,CAAC,4BAA4B,CAAC;aAC3D,CAAC;YACF,MAAM,YAAY,GAAG,IAAI,2BAAY;YACnC;;eAEG;YACH,wBAAwB,EACxB,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO,mCAAI,oBAAY,CAAC,aAAa,EAC9C,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO,mCAAI,EAAE,EACtB,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,WAAW,mCAAI,KAAK,EAC7B,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,YAAY,CACtB,CAAC;YACF,OAAO,IAAI,EAAS,CAClB,YAAY,EACZ,wBAAwB,EACxB,cAAc,EACd,UAAU,CACX,CAAC;QACJ,CAAC;KAAA;;AArKH,8BAsOC;;AArOC;;;GAGG;AACW,mBAAS,GAAG,qBAAS,AAAZ,CAAa;AAEpC;;;GAGG;AACW,eAAK,GAAG,aAAK,AAAR,CAAS;AA4J5B;;;;;;;;;;;GAWG;AACI,oBAAU,GAAG,CAClB,eAAmD,EACnD,OAMC,EACmB,EAAE;IACtB,OAAO,EAAS,CAAC,cAAc,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;AAC5D,CAAC,CAAA,AAXgB,CAWf"}
+{"version":3,"file":"push-chain.js","sourceRoot":"","sources":["../../../../../../packages/core/src/lib/push-chain/push-chain.ts"],"names":[],"mappings":";;;;;AAAA,4CAAyC;AACzC,8CAA6D;AAC7D,8CAAgD;AAChD,+DAA4D;AAC5D,gDAA4D;AAK5D,oCAAiC;AACjC,8CAA0C;AAC1C,+BAA6E;AAE7E,wDAAoD;AACpD,gDAQ6B;AAE7B;;;;;GAKG;AACH,MAAa,SAAS;IAapB;;OAEG;IACK,MAAM,CAAC,kBAAkB,CAC/B,KAAyC;QAEzC,OAAO,CAAC,CAAC,aAAa,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,wBAAwB,IAAI,KAAK,CAAC,CAAC;IAC3E,CAAC;IAwDD,YACU,YAA0B,EAC1B,eAAgC,EAChC,cAAgD,EACjD,UAAmB;;QAHlB,iBAAY,GAAZ,YAAY,CAAc;QAC1B,oBAAe,GAAf,eAAe,CAAiB;QAChC,mBAAc,GAAd,cAAc,CAAkC;QACjD,eAAU,GAAV,UAAU,CAAS;QA4Y5B;;;;;;;;;;;WAWG;QACH,iBAAY,GAAG,CACb,eAAmD,EACnD,OAMC,EACmB,EAAE;;YACtB,MAAM,aAAa,GAAG;gBACpB,OAAO,EAAE,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO,mCAAI,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE;gBAC3D,OAAO,EAAE,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO,mCAAI,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE;gBAC3D,cAAc,EAAE,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,cAAc,mCAAI,IAAI,CAAC,cAAc;gBAC9D,WAAW,EAAE,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,WAAW,mCAAI,IAAI,CAAC,YAAY,CAAC,cAAc,EAAE;gBACvE,YAAY,EACV,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,YAAY,mCAAI,IAAI,CAAC,YAAY,CAAC,eAAe,EAAE;aAO/D,CAAC;YACF,OAAO,EAAS,CAAC,cAAc,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;QAClE,CAAC,CAAA,CAAC;QA/aA,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QAEjC,IAAI,CAAC,SAAS,GAAG;YACf,IAAI,MAAM;gBACR,OAAO,YAAY,CAAC,MAAM,EAAE,CAAC;YAC/B,CAAC;YACD,IAAI,OAAO;gBACT,OAAO,YAAY,CAAC,kBAAkB,EAAE,CAAC;YAC3C,CAAC;YACD,eAAe,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE;gBAC3B,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;oBACpB,MAAM,IAAI,KAAK,CACb,qDAAqD,CACtD,CAAC;gBACJ,CAAC;gBACD,OAAO,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;YAC1D,CAAC;YACD,WAAW,EAAE,CAAO,IAAgB,EAAE,EAAE;gBACtC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;oBACpB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;gBACrE,CAAC;gBACD,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;gBACzD,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC;gBAC5C,IAAI,kBAAU,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,UAAE,CAAC,GAAG,EAAE,CAAC;oBACpC,OAAO,IAAA,iBAAU,EAAC,QAAQ,CAAC,CAAC;gBAC9B,CAAC;qBAAM,IAAI,kBAAU,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,UAAE,CAAC,GAAG,EAAE,CAAC;oBAC3C,OAAO,cAAK,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAC3C,CAAC;gBACD,OAAO,IAAA,iBAAU,EAAC,QAAQ,CAAC,CAAC;YAC9B,CAAC,CAAA;YACD,aAAa,EAAE,CAAO,GAAG,IAAI,EAAE,EAAE;gBAC/B,IAAI,OAAO,eAAe,CAAC,aAAa,KAAK,UAAU,EAAE,CAAC;oBACxD,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;gBACtD,CAAC;gBACD,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,CAAC;gBAC/D,OAAO,IAAA,iBAAU,EAAC,SAAS,CAAC,CAAC;YAC/B,CAAC,CAAA;SACF,CAAC;QAEF,IAAI,CAAC,QAAQ,GAAG;YACd,iBAAiB,EAAE,CAAC,MAAc,EAAE,EAAE;gBACpC,OAAO,iCAAiC,MAAM,EAAE,CAAC;YACnD,CAAC;YACD,QAAQ,EAAE,GAAG,EAAE;;gBACb,OAAO,MAAA,cAAc,CAAC,aAAK,CAAC,kBAAkB,CAAC,mCAAI,EAAE,CAAC;YACxD,CAAC;SACF,CAAC;QAEF,8DAA8D;QAC9D,MAAM,WAAW,GAAG,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC;QAClD,MAAM,UAAU,GAAG,CAA+B,GAAoB,EAAE,EAAE,CACxE,CAAC,GAAG,aAAH,GAAG,cAAH,GAAG,GAAI,EAAE,CAAC,CAAC,MAAM,CAAoB,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;YAC/C,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAClB,OAAO,GAAG,CAAC;QACb,CAAC,EAAE,EAAE,CAAC,CAAC;QAET,MAAM,YAAY,GAChB,MAAA,MAAA,MAAA,wBAAe,CAAC,WAAW,CAAC,mCAC5B,wBAAe,CAAC,aAAK,CAAC,gBAAgB,CAAC,mCACvC,wBAAe,CAAC,aAAK,CAAC,gBAAgB,CAAC,mCACvC,EAAE,CAAC;QACL,MAAM,WAAW,GACf,MAAA,MAAA,MAAA,uBAAc,CAAC,WAAW,CAAC,mCAC3B,uBAAc,CAAC,aAAK,CAAC,gBAAgB,CAAC,mCACtC,uBAAc,CAAC,aAAK,CAAC,gBAAgB,CAAC,mCACtC,EAAE,CAAC;QAEL,IAAI,CAAC,QAAQ,GAAG;YACd,KAAK,EAAE,IAAI,8BAAqB,CAC9B,UAAU,CAAC,YAAY,CAAkC,CAC1D;SACF,CAAC;QACF,IAAI,CAAC,OAAO,GAAG;YACb,KAAK,EAAE,IAAI,6BAAoB,CAC7B,UAAU,CAAC,WAAW,CAAiC,CACxD;SACF,CAAC;QAEF,IAAI,CAAC,KAAK,GAAG;YACX,kBAAkB,EAAE,iBASQ,EAAE,8DAR5B,QAAgB,EAChB,EACE,IAAI,EACJ,EAAE,GAIH;;gBAED,MAAM,WAAW,GAAG,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC;gBAClD,IACE,WAAW,KAAK,aAAK,CAAC,gBAAgB;oBACtC,WAAW,KAAK,aAAK,CAAC,gBAAgB,EACtC,CAAC;oBACD,MAAM,IAAI,KAAK,CACb,8EAA8E,CAC/E,CAAC;gBACJ,CAAC;gBAED,IAAI,CAAC,IAAI,EAAE,CAAC;oBACV,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;gBAC5C,CAAC;gBAED,IAAI,CAAC,EAAE,EAAE,CAAC;oBACR,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;gBAC1C,CAAC;gBAED,wGAAwG;gBACxG,IACE,WAAW,KAAK,aAAK,CAAC,gBAAgB;oBACtC,IAAI,CAAC,MAAM,KAAK,MAAM;oBACtB,EAAE,CAAC,MAAM,KAAK,MAAM,EACpB,CAAC;oBACD,4DAA4D;oBAC5D,MAAM,OAAO,GACX,YAAY,CAAC,UAAU,EAAE,CAAC,WAAW,CAAC;wBACtC,kBAAU,CAAC,WAAW,CAAC,CAAC,UAAU,CAAC;oBAErC,MAAM,GAAG,GAAG,IAAI,sBAAS,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;oBAEvC,uDAAuD;oBACvD,MAAM,aAAa,GAAQ,IAAA,eAAQ,EAAC;wBAClC,uIAAuI;wBACvI,0CAA0C;qBAC3C,CAAC,CAAC;oBACH,MAAM,oBAAoB,GACxB,4CAA6D,CAAC;oBAEhE,yBAAyB;oBACzB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;wBACtC,GAAG,CAAC,YAAY,CAQd;4BACA,GAAG,EAAE,aAAa;4BAClB,OAAO,EAAE,oBAAoB;4BAC7B,YAAY,EAAE,iBAAiB;4BAC/B,IAAI,EAAE,EAAE;yBACT,CAAC;wBACF,GAAG,CAAC,YAAY,CAAS;4BACvB,GAAG,EAAE,aAAa;4BAClB,OAAO,EAAE,oBAAoB;4BAC7B,YAAY,EAAE,UAAU;4BACxB,IAAI,EAAE,EAAE;yBACT,CAAC;qBACH,CAAC,CAAC;oBAEH,MAAM,MAAM,GAAG,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAG,CAAC,CAAC,mCAAI,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,wCAAwC;oBACjF,IAAI,MAAM,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;wBACxB,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;oBACxD,CAAC;oBAED,kFAAkF;oBAClF,IAAI,GAAG,GAAG,EAAE,EAAE,CAAC;wBACb,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;oBACnD,CAAC;oBACD,MAAM,KAAK,GAAG,CAAC,GAAW,EAAU,EAAE;wBACpC,IAAI,GAAG,IAAI,CAAC;4BAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;wBAC/B,IAAI,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;wBACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE;4BAAE,MAAM,IAAI,MAAM,CAAC,EAAE,CAAC,CAAC;wBACnD,OAAO,MAAM,CAAC;oBAChB,CAAC,CAAC;oBACF,MAAM,UAAU,GAAG,KAAK,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC;oBACnC,MAAM,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC,CAAC,sBAAsB;oBAE7D,oEAAoE;oBACpE,MAAM,YAAY,GAChB,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;oBACxD,MAAM,OAAO,GACX,YAAY,IAAI,EAAE;wBAChB,CAAC,CAAC,QAAQ,GAAG,KAAK,CAAC,EAAE,GAAG,YAAY,CAAC;wBACrC,CAAC,CAAC,QAAQ,GAAG,KAAK,CAAC,YAAY,GAAG,EAAE,CAAC,CAAC;oBAE1C,4CAA4C;oBAC5C,MAAM,YAAY,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC;oBAEvD,MAAM,aAAa,GAAG,UAAU,CAC9B,aAAK,CAAC,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CACjE,CAAC;oBACF,MAAM,cAAc,GAAG,UAAU,CAC/B,aAAK,CAAC,OAAO,CAAC,WAAW,CAAC,YAAY,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,CAAC,CACnE,CAAC;oBACF,MAAM,IAAI,GAAG,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;oBAEpE,OAAO;wBACL,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE;wBAC7B,SAAS,EAAE,YAAY,CAAC,QAAQ,EAAE;wBAClC,IAAI;wBACJ,KAAK,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC;wBAC/B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;qBACtB,CAAC;gBACJ,CAAC;gBAED,4DAA4D;gBAC5D,MAAM,OAAO,GACX,YAAY,CAAC,UAAU,EAAE,CAAC,WAAW,CAAC;oBACtC,kBAAU,CAAC,WAAW,CAAC,CAAC,UAAU,CAAC;gBAErC,MAAM,GAAG,GAAG,IAAI,sBAAS,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;gBAEvC,4DAA4D;gBAC5D,MAAM,kBAAkB,GACtB,WAAW,KAAK,aAAK,CAAC,gBAAgB;oBACpC,CAAC,CAAE,4CAA8D;oBACjE,CAAC,CAAE,4CAA8D,CAAC;gBACtE,MAAM,oBAAoB,GACxB,WAAW,KAAK,aAAK,CAAC,gBAAgB;oBACpC,CAAC,CAAE,4CAA8D;oBACjE,CAAC,CAAE,4CAA8D,CAAC;gBAEtE,MAAM,UAAU,GAAQ,IAAA,eAAQ,EAAC;oBAC/B,qFAAqF;iBACtF,CAAC,CAAC;gBACH,MAAM,SAAS,GAAQ,IAAA,eAAQ,EAAC;oBAC9B,iPAAiP;iBAClP,CAAC,CAAC;gBACH,MAAM,OAAO,GAAQ,IAAA,eAAQ,EAAC;oBAC5B,6CAA6C;iBAC9C,CAAC,CAAC;gBAEH,MAAM,QAAQ,GAAa,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;gBAEnD,IAAI,aAAa,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;gBAC9B,IAAI,OAAO,GAAkB,IAAI,CAAC;gBAElC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;oBAC3B,sCAAsC;oBACtC,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,YAAY,CAAS;wBACjD,GAAG,EAAE,UAAU;wBACf,OAAO,EAAE,kBAAkB;wBAC3B,YAAY,EAAE,SAAS;wBACvB,IAAI,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC;qBACtC,CAAC,CAAC;oBAEH,MAAM,MAAM,GACV,CAAC,WAAW;wBACZ,WAAW,CAAC,WAAW,EAAE;4BACvB,4CAA4C,CAAC;oBACjD,IAAI,MAAM;wBAAE,SAAS;oBAErB,yDAAyD;oBACzD,IAAI,CAAC;wBACH,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,YAAY,CAAS;4BAC/C,GAAG,EAAE,OAAO;4BACZ,OAAO,EAAE,WAA4B;4BACrC,YAAY,EAAE,WAAW;4BACzB,IAAI,EAAE,EAAE;yBACT,CAAC,CAAC;wBACH,IAAI,CAAC,SAAS,IAAI,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;4BAC1C,SAAS;wBACX,CAAC;oBACH,CAAC;oBAAC,WAAM,CAAC;wBACP,sDAAsD;wBACtD,SAAS;oBACX,CAAC;oBAED,6FAA6F;oBAC7F,IAAI,CAAC;wBACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,YAAY,CAEnC;4BACA,GAAG,EAAE,SAAS;4BACd,OAAO,EAAE,oBAAoB;4BAC7B,YAAY,EAAE,uBAAuB;4BACrC,IAAI,EAAE;gCACJ;oCACE,OAAO,EAAE,IAAI,CAAC,OAAO;oCACrB,QAAQ,EAAE,EAAE,CAAC,OAAO;oCACpB,QAAQ;oCACR,GAAG;oCACH,iBAAiB,EAAE,MAAM,CAAC,CAAC,CAAC;iCAC7B;6BACF;yBACF,CAAC,CAAC;wBAEH,MAAM,SAAS,GAAG,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAG,CAAC,CAAC,mCAAI,MAAM,CAAC,CAAC,CAAC,CAAC;wBAC3C,IAAI,SAAS,GAAG,aAAa,EAAE,CAAC;4BAC9B,aAAa,GAAG,SAAS,CAAC;4BAC1B,OAAO,GAAG,GAAG,CAAC;wBAChB,CAAC;oBACH,CAAC;oBAAC,WAAM,CAAC;wBACP,eAAe;oBACjB,CAAC;gBACH,CAAC;gBAED,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,MAAM,IAAI,KAAK,CACb,8EAA8E,CAC/E,CAAC;gBACJ,CAAC;gBAED,gDAAgD;gBAChD,MAAM,aAAa,GAAG,UAAU,CAC9B,aAAK,CAAC,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CACjE,CAAC;gBACF,MAAM,cAAc,GAAG,UAAU,CAC/B,aAAK,CAAC,OAAO,CAAC,WAAW,CAAC,aAAa,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,CAAC,CACpE,CAAC;gBACF,MAAM,IAAI,GAAG,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;gBAEpE,OAAO;oBACL,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE;oBAC7B,SAAS,EAAE,aAAa,CAAC,QAAQ,EAAE;oBACnC,IAAI;oBACJ,KAAK,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC;oBAC/B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;iBACtB,CAAC;YACJ,CAAC,CAAA;SACF,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACK,MAAM,CAAO,cAAc,CACjC,eAAmD,EACnD,OAMC;;;YAED,MAAM,UAAU,GAAG,EAAS,CAAC,kBAAkB,CAAC,eAAe,CAAC,CAAC;YAEjE,qFAAqF;YACrF,MAAM,wBAAwB,GAAG,UAAU;gBACzC,CAAC,CAAC,IAAA,8BAAqB,EAAC;oBACpB,OAAO,EAAE,eAAe;oBACxB,WAAW,EAAE,GAAS,EAAE;wBACtB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;oBACrE,CAAC,CAAA;oBACD,sBAAsB,EAAE,GAAS,EAAE;wBACjC,MAAM,IAAI,KAAK,CACb,4DAA4D,CAC7D,CAAC;oBACJ,CAAC,CAAA;iBACF,CAAC;gBACJ,CAAC,CAAC,IAAA,8BAAqB,EAAC,eAAkC,CAAC,CAAC;YAE9D,MAAM,cAAc,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,cAAc,mCAAI;gBAChD,CAAC,aAAK,CAAC,kBAAkB,CAAC,EAAE,CAAC,4BAA4B,CAAC;aAC3D,CAAC;YACF,MAAM,YAAY,GAAG,IAAI,2BAAY;YACnC;;eAEG;YACH,wBAAwB,EACxB,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO,mCAAI,oBAAY,CAAC,aAAa,EAC9C,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO,mCAAI,EAAE,EACtB,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,WAAW,mCAAI,KAAK,EAC7B,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,YAAY,CACtB,CAAC;YACF,OAAO,IAAI,EAAS,CAClB,YAAY,EACZ,wBAAwB,EACxB,cAAc,EACd,UAAU,CACX,CAAC;QACJ,CAAC;KAAA;;AAjcH,8BAkgBC;;AAjgBC;;;GAGG;AACW,mBAAS,GAAG,qBAAS,AAAZ,CAAa;AAEpC;;;GAGG;AACW,eAAK,GAAG,aAAK,AAAR,CAAS;AAwb5B;;;;;;;;;;;GAWG;AACI,oBAAU,GAAG,CAClB,eAAmD,EACnD,OAMC,EACmB,EAAE;IACtB,OAAO,EAAS,CAAC,cAAc,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;AAC5D,CAAC,CAAA,AAXgB,CAWf"}

package/src/lib/utils.d.ts

@@ -1,5 +1,7 @@
 import { convertOriginToExecutor, fromChainAgnostic, convertExecutorToOriginAccount, toChainAgnostic, toUniversal } from './universal/account';
 import { construct, toUniversal as toUniversalSigner, toUniversalFromKeypair } from './universal/signer';
+import { CHAIN } from './constants/enums';
+import type { PushChain } from './push-chain/push-chain';
 /**
  * @dev - THESE UTILS ARE EXPORTED TO SDK CONSUMER
  * @dev - Make sure each exported fn has good comments to help out sdk consumer
@@ -55,7 +57,7 @@ export declare class Utils {
          * For example, converting "1.5" ETH to wei (18 decimals) would be parseUnits("1.5", 18).
          *
          * @param {string} value - The string representation of the number to multiply.
-         * @param {number} exponent - The exponent (number of decimal places).
+         * @param {number | {decimals: number}} exponent - The exponent (number of decimal places) or an object with decimals property.
          * @returns {bigint} The result as a bigint.
          *
          * @example
@@ -65,7 +67,101 @@ export declare class Utils {
          * @example
          * Utils.helpers.parseUnits('1.5', 18)
          * // → 1500000000000000000n
+         *
+         * @example
+         * Utils.helpers.parseUnits('1.5', {decimals: 18})
+         * // → 1500000000000000000n
          */
-        parseUnits(value: string, exponent: number): bigint;
+        parseUnits(value: string, exponent: number | {
+            decimals: number;
+        }): bigint;
+        /**
+         * Formats a value from smallest units to human-readable string.
+         *
+         * Supports both EVM-style (like ethers/viem) and Push-style (options object) usage patterns.
+         * Always returns a string for UI safety.
+         *
+         * @param {bigint | string} value - The value in smallest units (e.g., "1500000" or 1500000000000000000n).
+         * @param {number | {decimals: number; precision?: number}} decimalsOrOptions - Token decimals or options object.
+         * @returns {string} Human-readable string (e.g., "1.5").
+         *
+         * @example
+         * // EVM-style usage
+         * Utils.helpers.formatUnits(1500000000000000000n, 18)
+         * // → "1.5"
+         *
+         * @example
+         * // Push-style usage
+         * Utils.helpers.formatUnits("1500000", { decimals: 6 })
+         * // → "1.5"
+         *
+         * @example
+         * // With precision (truncate after 2 decimals)
+         * Utils.helpers.formatUnits("1234567", { decimals: 6, precision: 2 })
+         * // → "1.23"
+         */
+        formatUnits(value: bigint | string, decimalsOrOptions: number | {
+            decimals: number;
+            precision?: number;
+        }): string;
+        /**
+         * Calculates the minimum amount out after applying slippage.
+         *
+         * Given an input amount and slippage in basis points, returns the minimum amount
+         * that should be received after accounting for slippage.
+         *
+         * @param {string} amount - The input amount in smallest units (e.g., "100000000" for 100 USDC with 6 decimals)
+         * @param {object} options - Configuration options
+         * @param {number} options.slippageBps - Slippage in basis points (100 = 1%, 50 = 0.5%)
+         * @returns {string} The minimum amount out in smallest units
+         *
+         * @example
+         * // Calculate minimum amount for 100 USDC with 1% slippage
+         * const amount = PushChain.utils.helpers.parseUnits("100", 6); // "100000000"
+         * const minOut = PushChain.utils.helpers.slippageToMinAmount(amount, {
+         *   slippageBps: 100, // 1%
+         * });
+         * // => "99000000" (99 USDC in smallest units)
+         *
+         * @example
+         * // Simple case with whole numbers
+         * const minOut = PushChain.utils.helpers.slippageToMinAmount("100", {
+         *   slippageBps: 100, // 1%
+         * });
+         * // => "99"
+         */
+        slippageToMinAmount(amount: string, options: {
+            slippageBps: number;
+        }): string;
+    };
+    /**
+     * Returns supported moveable tokens as a flat list with chain info.
+     * - If a specific chain or a PushChain client is passed, returns only that chain's tokens
+     * - Otherwise returns tokens across all chains
+     */
+    static getMoveableTokens(chainOrClient?: CHAIN | PushChain): {
+        tokens: Array<{
+            chain: CHAIN;
+            symbol: string;
+            decimals: number;
+            address: string;
+        }>;
+    };
+    /**
+     * Returns supported payable tokens as a flat list with chain info.
+     * - If a specific chain or a PushChain client is passed, returns only that chain's tokens
+     * - Otherwise returns tokens across all chains
+     */
+    static getPayableTokens(chainOrClient?: CHAIN | PushChain): {
+        tokens: Array<{
+            chain: CHAIN;
+            symbol: string;
+            decimals: number;
+            address: string;
+        }>;
     };
+    /**
+     * Internal: resolves a CHAIN enum from either a CHAIN value or a PushChain client instance.
+     */
+    private static resolveChainFromInput;
 }