@veridex/sdk 1.0.0-beta.1

package/dist/utils.mjs

@@ -0,0 +1,390 @@
+// src/utils.ts
+import { ethers } from "ethers";
+
+// src/constants.ts
+var TESTNET_CHAINS = {
+  baseSepolia: {
+    name: "Base Sepolia",
+    chainId: 84532,
+    wormholeChainId: 10004,
+    rpcUrl: "https://sepolia.base.org",
+    // Public CORS-friendly RPC
+    explorerUrl: "https://sepolia.basescan.org",
+    isEvm: true,
+    contracts: {
+      hub: "0x66D87dE68327f48A099c5B9bE97020Feab9a7c82",
+      vaultFactory: "0x40D9B16094808Fa48e73598E31AB964Cf15b475f",
+      vaultImplementation: "0xcBEb49b0109E61c1C69C51D5D9483A3aD6D18258",
+      wormholeCoreBridge: "0x79A1027a6A159502049F10906D333EC57E95F083",
+      tokenBridge: "0x86F55A04690fd7815A3D802bD587e83eA888B239"
+    }
+  },
+  optimismSepolia: {
+    name: "Optimism Sepolia",
+    chainId: 11155420,
+    wormholeChainId: 10005,
+    rpcUrl: "https://sepolia.optimism.io",
+    explorerUrl: "https://sepolia-optimism.etherscan.io",
+    isEvm: true,
+    contracts: {
+      vaultFactory: "0xAbB421166E648953CDBE93c0078a0A794c56Fb84",
+      vaultImplementation: "0xDCD7daEf1AC06f4a8392957cca4834F7a16c058D",
+      wormholeCoreBridge: "0x31377888146f3253211EFEf5c676D41ECe7D58Fe",
+      tokenBridge: "0x99737Ec4B815d816c49A385943baf0380e75c0Ac"
+    }
+  },
+  arbitrumSepolia: {
+    name: "Arbitrum Sepolia",
+    chainId: 421614,
+    wormholeChainId: 10003,
+    rpcUrl: "https://sepolia-rollup.arbitrum.io/rpc",
+    explorerUrl: "https://sepolia.arbiscan.io",
+    isEvm: true,
+    contracts: {
+      vaultFactory: "0xd36D3D5DB59d78f1E33813490F72DABC15C9B07c",
+      vaultImplementation: "0xB10ACf39eBF17fc33F722cBD955b7aeCB0611bc4",
+      wormholeCoreBridge: "0x6b9C8671cdDC8dEab9c719bB87cBd3e782bA6a35",
+      tokenBridge: "0xC7A204bDBFe983FCD8d8E61D02b475D4073fF97e"
+    }
+  },
+  seiTestnet: {
+    name: "Sei Atlantic-2",
+    chainId: 1328,
+    wormholeChainId: 40,
+    rpcUrl: "https://evm-rpc-testnet.sei-apis.com",
+    explorerUrl: "https://seitrace.com/?chain=atlantic-2",
+    isEvm: true,
+    contracts: {
+      vaultFactory: "0x07F608AFf6d63b68029488b726d895c4Bb593038",
+      vaultImplementation: "0xD66153fccFB6731fB6c4944FbD607ba86A76a1f6",
+      wormholeCoreBridge: "0x0000000000000000000000000000000000000000"
+      // Mock - not yet deployed
+    }
+  },
+  solanaDevnet: {
+    name: "Solana Devnet",
+    chainId: 0,
+    wormholeChainId: 1,
+    rpcUrl: "https://api.devnet.solana.com",
+    explorerUrl: "https://explorer.solana.com",
+    isEvm: false,
+    contracts: {
+      hub: "AnyXHsqq9c2BiW4WgBcj6Aye7Ua7a7L7iSuwpfJxECJM",
+      wormholeCoreBridge: "3u8hJUVTA4jH1wYAyUur7FFZVQ8H635K3tSHHF4ssjQ5",
+      tokenBridge: "DZnkkTmCiFWfYTfT41X3Rd1kDgozqzxWaHqsw6W4x2oe"
+    }
+  },
+  aptosTestnet: {
+    name: "Aptos Testnet",
+    chainId: 0,
+    wormholeChainId: 22,
+    rpcUrl: "https://fullnode.testnet.aptoslabs.com/v1",
+    explorerUrl: "https://explorer.aptoslabs.com",
+    isEvm: false,
+    contracts: {
+      hub: "0x1a89da9e9f8f0bc90d8d492890bd55fb261c6277d2a95dfcac70c268d0c23dcc",
+      wormholeCoreBridge: "0x5bc11445584a763c1fa7ed39081f1b920954da14e04b32440cba863d03e19625",
+      tokenBridge: "0x576410486a2da45eee6c949c995670112ddf2fbeedab20350d506328eefc9d4f"
+    }
+  },
+  suiTestnet: {
+    name: "Sui Testnet",
+    chainId: 0,
+    wormholeChainId: 21,
+    rpcUrl: "https://fullnode.testnet.sui.io:443",
+    explorerUrl: "https://suiscan.xyz/testnet",
+    isEvm: false,
+    contracts: {
+      hub: "0x35e99fdbbc1cde7e093da6f9e758ba2c4a077904bd64caee2fa6db5e6c4e9e37",
+      wormholeCoreBridge: "0x31358d198147da50db32eda2562951d53973a0c0ad5ed738e9b17d88b213d790"
+    }
+  },
+  starknetSepolia: {
+    name: "Starknet Sepolia",
+    chainId: 0,
+    // Native Starknet chain ID (SN_SEPOLIA = 0x534e5f5345504f4c4941)
+    wormholeChainId: 50001,
+    // Custom chain ID (50000+ reserved for non-Wormhole chains)
+    rpcUrl: "https://starknet-sepolia.g.alchemy.com/starknet/version/rpc/v0_7/tsOnfTBZDKMXcUA26OED-",
+    explorerUrl: "https://sepolia.starkscan.co",
+    isEvm: false,
+    contracts: {
+      // Starknet spoke contract
+      hub: "0x68adcc730ed6c355200d00f763825448497b9cdf7936ca121711e078c88e811",
+      // Custom bridge contract (NOT Wormhole)
+      wormholeCoreBridge: "0x2c458c1ae64556482b05cc2d3ee5b032ed114d68429dda2062c9849a5a725f8"
+    },
+    // Hub chain ID that Starknet bridge validates (Base Sepolia = 10004)
+    hubChainId: 10004
+  }
+};
+var MAINNET_CHAINS = {
+  ethereum: {
+    name: "Ethereum",
+    chainId: 1,
+    wormholeChainId: 2,
+    rpcUrl: "https://eth.llamarpc.com",
+    explorerUrl: "https://etherscan.io",
+    isEvm: true,
+    contracts: {
+      wormholeCoreBridge: "0x98f3c9e6E3fAce36bAAd05FE09d375Ef1464288B",
+      tokenBridge: "0x3ee18B2214AFF97000D974cf647E7C347E8fa585"
+    }
+  },
+  base: {
+    name: "Base",
+    chainId: 8453,
+    wormholeChainId: 30,
+    rpcUrl: "https://mainnet.base.org",
+    explorerUrl: "https://basescan.org",
+    isEvm: true,
+    contracts: {
+      wormholeCoreBridge: "0xbebdb6C8ddC678FfA9f8748f85C815C556Dd8ac6",
+      tokenBridge: "0x8d2de8d2f73F1F4cAB472AC9A881C9b123C79627"
+    }
+  },
+  optimism: {
+    name: "Optimism",
+    chainId: 10,
+    wormholeChainId: 24,
+    rpcUrl: "https://mainnet.optimism.io",
+    explorerUrl: "https://optimistic.etherscan.io",
+    isEvm: true,
+    contracts: {
+      wormholeCoreBridge: "0xEe91C335eab126dF5fDB3797EA9d6aD93aeC9722",
+      tokenBridge: "0x1D68124e65faFC907325e3EDbF8c4d84499DAa8b"
+    }
+  },
+  arbitrum: {
+    name: "Arbitrum",
+    chainId: 42161,
+    wormholeChainId: 23,
+    rpcUrl: "https://arb1.arbitrum.io/rpc",
+    explorerUrl: "https://arbiscan.io",
+    isEvm: true,
+    contracts: {
+      wormholeCoreBridge: "0xa5f208e072434bC67592E4C49C1B991BA79BCA46",
+      tokenBridge: "0x0b2402144Bb366A632D14B83F244D2e0e21bD39c"
+    }
+  },
+  polygon: {
+    name: "Polygon",
+    chainId: 137,
+    wormholeChainId: 5,
+    rpcUrl: "https://polygon-rpc.com",
+    explorerUrl: "https://polygonscan.com",
+    isEvm: true,
+    contracts: {
+      wormholeCoreBridge: "0x7A4B5a56256163F07b2C80A7cA55aBE66c4ec4d7",
+      tokenBridge: "0x5a58505a96D1dbf8dF91cB21B54419FC36e93fdE"
+    }
+  },
+  solana: {
+    name: "Solana",
+    chainId: 0,
+    wormholeChainId: 1,
+    rpcUrl: "https://api.mainnet-beta.solana.com",
+    explorerUrl: "https://explorer.solana.com",
+    isEvm: false,
+    contracts: {
+      wormholeCoreBridge: "worm2ZoG2kUd4vFXhvjh93UUH596ayRfgQ2MgjNMTth",
+      tokenBridge: "wormDTUJ6AWPNvk59vGQbDvGJmqbDTdgWgAqcLBCgUb"
+    }
+  },
+  aptos: {
+    name: "Aptos",
+    chainId: 0,
+    wormholeChainId: 22,
+    rpcUrl: "https://fullnode.mainnet.aptoslabs.com/v1",
+    explorerUrl: "https://explorer.aptoslabs.com",
+    isEvm: false,
+    contracts: {
+      wormholeCoreBridge: "0x5bc11445584a763c1fa7ed39081f1b920954da14e04b32440cba863d03e19625",
+      tokenBridge: "0x576410486a2da45eee6c949c995670112ddf2fbeedab20350d506328eefc9d4f"
+    }
+  },
+  sui: {
+    name: "Sui",
+    chainId: 0,
+    wormholeChainId: 21,
+    rpcUrl: "https://fullnode.mainnet.sui.io:443",
+    explorerUrl: "https://suiscan.xyz/mainnet",
+    isEvm: false,
+    contracts: {
+      wormholeCoreBridge: "0xaeab97f96cf9877fee2883315d459552b2b921edc16d7ceac6eab944dd88919c"
+    }
+  }
+};
+
+// src/utils.ts
+function base64URLEncode(buffer) {
+  const bytes = Array.from(buffer);
+  const binary = String.fromCharCode(...bytes);
+  const base64 = btoa(binary);
+  return base64.replace(/\+/g, "-").replace(/\//g, "_").replace(/=/g, "");
+}
+function base64URLDecode(str) {
+  const base64 = str.replace(/-/g, "+").replace(/_/g, "/");
+  const padded = base64 + "=".repeat((4 - base64.length % 4) % 4);
+  const binary = atob(padded);
+  const bytes = new Uint8Array(binary.length);
+  for (let i = 0; i < binary.length; i++) {
+    bytes[i] = binary.charCodeAt(i);
+  }
+  return bytes;
+}
+function parseDERSignature(signature) {
+  let offset = 0;
+  if (signature[offset++] !== 48) {
+    throw new Error("Invalid signature format");
+  }
+  offset++;
+  if (signature[offset++] !== 2) {
+    throw new Error("Invalid signature format");
+  }
+  const rLength = signature[offset++];
+  if (rLength === void 0) {
+    throw new Error("Invalid signature format: missing r length");
+  }
+  let r = signature.slice(offset, offset + rLength);
+  offset += rLength;
+  if (r[0] === 0 && r.length > 32) {
+    r = r.slice(1);
+  }
+  if (r.length < 32) {
+    const padded = new Uint8Array(32);
+    padded.set(r, 32 - r.length);
+    r = padded;
+  }
+  if (signature[offset++] !== 2) {
+    throw new Error("Invalid signature format");
+  }
+  const sLength = signature[offset++];
+  if (sLength === void 0) {
+    throw new Error("Invalid signature format: missing s length");
+  }
+  let s = signature.slice(offset, offset + sLength);
+  if (s[0] === 0 && s.length > 32) {
+    s = s.slice(1);
+  }
+  if (s.length < 32) {
+    const padded = new Uint8Array(32);
+    padded.set(s, 32 - s.length);
+    s = padded;
+  }
+  return { r, s };
+}
+function encodeSignatureForSolidity(r, s) {
+  return ethers.solidityPacked(["uint256", "uint256"], [r, s]);
+}
+function computeKeyHash(publicKeyX, publicKeyY) {
+  return ethers.keccak256(
+    ethers.solidityPacked(["uint256", "uint256"], [publicKeyX, publicKeyY])
+  );
+}
+function getChainConfig(chainName, testnet = true) {
+  const chains = testnet ? TESTNET_CHAINS : MAINNET_CHAINS;
+  return chains[chainName];
+}
+function getChainByWormholeId(wormholeChainId, testnet = true) {
+  const chains = testnet ? TESTNET_CHAINS : MAINNET_CHAINS;
+  return Object.values(chains).find((chain) => chain.wormholeChainId === wormholeChainId);
+}
+function getChainByEvmId(evmChainId, testnet = true) {
+  const chains = testnet ? TESTNET_CHAINS : MAINNET_CHAINS;
+  return Object.values(chains).find((chain) => chain.chainId === evmChainId);
+}
+function isEvmChain(wormholeChainId) {
+  const nonEvmChains = /* @__PURE__ */ new Set([1, 8, 15, 21, 22]);
+  return !nonEvmChains.has(wormholeChainId);
+}
+function getSupportedChains(testnet = true) {
+  const chains = testnet ? TESTNET_CHAINS : MAINNET_CHAINS;
+  return Object.values(chains);
+}
+function getTxExplorerUrl(chain, txHash) {
+  if (chain.isEvm) {
+    return `${chain.explorerUrl}/tx/${txHash}`;
+  }
+  switch (chain.wormholeChainId) {
+    case 1:
+      return `${chain.explorerUrl}/tx/${txHash}?cluster=devnet`;
+    case 21:
+      return `${chain.explorerUrl}/tx/${txHash}`;
+    case 22:
+      return `${chain.explorerUrl}/txn/${txHash}?network=testnet`;
+    default:
+      return `${chain.explorerUrl}/tx/${txHash}`;
+  }
+}
+function getAddressExplorerUrl(chain, address) {
+  if (chain.isEvm) {
+    return `${chain.explorerUrl}/address/${address}`;
+  }
+  switch (chain.wormholeChainId) {
+    case 1:
+      return `${chain.explorerUrl}/address/${address}?cluster=devnet`;
+    case 21:
+      return `${chain.explorerUrl}/account/${address}`;
+    case 22:
+      return `${chain.explorerUrl}/account/${address}?network=testnet`;
+    default:
+      return `${chain.explorerUrl}/address/${address}`;
+  }
+}
+function isValidEvmAddress(address) {
+  return ethers.isAddress(address);
+}
+function isValidBytes32(hex) {
+  const clean = hex.replace("0x", "");
+  return /^[0-9a-fA-F]{64}$/.test(clean);
+}
+function isValidWormholeChainId(chainId) {
+  return chainId >= 1 && chainId <= 5e4;
+}
+async function retryWithBackoff(fn, options = {}) {
+  const {
+    maxRetries = 5,
+    initialDelayMs = 1e3,
+    maxDelayMs = 3e4,
+    backoffMultiplier = 2,
+    onRetry
+  } = options;
+  let lastError;
+  let delay = initialDelayMs;
+  for (let attempt = 1; attempt <= maxRetries; attempt++) {
+    try {
+      return await fn();
+    } catch (error) {
+      lastError = error;
+      if (attempt < maxRetries) {
+        onRetry?.(attempt, lastError);
+        await sleep(delay);
+        delay = Math.min(delay * backoffMultiplier, maxDelayMs);
+      }
+    }
+  }
+  throw lastError ?? new Error("Retry failed");
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export {
+  base64URLDecode,
+  base64URLEncode,
+  computeKeyHash,
+  encodeSignatureForSolidity,
+  getAddressExplorerUrl,
+  getChainByEvmId,
+  getChainByWormholeId,
+  getChainConfig,
+  getSupportedChains,
+  getTxExplorerUrl,
+  isEvmChain,
+  isValidBytes32,
+  isValidEvmAddress,
+  isValidWormholeChainId,
+  parseDERSignature,
+  retryWithBackoff
+};
+//# sourceMappingURL=utils.mjs.map

package/dist/utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils.ts","../src/constants.ts"],"sourcesContent":["/**\n * Veridex Protocol SDK - Utility Functions\n */\n\nimport { ethers } from 'ethers';\nimport type { ChainConfig } from './types.js';\nimport { TESTNET_CHAINS, MAINNET_CHAINS } from './constants.js';\n\n// ============================================================================\n// Base64URL Encoding/Decoding (WebAuthn compatible)\n// ============================================================================\n\n/**\n * Base64URL encode a buffer\n */\nexport function base64URLEncode(buffer: Uint8Array): string {\n  // Convert Uint8Array to base64 using browser APIs\n  const bytes = Array.from(buffer);\n  const binary = String.fromCharCode(...bytes);\n  const base64 = btoa(binary);\n  return base64.replace(/\\+/g, '-').replace(/\\//g, '_').replace(/=/g, '');\n}\n\n/**\n * Base64URL decode a string\n */\nexport function base64URLDecode(str: string): Uint8Array {\n  const base64 = str.replace(/-/g, '+').replace(/_/g, '/');\n  const padded = base64 + '='.repeat((4 - (base64.length % 4)) % 4);\n  // Use browser's atob for base64 decoding\n  const binary = atob(padded);\n  const bytes = new Uint8Array(binary.length);\n  for (let i = 0; i < binary.length; i++) {\n    bytes[i] = binary.charCodeAt(i);\n  }\n  return bytes;\n}\n\n// ============================================================================\n// Signature Utilities\n// ============================================================================\n\n/**\n * Parse DER-encoded ECDSA signature to r and s values\n */\nexport function parseDERSignature(signature: Uint8Array): { r: Uint8Array; s: Uint8Array } {\n  let offset = 0;\n\n  if (signature[offset++] !== 0x30) {\n    throw new Error('Invalid signature format');\n  }\n\n  // Skip total length\n  offset++;\n\n  if (signature[offset++] !== 0x02) {\n    throw new Error('Invalid signature format');\n  }\n\n  const rLength = signature[offset++];\n  if (rLength === undefined) {\n    throw new Error('Invalid signature format: missing r length');\n  }\n  let r = signature.slice(offset, offset + rLength);\n  offset += rLength;\n\n  // Remove leading zero if present (for positive number representation)\n  if (r[0] === 0x00 && r.length > 32) {\n    r = r.slice(1);\n  }\n  // Pad to 32 bytes if needed\n  if (r.length < 32) {\n    const padded = new Uint8Array(32);\n    padded.set(r, 32 - r.length);\n    r = padded;\n  }\n\n  if (signature[offset++] !== 0x02) {\n    throw new Error('Invalid signature format');\n  }\n\n  const sLength = signature[offset++];\n  if (sLength === undefined) {\n    throw new Error('Invalid signature format: missing s length');\n  }\n  let s = signature.slice(offset, offset + sLength);\n\n  // Remove leading zero if present\n  if (s[0] === 0x00 && s.length > 32) {\n    s = s.slice(1);\n  }\n  // Pad to 32 bytes if needed\n  if (s.length < 32) {\n    const padded = new Uint8Array(32);\n    padded.set(s, 32 - s.length);\n    s = padded;\n  }\n\n  return { r, s };\n}\n\n/**\n * Encode signature for Solidity verification\n */\nexport function encodeSignatureForSolidity(r: bigint, s: bigint): string {\n  return ethers.solidityPacked(['uint256', 'uint256'], [r, s]);\n}\n\n// ============================================================================\n// Key Hash Utilities\n// ============================================================================\n\n/**\n * Compute key hash from public key coordinates\n */\nexport function computeKeyHash(publicKeyX: bigint, publicKeyY: bigint): string {\n  return ethers.keccak256(\n    ethers.solidityPacked(['uint256', 'uint256'], [publicKeyX, publicKeyY])\n  );\n}\n\n// ============================================================================\n// Chain Utilities\n// ============================================================================\n\n/**\n * Get chain config by name\n */\nexport function getChainConfig(chainName: string, testnet = true): ChainConfig | undefined {\n  const chains = testnet ? TESTNET_CHAINS : MAINNET_CHAINS;\n  return chains[chainName];\n}\n\n/**\n * Get chain config by Wormhole chain ID\n */\nexport function getChainByWormholeId(wormholeChainId: number, testnet = true): ChainConfig | undefined {\n  const chains = testnet ? TESTNET_CHAINS : MAINNET_CHAINS;\n  return Object.values(chains).find(chain => chain.wormholeChainId === wormholeChainId);\n}\n\n/**\n * Get chain config by EVM chain ID\n */\nexport function getChainByEvmId(evmChainId: number, testnet = true): ChainConfig | undefined {\n  const chains = testnet ? TESTNET_CHAINS : MAINNET_CHAINS;\n  return Object.values(chains).find(chain => chain.chainId === evmChainId);\n}\n\n/**\n * Check if a chain is EVM-compatible\n */\nexport function isEvmChain(wormholeChainId: number): boolean {\n  // Non-EVM chains\n  const nonEvmChains = new Set([1, 8, 15, 21, 22]); // Solana, Algorand, NEAR, Sui, Aptos\n  return !nonEvmChains.has(wormholeChainId);\n}\n\n/**\n * Get all supported chains\n */\nexport function getSupportedChains(testnet = true): ChainConfig[] {\n  const chains = testnet ? TESTNET_CHAINS : MAINNET_CHAINS;\n  return Object.values(chains);\n}\n\n// ============================================================================\n// Explorer URL Utilities\n// ============================================================================\n\n/**\n * Get transaction explorer URL\n */\nexport function getTxExplorerUrl(chain: ChainConfig, txHash: string): string {\n  if (chain.isEvm) {\n    return `${chain.explorerUrl}/tx/${txHash}`;\n  }\n\n  // Non-EVM chains have different URL patterns\n  switch (chain.wormholeChainId) {\n    case 1: // Solana\n      return `${chain.explorerUrl}/tx/${txHash}?cluster=devnet`;\n    case 21: // Sui\n      return `${chain.explorerUrl}/tx/${txHash}`;\n    case 22: // Aptos\n      return `${chain.explorerUrl}/txn/${txHash}?network=testnet`;\n    default:\n      return `${chain.explorerUrl}/tx/${txHash}`;\n  }\n}\n\n/**\n * Get address explorer URL\n */\nexport function getAddressExplorerUrl(chain: ChainConfig, address: string): string {\n  if (chain.isEvm) {\n    return `${chain.explorerUrl}/address/${address}`;\n  }\n\n  switch (chain.wormholeChainId) {\n    case 1: // Solana\n      return `${chain.explorerUrl}/address/${address}?cluster=devnet`;\n    case 21: // Sui\n      return `${chain.explorerUrl}/account/${address}`;\n    case 22: // Aptos\n      return `${chain.explorerUrl}/account/${address}?network=testnet`;\n    default:\n      return `${chain.explorerUrl}/address/${address}`;\n  }\n}\n\n// ============================================================================\n// Validation Utilities\n// ============================================================================\n\n/**\n * Validate an EVM address\n */\nexport function isValidEvmAddress(address: string): boolean {\n  return ethers.isAddress(address);\n}\n\n/**\n * Validate a bytes32 hex string\n */\nexport function isValidBytes32(hex: string): boolean {\n  const clean = hex.replace('0x', '');\n  return /^[0-9a-fA-F]{64}$/.test(clean);\n}\n\n/**\n * Validate a Wormhole chain ID\n */\nexport function isValidWormholeChainId(chainId: number): boolean {\n  // Valid Wormhole chain IDs range from 1 to ~10007 (testnets)\n  return chainId >= 1 && chainId <= 50000;\n}\n\n// ============================================================================\n// Retry Utilities\n// ============================================================================\n\n/**\n * Retry a function with exponential backoff\n */\nexport async function retryWithBackoff<T>(\n  fn: () => Promise<T>,\n  options: {\n    maxRetries?: number;\n    initialDelayMs?: number;\n    maxDelayMs?: number;\n    backoffMultiplier?: number;\n    onRetry?: (attempt: number, error: Error) => void;\n  } = {}\n): Promise<T> {\n  const {\n    maxRetries = 5,\n    initialDelayMs = 1000,\n    maxDelayMs = 30000,\n    backoffMultiplier = 2,\n    onRetry,\n  } = options;\n\n  let lastError: Error | undefined;\n  let delay = initialDelayMs;\n\n  for (let attempt = 1; attempt <= maxRetries; attempt++) {\n    try {\n      return await fn();\n    } catch (error) {\n      lastError = error as Error;\n\n      if (attempt < maxRetries) {\n        onRetry?.(attempt, lastError);\n        await sleep(delay);\n        delay = Math.min(delay * backoffMultiplier, maxDelayMs);\n      }\n    }\n  }\n\n  throw lastError ?? new Error('Retry failed');\n}\n\n// ============================================================================\n// Helpers\n// ============================================================================\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise(resolve => setTimeout(resolve, ms));\n}\n","/**\n * Veridex Protocol SDK - Constants and Chain Configurations\n */\n\nimport type { ChainConfig } from './types.js';\n\n// ============================================================================\n// Action Type Constants\n// ============================================================================\n\nexport const ACTION_TYPES = {\n  TRANSFER: 1,\n  EXECUTE: 2,\n  CONFIG: 3,\n  BRIDGE: 4,\n} as const;\n\nexport const ACTION_TRANSFER = 1;\nexport const ACTION_EXECUTE = 2;\nexport const ACTION_CONFIG = 3;\nexport const ACTION_BRIDGE = 4;\n\n// Protocol version\nexport const PROTOCOL_VERSION = 1;\n\n// ============================================================================\n// Wormhole Chain IDs\n// ============================================================================\n\n/**\n * Wormhole Chain IDs organized by network\n * @see https://docs.wormhole.com/wormhole/reference/constants\n */\nexport const WORMHOLE_CHAIN_IDS = {\n  MAINNET: {\n    SOLANA: 1,\n    ETHEREUM: 2,\n    TERRA: 3,\n    BSC: 4,\n    POLYGON: 5,\n    AVALANCHE: 6,\n    OASIS: 7,\n    ALGORAND: 8,\n    AURORA: 9,\n    FANTOM: 10,\n    KARURA: 11,\n    ACALA: 12,\n    KLAYTN: 13,\n    CELO: 14,\n    NEAR: 15,\n    MOONBEAM: 16,\n    NEON: 17,\n    TERRA2: 18,\n    INJECTIVE: 19,\n    OSMOSIS: 20,\n    SUI: 21,\n    APTOS: 22,\n    ARBITRUM: 23,\n    OPTIMISM: 24,\n    GNOSIS: 25,\n    PYTHNET: 26,\n    XPLA: 28,\n    BASE: 30,\n    SEI: 32,\n    ROOTSTOCK: 33,\n    SCROLL: 34,\n    MANTLE: 35,\n    BLAST: 36,\n    XLAYER: 37,\n    LINEA: 38,\n    BERACHAIN: 39,\n    SEIEVM: 40,\n  },\n  TESTNET: {\n    SOLANA_DEVNET: 1,\n    GOERLI: 2,\n    BSC_TESTNET: 4,\n    POLYGON_MUMBAI: 5,\n    AVALANCHE_FUJI: 6,\n    FANTOM_TESTNET: 10,\n    CELO_ALFAJORES: 14,\n    MOONBASE_ALPHA: 16,\n    SUI_TESTNET: 21,\n    APTOS_TESTNET: 22,\n    SEPOLIA: 10002,\n    ARBITRUM_SEPOLIA: 10003,\n    BASE_SEPOLIA: 10004,\n    OPTIMISM_SEPOLIA: 10005,\n    HOLESKY: 10006,\n    POLYGON_SEPOLIA: 10007,\n    SEI_ATLANTIC_2: 10066, // Sei Arctic-1 testnet (EVM)\n    STARKNET_SEPOLIA: 50001, // Custom bridge (non-Wormhole, relayer-attested)\n  },\n} as const;\n\n// Legacy flat exports for backward compatibility\nexport const WORMHOLE_CHAIN_IDS_FLAT = {\n  // Mainnets\n  SOLANA: 1,\n  ETHEREUM: 2,\n  TERRA: 3,\n  BSC: 4,\n  POLYGON: 5,\n  AVALANCHE: 6,\n  OASIS: 7,\n  ALGORAND: 8,\n  AURORA: 9,\n  FANTOM: 10,\n  KARURA: 11,\n  ACALA: 12,\n  KLAYTN: 13,\n  CELO: 14,\n  NEAR: 15,\n  MOONBEAM: 16,\n  NEON: 17,\n  TERRA2: 18,\n  INJECTIVE: 19,\n  OSMOSIS: 20,\n  SUI: 21,\n  APTOS: 22,\n  ARBITRUM: 23,\n  OPTIMISM: 24,\n  GNOSIS: 25,\n  PYTHNET: 26,\n  XPLA: 28,\n  BASE: 30,\n  SEI: 32,\n  ROOTSTOCK: 33,\n  SCROLL: 34,\n  MANTLE: 35,\n  BLAST: 36,\n  XLAYER: 37,\n  LINEA: 38,\n  BERACHAIN: 39,\n  SEIEVM: 40,\n\n  // Testnets\n  SOLANA_DEVNET: 1,\n  GOERLI: 2,\n  BSC_TESTNET: 4,\n  POLYGON_MUMBAI: 5,\n  AVALANCHE_FUJI: 6,\n  FANTOM_TESTNET: 10,\n  CELO_ALFAJORES: 14,\n  MOONBASE_ALPHA: 16,\n  SUI_TESTNET: 21,\n  APTOS_TESTNET: 22,\n  ARBITRUM_SEPOLIA: 10003,\n  BASE_SEPOLIA: 10004,\n  OPTIMISM_SEPOLIA: 10005,\n  POLYGON_SEPOLIA: 10007,\n  HOLESKY: 10006,\n  STARKNET_SEPOLIA: 50001, // Custom bridge (non-Wormhole)\n} as const;\n\n// ============================================================================\n// Testnet Chain Configurations\n// ============================================================================\n\nexport const TESTNET_CHAINS: Record<string, ChainConfig> = {\n  baseSepolia: {\n    name: 'Base Sepolia',\n    chainId: 84532,\n    wormholeChainId: 10004,\n    rpcUrl: 'https://sepolia.base.org', // Public CORS-friendly RPC\n    explorerUrl: 'https://sepolia.basescan.org',\n    isEvm: true,\n    contracts: {\n      hub: '0x66D87dE68327f48A099c5B9bE97020Feab9a7c82',\n      vaultFactory: '0x40D9B16094808Fa48e73598E31AB964Cf15b475f',\n      vaultImplementation: '0xcBEb49b0109E61c1C69C51D5D9483A3aD6D18258',\n      wormholeCoreBridge: '0x79A1027a6A159502049F10906D333EC57E95F083',\n      tokenBridge: '0x86F55A04690fd7815A3D802bD587e83eA888B239',\n    },\n  },\n  optimismSepolia: {\n    name: 'Optimism Sepolia',\n    chainId: 11155420,\n    wormholeChainId: 10005,\n    rpcUrl: 'https://sepolia.optimism.io',\n    explorerUrl: 'https://sepolia-optimism.etherscan.io',\n    isEvm: true,\n    contracts: {\n      vaultFactory: '0xAbB421166E648953CDBE93c0078a0A794c56Fb84',\n      vaultImplementation: '0xDCD7daEf1AC06f4a8392957cca4834F7a16c058D',\n      wormholeCoreBridge: '0x31377888146f3253211EFEf5c676D41ECe7D58Fe',\n      tokenBridge: '0x99737Ec4B815d816c49A385943baf0380e75c0Ac',\n    },\n  },\n  arbitrumSepolia: {\n    name: 'Arbitrum Sepolia',\n    chainId: 421614,\n    wormholeChainId: 10003,\n    rpcUrl: 'https://sepolia-rollup.arbitrum.io/rpc',\n    explorerUrl: 'https://sepolia.arbiscan.io',\n    isEvm: true,\n    contracts: {\n      vaultFactory: '0xd36D3D5DB59d78f1E33813490F72DABC15C9B07c',\n      vaultImplementation: '0xB10ACf39eBF17fc33F722cBD955b7aeCB0611bc4',\n      wormholeCoreBridge: '0x6b9C8671cdDC8dEab9c719bB87cBd3e782bA6a35',\n      tokenBridge: '0xC7A204bDBFe983FCD8d8E61D02b475D4073fF97e',\n    },\n  },\n  seiTestnet: {\n    name: 'Sei Atlantic-2',\n    chainId: 1328,\n    wormholeChainId: 40,\n    rpcUrl: 'https://evm-rpc-testnet.sei-apis.com',\n    explorerUrl: 'https://seitrace.com/?chain=atlantic-2',\n    isEvm: true,\n    contracts: {\n      vaultFactory: '0x07F608AFf6d63b68029488b726d895c4Bb593038',\n      vaultImplementation: '0xD66153fccFB6731fB6c4944FbD607ba86A76a1f6',\n      wormholeCoreBridge: '0x0000000000000000000000000000000000000000', // Mock - not yet deployed\n    },\n  },\n  solanaDevnet: {\n    name: 'Solana Devnet',\n    chainId: 0,\n    wormholeChainId: 1,\n    rpcUrl: 'https://api.devnet.solana.com',\n    explorerUrl: 'https://explorer.solana.com',\n    isEvm: false,\n    contracts: {\n      hub: 'AnyXHsqq9c2BiW4WgBcj6Aye7Ua7a7L7iSuwpfJxECJM',\n      wormholeCoreBridge: '3u8hJUVTA4jH1wYAyUur7FFZVQ8H635K3tSHHF4ssjQ5',\n      tokenBridge: 'DZnkkTmCiFWfYTfT41X3Rd1kDgozqzxWaHqsw6W4x2oe',\n    },\n  },\n  aptosTestnet: {\n    name: 'Aptos Testnet',\n    chainId: 0,\n    wormholeChainId: 22,\n    rpcUrl: 'https://fullnode.testnet.aptoslabs.com/v1',\n    explorerUrl: 'https://explorer.aptoslabs.com',\n    isEvm: false,\n    contracts: {\n      hub: '0x1a89da9e9f8f0bc90d8d492890bd55fb261c6277d2a95dfcac70c268d0c23dcc',\n      wormholeCoreBridge: '0x5bc11445584a763c1fa7ed39081f1b920954da14e04b32440cba863d03e19625',\n      tokenBridge: '0x576410486a2da45eee6c949c995670112ddf2fbeedab20350d506328eefc9d4f',\n    },\n  },\n  suiTestnet: {\n    name: 'Sui Testnet',\n    chainId: 0,\n    wormholeChainId: 21,\n    rpcUrl: 'https://fullnode.testnet.sui.io:443',\n    explorerUrl: 'https://suiscan.xyz/testnet',\n    isEvm: false,\n    contracts: {\n      hub: '0x35e99fdbbc1cde7e093da6f9e758ba2c4a077904bd64caee2fa6db5e6c4e9e37',\n      wormholeCoreBridge: '0x31358d198147da50db32eda2562951d53973a0c0ad5ed738e9b17d88b213d790',\n    },\n  },\n  starknetSepolia: {\n    name: 'Starknet Sepolia',\n    chainId: 0, // Native Starknet chain ID (SN_SEPOLIA = 0x534e5f5345504f4c4941)\n    wormholeChainId: 50001, // Custom chain ID (50000+ reserved for non-Wormhole chains)\n    rpcUrl: 'https://starknet-sepolia.g.alchemy.com/starknet/version/rpc/v0_7/tsOnfTBZDKMXcUA26OED-',\n    explorerUrl: 'https://sepolia.starkscan.co',\n    isEvm: false,\n    contracts: {\n      // Starknet spoke contract\n      hub: '0x68adcc730ed6c355200d00f763825448497b9cdf7936ca121711e078c88e811',\n      // Custom bridge contract (NOT Wormhole)\n      wormholeCoreBridge: '0x2c458c1ae64556482b05cc2d3ee5b032ed114d68429dda2062c9849a5a725f8',\n    },\n    // Hub chain ID that Starknet bridge validates (Base Sepolia = 10004)\n    hubChainId: 10004,\n  },\n};\n\n// ============================================================================\n// Mainnet Chain Configurations\n// ============================================================================\n\nexport const MAINNET_CHAINS: Record<string, ChainConfig> = {\n  ethereum: {\n    name: 'Ethereum',\n    chainId: 1,\n    wormholeChainId: 2,\n    rpcUrl: 'https://eth.llamarpc.com',\n    explorerUrl: 'https://etherscan.io',\n    isEvm: true,\n    contracts: {\n      wormholeCoreBridge: '0x98f3c9e6E3fAce36bAAd05FE09d375Ef1464288B',\n      tokenBridge: '0x3ee18B2214AFF97000D974cf647E7C347E8fa585',\n    },\n  },\n  base: {\n    name: 'Base',\n    chainId: 8453,\n    wormholeChainId: 30,\n    rpcUrl: 'https://mainnet.base.org',\n    explorerUrl: 'https://basescan.org',\n    isEvm: true,\n    contracts: {\n      wormholeCoreBridge: '0xbebdb6C8ddC678FfA9f8748f85C815C556Dd8ac6',\n      tokenBridge: '0x8d2de8d2f73F1F4cAB472AC9A881C9b123C79627',\n    },\n  },\n  optimism: {\n    name: 'Optimism',\n    chainId: 10,\n    wormholeChainId: 24,\n    rpcUrl: 'https://mainnet.optimism.io',\n    explorerUrl: 'https://optimistic.etherscan.io',\n    isEvm: true,\n    contracts: {\n      wormholeCoreBridge: '0xEe91C335eab126dF5fDB3797EA9d6aD93aeC9722',\n      tokenBridge: '0x1D68124e65faFC907325e3EDbF8c4d84499DAa8b',\n    },\n  },\n  arbitrum: {\n    name: 'Arbitrum',\n    chainId: 42161,\n    wormholeChainId: 23,\n    rpcUrl: 'https://arb1.arbitrum.io/rpc',\n    explorerUrl: 'https://arbiscan.io',\n    isEvm: true,\n    contracts: {\n      wormholeCoreBridge: '0xa5f208e072434bC67592E4C49C1B991BA79BCA46',\n      tokenBridge: '0x0b2402144Bb366A632D14B83F244D2e0e21bD39c',\n    },\n  },\n  polygon: {\n    name: 'Polygon',\n    chainId: 137,\n    wormholeChainId: 5,\n    rpcUrl: 'https://polygon-rpc.com',\n    explorerUrl: 'https://polygonscan.com',\n    isEvm: true,\n    contracts: {\n      wormholeCoreBridge: '0x7A4B5a56256163F07b2C80A7cA55aBE66c4ec4d7',\n      tokenBridge: '0x5a58505a96D1dbf8dF91cB21B54419FC36e93fdE',\n    },\n  },\n  solana: {\n    name: 'Solana',\n    chainId: 0,\n    wormholeChainId: 1,\n    rpcUrl: 'https://api.mainnet-beta.solana.com',\n    explorerUrl: 'https://explorer.solana.com',\n    isEvm: false,\n    contracts: {\n      wormholeCoreBridge: 'worm2ZoG2kUd4vFXhvjh93UUH596ayRfgQ2MgjNMTth',\n      tokenBridge: 'wormDTUJ6AWPNvk59vGQbDvGJmqbDTdgWgAqcLBCgUb',\n    },\n  },\n  aptos: {\n    name: 'Aptos',\n    chainId: 0,\n    wormholeChainId: 22,\n    rpcUrl: 'https://fullnode.mainnet.aptoslabs.com/v1',\n    explorerUrl: 'https://explorer.aptoslabs.com',\n    isEvm: false,\n    contracts: {\n      wormholeCoreBridge: '0x5bc11445584a763c1fa7ed39081f1b920954da14e04b32440cba863d03e19625',\n      tokenBridge: '0x576410486a2da45eee6c949c995670112ddf2fbeedab20350d506328eefc9d4f',\n    },\n  },\n  sui: {\n    name: 'Sui',\n    chainId: 0,\n    wormholeChainId: 21,\n    rpcUrl: 'https://fullnode.mainnet.sui.io:443',\n    explorerUrl: 'https://suiscan.xyz/mainnet',\n    isEvm: false,\n    contracts: {\n      wormholeCoreBridge: '0xaeab97f96cf9877fee2883315d459552b2b921edc16d7ceac6eab944dd88919c',\n    },\n  },\n};\n\n// ============================================================================\n// Wormhole API Endpoints\n// ============================================================================\n\nexport const WORMHOLE_API = {\n  MAINNET: 'https://api.wormholescan.io',\n  TESTNET: 'https://api.testnet.wormholescan.io',\n  GUARDIAN_RPC_MAINNET: 'https://wormhole-v2-mainnet-api.certus.one',\n  GUARDIAN_RPC_TESTNET: 'https://wormhole-v2-testnet-api.certus.one',\n} as const;\n\n// ============================================================================\n// Hub Contract ABI (minimal)\n// ============================================================================\n\nexport const HUB_ABI = [\n  'function authenticateAndDispatch((bytes authenticatorData, string clientDataJSON, uint256 challengeIndex, uint256 typeIndex, uint256 r, uint256 s) auth, uint256 publicKeyX, uint256 publicKeyY, uint16 targetChain, bytes actionPayload) external payable returns (uint64 sequence)',\n  'function authenticateRawAndDispatch(uint256 r, uint256 s, bytes32 messageHash, uint256 publicKeyX, uint256 publicKeyY, uint16 targetChain, bytes actionPayload, uint256 nonce) external payable returns (uint64 sequence)',\n  'function getNonce(bytes32 userKeyHash) external view returns (uint256)',\n  'function encodeTransferAction(address token, address recipient, uint256 amount) external pure returns (bytes)',\n  'function encodeExecuteAction(address target, uint256 value, bytes data) external pure returns (bytes)',\n  'function encodeBridgeAction(bytes32 token, uint256 amount, uint16 targetChain, bytes32 recipient) external pure returns (bytes)',\n  'function messageFee() external view returns (uint256)',\n  'event Dispatched(bytes32 indexed userKeyHash, uint16 targetChain, uint256 nonce, uint64 sequence, bytes actionPayload)',\n] as const;\n\n// ============================================================================\n// Vault Factory ABI (minimal)\n// ============================================================================\n\nexport const VAULT_FACTORY_ABI = [\n  'function createVault(bytes32 userKeyHash) external returns (address)',\n  'function getVault(bytes32 userKeyHash) external view returns (address)',\n  'function vaultExists(bytes32 userKeyHash) external view returns (bool)',\n  'event VaultCreated(bytes32 indexed userKeyHash, address vault)',\n] as const;\n\n// ============================================================================\n// Vault ABI (minimal)\n// ============================================================================\n\nexport const VAULT_ABI = [\n  'function execute(address target, uint256 value, bytes data) external returns (bytes)',\n  'function executeFromHub(bytes32 vaaHash, uint16 emitterChain, bytes32 emitterAddress, bytes payload) external',\n  'function owner() external view returns (bytes32)',\n  'function hub() external view returns (address)',\n  'receive() external payable',\n] as const;\n"],"mappings":"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","names":[]}

package/dist/wormhole.d.mts

@@ -0,0 +1,167 @@
+import { ethers } from 'ethers';
+import { VAA, VeridexPayload } from './types.mjs';
+
+/**
+ * Veridex Protocol SDK - Wormhole Utilities
+ *
+ * Functions for fetching VAAs, parsing messages, and interacting with Wormhole
+ *
+ * This module integrates with the official @wormhole-foundation/sdk patterns for
+ * better chain abstraction and reliability, while providing Veridex-specific
+ * utilities for payload handling and VAA management.
+ */
+
+/**
+ * Wormhole Consistency Levels
+ * @see https://docs.wormhole.com/wormhole/reference/glossary#consistency-level
+ */
+declare const CONSISTENCY_LEVELS: {
+    /** Finalized - Wait for block finality (most secure) */
+    readonly FINALIZED: 200;
+    /** Instant - No wait for finality (fastest, less secure) */
+    readonly INSTANT: 201;
+    /** Safe - Standard finality (deprecated, use FINALIZED) */
+    readonly SAFE: 200;
+};
+/**
+ * Guardian network configuration
+ */
+declare const GUARDIAN_CONFIG: {
+    /** Total number of guardians in mainnet */
+    readonly MAINNET_GUARDIAN_COUNT: 19;
+    /** Required signatures for mainnet quorum (13/19) */
+    readonly MAINNET_QUORUM: 13;
+    /** Total number of guardians in testnet */
+    readonly TESTNET_GUARDIAN_COUNT: 1;
+    /** Required signatures for testnet quorum */
+    readonly TESTNET_QUORUM: 1;
+};
+interface FetchVAAOptions {
+    testnet?: boolean;
+    maxRetries?: number;
+    retryDelayMs?: number;
+    onRetry?: (attempt: number, maxRetries: number) => void;
+}
+interface WaitForSignaturesOptions {
+    testnet?: boolean;
+    requiredSignatures?: number;
+    maxWaitMs?: number;
+    checkIntervalMs?: number;
+    onProgress?: (currentSignatures: number, required: number) => void;
+}
+/**
+ * Fetch a VAA from Wormhole guardians by sequence number
+ *
+ * @example
+ * ```ts
+ * const vaa = await fetchVAA(
+ *   WORMHOLE_CHAIN_IDS.TESTNET.BASE_SEPOLIA,
+ *   '0x000...hubAddress',
+ *   97n,
+ *   { testnet: true }
+ * );
+ * ```
+ */
+declare function fetchVAA(emitterChain: number, emitterAddress: string, sequence: bigint, options?: FetchVAAOptions): Promise<string>;
+/**
+ * Fetch VAA by transaction hash using operations API
+ * This is more reliable than the transactions API when sequence numbers don't match
+ */
+declare function fetchVAAByTxHash(txHash: string, options?: {
+    testnet?: boolean;
+    maxRetries?: number;
+    retryDelayMs?: number;
+    onRetry?: (attempt: number, maxRetries: number) => void;
+}): Promise<string>;
+/**
+ * Fetch VAA by transaction hash using transactions API (fallback)
+ */
+declare function fetchVAAByTxHashFallback(txHash: string, options?: {
+    testnet?: boolean;
+    maxRetries?: number;
+    retryDelayMs?: number;
+    onRetry?: (attempt: number, maxRetries: number) => void;
+}): Promise<string>;
+/**
+ * Parse a base64-encoded VAA into its components
+ */
+declare function parseVAA(vaaBase64: string): VAA;
+/**
+ * Parse raw VAA bytes into its components
+ */
+declare function parseVAABytes(vaaBytes: Buffer): VAA;
+/**
+ * Parse a Veridex-specific payload from a VAA
+ */
+declare function parseVeridexPayload(payloadHex: string): VeridexPayload;
+/**
+ * Encode a VAA back to bytes for on-chain submission
+ */
+declare function encodeVAAToBytes(vaaBase64: string): string;
+/**
+ * Encode VAA to bytes for Solana (returns Uint8Array)
+ */
+declare function encodeVAAForSolana(vaaBase64: string): Uint8Array;
+/**
+ * Normalize an address to a 32-byte Wormhole emitter address format
+ */
+declare function normalizeEmitterAddress(address: string): string;
+/**
+ * Convert a 32-byte emitter address back to a 20-byte EVM address
+ */
+declare function emitterToEvmAddress(emitterHex: string): string;
+/**
+ * Extract the VAA sequence from a transaction receipt
+ */
+declare function getSequenceFromTxReceipt(provider: ethers.Provider, txHash: string, wormholeCoreBridge: string): Promise<bigint>;
+/**
+ * Wait for a Wormhole message to be signed by guardians
+ *
+ * @example
+ * ```ts
+ * const vaa = await waitForGuardianSignatures(
+ *   WORMHOLE_CHAIN_IDS.TESTNET.BASE_SEPOLIA,
+ *   hubEmitter,
+ *   97n,
+ *   {
+ *     testnet: true,
+ *     onProgress: (current, required) => console.log(`${current}/${required} signatures`)
+ *   }
+ * );
+ * ```
+ */
+declare function waitForGuardianSignatures(emitterChain: number, emitterAddress: string, sequence: bigint, options?: WaitForSignaturesOptions): Promise<VAA>;
+/**
+ * Get the Wormhole Core Bridge contract address for a chain
+ */
+declare function getWormholeCoreBridge(wormholeChainId: number, testnet?: boolean): string;
+/**
+ * Get the Wormhole Token Bridge contract address for a chain
+ */
+declare function getWormholeTokenBridge(wormholeChainId: number, testnet?: boolean): string;
+/**
+ * Get the Wormhole Relayer contract address for a chain
+ */
+declare function getWormholeRelayer(wormholeChainId: number, testnet?: boolean): string;
+/**
+ * Check if a chain supports Wormhole Relayer
+ */
+declare function supportsRelayer(wormholeChainId: number, testnet?: boolean): boolean;
+/**
+ * Get chain name from Wormhole chain ID
+ */
+declare function getChainName(wormholeChainId: number): string;
+/**
+ * Validate that a VAA has sufficient signatures for the given network
+ */
+declare function hasQuorum(vaa: VAA, testnet?: boolean): boolean;
+/**
+ * Validate VAA emitter matches expected source
+ */
+declare function validateEmitter(vaa: VAA, expectedChain: number, expectedAddress: string): boolean;
+/**
+ * Convert an EVM address to bytes32 format (for Wormhole)
+ */
+declare function evmAddressToBytes32(address: string): string;
+
+export { CONSISTENCY_LEVELS, type FetchVAAOptions, GUARDIAN_CONFIG, type WaitForSignaturesOptions, emitterToEvmAddress, encodeVAAForSolana, encodeVAAToBytes, evmAddressToBytes32, fetchVAA, fetchVAAByTxHash, fetchVAAByTxHashFallback, getChainName, getSequenceFromTxReceipt, getWormholeCoreBridge, getWormholeRelayer, getWormholeTokenBridge, hasQuorum, normalizeEmitterAddress, parseVAA, parseVAABytes, parseVeridexPayload, supportsRelayer, validateEmitter, waitForGuardianSignatures };