@veridex/sdk 1.0.0-beta.1 → 1.0.0-beta.11

package/dist/chains/solana/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/chains/solana/index.ts","../../../src/chains/solana/SolanaClient.ts","../../../src/payload.ts","../../../src/constants.ts"],"sourcesContent":["/**\n * Veridex Protocol SDK - Solana Chain Module\n */\n\nexport { SolanaClient } from './SolanaClient.js';\nexport type { SolanaClientConfig } from './SolanaClient.js';\n","/**\n * Veridex Protocol SDK - Solana Chain Client\n * \n * Implementation of ChainClient interface for Solana blockchain\n */\n\nimport {\n    Connection,\n    PublicKey,\n} from '@solana/web3.js';\nimport {\n    getAssociatedTokenAddressSync,\n} from '@solana/spl-token';\nimport { createHash } from 'crypto';\nimport type {\n    ChainClient,\n    ChainConfig,\n    TransferParams,\n    ExecuteParams,\n    BridgeParams,\n    DispatchResult,\n    WebAuthnSignature,\n    VaultCreationResult,\n} from '../../core/types.js';\nimport { encodeTransferAction, encodeExecuteAction, encodeBridgeAction } from '../../payload.js';\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface SolanaClientConfig {\n    wormholeChainId: number;\n    rpcUrl: string;\n    programId: string; // Veridex Spoke program\n    wormholeCoreBridge: string;\n    tokenBridge: string;\n    network?: 'mainnet' | 'devnet' | 'testnet';\n    commitment?: 'processed' | 'confirmed' | 'finalized';\n}\n\n// ============================================================================\n// Constants\n// ============================================================================\n\n// ============================================================================\n// SolanaClient Class\n// ============================================================================\n\n/**\n * Solana implementation of the ChainClient interface\n */\nexport class SolanaClient implements ChainClient {\n    private config: ChainConfig;\n    private connection: Connection;\n    private programId: PublicKey;\n\n    constructor(config: SolanaClientConfig) {\n        this.config = {\n            name: `Solana ${config.network || 'mainnet'}`,\n            chainId: config.wormholeChainId,\n            wormholeChainId: config.wormholeChainId,\n            rpcUrl: config.rpcUrl,\n            explorerUrl: config.network === 'devnet'\n                ? 'https://explorer.solana.com?cluster=devnet'\n                : 'https://explorer.solana.com',\n            isEvm: false,\n            contracts: {\n                hub: undefined, // Solana is a spoke only\n                wormholeCoreBridge: config.wormholeCoreBridge,\n                tokenBridge: config.tokenBridge,\n            },\n        };\n\n        this.connection = new Connection(\n            config.rpcUrl,\n            config.commitment || 'confirmed'\n        );\n        this.programId = new PublicKey(config.programId);\n    }\n\n    getConfig(): ChainConfig {\n        return this.config;\n    }\n\n    async getNonce(userKeyHash: string): Promise<bigint> {\n        try {\n            const vaultAddress = this.computeVaultAddressFromHash(userKeyHash);\n            const accountInfo = await this.connection.getAccountInfo(new PublicKey(vaultAddress));\n\n            if (!accountInfo || accountInfo.data.length < 40) {\n                return 0n;\n            }\n\n            // Nonce is stored at offset 8 (after discriminator)\n            // Read as u64 little-endian\n            const nonce = accountInfo.data.readBigUInt64LE(8);\n            return nonce;\n        } catch (error) {\n            console.error('Error getting nonce:', error);\n            return 0n;\n        }\n    }\n\n    async getMessageFee(): Promise<bigint> {\n        try {\n            // Query Wormhole bridge for message fee\n            // For now, return a default estimate\n            // TODO: Query on-chain Wormhole config account\n            return 0n; // Solana doesn't charge a Wormhole fee in the same way\n        } catch (error) {\n            console.error('Error getting message fee:', error);\n            return 0n;\n        }\n    }\n\n    async buildTransferPayload(params: TransferParams): Promise<string> {\n        return encodeTransferAction(\n            params.token,\n            params.recipient,\n            params.amount\n        );\n    }\n\n    async buildExecutePayload(params: ExecuteParams): Promise<string> {\n        return encodeExecuteAction(\n            params.target,\n            params.value,\n            params.data\n        );\n    }\n\n    async buildBridgePayload(params: BridgeParams): Promise<string> {\n        return encodeBridgeAction(\n            params.token,\n            params.amount,\n            params.destinationChain,\n            params.recipient\n        );\n    }\n\n    async dispatch(\n        signature: WebAuthnSignature,\n        publicKeyX: bigint,\n        publicKeyY: bigint,\n        targetChain: number,\n        actionPayload: string,\n        nonce: bigint,\n        signer: any // Solana Keypair or similar\n    ): Promise<DispatchResult> {\n        void signature;\n        void publicKeyX;\n        void publicKeyY;\n        void targetChain;\n        void actionPayload;\n        void nonce;\n        void signer;\n        throw new Error(\n            'Direct dispatch not supported on Solana spoke chains. ' +\n            'Actions must be dispatched from the Hub (EVM) chain. ' +\n            'This client is for receiving cross-chain messages only.'\n        );\n    }\n\n    /**\n     * Dispatch an action via relayer (gasless)\n     * Note: On Solana, this still goes through the Hub chain\n     * Solana is a spoke-only chain in Veridex architecture\n     */\n    async dispatchGasless(\n        signature: WebAuthnSignature,\n        publicKeyX: bigint,\n        publicKeyY: bigint,\n        targetChain: number,\n        actionPayload: string,\n        nonce: bigint,\n        relayerUrl: string\n    ): Promise<DispatchResult> {\n        // Compute key hash\n        const keyHash = this.computeKeyHash(publicKeyX, publicKeyY);\n\n        // Build the message that was signed (matches Hub chain format)\n        const message = this.buildMessage(keyHash, targetChain, actionPayload, nonce);\n\n        // Prepare request for relayer\n        const request = {\n            messageHash: message,\n            r: '0x' + signature.r.toString(16).padStart(64, '0'),\n            s: '0x' + signature.s.toString(16).padStart(64, '0'),\n            publicKeyX: '0x' + publicKeyX.toString(16).padStart(64, '0'),\n            publicKeyY: '0x' + publicKeyY.toString(16).padStart(64, '0'),\n            targetChain,\n            actionPayload,\n            nonce: Number(nonce),\n        };\n\n        // Submit to relayer\n        const response = await fetch(`${relayerUrl}/api/v1/submit`, {\n            method: 'POST',\n            headers: {\n                'Content-Type': 'application/json',\n            },\n            body: JSON.stringify(request),\n        });\n\n        if (!response.ok) {\n            const error = await response.json().catch(() => ({ error: response.statusText }));\n            throw new Error(`Relayer submission failed: ${error.error || response.statusText}`);\n        }\n\n        const result = await response.json();\n\n        if (!result.success) {\n            throw new Error(`Relayer submission failed: ${result.error}`);\n        }\n\n        return {\n            transactionHash: result.txHash,\n            sequence: BigInt(result.sequence || '0'),\n            userKeyHash: keyHash,\n            targetChain,\n        };\n    }\n\n    async getVaultAddress(userKeyHash: string): Promise<string | null> {\n        try {\n            const vaultAddress = this.computeVaultAddressFromHash(userKeyHash);\n            const accountInfo = await this.connection.getAccountInfo(new PublicKey(vaultAddress));\n\n            if (!accountInfo) {\n                return null;\n            }\n\n            return vaultAddress;\n        } catch (error) {\n            console.error('Error getting vault address:', error);\n            return null;\n        }\n    }\n\n    /**\n     * Compute vault address using PDA (Program Derived Address)\n     * Seeds: [\"vault\", userKeyHash]\n     */\n    computeVaultAddress(userKeyHash: string): string {\n        return this.computeVaultAddressFromHash(userKeyHash);\n    }\n\n    private computeVaultAddressFromHash(userKeyHash: string): string {\n        const userKeyHashBuffer = Buffer.from(userKeyHash.replace('0x', ''), 'hex');\n        const [vaultPda] = PublicKey.findProgramAddressSync(\n            [Buffer.from('vault'), userKeyHashBuffer],\n            this.programId\n        );\n        return vaultPda.toBase58();\n    }\n\n    async vaultExists(userKeyHash: string): Promise<boolean> {\n        const address = await this.getVaultAddress(userKeyHash);\n        return address !== null;\n    }\n\n    async createVault(userKeyHash: string, signer: any): Promise<VaultCreationResult> {\n        void userKeyHash;\n        void signer;\n        throw new Error(\n            'Vault creation on Solana must be done via relayer. ' +\n            'Use createVaultViaRelayer() instead.'\n        );\n    }\n\n    async createVaultSponsored?(\n        userKeyHash: string,\n        sponsorPrivateKey: string,\n        rpcUrl?: string\n    ): Promise<VaultCreationResult> {\n        void userKeyHash;\n        void sponsorPrivateKey;\n        void rpcUrl;\n        throw new Error(\n            'Vault creation on Solana must be done via relayer. ' +\n            'Use createVaultViaRelayer() instead.'\n        );\n    }\n\n    /**\n     * Create a vault via the relayer (sponsored/gasless)\n     * This is the recommended way to create Solana vaults\n     */\n    async createVaultViaRelayer(\n        userKeyHash: string,\n        relayerUrl: string\n    ): Promise<VaultCreationResult> {\n        const response = await fetch(`${relayerUrl}/api/v1/solana/vault`, {\n            method: 'POST',\n            headers: {\n                'Content-Type': 'application/json',\n            },\n            body: JSON.stringify({\n                userKeyHash,\n                chainId: this.config.wormholeChainId,\n            }),\n        });\n\n        const result = await response.json();\n\n        if (!response.ok || !result.success) {\n            throw new Error(result.error || 'Failed to create vault via relayer');\n        }\n\n        return {\n            address: result.vaultAddress,\n            transactionHash: result.transactionHash || '',\n            blockNumber: 0, // Solana doesn't have block numbers like EVM\n            gasUsed: 0n, // Solana uses compute units, not gas\n            alreadyExisted: !result.transactionHash,\n            sponsoredBy: 'relayer',\n        };\n    }\n\n    /**\n     * Get vault info via relayer (includes existence check)\n     */\n    async getVaultViaRelayer(\n        userKeyHash: string,\n        relayerUrl: string\n    ): Promise<{ vaultAddress: string; exists: boolean }> {\n        const response = await fetch(\n            `${relayerUrl}/api/v1/solana/vault/${userKeyHash}?chainId=${this.config.wormholeChainId}`\n        );\n\n        if (!response.ok) {\n            throw new Error('Failed to get vault info from relayer');\n        }\n\n        const result = await response.json();\n        return {\n            vaultAddress: result.vaultAddress,\n            exists: result.exists,\n        };\n    }\n\n    async estimateVaultCreationGas(userKeyHash: string): Promise<bigint> {\n        void userKeyHash;\n        // Return SOL estimate for vault creation (rent + compute)\n        // ~0.002 SOL for rent-exempt account + compute units\n        return 2_000_000n; // 0.002 SOL in lamports\n    }\n\n    getFactoryAddress(): string | undefined {\n        // Solana uses program addresses, not factory pattern\n        return undefined;\n    }\n\n    getImplementationAddress(): string | undefined {\n        // Solana uses program addresses, not implementation pattern\n        return undefined;\n    }\n\n    // ========================================================================\n    // Balance Methods\n    // ========================================================================\n\n    /**\n     * Get native SOL balance\n     */\n    async getNativeBalance(address: string): Promise<bigint> {\n        const balance = await this.connection.getBalance(new PublicKey(address));\n        return BigInt(balance);\n    }\n\n    /**\n     * Get SPL token balance\n     */\n    async getTokenBalance(tokenAddress: string, ownerAddress: string): Promise<bigint> {\n        try {\n            const mint = new PublicKey(tokenAddress);\n            const owner = new PublicKey(ownerAddress);\n            const ata = getAssociatedTokenAddressSync(mint, owner);\n\n            const balance = await this.connection.getTokenAccountBalance(ata);\n            return BigInt(balance.value.amount);\n        } catch (error) {\n            console.error('Error getting token balance:', error);\n            return 0n;\n        }\n    }\n\n    // ========================================================================\n    // Utility Methods\n    // ========================================================================\n\n    /**\n     * Compute key hash from public key coordinates\n     * Matches EVM keccak256(abi.encode(publicKeyX, publicKeyY))\n     */\n    private computeKeyHash(publicKeyX: bigint, publicKeyY: bigint): string {\n        // Use SHA-256 for Solana (Solana doesn't have keccak256 built-in)\n        // The relayer will convert this to match EVM format\n        const xBuffer = Buffer.alloc(32);\n        const yBuffer = Buffer.alloc(32);\n\n        // Write as big-endian to match EVM encoding\n        const xHex = publicKeyX.toString(16).padStart(64, '0');\n        const yHex = publicKeyY.toString(16).padStart(64, '0');\n\n        Buffer.from(xHex, 'hex').copy(xBuffer);\n        Buffer.from(yHex, 'hex').copy(yBuffer);\n\n        // For cross-chain compatibility, we need to match the EVM hash\n        // This should be keccak256, but we'll return a format the relayer expects\n        const combined = Buffer.concat([xBuffer, yBuffer]);\n        const hash = createHash('sha256').update(combined).digest();\n\n        return '0x' + hash.toString('hex');\n    }\n\n    /**\n     * Build message for signing (matches Hub chain format)\n     */\n    private buildMessage(\n        keyHash: string,\n        targetChain: number,\n        actionPayload: string,\n        nonce: bigint\n    ): string {\n        // This should match the EVM message format for cross-chain compatibility\n        const keyHashBuffer = Buffer.from(keyHash.replace('0x', ''), 'hex');\n        const targetChainBuffer = Buffer.alloc(2);\n        targetChainBuffer.writeUInt16BE(targetChain);\n        const payloadBuffer = Buffer.from(actionPayload.replace('0x', ''), 'hex');\n        const nonceBuffer = Buffer.alloc(32);\n        const nonceHex = nonce.toString(16).padStart(64, '0');\n        Buffer.from(nonceHex, 'hex').copy(nonceBuffer);\n\n        const combined = Buffer.concat([\n            keyHashBuffer,\n            targetChainBuffer,\n            payloadBuffer,\n            nonceBuffer,\n        ]);\n\n        const hash = createHash('sha256').update(combined).digest();\n        return '0x' + hash.toString('hex');\n    }\n\n    /**\n     * Get connection instance for advanced usage\n     */\n    getConnection(): Connection {\n        return this.connection;\n    }\n\n    /**\n     * Get program ID\n     */\n    getProgramId(): PublicKey {\n        return this.programId;\n    }\n\n    /**\n     * Get current slot\n     */\n    async getSlot(): Promise<number> {\n        return await this.connection.getSlot();\n    }\n\n    /**\n     * Get transaction status\n     */\n    async getTransaction(signature: string, commitment?: 'confirmed' | 'finalized') {\n        return await this.connection.getTransaction(signature, {\n            commitment: commitment || 'confirmed',\n            maxSupportedTransactionVersion: 0,\n        });\n    }\n\n    // ============================================================================\n    // Social Recovery Methods (Issue #23)\n    // ============================================================================\n    // \n    // Note: Social recovery is managed on the Hub chain (EVM).\n    // Solana spokes receive and execute recovery VAAs broadcast from the Hub.\n    // These methods are placeholders that indicate spoke-only chains don't\n    // initiate recovery - they only execute recovery instructions from Hub VAAs.\n    //\n    // The relayer service handles:\n    // 1. Fetching recovery VAAs from Wormhole guardians\n    // 2. Submitting execute_recovery instruction to Solana spoke\n    // 3. Processing OwnerRecovered events\n    //\n    // SDK users should use EVMClient methods for guardian management and\n    // recovery initiation on the Hub chain.\n    // ============================================================================\n\n    /**\n     * Check if a recovery VAA has been executed on this spoke\n     * \n     * @param vaaHash - Hash of the recovery VAA\n     * @returns Whether the VAA has been processed\n     */\n    async isRecoveryExecuted(vaaHash: string): Promise<boolean> {\n        try {\n            // Derive VAA record PDA\n            const vaaHashBuffer = Buffer.from(vaaHash.replace('0x', ''), 'hex');\n            const [vaaRecordPda] = PublicKey.findProgramAddressSync(\n                [Buffer.from('vaa_record'), vaaHashBuffer],\n                this.programId\n            );\n\n            const accountInfo = await this.connection.getAccountInfo(vaaRecordPda);\n            if (!accountInfo || accountInfo.data.length < 9) {\n                return false;\n            }\n\n            // First byte after discriminator is 'processed' bool\n            return accountInfo.data[8] === 1;\n        } catch (error) {\n            console.error('Error checking recovery execution:', error);\n            return false;\n        }\n    }\n\n    /**\n     * Get vault owner after potential recovery\n     * \n     * @param vaultAddress - Vault address to check\n     * @returns Current owner key hash\n     */\n    async getVaultOwner(vaultAddress: string): Promise<string> {\n        try {\n            const accountInfo = await this.connection.getAccountInfo(new PublicKey(vaultAddress));\n            if (!accountInfo || accountInfo.data.length < 40) {\n                throw new Error('Vault not found');\n            }\n\n            // Owner key hash is stored after discriminator (8 bytes) at offset 8-40\n            const ownerKeyHash = accountInfo.data.slice(8, 40);\n            return '0x' + ownerKeyHash.toString('hex');\n        } catch (error) {\n            console.error('Error getting vault owner:', error);\n            throw error;\n        }\n    }\n\n    /**\n     * Get authorized signers for a vault\n     * \n     * @param vaultAddress - Vault address to check\n     * @returns Array of authorized signer key hashes\n     */\n    async getAuthorizedSigners(vaultAddress: string): Promise<string[]> {\n        try {\n            const accountInfo = await this.connection.getAccountInfo(new PublicKey(vaultAddress));\n            if (!accountInfo || accountInfo.data.length < 235) {\n                throw new Error('Vault not found');\n            }\n\n            // Vault layout:\n            // 8 bytes discriminator\n            // 32 bytes owner_key_hash\n            // 8 bytes nonce\n            // 1 byte paused\n            // 8 bytes daily_limit\n            // 8 bytes daily_spent\n            // 8 bytes day_start\n            // 1 byte bump\n            // 1 byte authorized_signer_count\n            // 5 * 32 bytes authorized_signers\n\n            const signerCount = accountInfo.data[66]; // offset 8+32+8+1+8+8+1 = 66\n            const signers: string[] = [];\n\n            for (let i = 0; i < signerCount; i++) {\n                const offset = 67 + (i * 32); // Start of authorized_signers array\n                const keyHash = accountInfo.data.slice(offset, offset + 32);\n                signers.push('0x' + keyHash.toString('hex'));\n            }\n\n            return signers;\n        } catch (error) {\n            console.error('Error getting authorized signers:', error);\n            throw error;\n        }\n    }\n}\n","/**\n * Veridex Protocol SDK - Payload Encoding/Decoding Utilities\n */\n\nimport { ethers } from 'ethers';\nimport {\n  ACTION_TRANSFER,\n  ACTION_EXECUTE,\n  ACTION_CONFIG,\n  ACTION_BRIDGE,\n  PROTOCOL_VERSION,\n} from './constants.js';\nimport type { TransferAction, BridgeAction, ExecuteAction, ActionPayload } from './types.js';\n\n// ============================================================================\n// Action Encoding\n// ============================================================================\n\n/**\n * Encode a transfer action payload\n * Format: [actionType(1)] [token(32)] [recipient(32)] [amount(32)]\n */\nexport function encodeTransferAction(\n  token: string,\n  recipient: string,\n  amount: bigint\n): string {\n  const tokenPadded = padTo32Bytes(token);\n  const recipientPadded = padTo32Bytes(recipient);\n  const amountBytes = ethers.zeroPadValue(ethers.toBeHex(amount), 32);\n\n  return ethers.concat([\n    ethers.toBeHex(ACTION_TRANSFER, 1),\n    tokenPadded,\n    recipientPadded,\n    amountBytes,\n  ]);\n}\n\n/**\n * Encode a bridge action payload\n * Format: [actionType(1)] [token(32)] [amount(32)] [targetChain(2)] [recipient(32)]\n */\nexport function encodeBridgeAction(\n  token: string,\n  amount: bigint,\n  targetChain: number,\n  recipient: string\n): string {\n  const tokenPadded = padTo32Bytes(token);\n  const amountBytes = ethers.zeroPadValue(ethers.toBeHex(amount), 32);\n  const targetChainBytes = ethers.toBeHex(targetChain, 2);\n  const recipientPadded = padTo32Bytes(recipient);\n\n  return ethers.concat([\n    ethers.toBeHex(ACTION_BRIDGE, 1),\n    tokenPadded,\n    amountBytes,\n    targetChainBytes,\n    recipientPadded,\n  ]);\n}\n\n/**\n * Encode an execute action payload (arbitrary contract call)\n * Format: [actionType(1)] [target(32)] [value(32)] [dataLength(2)] [data(variable)]\n */\nexport function encodeExecuteAction(\n  target: string,\n  value: bigint,\n  data: string\n): string {\n  const targetPadded = padTo32Bytes(target);\n  const valueBytes = ethers.zeroPadValue(ethers.toBeHex(value), 32);\n  const dataBytes = ethers.getBytes(data);\n  const dataLengthBytes = ethers.toBeHex(dataBytes.length, 2);\n\n  return ethers.concat([\n    ethers.toBeHex(ACTION_EXECUTE, 1),\n    targetPadded,\n    valueBytes,\n    dataLengthBytes,\n    data,\n  ]);\n}\n\n/**\n * Encode a config action payload\n * Format: [actionType(1)] [configType(1)] [configData(variable)]\n */\nexport function encodeConfigAction(configType: number, configData: string): string {\n  return ethers.concat([\n    ethers.toBeHex(ACTION_CONFIG, 1),\n    ethers.toBeHex(configType, 1),\n    configData,\n  ]);\n}\n\n// ============================================================================\n// Veridex Payload Encoding\n// ============================================================================\n\n/**\n * Encode the full Veridex message payload that gets published via Wormhole\n * Format: [version(1)] [userKeyHash(32)] [targetChain(2)] [nonce(32)] [pubKeyX(32)] [pubKeyY(32)] [actionPayload]\n */\nexport function encodeVeridexPayload(\n  userKeyHash: string,\n  targetChain: number,\n  nonce: bigint,\n  publicKeyX: bigint,\n  publicKeyY: bigint,\n  actionPayload: string\n): string {\n  return ethers.concat([\n    ethers.toBeHex(PROTOCOL_VERSION, 1),\n    userKeyHash,\n    ethers.toBeHex(targetChain, 2),\n    ethers.zeroPadValue(ethers.toBeHex(nonce), 32),\n    ethers.zeroPadValue(ethers.toBeHex(publicKeyX), 32),\n    ethers.zeroPadValue(ethers.toBeHex(publicKeyY), 32),\n    actionPayload,\n  ]);\n}\n\n// ============================================================================\n// Action Decoding\n// ============================================================================\n\n/**\n * Decode an action payload to determine its type and contents\n */\nexport function decodeActionPayload(payload: string): ActionPayload {\n  const data = ethers.getBytes(payload);\n  const actionType = data[0];\n\n  switch (actionType) {\n    case ACTION_TRANSFER:\n      return decodeTransferAction(payload);\n    case ACTION_BRIDGE:\n      return decodeBridgeAction(payload);\n    case ACTION_EXECUTE:\n      return decodeExecuteAction(payload);\n    default:\n      return { type: `unknown_${actionType}`, raw: payload };\n  }\n}\n\n/**\n * Decode a transfer action payload\n */\nexport function decodeTransferAction(payload: string): TransferAction {\n  const data = ethers.getBytes(payload);\n\n  const tokenBytes = data.slice(1, 33);\n  const recipientBytes = data.slice(33, 65);\n  const amountBytes = data.slice(65, 97);\n\n  return {\n    type: 'transfer',\n    token: trimTo20Bytes(ethers.hexlify(tokenBytes)),\n    recipient: trimTo20Bytes(ethers.hexlify(recipientBytes)),\n    amount: BigInt(ethers.hexlify(amountBytes)),\n  };\n}\n\n/**\n * Decode a bridge action payload\n */\nexport function decodeBridgeAction(payload: string): BridgeAction {\n  const data = ethers.getBytes(payload);\n\n  const tokenBytes = data.slice(1, 33);\n  const amountBytes = data.slice(33, 65);\n  const targetChainByte0 = data[65];\n  const targetChainByte1 = data[66];\n  const recipientBytes = data.slice(67, 99);\n\n  const targetChain = ((targetChainByte0 ?? 0) << 8) | (targetChainByte1 ?? 0);\n\n  return {\n    type: 'bridge',\n    token: trimTo20Bytes(ethers.hexlify(tokenBytes)),\n    amount: BigInt(ethers.hexlify(amountBytes)),\n    targetChain,\n    recipient: ethers.hexlify(recipientBytes),\n  };\n}\n\n/**\n * Decode an execute action payload\n */\nexport function decodeExecuteAction(payload: string): ExecuteAction {\n  const data = ethers.getBytes(payload);\n\n  const targetBytes = data.slice(1, 33);\n  const valueBytes = data.slice(33, 65);\n  const dataLengthByte0 = data[65];\n  const dataLengthByte1 = data[66];\n  const dataLength = ((dataLengthByte0 ?? 0) << 8) | (dataLengthByte1 ?? 0);\n  const callData = data.slice(67, 67 + dataLength);\n\n  return {\n    type: 'execute',\n    target: trimTo20Bytes(ethers.hexlify(targetBytes)),\n    value: BigInt(ethers.hexlify(valueBytes)),\n    data: ethers.hexlify(callData),\n  };\n}\n\n// ============================================================================\n// Chain-Specific Encodings\n// ============================================================================\n\n/**\n * Encode a Solana-compatible transfer action\n * Solana uses: [actionType(1)] [amount(8 LE)] [recipient(32)]\n */\nexport function encodeSolanaTransferAction(\n  amount: bigint,\n  recipient: string\n): string {\n  const amountBytes = Buffer.alloc(8);\n  amountBytes.writeBigUInt64LE(amount);\n\n  const recipientBytes = ethers.getBytes(recipient);\n\n  return ethers.hexlify(\n    Buffer.concat([\n      Buffer.from([ACTION_TRANSFER]),\n      amountBytes,\n      Buffer.from(recipientBytes),\n    ])\n  );\n}\n\n/**\n * Encode an Aptos-compatible transfer action\n * Aptos uses: [actionType(1)] [amount(8 LE)] [recipient(32)]\n */\nexport function encodeAptosTransferAction(\n  amount: bigint,\n  recipient: string\n): string {\n  const amountBytes = Buffer.alloc(8);\n  amountBytes.writeBigUInt64LE(amount);\n\n  const recipientPadded = padTo32Bytes(recipient);\n\n  return ethers.hexlify(\n    Buffer.concat([\n      Buffer.from([ACTION_TRANSFER]),\n      amountBytes,\n      Buffer.from(ethers.getBytes(recipientPadded)),\n    ])\n  );\n}\n\n/**\n * Encode a Sui-compatible transfer action\n * Sui uses: [actionType(1)] [amount(8 LE)] [recipient(32)]\n */\nexport function encodeSuiTransferAction(\n  amount: bigint,\n  recipient: string\n): string {\n  const amountBytes = Buffer.alloc(8);\n  amountBytes.writeBigUInt64LE(amount);\n\n  const recipientPadded = padTo32Bytes(recipient);\n\n  return ethers.hexlify(\n    Buffer.concat([\n      Buffer.from([ACTION_TRANSFER]),\n      amountBytes,\n      Buffer.from(ethers.getBytes(recipientPadded)),\n    ])\n  );\n}\n\n// ============================================================================\n// Address Utilities\n// ============================================================================\n\n/**\n * Pad an address to 32 bytes (Wormhole standard)\n * Supports both EVM addresses (0x...) and Solana addresses (base58)\n */\nexport function padTo32Bytes(address: string): string {\n  // Handle native token - convert to zero address\n  if (address.toLowerCase() === 'native') {\n    return '0x' + '0'.repeat(64);\n  }\n  \n  // If it starts with 0x, treat as hex\n  if (address.startsWith('0x')) {\n    const hex = address.replace('0x', '');\n    // Validate that hex only contains valid hex characters\n    if (!/^[0-9a-fA-F]*$/.test(hex)) {\n      throw new Error(`Invalid address: ${address}. Expected hex string or 'native'.`);\n    }\n    return '0x' + hex.padStart(64, '0');\n  }\n  \n  // Otherwise, assume base58 Solana address and decode it\n  // Base58 character set (Bitcoin/Solana style - no 0, O, I, l)\n  const base58Chars = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';\n  \n  // Validate base58 characters\n  for (const char of address) {\n    if (!base58Chars.includes(char)) {\n      throw new Error(`Invalid address: ${address}. Contains invalid base58 character '${char}'.`);\n    }\n  }\n  \n  // Decode base58 to bytes\n  let value = BigInt(0);\n  for (const char of address) {\n    value = value * 58n + BigInt(base58Chars.indexOf(char));\n  }\n  \n  // Convert to 32-byte hex\n  let hex = value.toString(16);\n  // Ensure it's not longer than 64 chars (32 bytes)\n  if (hex.length > 64) {\n    throw new Error(`Invalid address: ${address}. Decoded value too large for 32 bytes.`);\n  }\n  \n  return '0x' + hex.padStart(64, '0');\n}\n\n/**\n * Trim a 32-byte hex to a 20-byte EVM address\n */\nexport function trimTo20Bytes(hex32: string): string {\n  const clean = hex32.replace('0x', '');\n  return '0x' + clean.slice(-40);\n}\n\n/**\n * Convert a Solana public key (base58) to bytes32\n * @deprecated Use padTo32Bytes instead, which now handles both EVM and Solana addresses\n */\nexport function solanaAddressToBytes32(base58Address: string): string {\n  return padTo32Bytes(base58Address);\n}\n\n// ============================================================================\n// Amount Utilities\n// ============================================================================\n\n/**\n * Format an amount with decimals for display\n */\nexport function formatAmount(amount: bigint, decimals = 18): string {\n  const divisor = 10n ** BigInt(decimals);\n  const whole = amount / divisor;\n  const fraction = amount % divisor;\n\n  if (fraction === 0n) {\n    return whole.toString();\n  }\n\n  const fractionStr = fraction.toString().padStart(decimals, '0');\n  const trimmedFraction = fractionStr.replace(/0+$/, '');\n\n  return `${whole}.${trimmedFraction}`;\n}\n\n/**\n * Parse an amount string with decimals to bigint\n */\nexport function parseAmount(amountStr: string, decimals = 18): bigint {\n  const parts = amountStr.split('.');\n  const whole = BigInt(parts[0] ?? '0');\n\n  if (parts.length === 1 || !parts[1]) {\n    return whole * (10n ** BigInt(decimals));\n  }\n\n  const fractionStr = parts[1].slice(0, decimals).padEnd(decimals, '0');\n  const fraction = BigInt(fractionStr);\n\n  return whole * (10n ** BigInt(decimals)) + fraction;\n}\n\n// ============================================================================\n// Nonce Utilities\n// ============================================================================\n\n/**\n * Generate a unique nonce for a transaction\n */\nexport function generateNonce(): bigint {\n  const timestamp = BigInt(Date.now());\n  const random = BigInt(Math.floor(Math.random() * 1000000));\n  return (timestamp << 20n) | random;\n}\n\n/**\n * Create a message hash for signing (used in authenticateRawAndDispatch)\n */\nexport function createMessageHash(\n  targetChain: number,\n  actionPayload: string,\n  nonce: bigint\n): string {\n  return ethers.keccak256(\n    ethers.solidityPacked(\n      ['uint16', 'bytes', 'uint256'],\n      [targetChain, actionPayload, nonce]\n    )\n  );\n}\n\n/**\n * Create the challenge bytes for gasless dispatch (matches Hub's authenticateAndDispatch)\n * \n * The Hub contract passes raw packed bytes to WebAuthn.verify():\n * abi.encodePacked(targetChain, actionPayload, userNonce, hubChainId)\n * \n * The WebAuthn library then base64url-encodes these bytes to match against clientDataJSON.\n * We do NOT hash here - the challenge is the raw packed bytes.\n * \n * @param targetChain - Wormhole chain ID of the destination\n * @param actionPayload - The action payload (hex string)\n * @param nonce - User's current nonce\n * @param hubChainId - Wormhole chain ID of the Hub (e.g., 30 for Base)\n * @returns The packed bytes as hex string (NOT hashed)\n */\nexport function createGaslessMessageHash(\n  targetChain: number,\n  actionPayload: string,\n  nonce: bigint,\n  hubChainId: number\n): string {\n  // Return raw packed bytes - NO sha256 hash\n  // The contract passes these bytes directly to WebAuthn.verify()\n  return ethers.solidityPacked(\n    ['uint16', 'bytes', 'uint256', 'uint16'],\n    [targetChain, actionPayload, nonce, hubChainId]\n  );\n}\n\n/**\n * Build the challenge bytes for WebAuthn signing (gasless flow)\n * Returns raw packed bytes that match what the Hub contract expects\n * \n * @param targetChain - Wormhole chain ID of the destination\n * @param actionPayload - The action payload (hex string)\n * @param nonce - User's current nonce\n * @param hubChainId - Wormhole chain ID of the Hub\n * @returns Challenge bytes for WebAuthn signing (raw packed, not hashed)\n */\nexport function buildGaslessChallenge(\n  targetChain: number,\n  actionPayload: string,\n  nonce: bigint,\n  hubChainId: number\n): Uint8Array {\n  const packed = createGaslessMessageHash(targetChain, actionPayload, nonce, hubChainId);\n  return ethers.getBytes(packed);\n}\n\n/**\n * Build the challenge bytes for WebAuthn signing\n */\nexport function buildChallenge(\n  userKeyHash: string,\n  targetChain: number,\n  nonce: bigint,\n  actionPayload: string\n): Uint8Array {\n  const encoded = ethers.solidityPacked(\n    ['bytes32', 'uint16', 'uint256', 'bytes'],\n    [userKeyHash, targetChain, nonce, actionPayload]\n  );\n  return ethers.getBytes(ethers.keccak256(encoded));\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":["hex"]}
+{"version":3,"sources":["../../../src/chains/solana/index.ts","../../../src/chains/solana/SolanaClient.ts","../../../src/payload.ts","../../../src/constants.ts"],"sourcesContent":["/**\n * Veridex Protocol SDK - Solana Chain Module\n */\n\nexport { SolanaClient } from './SolanaClient.js';\nexport type { SolanaClientConfig } from './SolanaClient.js';\n","/**\n * Veridex Protocol SDK - Solana Chain Client\n * \n * Implementation of ChainClient interface for Solana blockchain\n */\n\nimport {\n    Connection,\n    PublicKey,\n} from '@solana/web3.js';\nimport {\n    getAssociatedTokenAddressSync,\n} from '@solana/spl-token';\nimport { createHash } from 'crypto';\nimport type {\n    ChainClient,\n    ChainConfig,\n    TransferParams,\n    ExecuteParams,\n    BridgeParams,\n    DispatchResult,\n    WebAuthnSignature,\n    VaultCreationResult,\n} from '../../core/types.js';\nimport { encodeTransferAction, encodeExecuteAction, encodeBridgeAction } from '../../payload.js';\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface SolanaClientConfig {\n    wormholeChainId: number;\n    rpcUrl: string;\n    programId: string; // Veridex Spoke program\n    wormholeCoreBridge: string;\n    tokenBridge: string;\n    network?: 'mainnet' | 'devnet' | 'testnet';\n    commitment?: 'processed' | 'confirmed' | 'finalized';\n}\n\n// ============================================================================\n// Constants\n// ============================================================================\n\n// ============================================================================\n// SolanaClient Class\n// ============================================================================\n\n/**\n * Solana implementation of the ChainClient interface\n */\nexport class SolanaClient implements ChainClient {\n    private config: ChainConfig;\n    private connection: Connection;\n    private programId: PublicKey;\n\n    constructor(config: SolanaClientConfig) {\n        this.config = {\n            name: `Solana ${config.network || 'mainnet'}`,\n            chainId: config.wormholeChainId,\n            wormholeChainId: config.wormholeChainId,\n            rpcUrl: config.rpcUrl,\n            explorerUrl: config.network === 'devnet'\n                ? 'https://explorer.solana.com?cluster=devnet'\n                : 'https://explorer.solana.com',\n            isEvm: false,\n            contracts: {\n                hub: undefined, // Solana is a spoke only\n                wormholeCoreBridge: config.wormholeCoreBridge,\n                tokenBridge: config.tokenBridge,\n            },\n        };\n\n        this.connection = new Connection(\n            config.rpcUrl,\n            config.commitment || 'confirmed'\n        );\n        this.programId = new PublicKey(config.programId);\n    }\n\n    getConfig(): ChainConfig {\n        return this.config;\n    }\n\n    async getNonce(userKeyHash: string): Promise<bigint> {\n        try {\n            const vaultAddress = this.computeVaultAddressFromHash(userKeyHash);\n            const accountInfo = await this.connection.getAccountInfo(new PublicKey(vaultAddress));\n\n            if (!accountInfo || accountInfo.data.length < 40) {\n                return 0n;\n            }\n\n            // Nonce is stored at offset 8 (after discriminator)\n            // Read as u64 little-endian\n            const nonce = accountInfo.data.readBigUInt64LE(8);\n            return nonce;\n        } catch (error) {\n            console.error('Error getting nonce:', error);\n            return 0n;\n        }\n    }\n\n    async getMessageFee(): Promise<bigint> {\n        try {\n            // Query Wormhole bridge for message fee\n            // For now, return a default estimate\n            // TODO: Query on-chain Wormhole config account\n            return 0n; // Solana doesn't charge a Wormhole fee in the same way\n        } catch (error) {\n            console.error('Error getting message fee:', error);\n            return 0n;\n        }\n    }\n\n    async buildTransferPayload(params: TransferParams): Promise<string> {\n        return encodeTransferAction(\n            params.token,\n            params.recipient,\n            params.amount\n        );\n    }\n\n    async buildExecutePayload(params: ExecuteParams): Promise<string> {\n        return encodeExecuteAction(\n            params.target,\n            params.value,\n            params.data\n        );\n    }\n\n    async buildBridgePayload(params: BridgeParams): Promise<string> {\n        return encodeBridgeAction(\n            params.token,\n            params.amount,\n            params.destinationChain,\n            params.recipient\n        );\n    }\n\n    async dispatch(\n        signature: WebAuthnSignature,\n        publicKeyX: bigint,\n        publicKeyY: bigint,\n        targetChain: number,\n        actionPayload: string,\n        nonce: bigint,\n        signer: any // Solana Keypair or similar\n    ): Promise<DispatchResult> {\n        void signature;\n        void publicKeyX;\n        void publicKeyY;\n        void targetChain;\n        void actionPayload;\n        void nonce;\n        void signer;\n        throw new Error(\n            'Direct dispatch not supported on Solana spoke chains. ' +\n            'Actions must be dispatched from the Hub (EVM) chain. ' +\n            'This client is for receiving cross-chain messages only.'\n        );\n    }\n\n    /**\n     * Dispatch an action via relayer (gasless)\n     * Note: On Solana, this still goes through the Hub chain\n     * Solana is a spoke-only chain in Veridex architecture\n     */\n    async dispatchGasless(\n        signature: WebAuthnSignature,\n        publicKeyX: bigint,\n        publicKeyY: bigint,\n        targetChain: number,\n        actionPayload: string,\n        nonce: bigint,\n        relayerUrl: string\n    ): Promise<DispatchResult> {\n        // Compute key hash\n        const keyHash = this.computeKeyHash(publicKeyX, publicKeyY);\n\n        // Build the message that was signed (matches Hub chain format)\n        const message = this.buildMessage(keyHash, targetChain, actionPayload, nonce);\n\n        // Prepare request for relayer\n        const request = {\n            messageHash: message,\n            r: '0x' + signature.r.toString(16).padStart(64, '0'),\n            s: '0x' + signature.s.toString(16).padStart(64, '0'),\n            publicKeyX: '0x' + publicKeyX.toString(16).padStart(64, '0'),\n            publicKeyY: '0x' + publicKeyY.toString(16).padStart(64, '0'),\n            targetChain,\n            actionPayload,\n            nonce: Number(nonce),\n        };\n\n        // Submit to relayer\n        const response = await fetch(`${relayerUrl}/api/v1/submit`, {\n            method: 'POST',\n            headers: {\n                'Content-Type': 'application/json',\n            },\n            body: JSON.stringify(request),\n        });\n\n        if (!response.ok) {\n            const error = await response.json().catch(() => ({ error: response.statusText }));\n            throw new Error(`Relayer submission failed: ${error.error || response.statusText}`);\n        }\n\n        const result = await response.json();\n\n        if (!result.success) {\n            throw new Error(`Relayer submission failed: ${result.error}`);\n        }\n\n        return {\n            transactionHash: result.txHash,\n            sequence: BigInt(result.sequence || '0'),\n            userKeyHash: keyHash,\n            targetChain,\n        };\n    }\n\n    async getVaultAddress(userKeyHash: string): Promise<string | null> {\n        try {\n            const vaultAddress = this.computeVaultAddressFromHash(userKeyHash);\n            const accountInfo = await this.connection.getAccountInfo(new PublicKey(vaultAddress));\n\n            if (!accountInfo) {\n                return null;\n            }\n\n            return vaultAddress;\n        } catch (error) {\n            console.error('Error getting vault address:', error);\n            return null;\n        }\n    }\n\n    /**\n     * Compute vault address using PDA (Program Derived Address)\n     * Seeds: [\"vault\", userKeyHash]\n     */\n    computeVaultAddress(userKeyHash: string): string {\n        return this.computeVaultAddressFromHash(userKeyHash);\n    }\n\n    private computeVaultAddressFromHash(userKeyHash: string): string {\n        const userKeyHashBuffer = Buffer.from(userKeyHash.replace('0x', ''), 'hex');\n        const [vaultPda] = PublicKey.findProgramAddressSync(\n            [Buffer.from('vault'), userKeyHashBuffer],\n            this.programId\n        );\n        return vaultPda.toBase58();\n    }\n\n    async vaultExists(userKeyHash: string): Promise<boolean> {\n        const address = await this.getVaultAddress(userKeyHash);\n        return address !== null;\n    }\n\n    async createVault(userKeyHash: string, signer: any): Promise<VaultCreationResult> {\n        void userKeyHash;\n        void signer;\n        throw new Error(\n            'Vault creation on Solana must be done via relayer. ' +\n            'Use createVaultViaRelayer() instead.'\n        );\n    }\n\n    async createVaultSponsored?(\n        userKeyHash: string,\n        sponsorPrivateKey: string,\n        rpcUrl?: string\n    ): Promise<VaultCreationResult> {\n        void userKeyHash;\n        void sponsorPrivateKey;\n        void rpcUrl;\n        throw new Error(\n            'Vault creation on Solana must be done via relayer. ' +\n            'Use createVaultViaRelayer() instead.'\n        );\n    }\n\n    /**\n     * Create a vault via the relayer (sponsored/gasless)\n     * This is the recommended way to create Solana vaults\n     */\n    async createVaultViaRelayer(\n        userKeyHash: string,\n        relayerUrl: string\n    ): Promise<VaultCreationResult> {\n        const response = await fetch(`${relayerUrl}/api/v1/solana/vault`, {\n            method: 'POST',\n            headers: {\n                'Content-Type': 'application/json',\n            },\n            body: JSON.stringify({\n                userKeyHash,\n                chainId: this.config.wormholeChainId,\n            }),\n        });\n\n        const result = await response.json();\n\n        if (!response.ok || !result.success) {\n            throw new Error(result.error || 'Failed to create vault via relayer');\n        }\n\n        return {\n            address: result.vaultAddress,\n            transactionHash: result.transactionHash || '',\n            blockNumber: 0, // Solana doesn't have block numbers like EVM\n            gasUsed: 0n, // Solana uses compute units, not gas\n            alreadyExisted: !result.transactionHash,\n            sponsoredBy: 'relayer',\n        };\n    }\n\n    /**\n     * Get vault info via relayer (includes existence check)\n     */\n    async getVaultViaRelayer(\n        userKeyHash: string,\n        relayerUrl: string\n    ): Promise<{ vaultAddress: string; exists: boolean }> {\n        const response = await fetch(\n            `${relayerUrl}/api/v1/solana/vault/${userKeyHash}?chainId=${this.config.wormholeChainId}`\n        );\n\n        if (!response.ok) {\n            throw new Error('Failed to get vault info from relayer');\n        }\n\n        const result = await response.json();\n        return {\n            vaultAddress: result.vaultAddress,\n            exists: result.exists,\n        };\n    }\n\n    async estimateVaultCreationGas(userKeyHash: string): Promise<bigint> {\n        void userKeyHash;\n        // Return SOL estimate for vault creation (rent + compute)\n        // ~0.002 SOL for rent-exempt account + compute units\n        return 2_000_000n; // 0.002 SOL in lamports\n    }\n\n    getFactoryAddress(): string | undefined {\n        // Solana uses program addresses, not factory pattern\n        return undefined;\n    }\n\n    getImplementationAddress(): string | undefined {\n        // Solana uses program addresses, not implementation pattern\n        return undefined;\n    }\n\n    // ========================================================================\n    // Balance Methods\n    // ========================================================================\n\n    /**\n     * Get native SOL balance\n     */\n    async getNativeBalance(address: string): Promise<bigint> {\n        const balance = await this.connection.getBalance(new PublicKey(address));\n        return BigInt(balance);\n    }\n\n    /**\n     * Get SPL token balance\n     */\n    async getTokenBalance(tokenAddress: string, ownerAddress: string): Promise<bigint> {\n        try {\n            const mint = new PublicKey(tokenAddress);\n            const owner = new PublicKey(ownerAddress);\n            const ata = getAssociatedTokenAddressSync(mint, owner);\n\n            const balance = await this.connection.getTokenAccountBalance(ata);\n            return BigInt(balance.value.amount);\n        } catch (error) {\n            console.error('Error getting token balance:', error);\n            return 0n;\n        }\n    }\n\n    // ========================================================================\n    // Utility Methods\n    // ========================================================================\n\n    /**\n     * Compute key hash from public key coordinates\n     * Matches EVM keccak256(abi.encode(publicKeyX, publicKeyY))\n     */\n    private computeKeyHash(publicKeyX: bigint, publicKeyY: bigint): string {\n        // Use SHA-256 for Solana (Solana doesn't have keccak256 built-in)\n        // The relayer will convert this to match EVM format\n        const xBuffer = Buffer.alloc(32);\n        const yBuffer = Buffer.alloc(32);\n\n        // Write as big-endian to match EVM encoding\n        const xHex = publicKeyX.toString(16).padStart(64, '0');\n        const yHex = publicKeyY.toString(16).padStart(64, '0');\n\n        Buffer.from(xHex, 'hex').copy(xBuffer);\n        Buffer.from(yHex, 'hex').copy(yBuffer);\n\n        // For cross-chain compatibility, we need to match the EVM hash\n        // This should be keccak256, but we'll return a format the relayer expects\n        const combined = Buffer.concat([xBuffer, yBuffer]);\n        const hash = createHash('sha256').update(combined).digest();\n\n        return '0x' + hash.toString('hex');\n    }\n\n    /**\n     * Build message for signing (matches Hub chain format)\n     */\n    private buildMessage(\n        keyHash: string,\n        targetChain: number,\n        actionPayload: string,\n        nonce: bigint\n    ): string {\n        // This should match the EVM message format for cross-chain compatibility\n        const keyHashBuffer = Buffer.from(keyHash.replace('0x', ''), 'hex');\n        const targetChainBuffer = Buffer.alloc(2);\n        targetChainBuffer.writeUInt16BE(targetChain);\n        const payloadBuffer = Buffer.from(actionPayload.replace('0x', ''), 'hex');\n        const nonceBuffer = Buffer.alloc(32);\n        const nonceHex = nonce.toString(16).padStart(64, '0');\n        Buffer.from(nonceHex, 'hex').copy(nonceBuffer);\n\n        const combined = Buffer.concat([\n            keyHashBuffer,\n            targetChainBuffer,\n            payloadBuffer,\n            nonceBuffer,\n        ]);\n\n        const hash = createHash('sha256').update(combined).digest();\n        return '0x' + hash.toString('hex');\n    }\n\n    /**\n     * Get connection instance for advanced usage\n     */\n    getConnection(): Connection {\n        return this.connection;\n    }\n\n    /**\n     * Get program ID\n     */\n    getProgramId(): PublicKey {\n        return this.programId;\n    }\n\n    /**\n     * Get current slot\n     */\n    async getSlot(): Promise<number> {\n        return await this.connection.getSlot();\n    }\n\n    /**\n     * Get transaction status\n     */\n    async getTransaction(signature: string, commitment?: 'confirmed' | 'finalized') {\n        return await this.connection.getTransaction(signature, {\n            commitment: commitment || 'confirmed',\n            maxSupportedTransactionVersion: 0,\n        });\n    }\n\n    // ============================================================================\n    // Social Recovery Methods (Issue #23)\n    // ============================================================================\n    // \n    // Note: Social recovery is managed on the Hub chain (EVM).\n    // Solana spokes receive and execute recovery VAAs broadcast from the Hub.\n    // These methods are placeholders that indicate spoke-only chains don't\n    // initiate recovery - they only execute recovery instructions from Hub VAAs.\n    //\n    // The relayer service handles:\n    // 1. Fetching recovery VAAs from Wormhole guardians\n    // 2. Submitting execute_recovery instruction to Solana spoke\n    // 3. Processing OwnerRecovered events\n    //\n    // SDK users should use EVMClient methods for guardian management and\n    // recovery initiation on the Hub chain.\n    // ============================================================================\n\n    /**\n     * Check if a recovery VAA has been executed on this spoke\n     * \n     * @param vaaHash - Hash of the recovery VAA\n     * @returns Whether the VAA has been processed\n     */\n    async isRecoveryExecuted(vaaHash: string): Promise<boolean> {\n        try {\n            // Derive VAA record PDA\n            const vaaHashBuffer = Buffer.from(vaaHash.replace('0x', ''), 'hex');\n            const [vaaRecordPda] = PublicKey.findProgramAddressSync(\n                [Buffer.from('vaa_record'), vaaHashBuffer],\n                this.programId\n            );\n\n            const accountInfo = await this.connection.getAccountInfo(vaaRecordPda);\n            if (!accountInfo || accountInfo.data.length < 9) {\n                return false;\n            }\n\n            // First byte after discriminator is 'processed' bool\n            return accountInfo.data[8] === 1;\n        } catch (error) {\n            console.error('Error checking recovery execution:', error);\n            return false;\n        }\n    }\n\n    /**\n     * Get vault owner after potential recovery\n     * \n     * @param vaultAddress - Vault address to check\n     * @returns Current owner key hash\n     */\n    async getVaultOwner(vaultAddress: string): Promise<string> {\n        try {\n            const accountInfo = await this.connection.getAccountInfo(new PublicKey(vaultAddress));\n            if (!accountInfo || accountInfo.data.length < 40) {\n                throw new Error('Vault not found');\n            }\n\n            // Owner key hash is stored after discriminator (8 bytes) at offset 8-40\n            const ownerKeyHash = accountInfo.data.slice(8, 40);\n            return '0x' + ownerKeyHash.toString('hex');\n        } catch (error) {\n            console.error('Error getting vault owner:', error);\n            throw error;\n        }\n    }\n\n    /**\n     * Get authorized signers for a vault\n     * \n     * @param vaultAddress - Vault address to check\n     * @returns Array of authorized signer key hashes\n     */\n    async getAuthorizedSigners(vaultAddress: string): Promise<string[]> {\n        try {\n            const accountInfo = await this.connection.getAccountInfo(new PublicKey(vaultAddress));\n            if (!accountInfo || accountInfo.data.length < 235) {\n                throw new Error('Vault not found');\n            }\n\n            // Vault layout:\n            // 8 bytes discriminator\n            // 32 bytes owner_key_hash\n            // 8 bytes nonce\n            // 1 byte paused\n            // 8 bytes daily_limit\n            // 8 bytes daily_spent\n            // 8 bytes day_start\n            // 1 byte bump\n            // 1 byte authorized_signer_count\n            // 5 * 32 bytes authorized_signers\n\n            const signerCount = accountInfo.data[66]; // offset 8+32+8+1+8+8+1 = 66\n            const signers: string[] = [];\n\n            for (let i = 0; i < signerCount; i++) {\n                const offset = 67 + (i * 32); // Start of authorized_signers array\n                const keyHash = accountInfo.data.slice(offset, offset + 32);\n                signers.push('0x' + keyHash.toString('hex'));\n            }\n\n            return signers;\n        } catch (error) {\n            console.error('Error getting authorized signers:', error);\n            throw error;\n        }\n    }\n}\n","/**\n * Veridex Protocol SDK - Payload Encoding/Decoding Utilities\n */\n\nimport { ethers } from 'ethers';\nimport {\n  ACTION_TRANSFER,\n  ACTION_EXECUTE,\n  ACTION_CONFIG,\n  ACTION_BRIDGE,\n  PROTOCOL_VERSION,\n} from './constants.js';\nimport type { TransferAction, BridgeAction, ExecuteAction, ActionPayload } from './types.js';\n\n// ============================================================================\n// Action Encoding\n// ============================================================================\n\n/**\n * Encode a transfer action payload\n * Format: [actionType(1)] [token(32)] [recipient(32)] [amount(32)]\n */\nexport function encodeTransferAction(\n  token: string,\n  recipient: string,\n  amount: bigint\n): string {\n  const tokenPadded = padTo32Bytes(token);\n  const recipientPadded = padTo32Bytes(recipient);\n  const amountBytes = ethers.zeroPadValue(ethers.toBeHex(amount), 32);\n\n  return ethers.concat([\n    ethers.toBeHex(ACTION_TRANSFER, 1),\n    tokenPadded,\n    recipientPadded,\n    amountBytes,\n  ]);\n}\n\n/**\n * Encode a bridge action payload\n * Format: [actionType(1)] [token(32)] [amount(32)] [targetChain(2)] [recipient(32)]\n */\nexport function encodeBridgeAction(\n  token: string,\n  amount: bigint,\n  targetChain: number,\n  recipient: string\n): string {\n  const tokenPadded = padTo32Bytes(token);\n  const amountBytes = ethers.zeroPadValue(ethers.toBeHex(amount), 32);\n  const targetChainBytes = ethers.toBeHex(targetChain, 2);\n  const recipientPadded = padTo32Bytes(recipient);\n\n  return ethers.concat([\n    ethers.toBeHex(ACTION_BRIDGE, 1),\n    tokenPadded,\n    amountBytes,\n    targetChainBytes,\n    recipientPadded,\n  ]);\n}\n\n/**\n * Encode an execute action payload (arbitrary contract call)\n * Format: [actionType(1)] [target(32)] [value(32)] [dataLength(2)] [data(variable)]\n */\nexport function encodeExecuteAction(\n  target: string,\n  value: bigint,\n  data: string\n): string {\n  const targetPadded = padTo32Bytes(target);\n  const valueBytes = ethers.zeroPadValue(ethers.toBeHex(value), 32);\n  const dataBytes = ethers.getBytes(data);\n  const dataLengthBytes = ethers.toBeHex(dataBytes.length, 2);\n\n  return ethers.concat([\n    ethers.toBeHex(ACTION_EXECUTE, 1),\n    targetPadded,\n    valueBytes,\n    dataLengthBytes,\n    data,\n  ]);\n}\n\n/**\n * Encode a config action payload\n * Format: [actionType(1)] [configType(1)] [configData(variable)]\n */\nexport function encodeConfigAction(configType: number, configData: string): string {\n  return ethers.concat([\n    ethers.toBeHex(ACTION_CONFIG, 1),\n    ethers.toBeHex(configType, 1),\n    configData,\n  ]);\n}\n\n// ============================================================================\n// Veridex Payload Encoding\n// ============================================================================\n\n/**\n * Encode the full Veridex message payload that gets published via Wormhole\n * Format: [version(1)] [userKeyHash(32)] [targetChain(2)] [nonce(32)] [pubKeyX(32)] [pubKeyY(32)] [actionPayload]\n */\nexport function encodeVeridexPayload(\n  userKeyHash: string,\n  targetChain: number,\n  nonce: bigint,\n  publicKeyX: bigint,\n  publicKeyY: bigint,\n  actionPayload: string\n): string {\n  return ethers.concat([\n    ethers.toBeHex(PROTOCOL_VERSION, 1),\n    userKeyHash,\n    ethers.toBeHex(targetChain, 2),\n    ethers.zeroPadValue(ethers.toBeHex(nonce), 32),\n    ethers.zeroPadValue(ethers.toBeHex(publicKeyX), 32),\n    ethers.zeroPadValue(ethers.toBeHex(publicKeyY), 32),\n    actionPayload,\n  ]);\n}\n\n// ============================================================================\n// Action Decoding\n// ============================================================================\n\n/**\n * Decode an action payload to determine its type and contents\n */\nexport function decodeActionPayload(payload: string): ActionPayload {\n  const data = ethers.getBytes(payload);\n  const actionType = data[0];\n\n  switch (actionType) {\n    case ACTION_TRANSFER:\n      return decodeTransferAction(payload);\n    case ACTION_BRIDGE:\n      return decodeBridgeAction(payload);\n    case ACTION_EXECUTE:\n      return decodeExecuteAction(payload);\n    default:\n      return { type: `unknown_${actionType}`, raw: payload };\n  }\n}\n\n/**\n * Decode a transfer action payload\n */\nexport function decodeTransferAction(payload: string): TransferAction {\n  const data = ethers.getBytes(payload);\n\n  const tokenBytes = data.slice(1, 33);\n  const recipientBytes = data.slice(33, 65);\n  const amountBytes = data.slice(65, 97);\n\n  return {\n    type: 'transfer',\n    token: trimTo20Bytes(ethers.hexlify(tokenBytes)),\n    recipient: trimTo20Bytes(ethers.hexlify(recipientBytes)),\n    amount: BigInt(ethers.hexlify(amountBytes)),\n  };\n}\n\n/**\n * Decode a bridge action payload\n */\nexport function decodeBridgeAction(payload: string): BridgeAction {\n  const data = ethers.getBytes(payload);\n\n  const tokenBytes = data.slice(1, 33);\n  const amountBytes = data.slice(33, 65);\n  const targetChainByte0 = data[65];\n  const targetChainByte1 = data[66];\n  const recipientBytes = data.slice(67, 99);\n\n  const targetChain = ((targetChainByte0 ?? 0) << 8) | (targetChainByte1 ?? 0);\n\n  return {\n    type: 'bridge',\n    token: trimTo20Bytes(ethers.hexlify(tokenBytes)),\n    amount: BigInt(ethers.hexlify(amountBytes)),\n    targetChain,\n    recipient: ethers.hexlify(recipientBytes),\n  };\n}\n\n/**\n * Decode an execute action payload\n */\nexport function decodeExecuteAction(payload: string): ExecuteAction {\n  const data = ethers.getBytes(payload);\n\n  const targetBytes = data.slice(1, 33);\n  const valueBytes = data.slice(33, 65);\n  const dataLengthByte0 = data[65];\n  const dataLengthByte1 = data[66];\n  const dataLength = ((dataLengthByte0 ?? 0) << 8) | (dataLengthByte1 ?? 0);\n  const callData = data.slice(67, 67 + dataLength);\n\n  return {\n    type: 'execute',\n    target: trimTo20Bytes(ethers.hexlify(targetBytes)),\n    value: BigInt(ethers.hexlify(valueBytes)),\n    data: ethers.hexlify(callData),\n  };\n}\n\n// ============================================================================\n// Chain-Specific Encodings\n// ============================================================================\n\n/**\n * Encode a Solana-compatible transfer action\n * Solana uses: [actionType(1)] [amount(8 LE)] [recipient(32)]\n */\nexport function encodeSolanaTransferAction(\n  amount: bigint,\n  recipient: string\n): string {\n  const amountBytes = Buffer.alloc(8);\n  amountBytes.writeBigUInt64LE(amount);\n\n  const recipientBytes = ethers.getBytes(recipient);\n\n  return ethers.hexlify(\n    Buffer.concat([\n      Buffer.from([ACTION_TRANSFER]),\n      amountBytes,\n      Buffer.from(recipientBytes),\n    ])\n  );\n}\n\n/**\n * Encode an Aptos-compatible transfer action\n * Aptos uses: [actionType(1)] [amount(8 LE)] [recipient(32)]\n */\nexport function encodeAptosTransferAction(\n  amount: bigint,\n  recipient: string\n): string {\n  const amountBytes = Buffer.alloc(8);\n  amountBytes.writeBigUInt64LE(amount);\n\n  const recipientPadded = padTo32Bytes(recipient);\n\n  return ethers.hexlify(\n    Buffer.concat([\n      Buffer.from([ACTION_TRANSFER]),\n      amountBytes,\n      Buffer.from(ethers.getBytes(recipientPadded)),\n    ])\n  );\n}\n\n/**\n * Encode a Sui-compatible transfer action\n * Sui uses: [actionType(1)] [amount(8 LE)] [recipient(32)]\n */\nexport function encodeSuiTransferAction(\n  amount: bigint,\n  recipient: string\n): string {\n  const amountBytes = Buffer.alloc(8);\n  amountBytes.writeBigUInt64LE(amount);\n\n  const recipientPadded = padTo32Bytes(recipient);\n\n  return ethers.hexlify(\n    Buffer.concat([\n      Buffer.from([ACTION_TRANSFER]),\n      amountBytes,\n      Buffer.from(ethers.getBytes(recipientPadded)),\n    ])\n  );\n}\n\n// ============================================================================\n// Address Utilities\n// ============================================================================\n\n/**\n * Pad an address to 32 bytes (Wormhole standard)\n * Supports both EVM addresses (0x...) and Solana addresses (base58)\n */\nexport function padTo32Bytes(address: string): string {\n  // Handle native token - convert to zero address\n  if (address.toLowerCase() === 'native') {\n    return '0x' + '0'.repeat(64);\n  }\n  \n  // If it starts with 0x, treat as hex\n  if (address.startsWith('0x')) {\n    const hex = address.replace('0x', '');\n    // Validate that hex only contains valid hex characters\n    if (!/^[0-9a-fA-F]*$/.test(hex)) {\n      throw new Error(`Invalid address: ${address}. Expected hex string or 'native'.`);\n    }\n    return '0x' + hex.padStart(64, '0');\n  }\n  \n  // Otherwise, assume base58 Solana address and decode it\n  // Base58 character set (Bitcoin/Solana style - no 0, O, I, l)\n  const base58Chars = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';\n  \n  // Validate base58 characters\n  for (const char of address) {\n    if (!base58Chars.includes(char)) {\n      throw new Error(`Invalid address: ${address}. Contains invalid base58 character '${char}'.`);\n    }\n  }\n  \n  // Decode base58 to bytes\n  let value = BigInt(0);\n  for (const char of address) {\n    value = value * 58n + BigInt(base58Chars.indexOf(char));\n  }\n  \n  // Convert to 32-byte hex\n  let hex = value.toString(16);\n  // Ensure it's not longer than 64 chars (32 bytes)\n  if (hex.length > 64) {\n    throw new Error(`Invalid address: ${address}. Decoded value too large for 32 bytes.`);\n  }\n  \n  return '0x' + hex.padStart(64, '0');\n}\n\n/**\n * Trim a 32-byte hex to a 20-byte EVM address\n */\nexport function trimTo20Bytes(hex32: string): string {\n  const clean = hex32.replace('0x', '');\n  return '0x' + clean.slice(-40);\n}\n\n/**\n * Convert a Solana public key (base58) to bytes32\n * @deprecated Use padTo32Bytes instead, which now handles both EVM and Solana addresses\n */\nexport function solanaAddressToBytes32(base58Address: string): string {\n  return padTo32Bytes(base58Address);\n}\n\n// ============================================================================\n// Amount Utilities\n// ============================================================================\n\n/**\n * Format an amount with decimals for display\n */\nexport function formatAmount(amount: bigint, decimals = 18): string {\n  const divisor = 10n ** BigInt(decimals);\n  const whole = amount / divisor;\n  const fraction = amount % divisor;\n\n  if (fraction === 0n) {\n    return whole.toString();\n  }\n\n  const fractionStr = fraction.toString().padStart(decimals, '0');\n  const trimmedFraction = fractionStr.replace(/0+$/, '');\n\n  return `${whole}.${trimmedFraction}`;\n}\n\n/**\n * Parse an amount string with decimals to bigint\n */\nexport function parseAmount(amountStr: string, decimals = 18): bigint {\n  const parts = amountStr.split('.');\n  const whole = BigInt(parts[0] ?? '0');\n\n  if (parts.length === 1 || !parts[1]) {\n    return whole * (10n ** BigInt(decimals));\n  }\n\n  const fractionStr = parts[1].slice(0, decimals).padEnd(decimals, '0');\n  const fraction = BigInt(fractionStr);\n\n  return whole * (10n ** BigInt(decimals)) + fraction;\n}\n\n// ============================================================================\n// Nonce Utilities\n// ============================================================================\n\n/**\n * Generate a unique nonce for a transaction\n */\nexport function generateNonce(): bigint {\n  const timestamp = BigInt(Date.now());\n  const random = BigInt(Math.floor(Math.random() * 1000000));\n  return (timestamp << 20n) | random;\n}\n\n/**\n * Create a message hash for signing (used in authenticateRawAndDispatch)\n */\nexport function createMessageHash(\n  targetChain: number,\n  actionPayload: string,\n  nonce: bigint\n): string {\n  return ethers.keccak256(\n    ethers.solidityPacked(\n      ['uint16', 'bytes', 'uint256'],\n      [targetChain, actionPayload, nonce]\n    )\n  );\n}\n\n/**\n * Create the challenge bytes for gasless dispatch (matches Hub's authenticateAndDispatch)\n * \n * The Hub contract passes raw packed bytes to WebAuthn.verify():\n * abi.encodePacked(targetChain, actionPayload, userNonce, hubChainId)\n * \n * The WebAuthn library then base64url-encodes these bytes to match against clientDataJSON.\n * We do NOT hash here - the challenge is the raw packed bytes.\n * \n * @param targetChain - Wormhole chain ID of the destination\n * @param actionPayload - The action payload (hex string)\n * @param nonce - User's current nonce\n * @param hubChainId - Wormhole chain ID of the Hub (e.g., 30 for Base)\n * @returns The packed bytes as hex string (NOT hashed)\n */\nexport function createGaslessMessageHash(\n  targetChain: number,\n  actionPayload: string,\n  nonce: bigint,\n  hubChainId: number\n): string {\n  // Return raw packed bytes - NO sha256 hash\n  // The contract passes these bytes directly to WebAuthn.verify()\n  return ethers.solidityPacked(\n    ['uint16', 'bytes', 'uint256', 'uint16'],\n    [targetChain, actionPayload, nonce, hubChainId]\n  );\n}\n\n/**\n * Build the challenge bytes for WebAuthn signing (gasless flow)\n * Returns raw packed bytes that match what the Hub contract expects\n * \n * @param targetChain - Wormhole chain ID of the destination\n * @param actionPayload - The action payload (hex string)\n * @param nonce - User's current nonce\n * @param hubChainId - Wormhole chain ID of the Hub\n * @returns Challenge bytes for WebAuthn signing (raw packed, not hashed)\n */\nexport function buildGaslessChallenge(\n  targetChain: number,\n  actionPayload: string,\n  nonce: bigint,\n  hubChainId: number\n): Uint8Array {\n  const packed = createGaslessMessageHash(targetChain, actionPayload, nonce, hubChainId);\n  return ethers.getBytes(packed);\n}\n\n/**\n * Build the challenge bytes for WebAuthn signing\n */\nexport function buildChallenge(\n  userKeyHash: string,\n  targetChain: number,\n  nonce: bigint,\n  actionPayload: string\n): Uint8Array {\n  const encoded = ethers.solidityPacked(\n    ['bytes32', 'uint16', 'uint256', 'bytes'],\n    [userKeyHash, targetChain, nonce, actionPayload]\n  );\n  return ethers.getBytes(ethers.keccak256(encoded));\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: '0xCFaEb5652aa2Ee60b2229dC8895B4159749C7e53',\n      vaultImplementation: '0x0d13367C16c6f0B24eD275CC67C7D9f42878285c',\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: '0xA5653d54079ABeCe780F8d9597B2bc4B09fe464A',\n      vaultImplementation: '0x8099b1406485d2255ff89Ce5Ea18520802AFC150',\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: '0x0237e04f74b991b5b6030a793779663033f4ff4a1682a9e66c1f41fc1ec3e2a4',\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 userNonces(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":["hex"]}

package/dist/chains/solana/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/chains/solana/SolanaClient.ts","../../../src/payload.ts","../../../src/constants.ts"],"sourcesContent":["/**\n * Veridex Protocol SDK - Solana Chain Client\n * \n * Implementation of ChainClient interface for Solana blockchain\n */\n\nimport {\n    Connection,\n    PublicKey,\n} from '@solana/web3.js';\nimport {\n    getAssociatedTokenAddressSync,\n} from '@solana/spl-token';\nimport { createHash } from 'crypto';\nimport type {\n    ChainClient,\n    ChainConfig,\n    TransferParams,\n    ExecuteParams,\n    BridgeParams,\n    DispatchResult,\n    WebAuthnSignature,\n    VaultCreationResult,\n} from '../../core/types.js';\nimport { encodeTransferAction, encodeExecuteAction, encodeBridgeAction } from '../../payload.js';\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface SolanaClientConfig {\n    wormholeChainId: number;\n    rpcUrl: string;\n    programId: string; // Veridex Spoke program\n    wormholeCoreBridge: string;\n    tokenBridge: string;\n    network?: 'mainnet' | 'devnet' | 'testnet';\n    commitment?: 'processed' | 'confirmed' | 'finalized';\n}\n\n// ============================================================================\n// Constants\n// ============================================================================\n\n// ============================================================================\n// SolanaClient Class\n// ============================================================================\n\n/**\n * Solana implementation of the ChainClient interface\n */\nexport class SolanaClient implements ChainClient {\n    private config: ChainConfig;\n    private connection: Connection;\n    private programId: PublicKey;\n\n    constructor(config: SolanaClientConfig) {\n        this.config = {\n            name: `Solana ${config.network || 'mainnet'}`,\n            chainId: config.wormholeChainId,\n            wormholeChainId: config.wormholeChainId,\n            rpcUrl: config.rpcUrl,\n            explorerUrl: config.network === 'devnet'\n                ? 'https://explorer.solana.com?cluster=devnet'\n                : 'https://explorer.solana.com',\n            isEvm: false,\n            contracts: {\n                hub: undefined, // Solana is a spoke only\n                wormholeCoreBridge: config.wormholeCoreBridge,\n                tokenBridge: config.tokenBridge,\n            },\n        };\n\n        this.connection = new Connection(\n            config.rpcUrl,\n            config.commitment || 'confirmed'\n        );\n        this.programId = new PublicKey(config.programId);\n    }\n\n    getConfig(): ChainConfig {\n        return this.config;\n    }\n\n    async getNonce(userKeyHash: string): Promise<bigint> {\n        try {\n            const vaultAddress = this.computeVaultAddressFromHash(userKeyHash);\n            const accountInfo = await this.connection.getAccountInfo(new PublicKey(vaultAddress));\n\n            if (!accountInfo || accountInfo.data.length < 40) {\n                return 0n;\n            }\n\n            // Nonce is stored at offset 8 (after discriminator)\n            // Read as u64 little-endian\n            const nonce = accountInfo.data.readBigUInt64LE(8);\n            return nonce;\n        } catch (error) {\n            console.error('Error getting nonce:', error);\n            return 0n;\n        }\n    }\n\n    async getMessageFee(): Promise<bigint> {\n        try {\n            // Query Wormhole bridge for message fee\n            // For now, return a default estimate\n            // TODO: Query on-chain Wormhole config account\n            return 0n; // Solana doesn't charge a Wormhole fee in the same way\n        } catch (error) {\n            console.error('Error getting message fee:', error);\n            return 0n;\n        }\n    }\n\n    async buildTransferPayload(params: TransferParams): Promise<string> {\n        return encodeTransferAction(\n            params.token,\n            params.recipient,\n            params.amount\n        );\n    }\n\n    async buildExecutePayload(params: ExecuteParams): Promise<string> {\n        return encodeExecuteAction(\n            params.target,\n            params.value,\n            params.data\n        );\n    }\n\n    async buildBridgePayload(params: BridgeParams): Promise<string> {\n        return encodeBridgeAction(\n            params.token,\n            params.amount,\n            params.destinationChain,\n            params.recipient\n        );\n    }\n\n    async dispatch(\n        signature: WebAuthnSignature,\n        publicKeyX: bigint,\n        publicKeyY: bigint,\n        targetChain: number,\n        actionPayload: string,\n        nonce: bigint,\n        signer: any // Solana Keypair or similar\n    ): Promise<DispatchResult> {\n        void signature;\n        void publicKeyX;\n        void publicKeyY;\n        void targetChain;\n        void actionPayload;\n        void nonce;\n        void signer;\n        throw new Error(\n            'Direct dispatch not supported on Solana spoke chains. ' +\n            'Actions must be dispatched from the Hub (EVM) chain. ' +\n            'This client is for receiving cross-chain messages only.'\n        );\n    }\n\n    /**\n     * Dispatch an action via relayer (gasless)\n     * Note: On Solana, this still goes through the Hub chain\n     * Solana is a spoke-only chain in Veridex architecture\n     */\n    async dispatchGasless(\n        signature: WebAuthnSignature,\n        publicKeyX: bigint,\n        publicKeyY: bigint,\n        targetChain: number,\n        actionPayload: string,\n        nonce: bigint,\n        relayerUrl: string\n    ): Promise<DispatchResult> {\n        // Compute key hash\n        const keyHash = this.computeKeyHash(publicKeyX, publicKeyY);\n\n        // Build the message that was signed (matches Hub chain format)\n        const message = this.buildMessage(keyHash, targetChain, actionPayload, nonce);\n\n        // Prepare request for relayer\n        const request = {\n            messageHash: message,\n            r: '0x' + signature.r.toString(16).padStart(64, '0'),\n            s: '0x' + signature.s.toString(16).padStart(64, '0'),\n            publicKeyX: '0x' + publicKeyX.toString(16).padStart(64, '0'),\n            publicKeyY: '0x' + publicKeyY.toString(16).padStart(64, '0'),\n            targetChain,\n            actionPayload,\n            nonce: Number(nonce),\n        };\n\n        // Submit to relayer\n        const response = await fetch(`${relayerUrl}/api/v1/submit`, {\n            method: 'POST',\n            headers: {\n                'Content-Type': 'application/json',\n            },\n            body: JSON.stringify(request),\n        });\n\n        if (!response.ok) {\n            const error = await response.json().catch(() => ({ error: response.statusText }));\n            throw new Error(`Relayer submission failed: ${error.error || response.statusText}`);\n        }\n\n        const result = await response.json();\n\n        if (!result.success) {\n            throw new Error(`Relayer submission failed: ${result.error}`);\n        }\n\n        return {\n            transactionHash: result.txHash,\n            sequence: BigInt(result.sequence || '0'),\n            userKeyHash: keyHash,\n            targetChain,\n        };\n    }\n\n    async getVaultAddress(userKeyHash: string): Promise<string | null> {\n        try {\n            const vaultAddress = this.computeVaultAddressFromHash(userKeyHash);\n            const accountInfo = await this.connection.getAccountInfo(new PublicKey(vaultAddress));\n\n            if (!accountInfo) {\n                return null;\n            }\n\n            return vaultAddress;\n        } catch (error) {\n            console.error('Error getting vault address:', error);\n            return null;\n        }\n    }\n\n    /**\n     * Compute vault address using PDA (Program Derived Address)\n     * Seeds: [\"vault\", userKeyHash]\n     */\n    computeVaultAddress(userKeyHash: string): string {\n        return this.computeVaultAddressFromHash(userKeyHash);\n    }\n\n    private computeVaultAddressFromHash(userKeyHash: string): string {\n        const userKeyHashBuffer = Buffer.from(userKeyHash.replace('0x', ''), 'hex');\n        const [vaultPda] = PublicKey.findProgramAddressSync(\n            [Buffer.from('vault'), userKeyHashBuffer],\n            this.programId\n        );\n        return vaultPda.toBase58();\n    }\n\n    async vaultExists(userKeyHash: string): Promise<boolean> {\n        const address = await this.getVaultAddress(userKeyHash);\n        return address !== null;\n    }\n\n    async createVault(userKeyHash: string, signer: any): Promise<VaultCreationResult> {\n        void userKeyHash;\n        void signer;\n        throw new Error(\n            'Vault creation on Solana must be done via relayer. ' +\n            'Use createVaultViaRelayer() instead.'\n        );\n    }\n\n    async createVaultSponsored?(\n        userKeyHash: string,\n        sponsorPrivateKey: string,\n        rpcUrl?: string\n    ): Promise<VaultCreationResult> {\n        void userKeyHash;\n        void sponsorPrivateKey;\n        void rpcUrl;\n        throw new Error(\n            'Vault creation on Solana must be done via relayer. ' +\n            'Use createVaultViaRelayer() instead.'\n        );\n    }\n\n    /**\n     * Create a vault via the relayer (sponsored/gasless)\n     * This is the recommended way to create Solana vaults\n     */\n    async createVaultViaRelayer(\n        userKeyHash: string,\n        relayerUrl: string\n    ): Promise<VaultCreationResult> {\n        const response = await fetch(`${relayerUrl}/api/v1/solana/vault`, {\n            method: 'POST',\n            headers: {\n                'Content-Type': 'application/json',\n            },\n            body: JSON.stringify({\n                userKeyHash,\n                chainId: this.config.wormholeChainId,\n            }),\n        });\n\n        const result = await response.json();\n\n        if (!response.ok || !result.success) {\n            throw new Error(result.error || 'Failed to create vault via relayer');\n        }\n\n        return {\n            address: result.vaultAddress,\n            transactionHash: result.transactionHash || '',\n            blockNumber: 0, // Solana doesn't have block numbers like EVM\n            gasUsed: 0n, // Solana uses compute units, not gas\n            alreadyExisted: !result.transactionHash,\n            sponsoredBy: 'relayer',\n        };\n    }\n\n    /**\n     * Get vault info via relayer (includes existence check)\n     */\n    async getVaultViaRelayer(\n        userKeyHash: string,\n        relayerUrl: string\n    ): Promise<{ vaultAddress: string; exists: boolean }> {\n        const response = await fetch(\n            `${relayerUrl}/api/v1/solana/vault/${userKeyHash}?chainId=${this.config.wormholeChainId}`\n        );\n\n        if (!response.ok) {\n            throw new Error('Failed to get vault info from relayer');\n        }\n\n        const result = await response.json();\n        return {\n            vaultAddress: result.vaultAddress,\n            exists: result.exists,\n        };\n    }\n\n    async estimateVaultCreationGas(userKeyHash: string): Promise<bigint> {\n        void userKeyHash;\n        // Return SOL estimate for vault creation (rent + compute)\n        // ~0.002 SOL for rent-exempt account + compute units\n        return 2_000_000n; // 0.002 SOL in lamports\n    }\n\n    getFactoryAddress(): string | undefined {\n        // Solana uses program addresses, not factory pattern\n        return undefined;\n    }\n\n    getImplementationAddress(): string | undefined {\n        // Solana uses program addresses, not implementation pattern\n        return undefined;\n    }\n\n    // ========================================================================\n    // Balance Methods\n    // ========================================================================\n\n    /**\n     * Get native SOL balance\n     */\n    async getNativeBalance(address: string): Promise<bigint> {\n        const balance = await this.connection.getBalance(new PublicKey(address));\n        return BigInt(balance);\n    }\n\n    /**\n     * Get SPL token balance\n     */\n    async getTokenBalance(tokenAddress: string, ownerAddress: string): Promise<bigint> {\n        try {\n            const mint = new PublicKey(tokenAddress);\n            const owner = new PublicKey(ownerAddress);\n            const ata = getAssociatedTokenAddressSync(mint, owner);\n\n            const balance = await this.connection.getTokenAccountBalance(ata);\n            return BigInt(balance.value.amount);\n        } catch (error) {\n            console.error('Error getting token balance:', error);\n            return 0n;\n        }\n    }\n\n    // ========================================================================\n    // Utility Methods\n    // ========================================================================\n\n    /**\n     * Compute key hash from public key coordinates\n     * Matches EVM keccak256(abi.encode(publicKeyX, publicKeyY))\n     */\n    private computeKeyHash(publicKeyX: bigint, publicKeyY: bigint): string {\n        // Use SHA-256 for Solana (Solana doesn't have keccak256 built-in)\n        // The relayer will convert this to match EVM format\n        const xBuffer = Buffer.alloc(32);\n        const yBuffer = Buffer.alloc(32);\n\n        // Write as big-endian to match EVM encoding\n        const xHex = publicKeyX.toString(16).padStart(64, '0');\n        const yHex = publicKeyY.toString(16).padStart(64, '0');\n\n        Buffer.from(xHex, 'hex').copy(xBuffer);\n        Buffer.from(yHex, 'hex').copy(yBuffer);\n\n        // For cross-chain compatibility, we need to match the EVM hash\n        // This should be keccak256, but we'll return a format the relayer expects\n        const combined = Buffer.concat([xBuffer, yBuffer]);\n        const hash = createHash('sha256').update(combined).digest();\n\n        return '0x' + hash.toString('hex');\n    }\n\n    /**\n     * Build message for signing (matches Hub chain format)\n     */\n    private buildMessage(\n        keyHash: string,\n        targetChain: number,\n        actionPayload: string,\n        nonce: bigint\n    ): string {\n        // This should match the EVM message format for cross-chain compatibility\n        const keyHashBuffer = Buffer.from(keyHash.replace('0x', ''), 'hex');\n        const targetChainBuffer = Buffer.alloc(2);\n        targetChainBuffer.writeUInt16BE(targetChain);\n        const payloadBuffer = Buffer.from(actionPayload.replace('0x', ''), 'hex');\n        const nonceBuffer = Buffer.alloc(32);\n        const nonceHex = nonce.toString(16).padStart(64, '0');\n        Buffer.from(nonceHex, 'hex').copy(nonceBuffer);\n\n        const combined = Buffer.concat([\n            keyHashBuffer,\n            targetChainBuffer,\n            payloadBuffer,\n            nonceBuffer,\n        ]);\n\n        const hash = createHash('sha256').update(combined).digest();\n        return '0x' + hash.toString('hex');\n    }\n\n    /**\n     * Get connection instance for advanced usage\n     */\n    getConnection(): Connection {\n        return this.connection;\n    }\n\n    /**\n     * Get program ID\n     */\n    getProgramId(): PublicKey {\n        return this.programId;\n    }\n\n    /**\n     * Get current slot\n     */\n    async getSlot(): Promise<number> {\n        return await this.connection.getSlot();\n    }\n\n    /**\n     * Get transaction status\n     */\n    async getTransaction(signature: string, commitment?: 'confirmed' | 'finalized') {\n        return await this.connection.getTransaction(signature, {\n            commitment: commitment || 'confirmed',\n            maxSupportedTransactionVersion: 0,\n        });\n    }\n\n    // ============================================================================\n    // Social Recovery Methods (Issue #23)\n    // ============================================================================\n    // \n    // Note: Social recovery is managed on the Hub chain (EVM).\n    // Solana spokes receive and execute recovery VAAs broadcast from the Hub.\n    // These methods are placeholders that indicate spoke-only chains don't\n    // initiate recovery - they only execute recovery instructions from Hub VAAs.\n    //\n    // The relayer service handles:\n    // 1. Fetching recovery VAAs from Wormhole guardians\n    // 2. Submitting execute_recovery instruction to Solana spoke\n    // 3. Processing OwnerRecovered events\n    //\n    // SDK users should use EVMClient methods for guardian management and\n    // recovery initiation on the Hub chain.\n    // ============================================================================\n\n    /**\n     * Check if a recovery VAA has been executed on this spoke\n     * \n     * @param vaaHash - Hash of the recovery VAA\n     * @returns Whether the VAA has been processed\n     */\n    async isRecoveryExecuted(vaaHash: string): Promise<boolean> {\n        try {\n            // Derive VAA record PDA\n            const vaaHashBuffer = Buffer.from(vaaHash.replace('0x', ''), 'hex');\n            const [vaaRecordPda] = PublicKey.findProgramAddressSync(\n                [Buffer.from('vaa_record'), vaaHashBuffer],\n                this.programId\n            );\n\n            const accountInfo = await this.connection.getAccountInfo(vaaRecordPda);\n            if (!accountInfo || accountInfo.data.length < 9) {\n                return false;\n            }\n\n            // First byte after discriminator is 'processed' bool\n            return accountInfo.data[8] === 1;\n        } catch (error) {\n            console.error('Error checking recovery execution:', error);\n            return false;\n        }\n    }\n\n    /**\n     * Get vault owner after potential recovery\n     * \n     * @param vaultAddress - Vault address to check\n     * @returns Current owner key hash\n     */\n    async getVaultOwner(vaultAddress: string): Promise<string> {\n        try {\n            const accountInfo = await this.connection.getAccountInfo(new PublicKey(vaultAddress));\n            if (!accountInfo || accountInfo.data.length < 40) {\n                throw new Error('Vault not found');\n            }\n\n            // Owner key hash is stored after discriminator (8 bytes) at offset 8-40\n            const ownerKeyHash = accountInfo.data.slice(8, 40);\n            return '0x' + ownerKeyHash.toString('hex');\n        } catch (error) {\n            console.error('Error getting vault owner:', error);\n            throw error;\n        }\n    }\n\n    /**\n     * Get authorized signers for a vault\n     * \n     * @param vaultAddress - Vault address to check\n     * @returns Array of authorized signer key hashes\n     */\n    async getAuthorizedSigners(vaultAddress: string): Promise<string[]> {\n        try {\n            const accountInfo = await this.connection.getAccountInfo(new PublicKey(vaultAddress));\n            if (!accountInfo || accountInfo.data.length < 235) {\n                throw new Error('Vault not found');\n            }\n\n            // Vault layout:\n            // 8 bytes discriminator\n            // 32 bytes owner_key_hash\n            // 8 bytes nonce\n            // 1 byte paused\n            // 8 bytes daily_limit\n            // 8 bytes daily_spent\n            // 8 bytes day_start\n            // 1 byte bump\n            // 1 byte authorized_signer_count\n            // 5 * 32 bytes authorized_signers\n\n            const signerCount = accountInfo.data[66]; // offset 8+32+8+1+8+8+1 = 66\n            const signers: string[] = [];\n\n            for (let i = 0; i < signerCount; i++) {\n                const offset = 67 + (i * 32); // Start of authorized_signers array\n                const keyHash = accountInfo.data.slice(offset, offset + 32);\n                signers.push('0x' + keyHash.toString('hex'));\n            }\n\n            return signers;\n        } catch (error) {\n            console.error('Error getting authorized signers:', error);\n            throw error;\n        }\n    }\n}\n","/**\n * Veridex Protocol SDK - Payload Encoding/Decoding Utilities\n */\n\nimport { ethers } from 'ethers';\nimport {\n  ACTION_TRANSFER,\n  ACTION_EXECUTE,\n  ACTION_CONFIG,\n  ACTION_BRIDGE,\n  PROTOCOL_VERSION,\n} from './constants.js';\nimport type { TransferAction, BridgeAction, ExecuteAction, ActionPayload } from './types.js';\n\n// ============================================================================\n// Action Encoding\n// ============================================================================\n\n/**\n * Encode a transfer action payload\n * Format: [actionType(1)] [token(32)] [recipient(32)] [amount(32)]\n */\nexport function encodeTransferAction(\n  token: string,\n  recipient: string,\n  amount: bigint\n): string {\n  const tokenPadded = padTo32Bytes(token);\n  const recipientPadded = padTo32Bytes(recipient);\n  const amountBytes = ethers.zeroPadValue(ethers.toBeHex(amount), 32);\n\n  return ethers.concat([\n    ethers.toBeHex(ACTION_TRANSFER, 1),\n    tokenPadded,\n    recipientPadded,\n    amountBytes,\n  ]);\n}\n\n/**\n * Encode a bridge action payload\n * Format: [actionType(1)] [token(32)] [amount(32)] [targetChain(2)] [recipient(32)]\n */\nexport function encodeBridgeAction(\n  token: string,\n  amount: bigint,\n  targetChain: number,\n  recipient: string\n): string {\n  const tokenPadded = padTo32Bytes(token);\n  const amountBytes = ethers.zeroPadValue(ethers.toBeHex(amount), 32);\n  const targetChainBytes = ethers.toBeHex(targetChain, 2);\n  const recipientPadded = padTo32Bytes(recipient);\n\n  return ethers.concat([\n    ethers.toBeHex(ACTION_BRIDGE, 1),\n    tokenPadded,\n    amountBytes,\n    targetChainBytes,\n    recipientPadded,\n  ]);\n}\n\n/**\n * Encode an execute action payload (arbitrary contract call)\n * Format: [actionType(1)] [target(32)] [value(32)] [dataLength(2)] [data(variable)]\n */\nexport function encodeExecuteAction(\n  target: string,\n  value: bigint,\n  data: string\n): string {\n  const targetPadded = padTo32Bytes(target);\n  const valueBytes = ethers.zeroPadValue(ethers.toBeHex(value), 32);\n  const dataBytes = ethers.getBytes(data);\n  const dataLengthBytes = ethers.toBeHex(dataBytes.length, 2);\n\n  return ethers.concat([\n    ethers.toBeHex(ACTION_EXECUTE, 1),\n    targetPadded,\n    valueBytes,\n    dataLengthBytes,\n    data,\n  ]);\n}\n\n/**\n * Encode a config action payload\n * Format: [actionType(1)] [configType(1)] [configData(variable)]\n */\nexport function encodeConfigAction(configType: number, configData: string): string {\n  return ethers.concat([\n    ethers.toBeHex(ACTION_CONFIG, 1),\n    ethers.toBeHex(configType, 1),\n    configData,\n  ]);\n}\n\n// ============================================================================\n// Veridex Payload Encoding\n// ============================================================================\n\n/**\n * Encode the full Veridex message payload that gets published via Wormhole\n * Format: [version(1)] [userKeyHash(32)] [targetChain(2)] [nonce(32)] [pubKeyX(32)] [pubKeyY(32)] [actionPayload]\n */\nexport function encodeVeridexPayload(\n  userKeyHash: string,\n  targetChain: number,\n  nonce: bigint,\n  publicKeyX: bigint,\n  publicKeyY: bigint,\n  actionPayload: string\n): string {\n  return ethers.concat([\n    ethers.toBeHex(PROTOCOL_VERSION, 1),\n    userKeyHash,\n    ethers.toBeHex(targetChain, 2),\n    ethers.zeroPadValue(ethers.toBeHex(nonce), 32),\n    ethers.zeroPadValue(ethers.toBeHex(publicKeyX), 32),\n    ethers.zeroPadValue(ethers.toBeHex(publicKeyY), 32),\n    actionPayload,\n  ]);\n}\n\n// ============================================================================\n// Action Decoding\n// ============================================================================\n\n/**\n * Decode an action payload to determine its type and contents\n */\nexport function decodeActionPayload(payload: string): ActionPayload {\n  const data = ethers.getBytes(payload);\n  const actionType = data[0];\n\n  switch (actionType) {\n    case ACTION_TRANSFER:\n      return decodeTransferAction(payload);\n    case ACTION_BRIDGE:\n      return decodeBridgeAction(payload);\n    case ACTION_EXECUTE:\n      return decodeExecuteAction(payload);\n    default:\n      return { type: `unknown_${actionType}`, raw: payload };\n  }\n}\n\n/**\n * Decode a transfer action payload\n */\nexport function decodeTransferAction(payload: string): TransferAction {\n  const data = ethers.getBytes(payload);\n\n  const tokenBytes = data.slice(1, 33);\n  const recipientBytes = data.slice(33, 65);\n  const amountBytes = data.slice(65, 97);\n\n  return {\n    type: 'transfer',\n    token: trimTo20Bytes(ethers.hexlify(tokenBytes)),\n    recipient: trimTo20Bytes(ethers.hexlify(recipientBytes)),\n    amount: BigInt(ethers.hexlify(amountBytes)),\n  };\n}\n\n/**\n * Decode a bridge action payload\n */\nexport function decodeBridgeAction(payload: string): BridgeAction {\n  const data = ethers.getBytes(payload);\n\n  const tokenBytes = data.slice(1, 33);\n  const amountBytes = data.slice(33, 65);\n  const targetChainByte0 = data[65];\n  const targetChainByte1 = data[66];\n  const recipientBytes = data.slice(67, 99);\n\n  const targetChain = ((targetChainByte0 ?? 0) << 8) | (targetChainByte1 ?? 0);\n\n  return {\n    type: 'bridge',\n    token: trimTo20Bytes(ethers.hexlify(tokenBytes)),\n    amount: BigInt(ethers.hexlify(amountBytes)),\n    targetChain,\n    recipient: ethers.hexlify(recipientBytes),\n  };\n}\n\n/**\n * Decode an execute action payload\n */\nexport function decodeExecuteAction(payload: string): ExecuteAction {\n  const data = ethers.getBytes(payload);\n\n  const targetBytes = data.slice(1, 33);\n  const valueBytes = data.slice(33, 65);\n  const dataLengthByte0 = data[65];\n  const dataLengthByte1 = data[66];\n  const dataLength = ((dataLengthByte0 ?? 0) << 8) | (dataLengthByte1 ?? 0);\n  const callData = data.slice(67, 67 + dataLength);\n\n  return {\n    type: 'execute',\n    target: trimTo20Bytes(ethers.hexlify(targetBytes)),\n    value: BigInt(ethers.hexlify(valueBytes)),\n    data: ethers.hexlify(callData),\n  };\n}\n\n// ============================================================================\n// Chain-Specific Encodings\n// ============================================================================\n\n/**\n * Encode a Solana-compatible transfer action\n * Solana uses: [actionType(1)] [amount(8 LE)] [recipient(32)]\n */\nexport function encodeSolanaTransferAction(\n  amount: bigint,\n  recipient: string\n): string {\n  const amountBytes = Buffer.alloc(8);\n  amountBytes.writeBigUInt64LE(amount);\n\n  const recipientBytes = ethers.getBytes(recipient);\n\n  return ethers.hexlify(\n    Buffer.concat([\n      Buffer.from([ACTION_TRANSFER]),\n      amountBytes,\n      Buffer.from(recipientBytes),\n    ])\n  );\n}\n\n/**\n * Encode an Aptos-compatible transfer action\n * Aptos uses: [actionType(1)] [amount(8 LE)] [recipient(32)]\n */\nexport function encodeAptosTransferAction(\n  amount: bigint,\n  recipient: string\n): string {\n  const amountBytes = Buffer.alloc(8);\n  amountBytes.writeBigUInt64LE(amount);\n\n  const recipientPadded = padTo32Bytes(recipient);\n\n  return ethers.hexlify(\n    Buffer.concat([\n      Buffer.from([ACTION_TRANSFER]),\n      amountBytes,\n      Buffer.from(ethers.getBytes(recipientPadded)),\n    ])\n  );\n}\n\n/**\n * Encode a Sui-compatible transfer action\n * Sui uses: [actionType(1)] [amount(8 LE)] [recipient(32)]\n */\nexport function encodeSuiTransferAction(\n  amount: bigint,\n  recipient: string\n): string {\n  const amountBytes = Buffer.alloc(8);\n  amountBytes.writeBigUInt64LE(amount);\n\n  const recipientPadded = padTo32Bytes(recipient);\n\n  return ethers.hexlify(\n    Buffer.concat([\n      Buffer.from([ACTION_TRANSFER]),\n      amountBytes,\n      Buffer.from(ethers.getBytes(recipientPadded)),\n    ])\n  );\n}\n\n// ============================================================================\n// Address Utilities\n// ============================================================================\n\n/**\n * Pad an address to 32 bytes (Wormhole standard)\n * Supports both EVM addresses (0x...) and Solana addresses (base58)\n */\nexport function padTo32Bytes(address: string): string {\n  // Handle native token - convert to zero address\n  if (address.toLowerCase() === 'native') {\n    return '0x' + '0'.repeat(64);\n  }\n  \n  // If it starts with 0x, treat as hex\n  if (address.startsWith('0x')) {\n    const hex = address.replace('0x', '');\n    // Validate that hex only contains valid hex characters\n    if (!/^[0-9a-fA-F]*$/.test(hex)) {\n      throw new Error(`Invalid address: ${address}. Expected hex string or 'native'.`);\n    }\n    return '0x' + hex.padStart(64, '0');\n  }\n  \n  // Otherwise, assume base58 Solana address and decode it\n  // Base58 character set (Bitcoin/Solana style - no 0, O, I, l)\n  const base58Chars = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';\n  \n  // Validate base58 characters\n  for (const char of address) {\n    if (!base58Chars.includes(char)) {\n      throw new Error(`Invalid address: ${address}. Contains invalid base58 character '${char}'.`);\n    }\n  }\n  \n  // Decode base58 to bytes\n  let value = BigInt(0);\n  for (const char of address) {\n    value = value * 58n + BigInt(base58Chars.indexOf(char));\n  }\n  \n  // Convert to 32-byte hex\n  let hex = value.toString(16);\n  // Ensure it's not longer than 64 chars (32 bytes)\n  if (hex.length > 64) {\n    throw new Error(`Invalid address: ${address}. Decoded value too large for 32 bytes.`);\n  }\n  \n  return '0x' + hex.padStart(64, '0');\n}\n\n/**\n * Trim a 32-byte hex to a 20-byte EVM address\n */\nexport function trimTo20Bytes(hex32: string): string {\n  const clean = hex32.replace('0x', '');\n  return '0x' + clean.slice(-40);\n}\n\n/**\n * Convert a Solana public key (base58) to bytes32\n * @deprecated Use padTo32Bytes instead, which now handles both EVM and Solana addresses\n */\nexport function solanaAddressToBytes32(base58Address: string): string {\n  return padTo32Bytes(base58Address);\n}\n\n// ============================================================================\n// Amount Utilities\n// ============================================================================\n\n/**\n * Format an amount with decimals for display\n */\nexport function formatAmount(amount: bigint, decimals = 18): string {\n  const divisor = 10n ** BigInt(decimals);\n  const whole = amount / divisor;\n  const fraction = amount % divisor;\n\n  if (fraction === 0n) {\n    return whole.toString();\n  }\n\n  const fractionStr = fraction.toString().padStart(decimals, '0');\n  const trimmedFraction = fractionStr.replace(/0+$/, '');\n\n  return `${whole}.${trimmedFraction}`;\n}\n\n/**\n * Parse an amount string with decimals to bigint\n */\nexport function parseAmount(amountStr: string, decimals = 18): bigint {\n  const parts = amountStr.split('.');\n  const whole = BigInt(parts[0] ?? '0');\n\n  if (parts.length === 1 || !parts[1]) {\n    return whole * (10n ** BigInt(decimals));\n  }\n\n  const fractionStr = parts[1].slice(0, decimals).padEnd(decimals, '0');\n  const fraction = BigInt(fractionStr);\n\n  return whole * (10n ** BigInt(decimals)) + fraction;\n}\n\n// ============================================================================\n// Nonce Utilities\n// ============================================================================\n\n/**\n * Generate a unique nonce for a transaction\n */\nexport function generateNonce(): bigint {\n  const timestamp = BigInt(Date.now());\n  const random = BigInt(Math.floor(Math.random() * 1000000));\n  return (timestamp << 20n) | random;\n}\n\n/**\n * Create a message hash for signing (used in authenticateRawAndDispatch)\n */\nexport function createMessageHash(\n  targetChain: number,\n  actionPayload: string,\n  nonce: bigint\n): string {\n  return ethers.keccak256(\n    ethers.solidityPacked(\n      ['uint16', 'bytes', 'uint256'],\n      [targetChain, actionPayload, nonce]\n    )\n  );\n}\n\n/**\n * Create the challenge bytes for gasless dispatch (matches Hub's authenticateAndDispatch)\n * \n * The Hub contract passes raw packed bytes to WebAuthn.verify():\n * abi.encodePacked(targetChain, actionPayload, userNonce, hubChainId)\n * \n * The WebAuthn library then base64url-encodes these bytes to match against clientDataJSON.\n * We do NOT hash here - the challenge is the raw packed bytes.\n * \n * @param targetChain - Wormhole chain ID of the destination\n * @param actionPayload - The action payload (hex string)\n * @param nonce - User's current nonce\n * @param hubChainId - Wormhole chain ID of the Hub (e.g., 30 for Base)\n * @returns The packed bytes as hex string (NOT hashed)\n */\nexport function createGaslessMessageHash(\n  targetChain: number,\n  actionPayload: string,\n  nonce: bigint,\n  hubChainId: number\n): string {\n  // Return raw packed bytes - NO sha256 hash\n  // The contract passes these bytes directly to WebAuthn.verify()\n  return ethers.solidityPacked(\n    ['uint16', 'bytes', 'uint256', 'uint16'],\n    [targetChain, actionPayload, nonce, hubChainId]\n  );\n}\n\n/**\n * Build the challenge bytes for WebAuthn signing (gasless flow)\n * Returns raw packed bytes that match what the Hub contract expects\n * \n * @param targetChain - Wormhole chain ID of the destination\n * @param actionPayload - The action payload (hex string)\n * @param nonce - User's current nonce\n * @param hubChainId - Wormhole chain ID of the Hub\n * @returns Challenge bytes for WebAuthn signing (raw packed, not hashed)\n */\nexport function buildGaslessChallenge(\n  targetChain: number,\n  actionPayload: string,\n  nonce: bigint,\n  hubChainId: number\n): Uint8Array {\n  const packed = createGaslessMessageHash(targetChain, actionPayload, nonce, hubChainId);\n  return ethers.getBytes(packed);\n}\n\n/**\n * Build the challenge bytes for WebAuthn signing\n */\nexport function buildChallenge(\n  userKeyHash: string,\n  targetChain: number,\n  nonce: bigint,\n  actionPayload: string\n): Uint8Array {\n  const encoded = ethers.solidityPacked(\n    ['bytes32', 'uint16', 'uint256', 'bytes'],\n    [userKeyHash, targetChain, nonce, actionPayload]\n  );\n  return ethers.getBytes(ethers.keccak256(encoded));\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":["hex"]}
+{"version":3,"sources":["../../../src/chains/solana/SolanaClient.ts","../../../src/payload.ts","../../../src/constants.ts"],"sourcesContent":["/**\n * Veridex Protocol SDK - Solana Chain Client\n * \n * Implementation of ChainClient interface for Solana blockchain\n */\n\nimport {\n    Connection,\n    PublicKey,\n} from '@solana/web3.js';\nimport {\n    getAssociatedTokenAddressSync,\n} from '@solana/spl-token';\nimport { createHash } from 'crypto';\nimport type {\n    ChainClient,\n    ChainConfig,\n    TransferParams,\n    ExecuteParams,\n    BridgeParams,\n    DispatchResult,\n    WebAuthnSignature,\n    VaultCreationResult,\n} from '../../core/types.js';\nimport { encodeTransferAction, encodeExecuteAction, encodeBridgeAction } from '../../payload.js';\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface SolanaClientConfig {\n    wormholeChainId: number;\n    rpcUrl: string;\n    programId: string; // Veridex Spoke program\n    wormholeCoreBridge: string;\n    tokenBridge: string;\n    network?: 'mainnet' | 'devnet' | 'testnet';\n    commitment?: 'processed' | 'confirmed' | 'finalized';\n}\n\n// ============================================================================\n// Constants\n// ============================================================================\n\n// ============================================================================\n// SolanaClient Class\n// ============================================================================\n\n/**\n * Solana implementation of the ChainClient interface\n */\nexport class SolanaClient implements ChainClient {\n    private config: ChainConfig;\n    private connection: Connection;\n    private programId: PublicKey;\n\n    constructor(config: SolanaClientConfig) {\n        this.config = {\n            name: `Solana ${config.network || 'mainnet'}`,\n            chainId: config.wormholeChainId,\n            wormholeChainId: config.wormholeChainId,\n            rpcUrl: config.rpcUrl,\n            explorerUrl: config.network === 'devnet'\n                ? 'https://explorer.solana.com?cluster=devnet'\n                : 'https://explorer.solana.com',\n            isEvm: false,\n            contracts: {\n                hub: undefined, // Solana is a spoke only\n                wormholeCoreBridge: config.wormholeCoreBridge,\n                tokenBridge: config.tokenBridge,\n            },\n        };\n\n        this.connection = new Connection(\n            config.rpcUrl,\n            config.commitment || 'confirmed'\n        );\n        this.programId = new PublicKey(config.programId);\n    }\n\n    getConfig(): ChainConfig {\n        return this.config;\n    }\n\n    async getNonce(userKeyHash: string): Promise<bigint> {\n        try {\n            const vaultAddress = this.computeVaultAddressFromHash(userKeyHash);\n            const accountInfo = await this.connection.getAccountInfo(new PublicKey(vaultAddress));\n\n            if (!accountInfo || accountInfo.data.length < 40) {\n                return 0n;\n            }\n\n            // Nonce is stored at offset 8 (after discriminator)\n            // Read as u64 little-endian\n            const nonce = accountInfo.data.readBigUInt64LE(8);\n            return nonce;\n        } catch (error) {\n            console.error('Error getting nonce:', error);\n            return 0n;\n        }\n    }\n\n    async getMessageFee(): Promise<bigint> {\n        try {\n            // Query Wormhole bridge for message fee\n            // For now, return a default estimate\n            // TODO: Query on-chain Wormhole config account\n            return 0n; // Solana doesn't charge a Wormhole fee in the same way\n        } catch (error) {\n            console.error('Error getting message fee:', error);\n            return 0n;\n        }\n    }\n\n    async buildTransferPayload(params: TransferParams): Promise<string> {\n        return encodeTransferAction(\n            params.token,\n            params.recipient,\n            params.amount\n        );\n    }\n\n    async buildExecutePayload(params: ExecuteParams): Promise<string> {\n        return encodeExecuteAction(\n            params.target,\n            params.value,\n            params.data\n        );\n    }\n\n    async buildBridgePayload(params: BridgeParams): Promise<string> {\n        return encodeBridgeAction(\n            params.token,\n            params.amount,\n            params.destinationChain,\n            params.recipient\n        );\n    }\n\n    async dispatch(\n        signature: WebAuthnSignature,\n        publicKeyX: bigint,\n        publicKeyY: bigint,\n        targetChain: number,\n        actionPayload: string,\n        nonce: bigint,\n        signer: any // Solana Keypair or similar\n    ): Promise<DispatchResult> {\n        void signature;\n        void publicKeyX;\n        void publicKeyY;\n        void targetChain;\n        void actionPayload;\n        void nonce;\n        void signer;\n        throw new Error(\n            'Direct dispatch not supported on Solana spoke chains. ' +\n            'Actions must be dispatched from the Hub (EVM) chain. ' +\n            'This client is for receiving cross-chain messages only.'\n        );\n    }\n\n    /**\n     * Dispatch an action via relayer (gasless)\n     * Note: On Solana, this still goes through the Hub chain\n     * Solana is a spoke-only chain in Veridex architecture\n     */\n    async dispatchGasless(\n        signature: WebAuthnSignature,\n        publicKeyX: bigint,\n        publicKeyY: bigint,\n        targetChain: number,\n        actionPayload: string,\n        nonce: bigint,\n        relayerUrl: string\n    ): Promise<DispatchResult> {\n        // Compute key hash\n        const keyHash = this.computeKeyHash(publicKeyX, publicKeyY);\n\n        // Build the message that was signed (matches Hub chain format)\n        const message = this.buildMessage(keyHash, targetChain, actionPayload, nonce);\n\n        // Prepare request for relayer\n        const request = {\n            messageHash: message,\n            r: '0x' + signature.r.toString(16).padStart(64, '0'),\n            s: '0x' + signature.s.toString(16).padStart(64, '0'),\n            publicKeyX: '0x' + publicKeyX.toString(16).padStart(64, '0'),\n            publicKeyY: '0x' + publicKeyY.toString(16).padStart(64, '0'),\n            targetChain,\n            actionPayload,\n            nonce: Number(nonce),\n        };\n\n        // Submit to relayer\n        const response = await fetch(`${relayerUrl}/api/v1/submit`, {\n            method: 'POST',\n            headers: {\n                'Content-Type': 'application/json',\n            },\n            body: JSON.stringify(request),\n        });\n\n        if (!response.ok) {\n            const error = await response.json().catch(() => ({ error: response.statusText }));\n            throw new Error(`Relayer submission failed: ${error.error || response.statusText}`);\n        }\n\n        const result = await response.json();\n\n        if (!result.success) {\n            throw new Error(`Relayer submission failed: ${result.error}`);\n        }\n\n        return {\n            transactionHash: result.txHash,\n            sequence: BigInt(result.sequence || '0'),\n            userKeyHash: keyHash,\n            targetChain,\n        };\n    }\n\n    async getVaultAddress(userKeyHash: string): Promise<string | null> {\n        try {\n            const vaultAddress = this.computeVaultAddressFromHash(userKeyHash);\n            const accountInfo = await this.connection.getAccountInfo(new PublicKey(vaultAddress));\n\n            if (!accountInfo) {\n                return null;\n            }\n\n            return vaultAddress;\n        } catch (error) {\n            console.error('Error getting vault address:', error);\n            return null;\n        }\n    }\n\n    /**\n     * Compute vault address using PDA (Program Derived Address)\n     * Seeds: [\"vault\", userKeyHash]\n     */\n    computeVaultAddress(userKeyHash: string): string {\n        return this.computeVaultAddressFromHash(userKeyHash);\n    }\n\n    private computeVaultAddressFromHash(userKeyHash: string): string {\n        const userKeyHashBuffer = Buffer.from(userKeyHash.replace('0x', ''), 'hex');\n        const [vaultPda] = PublicKey.findProgramAddressSync(\n            [Buffer.from('vault'), userKeyHashBuffer],\n            this.programId\n        );\n        return vaultPda.toBase58();\n    }\n\n    async vaultExists(userKeyHash: string): Promise<boolean> {\n        const address = await this.getVaultAddress(userKeyHash);\n        return address !== null;\n    }\n\n    async createVault(userKeyHash: string, signer: any): Promise<VaultCreationResult> {\n        void userKeyHash;\n        void signer;\n        throw new Error(\n            'Vault creation on Solana must be done via relayer. ' +\n            'Use createVaultViaRelayer() instead.'\n        );\n    }\n\n    async createVaultSponsored?(\n        userKeyHash: string,\n        sponsorPrivateKey: string,\n        rpcUrl?: string\n    ): Promise<VaultCreationResult> {\n        void userKeyHash;\n        void sponsorPrivateKey;\n        void rpcUrl;\n        throw new Error(\n            'Vault creation on Solana must be done via relayer. ' +\n            'Use createVaultViaRelayer() instead.'\n        );\n    }\n\n    /**\n     * Create a vault via the relayer (sponsored/gasless)\n     * This is the recommended way to create Solana vaults\n     */\n    async createVaultViaRelayer(\n        userKeyHash: string,\n        relayerUrl: string\n    ): Promise<VaultCreationResult> {\n        const response = await fetch(`${relayerUrl}/api/v1/solana/vault`, {\n            method: 'POST',\n            headers: {\n                'Content-Type': 'application/json',\n            },\n            body: JSON.stringify({\n                userKeyHash,\n                chainId: this.config.wormholeChainId,\n            }),\n        });\n\n        const result = await response.json();\n\n        if (!response.ok || !result.success) {\n            throw new Error(result.error || 'Failed to create vault via relayer');\n        }\n\n        return {\n            address: result.vaultAddress,\n            transactionHash: result.transactionHash || '',\n            blockNumber: 0, // Solana doesn't have block numbers like EVM\n            gasUsed: 0n, // Solana uses compute units, not gas\n            alreadyExisted: !result.transactionHash,\n            sponsoredBy: 'relayer',\n        };\n    }\n\n    /**\n     * Get vault info via relayer (includes existence check)\n     */\n    async getVaultViaRelayer(\n        userKeyHash: string,\n        relayerUrl: string\n    ): Promise<{ vaultAddress: string; exists: boolean }> {\n        const response = await fetch(\n            `${relayerUrl}/api/v1/solana/vault/${userKeyHash}?chainId=${this.config.wormholeChainId}`\n        );\n\n        if (!response.ok) {\n            throw new Error('Failed to get vault info from relayer');\n        }\n\n        const result = await response.json();\n        return {\n            vaultAddress: result.vaultAddress,\n            exists: result.exists,\n        };\n    }\n\n    async estimateVaultCreationGas(userKeyHash: string): Promise<bigint> {\n        void userKeyHash;\n        // Return SOL estimate for vault creation (rent + compute)\n        // ~0.002 SOL for rent-exempt account + compute units\n        return 2_000_000n; // 0.002 SOL in lamports\n    }\n\n    getFactoryAddress(): string | undefined {\n        // Solana uses program addresses, not factory pattern\n        return undefined;\n    }\n\n    getImplementationAddress(): string | undefined {\n        // Solana uses program addresses, not implementation pattern\n        return undefined;\n    }\n\n    // ========================================================================\n    // Balance Methods\n    // ========================================================================\n\n    /**\n     * Get native SOL balance\n     */\n    async getNativeBalance(address: string): Promise<bigint> {\n        const balance = await this.connection.getBalance(new PublicKey(address));\n        return BigInt(balance);\n    }\n\n    /**\n     * Get SPL token balance\n     */\n    async getTokenBalance(tokenAddress: string, ownerAddress: string): Promise<bigint> {\n        try {\n            const mint = new PublicKey(tokenAddress);\n            const owner = new PublicKey(ownerAddress);\n            const ata = getAssociatedTokenAddressSync(mint, owner);\n\n            const balance = await this.connection.getTokenAccountBalance(ata);\n            return BigInt(balance.value.amount);\n        } catch (error) {\n            console.error('Error getting token balance:', error);\n            return 0n;\n        }\n    }\n\n    // ========================================================================\n    // Utility Methods\n    // ========================================================================\n\n    /**\n     * Compute key hash from public key coordinates\n     * Matches EVM keccak256(abi.encode(publicKeyX, publicKeyY))\n     */\n    private computeKeyHash(publicKeyX: bigint, publicKeyY: bigint): string {\n        // Use SHA-256 for Solana (Solana doesn't have keccak256 built-in)\n        // The relayer will convert this to match EVM format\n        const xBuffer = Buffer.alloc(32);\n        const yBuffer = Buffer.alloc(32);\n\n        // Write as big-endian to match EVM encoding\n        const xHex = publicKeyX.toString(16).padStart(64, '0');\n        const yHex = publicKeyY.toString(16).padStart(64, '0');\n\n        Buffer.from(xHex, 'hex').copy(xBuffer);\n        Buffer.from(yHex, 'hex').copy(yBuffer);\n\n        // For cross-chain compatibility, we need to match the EVM hash\n        // This should be keccak256, but we'll return a format the relayer expects\n        const combined = Buffer.concat([xBuffer, yBuffer]);\n        const hash = createHash('sha256').update(combined).digest();\n\n        return '0x' + hash.toString('hex');\n    }\n\n    /**\n     * Build message for signing (matches Hub chain format)\n     */\n    private buildMessage(\n        keyHash: string,\n        targetChain: number,\n        actionPayload: string,\n        nonce: bigint\n    ): string {\n        // This should match the EVM message format for cross-chain compatibility\n        const keyHashBuffer = Buffer.from(keyHash.replace('0x', ''), 'hex');\n        const targetChainBuffer = Buffer.alloc(2);\n        targetChainBuffer.writeUInt16BE(targetChain);\n        const payloadBuffer = Buffer.from(actionPayload.replace('0x', ''), 'hex');\n        const nonceBuffer = Buffer.alloc(32);\n        const nonceHex = nonce.toString(16).padStart(64, '0');\n        Buffer.from(nonceHex, 'hex').copy(nonceBuffer);\n\n        const combined = Buffer.concat([\n            keyHashBuffer,\n            targetChainBuffer,\n            payloadBuffer,\n            nonceBuffer,\n        ]);\n\n        const hash = createHash('sha256').update(combined).digest();\n        return '0x' + hash.toString('hex');\n    }\n\n    /**\n     * Get connection instance for advanced usage\n     */\n    getConnection(): Connection {\n        return this.connection;\n    }\n\n    /**\n     * Get program ID\n     */\n    getProgramId(): PublicKey {\n        return this.programId;\n    }\n\n    /**\n     * Get current slot\n     */\n    async getSlot(): Promise<number> {\n        return await this.connection.getSlot();\n    }\n\n    /**\n     * Get transaction status\n     */\n    async getTransaction(signature: string, commitment?: 'confirmed' | 'finalized') {\n        return await this.connection.getTransaction(signature, {\n            commitment: commitment || 'confirmed',\n            maxSupportedTransactionVersion: 0,\n        });\n    }\n\n    // ============================================================================\n    // Social Recovery Methods (Issue #23)\n    // ============================================================================\n    // \n    // Note: Social recovery is managed on the Hub chain (EVM).\n    // Solana spokes receive and execute recovery VAAs broadcast from the Hub.\n    // These methods are placeholders that indicate spoke-only chains don't\n    // initiate recovery - they only execute recovery instructions from Hub VAAs.\n    //\n    // The relayer service handles:\n    // 1. Fetching recovery VAAs from Wormhole guardians\n    // 2. Submitting execute_recovery instruction to Solana spoke\n    // 3. Processing OwnerRecovered events\n    //\n    // SDK users should use EVMClient methods for guardian management and\n    // recovery initiation on the Hub chain.\n    // ============================================================================\n\n    /**\n     * Check if a recovery VAA has been executed on this spoke\n     * \n     * @param vaaHash - Hash of the recovery VAA\n     * @returns Whether the VAA has been processed\n     */\n    async isRecoveryExecuted(vaaHash: string): Promise<boolean> {\n        try {\n            // Derive VAA record PDA\n            const vaaHashBuffer = Buffer.from(vaaHash.replace('0x', ''), 'hex');\n            const [vaaRecordPda] = PublicKey.findProgramAddressSync(\n                [Buffer.from('vaa_record'), vaaHashBuffer],\n                this.programId\n            );\n\n            const accountInfo = await this.connection.getAccountInfo(vaaRecordPda);\n            if (!accountInfo || accountInfo.data.length < 9) {\n                return false;\n            }\n\n            // First byte after discriminator is 'processed' bool\n            return accountInfo.data[8] === 1;\n        } catch (error) {\n            console.error('Error checking recovery execution:', error);\n            return false;\n        }\n    }\n\n    /**\n     * Get vault owner after potential recovery\n     * \n     * @param vaultAddress - Vault address to check\n     * @returns Current owner key hash\n     */\n    async getVaultOwner(vaultAddress: string): Promise<string> {\n        try {\n            const accountInfo = await this.connection.getAccountInfo(new PublicKey(vaultAddress));\n            if (!accountInfo || accountInfo.data.length < 40) {\n                throw new Error('Vault not found');\n            }\n\n            // Owner key hash is stored after discriminator (8 bytes) at offset 8-40\n            const ownerKeyHash = accountInfo.data.slice(8, 40);\n            return '0x' + ownerKeyHash.toString('hex');\n        } catch (error) {\n            console.error('Error getting vault owner:', error);\n            throw error;\n        }\n    }\n\n    /**\n     * Get authorized signers for a vault\n     * \n     * @param vaultAddress - Vault address to check\n     * @returns Array of authorized signer key hashes\n     */\n    async getAuthorizedSigners(vaultAddress: string): Promise<string[]> {\n        try {\n            const accountInfo = await this.connection.getAccountInfo(new PublicKey(vaultAddress));\n            if (!accountInfo || accountInfo.data.length < 235) {\n                throw new Error('Vault not found');\n            }\n\n            // Vault layout:\n            // 8 bytes discriminator\n            // 32 bytes owner_key_hash\n            // 8 bytes nonce\n            // 1 byte paused\n            // 8 bytes daily_limit\n            // 8 bytes daily_spent\n            // 8 bytes day_start\n            // 1 byte bump\n            // 1 byte authorized_signer_count\n            // 5 * 32 bytes authorized_signers\n\n            const signerCount = accountInfo.data[66]; // offset 8+32+8+1+8+8+1 = 66\n            const signers: string[] = [];\n\n            for (let i = 0; i < signerCount; i++) {\n                const offset = 67 + (i * 32); // Start of authorized_signers array\n                const keyHash = accountInfo.data.slice(offset, offset + 32);\n                signers.push('0x' + keyHash.toString('hex'));\n            }\n\n            return signers;\n        } catch (error) {\n            console.error('Error getting authorized signers:', error);\n            throw error;\n        }\n    }\n}\n","/**\n * Veridex Protocol SDK - Payload Encoding/Decoding Utilities\n */\n\nimport { ethers } from 'ethers';\nimport {\n  ACTION_TRANSFER,\n  ACTION_EXECUTE,\n  ACTION_CONFIG,\n  ACTION_BRIDGE,\n  PROTOCOL_VERSION,\n} from './constants.js';\nimport type { TransferAction, BridgeAction, ExecuteAction, ActionPayload } from './types.js';\n\n// ============================================================================\n// Action Encoding\n// ============================================================================\n\n/**\n * Encode a transfer action payload\n * Format: [actionType(1)] [token(32)] [recipient(32)] [amount(32)]\n */\nexport function encodeTransferAction(\n  token: string,\n  recipient: string,\n  amount: bigint\n): string {\n  const tokenPadded = padTo32Bytes(token);\n  const recipientPadded = padTo32Bytes(recipient);\n  const amountBytes = ethers.zeroPadValue(ethers.toBeHex(amount), 32);\n\n  return ethers.concat([\n    ethers.toBeHex(ACTION_TRANSFER, 1),\n    tokenPadded,\n    recipientPadded,\n    amountBytes,\n  ]);\n}\n\n/**\n * Encode a bridge action payload\n * Format: [actionType(1)] [token(32)] [amount(32)] [targetChain(2)] [recipient(32)]\n */\nexport function encodeBridgeAction(\n  token: string,\n  amount: bigint,\n  targetChain: number,\n  recipient: string\n): string {\n  const tokenPadded = padTo32Bytes(token);\n  const amountBytes = ethers.zeroPadValue(ethers.toBeHex(amount), 32);\n  const targetChainBytes = ethers.toBeHex(targetChain, 2);\n  const recipientPadded = padTo32Bytes(recipient);\n\n  return ethers.concat([\n    ethers.toBeHex(ACTION_BRIDGE, 1),\n    tokenPadded,\n    amountBytes,\n    targetChainBytes,\n    recipientPadded,\n  ]);\n}\n\n/**\n * Encode an execute action payload (arbitrary contract call)\n * Format: [actionType(1)] [target(32)] [value(32)] [dataLength(2)] [data(variable)]\n */\nexport function encodeExecuteAction(\n  target: string,\n  value: bigint,\n  data: string\n): string {\n  const targetPadded = padTo32Bytes(target);\n  const valueBytes = ethers.zeroPadValue(ethers.toBeHex(value), 32);\n  const dataBytes = ethers.getBytes(data);\n  const dataLengthBytes = ethers.toBeHex(dataBytes.length, 2);\n\n  return ethers.concat([\n    ethers.toBeHex(ACTION_EXECUTE, 1),\n    targetPadded,\n    valueBytes,\n    dataLengthBytes,\n    data,\n  ]);\n}\n\n/**\n * Encode a config action payload\n * Format: [actionType(1)] [configType(1)] [configData(variable)]\n */\nexport function encodeConfigAction(configType: number, configData: string): string {\n  return ethers.concat([\n    ethers.toBeHex(ACTION_CONFIG, 1),\n    ethers.toBeHex(configType, 1),\n    configData,\n  ]);\n}\n\n// ============================================================================\n// Veridex Payload Encoding\n// ============================================================================\n\n/**\n * Encode the full Veridex message payload that gets published via Wormhole\n * Format: [version(1)] [userKeyHash(32)] [targetChain(2)] [nonce(32)] [pubKeyX(32)] [pubKeyY(32)] [actionPayload]\n */\nexport function encodeVeridexPayload(\n  userKeyHash: string,\n  targetChain: number,\n  nonce: bigint,\n  publicKeyX: bigint,\n  publicKeyY: bigint,\n  actionPayload: string\n): string {\n  return ethers.concat([\n    ethers.toBeHex(PROTOCOL_VERSION, 1),\n    userKeyHash,\n    ethers.toBeHex(targetChain, 2),\n    ethers.zeroPadValue(ethers.toBeHex(nonce), 32),\n    ethers.zeroPadValue(ethers.toBeHex(publicKeyX), 32),\n    ethers.zeroPadValue(ethers.toBeHex(publicKeyY), 32),\n    actionPayload,\n  ]);\n}\n\n// ============================================================================\n// Action Decoding\n// ============================================================================\n\n/**\n * Decode an action payload to determine its type and contents\n */\nexport function decodeActionPayload(payload: string): ActionPayload {\n  const data = ethers.getBytes(payload);\n  const actionType = data[0];\n\n  switch (actionType) {\n    case ACTION_TRANSFER:\n      return decodeTransferAction(payload);\n    case ACTION_BRIDGE:\n      return decodeBridgeAction(payload);\n    case ACTION_EXECUTE:\n      return decodeExecuteAction(payload);\n    default:\n      return { type: `unknown_${actionType}`, raw: payload };\n  }\n}\n\n/**\n * Decode a transfer action payload\n */\nexport function decodeTransferAction(payload: string): TransferAction {\n  const data = ethers.getBytes(payload);\n\n  const tokenBytes = data.slice(1, 33);\n  const recipientBytes = data.slice(33, 65);\n  const amountBytes = data.slice(65, 97);\n\n  return {\n    type: 'transfer',\n    token: trimTo20Bytes(ethers.hexlify(tokenBytes)),\n    recipient: trimTo20Bytes(ethers.hexlify(recipientBytes)),\n    amount: BigInt(ethers.hexlify(amountBytes)),\n  };\n}\n\n/**\n * Decode a bridge action payload\n */\nexport function decodeBridgeAction(payload: string): BridgeAction {\n  const data = ethers.getBytes(payload);\n\n  const tokenBytes = data.slice(1, 33);\n  const amountBytes = data.slice(33, 65);\n  const targetChainByte0 = data[65];\n  const targetChainByte1 = data[66];\n  const recipientBytes = data.slice(67, 99);\n\n  const targetChain = ((targetChainByte0 ?? 0) << 8) | (targetChainByte1 ?? 0);\n\n  return {\n    type: 'bridge',\n    token: trimTo20Bytes(ethers.hexlify(tokenBytes)),\n    amount: BigInt(ethers.hexlify(amountBytes)),\n    targetChain,\n    recipient: ethers.hexlify(recipientBytes),\n  };\n}\n\n/**\n * Decode an execute action payload\n */\nexport function decodeExecuteAction(payload: string): ExecuteAction {\n  const data = ethers.getBytes(payload);\n\n  const targetBytes = data.slice(1, 33);\n  const valueBytes = data.slice(33, 65);\n  const dataLengthByte0 = data[65];\n  const dataLengthByte1 = data[66];\n  const dataLength = ((dataLengthByte0 ?? 0) << 8) | (dataLengthByte1 ?? 0);\n  const callData = data.slice(67, 67 + dataLength);\n\n  return {\n    type: 'execute',\n    target: trimTo20Bytes(ethers.hexlify(targetBytes)),\n    value: BigInt(ethers.hexlify(valueBytes)),\n    data: ethers.hexlify(callData),\n  };\n}\n\n// ============================================================================\n// Chain-Specific Encodings\n// ============================================================================\n\n/**\n * Encode a Solana-compatible transfer action\n * Solana uses: [actionType(1)] [amount(8 LE)] [recipient(32)]\n */\nexport function encodeSolanaTransferAction(\n  amount: bigint,\n  recipient: string\n): string {\n  const amountBytes = Buffer.alloc(8);\n  amountBytes.writeBigUInt64LE(amount);\n\n  const recipientBytes = ethers.getBytes(recipient);\n\n  return ethers.hexlify(\n    Buffer.concat([\n      Buffer.from([ACTION_TRANSFER]),\n      amountBytes,\n      Buffer.from(recipientBytes),\n    ])\n  );\n}\n\n/**\n * Encode an Aptos-compatible transfer action\n * Aptos uses: [actionType(1)] [amount(8 LE)] [recipient(32)]\n */\nexport function encodeAptosTransferAction(\n  amount: bigint,\n  recipient: string\n): string {\n  const amountBytes = Buffer.alloc(8);\n  amountBytes.writeBigUInt64LE(amount);\n\n  const recipientPadded = padTo32Bytes(recipient);\n\n  return ethers.hexlify(\n    Buffer.concat([\n      Buffer.from([ACTION_TRANSFER]),\n      amountBytes,\n      Buffer.from(ethers.getBytes(recipientPadded)),\n    ])\n  );\n}\n\n/**\n * Encode a Sui-compatible transfer action\n * Sui uses: [actionType(1)] [amount(8 LE)] [recipient(32)]\n */\nexport function encodeSuiTransferAction(\n  amount: bigint,\n  recipient: string\n): string {\n  const amountBytes = Buffer.alloc(8);\n  amountBytes.writeBigUInt64LE(amount);\n\n  const recipientPadded = padTo32Bytes(recipient);\n\n  return ethers.hexlify(\n    Buffer.concat([\n      Buffer.from([ACTION_TRANSFER]),\n      amountBytes,\n      Buffer.from(ethers.getBytes(recipientPadded)),\n    ])\n  );\n}\n\n// ============================================================================\n// Address Utilities\n// ============================================================================\n\n/**\n * Pad an address to 32 bytes (Wormhole standard)\n * Supports both EVM addresses (0x...) and Solana addresses (base58)\n */\nexport function padTo32Bytes(address: string): string {\n  // Handle native token - convert to zero address\n  if (address.toLowerCase() === 'native') {\n    return '0x' + '0'.repeat(64);\n  }\n  \n  // If it starts with 0x, treat as hex\n  if (address.startsWith('0x')) {\n    const hex = address.replace('0x', '');\n    // Validate that hex only contains valid hex characters\n    if (!/^[0-9a-fA-F]*$/.test(hex)) {\n      throw new Error(`Invalid address: ${address}. Expected hex string or 'native'.`);\n    }\n    return '0x' + hex.padStart(64, '0');\n  }\n  \n  // Otherwise, assume base58 Solana address and decode it\n  // Base58 character set (Bitcoin/Solana style - no 0, O, I, l)\n  const base58Chars = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';\n  \n  // Validate base58 characters\n  for (const char of address) {\n    if (!base58Chars.includes(char)) {\n      throw new Error(`Invalid address: ${address}. Contains invalid base58 character '${char}'.`);\n    }\n  }\n  \n  // Decode base58 to bytes\n  let value = BigInt(0);\n  for (const char of address) {\n    value = value * 58n + BigInt(base58Chars.indexOf(char));\n  }\n  \n  // Convert to 32-byte hex\n  let hex = value.toString(16);\n  // Ensure it's not longer than 64 chars (32 bytes)\n  if (hex.length > 64) {\n    throw new Error(`Invalid address: ${address}. Decoded value too large for 32 bytes.`);\n  }\n  \n  return '0x' + hex.padStart(64, '0');\n}\n\n/**\n * Trim a 32-byte hex to a 20-byte EVM address\n */\nexport function trimTo20Bytes(hex32: string): string {\n  const clean = hex32.replace('0x', '');\n  return '0x' + clean.slice(-40);\n}\n\n/**\n * Convert a Solana public key (base58) to bytes32\n * @deprecated Use padTo32Bytes instead, which now handles both EVM and Solana addresses\n */\nexport function solanaAddressToBytes32(base58Address: string): string {\n  return padTo32Bytes(base58Address);\n}\n\n// ============================================================================\n// Amount Utilities\n// ============================================================================\n\n/**\n * Format an amount with decimals for display\n */\nexport function formatAmount(amount: bigint, decimals = 18): string {\n  const divisor = 10n ** BigInt(decimals);\n  const whole = amount / divisor;\n  const fraction = amount % divisor;\n\n  if (fraction === 0n) {\n    return whole.toString();\n  }\n\n  const fractionStr = fraction.toString().padStart(decimals, '0');\n  const trimmedFraction = fractionStr.replace(/0+$/, '');\n\n  return `${whole}.${trimmedFraction}`;\n}\n\n/**\n * Parse an amount string with decimals to bigint\n */\nexport function parseAmount(amountStr: string, decimals = 18): bigint {\n  const parts = amountStr.split('.');\n  const whole = BigInt(parts[0] ?? '0');\n\n  if (parts.length === 1 || !parts[1]) {\n    return whole * (10n ** BigInt(decimals));\n  }\n\n  const fractionStr = parts[1].slice(0, decimals).padEnd(decimals, '0');\n  const fraction = BigInt(fractionStr);\n\n  return whole * (10n ** BigInt(decimals)) + fraction;\n}\n\n// ============================================================================\n// Nonce Utilities\n// ============================================================================\n\n/**\n * Generate a unique nonce for a transaction\n */\nexport function generateNonce(): bigint {\n  const timestamp = BigInt(Date.now());\n  const random = BigInt(Math.floor(Math.random() * 1000000));\n  return (timestamp << 20n) | random;\n}\n\n/**\n * Create a message hash for signing (used in authenticateRawAndDispatch)\n */\nexport function createMessageHash(\n  targetChain: number,\n  actionPayload: string,\n  nonce: bigint\n): string {\n  return ethers.keccak256(\n    ethers.solidityPacked(\n      ['uint16', 'bytes', 'uint256'],\n      [targetChain, actionPayload, nonce]\n    )\n  );\n}\n\n/**\n * Create the challenge bytes for gasless dispatch (matches Hub's authenticateAndDispatch)\n * \n * The Hub contract passes raw packed bytes to WebAuthn.verify():\n * abi.encodePacked(targetChain, actionPayload, userNonce, hubChainId)\n * \n * The WebAuthn library then base64url-encodes these bytes to match against clientDataJSON.\n * We do NOT hash here - the challenge is the raw packed bytes.\n * \n * @param targetChain - Wormhole chain ID of the destination\n * @param actionPayload - The action payload (hex string)\n * @param nonce - User's current nonce\n * @param hubChainId - Wormhole chain ID of the Hub (e.g., 30 for Base)\n * @returns The packed bytes as hex string (NOT hashed)\n */\nexport function createGaslessMessageHash(\n  targetChain: number,\n  actionPayload: string,\n  nonce: bigint,\n  hubChainId: number\n): string {\n  // Return raw packed bytes - NO sha256 hash\n  // The contract passes these bytes directly to WebAuthn.verify()\n  return ethers.solidityPacked(\n    ['uint16', 'bytes', 'uint256', 'uint16'],\n    [targetChain, actionPayload, nonce, hubChainId]\n  );\n}\n\n/**\n * Build the challenge bytes for WebAuthn signing (gasless flow)\n * Returns raw packed bytes that match what the Hub contract expects\n * \n * @param targetChain - Wormhole chain ID of the destination\n * @param actionPayload - The action payload (hex string)\n * @param nonce - User's current nonce\n * @param hubChainId - Wormhole chain ID of the Hub\n * @returns Challenge bytes for WebAuthn signing (raw packed, not hashed)\n */\nexport function buildGaslessChallenge(\n  targetChain: number,\n  actionPayload: string,\n  nonce: bigint,\n  hubChainId: number\n): Uint8Array {\n  const packed = createGaslessMessageHash(targetChain, actionPayload, nonce, hubChainId);\n  return ethers.getBytes(packed);\n}\n\n/**\n * Build the challenge bytes for WebAuthn signing\n */\nexport function buildChallenge(\n  userKeyHash: string,\n  targetChain: number,\n  nonce: bigint,\n  actionPayload: string\n): Uint8Array {\n  const encoded = ethers.solidityPacked(\n    ['bytes32', 'uint16', 'uint256', 'bytes'],\n    [userKeyHash, targetChain, nonce, actionPayload]\n  );\n  return ethers.getBytes(ethers.keccak256(encoded));\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: '0xCFaEb5652aa2Ee60b2229dC8895B4159749C7e53',\n      vaultImplementation: '0x0d13367C16c6f0B24eD275CC67C7D9f42878285c',\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: '0xA5653d54079ABeCe780F8d9597B2bc4B09fe464A',\n      vaultImplementation: '0x8099b1406485d2255ff89Ce5Ea18520802AFC150',\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: '0x0237e04f74b991b5b6030a793779663033f4ff4a1682a9e66c1f41fc1ec3e2a4',\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 userNonces(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":["hex"]}