@gibs/bridge-client 1.12.0 → 1.13.0

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2026 Gibs Finance
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,53 @@
+# @gibs/bridge-client
+
+Browser-side endpoints, public clients, and caching for a Gibs Finance bridge interface. It has no framework dependency.
+
+It sits between `@gibs/bridge-sdk`, which prices and builds transfers but does no input or output, and an application that renders them.
+
+## Install
+
+```sh
+npm install @gibs/bridge-client viem
+```
+
+`viem` is a peer dependency. The supported range is `>=2.37.0 <3`.
+
+## Requirements
+
+- Node 20 or later, or a modern browser.
+- The package is ESM only. Use `import`, not `require`.
+- `@gibs/bridge-sdk` is a dependency, and it reaches TON code. A browser bundle needs a global `Buffer`. Install the `buffer` package and set `globalThis.Buffer` before you import this package. Node has it already.
+
+## Example
+
+```ts
+import { clientFromChain } from '@gibs/bridge-client/client'
+import { chainLogoUrl } from '@gibs/bridge-client/image'
+import { isSupportedEvmChain } from '@gibs/bridge-client/networks'
+
+const pulsechain = 369
+
+if (isSupportedEvmChain(pulsechain)) {
+  const client = clientFromChain(pulsechain)
+  const blockNumber = await client.getBlockNumber()
+  console.log(blockNumber, chainLogoUrl({ chainId: pulsechain, displayPx: 32 }))
+}
+```
+
+## Subpath exports
+
+Import from a subpath so that your bundler loads only what you use.
+
+| Subpath | Purpose |
+| --- | --- |
+| `@gibs/bridge-client/client` | `clientFromChain`, a cached viem public client per chain |
+| `@gibs/bridge-client/endpoints` | Per-chain RPC endpoint lists, with storage and subscription |
+| `@gibs/bridge-client/networks` | The supported viem chains |
+| `@gibs/bridge-client/image` | Chain logo urls |
+| `@gibs/bridge-client/token-metadata` | Token metadata reads and caching |
+| `@gibs/bridge-client/chain-read` | Allowance reads |
+| `@gibs/bridge-client/cache` | The `Cache` class |
+
+## License
+
+ISC

package/dist/chain-table.d.ts

@@ -0,0 +1,18 @@
+/** One chain, carrying only what this application reads. */
+export type ChainTableEntry = {
+    readonly id: number;
+    readonly name: string;
+    readonly nativeCurrency: {
+        readonly name: string;
+        readonly symbol: string;
+        readonly decimals: number;
+    };
+    readonly http: readonly string[];
+    readonly explorer: string | null;
+    /** Whether this is a test network, which a production build must not offer. */
+    readonly isTestnet: boolean;
+    /** The chain's Multicall3 deployment, or null where it has none. */
+    readonly multicall3: string | null;
+};
+/** Every supported chain, the bridge's own first. */
+export declare const chainTable: readonly ChainTableEntry[];

package/dist/chain-table.js

@@ -0,0 +1,89 @@
+// GENERATED by scripts/generate-chain-table.mjs — do not edit by hand.
+//
+// The Ethereum Virtual Machine chains LI.FI or Relay will quote, plus the
+// bridge's own, with the fields a public client needs. Regenerate when either
+// service adds a chain; the generator's own doc comment explains why this is a
+// table rather than viem imports.
+//
+// Chains those services list that viem does not ship, and which are therefore
+// absent here: 1672, 4663, 5042, 42018, 69000, 97477, 685689, 3586256, 5064014.
+// They have no endpoint to seed from, so naming them would produce a chain the
+// picker offers and no read can reach.
+/** Every supported chain, the bridge's own first. */
+export const chainTable = [
+    { id: 1, name: "Ethereum", nativeCurrency: { "name": "Ether", "symbol": "ETH", "decimals": 18 }, http: ["https://eth.merkle.io"], explorer: "https://etherscan.io", isTestnet: false, multicall3: "0xca11bde05977b3631167028862be2a173976ca11" },
+    { id: 369, name: "PulseChain", nativeCurrency: { "name": "Pulse", "symbol": "PLS", "decimals": 18 }, http: ["https://rpc.pulsechain.com"], explorer: "https://ipfs.scan.pulsechain.com", isTestnet: false, multicall3: "0xca11bde05977b3631167028862be2a173976ca11" },
+    { id: 11155111, name: "Sepolia", nativeCurrency: { "name": "Sepolia Ether", "symbol": "ETH", "decimals": 18 }, http: ["https://11155111.rpc.thirdweb.com"], explorer: "https://sepolia.etherscan.io", isTestnet: true, multicall3: "0xca11bde05977b3631167028862be2a173976ca11" },
+    { id: 943, name: "PulseChain V4", nativeCurrency: { "name": "V4 Pulse", "symbol": "v4PLS", "decimals": 18 }, http: ["https://rpc.v4.testnet.pulsechain.com"], explorer: "https://scan.v4.testnet.pulsechain.com", isTestnet: true, multicall3: "0xca11bde05977b3631167028862be2a173976ca11" },
+    { id: 56, name: "BNB Smart Chain", nativeCurrency: { "decimals": 18, "name": "BNB", "symbol": "BNB" }, http: ["https://56.rpc.thirdweb.com"], explorer: "https://bscscan.com", isTestnet: false, multicall3: "0xca11bde05977b3631167028862be2a173976ca11" },
+    { id: 42161, name: "Arbitrum One", nativeCurrency: { "name": "Ether", "symbol": "ETH", "decimals": 18 }, http: ["https://arb1.arbitrum.io/rpc"], explorer: "https://arbiscan.io", isTestnet: false, multicall3: "0xca11bde05977b3631167028862be2a173976ca11" },
+    { id: 8453, name: "Base", nativeCurrency: { "name": "Ether", "symbol": "ETH", "decimals": 18 }, http: ["https://mainnet-preconf.base.org"], explorer: "https://basescan.org", isTestnet: false, multicall3: "0xca11bde05977b3631167028862be2a173976ca11" },
+    { id: 81457, name: "Blast", nativeCurrency: { "decimals": 18, "name": "Ether", "symbol": "ETH" }, http: ["https://rpc.blast.io"], explorer: "https://blastscan.io", isTestnet: false, multicall3: "0xcA11bde05977b3631167028862bE2a173976CA11" },
+    { id: 43114, name: "Avalanche", nativeCurrency: { "decimals": 18, "name": "Avalanche", "symbol": "AVAX" }, http: ["https://api.avax.network/ext/bc/C/rpc"], explorer: "https://snowtrace.io", isTestnet: false, multicall3: "0xca11bde05977b3631167028862be2a173976ca11" },
+    { id: 137, name: "Polygon", nativeCurrency: { "name": "POL", "symbol": "POL", "decimals": 18 }, http: ["https://polygon.drpc.org"], explorer: "https://polygonscan.com", isTestnet: false, multicall3: "0xca11bde05977b3631167028862be2a173976ca11" },
+    { id: 534352, name: "Scroll", nativeCurrency: { "name": "Ether", "symbol": "ETH", "decimals": 18 }, http: ["https://rpc.scroll.io"], explorer: "https://scrollscan.com", isTestnet: false, multicall3: "0xca11bde05977b3631167028862be2a173976ca11" },
+    { id: 10, name: "OP Mainnet", nativeCurrency: { "name": "Ether", "symbol": "ETH", "decimals": 18 }, http: ["https://mainnet.optimism.io"], explorer: "https://optimistic.etherscan.io", isTestnet: false, multicall3: "0xca11bde05977b3631167028862be2a173976ca11" },
+    { id: 59144, name: "Linea Mainnet", nativeCurrency: { "name": "Linea Ether", "symbol": "ETH", "decimals": 18 }, http: ["https://rpc.linea.build"], explorer: "https://lineascan.build", isTestnet: false, multicall3: "0xcA11bde05977b3631167028862bE2a173976CA11" },
+    { id: 324, name: "ZKsync Era", nativeCurrency: { "decimals": 18, "name": "Ether", "symbol": "ETH" }, http: ["https://mainnet.era.zksync.io"], explorer: "https://explorer.zksync.io/", isTestnet: false, multicall3: "0xF9cda624FBC7e059355ce98a31693d299FACd963" },
+    { id: 100, name: "Gnosis", nativeCurrency: { "decimals": 18, "name": "xDAI", "symbol": "XDAI" }, http: ["https://rpc.gnosischain.com"], explorer: "https://gnosisscan.io", isTestnet: false, multicall3: "0xca11bde05977b3631167028862be2a173976ca11" },
+    { id: 122, name: "Fuse", nativeCurrency: { "name": "Fuse", "symbol": "FUSE", "decimals": 18 }, http: ["https://rpc.fuse.io"], explorer: "https://explorer.fuse.io", isTestnet: false, multicall3: "0xca11bde05977b3631167028862be2a173976ca11" },
+    { id: 288, name: "Boba Network", nativeCurrency: { "decimals": 18, "name": "Ether", "symbol": "ETH" }, http: ["https://mainnet.boba.network"], explorer: "https://bobascan.com", isTestnet: false, multicall3: "0xca11bde05977b3631167028862be2a173976ca11" },
+    { id: 130, name: "Unichain", nativeCurrency: { "name": "Ether", "symbol": "ETH", "decimals": 18 }, http: ["https://mainnet.unichain.org/"], explorer: "https://uniscan.xyz", isTestnet: false, multicall3: "0xca11bde05977b3631167028862be2a173976ca11" },
+    { id: 1329, name: "Sei Network", nativeCurrency: { "name": "Sei", "symbol": "SEI", "decimals": 18 }, http: ["https://evm-rpc.sei-apis.com/"], explorer: "https://seiscan.io", isTestnet: false, multicall3: "0xcA11bde05977b3631167028862bE2a173976CA11" },
+    { id: 13371, name: "Immutable zkEVM", nativeCurrency: { "decimals": 18, "name": "Immutable Coin", "symbol": "IMX" }, http: ["https://rpc.immutable.com"], explorer: "https://explorer.immutable.com", isTestnet: false, multicall3: "0x236bdA4589e44e6850f5aC6a74BfCa398a86c6c0" },
+    { id: 146, name: "Sonic", nativeCurrency: { "decimals": 18, "name": "Sonic", "symbol": "S" }, http: ["https://rpc.soniclabs.com"], explorer: "https://sonicscan.org", isTestnet: false, multicall3: "0xca11bde05977b3631167028862be2a173976ca11" },
+    { id: 1625, name: "Gravity Alpha Mainnet", nativeCurrency: { "name": "G", "symbol": "G", "decimals": 18 }, http: ["https://rpc.gravity.xyz"], explorer: "https://explorer.gravity.xyz", isTestnet: false, multicall3: "0xf8ac4BEB2F75d2cFFb588c63251347fdD629B92c" },
+    { id: 25, name: "Cronos Mainnet", nativeCurrency: { "decimals": 18, "name": "Cronos", "symbol": "CRO" }, http: ["https://evm.cronos.org"], explorer: "https://explorer.cronos.org", isTestnet: false, multicall3: "0xcA11bde05977b3631167028862bE2a173976CA11" },
+    { id: 252, name: "Fraxtal", nativeCurrency: { "name": "Frax", "symbol": "FRAX", "decimals": 18 }, http: ["https://rpc.frax.com"], explorer: "https://fraxscan.com", isTestnet: false, multicall3: "0xca11bde05977b3631167028862be2a173976ca11" },
+    { id: 2741, name: "Abstract", nativeCurrency: { "decimals": 18, "name": "ETH", "symbol": "ETH" }, http: ["https://api.mainnet.abs.xyz"], explorer: "https://abscan.org", isTestnet: false, multicall3: "0xAa4De41dba0Ca5dCBb288b7cC6b708F3aaC759E7" },
+    { id: 30, name: "Rootstock Mainnet", nativeCurrency: { "decimals": 18, "name": "Rootstock Bitcoin", "symbol": "RBTC" }, http: ["https://public-node.rsk.co"], explorer: "https://explorer.rsk.co", isTestnet: false, multicall3: "0xcA11bde05977b3631167028862bE2a173976CA11" },
+    { id: 42220, name: "Celo", nativeCurrency: { "decimals": 18, "name": "CELO", "symbol": "CELO" }, http: ["https://forno.celo.org"], explorer: "https://celoscan.io", isTestnet: false, multicall3: "0xcA11bde05977b3631167028862bE2a173976CA11" },
+    { id: 480, name: "World Chain", nativeCurrency: { "name": "Ether", "symbol": "ETH", "decimals": 18 }, http: ["https://worldchain-mainnet.g.alchemy.com/public"], explorer: "https://worldscan.org", isTestnet: false, multicall3: "0xca11bde05977b3631167028862be2a173976ca11" },
+    { id: 5000, name: "Mantle", nativeCurrency: { "decimals": 18, "name": "MNT", "symbol": "MNT" }, http: ["https://rpc.mantle.xyz"], explorer: "https://mantlescan.xyz/", isTestnet: false, multicall3: "0xcA11bde05977b3631167028862bE2a173976CA11" },
+    { id: 80094, name: "Berachain", nativeCurrency: { "decimals": 18, "name": "BERA Token", "symbol": "BERA" }, http: ["https://rpc.berachain.com"], explorer: "https://berascan.com", isTestnet: false, multicall3: "0xcA11bde05977b3631167028862bE2a173976CA11" },
+    { id: 14, name: "Flare Mainnet", nativeCurrency: { "decimals": 18, "name": "Flare", "symbol": "FLR" }, http: ["https://flare-api.flare.network/ext/C/rpc"], explorer: "https://flare-explorer.flare.network", isTestnet: false, multicall3: "0xcA11bde05977b3631167028862bE2a173976CA11" },
+    { id: 40, name: "Telos", nativeCurrency: { "decimals": 18, "name": "Telos", "symbol": "TLOS" }, http: ["https://rpc.telos.net"], explorer: "https://www.teloscan.io/", isTestnet: false, multicall3: "0xcA11bde05977b3631167028862bE2a173976CA11" },
+    { id: 50, name: "XDC Network", nativeCurrency: { "decimals": 18, "name": "XDC", "symbol": "XDC" }, http: ["https://rpc.xdcrpc.com"], explorer: "https://xdcscan.com", isTestnet: false, multicall3: "0x0B1795ccA8E4eC4df02346a082df54D437F8D9aF" },
+    { id: 88, name: "Viction", nativeCurrency: { "name": "Viction", "symbol": "VIC", "decimals": 18 }, http: ["https://rpc.viction.xyz"], explorer: "https://vicscan.xyz", isTestnet: false, multicall3: null },
+    { id: 143, name: "Monad", nativeCurrency: { "name": "Monad", "symbol": "MON", "decimals": 18 }, http: ["https://rpc.monad.xyz", "https://rpc1.monad.xyz"], explorer: "https://monadvision.com", isTestnet: false, multicall3: "0xcA11bde05977b3631167028862bE2a173976CA11" },
+    { id: 169, name: "Manta Pacific Mainnet", nativeCurrency: { "decimals": 18, "name": "ETH", "symbol": "ETH" }, http: ["https://pacific-rpc.manta.network/http"], explorer: "https://pacific-explorer.manta.network", isTestnet: false, multicall3: "0xcA11bde05977b3631167028862bE2a173976CA11" },
+    { id: 196, name: "X Layer Mainnet", nativeCurrency: { "decimals": 18, "name": "OKB", "symbol": "OKB" }, http: ["https://rpc.xlayer.tech"], explorer: "https://www.oklink.com/xlayer", isTestnet: false, multicall3: "0xcA11bde05977b3631167028862bE2a173976CA11" },
+    { id: 204, name: "opBNB", nativeCurrency: { "name": "BNB", "symbol": "BNB", "decimals": 18 }, http: ["https://opbnb-mainnet-rpc.bnbchain.org"], explorer: "https://opbnb.bscscan.com", isTestnet: false, multicall3: "0xcA11bde05977b3631167028862bE2a173976CA11" },
+    { id: 232, name: "Lens", nativeCurrency: { "name": "GHO", "symbol": "GHO", "decimals": 18 }, http: ["https://rpc.lens.xyz"], explorer: "https://explorer.lens.xyz", isTestnet: false, multicall3: null },
+    { id: 360, name: "Shape", nativeCurrency: { "name": "Ether", "symbol": "ETH", "decimals": 18 }, http: ["https://mainnet.shape.network"], explorer: "https://shapescan.xyz", isTestnet: false, multicall3: "0xca11bde05977b3631167028862be2a173976ca11" },
+    { id: 747, name: "Flow EVM Mainnet", nativeCurrency: { "decimals": 18, "name": "Flow", "symbol": "FLOW" }, http: ["https://mainnet.evm.nodes.onflow.org"], explorer: "https://evm.flowscan.io", isTestnet: false, multicall3: "0xca11bde05977b3631167028862be2a173976ca11" },
+    { id: 988, name: "Stable Mainnet", nativeCurrency: { "name": "USDT0", "symbol": "USDT0", "decimals": 18 }, http: ["https://rpc.stable.xyz"], explorer: "https://stablescan.xyz", isTestnet: false, multicall3: "0xcA11bde05977b3631167028862bE2a173976CA11" },
+    { id: 999, name: "Zora Goerli Testnet", nativeCurrency: { "decimals": 18, "name": "Zora Goerli", "symbol": "ETH" }, http: ["https://testnet.rpc.zora.energy"], explorer: "https://testnet.explorer.zora.energy", isTestnet: true, multicall3: "0xcA11bde05977b3631167028862bE2a173976CA11" },
+    { id: 1088, name: "Metis", nativeCurrency: { "decimals": 18, "name": "Metis", "symbol": "METIS" }, http: ["https://metis.rpc.hypersync.xyz", "https://metis-pokt.nodies.app", "https://api.blockeden.xyz/metis/67nCBdZQSH9z3YqDDjdm", "https://metis-andromeda.rpc.thirdweb.com", "https://metis-andromeda.gateway.tenderly.co", "https://metis.api.onfinality.io/public", "https://andromeda.metis.io/?owner=1088", "https://metis-mainnet.public.blastapi.io"], explorer: "https://explorer.metis.io", isTestnet: false, multicall3: "0xca11bde05977b3631167028862be2a173976ca11" },
+    { id: 1135, name: "Lisk", nativeCurrency: { "decimals": 18, "name": "Ether", "symbol": "ETH" }, http: ["https://rpc.api.lisk.com"], explorer: "https://blockscout.lisk.com", isTestnet: false, multicall3: "0xA9d71E1dd7ca26F26e656E66d6AA81ed7f745bf0" },
+    { id: 1337, name: "Tempo", nativeCurrency: { "name": "USD", "symbol": "USD", "decimals": 6 }, http: ["http://localhost:8545"], explorer: null, isTestnet: false, multicall3: null },
+    { id: 1480, name: "Vana", nativeCurrency: { "decimals": 18, "name": "Vana", "symbol": "VANA" }, http: ["https://rpc.vana.org/"], explorer: "https://vanascan.io", isTestnet: false, multicall3: "0xD8d2dFca27E8797fd779F8547166A2d3B29d360E" },
+    { id: 1776, name: "Injective", nativeCurrency: { "decimals": 18, "name": "Injective", "symbol": "INJ" }, http: ["https://sentry.evm-rpc.injective.network"], explorer: "https://blockscout.injective.network", isTestnet: false, multicall3: null },
+    { id: 1868, name: "Soneium Mainnet", nativeCurrency: { "name": "Ether", "symbol": "ETH", "decimals": 18 }, http: ["https://rpc.soneium.org"], explorer: "https://soneium.blockscout.com", isTestnet: false, multicall3: "0xcA11bde05977b3631167028862bE2a173976CA11" },
+    { id: 2020, name: "Ronin", nativeCurrency: { "name": "RON", "symbol": "RON", "decimals": 18 }, http: ["https://api.roninchain.com/rpc"], explorer: "https://app.roninchain.com", isTestnet: false, multicall3: "0xca11bde05977b3631167028862be2a173976ca11" },
+    { id: 2818, name: "Morph", nativeCurrency: { "decimals": 18, "name": "Ether", "symbol": "ETH" }, http: ["https://rpc.morphl2.io"], explorer: "https://explorer.morphl2.io", isTestnet: false, multicall3: "0xcA11bde05977b3631167028862bE2a173976CA11" },
+    { id: 4217, name: "Tempo Mainnet", nativeCurrency: { "name": "USD", "symbol": "USD", "decimals": 6 }, http: ["https://rpc.presto.tempo.xyz"], explorer: "https://explore.mainnet.tempo.xyz", isTestnet: false, multicall3: null },
+    { id: 4326, name: "MegaETH", nativeCurrency: { "name": "Ether", "symbol": "ETH", "decimals": 18 }, http: ["https://mainnet.megaeth.com/rpc"], explorer: "https://mega.etherscan.io", isTestnet: false, multicall3: "0xcA11bde05977b3631167028862bE2a173976CA11" },
+    { id: 5031, name: "Somnia", nativeCurrency: { "name": "Somnia", "symbol": "SOMI", "decimals": 18 }, http: ["https://api.infra.mainnet.somnia.network"], explorer: "https://explorer.somnia.network", isTestnet: false, multicall3: null },
+    { id: 5330, name: "Superseed", nativeCurrency: { "name": "Ether", "symbol": "ETH", "decimals": 18 }, http: ["https://mainnet.superseed.xyz"], explorer: "https://explorer.superseed.xyz", isTestnet: false, multicall3: "0xcA11bde05977b3631167028862bE2a173976CA11" },
+    { id: 8217, name: "Klaytn", nativeCurrency: { "decimals": 18, "name": "Klaytn", "symbol": "KLAY" }, http: ["https://public-en-cypress.klaytn.net"], explorer: "https://scope.klaytn.com", isTestnet: false, multicall3: "0xcA11bde05977b3631167028862bE2a173976CA11" },
+    { id: 8333, name: "B3", nativeCurrency: { "name": "Ether", "symbol": "ETH", "decimals": 18 }, http: ["https://mainnet-rpc.b3.fun/http"], explorer: "https://explorer.b3.fun", isTestnet: false, multicall3: "0xca11bde05977b3631167028862be2a173976ca11" },
+    { id: 9745, name: "Plasma", nativeCurrency: { "name": "Plasma", "symbol": "XPL", "decimals": 18 }, http: ["https://rpc.plasma.to"], explorer: "https://plasmascan.to", isTestnet: false, multicall3: "0xcA11bde05977b3631167028862bE2a173976CA11" },
+    { id: 16661, name: "0G Mainnet", nativeCurrency: { "name": "0G", "symbol": "0G", "decimals": 18 }, http: ["https://evmrpc.0g.ai"], explorer: "https://chainscan.0g.ai", isTestnet: false, multicall3: null },
+    { id: 33139, name: "ApeChain", nativeCurrency: { "name": "ApeCoin", "symbol": "APE", "decimals": 18 }, http: ["https://rpc.apechain.com/http"], explorer: "https://apescan.io", isTestnet: false, multicall3: "0xcA11bde05977b3631167028862bE2a173976CA11" },
+    { id: 34443, name: "Mode Mainnet", nativeCurrency: { "name": "Ether", "symbol": "ETH", "decimals": 18 }, http: ["https://mainnet.mode.network"], explorer: "https://modescan.io", isTestnet: false, multicall3: "0xca11bde05977b3631167028862be2a173976ca11" },
+    { id: 42170, name: "Arbitrum Nova", nativeCurrency: { "name": "Ether", "symbol": "ETH", "decimals": 18 }, http: ["https://nova.arbitrum.io/rpc"], explorer: "https://nova.arbiscan.io", isTestnet: false, multicall3: "0xca11bde05977b3631167028862be2a173976ca11" },
+    { id: 42793, name: "Etherlink", nativeCurrency: { "decimals": 18, "name": "Tez", "symbol": "XTZ" }, http: ["https://node.mainnet.etherlink.com"], explorer: "https://explorer.etherlink.com", isTestnet: false, multicall3: "0xcA11bde05977b3631167028862bE2a173976CA11" },
+    { id: 43111, name: "Hemi", nativeCurrency: { "name": "Ether", "symbol": "ETH", "decimals": 18 }, http: ["https://rpc.hemi.network/rpc"], explorer: "https://explorer.hemi.xyz", isTestnet: false, multicall3: null },
+    { id: 43419, name: "Gunz Mainnet", nativeCurrency: { "name": "GUN", "symbol": "GUN", "decimals": 18 }, http: ["https://rpc.gunzchain.io/ext/bc/2M47TxWHGnhNtq6pM5zPXdATBtuqubxn5EPFgFmEawCQr9WFML/rpc"], explorer: "https://gunzscan.io/", isTestnet: false, multicall3: "0xcA11bde05977b3631167028862bE2a173976CA11" },
+    { id: 48900, name: "Zircuit Mainnet", nativeCurrency: { "decimals": 18, "name": "Ether", "symbol": "ETH" }, http: ["https://mainnet.zircuit.com", "https://zircuit1-mainnet.liquify.com", "https://zircuit1-mainnet.p2pify.com", "https://zircuit-mainnet.drpc.org"], explorer: "https://explorer.zircuit.com", isTestnet: false, multicall3: "0xcA11bde05977b3631167028862bE2a173976CA11" },
+    { id: 57073, name: "Ink", nativeCurrency: { "name": "Ether", "symbol": "ETH", "decimals": 18 }, http: ["https://rpc-gel.inkonchain.com", "https://rpc-qnd.inkonchain.com"], explorer: "https://explorer.inkonchain.com", isTestnet: false, multicall3: "0xcA11bde05977b3631167028862bE2a173976CA11" },
+    { id: 60808, name: "BOB", nativeCurrency: { "decimals": 18, "name": "ETH", "symbol": "ETH" }, http: ["https://rpc.gobob.xyz"], explorer: "https://explorer.gobob.xyz", isTestnet: false, multicall3: "0xcA11bde05977b3631167028862bE2a173976CA11" },
+    { id: 84532, name: "Base Sepolia", nativeCurrency: { "name": "Sepolia Ether", "symbol": "ETH", "decimals": 18 }, http: ["https://sepolia-preconf.base.org"], explorer: "https://sepolia.basescan.org", isTestnet: true, multicall3: "0xca11bde05977b3631167028862be2a173976ca11" },
+    { id: 98866, name: "Plume", nativeCurrency: { "name": "Plume", "symbol": "PLUME", "decimals": 18 }, http: ["https://rpc.plume.org"], explorer: "https://explorer.plume.org", isTestnet: false, multicall3: "0xcA11bde05977b3631167028862bE2a173976CA11" },
+    { id: 421614, name: "Arbitrum Sepolia", nativeCurrency: { "name": "Arbitrum Sepolia Ether", "symbol": "ETH", "decimals": 18 }, http: ["https://sepolia-rollup.arbitrum.io/rpc"], explorer: "https://sepolia.arbiscan.io", isTestnet: true, multicall3: "0xca11bde05977b3631167028862be2a173976ca11" },
+    { id: 747474, name: "Katana", nativeCurrency: { "name": "Ether", "symbol": "ETH", "decimals": 18 }, http: ["https://rpc.katana.network"], explorer: "https://katanascan.com", isTestnet: false, multicall3: null },
+    { id: 5042002, name: "Arc Testnet", nativeCurrency: { "name": "USDC", "symbol": "USDC", "decimals": 18 }, http: ["https://rpc.testnet.arc.network", "https://rpc.quicknode.testnet.arc.network", "https://rpc.blockdaemon.testnet.arc.network"], explorer: "https://testnet.arcscan.app", isTestnet: true, multicall3: "0xcA11bde05977b3631167028862bE2a173976CA11" },
+    { id: 7777777, name: "Zora", nativeCurrency: { "decimals": 18, "name": "Ether", "symbol": "ETH" }, http: ["https://rpc.zora.energy"], explorer: "https://explorer.zora.energy", isTestnet: false, multicall3: "0xcA11bde05977b3631167028862bE2a173976CA11" },
+    { id: 11155420, name: "OP Sepolia", nativeCurrency: { "name": "Sepolia Ether", "symbol": "ETH", "decimals": 18 }, http: ["https://sepolia.optimism.io"], explorer: "https://optimism-sepolia.blockscout.com", isTestnet: true, multicall3: "0xca11bde05977b3631167028862be2a173976ca11" },
+];

package/dist/client.d.ts

@@ -1,13 +1,19 @@
-import type { PublicClient } from 'viem';
+import type { HttpTransportConfig, PublicClient } from 'viem';
 /**
- * The request-batching setting for a chain's client: `false` to disable batching
- * for chains that reject batch bodies (see {@link chainsWithoutRpcBatching}), or
- * `undefined` to use the transport's default batching.
+ * The request-batching setting for a chain's client.
+ *
+ * `false` for chains whose nodes reject a batch body at all (see
+ * {@link chainsWithoutRpcBatching}). Otherwise batching stays on, capped at
+ * {@link MAX_SAME_METHOD_CALLS_PER_SECOND} so no single post can exceed the
+ * proxy's per-method budget on its own and lose every call in it.
+ *
+ * The `wait` of ten milliseconds is viem's own default, restated here because
+ * naming `batchSize` alone would otherwise drop it.
  *
  * @param chainId - the chain to resolve the batch setting for
- * @returns `false` when batching must be disabled, otherwise `undefined`
+ * @returns `false` when batching must be disabled, otherwise the batch config
  */
-export declare const rpcBatchSetting: (chainId: number) => false | undefined;
+export declare const rpcBatchSetting: (chainId: number) => HttpTransportConfig["batch"];
 /**
  * Returns a viem {@link PublicClient} for a chain, reusing the cached instance
  * while the chain's endpoint list is unchanged. The cache key is derived from the

package/dist/client.js

@@ -1,4 +1,6 @@
-import { chainKey, clientCache, clientFromChain as buildClient } from '@gibs/common/client';
+import { chainsMetadata } from '@gibs/bridge-sdk/chains';
+import { toChain } from '@gibs/bridge-sdk/config';
+import { chainKey, clientCache, clientFromChain as buildClient, MAX_SAME_METHOD_CALLS_PER_SECOND, } from '@gibs/common/client';
 import * as _ from 'lodash-es';
 import { bsc } from 'viem/chains';
 import * as endpoints from './endpoints.js';
@@ -13,14 +15,22 @@ import { evmChainsById } from './networks.js';
  */
 const chainsWithoutRpcBatching = new Set([bsc.id]);
 /**
- * The request-batching setting for a chain's client: `false` to disable batching
- * for chains that reject batch bodies (see {@link chainsWithoutRpcBatching}), or
- * `undefined` to use the transport's default batching.
+ * The request-batching setting for a chain's client.
+ *
+ * `false` for chains whose nodes reject a batch body at all (see
+ * {@link chainsWithoutRpcBatching}). Otherwise batching stays on, capped at
+ * {@link MAX_SAME_METHOD_CALLS_PER_SECOND} so no single post can exceed the
+ * proxy's per-method budget on its own and lose every call in it.
+ *
+ * The `wait` of ten milliseconds is viem's own default, restated here because
+ * naming `batchSize` alone would otherwise drop it.
  *
  * @param chainId - the chain to resolve the batch setting for
- * @returns `false` when batching must be disabled, otherwise `undefined`
+ * @returns `false` when batching must be disabled, otherwise the batch config
  */
-export const rpcBatchSetting = (chainId) => chainsWithoutRpcBatching.has(chainId) ? false : undefined;
+export const rpcBatchSetting = (chainId) => chainsWithoutRpcBatching.has(chainId)
+    ? false
+    : { batchSize: MAX_SAME_METHOD_CALLS_PER_SECOND, wait: 10 };
 /**
  * A chain's own default endpoints, used when the editable table has no entry.
  *
@@ -31,6 +41,23 @@ const defaultUrlsFor = (chainId) => {
     if (!chainId) {
         throw new Error('chainId is required');
     }
+    // The APPLICATION's metadata first, viem's chain object only for the chains it
+    // does not override.
+    //
+    // These are two different answers to the same question, and reading only the
+    // second is why demoting a rate-limited Sepolia endpoint in `chainsMetadata`
+    // changed nothing: the seed built from that map, while THIS function — which
+    // decides what a client actually talks to when the stored table is empty —
+    // returned viem's own default and went on hitting the demoted host first.
+    //
+    // The bridge chains are overridden precisely because viem's defaults are not
+    // the ones this application wants; the wider list (Arbitrum, Base, and the
+    // rest) has no override and correctly falls through.
+    const overridden = chainsMetadata[toChain(chainId)];
+    const overriddenHttp = overridden?.rpcUrls?.default?.http;
+    if (overriddenHttp?.length) {
+        return [...overriddenHttp];
+    }
     const chain = evmChainsById.get(chainId);
     if (!chain) {
         return [];

package/dist/endpoints.d.ts

@@ -31,7 +31,13 @@ export type EndpointStorage = {
  * rename silently reverts every one of them to the defaults on the next load.
  */
 export declare const ENDPOINTS_STORAGE_KEY = "rpcs";
-/** The bridge's production chains. */
+/**
+ * Every chain the application can reach, the bridge's own first.
+ *
+ * The bridge's three keep taking their urls from `chainsMetadata`, which is
+ * where the product's own node choices live and which must win over viem's
+ * generic default for them.
+ */
 export declare const productionSeed: EndpointEntry[];
 /** The bridge's test chains, for a build that is not production. */
 export declare const testnetSeed: EndpointEntry[];

package/dist/endpoints.js

@@ -1,5 +1,6 @@
 import { chainsMetadata } from '@gibs/bridge-sdk/chains';
 import { Chains, toChain } from '@gibs/bridge-sdk/config';
+import { chainTable } from './chain-table.js';
 import * as _ from 'lodash-es';
 /**
  * The storage key holding the endpoint table.
@@ -8,10 +9,53 @@ import * as _ from 'lodash-es';
  * rename silently reverts every one of them to the defaults on the next load.
  */
 export const ENDPOINTS_STORAGE_KEY = 'rpcs';
-/** Builds a seed table from the bridge metadata for the given chains. */
+/**
+ * EVERY SUPPORTED CHAIN GETS AN ENTRY, and the entry comes from viem.
+ *
+ * This used to seed three chains — PulseChain, Ethereum and Binance Smart Chain
+ * — while the aggregators quote routes from seventy-odd. A chain absent from
+ * this table is not refused; `clientFromChain` falls through to viem's own
+ * public nodes for it. So every read on an aggregator origin went to a node
+ * nobody chose, which is where the rate limiting came from, and the endpoint
+ * editor could not show the chain at all: a reader whose Base node was throttled
+ * had no way to replace it, because Base was not in the list they were editing.
+ *
+ * Seeding from `chainTable` fixes both at once. The urls are viem's own
+ * defaults, which is what the three seeded chains always used — the change is
+ * the breadth, not the source.
+ */
 const seedFor = (chains) => chains.map((chain) => [Number(chain), [...chainsMetadata[chain].rpcUrls.default.http]]);
-/** The bridge's production chains. */
-export const productionSeed = seedFor([Chains.PLS, Chains.ETH, Chains.BNB]);
+/** The bridge's own chains, kept first so a picker built from this reads well. */
+const BRIDGE_CHAIN_IDS = [
+    Number(Chains.PLS),
+    Number(Chains.ETH),
+    Number(Chains.BNB),
+];
+/**
+ * Every chain the application can reach, the bridge's own first.
+ *
+ * The bridge's three keep taking their urls from `chainsMetadata`, which is
+ * where the product's own node choices live and which must win over viem's
+ * generic default for them.
+ */
+export const productionSeed = [
+    ...seedFor([Chains.PLS, Chains.ETH, Chains.BNB]),
+    ...chainTable
+        .filter((entry) => 
+    // The bridge's own three are seeded above, from `chainsMetadata`, and
+    // must not be seeded twice. That map is where the product's node
+    // choices live — demoting a rate-limited host there has to take effect,
+    // and a table entry added after it would silently win.
+    !BRIDGE_CHAIN_IDS.includes(entry.id) &&
+        // A PRODUCTION BUILD PROMISES NOT TO OFFER A TEST NETWORK, and the
+        // endpoint table is one of the places that promise can be broken: the
+        // chains seeded here are the chains the endpoint editor lists. The
+        // table carries test networks deliberately, because a client still has
+        // to be buildable for them on a testnet build; this is where they are
+        // held back.
+        !entry.isTestnet)
+        .map((entry) => [entry.id, [...entry.http]]),
+];
 /** The bridge's test chains, for a build that is not production. */
 export const testnetSeed = seedFor([Chains.V4PLS, Chains.SEP]);
 /** The seed the next load starts from. */

package/dist/image.d.ts

@@ -1,14 +1,16 @@
 /**
  * Chain-logo resolution, in one place.
  *
- * Two image services are involved and neither covers every chain a route can
- * start from, which is why this is a module rather than an inline template
- * string: gib.show keys on real chain ids, while the non-Ethereum origins reach
- * us under Relay's own pseudo identifiers (Solana, Bitcoin, Tron, The Open
- * Network, Eclipse). Asking gib.show for one of those returns a 404, and a 404
- * in an `<img src>` is drawn by the browser as a broken-image glyph — so the
- * mistake surfaces as a visual blemish on the token pill rather than as an
- * error anyone would go looking for.
+ * gib.show serves almost every chain a route can start from — including the
+ * non-Ethereum ones — but it keys them by a CAIP-2 style identifier rather than
+ * by Relay's invented decimal ids, so the two have to be mapped. Only Eclipse
+ * and Hyperliquid are genuinely absent from it, and those alone fall back to
+ * Relay's own icon service.
+ *
+ * This is a module rather than an inline template string because getting the
+ * key wrong is invisible: a 404 in an `<img src>` is drawn by the browser as a
+ * broken-image glyph, so the mistake surfaces as a blemish on a token pill
+ * rather than as an error anyone would go looking for.
  */
 /**
  * Relay's public chain-icon service, keyed on Relay's own chain identifiers —
@@ -16,31 +18,51 @@
  *
  * The `light` variant is the full-colour brand mark (the pair is light/dark
  * BACKGROUND, not a monochrome inversion), so one variant serves both of our
- * themes. Not every id is populated — The Open Network currently answers 403 —
- * which is why callers must tolerate a badge that fails to load.
+ * themes. Not every id is populated — The Open Network answers 403, which is
+ * what the bundled asset used to exist for — so callers must still tolerate a
+ * badge that fails to load. Only Eclipse and Hyperliquid reach this now.
  *
  * @param chainId - a Relay chain identifier
  * @returns the icon url
  */
 export declare const relayChainIconUrl: (chainId: number) => string;
 /**
- * Resolves the logo url for a chain, choosing the service that can actually
- * serve it.
+ * Resolves the logo url for a chain, choosing the service that can serve it.
  *
- * A chain we bundle the mark for wins outright ({@link bundledChainLogoUri}).
- * Otherwise Ethereum-Virtual-Machine chains go to gib.show, honouring the
- * configured image root (so a self-hosted deployment is respected) rather than
- * hard-coding the public host, and everything else is a Relay identifier and
- * goes to Relay.
+ * A chain gib.show knows under its own identifier wins outright
+ * ({@link gibShowChainIdentifier}). Otherwise an Ethereum-Virtual-Machine chain
+ * goes to gib.show by number, honouring the configured image root so a
+ * self-hosted deployment is respected rather than hard-coding the public host.
+ * What remains is Eclipse and Hyperliquid, which gib.show does not carry, and
+ * they go to Relay.
  *
  * @param chainId - the decimal chain id, Relay's pseudo identifiers included
  * @param displayPx - the CSS pixel size the logo renders at; when supplied,
  *   gib.show is asked for twice that in webp per its retina guidance. Ignored
- *   for a Relay-served icon and for a bundled asset, neither of which takes
- *   sizing parameters.
+ *   for a Relay-served icon and for an identifier-keyed mark, neither of which
+ *   takes sizing parameters.
  * @returns an image url for the chain
  */
 export declare const chainLogoUrl: ({ chainId, displayPx, }: {
     chainId: number;
     displayPx?: number;
 }) => string;
+/**
+ * The gib.show sources for a chain's NATIVE COIN, best first.
+ *
+ * The service serves the first source that resolves: the coin as this chain
+ * keys it, then the coin as its home chain keys it, then the chain's own mark.
+ * The last is an honest fallback rather than a mistake — for a chain's own coin
+ * the two marks are the same picture.
+ *
+ * @param chainId - the chain the coin is being shown on
+ * @returns the ordered source list, for {@link imageLinks.images}
+ */
+export declare const nativeCoinImageSources: (chainId: number) => string[];
+/**
+ * Resolves the picture of a chain's native coin, as opposed to of the chain.
+ *
+ * @param chainId - the chain the coin is being shown on
+ * @returns an image url
+ */
+export declare const nativeCoinLogoUrl: (chainId: number) => string;

package/dist/image.js

@@ -1,16 +1,20 @@
 import * as imageLinks from '@gibs/bridge-sdk/image-links';
 import { ecosystemByChainId, relayChainIds } from '@gibs/bridge-sdk/relay-quote';
+import { zeroAddress } from 'viem';
+import { chainTable } from './chain-table.js';
 /**
  * Chain-logo resolution, in one place.
  *
- * Two image services are involved and neither covers every chain a route can
- * start from, which is why this is a module rather than an inline template
- * string: gib.show keys on real chain ids, while the non-Ethereum origins reach
- * us under Relay's own pseudo identifiers (Solana, Bitcoin, Tron, The Open
- * Network, Eclipse). Asking gib.show for one of those returns a 404, and a 404
- * in an `<img src>` is drawn by the browser as a broken-image glyph — so the
- * mistake surfaces as a visual blemish on the token pill rather than as an
- * error anyone would go looking for.
+ * gib.show serves almost every chain a route can start from — including the
+ * non-Ethereum ones — but it keys them by a CAIP-2 style identifier rather than
+ * by Relay's invented decimal ids, so the two have to be mapped. Only Eclipse
+ * and Hyperliquid are genuinely absent from it, and those alone fall back to
+ * Relay's own icon service.
+ *
+ * This is a module rather than an inline template string because getting the
+ * key wrong is invisible: a 404 in an `<img src>` is drawn by the browser as a
+ * broken-image glyph, so the mistake surfaces as a blemish on a token pill
+ * rather than as an error anyone would go looking for.
  */
 /**
  * Relay's public chain-icon service, keyed on Relay's own chain identifiers —
@@ -18,59 +22,73 @@ import { ecosystemByChainId, relayChainIds } from '@gibs/bridge-sdk/relay-quote'
  *
  * The `light` variant is the full-colour brand mark (the pair is light/dark
  * BACKGROUND, not a monochrome inversion), so one variant serves both of our
- * themes. Not every id is populated — The Open Network currently answers 403 —
- * which is why callers must tolerate a badge that fails to load.
+ * themes. Not every id is populated — The Open Network answers 403, which is
+ * what the bundled asset used to exist for — so callers must still tolerate a
+ * badge that fails to load. Only Eclipse and Hyperliquid reach this now.
  *
  * @param chainId - a Relay chain identifier
  * @returns the icon url
  */
 export const relayChainIconUrl = (chainId) => `https://assets.relay.link/icons/${chainId}/light.png`;
 /**
- * Chains we ship the mark for ourselves, because neither service will serve it.
- *
- * The Open Network is the only entry today: gib.show does not know Relay's
- * pseudo id, and Relay's own service answers 403 for it — the one chain its
- * authority does not actually cover. Between the two, the badge had no source at
- * all and rendered as nothing via the hide-on-error path, which reads as a
- * missing chain rather than a missing image.
- *
- * The paths are RELATIVE (no leading slash): the reference deployment publishes
- * to the InterPlanetary File System, where a leading slash resolves against the
- * gateway root instead of the deployed directory.
- *
- * A CONSUMER CONTRACT: this package names the asset but cannot ship it. An
- * application using these urls must serve a file at each path from its own
- * static root, or the badge silently renders as nothing. The application-side
- * check is `ui/src/lib/tokens/bundledChainLogo.test.ts`.
- *
- * This is checked BEFORE either service, so an entry here is the last word — the
- * point is to stop depending on a service that has already been observed to fail
- * for the chain.
+ * gib.show's own key for a chain that Relay reaches us under a pseudo id.
+ *
+ * THE SERVICE WAS NEVER MISSING THESE CHAINS — WE WERE ASKING BY THE WRONG KEY.
+ * gib.show keys every chain by a CAIP-2 style identifier: `eip155-1`,
+ * `solana-501`, `bip122-0`. Relay invented its own decimal ids for the
+ * non-Ethereum origins (Solana is 792703809, Bitcoin 8253038), and asking
+ * gib.show for one of those 404s — which read as "gib.show does not serve
+ * Solana" and sent every non-Ethereum badge to a second service. It serves them
+ * all, under its own key.
+ *
+ * Each entry below was verified twice: the url returns 200 with a real PNG, and
+ * the picture was LOOKED AT and is the chain's genuine mark. A 200 alone proves
+ * nothing here — `/image/999` returns 200 and hands back a completely different
+ * chain's logo, which is why an identifier is only listed once someone has seen
+ * what comes back.
+ *
+ * ECLIPSE AND HYPERLIQUID ARE ABSENT ON PURPOSE. Neither appears anywhere in
+ * gib.show's network list under any key, so they keep Relay's service. Guessing
+ * a plausible identifier for them would be worse than falling back: Hyperliquid
+ * in particular collides with an unrelated chain at id 999, so a guess renders
+ * the wrong company's logo rather than none at all.
+ *
+ * The pay-by-hand chains (Zcash and, later, its siblings) are NOT listed by
+ * hand here. `bridge-sdk`'s `image-links.ts` is the one place that key is
+ * declared — see its `pseudoChainGibShowIdentifier` — and this table spreads
+ * that map in, so a pay-by-hand chain added there needs no matching edit here.
  */
-const bundledChainLogoUri = {
-    [relayChainIds.ton]: 'images/networks/ton.png',
+const gibShowChainIdentifier = {
+    [relayChainIds.solana]: 'solana-501',
+    [relayChainIds.bitcoin]: 'bip122-0',
+    [relayChainIds.tron]: 'tvm-195',
+    [relayChainIds.ton]: 'ton-607',
+    ...imageLinks.pseudoChainGibShowIdentifier,
 };
 /**
- * Resolves the logo url for a chain, choosing the service that can actually
- * serve it.
+ * Resolves the logo url for a chain, choosing the service that can serve it.
  *
- * A chain we bundle the mark for wins outright ({@link bundledChainLogoUri}).
- * Otherwise Ethereum-Virtual-Machine chains go to gib.show, honouring the
- * configured image root (so a self-hosted deployment is respected) rather than
- * hard-coding the public host, and everything else is a Relay identifier and
- * goes to Relay.
+ * A chain gib.show knows under its own identifier wins outright
+ * ({@link gibShowChainIdentifier}). Otherwise an Ethereum-Virtual-Machine chain
+ * goes to gib.show by number, honouring the configured image root so a
+ * self-hosted deployment is respected rather than hard-coding the public host.
+ * What remains is Eclipse and Hyperliquid, which gib.show does not carry, and
+ * they go to Relay.
  *
  * @param chainId - the decimal chain id, Relay's pseudo identifiers included
  * @param displayPx - the CSS pixel size the logo renders at; when supplied,
  *   gib.show is asked for twice that in webp per its retina guidance. Ignored
- *   for a Relay-served icon and for a bundled asset, neither of which takes
- *   sizing parameters.
+ *   for a Relay-served icon and for an identifier-keyed mark, neither of which
+ *   takes sizing parameters.
  * @returns an image url for the chain
  */
 export const chainLogoUrl = ({ chainId, displayPx, }) => {
-    const bundled = bundledChainLogoUri[chainId];
-    if (bundled !== undefined) {
-        return bundled;
+    const identifier = gibShowChainIdentifier[chainId];
+    if (identifier !== undefined) {
+        // gib.show serves this chain, just not under Relay's number. No sizing
+        // parameters: these are fixed-size marks rather than the resizable images
+        // the numeric endpoint serves.
+        return `${imageLinks.getImageRoot()}/image/${identifier}`;
     }
     if (ecosystemByChainId(chainId) !== 'evm') {
         return relayChainIconUrl(chainId);
@@ -81,3 +99,58 @@ export const chainLogoUrl = ({ chainId, displayPx, }) => {
     }
     return `${base}?w=${displayPx * 2}&h=${displayPx * 2}&format=webp`;
 };
+/**
+ * The chain a native coin actually belongs to, found by its symbol.
+ *
+ * WHY THIS IS NEEDED. gib.show serves a coin's own picture under
+ * `<chain>/<zero address>`, and it carries that picture only for the chain the
+ * coin is native to — not for every chain the coin has been bridged onto. Ether
+ * on Base is the case that exposed it: `8453/<zero address>` is a 404, so the
+ * lookup fell through to the chain mark and drew Base's blue disc where the
+ * ether diamond belongs. The same picture is one source away under `1/<zero
+ * address>`, and gib.show's multi-source lookup will cross chains to reach it.
+ *
+ * READ FROM THE TABLE, NOT FROM A LIST WRITTEN HERE. The generated chain table
+ * orders the bridge's own chains first and the rest in the order the product
+ * chose, so the EARLIEST entry carrying a symbol is the chain that coin came
+ * from: ether resolves to Ethereum ahead of the dozen chains that also call
+ * their coin ETH, and the mapping stays right as the table grows. The table is
+ * reversed before the map is built because a later `set` wins — reversing makes
+ * the earliest entry the last one written.
+ *
+ * A coin whose home chain has no dedicated picture — Binance Coin, Polygon
+ * Ecosystem Token, Avalanche — loses nothing. Their home chain IS the chain
+ * they are asked about, so the list collapses to what it already was, and for
+ * a chain's own coin the chain mark is the coin mark.
+ */
+const homeChainOfSymbol = new Map([...chainTable].reverse().map((entry) => [entry.nativeCurrency.symbol, entry.id]));
+/** Every chain's own native symbol, for resolving a coin from its chain alone. */
+const symbolOfChain = new Map(chainTable.map((entry) => [entry.id, entry.nativeCurrency.symbol]));
+/**
+ * The gib.show sources for a chain's NATIVE COIN, best first.
+ *
+ * The service serves the first source that resolves: the coin as this chain
+ * keys it, then the coin as its home chain keys it, then the chain's own mark.
+ * The last is an honest fallback rather than a mistake — for a chain's own coin
+ * the two marks are the same picture.
+ *
+ * @param chainId - the chain the coin is being shown on
+ * @returns the ordered source list, for {@link imageLinks.images}
+ */
+export const nativeCoinImageSources = (chainId) => {
+    const sources = [`${chainId}/${zeroAddress}`];
+    const symbol = symbolOfChain.get(chainId);
+    const home = symbol === undefined ? undefined : homeChainOfSymbol.get(symbol);
+    if (home !== undefined && home !== chainId) {
+        sources.push(`${home}/${zeroAddress}`);
+    }
+    sources.push(`${chainId}/`);
+    return sources;
+};
+/**
+ * Resolves the picture of a chain's native coin, as opposed to of the chain.
+ *
+ * @param chainId - the chain the coin is being shown on
+ * @returns an image url
+ */
+export const nativeCoinLogoUrl = (chainId) => imageLinks.images(nativeCoinImageSources(chainId));

package/dist/networks.js

@@ -1,10 +1,47 @@
-// NAMED imports, deliberately, and never `import * as chains from 'viem/chains'`.
-// A namespace import that is read dynamically (`Object.values`, or indexing by a
-// computed key) defeats tree-shaking outright: all ~700 chain definitions viem
-// ships get emitted to answer a question about the few dozen below, which
-// measured 255 kB of an application entry chunk. Naming each one keeps only what
-// is named.
-import { abstract, arbitrum, aurora, avalanche, base, berachain, blast, boba, bsc, celo, cronos, cronoszkEVM, fantom, fraxtal, fuse, gnosis, gravity, immutableZkEvm, linea, mainnet, mantle, optimism, polygon, polygonZkEvm, pulsechain, pulsechainV4, rootstock, scroll, sei, sepolia, sonic, taiko, unichain, worldchain, zksync, } from 'viem/chains';
+import { registerChainNames } from '@gibs/bridge-sdk/chain-names';
+import { chainTable } from './chain-table.js';
+/**
+ * Turns one row of the generated table into the shape viem wants.
+ *
+ * NAMED VIEM IMPORTS USED TO LIVE HERE — 37 of them, each pulling that chain's
+ * whole definition including fee logic, formatters and contract addresses this
+ * application never reads. That cost about 3.7 kB compressed for a third of the
+ * chains the aggregators quote; naming all 73 would have cost about 7.3 kB
+ * against roughly 7.8 kB of headroom under the first-load budget. The generated
+ * table carries the same 73 in 2.6 kB, so the whole supported set now weighs
+ * less than the third of it that shipped before.
+ *
+ * A namespace import is still never used, for the reason the old comment here
+ * gave: `Object.values(chains)` defeats tree-shaking and emitted all ~674
+ * definitions, measured at 255 kB. The generator does that read in Node, at
+ * build time, where it costs a reader nothing.
+ *
+ * `blockExplorers` is omitted rather than faked when a chain has no explorer —
+ * viem treats the field as optional and an empty url would render a dead link.
+ */
+const toViemChain = (entry) => ({
+    id: entry.id,
+    name: entry.name,
+    nativeCurrency: entry.nativeCurrency,
+    rpcUrls: { default: { http: [...entry.http] } },
+    ...(entry.explorer === null
+        ? {}
+        : { blockExplorers: { default: { name: 'Explorer', url: entry.explorer } } }),
+    // WITHOUT THIS, NOTHING CAN BATCH A READ. viem's `multicall` action reads the
+    // Multicall3 address off the chain and throws `ChainDoesNotSupportContract`
+    // when it is absent, so every chain built here refused — including
+    // PulseChain, whose token-metadata fallback failed with exactly that.
+    //
+    // It went missing when this table replaced viem's own chain objects to keep
+    // 255 kB of unused per-chain data out of the build. The table kept the four
+    // fields a TRANSPORT needs and dropped the one field an ACTION needs.
+    //
+    // Read per chain, never assumed: the canonical `0xcA11bde0…` covers most, but
+    // there are 8 distinct deployments across the chains listed here.
+    ...(entry.multicall3 === null
+        ? {}
+        : { contracts: { multicall3: { address: entry.multicall3 } } }),
+});
 /**
  * Every Ethereum-Virtual-Machine chain this client can build a public client for.
  *
@@ -18,43 +55,7 @@ import { abstract, arbitrum, aurora, avalanche, base, berachain, blast, boba, bs
  * for them. Anything wallet-facing that needs them keys off the aggregator's
  * chain identifiers instead.
  */
-export const evmChains = [
-    mainnet,
-    pulsechain,
-    sepolia,
-    pulsechainV4,
-    bsc,
-    arbitrum,
-    base,
-    blast,
-    avalanche,
-    polygon,
-    scroll,
-    optimism,
-    linea,
-    zksync,
-    polygonZkEvm,
-    gnosis,
-    fantom,
-    fuse,
-    boba,
-    unichain,
-    aurora,
-    sei,
-    immutableZkEvm,
-    sonic,
-    gravity,
-    taiko,
-    cronos,
-    cronoszkEVM,
-    fraxtal,
-    abstract,
-    rootstock,
-    celo,
-    worldchain,
-    mantle,
-    berachain,
-];
+export const evmChains = chainTable.map(toViemChain);
 /**
  * Lookup from a chain id to its viem chain definition, for supported chains only.
  *
@@ -63,6 +64,12 @@ export const evmChains = [
  * numeric-versus-string mismatch reads as "chain not supported".
  */
 export const evmChainsById = new Map(evmChains.map((chain) => [chain.id, chain]));
+// Hand these names to the SDK's display-name table so ONE function answers
+// "what is this chain called" everywhere. Done at module load, before anything
+// renders, because a name that arrives late is a name that changes under the
+// reader — which is precisely the flicker this removes. The SDK's own entries
+// win on conflict, so the product's chosen spellings are not overwritten.
+registerChainNames(evmChains.map((chain) => [chain.id, chain.name]));
 /**
  * Whether this client can reach a chain over Ethereum-style remote procedure calls.
  *

package/dist/token-metadata.js

@@ -1,8 +1,15 @@
 import { nativeTokenName, nativeTokenSymbol, toChain } from '@gibs/bridge-sdk/config';
+import { isNativeAsset } from '@gibs/bridge-sdk/ecosystems';
 import * as _ from 'lodash-es';
-import { erc20Abi, erc20Abi_bytes32, hexToString, zeroAddress } from 'viem';
+import { erc20Abi, erc20Abi_bytes32, hexToString } from 'viem';
 import { clientFromChain } from './client.js';
 import { evmChainsById } from './networks.js';
+/**
+ * How many tokens one multicall asks about. Results come back flat, so each
+ * loop below MUST pair a result triple with the address chunk that produced it
+ * — see the primary loop for what indexing the flat array cost.
+ */
+const TOKENS_PER_MULTICALL = 100;
 const bytes32Whitelist = new Set();
 // In-memory store for token metadata (loaded once, no persistence)
 const tokenMetadataStore = new Map();
@@ -81,7 +88,11 @@ async function batchFetchTokenMetadata(chainId, tokenAddresses) {
     const nativeTokens = [];
     const erc20Tokens = [];
     tokenAddresses.forEach((address) => {
-        if (address === zeroAddress || address.toLowerCase() === zeroAddress.toLowerCase()) {
+        // The registry's rule, not a hand-written one. Two spellings of the same
+        // comparison sat here — an exact match OR a lower-cased one — which is what
+        // a duplicated rule looks like once nobody is sure which half is load
+        // bearing.
+        if (isNativeAsset(address, 'evm')) {
             nativeTokens.push(address);
         }
         else {
@@ -99,7 +110,7 @@ async function batchFetchTokenMetadata(chainId, tokenAddresses) {
         return results;
     }
     // console.log(`Processing ${erc20Tokens.length} ERC20 tokens for chain ${chainId}:`, erc20Tokens)
-    const addressChunks = _.chunk(erc20Tokens, 100);
+    const addressChunks = _.chunk(erc20Tokens, TOKENS_PER_MULTICALL);
     const methods = ['symbol', 'name', 'decimals'];
     const addressChunksToCallChunks = (addressChunks, abi) => addressChunks.map((chunk) => chunk.map((address) => methods.map((functionName) => ({
         functionName,
@@ -111,16 +122,23 @@ async function batchFetchTokenMetadata(chainId, tokenAddresses) {
     // Try with standard ERC20 ABI first
     const chunkedCalls = addressChunksToCallChunks(addressChunks, (address) => bytes32Whitelist.has(getStoreKey(chainId, address)) ? erc20Abi_bytes32 : erc20Abi);
     const fallback = [];
-    for (const chunk of chunkedCalls) {
-        // console.log(`Executing multicall for chain ${chainId} with ${_.flatten(chunk).length} contracts`)
+    for (const [chunkIndex, chunk] of chunkedCalls.entries()) {
+        // The addresses THIS chunk asked about. Indexing the flat `erc20Tokens`
+        // here instead was a silent data-corruption bug: `index` restarts at 0 for
+        // every chunk, so with more than TOKENS_PER_MULTICALL tokens on one chain,
+        // the second chunk's results were stored under the FIRST chunk's addresses
+        // — every token past the first 100 got another token's name, symbol and
+        // decimals. A wrong `decimals` misprints every amount rendered for that
+        // token. Reading from the same partition that built the calls makes the
+        // pairing structural rather than arithmetic.
+        const chunkAddresses = addressChunks[chunkIndex];
         try {
             const batchResults = await client.multicall({
                 allowFailure: true,
                 contracts: _.flatten(chunk),
             });
-            // console.log(`Multicall results for chain ${chainId}:`, batchResults.length, 'results')
             _.chunk(batchResults, 3).forEach((batch, index) => {
-                const tokenAddress = erc20Tokens[index];
+                const tokenAddress = chunkAddresses[index];
                 const symbol = batch[0].result;
                 const name = batch[1].result;
                 const decimals = Number(batch[2].result);
@@ -136,17 +154,21 @@ async function batchFetchTokenMetadata(chainId, tokenAddresses) {
         }
         catch (error) {
             console.error(`Multicall failed for chain ${chainId}:`, error);
-            // Add all tokens to fallback if multicall fails completely
-            fallback.push(...erc20Tokens);
+            // Only THIS chunk's addresses. Pushing every token meant one failing
+            // chunk re-queued the whole set through the bytes32 fallback, including
+            // the tokens that had just succeeded.
+            fallback.push(...chunkAddresses);
         }
     }
     if (fallback.length === 0) {
         return results;
     }
     console.log(`Processing ${fallback.length} tokens in fallback with bytes32 ABI for chain ${chainId}:`, fallback);
-    const fallbackAddressChunks = _.chunk(fallback, 100);
+    const fallbackAddressChunks = _.chunk(fallback, TOKENS_PER_MULTICALL);
     const fallbackChunkedCalls = addressChunksToCallChunks(fallbackAddressChunks, () => erc20Abi_bytes32);
-    for (const chunk of fallbackChunkedCalls) {
+    for (const [chunkIndex, chunk] of fallbackChunkedCalls.entries()) {
+        // Same pairing rule as the primary loop above.
+        const chunkAddresses = fallbackAddressChunks[chunkIndex];
         try {
             console.log(`Executing fallback multicall for chain ${chainId} with ${_.flatten(chunk).length} contracts`);
             const batchResults = await client.multicall({
@@ -155,7 +177,7 @@ async function batchFetchTokenMetadata(chainId, tokenAddresses) {
             });
             console.log(`Fallback multicall results for chain ${chainId}:`, batchResults.length, 'results');
             _.chunk(batchResults, 3).forEach((batch, index) => {
-                const tokenAddress = fallback[index];
+                const tokenAddress = chunkAddresses[index];
                 const symbol = batch[0];
                 const name = batch[1];
                 const decimals = Number(batch[2]);

package/package.json

@@ -1,13 +1,32 @@
 {
   "name": "@gibs/bridge-client",
-  "version": "1.12.0",
-  "description": "Browser-side data loading, caching and endpoint resolution for the Gibs Finance bridge",
+  "version": "1.13.0",
+  "description": "Browser-side endpoints, clients, and caching for a Gibs Finance bridge interface.",
+  "keywords": [
+    "ethereum",
+    "pulsechain",
+    "bridge",
+    "viem",
+    "browser"
+  ],
+  "license": "ISC",
+  "author": "Gibs Finance",
+  "homepage": "https://gibs.finance",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gibsfinance/bridge.git",
+    "directory": "packages/bridge-client"
+  },
+  "bugs": {
+    "url": "https://github.com/gibsfinance/bridge/issues"
+  },
+  "engines": {
+    "node": ">=20"
+  },
   "type": "module",
+  "sideEffects": false,
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
-  "files": [
-    "dist"
-  ],
   "exports": {
     ".": {
       "gibs-source": "./src/index.ts",
@@ -50,27 +69,35 @@
       "default": "./dist/token-metadata.js"
     }
   },
-  "publishConfig": {
-    "access": "public"
-  },
+  "files": [
+    "dist",
+    "!dist/tsconfig.tsbuildinfo",
+    "!dist/**/*.test-d.*",
+    "!dist/test-utils",
+    "LICENSE"
+  ],
   "scripts": {
+    "prepublishOnly": "npx tsc",
     "build": "npx tsc",
     "test": "vitest run",
     "test:watch": "vitest"
   },
-  "keywords": [],
-  "author": "",
-  "license": "ISC",
+  "dependencies": {
+    "@gibs/bridge-sdk": "^1.13.0",
+    "@gibs/common": "^1.13.0",
+    "lodash-es": "^4.17.21"
+  },
+  "peerDependencies": {
+    "viem": ">=2.37.0 <3"
+  },
   "devDependencies": {
     "@types/lodash-es": "^4.17.12",
     "@types/node": "^24",
     "typescript": "~5.7.2",
+    "viem": "^2.46.3",
     "vitest": "^3.1.1"
   },
-  "dependencies": {
-    "@gibs/bridge-sdk": "^1.12.0",
-    "@gibs/common": "^1.12.0",
-    "lodash-es": "^4.17.21",
-    "viem": "^2.46.3"
+  "publishConfig": {
+    "access": "public"
   }
 }