@gibs/bridge-sdk 1.13.1 → 1.18.0

package/dist/cjs/config.js

@@ -0,0 +1,569 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FOREIGN_TO_HOME_FEE = exports.HOME_TO_FOREIGN_FEE = exports.bridgeConfigs = exports.startBlocks = exports.chainIds = exports.chains = exports.canChangeUnwrap = exports.isUnwrappable = exports.isNative = exports.defaultAssetIn = exports.pathway = exports.pathwayGroup = exports.inferBridgeKey = exports.isTestnetChain = exports.validBridgeKeys = exports.testnetPathways = exports.pathways = exports.nativeTokenName = exports.nativeTokenSymbol = exports.uniV2Factories = exports.uniV2Routers = exports.defaultSwapVenues = exports.deprecatedNativeAssetOut = exports.pulsechainTokenAddresses = exports.nativeAssetOut = exports.Providers = exports.toChainKey = exports.toChain = exports.chainIdToKey = exports.Chains = void 0;
+const viem_1 = require("viem");
+(function (Chains) {
+    Chains["PLS"] = "0x171";
+    Chains["ETH"] = "0x1";
+    Chains["BNB"] = "0x38";
+    // testnets
+    Chains["SEP"] = "0xaa36a7";
+    Chains["V4PLS"] = "0x3af";
+    // TBNB = '0x61',
+})(exports.Chains || (exports.Chains = {}));
+/** A map of chain ids to chain keys */
+exports.chainIdToKey = new Map(Object.entries(exports.Chains).map(([key, chain]) => [chain, key]));
+/**
+ * Converts a chain id to a chain key
+ * @param chainId - the chain id
+ * @returns the chain key
+ */
+const toChain = (chainId) => `0x${Number(chainId).toString(16)}`;
+exports.toChain = toChain;
+/**
+ * Converts a chain id to a chain key
+ * @param chainId - the chain id
+ * @returns the chain key
+ */
+const toChainKey = (chainId) => exports.chainIdToKey.get((0, exports.toChain)(chainId));
+exports.toChainKey = toChainKey;
+// /** The provider of an omnibridge */
+// export enum Provider {
+//   PULSECHAIN = 'pulsechain',
+//   TOKENSEX = 'tokensex',
+// }
+exports.Providers = {
+    PULSECHAIN: 'pulsechain',
+    TOKENSEX: 'tokensex',
+};
+/** A map of chains to native asset out addresses */
+exports.nativeAssetOut = {
+    [exports.Chains.ETH]: '0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2',
+    [exports.Chains.BNB]: '0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c',
+    [exports.Chains.PLS]: '0xA1077a294dDE1B09bB078844df40758a5D0f9a27',
+    [exports.Chains.SEP]: '0x7b79995e5f793A07Bc00c21412e50Ecae098E7f9',
+    [exports.Chains.V4PLS]: '0x70499adEBB11Efd915E3b69E700c331778628707',
+};
+/**
+ * Four PulseChain mainnet tokens that no other constant in this package
+ * names. The PulseX carrier routes swaps through them
+ * (`routing/carriers/pulsex-paths.ts`), and the interface builds its
+ * PulseChain hub nodes from the two stablecoins.
+ *
+ * Each address was already in the repository before it moved here: USDC and
+ * USDT from the interface's `HUB_STABLECOIN_ADDRESSES`
+ * (`packages/ui/src/lib/state/useRouteSearch.ts`), PLSX and HEX from
+ * `scripts/route-parity-corpus.ts`. Each one was read on chain again on
+ * 2026-10-06 (`symbol()`, `decimals()`): PLSX 18, HEX 8, USDC 6, USDT 6.
+ * `getAddress` checksums them at load, so a mistyped character fails the
+ * build rather than silently matching nothing.
+ */
+exports.pulsechainTokenAddresses = Object.freeze({
+    /** PulseX, the exchange's own token. */
+    PLSX: (0, viem_1.getAddress)('0x95b303987a60c71504d99aa1b13b4da07b0790ab'),
+    /** HEX. */
+    HEX: (0, viem_1.getAddress)('0x2b591e99afe9f32eaa6214f7b7629768c40eeb39'),
+    /** USD Coin, bridged from Ethereum. */
+    USDC: (0, viem_1.getAddress)('0x15d38573d2feeb82e7ad5187ab8c1d52810b1f07'),
+    /** Tether USD, bridged from Ethereum. */
+    USDT: (0, viem_1.getAddress)('0x0cb6f5a34ad42ec934882a05265a7d5f59b51a2f'),
+});
+/** A map of chains to deprecated native asset out addresses */
+exports.deprecatedNativeAssetOut = {
+    [exports.Chains.PLS]: new Set(['0x97Ac4a2439A47c07ad535bb1188c989dae755341']),
+};
+/**
+ * Routers on chains where this package knows the router but has not verified
+ * a factory, so no {@link SwapVenue} can be built for them. They stay in
+ * {@link uniV2Routers} for the native-price reads (`chain-info.ts`,
+ * `readAmountOut`) that need only a router.
+ */
+const routersWithoutVenue = {
+    [exports.Chains.ETH]: ['0x7a250d5630b4cf539739df2c5dacb4c659f2488d'],
+    [exports.Chains.BNB]: ['0x05fF2B0DB69458A0750badebc4f9e13aDd608C7F'],
+    [exports.Chains.SEP]: ['0xeE567Fe1712Faf6149d80dA1E6934E354124CfE3'],
+    [exports.Chains.V4PLS]: [
+        '0xDaE9dd3d1A52CfCe9d5F2fAC7fDe164D500E50f7',
+        '0x636f6407B90661b73b1C0F7e24F4C79f624d0738',
+    ],
+};
+/**
+ * The swap venues the package ships with: PulseX V1 then V2 on PulseChain.
+ * Frozen. A caller who wants other routers passes its own
+ * {@link SwapVenues} (see `resolveSwapVenues`); this table is never mutated.
+ *
+ * Each factory is the router's own `router.factory()` read on chain — see
+ * {@link uniV2Factories}'s doc. The fee is 29 basis points for both
+ * deployments (measured, same doc).
+ */
+exports.defaultSwapVenues = Object.freeze({
+    [Number(exports.Chains.PLS)]: Object.freeze([
+        Object.freeze({
+            kind: 'uniswap-v2',
+            chainId: Number(exports.Chains.PLS),
+            router: '0x98bf93ebf5c380C0e6Ae8e192A7e2AE08edAcc02',
+            factory: '0x1715a3E4A142d8b698131108995174F37aEBA10D',
+            feeBasisPoints: 29,
+            label: 'PulseX V1',
+        }),
+        Object.freeze({
+            kind: 'uniswap-v2',
+            chainId: Number(exports.Chains.PLS),
+            router: '0x165C3410fC91EF562C50559f7d2289fEbed552d9',
+            factory: '0x29eA7545DEf87022BAdc76323F373EA1e707C523',
+            feeBasisPoints: 29,
+            label: 'PulseX V2',
+        }),
+    ]),
+});
+/** One chain's routers: its default venues' routers, else the router-only entries. */
+const defaultRoutersFor = (chain) => exports.defaultSwapVenues[Number(chain)]?.map((venue) => venue.router) ?? routersWithoutVenue[chain] ?? [];
+/**
+ * A map of chains to uni v2 router addresses. Frozen. PulseChain's entries
+ * derive from {@link defaultSwapVenues}, so the two cannot drift. Kept for
+ * compatibility; to swap on other routers pass `swapVenues` instead.
+ */
+exports.uniV2Routers = Object.freeze(Object.fromEntries(Object.values(exports.Chains).map((chain) => [chain, Object.freeze([...defaultRoutersFor(chain)])])));
+/**
+ * Each {@link uniV2Routers} entry's OWN factory address, same index, same
+ * chain — `router.factory()` read live from `one.valve.city` on 2026-09-24.
+ * Only PulseChain mainnet is filled: PulseX carries funds nowhere else
+ * (`routing/carriers/pulsex.ts`'s own `pulseXCarries`), so no other chain's
+ * factory has ever been needed or verified.
+ *
+ * MEASURED, NOT ASSUMED (owner Rule 13). Reading each factory's `getPair`
+ * and the resulting pool's `getReserves`, then recomputing `getAmountsOut`
+ * from the standard constant-product formula, showed the SAME fee ratio for
+ * both — `9971/10000` (0.29%) — to the base unit, on both a one-hop and a
+ * two-hop path. "V1 and V2 differ" was the assumption going in; measurement
+ * said otherwise, so `routing/carriers/pulsex.ts`'s `exact` uses one shared
+ * fee constant rather than two.
+ *
+ * `0x1715a3E4A142d8b698131108995174F37aEBA10D` (the V1 factory, index 0) is
+ * NOT a copy-paste of the omnibridge's Ethereum mediator address from
+ * `pathways` above — it is the same string on a DIFFERENT chain (PulseChain,
+ * not Ethereum), confirmed by reading it fresh from `one.valve.city/…/evm/369`.
+ * Two unrelated contracts landing on the same address on two different
+ * chains is possible (a shared deployer at a matching nonce, or a CREATE2
+ * salt collision) and worth this note so a future reader does not assume a
+ * transcription error and "fix" it back to something wrong.
+ */
+exports.uniV2Factories = Object.freeze(Object.fromEntries(Object.values(exports.Chains).map((chain) => [
+    chain,
+    Object.freeze((exports.defaultSwapVenues[Number(chain)] ?? []).map((venue) => venue.factory)),
+])));
+/** A map of chains to native token symbols */
+exports.nativeTokenSymbol = {
+    [exports.Chains.PLS]: 'PLS',
+    [exports.Chains.V4PLS]: 'V4PLS',
+    [exports.Chains.ETH]: 'ETH',
+    [exports.Chains.SEP]: 'sepETH',
+    [exports.Chains.BNB]: 'BNB',
+};
+/** A map of chains to native token names */
+exports.nativeTokenName = {
+    [exports.Chains.PLS]: 'Pulse',
+    [exports.Chains.V4PLS]: 'V4 Pulse',
+    [exports.Chains.ETH]: 'Ether',
+    [exports.Chains.SEP]: 'Sepolia Ether',
+    [exports.Chains.BNB]: 'BNB',
+};
+/** The settings for the pulsechain pls eth pathway */
+const pulsechainPLSETHSettings = {
+    from: '0x0e18d0d556b652794EF12Bf68B2dC857EF5f3996',
+    to: '0xe20E337DB2a00b1C37139c873B92a0AAd3F468bF',
+    destinationRouter: '0x1F0144Ce3BDaf11944Fe0beF6444599a0500695B',
+    nativeRouter: '0xE66877Cfe4CEc10ffBbBB3092B7001321AB5809D',
+};
+exports.pathways = {
+    [exports.Providers.PULSECHAIN]: {
+        [exports.Chains.PLS]: {
+            [exports.Chains.ETH]: {
+                from: '0x4fD0aaa7506f3d9cB8274bdB946Ec42A1b8751Ef',
+                to: '0x1715a3E4A142d8b698131108995174F37aEBA10D',
+                destinationRouter: '0x2Ed02372C3efF1F239B22a901ceA8Cf6fbf82d8d',
+                nativeRouter: '0x612Da68aA7BcA625dD2F27f252cddB573674991A',
+                validator: '0x5ECfE77502317F3677f23C3b8Ab17929ACE3D74E',
+                usesExtraParam: false,
+                feeManager: 'from',
+                toHome: false,
+                requiresDelivery: true,
+                // weth from ethereum on pulsechain
+                bridgedNativeAssetOut: '0x02DcdD04e3F455D838cd1249292C58f3B79e3C3C',
+                settingOverrides: {
+                    [viem_1.zeroAddress]: pulsechainPLSETHSettings,
+                    [(0, viem_1.getAddress)(exports.nativeAssetOut[exports.Chains.PLS])]: pulsechainPLSETHSettings,
+                },
+            },
+        },
+        [exports.Chains.ETH]: {
+            [exports.Chains.PLS]: {
+                from: '0x1715a3E4A142d8b698131108995174F37aEBA10D',
+                to: '0x4fD0aaa7506f3d9cB8274bdB946Ec42A1b8751Ef',
+                nativeRouter: '0x2Ed02372C3efF1F239B22a901ceA8Cf6fbf82d8d',
+                destinationRouter: '0x612Da68aA7BcA625dD2F27f252cddB573674991A',
+                validator: '0x5ECfE77502317F3677f23C3b8Ab17929ACE3D74E',
+                feeManager: 'to',
+                usesExtraParam: false,
+                toHome: true,
+                requiresDelivery: false,
+                // wpls from pulsechain on ethereum
+                bridgedNativeAssetOut: '0xA882606494D86804B5514E07e6Bd2D6a6eE6d68A',
+                settingOverrides: {
+                    [(0, viem_1.getAddress)('0xa882606494d86804b5514e07e6bd2d6a6ee6d68a')]: {
+                        from: '0xe20E337DB2a00b1C37139c873B92a0AAd3F468bF',
+                        to: '0x0e18d0d556b652794EF12Bf68B2dC857EF5f3996',
+                        destinationRouter: '0xE66877Cfe4CEc10ffBbBB3092B7001321AB5809D',
+                        nativeRouter: '0x1F0144Ce3BDaf11944Fe0beF6444599a0500695B',
+                    },
+                },
+            },
+        },
+    },
+    [exports.Providers.TOKENSEX]: {
+        [exports.Chains.PLS]: {
+            [exports.Chains.BNB]: {
+                from: '0xf1DFc63e10fF01b8c3d307529b47AefaD2154C0e',
+                to: '0xb4005881e81a6ecd2c1f75d58e8e41f28d59c6b1',
+                destinationRouter: '0x9c50EfD36dF2DBD310fBC981d6D8478cF3484B85',
+                nativeRouter: '0xB80B80EBB375BD83a9d6c0761b197d16a8670f81',
+                validator: '0xc3c3d5d3ba946a2eb3906878ebe187418b0b524e',
+                feeManager: 'from',
+                usesExtraParam: true,
+                toHome: false,
+                requiresDelivery: true,
+                // wbnb from bsc on pulsechain (tokensex)
+                bridgedNativeAssetOut: '0x518076CCE3729eF1a3877EA3647a26e278e764FE',
+            },
+        },
+        [exports.Chains.BNB]: {
+            [exports.Chains.PLS]: {
+                from: '0xb4005881e81a6ecd2c1f75d58e8e41f28d59c6b1',
+                to: '0xf1DFc63e10fF01b8c3d307529b47AefaD2154C0e',
+                nativeRouter: '0x9c50EfD36dF2DBD310fBC981d6D8478cF3484B85',
+                destinationRouter: '0xB80B80EBB375BD83a9d6c0761b197d16a8670f81',
+                validator: '0xc3c3d5d3ba946a2eb3906878ebe187418b0b524e',
+                feeManager: 'to',
+                usesExtraParam: true,
+                toHome: true,
+                requiresDelivery: false,
+                // wpls from pulsechain on bsc (tokensex)
+                bridgedNativeAssetOut: '0xF6088134D28eeBEF7128BA41FaDb2FCA0666c64C',
+            },
+        },
+    },
+};
+exports.testnetPathways = {
+    [exports.Providers.TOKENSEX]: {
+    // plsv4 to bnb home omnibridge: 0xfd0c07C376D27EA0E9fA64Ac5D2481439e36CF9C
+    // [Chains.BNB]: {
+    //   [Chains.V4PLS]: {
+    //     from: '0xDDf1b0CD7fb7AAA310c703C17995c6671F9DC806',
+    //     to: '0xfd0c07C376D27EA0E9fA64Ac5D2481439e36CF9C',
+    //     usesExtraParam: false,
+    //     requiresDelivery: false,
+    //     toHome: true,
+    //     feeManager: 'to',
+    //     defaultAssetIn: {
+    //       chainId: 56,
+    //       address: nativeAssetOut[Chains.TBNB],
+    //     },
+    //   },
+    // },
+    // [Chains.V4PLS]: {
+    //   [Chains.BNB]: {
+    //     from: '0xfd0c07C376D27EA0E9fA64Ac5D2481439e36CF9C',
+    //     to: '0xDDf1b0CD7fb7AAA310c703C17995c6671F9DC806',
+    //   },
+    // },
+    },
+    [exports.Providers.PULSECHAIN]: {
+        [exports.Chains.V4PLS]: {
+            [exports.Chains.SEP]: {
+                from: '0x6B08a50865aDeCe6e3869D9AfbB316d0a0436B6c',
+                to: '0x546e37DAA15cdb82fd1a717E5dEEa4AF08D4349A',
+                nativeRouter: '0xCA1BDc038909038C4B3cbab0EA0ec3cC2839F106',
+                destinationRouter: '0xCb4057d7DA4CE521B93b71186DfE11f9FBC3e3b1',
+                validator: '0xDcd4D88552c86114b2ca029F7F8d4e1a7951d051',
+                usesExtraParam: false,
+                requiresDelivery: true,
+                toHome: false,
+                feeManager: 'from',
+                bridgedNativeAssetOut: '0x3677bd78ccf4d299328ecfba61790cf8dbfcf686',
+            },
+        },
+        [exports.Chains.SEP]: {
+            [exports.Chains.V4PLS]: {
+                from: '0x546e37DAA15cdb82fd1a717E5dEEa4AF08D4349A',
+                to: '0x6B08a50865aDeCe6e3869D9AfbB316d0a0436B6c',
+                nativeRouter: '0xCb4057d7DA4CE521B93b71186DfE11f9FBC3e3b1',
+                destinationRouter: '0xCA1BDc038909038C4B3cbab0EA0ec3cC2839F106',
+                validator: '0xDcd4D88552c86114b2ca029F7F8d4e1a7951d051',
+                usesExtraParam: false,
+                requiresDelivery: false,
+                toHome: true,
+                feeManager: 'to',
+                bridgedNativeAssetOut: '0x35807560aD0597E23F452cdc82D4Fb0e7E3c6590',
+            },
+        },
+    },
+};
+/** The mainnet bridge keys */
+const mainnetBridgeKeys = [
+    [exports.Providers.PULSECHAIN, exports.Chains.PLS, exports.Chains.ETH],
+    [exports.Providers.PULSECHAIN, exports.Chains.ETH, exports.Chains.PLS],
+    [exports.Providers.TOKENSEX, exports.Chains.PLS, exports.Chains.BNB],
+    [exports.Providers.TOKENSEX, exports.Chains.BNB, exports.Chains.PLS],
+];
+/** The testnet bridge keys */
+const testnetBridgeKeys = [
+    [exports.Providers.PULSECHAIN, exports.Chains.SEP, exports.Chains.V4PLS],
+    [exports.Providers.PULSECHAIN, exports.Chains.V4PLS, exports.Chains.SEP],
+];
+/** Returns the valid bridge keys for the given is prod */
+const validBridgeKeys = (isProd) => [
+    ...mainnetBridgeKeys,
+    ...(isProd ? [] : testnetBridgeKeys),
+];
+exports.validBridgeKeys = validBridgeKeys;
+/** Every chain that appears only on a testnet pathway. */
+const testnetChains = new Set(testnetBridgeKeys.flatMap(([, fromChain, toChain]) => [fromChain, toChain]));
+/**
+ * Whether a chain belongs to the testnet pathway map rather than the mainnet one.
+ * @param chain - the chain to classify
+ * @returns true for Sepolia and PulseChain testnet V4
+ */
+const isTestnetChain = (chain) => testnetChains.has(chain);
+exports.isTestnetChain = isTestnetChain;
+/**
+ * Infers the bridge key from the current key, provider, from chain, and to chain.
+ *
+ * A chain the provider does not serve falls back to the provider's first chain,
+ * so a provider switch lands on a real pathway. That fallback never crosses
+ * between the testnet and mainnet maps: when testnets are off and a requested
+ * chain is a testnet chain, this returns null rather than a mainnet key for a
+ * testnet pair.
+ *
+ * @param options.currentKey - the current bridge key
+ * @param options.provider - the provider
+ * @param options.fromChain - the from chain (defaults to the current key's)
+ * @param options.toChain - the to chain (defaults to the current key's)
+ * @param options.isProd - true leaves testnet pathways out (default false: both maps)
+ * @returns the inferred bridge key, or null when no pathway can honour the request
+ */
+const inferBridgeKey = ({ currentKey, provider, fromChain, toChain, isProd = false, }) => {
+    const [, fromChainKey, toChainKey] = currentKey;
+    const from = fromChain ?? fromChainKey;
+    const to = toChain ?? toChainKey;
+    if (isProd && ((0, exports.isTestnetChain)(from) || (0, exports.isTestnetChain)(to))) {
+        return null;
+    }
+    const network = (0, exports.isTestnetChain)(from) ? exports.testnetPathways : exports.pathways;
+    const providerGroups = network[provider] ?? {};
+    const nextFromChain = providerGroups[from] ? from : Object.keys(providerGroups)[0];
+    if (!nextFromChain) {
+        return null;
+    }
+    const destinations = providerGroups[nextFromChain] ?? {};
+    const nextToChain = destinations[to] ? to : Object.keys(destinations)[0];
+    if (!nextToChain) {
+        return null;
+    }
+    return [provider, nextFromChain, nextToChain];
+};
+exports.inferBridgeKey = inferBridgeKey;
+/**
+ * Returns the pathway for the given bridge key, is prod, and asset in address
+ * @param bridgeKey - the bridge key
+ * @param isProd - whether to use the production pathway
+ * @param assetInAddress - the asset in address
+ * @returns the pathway
+ */
+/**
+ * The pathway group for one provider on one chain, honouring the testnet map.
+ *
+ * Exists because {@link pathway} already knew that testnet pathways live in a
+ * SECOND map and are only in play off production, while other callers reached
+ * straight into `pathways` and therefore could not see a testnet route at all.
+ * That is the sort of knowledge that has to live in one place: duplicated, one
+ * copy silently lags the other, and the symptom is a thrown "no pathway found"
+ * on a route the rest of the application considers perfectly valid.
+ *
+ * @param provider - the bridge provider
+ * @param chain - the chain being bridged FROM
+ * @param isProd - whether this is a production build; testnets are off when true
+ * @returns the group keyed by destination chain, or undefined when unknown
+ */
+const pathwayGroup = (provider, chain, isProd) => exports.pathways[provider]?.[chain] || (!isProd ? exports.testnetPathways[provider]?.[chain] : undefined);
+exports.pathwayGroup = pathwayGroup;
+/**
+ * Reads one pathway out of a provider, chain and chain map.
+ *
+ * Every level is optional at runtime: the testnet map leaves whole providers
+ * out, and a caller can hold a bridge key built from untrusted input.
+ *
+ * @param config - the pathway map to read
+ * @param bridgeKey - the provider, origin chain and destination chain
+ * @returns the pathway, or undefined when any level is missing
+ */
+const lookupPathway = (config, [provider, from, to]) => config[provider]?.[from]?.[to];
+const pathway = (bridgeKey, isProd, assetInAddress) => {
+    if (!bridgeKey)
+        return;
+    let pathway = lookupPathway(exports.pathways, bridgeKey) ||
+        (!isProd ? lookupPathway(exports.testnetPathways, bridgeKey) : undefined);
+    if (assetInAddress) {
+        const addr = (0, viem_1.getAddress)(assetInAddress);
+        if (pathway?.settingOverrides?.[addr]) {
+            pathway = {
+                ...pathway,
+                ...pathway.settingOverrides[addr],
+            };
+        }
+    }
+    return pathway;
+};
+exports.pathway = pathway;
+/**
+ * Returns the default asset in for the given bridge key and is prod
+ * @param bridgeKey - the bridge key
+ * @param isProd - whether to use the production pathway
+ * @returns the default asset in
+ */
+const defaultAssetIn = ($bridgeKey, isProd) => {
+    if (!$bridgeKey)
+        return null;
+    const conf = (0, exports.pathway)($bridgeKey, isProd);
+    const defaultAssetIn = conf?.bridgedNativeAssetOut;
+    return defaultAssetIn;
+};
+exports.defaultAssetIn = defaultAssetIn;
+/**
+ * Returns whether the given asset is the native asset for the given bridge key.
+ *
+ * Never throws. A token whose address is not known yet (a {@link TokenOut} for a
+ * not-yet-bridged token), an address that is not a valid address, and a bridge
+ * key with no pathway each answer false.
+ *
+ * @param asset - the asset
+ * @param bridgeKey - the bridge key
+ * @param options - which pathway maps to read; see {@link PathwayLookupOptions}
+ * @returns whether the given asset is the native asset for the given bridge key
+ */
+const isNative = (asset, bridgeKey, options = {}) => {
+    if (!bridgeKey || !asset?.address || !(0, viem_1.isAddress)(asset.address, { strict: false })) {
+        return false;
+    }
+    const path = (0, exports.pathway)(bridgeKey, options.isProd ?? false);
+    if (!path) {
+        return false;
+    }
+    if ((0, viem_1.isAddressEqual)(asset.address, path.bridgedNativeAssetOut)) {
+        return true;
+    }
+    const wrappedNative = exports.nativeAssetOut[(0, exports.toChain)(asset.chainId)];
+    const isGasTokenOrItsWrapper = (0, viem_1.isAddressEqual)(asset.address, viem_1.zeroAddress) ||
+        (!!wrappedNative && (0, viem_1.isAddressEqual)(asset.address, wrappedNative));
+    return isGasTokenOrItsWrapper && !asset.name.includes(' from Pulsechain');
+};
+exports.isNative = isNative;
+/**
+ * Returns whether the given asset is unwrappable for the given bridge key.
+ *
+ * Never throws: a missing or malformed address and a bridge key with no
+ * pathway each answer false.
+ *
+ * @param bridgeKey - the bridge key
+ * @param assetIn - the asset in
+ * @param options - which pathway maps to read; see {@link PathwayLookupOptions}
+ * @returns whether the given asset is unwrappable for the given bridge key
+ */
+const isUnwrappable = (bridgeKey, assetIn, options = {}) => {
+    if (!bridgeKey || !assetIn?.address || !(0, viem_1.isAddress)(assetIn.address, { strict: false })) {
+        return false;
+    }
+    const path = (0, exports.pathway)(bridgeKey, options.isProd ?? false);
+    if (!path) {
+        return false;
+    }
+    return (0, viem_1.isAddressEqual)(path.bridgedNativeAssetOut, assetIn.address);
+};
+exports.isUnwrappable = isUnwrappable;
+/**
+ * Returns whether the given asset can be unwrapped for the given bridge key
+ * @param bridgeKey - the bridge key
+ * @param assetIn - the asset in
+ * @param options - which pathway maps to read; see {@link PathwayLookupOptions}
+ * @returns boolean
+ */
+const canChangeUnwrap = (bridgeKey, assetIn, options = {}) => {
+    return !!assetIn && (0, exports.isUnwrappable)(bridgeKey, assetIn, options);
+};
+exports.canChangeUnwrap = canChangeUnwrap;
+exports.chains = {
+    ethereum: 1,
+    bsc: 56,
+    pulsechain: 369,
+    pulsechainV4: 943,
+    sepolia: 11155111,
+};
+exports.chainIds = Object.values(exports.chains);
+/** Start blocks aligned with when bridge validators began operating — canonical reference for all ponder indexers in this monorepo. */
+exports.startBlocks = {
+    ethereum: 17_264_119,
+    bsc: 28_987_313,
+    pulsechain: 17_268_300,
+    pulsechainV4: 16_564_233,
+    sepolia: 3_331_901,
+};
+// provider -> home -> foreign
+exports.bridgeConfigs = {
+    [exports.Providers.PULSECHAIN]: {
+        [exports.chains.pulsechain]: {
+            [exports.chains.ethereum]: [
+                {
+                    pair: 'mainnet',
+                    key: 'erc20',
+                    home: '0x4fD0aaa7506f3d9cB8274bdB946Ec42A1b8751Ef',
+                    foreign: '0x1715a3e4a142d8b698131108995174f37aeba10d',
+                },
+                {
+                    pair: 'mainnet',
+                    key: 'native',
+                    home: '0x0e18d0d556b652794EF12Bf68B2dC857EF5f3996',
+                    foreign: '0xe20E337DB2a00b1C37139c873B92a0AAd3F468bF',
+                },
+            ],
+        },
+        [exports.chains.pulsechainV4]: {
+            [exports.chains.sepolia]: [
+                {
+                    pair: 'v4',
+                    key: 'erc20',
+                    home: '0x6B08a50865aDeCe6e3869D9AfbB316d0a0436B6c',
+                    foreign: '0x546e37DAA15cdb82fd1a717E5dEEa4AF08D4349A',
+                },
+                {
+                    pair: 'v4',
+                    key: 'native',
+                    home: '0x81c10846F40fA2B173FC47958D0a892529983F50',
+                    foreign: '0x5e238ef968467cf443ef5ecb683b76c5a04a0421',
+                },
+            ],
+        },
+    },
+    [exports.Providers.TOKENSEX]: {
+        [exports.chains.pulsechain]: {
+            [exports.chains.bsc]: [
+                {
+                    pair: 'bsctokensex',
+                    key: 'erc20',
+                    home: '0xf1DFc63e10fF01b8c3d307529b47AefaD2154C0e',
+                    foreign: '0xb4005881e81a6ecd2c1f75d58e8e41f28d59c6b1',
+                },
+            ],
+        },
+    },
+};
+exports.HOME_TO_FOREIGN_FEE = (0, viem_1.keccak256)((0, viem_1.stringToHex)('homeToForeignFee'));
+exports.FOREIGN_TO_HOME_FEE = (0, viem_1.keccak256)((0, viem_1.stringToHex)('foreignToHomeFee'));