@rango-dev/internal-blockchains 0.1.1-next.0

package/dist/caip.d.ts

@@ -0,0 +1,39 @@
+import type { BlockchainMeta } from 'rango-types';
+/**
+ * A CAIP-2 chain id, e.g. `eip155:1` or `bip122:000000000019d6689c085ae165831e93`.
+ *
+ * @see https://github.com/ChainAgnostic/CAIPs/blob/main/CAIPs/caip-2.md
+ */
+export type CaipChainId = `${string}:${string}`;
+/** Pair a namespace with a reference here, not at call sites — that's where ids get crossed. */
+export declare const CAIP_CHAINS: {
+    readonly BITCOIN: "bip122:000000000019d6689c085ae165831e93";
+    readonly BITCOINCASH: "bip122:000000000000000000651ef99cb9fcbe";
+    readonly DOGECOIN: "bip122:1a91e3dace36e2be3bf030a65679fe82";
+    readonly ETHEREUM: "eip155:1";
+    readonly LITECOIN: "bip122:12a765e31ffd4059bada1e25190f6e98";
+    readonly SOLANA: "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
+    readonly STARKNET: "starknet:SN_MAIN";
+    readonly STELLAR: "stellar:mainnet";
+    readonly SUI: "sui:sui";
+    readonly TON: "tvm:-239";
+    readonly TRON: "tron:tron";
+    readonly XRPL: "xrpl:mainnet";
+    readonly ZCASH: "bip122:zcash";
+};
+type BlockchainMetaForCaip = Pick<BlockchainMeta, 'type' | 'chainId' | 'name'>;
+/**
+ * Convert a meta entry to its CAIP-2 chain id, so providers are handed CAIP rather than
+ * Rango names. `null` means "not addressable by CAIP" — callers should skip the chain
+ * rather than fall back to a name.
+ */
+export declare function convertBlockchainMetaToCaip(blockchainMeta: BlockchainMetaForCaip): CaipChainId | null;
+/**
+ * The name-level counterpart to {@link convertBlockchainMetaToCaip}: signers get
+ * `asset.blockchain` ('BTC'), not a chain id. Only `TRANSFER` names resolve.
+ */
+export declare function isTransferBlockchainName(blockchainName: string, caipChainId: CaipChainId): boolean;
+export declare function isBitcoinBlockchain(blockchainName: string): boolean;
+export declare function isZcashBlockchain(blockchainName: string): boolean;
+export {};
+//# sourceMappingURL=caip.d.ts.map

package/dist/caip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"caip.d.ts","sourceRoot":"","sources":["../src/caip.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AA8ClD;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;AAEhD,gGAAgG;AAChG,eAAO,MAAM,WAAW;;;;;;;;;;;;;;CAcwB,CAAC;AAEjD,KAAK,qBAAqB,GAAG,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC,CAAC;AA2F/E;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,cAAc,EAAE,qBAAqB,GACpC,WAAW,GAAG,IAAI,CAQpB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,WAAW,GACvB,OAAO,CAET;AAED,wBAAgB,mBAAmB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAEjE"}

package/dist/mod.d.ts

@@ -0,0 +1,4 @@
+export * from './networks.js';
+export * from './caip.js';
+export * from './utils.js';
+//# sourceMappingURL=mod.d.ts.map

package/dist/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC"}

package/dist/mod.js

@@ -0,0 +1,2 @@
+var N=Object.defineProperty;var r=(C,n)=>N(C,"name",{value:n,configurable:!0});var p=(A=>(A.BTC="BTC",A.BSC="BSC",A.LTC="LTC",A.THORCHAIN="THOR",A.BCH="BCH",A.BINANCE="BNB",A.BLAST="BLAST",A.CELO="CELO",A.LINEA="LINEA",A.METIS="METIS",A.SONIC="SONIC",A.BERACHAIN="BERACHAIN",A.ZETA_CHAIN="ZETA_CHAIN",A.SCROLL="SCROLL",A.ZKSYNC="ZKSYNC",A.MONAD="MONAD",A.ETHEREUM="ETH",A.POLYGON="POLYGON",A.POLKADOT="",A.TRON="TRON",A.DOGE="DOGE",A.HARMONY="HARMONY",A.AVAX_CCHAIN="AVAX_CCHAIN",A.FANTOM="FANTOM",A.MOONBEAM="MOONBEAM",A.ARBITRUM="ARBITRUM",A.BOBA="BOBA",A.OPTIMISM="OPTIMISM",A.FUSE="FUSE",A.CRONOS="CRONOS",A.SOLANA="SOLANA",A.MOONRIVER="MOONRIVER",A.GNOSIS="GNOSIS",A.MAYA="MAYA",A.STARKNET="STARKNET",A.STELLAR="STELLAR",A.TON="TON",A.BASE="BASE",A.SUI="SUI",A.XRPL="XRPL",A.ZCASH="ZCASH",A.HYPERLIQUID="HYPERLIQUID",A.Unknown="Unkown",A))(p||{}),F="ARBITRUM";import{CAIP_ETHEREUM_CHAIN_ID as P,CAIP_NAMESPACE as t}from"@hub3js/evm";import{CAIP_SOLANA_CHAIN_ID as R,CAIP_NAMESPACE as m}from"@hub3js/solana";import{CAIP_STARKNET_CHAIN_ID as M,CAIP_NAMESPACE as l}from"@hub3js/starknet";import{CAIP_STELLAR_CHAIN_ID as f,CAIP_NAMESPACE as B}from"@hub3js/stellar";import{CAIP_SUI_CHAIN_ID as u,CAIP_NAMESPACE as L}from"@hub3js/sui";import{CAIP_TON_CHAIN_ID as H,CAIP_NAMESPACE as h}from"@hub3js/tvm";import{CAIP_XRPL_CHAIN_ID as s,CAIP_NAMESPACE as d}from"@hub3js/xrpl";import{CAIP_TRON_CHAIN_ID as $,CAIP_NAMESPACE as D}from"@rango-dev/wallets-core/namespaces/tron";import{CAIP_BITCOIN_CHAIN_ID as U,CAIP_BITCOINCASH_CHAIN_ID as v,CAIP_DOGECOIN_CHAIN_ID as x,CAIP_LITECOIN_CHAIN_ID as y,CAIP_NAMESPACE as e,CAIP_ZCASH_CHAIN_ID as g}from"@rango-dev/wallets-core/namespaces/utxo";import{TransactionType as a}from"rango-types";var I={BITCOIN:`${e}:${U}`,BITCOINCASH:`${e}:${v}`,DOGECOIN:`${e}:${x}`,ETHEREUM:`${t}:${P}`,LITECOIN:`${e}:${y}`,SOLANA:`${m}:${R}`,STARKNET:`${l}:${M}`,STELLAR:`${B}:${f}`,SUI:`${L}:${u}`,TON:`${h}:${H}`,TRON:`${D}:${$}`,XRPL:`${d}:${s}`,ZCASH:`${e}:${g}`},Y=16,X=10,O={BCH:I.BITCOINCASH,BTC:I.BITCOIN,DOGE:I.DOGECOIN,LTC:I.LITECOIN,ZCASH:I.ZCASH};function T(C,n){if(!n)return null;let i=/^0x[0-9a-f]+$/i.test(n),E=/^[0-9]+$/.test(n);if(!i&&!E)return null;let o=parseInt(n,i?Y:X);return Number.isSafeInteger(o)?`${C}:${o}`:null}r(T,"toNumericCaip");var K={[a.SOLANA]:I.SOLANA,[a.STARKNET]:I.STARKNET,[a.STELLAR]:I.STELLAR,[a.SUI]:I.SUI,[a.TON]:I.TON,[a.TRON]:I.TRON,[a.XRPL]:I.XRPL,[a.EVM]:C=>T(t,C.chainId),[a.HYPERLIQUID]:C=>T(t,C.chainId),[a.TRANSFER]:C=>O[C.name]??null,[a.COSMOS]:null};function S(C){let n=K[C.type];return n?typeof n=="function"?n(C):n:null}r(S,"convertBlockchainMetaToCaip");function c(C,n){return O[C]===n}r(c,"isTransferBlockchainName");function CA(C){return c(C,I.BITCOIN)}r(CA,"isBitcoinBlockchain");function nA(C){return c(C,I.ZCASH)}r(nA,"isZcashBlockchain");function rA(C,n){return n?.filter(i=>{let E=S(i);return E?C.isChainSupported(E):!1})??[]}r(rA,"getSupportedChainsFromNamespace");function EA(C,n){let i=C.info()?.metadata.properties?.find(E=>E.name==="namespaces");return n?.filter(E=>{let o=S(E);return o?i?.value.data.some(_=>_.isChainSupported(o))??!1:!1})??[]}r(EA,"getSupportedChainsFromProvider");function oA(C){return C.reduce((n,i)=>(n[i.name]={chainName:i.info.chainName,chainId:i.chainId,nativeCurrency:i.info.nativeCurrency,rpcUrls:i.info.rpcUrls,blockExplorerUrls:i.info.blockExplorerUrls},n),{})}r(oA,"convertEvmBlockchainMetaToEvmChainInfo");export{I as CAIP_CHAINS,F as HYPERLIQUID_SIGN_NETWORK,p as Networks,S as convertBlockchainMetaToCaip,oA as convertEvmBlockchainMetaToEvmChainInfo,rA as getSupportedChainsFromNamespace,EA as getSupportedChainsFromProvider,CA as isBitcoinBlockchain,c as isTransferBlockchainName,nA as isZcashBlockchain};
+//# sourceMappingURL=mod.js.map

package/dist/mod.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/networks.ts", "../src/caip.ts", "../src/utils.ts"],
+  "sourcesContent": ["export enum Networks {\n  BTC = 'BTC',\n  BSC = 'BSC',\n  LTC = 'LTC',\n  THORCHAIN = 'THOR',\n  BCH = 'BCH',\n  BINANCE = 'BNB',\n  BLAST = 'BLAST',\n  CELO = 'CELO',\n  LINEA = 'LINEA',\n  METIS = 'METIS',\n  SONIC = 'SONIC',\n  BERACHAIN = 'BERACHAIN',\n  ZETA_CHAIN = 'ZETA_CHAIN',\n  SCROLL = 'SCROLL',\n  ZKSYNC = 'ZKSYNC',\n  MONAD = 'MONAD',\n  ETHEREUM = 'ETH',\n  POLYGON = 'POLYGON',\n  POLKADOT = '',\n  TRON = 'TRON',\n  DOGE = 'DOGE',\n  HARMONY = 'HARMONY',\n  AVAX_CCHAIN = 'AVAX_CCHAIN',\n  FANTOM = 'FANTOM',\n  MOONBEAM = 'MOONBEAM',\n  ARBITRUM = 'ARBITRUM',\n  BOBA = 'BOBA',\n  OPTIMISM = 'OPTIMISM',\n  FUSE = 'FUSE',\n  CRONOS = 'CRONOS',\n  SOLANA = 'SOLANA',\n  MOONRIVER = 'MOONRIVER',\n  GNOSIS = 'GNOSIS',\n  MAYA = 'MAYA',\n  STARKNET = 'STARKNET',\n  STELLAR = 'STELLAR',\n  TON = 'TON',\n  BASE = 'BASE',\n  SUI = 'SUI',\n  XRPL = 'XRPL',\n  ZCASH = 'ZCASH',\n  HYPERLIQUID = 'HYPERLIQUID',\n\n  // Using instead of null\n  Unknown = 'Unkown',\n}\n\nexport const HYPERLIQUID_SIGN_NETWORK = Networks.ARBITRUM;\n", "import type { BlockchainMeta } from 'rango-types';\n\nimport {\n  CAIP_ETHEREUM_CHAIN_ID,\n  CAIP_NAMESPACE as CAIP_EVM_NAMESPACE,\n} from '@hub3js/evm';\nimport {\n  CAIP_SOLANA_CHAIN_ID,\n  CAIP_NAMESPACE as CAIP_SOLANA_NAMESPACE,\n} from '@hub3js/solana';\nimport {\n  CAIP_STARKNET_CHAIN_ID,\n  CAIP_NAMESPACE as CAIP_STARKNET_NAMESPACE,\n} from '@hub3js/starknet';\nimport {\n  CAIP_STELLAR_CHAIN_ID,\n  CAIP_NAMESPACE as CAIP_STELLAR_NAMESPACE,\n} from '@hub3js/stellar';\nimport {\n  CAIP_SUI_CHAIN_ID,\n  CAIP_NAMESPACE as CAIP_SUI_NAMESPACE,\n} from '@hub3js/sui';\nimport {\n  CAIP_TON_CHAIN_ID,\n  CAIP_NAMESPACE as CAIP_TVM_NAMESPACE,\n} from '@hub3js/tvm';\nimport {\n  CAIP_XRPL_CHAIN_ID,\n  CAIP_NAMESPACE as CAIP_XRPL_NAMESPACE,\n} from '@hub3js/xrpl';\nimport {\n  CAIP_TRON_CHAIN_ID,\n  CAIP_NAMESPACE as CAIP_TRON_NAMESPACE,\n} from '@rango-dev/wallets-core/namespaces/tron';\nimport {\n  CAIP_BITCOIN_CHAIN_ID,\n  CAIP_BITCOINCASH_CHAIN_ID,\n  CAIP_DOGECOIN_CHAIN_ID,\n  CAIP_LITECOIN_CHAIN_ID,\n  CAIP_NAMESPACE as CAIP_UTXO_NAMESPACE,\n  CAIP_ZCASH_CHAIN_ID,\n} from '@rango-dev/wallets-core/namespaces/utxo';\nimport { TransactionType } from 'rango-types';\n\nimport { Networks } from './networks.js';\n\n/**\n * A CAIP-2 chain id, e.g. `eip155:1` or `bip122:000000000019d6689c085ae165831e93`.\n *\n * @see https://github.com/ChainAgnostic/CAIPs/blob/main/CAIPs/caip-2.md\n */\nexport type CaipChainId = `${string}:${string}`;\n\n/** Pair a namespace with a reference here, not at call sites \u2014 that's where ids get crossed. */\nexport const CAIP_CHAINS = {\n  BITCOIN: `${CAIP_UTXO_NAMESPACE}:${CAIP_BITCOIN_CHAIN_ID}`,\n  BITCOINCASH: `${CAIP_UTXO_NAMESPACE}:${CAIP_BITCOINCASH_CHAIN_ID}`,\n  DOGECOIN: `${CAIP_UTXO_NAMESPACE}:${CAIP_DOGECOIN_CHAIN_ID}`,\n  ETHEREUM: `${CAIP_EVM_NAMESPACE}:${CAIP_ETHEREUM_CHAIN_ID}`,\n  LITECOIN: `${CAIP_UTXO_NAMESPACE}:${CAIP_LITECOIN_CHAIN_ID}`,\n  SOLANA: `${CAIP_SOLANA_NAMESPACE}:${CAIP_SOLANA_CHAIN_ID}`,\n  STARKNET: `${CAIP_STARKNET_NAMESPACE}:${CAIP_STARKNET_CHAIN_ID}`,\n  STELLAR: `${CAIP_STELLAR_NAMESPACE}:${CAIP_STELLAR_CHAIN_ID}`,\n  SUI: `${CAIP_SUI_NAMESPACE}:${CAIP_SUI_CHAIN_ID}`,\n  TON: `${CAIP_TVM_NAMESPACE}:${CAIP_TON_CHAIN_ID}`,\n  TRON: `${CAIP_TRON_NAMESPACE}:${CAIP_TRON_CHAIN_ID}`,\n  XRPL: `${CAIP_XRPL_NAMESPACE}:${CAIP_XRPL_CHAIN_ID}`,\n  ZCASH: `${CAIP_UTXO_NAMESPACE}:${CAIP_ZCASH_CHAIN_ID}`,\n} as const satisfies Record<string, CaipChainId>;\n\ntype BlockchainMetaForCaip = Pick<BlockchainMeta, 'type' | 'chainId' | 'name'>;\n\nconst HEX_RADIX = 16;\nconst DECIMAL_RADIX = 10;\n\n/**\n * `TRANSFER` covers several UTXO chains and its meta `chainId` is always `null`, so\n * these can only be keyed by name. This table is the one place in the wallet packages\n * that has to know a Rango chain name \u2014 everywhere else works in CAIP-2 ids, which is\n * why `Networks` shouldn't spread beyond it.\n *\n * DASH is knowingly absent: no CAIP constant and no provider supports it, so it\n * converts to `null` and is dropped.\n */\nconst CAIP_BY_TRANSFER_BLOCKCHAIN_NAME: Record<string, CaipChainId> = {\n  [Networks.BCH]: CAIP_CHAINS.BITCOINCASH,\n  [Networks.BTC]: CAIP_CHAINS.BITCOIN,\n  [Networks.DOGE]: CAIP_CHAINS.DOGECOIN,\n  [Networks.LTC]: CAIP_CHAINS.LITECOIN,\n  [Networks.ZCASH]: CAIP_CHAINS.ZCASH,\n};\n\n/**\n * `eip155` references are decimal but meta reports EVM chainIds as hex ('0xa86a'), and\n * Hyperliquid reports a bare decimal ('1337') \u2014 so the prefix picks the radix, not the\n * chain family.\n */\nfunction toNumericCaip(\n  namespace: string,\n  chainId: string | null | undefined\n): CaipChainId | null {\n  if (!chainId) {\n    return null;\n  }\n\n  const isHex = /^0x[0-9a-f]+$/i.test(chainId);\n  const isDecimal = /^[0-9]+$/.test(chainId);\n\n  // `parseInt` stops at the first bad character, so '12abc' would become chain id '12'.\n  if (!isHex && !isDecimal) {\n    return null;\n  }\n\n  const reference = parseInt(chainId, isHex ? HEX_RADIX : DECIMAL_RADIX);\n\n  return Number.isSafeInteger(reference) ? `${namespace}:${reference}` : null;\n}\n\ntype CaipResolver =\n  | CaipChainId\n  | ((blockchainMeta: BlockchainMetaForCaip) => CaipChainId | null)\n  | null;\n\n/**\n * A total `Record` on purpose: a new `TransactionType` in rango-types fails to compile\n * here instead of silently making that family invisible to every wallet.\n */\nconst CAIP_BY_TRANSACTION_TYPE: Record<TransactionType, CaipResolver> = {\n  /*\n   * Fixed ids, ignoring meta `chainId` \u2014 it is NOT the CAIP reference for several of\n   * these (meta reports Solana as 'mainnet-beta', Sui as 'sui-mainnet'), so deriving\n   * from it would produce ids that don't match the accounts providers report.\n   */\n  [TransactionType.SOLANA]: CAIP_CHAINS.SOLANA,\n  [TransactionType.STARKNET]: CAIP_CHAINS.STARKNET,\n  [TransactionType.STELLAR]: CAIP_CHAINS.STELLAR,\n  [TransactionType.SUI]: CAIP_CHAINS.SUI,\n  [TransactionType.TON]: CAIP_CHAINS.TON,\n  [TransactionType.TRON]: CAIP_CHAINS.TRON,\n  [TransactionType.XRPL]: CAIP_CHAINS.XRPL,\n\n  [TransactionType.EVM]: (blockchainMeta) =>\n    toNumericCaip(CAIP_EVM_NAMESPACE, blockchainMeta.chainId),\n\n  /*\n   * `eip155` so the wallets claiming the whole EVM family keep supporting Hyperliquid,\n   * as they did when they listed it by name. The reference is meta's 1337, NOT\n   * HyperEVM's real 999 \u2014 safe only because an `eip155` reference is never turned back\n   * into a chain id. Give Hyperliquid its own namespace before deriving a network\n   * switch or RPC target from this.\n   */\n  [TransactionType.HYPERLIQUID]: (blockchainMeta) =>\n    toNumericCaip(CAIP_EVM_NAMESPACE, blockchainMeta.chainId),\n\n  [TransactionType.TRANSFER]: (blockchainMeta) =>\n    CAIP_BY_TRANSFER_BLOCKCHAIN_NAME[blockchainMeta.name] ?? null,\n\n  // Not addressable \u2014 no namespace claims it, so no provider can match it.\n  [TransactionType.COSMOS]: null,\n};\n\n/**\n * Convert a meta entry to its CAIP-2 chain id, so providers are handed CAIP rather than\n * Rango names. `null` means \"not addressable by CAIP\" \u2014 callers should skip the chain\n * rather than fall back to a name.\n */\nexport function convertBlockchainMetaToCaip(\n  blockchainMeta: BlockchainMetaForCaip\n): CaipChainId | null {\n  const resolver = CAIP_BY_TRANSACTION_TYPE[blockchainMeta.type];\n\n  if (!resolver) {\n    return null;\n  }\n\n  return typeof resolver === 'function' ? resolver(blockchainMeta) : resolver;\n}\n\n/**\n * The name-level counterpart to {@link convertBlockchainMetaToCaip}: signers get\n * `asset.blockchain` ('BTC'), not a chain id. Only `TRANSFER` names resolve.\n */\nexport function isTransferBlockchainName(\n  blockchainName: string,\n  caipChainId: CaipChainId\n): boolean {\n  return CAIP_BY_TRANSFER_BLOCKCHAIN_NAME[blockchainName] === caipChainId;\n}\n\nexport function isBitcoinBlockchain(blockchainName: string): boolean {\n  return isTransferBlockchainName(blockchainName, CAIP_CHAINS.BITCOIN);\n}\n\nexport function isZcashBlockchain(blockchainName: string): boolean {\n  return isTransferBlockchainName(blockchainName, CAIP_CHAINS.ZCASH);\n}\n", "import type { Provider } from '@hub3js/core';\nimport type { Chain } from '@hub3js/evm';\nimport type { BlockchainMeta, EvmBlockchainMeta } from 'rango-types';\n\nimport { convertBlockchainMetaToCaip } from './caip.js';\n\ntype ChainSupport = {\n  isChainSupported: (chainId: string) => boolean;\n};\n\nexport type EvmNetworksChainInfo = Record<string, Chain>;\n\n/**\n * The chains of `allBlockChains` a single namespace can address. Chains that don't\n * convert to CAIP are dropped rather than guessed at - see\n * {@link convertBlockchainMetaToCaip}.\n */\nexport function getSupportedChainsFromNamespace(\n  namespace: ChainSupport,\n  allBlockChains: BlockchainMeta[] | undefined\n): BlockchainMeta[] {\n  return (\n    allBlockChains?.filter((blockchain) => {\n      const chainId = convertBlockchainMetaToCaip(blockchain);\n\n      return chainId ? namespace.isChainSupported(chainId) : false;\n    }) ?? []\n  );\n}\n\n/**\n * The union of what every namespace of a provider supports, in `allBlockChains` order\n * and without duplicates when two namespaces claim the same chain.\n */\nexport function getSupportedChainsFromProvider(\n  provider: Provider,\n  allBlockChains: BlockchainMeta[] | undefined\n): BlockchainMeta[] {\n  const namespacesProperty = provider\n    .info()\n    ?.metadata.properties?.find((property) => property.name === 'namespaces');\n\n  return (\n    allBlockChains?.filter((blockchain) => {\n      const chainId = convertBlockchainMetaToCaip(blockchain);\n\n      if (!chainId) {\n        return false;\n      }\n\n      return (\n        namespacesProperty?.value.data.some((namespace) =>\n          namespace.isChainSupported(chainId)\n        ) ?? false\n      );\n    }) ?? []\n  );\n}\n\n/*\n * TODO: remove this. It exists only so a provider can look a chain up by Rango's\n * network name, which is knowledge a provider shouldn't carry \u2014 the caller already\n * resolves the chain and should hand the provider an EIP-3085 description instead.\n * Once every consumer does that, this table and the providers' dependency on\n * Rango's chain model go away together.\n */\nexport function convertEvmBlockchainMetaToEvmChainInfo(\n  evmBlockchains: EvmBlockchainMeta[]\n): EvmNetworksChainInfo {\n  return evmBlockchains.reduce<EvmNetworksChainInfo>(\n    (evmNetworksChainInfo, blockchainMeta) => {\n      evmNetworksChainInfo[blockchainMeta.name] = {\n        chainName: blockchainMeta.info.chainName,\n        chainId: blockchainMeta.chainId,\n        nativeCurrency: blockchainMeta.info.nativeCurrency,\n        rpcUrls: blockchainMeta.info.rpcUrls,\n        blockExplorerUrls: blockchainMeta.info.blockExplorerUrls,\n      };\n\n      return evmNetworksChainInfo;\n    },\n    {}\n  );\n}\n"],
+  "mappings": "+EAAO,IAAKA,OACVA,EAAA,IAAM,MACNA,EAAA,IAAM,MACNA,EAAA,IAAM,MACNA,EAAA,UAAY,OACZA,EAAA,IAAM,MACNA,EAAA,QAAU,MACVA,EAAA,MAAQ,QACRA,EAAA,KAAO,OACPA,EAAA,MAAQ,QACRA,EAAA,MAAQ,QACRA,EAAA,MAAQ,QACRA,EAAA,UAAY,YACZA,EAAA,WAAa,aACbA,EAAA,OAAS,SACTA,EAAA,OAAS,SACTA,EAAA,MAAQ,QACRA,EAAA,SAAW,MACXA,EAAA,QAAU,UACVA,EAAA,SAAW,GACXA,EAAA,KAAO,OACPA,EAAA,KAAO,OACPA,EAAA,QAAU,UACVA,EAAA,YAAc,cACdA,EAAA,OAAS,SACTA,EAAA,SAAW,WACXA,EAAA,SAAW,WACXA,EAAA,KAAO,OACPA,EAAA,SAAW,WACXA,EAAA,KAAO,OACPA,EAAA,OAAS,SACTA,EAAA,OAAS,SACTA,EAAA,UAAY,YACZA,EAAA,OAAS,SACTA,EAAA,KAAO,OACPA,EAAA,SAAW,WACXA,EAAA,QAAU,UACVA,EAAA,IAAM,MACNA,EAAA,KAAO,OACPA,EAAA,IAAM,MACNA,EAAA,KAAO,OACPA,EAAA,MAAQ,QACRA,EAAA,YAAc,cAGdA,EAAA,QAAU,SA7CAA,OAAA,IAgDCC,EAA2B,WC9CxC,OACE,0BAAAC,EACA,kBAAkBC,MACb,cACP,OACE,wBAAAC,EACA,kBAAkBC,MACb,iBACP,OACE,0BAAAC,EACA,kBAAkBC,MACb,mBACP,OACE,yBAAAC,EACA,kBAAkBC,MACb,kBACP,OACE,qBAAAC,EACA,kBAAkBC,MACb,cACP,OACE,qBAAAC,EACA,kBAAkBC,MACb,cACP,OACE,sBAAAC,EACA,kBAAkBC,MACb,eACP,OACE,sBAAAC,EACA,kBAAkBC,MACb,0CACP,OACE,yBAAAC,EACA,6BAAAC,EACA,0BAAAC,EACA,0BAAAC,EACA,kBAAkBC,EAClB,uBAAAC,MACK,0CACP,OAAS,mBAAAC,MAAuB,cAYzB,IAAMC,EAAc,CACzB,QAAS,GAAGC,CAAmB,IAAIC,CAAqB,GACxD,YAAa,GAAGD,CAAmB,IAAIE,CAAyB,GAChE,SAAU,GAAGF,CAAmB,IAAIG,CAAsB,GAC1D,SAAU,GAAGC,CAAkB,IAAIC,CAAsB,GACzD,SAAU,GAAGL,CAAmB,IAAIM,CAAsB,GAC1D,OAAQ,GAAGC,CAAqB,IAAIC,CAAoB,GACxD,SAAU,GAAGC,CAAuB,IAAIC,CAAsB,GAC9D,QAAS,GAAGC,CAAsB,IAAIC,CAAqB,GAC3D,IAAK,GAAGC,CAAkB,IAAIC,CAAiB,GAC/C,IAAK,GAAGC,CAAkB,IAAIC,CAAiB,GAC/C,KAAM,GAAGC,CAAmB,IAAIC,CAAkB,GAClD,KAAM,GAAGC,CAAmB,IAAIC,CAAkB,GAClD,MAAO,GAAGpB,CAAmB,IAAIqB,CAAmB,EACtD,EAIMC,EAAY,GACZC,EAAgB,GAWhBC,EAAgE,CACnE,IAAezB,EAAY,YAC3B,IAAeA,EAAY,QAC3B,KAAgBA,EAAY,SAC5B,IAAeA,EAAY,SAC3B,MAAiBA,EAAY,KAChC,EAOA,SAAS0B,EACPC,EACAC,EACoB,CACpB,GAAI,CAACA,EACH,OAAO,KAGT,IAAMC,EAAQ,iBAAiB,KAAKD,CAAO,EACrCE,EAAY,WAAW,KAAKF,CAAO,EAGzC,GAAI,CAACC,GAAS,CAACC,EACb,OAAO,KAGT,IAAMC,EAAY,SAASH,EAASC,EAAQN,EAAYC,CAAa,EAErE,OAAO,OAAO,cAAcO,CAAS,EAAI,GAAGJ,CAAS,IAAII,CAAS,GAAK,IACzE,CAnBSC,EAAAN,EAAA,iBA8BT,IAAMO,EAAkE,CAMtE,CAACC,EAAgB,MAAM,EAAGlC,EAAY,OACtC,CAACkC,EAAgB,QAAQ,EAAGlC,EAAY,SACxC,CAACkC,EAAgB,OAAO,EAAGlC,EAAY,QACvC,CAACkC,EAAgB,GAAG,EAAGlC,EAAY,IACnC,CAACkC,EAAgB,GAAG,EAAGlC,EAAY,IACnC,CAACkC,EAAgB,IAAI,EAAGlC,EAAY,KACpC,CAACkC,EAAgB,IAAI,EAAGlC,EAAY,KAEpC,CAACkC,EAAgB,GAAG,EAAIC,GACtBT,EAAcrB,EAAoB8B,EAAe,OAAO,EAS1D,CAACD,EAAgB,WAAW,EAAIC,GAC9BT,EAAcrB,EAAoB8B,EAAe,OAAO,EAE1D,CAACD,EAAgB,QAAQ,EAAIC,GAC3BV,EAAiCU,EAAe,IAAI,GAAK,KAG3D,CAACD,EAAgB,MAAM,EAAG,IAC5B,EAOO,SAASE,EACdD,EACoB,CACpB,IAAME,EAAWJ,EAAyBE,EAAe,IAAI,EAE7D,OAAKE,EAIE,OAAOA,GAAa,WAAaA,EAASF,CAAc,EAAIE,EAH1D,IAIX,CAVgBL,EAAAI,EAAA,+BAgBT,SAASE,EACdC,EACAC,EACS,CACT,OAAOf,EAAiCc,CAAc,IAAMC,CAC9D,CALgBR,EAAAM,EAAA,4BAOT,SAASG,GAAoBF,EAAiC,CACnE,OAAOD,EAAyBC,EAAgBvC,EAAY,OAAO,CACrE,CAFgBgC,EAAAS,GAAA,uBAIT,SAASC,GAAkBH,EAAiC,CACjE,OAAOD,EAAyBC,EAAgBvC,EAAY,KAAK,CACnE,CAFgBgC,EAAAU,GAAA,qBChLT,SAASC,GACdC,EACAC,EACkB,CAClB,OACEA,GAAgB,OAAQC,GAAe,CACrC,IAAMC,EAAUC,EAA4BF,CAAU,EAEtD,OAAOC,EAAUH,EAAU,iBAAiBG,CAAO,EAAI,EACzD,CAAC,GAAK,CAAC,CAEX,CAXgBE,EAAAN,GAAA,mCAiBT,SAASO,GACdC,EACAN,EACkB,CAClB,IAAMO,EAAqBD,EACxB,KAAK,GACJ,SAAS,YAAY,KAAME,GAAaA,EAAS,OAAS,YAAY,EAE1E,OACER,GAAgB,OAAQC,GAAe,CACrC,IAAMC,EAAUC,EAA4BF,CAAU,EAEtD,OAAKC,EAKHK,GAAoB,MAAM,KAAK,KAAMR,GACnCA,EAAU,iBAAiBG,CAAO,CACpC,GAAK,GANE,EAQX,CAAC,GAAK,CAAC,CAEX,CAvBgBE,EAAAC,GAAA,kCAgCT,SAASI,GACdC,EACsB,CACtB,OAAOA,EAAe,OACpB,CAACC,EAAsBC,KACrBD,EAAqBC,EAAe,IAAI,EAAI,CAC1C,UAAWA,EAAe,KAAK,UAC/B,QAASA,EAAe,QACxB,eAAgBA,EAAe,KAAK,eACpC,QAASA,EAAe,KAAK,QAC7B,kBAAmBA,EAAe,KAAK,iBACzC,EAEOD,GAET,CAAC,CACH,CACF,CAjBgBP,EAAAK,GAAA",
+  "names": ["Networks", "HYPERLIQUID_SIGN_NETWORK", "CAIP_ETHEREUM_CHAIN_ID", "CAIP_EVM_NAMESPACE", "CAIP_SOLANA_CHAIN_ID", "CAIP_SOLANA_NAMESPACE", "CAIP_STARKNET_CHAIN_ID", "CAIP_STARKNET_NAMESPACE", "CAIP_STELLAR_CHAIN_ID", "CAIP_STELLAR_NAMESPACE", "CAIP_SUI_CHAIN_ID", "CAIP_SUI_NAMESPACE", "CAIP_TON_CHAIN_ID", "CAIP_TVM_NAMESPACE", "CAIP_XRPL_CHAIN_ID", "CAIP_XRPL_NAMESPACE", "CAIP_TRON_CHAIN_ID", "CAIP_TRON_NAMESPACE", "CAIP_BITCOIN_CHAIN_ID", "CAIP_BITCOINCASH_CHAIN_ID", "CAIP_DOGECOIN_CHAIN_ID", "CAIP_LITECOIN_CHAIN_ID", "CAIP_UTXO_NAMESPACE", "CAIP_ZCASH_CHAIN_ID", "TransactionType", "CAIP_CHAINS", "CAIP_UTXO_NAMESPACE", "CAIP_BITCOIN_CHAIN_ID", "CAIP_BITCOINCASH_CHAIN_ID", "CAIP_DOGECOIN_CHAIN_ID", "CAIP_EVM_NAMESPACE", "CAIP_ETHEREUM_CHAIN_ID", "CAIP_LITECOIN_CHAIN_ID", "CAIP_SOLANA_NAMESPACE", "CAIP_SOLANA_CHAIN_ID", "CAIP_STARKNET_NAMESPACE", "CAIP_STARKNET_CHAIN_ID", "CAIP_STELLAR_NAMESPACE", "CAIP_STELLAR_CHAIN_ID", "CAIP_SUI_NAMESPACE", "CAIP_SUI_CHAIN_ID", "CAIP_TVM_NAMESPACE", "CAIP_TON_CHAIN_ID", "CAIP_TRON_NAMESPACE", "CAIP_TRON_CHAIN_ID", "CAIP_XRPL_NAMESPACE", "CAIP_XRPL_CHAIN_ID", "CAIP_ZCASH_CHAIN_ID", "HEX_RADIX", "DECIMAL_RADIX", "CAIP_BY_TRANSFER_BLOCKCHAIN_NAME", "toNumericCaip", "namespace", "chainId", "isHex", "isDecimal", "reference", "__name", "CAIP_BY_TRANSACTION_TYPE", "TransactionType", "blockchainMeta", "convertBlockchainMetaToCaip", "resolver", "isTransferBlockchainName", "blockchainName", "caipChainId", "isBitcoinBlockchain", "isZcashBlockchain", "getSupportedChainsFromNamespace", "namespace", "allBlockChains", "blockchain", "chainId", "convertBlockchainMetaToCaip", "__name", "getSupportedChainsFromProvider", "provider", "namespacesProperty", "property", "convertEvmBlockchainMetaToEvmChainInfo", "evmBlockchains", "evmNetworksChainInfo", "blockchainMeta"]
+}

package/dist/networks.d.ts

@@ -0,0 +1,47 @@
+export declare enum Networks {
+    BTC = "BTC",
+    BSC = "BSC",
+    LTC = "LTC",
+    THORCHAIN = "THOR",
+    BCH = "BCH",
+    BINANCE = "BNB",
+    BLAST = "BLAST",
+    CELO = "CELO",
+    LINEA = "LINEA",
+    METIS = "METIS",
+    SONIC = "SONIC",
+    BERACHAIN = "BERACHAIN",
+    ZETA_CHAIN = "ZETA_CHAIN",
+    SCROLL = "SCROLL",
+    ZKSYNC = "ZKSYNC",
+    MONAD = "MONAD",
+    ETHEREUM = "ETH",
+    POLYGON = "POLYGON",
+    POLKADOT = "",
+    TRON = "TRON",
+    DOGE = "DOGE",
+    HARMONY = "HARMONY",
+    AVAX_CCHAIN = "AVAX_CCHAIN",
+    FANTOM = "FANTOM",
+    MOONBEAM = "MOONBEAM",
+    ARBITRUM = "ARBITRUM",
+    BOBA = "BOBA",
+    OPTIMISM = "OPTIMISM",
+    FUSE = "FUSE",
+    CRONOS = "CRONOS",
+    SOLANA = "SOLANA",
+    MOONRIVER = "MOONRIVER",
+    GNOSIS = "GNOSIS",
+    MAYA = "MAYA",
+    STARKNET = "STARKNET",
+    STELLAR = "STELLAR",
+    TON = "TON",
+    BASE = "BASE",
+    SUI = "SUI",
+    XRPL = "XRPL",
+    ZCASH = "ZCASH",
+    HYPERLIQUID = "HYPERLIQUID",
+    Unknown = "Unkown"
+}
+export declare const HYPERLIQUID_SIGN_NETWORK = Networks.ARBITRUM;
+//# sourceMappingURL=networks.d.ts.map

package/dist/networks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"networks.d.ts","sourceRoot":"","sources":["../src/networks.ts"],"names":[],"mappings":"AAAA,oBAAY,QAAQ;IAClB,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,SAAS,SAAS;IAClB,GAAG,QAAQ;IACX,OAAO,QAAQ;IACf,KAAK,UAAU;IACf,IAAI,SAAS;IACb,KAAK,UAAU;IACf,KAAK,UAAU;IACf,KAAK,UAAU;IACf,SAAS,cAAc;IACvB,UAAU,eAAe;IACzB,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,QAAQ,QAAQ;IAChB,OAAO,YAAY;IACnB,QAAQ,KAAK;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,WAAW,gBAAgB;IAC3B,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,KAAK,UAAU;IACf,WAAW,gBAAgB;IAG3B,OAAO,WAAW;CACnB;AAED,eAAO,MAAM,wBAAwB,oBAAoB,CAAC"}

package/dist/utils.d.ts

@@ -0,0 +1,21 @@
+import type { Provider } from '@hub3js/core';
+import type { Chain } from '@hub3js/evm';
+import type { BlockchainMeta, EvmBlockchainMeta } from 'rango-types';
+type ChainSupport = {
+    isChainSupported: (chainId: string) => boolean;
+};
+export type EvmNetworksChainInfo = Record<string, Chain>;
+/**
+ * The chains of `allBlockChains` a single namespace can address. Chains that don't
+ * convert to CAIP are dropped rather than guessed at - see
+ * {@link convertBlockchainMetaToCaip}.
+ */
+export declare function getSupportedChainsFromNamespace(namespace: ChainSupport, allBlockChains: BlockchainMeta[] | undefined): BlockchainMeta[];
+/**
+ * The union of what every namespace of a provider supports, in `allBlockChains` order
+ * and without duplicates when two namespaces claim the same chain.
+ */
+export declare function getSupportedChainsFromProvider(provider: Provider, allBlockChains: BlockchainMeta[] | undefined): BlockchainMeta[];
+export declare function convertEvmBlockchainMetaToEvmChainInfo(evmBlockchains: EvmBlockchainMeta[]): EvmNetworksChainInfo;
+export {};
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAIrE,KAAK,YAAY,GAAG;IAClB,gBAAgB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAEzD;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,YAAY,EACvB,cAAc,EAAE,cAAc,EAAE,GAAG,SAAS,GAC3C,cAAc,EAAE,CAQlB;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,QAAQ,EAClB,cAAc,EAAE,cAAc,EAAE,GAAG,SAAS,GAC3C,cAAc,EAAE,CAoBlB;AASD,wBAAgB,sCAAsC,CACpD,cAAc,EAAE,iBAAiB,EAAE,GAClC,oBAAoB,CAetB"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@rango-dev/internal-blockchains",
+  "version": "0.1.1-next.0",
+  "license": "MIT",
+  "type": "module",
+  "source": "./src/mod.ts",
+  "main": "./dist/mod.js",
+  "typings": "dist/mod.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/mod.d.ts",
+      "default": "./dist/mod.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "yarn run rangutopia library build",
+    "ts-check": "tsc --declaration --emitDeclarationOnly -p ./tsconfig.json",
+    "clean": "rimraf dist",
+    "format": "prettier --write '{.,src}/**/*.{ts,tsx}'",
+    "lint": "eslint \"**/*.{ts,tsx}\"",
+    "test": "vitest",
+    "test:watch": "vitest --watch",
+    "test:coverage": "vitest run --coverage"
+  },
+  "dependencies": {
+    "@hub3js/core": "^0.61.1",
+    "@hub3js/evm": "^0.4.0",
+    "@hub3js/solana": "^0.4.0",
+    "@hub3js/starknet": "^0.3.0",
+    "@hub3js/stellar": "^0.3.0",
+    "@hub3js/sui": "^0.3.0",
+    "@hub3js/tvm": "^0.3.0",
+    "@hub3js/xrpl": "^0.3.0",
+    "@rango-dev/wallets-core": "^0.61.1-next.0",
+    "rango-types": "^0.5.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/readme.md

@@ -0,0 +1,34 @@
+# @rango-dev/internal-blockchains
+
+Translation between Rango's chain vocabulary (`BlockchainMeta`, `TransactionType`,
+`Networks`) and CAIP-2 chain ids.
+
+```ts
+import {
+  convertBlockchainMetaToCaip,
+  isBitcoinBlockchain,
+} from '@rango-dev/internal-blockchains';
+```
+
+## Why it is separate from `@hub3js/caip`
+
+Providers are moving to hub3js, which holds no Rango domain logic. Splitting the two
+puts that rule in the dependency graph rather than in review comments:
+
+| Provider code | Speaks | Imports |
+| --- | --- | --- |
+| `constants.ts`, `namespaces/`, `actions/`, `builders/`, `ProviderMetadata`, `isChainSupported` | CAIP-2 only | `@hub3js/caip` |
+| `signer.ts`, `signers/` | Rango names | this package |
+
+The first row is what moves; after the CAIP-2 chain-support refactor none of it knows a
+Rango chain name.
+
+The second row is a conscious exception. A signer implements `GenericSigner<Transfer>`
+from `rango-types`, so its input is a Rango transaction and `tx.asset.blockchain` is a
+Rango name — every provider already depends on `rango-types` for exactly this, and no
+signer moves to hub3js. The exception does not extend to resolving a name in provider
+setup, keying an instance map by name, or deciding chain support by name; those have
+CAIP equivalents.
+
+Nothing here may move to hub3js. Anything expressible without `rango-types` belongs in
+`@hub3js/caip` instead.

package/src/caip.ts

@@ -0,0 +1,196 @@
+import type { BlockchainMeta } from 'rango-types';
+
+import {
+  CAIP_ETHEREUM_CHAIN_ID,
+  CAIP_NAMESPACE as CAIP_EVM_NAMESPACE,
+} from '@hub3js/evm';
+import {
+  CAIP_SOLANA_CHAIN_ID,
+  CAIP_NAMESPACE as CAIP_SOLANA_NAMESPACE,
+} from '@hub3js/solana';
+import {
+  CAIP_STARKNET_CHAIN_ID,
+  CAIP_NAMESPACE as CAIP_STARKNET_NAMESPACE,
+} from '@hub3js/starknet';
+import {
+  CAIP_STELLAR_CHAIN_ID,
+  CAIP_NAMESPACE as CAIP_STELLAR_NAMESPACE,
+} from '@hub3js/stellar';
+import {
+  CAIP_SUI_CHAIN_ID,
+  CAIP_NAMESPACE as CAIP_SUI_NAMESPACE,
+} from '@hub3js/sui';
+import {
+  CAIP_TON_CHAIN_ID,
+  CAIP_NAMESPACE as CAIP_TVM_NAMESPACE,
+} from '@hub3js/tvm';
+import {
+  CAIP_XRPL_CHAIN_ID,
+  CAIP_NAMESPACE as CAIP_XRPL_NAMESPACE,
+} from '@hub3js/xrpl';
+import {
+  CAIP_TRON_CHAIN_ID,
+  CAIP_NAMESPACE as CAIP_TRON_NAMESPACE,
+} from '@rango-dev/wallets-core/namespaces/tron';
+import {
+  CAIP_BITCOIN_CHAIN_ID,
+  CAIP_BITCOINCASH_CHAIN_ID,
+  CAIP_DOGECOIN_CHAIN_ID,
+  CAIP_LITECOIN_CHAIN_ID,
+  CAIP_NAMESPACE as CAIP_UTXO_NAMESPACE,
+  CAIP_ZCASH_CHAIN_ID,
+} from '@rango-dev/wallets-core/namespaces/utxo';
+import { TransactionType } from 'rango-types';
+
+import { Networks } from './networks.js';
+
+/**
+ * A CAIP-2 chain id, e.g. `eip155:1` or `bip122:000000000019d6689c085ae165831e93`.
+ *
+ * @see https://github.com/ChainAgnostic/CAIPs/blob/main/CAIPs/caip-2.md
+ */
+export type CaipChainId = `${string}:${string}`;
+
+/** Pair a namespace with a reference here, not at call sites — that's where ids get crossed. */
+export const CAIP_CHAINS = {
+  BITCOIN: `${CAIP_UTXO_NAMESPACE}:${CAIP_BITCOIN_CHAIN_ID}`,
+  BITCOINCASH: `${CAIP_UTXO_NAMESPACE}:${CAIP_BITCOINCASH_CHAIN_ID}`,
+  DOGECOIN: `${CAIP_UTXO_NAMESPACE}:${CAIP_DOGECOIN_CHAIN_ID}`,
+  ETHEREUM: `${CAIP_EVM_NAMESPACE}:${CAIP_ETHEREUM_CHAIN_ID}`,
+  LITECOIN: `${CAIP_UTXO_NAMESPACE}:${CAIP_LITECOIN_CHAIN_ID}`,
+  SOLANA: `${CAIP_SOLANA_NAMESPACE}:${CAIP_SOLANA_CHAIN_ID}`,
+  STARKNET: `${CAIP_STARKNET_NAMESPACE}:${CAIP_STARKNET_CHAIN_ID}`,
+  STELLAR: `${CAIP_STELLAR_NAMESPACE}:${CAIP_STELLAR_CHAIN_ID}`,
+  SUI: `${CAIP_SUI_NAMESPACE}:${CAIP_SUI_CHAIN_ID}`,
+  TON: `${CAIP_TVM_NAMESPACE}:${CAIP_TON_CHAIN_ID}`,
+  TRON: `${CAIP_TRON_NAMESPACE}:${CAIP_TRON_CHAIN_ID}`,
+  XRPL: `${CAIP_XRPL_NAMESPACE}:${CAIP_XRPL_CHAIN_ID}`,
+  ZCASH: `${CAIP_UTXO_NAMESPACE}:${CAIP_ZCASH_CHAIN_ID}`,
+} as const satisfies Record<string, CaipChainId>;
+
+type BlockchainMetaForCaip = Pick<BlockchainMeta, 'type' | 'chainId' | 'name'>;
+
+const HEX_RADIX = 16;
+const DECIMAL_RADIX = 10;
+
+/**
+ * `TRANSFER` covers several UTXO chains and its meta `chainId` is always `null`, so
+ * these can only be keyed by name. This table is the one place in the wallet packages
+ * that has to know a Rango chain name — everywhere else works in CAIP-2 ids, which is
+ * why `Networks` shouldn't spread beyond it.
+ *
+ * DASH is knowingly absent: no CAIP constant and no provider supports it, so it
+ * converts to `null` and is dropped.
+ */
+const CAIP_BY_TRANSFER_BLOCKCHAIN_NAME: Record<string, CaipChainId> = {
+  [Networks.BCH]: CAIP_CHAINS.BITCOINCASH,
+  [Networks.BTC]: CAIP_CHAINS.BITCOIN,
+  [Networks.DOGE]: CAIP_CHAINS.DOGECOIN,
+  [Networks.LTC]: CAIP_CHAINS.LITECOIN,
+  [Networks.ZCASH]: CAIP_CHAINS.ZCASH,
+};
+
+/**
+ * `eip155` references are decimal but meta reports EVM chainIds as hex ('0xa86a'), and
+ * Hyperliquid reports a bare decimal ('1337') — so the prefix picks the radix, not the
+ * chain family.
+ */
+function toNumericCaip(
+  namespace: string,
+  chainId: string | null | undefined
+): CaipChainId | null {
+  if (!chainId) {
+    return null;
+  }
+
+  const isHex = /^0x[0-9a-f]+$/i.test(chainId);
+  const isDecimal = /^[0-9]+$/.test(chainId);
+
+  // `parseInt` stops at the first bad character, so '12abc' would become chain id '12'.
+  if (!isHex && !isDecimal) {
+    return null;
+  }
+
+  const reference = parseInt(chainId, isHex ? HEX_RADIX : DECIMAL_RADIX);
+
+  return Number.isSafeInteger(reference) ? `${namespace}:${reference}` : null;
+}
+
+type CaipResolver =
+  | CaipChainId
+  | ((blockchainMeta: BlockchainMetaForCaip) => CaipChainId | null)
+  | null;
+
+/**
+ * A total `Record` on purpose: a new `TransactionType` in rango-types fails to compile
+ * here instead of silently making that family invisible to every wallet.
+ */
+const CAIP_BY_TRANSACTION_TYPE: Record<TransactionType, CaipResolver> = {
+  /*
+   * Fixed ids, ignoring meta `chainId` — it is NOT the CAIP reference for several of
+   * these (meta reports Solana as 'mainnet-beta', Sui as 'sui-mainnet'), so deriving
+   * from it would produce ids that don't match the accounts providers report.
+   */
+  [TransactionType.SOLANA]: CAIP_CHAINS.SOLANA,
+  [TransactionType.STARKNET]: CAIP_CHAINS.STARKNET,
+  [TransactionType.STELLAR]: CAIP_CHAINS.STELLAR,
+  [TransactionType.SUI]: CAIP_CHAINS.SUI,
+  [TransactionType.TON]: CAIP_CHAINS.TON,
+  [TransactionType.TRON]: CAIP_CHAINS.TRON,
+  [TransactionType.XRPL]: CAIP_CHAINS.XRPL,
+
+  [TransactionType.EVM]: (blockchainMeta) =>
+    toNumericCaip(CAIP_EVM_NAMESPACE, blockchainMeta.chainId),
+
+  /*
+   * `eip155` so the wallets claiming the whole EVM family keep supporting Hyperliquid,
+   * as they did when they listed it by name. The reference is meta's 1337, NOT
+   * HyperEVM's real 999 — safe only because an `eip155` reference is never turned back
+   * into a chain id. Give Hyperliquid its own namespace before deriving a network
+   * switch or RPC target from this.
+   */
+  [TransactionType.HYPERLIQUID]: (blockchainMeta) =>
+    toNumericCaip(CAIP_EVM_NAMESPACE, blockchainMeta.chainId),
+
+  [TransactionType.TRANSFER]: (blockchainMeta) =>
+    CAIP_BY_TRANSFER_BLOCKCHAIN_NAME[blockchainMeta.name] ?? null,
+
+  // Not addressable — no namespace claims it, so no provider can match it.
+  [TransactionType.COSMOS]: null,
+};
+
+/**
+ * Convert a meta entry to its CAIP-2 chain id, so providers are handed CAIP rather than
+ * Rango names. `null` means "not addressable by CAIP" — callers should skip the chain
+ * rather than fall back to a name.
+ */
+export function convertBlockchainMetaToCaip(
+  blockchainMeta: BlockchainMetaForCaip
+): CaipChainId | null {
+  const resolver = CAIP_BY_TRANSACTION_TYPE[blockchainMeta.type];
+
+  if (!resolver) {
+    return null;
+  }
+
+  return typeof resolver === 'function' ? resolver(blockchainMeta) : resolver;
+}
+
+/**
+ * The name-level counterpart to {@link convertBlockchainMetaToCaip}: signers get
+ * `asset.blockchain` ('BTC'), not a chain id. Only `TRANSFER` names resolve.
+ */
+export function isTransferBlockchainName(
+  blockchainName: string,
+  caipChainId: CaipChainId
+): boolean {
+  return CAIP_BY_TRANSFER_BLOCKCHAIN_NAME[blockchainName] === caipChainId;
+}
+
+export function isBitcoinBlockchain(blockchainName: string): boolean {
+  return isTransferBlockchainName(blockchainName, CAIP_CHAINS.BITCOIN);
+}
+
+export function isZcashBlockchain(blockchainName: string): boolean {
+  return isTransferBlockchainName(blockchainName, CAIP_CHAINS.ZCASH);
+}

package/src/mod.ts

@@ -0,0 +1,3 @@
+export * from './networks.js';
+export * from './caip.js';
+export * from './utils.js';

package/src/networks.ts

@@ -0,0 +1,49 @@
+export enum Networks {
+  BTC = 'BTC',
+  BSC = 'BSC',
+  LTC = 'LTC',
+  THORCHAIN = 'THOR',
+  BCH = 'BCH',
+  BINANCE = 'BNB',
+  BLAST = 'BLAST',
+  CELO = 'CELO',
+  LINEA = 'LINEA',
+  METIS = 'METIS',
+  SONIC = 'SONIC',
+  BERACHAIN = 'BERACHAIN',
+  ZETA_CHAIN = 'ZETA_CHAIN',
+  SCROLL = 'SCROLL',
+  ZKSYNC = 'ZKSYNC',
+  MONAD = 'MONAD',
+  ETHEREUM = 'ETH',
+  POLYGON = 'POLYGON',
+  POLKADOT = '',
+  TRON = 'TRON',
+  DOGE = 'DOGE',
+  HARMONY = 'HARMONY',
+  AVAX_CCHAIN = 'AVAX_CCHAIN',
+  FANTOM = 'FANTOM',
+  MOONBEAM = 'MOONBEAM',
+  ARBITRUM = 'ARBITRUM',
+  BOBA = 'BOBA',
+  OPTIMISM = 'OPTIMISM',
+  FUSE = 'FUSE',
+  CRONOS = 'CRONOS',
+  SOLANA = 'SOLANA',
+  MOONRIVER = 'MOONRIVER',
+  GNOSIS = 'GNOSIS',
+  MAYA = 'MAYA',
+  STARKNET = 'STARKNET',
+  STELLAR = 'STELLAR',
+  TON = 'TON',
+  BASE = 'BASE',
+  SUI = 'SUI',
+  XRPL = 'XRPL',
+  ZCASH = 'ZCASH',
+  HYPERLIQUID = 'HYPERLIQUID',
+
+  // Using instead of null
+  Unknown = 'Unkown',
+}
+
+export const HYPERLIQUID_SIGN_NETWORK = Networks.ARBITRUM;

package/src/utils.ts

@@ -0,0 +1,84 @@
+import type { Provider } from '@hub3js/core';
+import type { Chain } from '@hub3js/evm';
+import type { BlockchainMeta, EvmBlockchainMeta } from 'rango-types';
+
+import { convertBlockchainMetaToCaip } from './caip.js';
+
+type ChainSupport = {
+  isChainSupported: (chainId: string) => boolean;
+};
+
+export type EvmNetworksChainInfo = Record<string, Chain>;
+
+/**
+ * The chains of `allBlockChains` a single namespace can address. Chains that don't
+ * convert to CAIP are dropped rather than guessed at - see
+ * {@link convertBlockchainMetaToCaip}.
+ */
+export function getSupportedChainsFromNamespace(
+  namespace: ChainSupport,
+  allBlockChains: BlockchainMeta[] | undefined
+): BlockchainMeta[] {
+  return (
+    allBlockChains?.filter((blockchain) => {
+      const chainId = convertBlockchainMetaToCaip(blockchain);
+
+      return chainId ? namespace.isChainSupported(chainId) : false;
+    }) ?? []
+  );
+}
+
+/**
+ * The union of what every namespace of a provider supports, in `allBlockChains` order
+ * and without duplicates when two namespaces claim the same chain.
+ */
+export function getSupportedChainsFromProvider(
+  provider: Provider,
+  allBlockChains: BlockchainMeta[] | undefined
+): BlockchainMeta[] {
+  const namespacesProperty = provider
+    .info()
+    ?.metadata.properties?.find((property) => property.name === 'namespaces');
+
+  return (
+    allBlockChains?.filter((blockchain) => {
+      const chainId = convertBlockchainMetaToCaip(blockchain);
+
+      if (!chainId) {
+        return false;
+      }
+
+      return (
+        namespacesProperty?.value.data.some((namespace) =>
+          namespace.isChainSupported(chainId)
+        ) ?? false
+      );
+    }) ?? []
+  );
+}
+
+/*
+ * TODO: remove this. It exists only so a provider can look a chain up by Rango's
+ * network name, which is knowledge a provider shouldn't carry — the caller already
+ * resolves the chain and should hand the provider an EIP-3085 description instead.
+ * Once every consumer does that, this table and the providers' dependency on
+ * Rango's chain model go away together.
+ */
+export function convertEvmBlockchainMetaToEvmChainInfo(
+  evmBlockchains: EvmBlockchainMeta[]
+): EvmNetworksChainInfo {
+  return evmBlockchains.reduce<EvmNetworksChainInfo>(
+    (evmNetworksChainInfo, blockchainMeta) => {
+      evmNetworksChainInfo[blockchainMeta.name] = {
+        chainName: blockchainMeta.info.chainName,
+        chainId: blockchainMeta.chainId,
+        nativeCurrency: blockchainMeta.info.nativeCurrency,
+        rpcUrls: blockchainMeta.info.rpcUrls,
+        blockExplorerUrls: blockchainMeta.info.blockExplorerUrls,
+      };
+
+      return evmNetworksChainInfo;
+    },
+    {}
+  );
+}