@avalabs/fusion-sdk 0.22.0 → 0.23.1

package/dist/utils/destination-chains.d.cts

@@ -0,0 +1,52 @@
+//#region src/utils/destination-chains.d.ts
+type ChainIdentifier = number | string;
+/**
+* Chain shape accepted by the destination chain sorting utilities.
+*
+* Supports Fusion `Chain` objects (`chainId`, `chainName`) and app-level chain
+* info objects (`universalChainId`, `name`).
+*/
+type DestinationChainSortInput = Readonly<{
+  chainId?: ChainIdentifier;
+  chainName?: string;
+  name?: string;
+  universalChainId?: ChainIdentifier;
+}> & ({
+  readonly chainId: ChainIdentifier;
+} | {
+  readonly universalChainId: ChainIdentifier;
+});
+/**
+* Returns the deterministic display priority for a destination chain.
+*
+* Lower values sort first. Numeric chain IDs are treated as EIP-155 IDs.
+*
+* Priority order:
+* C-Chain, P-Chain, X-Chain, Ethereum, Bitcoin/BVM, Solana, Base, Polygon, then unknown chains.
+*
+* @param chain - Chain object, CAIP-2 chain ID, or numeric EIP-155 chain ID to prioritize.
+* @returns Numeric priority used by {@link compareDestinationChains}.
+*/
+declare const getDestinationChainPriority: (chain: DestinationChainSortInput | ChainIdentifier) => number;
+/**
+* Compares two destination chains using shared Fusion SDK destination ordering.
+*
+* Sorts by priority first, then by display name, then by chain ID for a stable tie-breaker.
+*
+* @param a - First chain to compare.
+* @param b - Second chain to compare.
+* @returns Negative when `a` sorts first, positive when `b` sorts first, or zero when equivalent.
+*/
+declare const compareDestinationChains: <TChain extends DestinationChainSortInput>(a: TChain, b: TChain) => number;
+/**
+* Returns a new array of destination chains sorted with {@link compareDestinationChains}.
+*
+* The input array is not mutated.
+*
+* @param chains - Destination chains to sort.
+* @returns Sorted copy of the provided chains.
+*/
+declare const sortDestinationChains: <TChain extends DestinationChainSortInput>(chains: readonly TChain[]) => readonly TChain[];
+//#endregion
+export { DestinationChainSortInput, compareDestinationChains, getDestinationChainPriority, sortDestinationChains };
+//# sourceMappingURL=destination-chains.d.cts.map

package/dist/utils/destination-chains.d.ts

@@ -0,0 +1,52 @@
+//#region src/utils/destination-chains.d.ts
+type ChainIdentifier = number | string;
+/**
+* Chain shape accepted by the destination chain sorting utilities.
+*
+* Supports Fusion `Chain` objects (`chainId`, `chainName`) and app-level chain
+* info objects (`universalChainId`, `name`).
+*/
+type DestinationChainSortInput = Readonly<{
+  chainId?: ChainIdentifier;
+  chainName?: string;
+  name?: string;
+  universalChainId?: ChainIdentifier;
+}> & ({
+  readonly chainId: ChainIdentifier;
+} | {
+  readonly universalChainId: ChainIdentifier;
+});
+/**
+* Returns the deterministic display priority for a destination chain.
+*
+* Lower values sort first. Numeric chain IDs are treated as EIP-155 IDs.
+*
+* Priority order:
+* C-Chain, P-Chain, X-Chain, Ethereum, Bitcoin/BVM, Solana, Base, Polygon, then unknown chains.
+*
+* @param chain - Chain object, CAIP-2 chain ID, or numeric EIP-155 chain ID to prioritize.
+* @returns Numeric priority used by {@link compareDestinationChains}.
+*/
+declare const getDestinationChainPriority: (chain: DestinationChainSortInput | ChainIdentifier) => number;
+/**
+* Compares two destination chains using shared Fusion SDK destination ordering.
+*
+* Sorts by priority first, then by display name, then by chain ID for a stable tie-breaker.
+*
+* @param a - First chain to compare.
+* @param b - Second chain to compare.
+* @returns Negative when `a` sorts first, positive when `b` sorts first, or zero when equivalent.
+*/
+declare const compareDestinationChains: <TChain extends DestinationChainSortInput>(a: TChain, b: TChain) => number;
+/**
+* Returns a new array of destination chains sorted with {@link compareDestinationChains}.
+*
+* The input array is not mutated.
+*
+* @param chains - Destination chains to sort.
+* @returns Sorted copy of the provided chains.
+*/
+declare const sortDestinationChains: <TChain extends DestinationChainSortInput>(chains: readonly TChain[]) => readonly TChain[];
+//#endregion
+export { DestinationChainSortInput, compareDestinationChains, getDestinationChainPriority, sortDestinationChains };
+//# sourceMappingURL=destination-chains.d.ts.map

package/dist/utils/destination-chains.js

@@ -0,0 +1,2 @@
+import{AvalancheChainIds as e,AvalancheFujiBlockchainChainIds as t,AvalancheMainnetBlockchainChainIds as n,BaseChainIds as r,BitcoinChainIds as i,EthereumChainIds as a,PolygonChainIds as o,SolanaChainIds as s}from"../constants.js";const c=e=>typeof e==`number`?`eip155:${e}`:e,l=e=>{let t=e.universalChainId??e.chainId;return t===void 0?``:c(t)},u=(e,t=l(e))=>e.name??e.chainName??t,d=t=>t===e.MAINNET||t===e.FUJI,f=e=>e===n.P||e===t.P,p=e=>e===n.X||e===t.X,m=e=>e===a.MAINNET||e===a.SEPOLIA,h=e=>e===i.MAINNET||e===i.TESTNET,g=e=>e===s.MAINNET||e===s.DEVNET,_=e=>e===r.MAINNET||e===r.SEPOLIA,v=e=>e===o.MAINNET||e===o.AMOY,y=e=>{let t=typeof e==`object`?l(e):c(e);return d(t)?0:f(t)?1:p(t)?2:m(t)?3:h(t)?4:g(t)?5:_(t)?6:v(t)?7:8},b=(e,t)=>e===t?0:e<t?-1:1,x=(e,t)=>{let n=l(e),r=l(t),i=y(n)-y(r);if(i!==0)return i;let a=u(e,n).localeCompare(u(t,r),`en-US`);return a===0?b(n,r):a},S=e=>[...e].sort(x);export{x as compareDestinationChains,y as getDestinationChainPriority,S as sortDestinationChains};
+//# sourceMappingURL=destination-chains.js.map

package/dist/utils/destination-chains.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"destination-chains.js","names":[],"sources":["../../src/utils/destination-chains.ts"],"sourcesContent":["import {\n  AvalancheChainIds,\n  AvalancheFujiBlockchainChainIds,\n  AvalancheMainnetBlockchainChainIds,\n  BaseChainIds,\n  BitcoinChainIds,\n  EthereumChainIds,\n  PolygonChainIds,\n  SolanaChainIds,\n} from '../constants';\n\ntype ChainIdentifier = number | string;\n\n/**\n * Chain shape accepted by the destination chain sorting utilities.\n *\n * Supports Fusion `Chain` objects (`chainId`, `chainName`) and app-level chain\n * info objects (`universalChainId`, `name`).\n */\nexport type DestinationChainSortInput = Readonly<{\n  chainId?: ChainIdentifier;\n  chainName?: string;\n  name?: string;\n  universalChainId?: ChainIdentifier;\n}> &\n  ({ readonly chainId: ChainIdentifier } | { readonly universalChainId: ChainIdentifier });\n\nconst DESTINATION_CHAIN_SORT_LOCALE = 'en-US';\n\nconst asCaip2ChainId = (chainId: ChainIdentifier): string => {\n  return typeof chainId === 'number' ? `eip155:${chainId}` : chainId;\n};\n\nconst getDestinationChainId = (chain: DestinationChainSortInput): string => {\n  const chainId = chain.universalChainId ?? chain.chainId;\n\n  return chainId === undefined ? '' : asCaip2ChainId(chainId);\n};\n\nconst getDestinationChainName = (chain: DestinationChainSortInput, chainId = getDestinationChainId(chain)): string => {\n  return chain.name ?? chain.chainName ?? chainId;\n};\n\nconst isCChainId = (chainId: string): boolean => {\n  return chainId === AvalancheChainIds.MAINNET || chainId === AvalancheChainIds.FUJI;\n};\n\nconst isPChainId = (chainId: string): boolean => {\n  return chainId === AvalancheMainnetBlockchainChainIds.P || chainId === AvalancheFujiBlockchainChainIds.P;\n};\n\nconst isXChainId = (chainId: string): boolean => {\n  return chainId === AvalancheMainnetBlockchainChainIds.X || chainId === AvalancheFujiBlockchainChainIds.X;\n};\n\nconst isEthereumChainId = (chainId: string): boolean => {\n  return chainId === EthereumChainIds.MAINNET || chainId === EthereumChainIds.SEPOLIA;\n};\n\nconst isBitcoinChainId = (chainId: string): boolean => {\n  return chainId === BitcoinChainIds.MAINNET || chainId === BitcoinChainIds.TESTNET;\n};\n\nconst isSolanaChainId = (chainId: string): boolean => {\n  return chainId === SolanaChainIds.MAINNET || chainId === SolanaChainIds.DEVNET;\n};\n\nconst isBaseChainId = (chainId: string): boolean => {\n  return chainId === BaseChainIds.MAINNET || chainId === BaseChainIds.SEPOLIA;\n};\n\nconst isPolygonChainId = (chainId: string): boolean => {\n  return chainId === PolygonChainIds.MAINNET || chainId === PolygonChainIds.AMOY;\n};\n\n/**\n * Returns the deterministic display priority for a destination chain.\n *\n * Lower values sort first. Numeric chain IDs are treated as EIP-155 IDs.\n *\n * Priority order:\n * C-Chain, P-Chain, X-Chain, Ethereum, Bitcoin/BVM, Solana, Base, Polygon, then unknown chains.\n *\n * @param chain - Chain object, CAIP-2 chain ID, or numeric EIP-155 chain ID to prioritize.\n * @returns Numeric priority used by {@link compareDestinationChains}.\n */\nexport const getDestinationChainPriority = (chain: DestinationChainSortInput | ChainIdentifier): number => {\n  const chainId = typeof chain === 'object' ? getDestinationChainId(chain) : asCaip2ChainId(chain);\n\n  if (isCChainId(chainId)) {\n    return 0;\n  }\n  if (isPChainId(chainId)) {\n    return 1;\n  }\n  if (isXChainId(chainId)) {\n    return 2;\n  }\n  if (isEthereumChainId(chainId)) {\n    return 3;\n  }\n  if (isBitcoinChainId(chainId)) {\n    return 4;\n  }\n  if (isSolanaChainId(chainId)) {\n    return 5;\n  }\n  if (isBaseChainId(chainId)) {\n    return 6;\n  }\n  if (isPolygonChainId(chainId)) {\n    return 7;\n  }\n\n  return 8;\n};\n\nconst compareLexically = (a: string, b: string): number => (a === b ? 0 : a < b ? -1 : 1);\n\n/**\n * Compares two destination chains using shared Fusion SDK destination ordering.\n *\n * Sorts by priority first, then by display name, then by chain ID for a stable tie-breaker.\n *\n * @param a - First chain to compare.\n * @param b - Second chain to compare.\n * @returns Negative when `a` sorts first, positive when `b` sorts first, or zero when equivalent.\n */\nexport const compareDestinationChains = <TChain extends DestinationChainSortInput>(a: TChain, b: TChain): number => {\n  const aChainId = getDestinationChainId(a);\n  const bChainId = getDestinationChainId(b);\n  const priorityDifference = getDestinationChainPriority(aChainId) - getDestinationChainPriority(bChainId);\n\n  if (priorityDifference !== 0) {\n    return priorityDifference;\n  }\n\n  // Names are user-facing labels, so locale-aware ordering is still appropriate here.\n  const nameDifference = getDestinationChainName(a, aChainId).localeCompare(\n    getDestinationChainName(b, bChainId),\n    DESTINATION_CHAIN_SORT_LOCALE,\n  );\n\n  if (nameDifference !== 0) {\n    return nameDifference;\n  }\n\n  // Chain IDs are technical identifiers, so use raw lexical ordering for a deterministic final tie-breaker.\n  return compareLexically(aChainId, bChainId);\n};\n\n/**\n * Returns a new array of destination chains sorted with {@link compareDestinationChains}.\n *\n * The input array is not mutated.\n *\n * @param chains - Destination chains to sort.\n * @returns Sorted copy of the provided chains.\n */\nexport const sortDestinationChains = <TChain extends DestinationChainSortInput>(\n  chains: readonly TChain[],\n): readonly TChain[] => {\n  return [...chains].sort(compareDestinationChains);\n};\n"],"mappings":"uOA2BA,MAEM,EAAkB,GACf,OAAO,GAAY,SAAW,UAAU,IAAY,EAGvD,EAAyB,GAA6C,CAC1E,IAAM,EAAU,EAAM,kBAAoB,EAAM,QAEhD,OAAO,IAAY,IAAA,GAAY,GAAK,EAAe,EAAQ,EAGvD,GAA2B,EAAkC,EAAU,EAAsB,EAAM,GAChG,EAAM,MAAQ,EAAM,WAAa,EAGpC,EAAc,GACX,IAAY,EAAkB,SAAW,IAAY,EAAkB,KAG1E,EAAc,GACX,IAAY,EAAmC,GAAK,IAAY,EAAgC,EAGnG,EAAc,GACX,IAAY,EAAmC,GAAK,IAAY,EAAgC,EAGnG,EAAqB,GAClB,IAAY,EAAiB,SAAW,IAAY,EAAiB,QAGxE,EAAoB,GACjB,IAAY,EAAgB,SAAW,IAAY,EAAgB,QAGtE,EAAmB,GAChB,IAAY,EAAe,SAAW,IAAY,EAAe,OAGpE,EAAiB,GACd,IAAY,EAAa,SAAW,IAAY,EAAa,QAGhE,EAAoB,GACjB,IAAY,EAAgB,SAAW,IAAY,EAAgB,KAc/D,EAA+B,GAA+D,CACzG,IAAM,EAAU,OAAO,GAAU,SAAW,EAAsB,EAAM,CAAG,EAAe,EAAM,CA2BhG,OAzBI,EAAW,EAAQ,CACd,EAEL,EAAW,EAAQ,CACd,EAEL,EAAW,EAAQ,CACd,EAEL,EAAkB,EAAQ,CACrB,EAEL,EAAiB,EAAQ,CACpB,EAEL,EAAgB,EAAQ,CACnB,EAEL,EAAc,EAAQ,CACjB,EAEL,EAAiB,EAAQ,CACpB,EAGF,GAGH,GAAoB,EAAW,IAAuB,IAAM,EAAI,EAAI,EAAI,EAAI,GAAK,EAW1E,GAAsE,EAAW,IAAsB,CAClH,IAAM,EAAW,EAAsB,EAAE,CACnC,EAAW,EAAsB,EAAE,CACnC,EAAqB,EAA4B,EAAS,CAAG,EAA4B,EAAS,CAExG,GAAI,IAAuB,EACzB,OAAO,EAIT,IAAM,EAAiB,EAAwB,EAAG,EAAS,CAAC,cAC1D,EAAwB,EAAG,EAAS,CACpC,QACD,CAOD,OALI,IAAmB,EAKhB,EAAiB,EAAU,EAAS,CAJlC,GAeE,EACX,GAEO,CAAC,GAAG,EAAO,CAAC,KAAK,EAAyB"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@avalabs/fusion-sdk",
   "license": "Limited Ecosystem License",
-  "version": "0.22.0",
+  "version": "0.23.1",
   "type": "module",
   "main": "./dist/mod.cjs",
   "module": "./dist/mod.js",