@gibs/bridge-sdk 1.10.1 → 1.12.0

package/src/config.ts

@@ -1,6 +1,6 @@
-import { getAddress, keccak256, stringToHex, zeroAddress, type Hex } from "viem";
-import _ from 'lodash'
-import type { BridgeKey, Token, TokenOut } from "./types.js";
+import _ from 'lodash';
+import { getAddress, type Hex, keccak256, stringToHex, zeroAddress } from 'viem';
+import type { BridgeKey, Token, TokenOut } from './types.js';
 
 /**
  * Add here your chain id as hex, be sure to add your chain in the chainsMetadata object too
@@ -16,26 +16,26 @@ export enum Chains {
 }
 
 /** The key of a chain - human readable for query params */
-export type ChainKey = keyof typeof Chains
+export type ChainKey = keyof typeof Chains;
 
 /** A map of chain ids to chain keys */
 export const chainIdToKey = new Map<Chains, ChainKey>(
   Object.entries(Chains).map(([key, chain]) => [chain, key] as [Chains, ChainKey]),
-)
+);
 
 /**
  * Converts a chain id to a chain key
  * @param chainId - the chain id
  * @returns the chain key
  */
-export const toChain = (chainId: number | string) => `0x${Number(chainId).toString(16)}` as Chains
+export const toChain = (chainId: number | string) => `0x${Number(chainId).toString(16)}` as Chains;
 
 /**
  * Converts a chain id to a chain key
  * @param chainId - the chain id
  * @returns the chain key
  */
-export const toChainKey = (chainId: number | string) => chainIdToKey.get(toChain(chainId))
+export const toChainKey = (chainId: number | string) => chainIdToKey.get(toChain(chainId));
 
 // /** The provider of an omnibridge */
 // export enum Provider {
@@ -43,13 +43,12 @@ export const toChainKey = (chainId: number | string) => chainIdToKey.get(toChain
 //   TOKENSEX = 'tokensex',
 // }
 
-
 export const Providers = {
   PULSECHAIN: 'pulsechain',
   TOKENSEX: 'tokensex',
-} as const
+} as const;
 
-export type Provider = typeof Providers[keyof typeof Providers]
+export type Provider = (typeof Providers)[keyof typeof Providers];
 
 /** A map of chains to native asset out addresses */
 export const nativeAssetOut = {
@@ -58,12 +57,12 @@ export const nativeAssetOut = {
   [Chains.PLS]: '0xA1077a294dDE1B09bB078844df40758a5D0f9a27',
   [Chains.SEP]: '0x7b79995e5f793A07Bc00c21412e50Ecae098E7f9',
   [Chains.V4PLS]: '0x70499adEBB11Efd915E3b69E700c331778628707',
-} as Record<Chains, Hex>
+} as Record<Chains, Hex>;
 
 /** A map of chains to deprecated native asset out addresses */
 export const deprecatedNativeAssetOut = {
   [Chains.PLS]: new Set(['0x97Ac4a2439A47c07ad535bb1188c989dae755341']),
-} as Partial<Record<Chains, Set<Hex>>>
+} as Partial<Record<Chains, Set<Hex>>>;
 
 /** A map of chains to uni v2 router addresses */
 export const uniV2Routers = {
@@ -78,7 +77,7 @@ export const uniV2Routers = {
     '0xDaE9dd3d1A52CfCe9d5F2fAC7fDe164D500E50f7',
     '0x636f6407B90661b73b1C0F7e24F4C79f624d0738',
   ],
-} as Record<Chains, Hex[]>
+} as Record<Chains, Hex[]>;
 
 /** A map of chains to native token symbols */
 export const nativeTokenSymbol = {
@@ -87,7 +86,7 @@ export const nativeTokenSymbol = {
   [Chains.ETH]: 'ETH',
   [Chains.SEP]: 'sepETH',
   [Chains.BNB]: 'BNB',
-} as Record<Chains, string>
+} as Record<Chains, string>;
 
 /** A map of chains to native token names */
 export const nativeTokenName = {
@@ -96,29 +95,29 @@ export const nativeTokenName = {
   [Chains.ETH]: 'Ether',
   [Chains.SEP]: 'Sepolia Ether',
   [Chains.BNB]: 'BNB',
-} as Record<Chains, string>
+} as Record<Chains, string>;
 
 /** The pathway of a bridge */
 export type Pathway = {
-  from: Hex
-  to: Hex
-  destinationRouter: Hex | null
-  nativeRouter: Hex
-  validator: Hex
+  from: Hex;
+  to: Hex;
+  destinationRouter: Hex | null;
+  nativeRouter: Hex;
+  validator: Hex;
   // defaultAssetIn: Token
-  usesExtraParam: boolean
-  feeManager: 'from' | 'to'
-  toHome: boolean
-  requiresDelivery: boolean
-  bridgedNativeAssetOut: Hex
-  settingOverrides?: Record<Hex, Partial<Pathway>>
-}
+  usesExtraParam: boolean;
+  feeManager: 'from' | 'to';
+  toHome: boolean;
+  requiresDelivery: boolean;
+  bridgedNativeAssetOut: Hex;
+  settingOverrides?: Record<Hex, Partial<Pathway>>;
+};
 
 /** A map of providers to pathways */
 export type DeepPathwayConfig = Record<
   Provider,
   Partial<Record<Chains, Partial<Record<Chains, Pathway>>>>
->
+>;
 
 /** The settings for the pulsechain pls eth pathway */
 const pulsechainPLSETHSettings = {
@@ -126,7 +125,7 @@ const pulsechainPLSETHSettings = {
   to: '0xe20E337DB2a00b1C37139c873B92a0AAd3F468bF',
   destinationRouter: '0x1F0144Ce3BDaf11944Fe0beF6444599a0500695B',
   nativeRouter: '0xE66877Cfe4CEc10ffBbBB3092B7001321AB5809D',
-}
+};
 
 export const pathways = {
   [Providers.PULSECHAIN]: {
@@ -205,7 +204,7 @@ export const pathways = {
       },
     },
   },
-} as DeepPathwayConfig
+} as DeepPathwayConfig;
 
 export const testnetPathways = {
   [Providers.TOKENSEX]: {
@@ -261,7 +260,7 @@ export const testnetPathways = {
       },
     },
   },
-} as DeepPathwayConfig
+} as DeepPathwayConfig;
 
 /** The mainnet bridge keys */
 const mainnetBridgeKeys = [
@@ -269,19 +268,19 @@ const mainnetBridgeKeys = [
   [Providers.PULSECHAIN, Chains.ETH, Chains.PLS],
   [Providers.TOKENSEX, Chains.PLS, Chains.BNB],
   [Providers.TOKENSEX, Chains.BNB, Chains.PLS],
-] as BridgeKey[]
+] as BridgeKey[];
 
 /** The testnet bridge keys */
 const testnetBridgeKeys = [
   [Providers.PULSECHAIN, Chains.SEP, Chains.V4PLS],
   [Providers.PULSECHAIN, Chains.V4PLS, Chains.SEP],
-] as BridgeKey[]
+] as BridgeKey[];
 
 /** Returns the valid bridge keys for the given is prod */
 export const validBridgeKeys = (isProd: boolean) => [
   ...mainnetBridgeKeys,
   ...(isProd ? [] : testnetBridgeKeys),
-]
+];
 
 /**
  * Infers the bridge key from the current key, provider, from chain, and to chain
@@ -297,24 +296,24 @@ export const inferBridgeKey = ({
   fromChain,
   toChain,
 }: {
-  currentKey: BridgeKey
-  provider: Provider
-  fromChain?: Chains
-  toChain?: Chains
+  currentKey: BridgeKey;
+  provider: Provider;
+  fromChain?: Chains;
+  toChain?: Chains;
 }) => {
-  const [, fromChainKey, toChainKey] = currentKey
-  const from = fromChain ?? fromChainKey
-  const to = toChain ?? toChainKey
-  const currentFromChainIsValid = !!_.get(pathways, [provider, from])
+  const [, fromChainKey, toChainKey] = currentKey;
+  const from = fromChain ?? fromChainKey;
+  const to = toChain ?? toChainKey;
+  const currentFromChainIsValid = !!_.get(pathways, [provider, from]);
   const nextFromChain = currentFromChainIsValid
     ? from
-    : (Object.keys(pathways[provider])[0] as Chains)
-  const currentToChainIsValid = !!_.get(pathways, [provider, nextFromChain, to])
+    : (Object.keys(pathways[provider])[0] as Chains);
+  const currentToChainIsValid = !!_.get(pathways, [provider, nextFromChain, to]);
   const nextToChain = currentToChainIsValid
     ? to
-    : (Object.keys(pathways[provider]![nextFromChain]!)[0] as Chains)
-  return [provider, nextFromChain, nextToChain] as BridgeKey
-}
+    : (Object.keys(pathways[provider]![nextFromChain]!)[0] as Chains);
+  return [provider, nextFromChain, nextToChain] as BridgeKey;
+};
 
 /**
  * Returns the pathway for the given bridge key, is prod, and asset in address
@@ -323,20 +322,25 @@ export const inferBridgeKey = ({
  * @param assetInAddress - the asset in address
  * @returns the pathway
  */
-export const pathway = (bridgeKey: BridgeKey | null, isProd: boolean, assetInAddress?: string | Hex | null | undefined) => {
-  if (!bridgeKey) return
-  let pathway = _.get(pathways, bridgeKey) || (!isProd ? _.get(testnetPathways, bridgeKey) : undefined)
+export const pathway = (
+  bridgeKey: BridgeKey | null,
+  isProd: boolean,
+  assetInAddress?: string | Hex | null | undefined,
+) => {
+  if (!bridgeKey) return;
+  let pathway =
+    _.get(pathways, bridgeKey) || (!isProd ? _.get(testnetPathways, bridgeKey) : undefined);
   if (assetInAddress) {
-    const addr = getAddress(assetInAddress)
+    const addr = getAddress(assetInAddress);
     if (pathway?.settingOverrides?.[addr]) {
       pathway = {
         ...pathway,
         ...pathway.settingOverrides[addr],
-      }
+      };
     }
   }
-  return pathway
-}
+  return pathway;
+};
 
 /**
  * Returns the default asset in for the given bridge key and is prod
@@ -345,11 +349,11 @@ export const pathway = (bridgeKey: BridgeKey | null, isProd: boolean, assetInAdd
  * @returns the default asset in
  */
 export const defaultAssetIn = ($bridgeKey: BridgeKey | null, isProd: boolean) => {
-  if (!$bridgeKey) return null
-  const conf = pathway($bridgeKey, isProd)
-  const defaultAssetIn = _.get(conf, ['bridgedNativeAssetOut']) as Hex | undefined
-  return defaultAssetIn
-}
+  if (!$bridgeKey) return null;
+  const conf = pathway($bridgeKey, isProd);
+  const defaultAssetIn = _.get(conf, ['bridgedNativeAssetOut']) as Hex | undefined;
+  return defaultAssetIn;
+};
 
 /**
  * Returns whether the given asset is the native asset for the given bridge key
@@ -359,16 +363,16 @@ export const defaultAssetIn = ($bridgeKey: BridgeKey | null, isProd: boolean) =>
  */
 export const isNative = (asset: Token | TokenOut | null, bridgeKey: BridgeKey | null) => {
   if (!bridgeKey || !asset) {
-    return false
+    return false;
   }
-  const path = pathway(bridgeKey, false)
+  const path = pathway(bridgeKey, false);
   return (
     getAddress(asset.address!) === getAddress(path!.bridgedNativeAssetOut!) ||
-    (asset.address === zeroAddress ||
+    ((asset.address === zeroAddress ||
       nativeAssetOut[toChain(asset.chainId)]?.toLowerCase() === asset.address?.toLowerCase()) &&
-    !asset.name.includes(' from Pulsechain')
-  )
-}
+      !asset.name.includes(' from Pulsechain'))
+  );
+};
 
 /**
  * Returns whether the given asset is unwrappable for the given bridge key
@@ -381,13 +385,13 @@ export const isUnwrappable = (
   assetIn: Pick<Token, 'address'> | null,
 ) => {
   if (!bridgeKey || !assetIn) {
-    return false
+    return false;
   }
-  const addr = getAddress(assetIn.address)
-  const path = pathway(bridgeKey, false)
-  if (!path) return false
-  return path.bridgedNativeAssetOut === getAddress(addr)
-}
+  const addr = getAddress(assetIn.address);
+  const path = pathway(bridgeKey, false);
+  if (!path) return false;
+  return path.bridgedNativeAssetOut === getAddress(addr);
+};
 
 /**
  * Returns whether the given asset can be unwrapped for the given bridge key
@@ -396,8 +400,8 @@ export const isUnwrappable = (
  * @returns boolean
  */
 export const canChangeUnwrap = (bridgeKey: BridgeKey, assetIn: Token | null) => {
-  return !!assetIn && isUnwrappable(bridgeKey, assetIn)
-}
+  return !!assetIn && isUnwrappable(bridgeKey, assetIn);
+};
 
 export const chains = {
   ethereum: 1,
@@ -405,15 +409,24 @@ export const chains = {
   pulsechain: 369,
   pulsechainV4: 943,
   sepolia: 11155111,
-} as const
+} as const;
+
+export const chainIds = Object.values(chains);
 
-export const chainIds = Object.values(chains)
+/** Start blocks aligned with when bridge validators began operating — canonical reference for all ponder indexers in this monorepo. */
+export const startBlocks: Record<keyof typeof chains, number> = {
+  ethereum: 17_264_119,
+  bsc: 28_987_313,
+  pulsechain: 17_268_300,
+  pulsechainV4: 16_564_233,
+  sepolia: 3_331_901,
+};
 
-export type ChainId = (typeof chainIds)[number]
+export type ChainId = (typeof chainIds)[number];
 
-export type Side = 'home' | 'foreign'
+export type Side = 'home' | 'foreign';
 
-export type MinimalKey = `${ChainId}-${Hex}`
+export type MinimalKey = `${ChainId}-${Hex}`;
 
 // export const Providers = {
 //   PULSECHAIN: 'pulsechain',
@@ -421,60 +434,67 @@ export type MinimalKey = `${ChainId}-${Hex}`
 // } as const
 
 export type PathwayInfo = {
-  pair: string
-  key: string
-  home: Hex
-  foreign: Hex
-}
+  pair: string;
+  key: string;
+  home: Hex;
+  foreign: Hex;
+};
 
-export type ProviderHomeChainEntry = Partial<Record<ChainId, PathwayInfo[]>>
+export type ProviderHomeChainEntry = Partial<Record<ChainId, PathwayInfo[]>>;
 
-export type ProviderEntries = Partial<Record<ChainId, ProviderHomeChainEntry>>
+export type ProviderEntries = Partial<Record<ChainId, ProviderHomeChainEntry>>;
 
-export type BridgeConfig = Record<Provider, ProviderEntries>
+export type BridgeConfig = Record<Provider, ProviderEntries>;
 
 // provider -> home -> foreign
 export const bridgeConfigs = {
   [Providers.PULSECHAIN]: {
     [chains.pulsechain]: {
-      [chains.ethereum]: [{
-        pair: 'mainnet',
-        key: 'erc20',
-        home: '0x4fD0aaa7506f3d9cB8274bdB946Ec42A1b8751Ef',
-        foreign: '0x1715a3e4a142d8b698131108995174f37aeba10d',
-      }, {
-        pair: 'mainnet',
-        key: 'native',
-        home: '0x0e18d0d556b652794EF12Bf68B2dC857EF5f3996',
-        foreign: '0xe20E337DB2a00b1C37139c873B92a0AAd3F468bF',
-      }],
+      [chains.ethereum]: [
+        {
+          pair: 'mainnet',
+          key: 'erc20',
+          home: '0x4fD0aaa7506f3d9cB8274bdB946Ec42A1b8751Ef',
+          foreign: '0x1715a3e4a142d8b698131108995174f37aeba10d',
+        },
+        {
+          pair: 'mainnet',
+          key: 'native',
+          home: '0x0e18d0d556b652794EF12Bf68B2dC857EF5f3996',
+          foreign: '0xe20E337DB2a00b1C37139c873B92a0AAd3F468bF',
+        },
+      ],
     },
     [chains.pulsechainV4]: {
-      [chains.sepolia]: [{
-        pair: 'v4',
-        key: 'erc20',
-        home: '0x6B08a50865aDeCe6e3869D9AfbB316d0a0436B6c',
-        foreign: '0x546e37DAA15cdb82fd1a717E5dEEa4AF08D4349A',
-      }, {
-        pair: 'v4',
-        key: 'native',
-        home: '0x81c10846F40fA2B173FC47958D0a892529983F50',
-        foreign: '0x5e238ef968467cf443ef5ecb683b76c5a04a0421',
-      }],
+      [chains.sepolia]: [
+        {
+          pair: 'v4',
+          key: 'erc20',
+          home: '0x6B08a50865aDeCe6e3869D9AfbB316d0a0436B6c',
+          foreign: '0x546e37DAA15cdb82fd1a717E5dEEa4AF08D4349A',
+        },
+        {
+          pair: 'v4',
+          key: 'native',
+          home: '0x81c10846F40fA2B173FC47958D0a892529983F50',
+          foreign: '0x5e238ef968467cf443ef5ecb683b76c5a04a0421',
+        },
+      ],
     },
   },
   [Providers.TOKENSEX]: {
     [chains.pulsechain]: {
-      [chains.bsc]: [{
-        pair: 'bsctokensex',
-        key: 'erc20',
-        home: '0xf1DFc63e10fF01b8c3d307529b47AefaD2154C0e',
-        foreign: '0xb4005881e81a6ecd2c1f75d58e8e41f28d59c6b1',
-      }],
+      [chains.bsc]: [
+        {
+          pair: 'bsctokensex',
+          key: 'erc20',
+          home: '0xf1DFc63e10fF01b8c3d307529b47AefaD2154C0e',
+          foreign: '0xb4005881e81a6ecd2c1f75d58e8e41f28d59c6b1',
+        },
+      ],
     },
   },
-} as BridgeConfig
-
+} as BridgeConfig;
 
-export const HOME_TO_FOREIGN_FEE = keccak256(stringToHex("homeToForeignFee"))
-export const FOREIGN_TO_HOME_FEE = keccak256(stringToHex("foreignToHomeFee"))
+export const HOME_TO_FOREIGN_FEE = keccak256(stringToHex('homeToForeignFee'));
+export const FOREIGN_TO_HOME_FEE = keccak256(stringToHex('foreignToHomeFee'));

package/src/fee-type.test.ts

@@ -0,0 +1,45 @@
+import { describe, expect, it } from 'vitest';
+import { FeeType, feeTypeValToKeyMap } from './fee-type';
+
+describe('fee-type', () => {
+  describe('FeeType enum', () => {
+    it('should have PERCENT fee type', () => {
+      expect(FeeType.PERCENT).toBe('%');
+    });
+
+    it('should have GAS_TIP fee type', () => {
+      expect(FeeType.GAS_TIP).toBe('gas+%');
+    });
+
+    it('should have FIXED fee type', () => {
+      expect(FeeType.FIXED).toBe('fixed');
+    });
+
+    it('should have exactly 3 fee types', () => {
+      const keys = Object.keys(FeeType);
+      expect(keys).toHaveLength(3);
+    });
+  });
+
+  describe('feeTypeValToKeyMap', () => {
+    it('should map PERCENT value to key', () => {
+      expect(feeTypeValToKeyMap.get(FeeType.PERCENT)).toBe('PERCENT');
+    });
+
+    it('should map GAS_TIP value to key', () => {
+      expect(feeTypeValToKeyMap.get(FeeType.GAS_TIP)).toBe('GAS_TIP');
+    });
+
+    it('should map FIXED value to key', () => {
+      expect(feeTypeValToKeyMap.get(FeeType.FIXED)).toBe('FIXED');
+    });
+
+    it('should map all fee type values to keys', () => {
+      expect(feeTypeValToKeyMap.size).toBe(3);
+    });
+
+    it('should return undefined for invalid fee type', () => {
+      expect(feeTypeValToKeyMap.get('invalid' as FeeType)).toBeUndefined();
+    });
+  });
+});

package/src/fee-type.ts

@@ -6,9 +6,9 @@ export enum FeeType {
 }
 
 /** The keys of the fee type */
-export type FeeTypeKeys = keyof typeof FeeType
+export type FeeTypeKeys = keyof typeof FeeType;
 
 /** A map of fee type values to keys */
 export const feeTypeValToKeyMap = new Map<FeeType, FeeTypeKeys>(
   (Object.keys(FeeType) as FeeTypeKeys[]).map((key) => [FeeType[key], key]),
-)
+);

package/src/image-links.test.ts

@@ -0,0 +1,160 @@
+import { beforeEach, describe, expect, it } from 'vitest';
+import { getImageRoot, image, images, list, network, setImageRoot } from './image-links';
+
+describe('image-links', () => {
+  beforeEach(() => {
+    // Reset to default before each test
+    setImageRoot('https://gib.show');
+  });
+
+  describe('setImageRoot and getImageRoot', () => {
+    it('should have default image root', () => {
+      expect(getImageRoot()).toBe('https://gib.show');
+    });
+
+    it('should update image root', () => {
+      setImageRoot('https://custom.domain');
+      expect(getImageRoot()).toBe('https://custom.domain');
+    });
+
+    it('should affect all subsequent URL generations', () => {
+      setImageRoot('https://test.com');
+      expect(list('/tokens')).toBe('https://test.com/list/tokens');
+      expect(network(1)).toBe('https://test.com/image/1');
+    });
+  });
+
+  describe('list', () => {
+    it('should generate list URL with path', () => {
+      expect(list('/pulsex')).toBe('https://gib.show/list/pulsex');
+    });
+
+    it('should handle paths without leading slash', () => {
+      expect(list('tokens')).toBe('https://gib.show/listtokens');
+    });
+
+    it('should handle paths with query params', () => {
+      expect(list('/pulsechain-bridge/foreign?extensions=bridgeInfo')).toBe(
+        'https://gib.show/list/pulsechain-bridge/foreign?extensions=bridgeInfo',
+      );
+    });
+
+    it('should handle empty path', () => {
+      expect(list('')).toBe('https://gib.show/list');
+    });
+  });
+
+  describe('network', () => {
+    it('should generate network image URL for Ethereum', () => {
+      expect(network(1)).toBe('https://gib.show/image/1');
+    });
+
+    it('should generate network image URL for PulseChain', () => {
+      expect(network(369)).toBe('https://gib.show/image/369');
+    });
+
+    it('should generate network image URL for BSC', () => {
+      expect(network(56)).toBe('https://gib.show/image/56');
+    });
+
+    it('should convert string numbers to number', () => {
+      expect(network('369' as any)).toBe('https://gib.show/image/369');
+    });
+
+    it('should handle zero chainId', () => {
+      expect(network(0)).toBe('https://gib.show/image/0');
+    });
+
+    it('should handle falsy chainId', () => {
+      expect(network(null as any)).toBe('https://gib.show/image/0');
+      expect(network(undefined as any)).toBe('https://gib.show/image/NaN');
+    });
+  });
+
+  describe('image', () => {
+    it('should use logoURI if provided', () => {
+      const token = {
+        chainId: 1,
+        address: '0xdac17f958d2ee523a2206206994597c13d831ec7',
+        logoURI: 'https://custom.com/usdt.png',
+      };
+      expect(image(token)).toBe('https://custom.com/usdt.png');
+    });
+
+    it('should generate URL from chainId and address if no logoURI', () => {
+      const token = {
+        chainId: 1,
+        address: '0xdac17f958d2ee523a2206206994597c13d831ec7',
+      };
+      expect(image(token)).toBe(
+        'https://gib.show/image/1/0xdAC17F958D2ee523a2206206994597C13D831ec7',
+      );
+    });
+
+    it('should checksum the address', () => {
+      const token = {
+        chainId: 1,
+        address: '0xdac17f958d2ee523a2206206994597c13d831ec7', // lowercase
+      };
+      const result = image(token);
+      // Address should be checksummed in the URL
+      expect(result).toContain('0xdAC17F958D2ee523a2206206994597C13D831ec7');
+    });
+
+    it('should handle null logoURI', () => {
+      const token = {
+        chainId: 369,
+        address: '0xa1077a294dde1b09bb078844df40758a5d0f9a27',
+        logoURI: null,
+      };
+      expect(image(token)).toBe(
+        'https://gib.show/image/369/0xA1077a294dDE1B09bB078844df40758a5D0f9a27',
+      );
+    });
+
+    it('should handle different chain IDs', () => {
+      const bscToken = {
+        chainId: 56,
+        address: '0x0e09fabb73bd3ade0a17ecc321fd13a19e81ce82',
+      };
+      expect(image(bscToken)).toBe(
+        'https://gib.show/image/56/0x0E09FaBB73Bd3Ade0a17ECC321fD13a19e81cE82',
+      );
+    });
+  });
+
+  describe('images', () => {
+    it('should generate multi-source image URL', () => {
+      const sources = ['source1', 'source2', 'source3'];
+      expect(images(sources)).toBe('https://gib.show/image/?i=source1&i=source2&i=source3');
+    });
+
+    it('should handle single source', () => {
+      expect(images(['single'])).toBe('https://gib.show/image/?i=single');
+    });
+
+    it('should handle empty array', () => {
+      expect(images([])).toBe('https://gib.show/image/?');
+    });
+
+    it('should handle URL-encoded sources', () => {
+      const sources = ['https://example.com/image1.png', 'https://example.com/image2.png'];
+      expect(images(sources)).toBe(
+        'https://gib.show/image/?i=https://example.com/image1.png&i=https://example.com/image2.png',
+      );
+    });
+  });
+
+  describe('integration', () => {
+    it('should work with custom root across all functions', () => {
+      setImageRoot('https://cdn.example.com');
+
+      expect(list('/tokens')).toBe('https://cdn.example.com/list/tokens');
+      expect(network(1)).toBe('https://cdn.example.com/image/1');
+      expect(image({ chainId: 1, address: '0xdac17f958d2ee523a2206206994597c13d831ec7' })).toBe(
+        'https://cdn.example.com/image/1/0xdAC17F958D2ee523a2206206994597C13D831ec7',
+      );
+      expect(images(['a', 'b'])).toBe('https://cdn.example.com/image/?i=a&i=b');
+    });
+  });
+});