@veridex/sdk 1.0.0-beta.1

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/chains/evm/EVMClient.ts","../../../src/payload.ts","../../../src/constants.ts","../../../src/chains/evm/EVMHubClientAdapter.ts"],"sourcesContent":["/**\n * Veridex Protocol SDK - EVM Chain Client\n * \n * Implementation of ChainClient interface for EVM-compatible chains\n */\n\nimport { ethers } from 'ethers';\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 EVMClientConfig {\n    chainId: number;\n    wormholeChainId: number;\n    rpcUrl: string;\n    hubContractAddress: string;\n    wormholeCoreBridge: string;\n    name?: string;\n    explorerUrl?: string;\n    vaultFactory?: string;\n    vaultImplementation?: string;\n    tokenBridge?: string;\n}\n\n// ============================================================================\n// Constants\n// ============================================================================\n\n/**\n * EIP-1167 minimal proxy bytecode prefix (before implementation address)\n */\nconst PROXY_BYTECODE_PREFIX = '0x3d602d80600a3d3981f3363d3d373d3d3d363d73';\n\n/**\n * EIP-1167 minimal proxy bytecode suffix (after implementation address)\n */\nconst PROXY_BYTECODE_SUFFIX = '5af43d82803e903d91602b57fd5bf3';\n\n/**\n * ERC20 ABI for balance and transfer operations\n */\nconst ERC20_ABI = [\n    'function balanceOf(address owner) view returns (uint256)',\n    'function decimals() view returns (uint8)',\n    'function symbol() view returns (string)',\n    'function name() view returns (string)',\n    'function allowance(address owner, address spender) view returns (uint256)',\n    'function transfer(address to, uint256 amount) returns (bool)',\n    'function approve(address spender, uint256 amount) returns (bool)',\n];\n\n// ============================================================================\n// Hub Contract ABI (minimal)\n// ============================================================================\n\nconst HUB_ABI = [\n    'function dispatch(tuple(bytes authenticatorData, string clientDataJSON, uint256 challengeIndex, uint256 typeIndex, uint256 r, uint256 s) signature, uint256 publicKeyX, uint256 publicKeyY, uint16 targetChain, bytes actionPayload, uint256 nonce) payable returns (uint64 sequence)',\n    'function getNonce(bytes32 userKeyHash) view returns (uint256)',\n    'function getMessageFee() view returns (uint256)',\n    'function getVaultAddress(bytes32 userKeyHash) view returns (address)',\n    'function vaultExists(bytes32 userKeyHash) view returns (bool)',\n    'function createVault(bytes32 userKeyHash) returns (address)',\n    // Issue #9/#10: New Hub methods for Query-based execution\n    'function getUserState(bytes32 userKeyHash) view returns (bytes32 keyHash, uint256 nonce, bytes32 lastActionHash)',\n    'function getUserLastActionHash(bytes32 userKeyHash) view returns (bytes32)',\n    // Issue #13: Session key management\n    'function registerSession(tuple(bytes authenticatorData, string clientDataJSON, uint256 challengeIndex, uint256 typeIndex, uint256 r, uint256 s) auth, uint256 publicKeyX, uint256 publicKeyY, bytes32 sessionKeyHash, uint256 duration, uint256 maxValue, bool requireUV) external',\n    'function isSessionActive(bytes32 userKeyHash, bytes32 sessionKeyHash) view returns (bool active, uint256 expiry, uint256 maxValue, uint256 sessionIndex)',\n    'function revokeSession(tuple(bytes authenticatorData, string clientDataJSON, uint256 challengeIndex, uint256 typeIndex, uint256 r, uint256 s) auth, uint256 publicKeyX, uint256 publicKeyY, bytes32 sessionKeyHash, bool requireUV) external',\n    'function getUserSessions(bytes32 userKeyHash) view returns (tuple(bytes32 sessionKeyHash, uint256 expiry, uint256 maxValue, bool revoked)[])',\n    'function getUserSessionCount(bytes32 userKeyHash) view returns (uint256)',\n    // Issue #22: Backup Passkey / Multi-Key Identity management\n    'function registerIdentity(tuple(bytes authenticatorData, string clientDataJSON, uint256 challengeIndex, uint256 typeIndex, uint256 r, uint256 s) auth, uint256 publicKeyX, uint256 publicKeyY) external',\n    'function addBackupKey(tuple(bytes authenticatorData, string clientDataJSON, uint256 challengeIndex, uint256 typeIndex, uint256 r, uint256 s) auth, uint256 publicKeyX, uint256 publicKeyY, uint256 newPublicKeyX, uint256 newPublicKeyY, uint256 nonce) external payable returns (uint64 sequence)',\n    'function removeKey(tuple(bytes authenticatorData, string clientDataJSON, uint256 challengeIndex, uint256 typeIndex, uint256 r, uint256 s) auth, uint256 publicKeyX, uint256 publicKeyY, bytes32 keyToRemove, uint256 nonce) external payable returns (uint64 sequence)',\n    'function getIdentityForKey(bytes32 keyHash) view returns (bytes32)',\n    'function getAuthorizedKeys(bytes32 identity) view returns (bytes32[])',\n    'function getAuthorizedKeyCount(bytes32 identity) view returns (uint256)',\n    'function isAuthorizedForIdentity(bytes32 identity, bytes32 keyHash) view returns (bool)',\n    'function isIdentityRoot(bytes32 keyHash) view returns (bool)',\n    'function getIdentityState(bytes32 keyHash) view returns (bytes32 identity, uint256 keyCount, uint256 maxKeys, bool isRoot)',\n    \n    // Issue #23: Social Recovery / Guardian Management\n    'function setupGuardians(tuple(bytes authenticatorData, string clientDataJSON, uint256 challengeIndex, uint256 typeIndex, uint256 r, uint256 s) auth, uint256 publicKeyX, uint256 publicKeyY, bytes32[] guardians, uint256 threshold) external payable returns (uint64 sequence)',\n    'function addGuardian(tuple(bytes authenticatorData, string clientDataJSON, uint256 challengeIndex, uint256 typeIndex, uint256 r, uint256 s) auth, uint256 publicKeyX, uint256 publicKeyY, bytes32 guardianKeyHash) external payable returns (uint64 sequence)',\n    'function removeGuardian(tuple(bytes authenticatorData, string clientDataJSON, uint256 challengeIndex, uint256 typeIndex, uint256 r, uint256 s) auth, uint256 publicKeyX, uint256 publicKeyY, bytes32 guardianKeyHash) external payable returns (uint64 sequence)',\n    'function initiateRecovery(tuple(bytes authenticatorData, string clientDataJSON, uint256 challengeIndex, uint256 typeIndex, uint256 r, uint256 s) auth, uint256 publicKeyX, uint256 publicKeyY, bytes32 identityToRecover, bytes32 newOwnerKeyHash) external payable returns (uint64 sequence)',\n    'function approveRecovery(tuple(bytes authenticatorData, string clientDataJSON, uint256 challengeIndex, uint256 typeIndex, uint256 r, uint256 s) auth, uint256 publicKeyX, uint256 publicKeyY, bytes32 identityToRecover) external payable returns (uint64 sequence)',\n    'function executeRecovery(bytes32 identityToRecover, uint256 newPublicKeyX, uint256 newPublicKeyY) external payable returns (uint64 sequence)',\n    'function cancelRecovery(tuple(bytes authenticatorData, string clientDataJSON, uint256 challengeIndex, uint256 typeIndex, uint256 r, uint256 s) auth, uint256 publicKeyX, uint256 publicKeyY) external payable returns (uint64 sequence)',\n    'function getGuardians(bytes32 identityKeyHash) view returns (bytes32[] guardians, uint256 threshold, bool isConfigured)',\n    'function getRecoveryStatus(bytes32 identityKeyHash) view returns (bool isActive, bytes32 newOwnerKeyHash, uint256 initiatedAt, uint256 approvalCount, uint256 threshold, uint256 canExecuteAt, uint256 expiresAt)',\n    'function hasGuardianApproved(bytes32 identityKeyHash, bytes32 guardianKeyHash) view returns (bool hasApproved)',\n];\n\n// ============================================================================\n// Factory Contract ABI (minimal)\n// ============================================================================\n\nconst FACTORY_ABI = [\n    'function createVault(bytes32 ownerKeyHash) returns (address vault)',\n    'function getVault(bytes32 ownerKeyHash) view returns (address)',\n    'function computeVaultAddress(bytes32 ownerKeyHash) view returns (address vault)',\n    'function vaultExists(bytes32 ownerKeyHash) view returns (bool)',\n    'function implementation() view returns (address)',\n];\n\n// ============================================================================\n// EVMClient Class\n// ============================================================================\n\n/**\n * EVM implementation of the ChainClient interface\n */\nexport class EVMClient implements ChainClient {\n    private config: ChainConfig;\n    private provider: ethers.JsonRpcProvider;\n    private hubContract: ethers.Contract;\n    private factoryContract: ethers.Contract | null = null;\n    private cachedImplementation: string | null = null;\n\n    constructor(config: EVMClientConfig) {\n        this.config = {\n            name: config.name ?? `EVM Chain ${config.chainId}`,\n            chainId: config.chainId,\n            wormholeChainId: config.wormholeChainId,\n            rpcUrl: config.rpcUrl,\n            explorerUrl: config.explorerUrl ?? '',\n            isEvm: true,\n            contracts: {\n                hub: config.hubContractAddress,\n                vaultFactory: config.vaultFactory,\n                vaultImplementation: config.vaultImplementation,\n                wormholeCoreBridge: config.wormholeCoreBridge,\n                tokenBridge: config.tokenBridge,\n            },\n        };\n\n        this.provider = new ethers.JsonRpcProvider(config.rpcUrl);\n        this.hubContract = new ethers.Contract(\n            config.hubContractAddress,\n            HUB_ABI,\n            this.provider\n        );\n\n        // Initialize factory contract if address is provided\n        if (config.vaultFactory) {\n            this.factoryContract = new ethers.Contract(\n                config.vaultFactory,\n                FACTORY_ABI,\n                this.provider\n            );\n        }\n\n        // Cache implementation address if provided\n        if (config.vaultImplementation) {\n            this.cachedImplementation = config.vaultImplementation;\n        }\n    }\n\n    getConfig(): ChainConfig {\n        return this.config;\n    }\n\n    async getNonce(userKeyHash: string): Promise<bigint> {\n        const nonce = await this.hubContract.getNonce(userKeyHash);\n        return BigInt(nonce.toString());\n    }\n\n    /**\n     * Get user state from Hub (Issue #9/#10)\n     * Returns comprehensive state including last action hash\n     */\n    async getUserState(userKeyHash: string): Promise<{\n        keyHash: string;\n        nonce: bigint;\n        lastActionHash: string;\n    }> {\n        try {\n            const result = await this.hubContract.getUserState(userKeyHash);\n            return {\n                keyHash: result[0],\n                nonce: BigInt(result[1].toString()),\n                lastActionHash: result[2],\n            };\n        } catch (error) {\n            // Fallback for older Hub deployments without getUserState\n            const nonce = await this.getNonce(userKeyHash);\n            return {\n                keyHash: userKeyHash,\n                nonce,\n                lastActionHash: ethers.ZeroHash,\n            };\n        }\n    }\n\n    /**\n     * Get user's last action hash from Hub (Issue #9/#10)\n     * Returns zero hash if user has no actions yet\n     */\n    async getUserLastActionHash(userKeyHash: string): Promise<string> {\n        try {\n            return await this.hubContract.getUserLastActionHash(userKeyHash);\n        } catch (error) {\n            // Fallback for older Hub deployments\n            return ethers.ZeroHash;\n        }\n    }\n\n    // ==========================================================================\n    // Session Management Methods (Issue #13)\n    // ==========================================================================\n\n    /**\n     * Register a new session key for temporary authentication\n     * Enables native L1 speed for repeat transactions without biometric auth\n     * \n     * @param params Session registration parameters\n     * @param signer Ethereum signer to pay gas\n     * @returns Transaction receipt\n     */\n    async registerSession(\n        params: import('../../types.js').RegisterSessionParams,\n        signer: ethers.Signer\n    ): Promise<ethers.TransactionReceipt> {\n        const hubWithSigner = this.hubContract.connect(signer) as any;\n\n        const authTuple = {\n            authenticatorData: params.signature.authenticatorData,\n            clientDataJSON: params.signature.clientDataJSON,\n            challengeIndex: params.signature.challengeIndex,\n            typeIndex: params.signature.typeIndex,\n            r: params.signature.r,\n            s: params.signature.s,\n        };\n\n        const tx = await hubWithSigner.registerSession(\n            authTuple,\n            params.publicKeyX,\n            params.publicKeyY,\n            params.sessionKeyHash,\n            params.duration,\n            params.maxValue,\n            params.requireUV\n        );\n\n        return await tx.wait();\n    }\n\n    /**\n     * Check if a session is currently active (queryable via Wormhole CCQ)\n     * \n     * @param userKeyHash Hash of the user's Passkey public key\n     * @param sessionKeyHash Hash of the session key to check\n     * @returns Session validation result\n     */\n    async isSessionActive(\n        userKeyHash: string,\n        sessionKeyHash: string\n    ): Promise<import('../../types.js').SessionValidationResult> {\n        const result = await this.hubContract.isSessionActive(userKeyHash, sessionKeyHash);\n        \n        return {\n            active: result[0],\n            expiry: Number(result[1]),\n            maxValue: BigInt(result[2].toString()),\n            sessionIndex: Number(result[3]),\n        };\n    }\n\n    /**\n     * Revoke a session key immediately\n     * \n     * @param params Session revocation parameters\n     * @param signer Ethereum signer to pay gas\n     * @returns Transaction receipt\n     */\n    async revokeSession(\n        params: import('../../types.js').RevokeSessionParams,\n        signer: ethers.Signer\n    ): Promise<ethers.TransactionReceipt> {\n        const hubWithSigner = this.hubContract.connect(signer) as any;\n\n        const authTuple = {\n            authenticatorData: params.signature.authenticatorData,\n            clientDataJSON: params.signature.clientDataJSON,\n            challengeIndex: params.signature.challengeIndex,\n            typeIndex: params.signature.typeIndex,\n            r: params.signature.r,\n            s: params.signature.s,\n        };\n\n        const tx = await hubWithSigner.revokeSession(\n            authTuple,\n            params.publicKeyX,\n            params.publicKeyY,\n            params.sessionKeyHash,\n            params.requireUV\n        );\n\n        return await tx.wait();\n    }\n\n    /**\n     * Get all sessions for a user\n     * \n     * @param userKeyHash Hash of the user's Passkey public key\n     * @returns Array of all sessions (active and expired/revoked)\n     */\n    async getUserSessions(userKeyHash: string): Promise<import('../../types.js').SessionKey[]> {\n        const sessions = await this.hubContract.getUserSessions(userKeyHash);\n        \n        return sessions.map((s: any) => ({\n            sessionKeyHash: s.sessionKeyHash,\n            expiry: Number(s.expiry),\n            maxValue: BigInt(s.maxValue.toString()),\n            revoked: s.revoked,\n        }));\n    }\n\n    /**\n     * Get the number of sessions for a user\n     * \n     * @param userKeyHash Hash of the user's Passkey public key\n     * @returns Number of sessions\n     */\n    async getUserSessionCount(userKeyHash: string): Promise<number> {\n        const count = await this.hubContract.getUserSessionCount(userKeyHash);\n        return Number(count);\n    }\n\n    async getMessageFee(): Promise<bigint> {\n        const fee = await this.hubContract.getMessageFee();\n        return BigInt(fee.toString());\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: ethers.Signer\n    ): Promise<DispatchResult> {\n        const hubWithSigner = this.hubContract.connect(signer) as any;\n\n        const signatureTuple = {\n            authenticatorData: signature.authenticatorData,\n            clientDataJSON: signature.clientDataJSON,\n            challengeIndex: signature.challengeIndex,\n            typeIndex: signature.typeIndex,\n            r: signature.r,\n            s: signature.s,\n        };\n\n        const messageFee = await this.getMessageFee();\n\n        const tx = await hubWithSigner.dispatch(\n            signatureTuple,\n            publicKeyX,\n            publicKeyY,\n            targetChain,\n            actionPayload,\n            nonce,\n            { value: messageFee }\n        );\n\n        const receipt = await tx.wait();\n\n        // Extract sequence from event logs\n        const dispatchEvent = receipt.logs.find((log: any) => {\n            try {\n                const parsed = hubWithSigner.interface.parseLog(log);\n                return parsed?.name === 'ActionDispatched';\n            } catch {\n                return false;\n            }\n        });\n\n        let sequence = 0n;\n        if (dispatchEvent) {\n            const parsed = hubWithSigner.interface.parseLog(dispatchEvent);\n            sequence = BigInt(parsed?.args?.sequence?.toString() ?? '0');\n        }\n\n        const keyHash = ethers.keccak256(\n            ethers.AbiCoder.defaultAbiCoder().encode(\n                ['uint256', 'uint256'],\n                [publicKeyX, publicKeyY]\n            )\n        );\n\n        return {\n            transactionHash: receipt.hash,\n            sequence,\n            userKeyHash: keyHash,\n            targetChain,\n            blockNumber: receipt.blockNumber,\n        };\n    }\n\n    /**\n     * Dispatch an action to the Hub via relayer (gasless)\n     * The relayer pays for gas and submits the transaction on behalf of the user\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 message hash that was signed\n        // This should match how the WebAuthn signature was generated\n        const keyHash = ethers.keccak256(\n            ethers.AbiCoder.defaultAbiCoder().encode(\n                ['uint256', 'uint256'],\n                [publicKeyX, publicKeyY]\n            )\n        );\n\n        // Build the message that was signed\n        const message = ethers.keccak256(\n            ethers.AbiCoder.defaultAbiCoder().encode(\n                ['bytes32', 'uint16', 'bytes', 'uint256'],\n                [keyHash, targetChain, actionPayload, nonce]\n            )\n        );\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            // Try factory first if available\n            if (this.factoryContract) {\n                const address = await this.factoryContract.getVault(userKeyHash);\n                if (address !== ethers.ZeroAddress) {\n                    return address;\n                }\n            }\n\n            // Fallback to hub contract\n            const address = await this.hubContract.getVaultAddress(userKeyHash);\n            if (address === ethers.ZeroAddress) {\n                return null;\n            }\n            return address;\n        } catch (error) {\n            console.error('Error getting vault address:', error);\n            return null;\n        }\n    }\n\n    /**\n     * Compute vault address deterministically without querying the chain\n     * Uses CREATE2 with EIP-1167 minimal proxy pattern\n     */\n    computeVaultAddress(userKeyHash: string): string {\n        const factoryAddress = this.getFactoryAddress();\n        const implementationAddress = this.getImplementationAddress();\n\n        if (!factoryAddress || !implementationAddress) {\n            throw new Error('Factory and implementation addresses required for address computation');\n        }\n\n        // Compute salt: keccak256(abi.encodePacked(factory, keyHash))\n        const salt = ethers.keccak256(\n            ethers.solidityPacked(\n                ['address', 'bytes32'],\n                [factoryAddress, userKeyHash]\n            )\n        );\n\n        // Build EIP-1167 initcode\n        const initCode = this.buildProxyInitCode(implementationAddress);\n        const initCodeHash = ethers.keccak256(initCode);\n\n        // CREATE2 address computation:\n        // address = keccak256(0xff ++ factory ++ salt ++ initCodeHash)[12:]\n        const create2Data = ethers.solidityPacked(\n            ['bytes1', 'address', 'bytes32', 'bytes32'],\n            ['0xff', factoryAddress, salt, initCodeHash]\n        );\n\n        const hash = ethers.keccak256(create2Data);\n        // Take last 20 bytes as address\n        return ethers.getAddress('0x' + hash.slice(26));\n    }\n\n    /**\n     * Build EIP-1167 minimal proxy initcode\n     */\n    private buildProxyInitCode(implementationAddress: string): string {\n        const impl = implementationAddress.toLowerCase().replace('0x', '');\n        return PROXY_BYTECODE_PREFIX + impl + PROXY_BYTECODE_SUFFIX;\n    }\n\n    async vaultExists(userKeyHash: string): Promise<boolean> {\n        try {\n            // Try factory first if available\n            if (this.factoryContract) {\n                return await this.factoryContract.vaultExists(userKeyHash);\n            }\n            // Hub chains may not have vaultExists, silently return false\n            if (this.hubContract.vaultExists) {\n                try {\n                    return await this.hubContract.vaultExists(userKeyHash);\n                } catch {\n                    // Hub contract doesn't have vaultExists - this is expected on hub-only chains\n                    return false;\n                }\n            }\n            return false;\n        } catch {\n            // Silently return false - vault existence check is non-critical\n            return false;\n        }\n    }\n\n    async createVault(userKeyHash: string, signer: ethers.Signer): Promise<VaultCreationResult> {\n        // Check if vault already exists\n        const exists = await this.vaultExists(userKeyHash);\n        if (exists) {\n            const address = await this.getVaultAddress(userKeyHash);\n            if (address) {\n                return {\n                    address,\n                    transactionHash: '',\n                    blockNumber: 0,\n                    gasUsed: 0n,\n                    alreadyExisted: true,\n                };\n            }\n        }\n\n        // Create vault using factory or hub\n        let tx: ethers.TransactionResponse;\n\n        if (this.factoryContract) {\n            const factoryWithSigner = this.factoryContract.connect(signer) as ethers.Contract;\n            tx = await factoryWithSigner.createVault(userKeyHash);\n        } else {\n            const hubWithSigner = this.hubContract.connect(signer) as ethers.Contract;\n            tx = await hubWithSigner.createVault(userKeyHash);\n        }\n\n        const receipt = await tx.wait();\n        if (!receipt) {\n            throw new Error('Transaction failed - no receipt');\n        }\n\n        const vaultAddress = await this.getVaultAddress(userKeyHash);\n        if (!vaultAddress) {\n            throw new Error('Failed to create vault - address not found after creation');\n        }\n\n        return {\n            address: vaultAddress,\n            transactionHash: receipt.hash,\n            blockNumber: receipt.blockNumber,\n            gasUsed: receipt.gasUsed,\n            alreadyExisted: false,\n        };\n    }\n\n    /**\n     * Create a vault with a sponsor wallet paying for gas\n     * \n     * @param userKeyHash - The user's passkey hash\n     * @param sponsorPrivateKey - Private key of the wallet that will pay gas\n     * @param rpcUrl - Optional RPC URL to use (defaults to client's RPC)\n     * @returns VaultCreationResult with address and transaction details\n     */\n    async createVaultSponsored(\n        userKeyHash: string,\n        sponsorPrivateKey: string,\n        rpcUrl?: string\n    ): Promise<VaultCreationResult> {\n        // Check if vault already exists\n        const exists = await this.vaultExists(userKeyHash);\n        if (exists) {\n            const address = await this.getVaultAddress(userKeyHash);\n            if (address) {\n                return {\n                    address,\n                    transactionHash: '',\n                    blockNumber: 0,\n                    gasUsed: 0n,\n                    alreadyExisted: true,\n                };\n            }\n        }\n\n        // Create sponsor signer\n        const provider = rpcUrl\n            ? new ethers.JsonRpcProvider(rpcUrl)\n            : this.provider;\n        const sponsorWallet = new ethers.Wallet(sponsorPrivateKey, provider);\n\n        // Check sponsor balance\n        const sponsorBalance = await provider.getBalance(sponsorWallet.address);\n        const estimatedGas = await this.estimateVaultCreationGas(userKeyHash);\n        const feeData = await provider.getFeeData();\n        const estimatedCost = estimatedGas * (feeData.gasPrice ?? 1000000000n);\n\n        if (sponsorBalance < estimatedCost) {\n            throw new Error(\n                `Sponsor wallet has insufficient funds. ` +\n                `Balance: ${ethers.formatEther(sponsorBalance)} ETH, ` +\n                `Estimated cost: ${ethers.formatEther(estimatedCost)} ETH`\n            );\n        }\n\n        // Create vault using factory or hub with sponsor wallet\n        let tx: ethers.TransactionResponse;\n\n        if (this.factoryContract) {\n            const factoryWithSponsor = this.factoryContract.connect(sponsorWallet) as ethers.Contract;\n            tx = await factoryWithSponsor.createVault(userKeyHash);\n        } else {\n            const hubWithSponsor = this.hubContract.connect(sponsorWallet) as ethers.Contract;\n            tx = await hubWithSponsor.createVault(userKeyHash);\n        }\n\n        const receipt = await tx.wait();\n        if (!receipt) {\n            throw new Error('Transaction failed - no receipt');\n        }\n\n        const vaultAddress = await this.getVaultAddress(userKeyHash);\n        if (!vaultAddress) {\n            throw new Error('Failed to create vault - address not found after creation');\n        }\n\n        return {\n            address: vaultAddress,\n            transactionHash: receipt.hash,\n            blockNumber: receipt.blockNumber,\n            gasUsed: receipt.gasUsed,\n            alreadyExisted: false,\n            sponsoredBy: sponsorWallet.address,\n        };\n    }\n\n    async estimateVaultCreationGas(userKeyHash: string): Promise<bigint> {\n        try {\n            if (this.factoryContract) {\n                return await this.factoryContract.createVault.estimateGas(userKeyHash);\n            }\n            return await this.hubContract.createVault.estimateGas(userKeyHash);\n        } catch (error) {\n            // Return a default estimate if estimation fails (vault might already exist)\n            console.warn('Gas estimation failed, returning default:', error);\n            return 150000n; // Default estimate for vault creation\n        }\n    }\n\n    getFactoryAddress(): string | undefined {\n        return this.config.contracts.vaultFactory;\n    }\n\n    getImplementationAddress(): string | undefined {\n        return this.config.contracts.vaultImplementation ?? this.cachedImplementation ?? undefined;\n    }\n\n    /**\n     * Fetch implementation address from factory contract\n     */\n    async fetchImplementationAddress(): Promise<string | null> {\n        if (this.cachedImplementation) {\n            return this.cachedImplementation;\n        }\n\n        if (!this.factoryContract) {\n            return null;\n        }\n\n        try {\n            this.cachedImplementation = await this.factoryContract.implementation();\n            return this.cachedImplementation;\n        } catch (error) {\n            console.error('Error fetching implementation address:', error);\n            return null;\n        }\n    }\n\n    /**\n     * Get the provider instance\n     */\n    getProvider(): ethers.JsonRpcProvider {\n        return this.provider;\n    }\n\n    // ========================================================================\n    // Balance Methods (Phase 2)\n    // ========================================================================\n\n    /**\n     * Get native token balance for an address\n     */\n    async getNativeBalance(address: string): Promise<bigint> {\n        return await this.provider.getBalance(address);\n    }\n\n    /**\n     * Get ERC20 token balance for an address\n     */\n    async getTokenBalance(tokenAddress: string, ownerAddress: string): Promise<bigint> {\n        const contract = new ethers.Contract(tokenAddress, ERC20_ABI, this.provider);\n        return await contract.balanceOf(ownerAddress);\n    }\n\n    /**\n     * Get token allowance\n     */\n    async getTokenAllowance(\n        tokenAddress: string,\n        ownerAddress: string,\n        spenderAddress: string\n    ): Promise<bigint> {\n        const contract = new ethers.Contract(tokenAddress, ERC20_ABI, this.provider);\n        return await contract.allowance(ownerAddress, spenderAddress);\n    }\n\n    /**\n     * Estimate gas for a dispatch transaction\n     */\n    async estimateDispatchGas(\n        signature: WebAuthnSignature,\n        publicKeyX: bigint,\n        publicKeyY: bigint,\n        targetChain: number,\n        actionPayload: string,\n        nonce: bigint\n    ): Promise<bigint> {\n        const signatureTuple = {\n            authenticatorData: signature.authenticatorData,\n            clientDataJSON: signature.clientDataJSON,\n            challengeIndex: signature.challengeIndex,\n            typeIndex: signature.typeIndex,\n            r: signature.r,\n            s: signature.s,\n        };\n\n        const messageFee = await this.getMessageFee();\n\n        try {\n            const gasEstimate = await this.hubContract.dispatch.estimateGas(\n                signatureTuple,\n                publicKeyX,\n                publicKeyY,\n                targetChain,\n                actionPayload,\n                nonce,\n                { value: messageFee }\n            );\n            return gasEstimate;\n        } catch (error) {\n            console.warn('Gas estimation failed, using default:', error);\n            return 500000n; // Default estimate for dispatch\n        }\n    }\n\n    /**\n     * Get current gas price\n     */\n    async getGasPrice(): Promise<bigint> {\n        const feeData = await this.provider.getFeeData();\n        return feeData.gasPrice ?? feeData.maxFeePerGas ?? 0n;\n    }\n\n    /**\n     * Get current block number\n     */\n    async getBlockNumber(): Promise<number> {\n        return await this.provider.getBlockNumber();\n    }\n\n    /**\n     * Get transaction receipt\n     */\n    async getTransactionReceipt(hash: string): Promise<ethers.TransactionReceipt | null> {\n        return await this.provider.getTransactionReceipt(hash);\n    }\n\n    /**\n     * Wait for transaction confirmation\n     */\n    async waitForTransaction(\n        hash: string,\n        confirmations: number = 1\n    ): Promise<ethers.TransactionReceipt | null> {\n        return await this.provider.waitForTransaction(hash, confirmations);\n    }\n\n    // ==========================================================================\n    // Backup Passkey / Multi-Key Identity Methods (Issue #22)\n    // ==========================================================================\n\n    /**\n     * Get the identity for a given key hash\n     * Returns zero hash if key is not registered to any identity\n     * \n     * @param keyHash Hash of the passkey to look up\n     * @returns Identity (first passkey's keyHash) or zero hash\n     */\n    async getIdentityForKey(keyHash: string): Promise<string> {\n        try {\n            return await this.hubContract.getIdentityForKey(keyHash);\n        } catch (error) {\n            return ethers.ZeroHash;\n        }\n    }\n\n    /**\n     * Get all authorized keys for an identity\n     * \n     * @param identity The identity key hash (first passkey's keyHash)\n     * @returns Array of authorized key hashes\n     */\n    async getAuthorizedKeys(identity: string): Promise<string[]> {\n        try {\n            return await this.hubContract.getAuthorizedKeys(identity);\n        } catch (error) {\n            return [];\n        }\n    }\n\n    /**\n     * Get count of authorized keys for an identity\n     * \n     * @param identity The identity key hash\n     * @returns Number of authorized keys\n     */\n    async getAuthorizedKeyCount(identity: string): Promise<number> {\n        try {\n            const count = await this.hubContract.getAuthorizedKeyCount(identity);\n            return Number(count);\n        } catch (error) {\n            return 0;\n        }\n    }\n\n    /**\n     * Check if a key is authorized for an identity\n     * \n     * @param identity The identity key hash\n     * @param keyHash The key hash to check\n     * @returns Whether the key is authorized\n     */\n    async isAuthorizedForIdentity(identity: string, keyHash: string): Promise<boolean> {\n        try {\n            return await this.hubContract.isAuthorizedForIdentity(identity, keyHash);\n        } catch (error) {\n            return false;\n        }\n    }\n\n    /**\n     * Check if a key is the root identity key\n     * \n     * @param keyHash The key hash to check\n     * @returns Whether the key is a root identity\n     */\n    async isIdentityRootKey(keyHash: string): Promise<boolean> {\n        try {\n            return await this.hubContract.isIdentityRoot(keyHash);\n        } catch (error) {\n            return false;\n        }\n    }\n\n    /**\n     * Get comprehensive identity state for a key\n     * \n     * @param keyHash Hash of any key in the identity\n     * @returns Identity state including count, max, and root status\n     */\n    async getIdentityState(keyHash: string): Promise<import('../../types.js').IdentityState> {\n        try {\n            const result = await this.hubContract.getIdentityState(keyHash);\n            return {\n                identity: result[0],\n                keyCount: Number(result[1]),\n                maxKeys: Number(result[2]),\n                isRoot: result[3],\n            };\n        } catch (error) {\n            // Fallback for keys not registered\n            return {\n                identity: ethers.ZeroHash,\n                keyCount: 0,\n                maxKeys: 5,\n                isRoot: false,\n            };\n        }\n    }\n\n    /**\n     * Register a new identity with the first passkey\n     * This makes the passkey the root identity key\n     * \n     * @param signature WebAuthn signature\n     * @param publicKeyX Passkey public key X coordinate\n     * @param publicKeyY Passkey public key Y coordinate\n     * @param signer Ethereum signer to pay gas\n     * @returns Transaction receipt and identity hash\n     */\n    async registerIdentity(\n        signature: WebAuthnSignature,\n        publicKeyX: bigint,\n        publicKeyY: bigint,\n        signer: ethers.Signer\n    ): Promise<{ receipt: ethers.TransactionReceipt; identity: string }> {\n        const hubWithSigner = this.hubContract.connect(signer) as any;\n\n        const authTuple = {\n            authenticatorData: signature.authenticatorData,\n            clientDataJSON: signature.clientDataJSON,\n            challengeIndex: signature.challengeIndex,\n            typeIndex: signature.typeIndex,\n            r: signature.r,\n            s: signature.s,\n        };\n\n        const tx = await hubWithSigner.registerIdentity(\n            authTuple,\n            publicKeyX,\n            publicKeyY\n        );\n\n        const receipt = await tx.wait();\n        \n        // Compute identity (keyHash of the registered key)\n        const keyHash = ethers.keccak256(\n            ethers.solidityPacked(['uint256', 'uint256'], [publicKeyX, publicKeyY])\n        );\n\n        return { receipt, identity: keyHash };\n    }\n\n    /**\n     * Add a backup passkey to an existing identity\n     * Requires WebAuthn signature from an authorized key\n     * \n     * @param signature WebAuthn signature from existing authorized key\n     * @param publicKeyX Existing key's X coordinate\n     * @param publicKeyY Existing key's Y coordinate\n     * @param newPublicKeyX New backup key's X coordinate\n     * @param newPublicKeyY New backup key's Y coordinate\n     * @param nonce Current nonce for the signing key\n     * @param signer Ethereum signer to pay gas\n     * @returns Transaction receipt and sequence number\n     */\n    async addBackupKey(\n        signature: WebAuthnSignature,\n        publicKeyX: bigint,\n        publicKeyY: bigint,\n        newPublicKeyX: bigint,\n        newPublicKeyY: bigint,\n        nonce: bigint,\n        signer: ethers.Signer\n    ): Promise<{ receipt: ethers.TransactionReceipt; sequence: bigint }> {\n        const hubWithSigner = this.hubContract.connect(signer) as any;\n\n        const authTuple = {\n            authenticatorData: signature.authenticatorData,\n            clientDataJSON: signature.clientDataJSON,\n            challengeIndex: signature.challengeIndex,\n            typeIndex: signature.typeIndex,\n            r: signature.r,\n            s: signature.s,\n        };\n\n        const messageFee = await this.getMessageFee();\n\n        const tx = await hubWithSigner.addBackupKey(\n            authTuple,\n            publicKeyX,\n            publicKeyY,\n            newPublicKeyX,\n            newPublicKeyY,\n            nonce,\n            { value: messageFee }\n        );\n\n        const receipt = await tx.wait();\n\n        // Extract sequence from Dispatch event\n        let sequence = 0n;\n        for (const log of receipt.logs) {\n            try {\n                const parsed = this.hubContract.interface.parseLog({\n                    topics: log.topics as string[],\n                    data: log.data,\n                });\n                if (parsed?.name === 'Dispatched') {\n                    sequence = BigInt(parsed.args[3]); // sequence is 4th arg\n                    break;\n                }\n            } catch {\n                // Not a Hub event, skip\n            }\n        }\n\n        return { receipt, sequence };\n    }\n\n    /**\n     * Remove a passkey from an identity\n     * Cannot remove the last remaining key\n     * \n     * @param signature WebAuthn signature from an authorized key\n     * @param publicKeyX Signing key's X coordinate\n     * @param publicKeyY Signing key's Y coordinate\n     * @param keyToRemove Hash of the key to remove\n     * @param nonce Current nonce for the signing key\n     * @param signer Ethereum signer to pay gas\n     * @returns Transaction receipt and sequence number\n     */\n    async removeKey(\n        signature: WebAuthnSignature,\n        publicKeyX: bigint,\n        publicKeyY: bigint,\n        keyToRemove: string,\n        nonce: bigint,\n        signer: ethers.Signer\n    ): Promise<{ receipt: ethers.TransactionReceipt; sequence: bigint }> {\n        const hubWithSigner = this.hubContract.connect(signer) as any;\n\n        const authTuple = {\n            authenticatorData: signature.authenticatorData,\n            clientDataJSON: signature.clientDataJSON,\n            challengeIndex: signature.challengeIndex,\n            typeIndex: signature.typeIndex,\n            r: signature.r,\n            s: signature.s,\n        };\n\n        const messageFee = await this.getMessageFee();\n\n        const tx = await hubWithSigner.removeKey(\n            authTuple,\n            publicKeyX,\n            publicKeyY,\n            keyToRemove,\n            nonce,\n            { value: messageFee }\n        );\n\n        const receipt = await tx.wait();\n\n        // Extract sequence from Dispatch event\n        let sequence = 0n;\n        for (const log of receipt.logs) {\n            try {\n                const parsed = this.hubContract.interface.parseLog({\n                    topics: log.topics as string[],\n                    data: log.data,\n                });\n                if (parsed?.name === 'Dispatched') {\n                    sequence = BigInt(parsed.args[3]);\n                    break;\n                }\n            } catch {\n                // Not a Hub event, skip\n            }\n        }\n\n        return { receipt, sequence };\n    }\n\n    // =========================================================================\n    //                      SOCIAL RECOVERY METHODS (Issue #23)\n    // =========================================================================\n\n    /**\n     * Setup guardians for an identity\n     * @param signature WebAuthn signature from owner\n     * @param publicKeyX Owner's public key X coordinate\n     * @param publicKeyY Owner's public key Y coordinate\n     * @param guardians Array of guardian key hashes\n     * @param threshold Required approvals for recovery\n     * @param signer Ethers signer for transaction\n     */\n    async setupGuardians(\n        signature: WebAuthnSignature,\n        publicKeyX: bigint,\n        publicKeyY: bigint,\n        guardians: string[],\n        threshold: bigint,\n        signer: ethers.Signer\n    ): Promise<{ receipt: ethers.TransactionReceipt; sequence: bigint }> {\n        const hubWithSigner = this.hubContract.connect(signer) as any;\n\n        const authTuple = {\n            authenticatorData: signature.authenticatorData,\n            clientDataJSON: signature.clientDataJSON,\n            challengeIndex: signature.challengeIndex,\n            typeIndex: signature.typeIndex,\n            r: signature.r,\n            s: signature.s,\n        };\n\n        const messageFee = await this.getMessageFee();\n\n        const tx = await hubWithSigner.setupGuardians(\n            authTuple,\n            publicKeyX,\n            publicKeyY,\n            guardians,\n            threshold,\n            { value: messageFee }\n        );\n\n        const receipt = await tx.wait();\n        const sequence = this._extractSequenceFromReceipt(receipt);\n\n        return { receipt, sequence };\n    }\n\n    /**\n     * Add a guardian to an identity\n     */\n    async addGuardian(\n        signature: WebAuthnSignature,\n        publicKeyX: bigint,\n        publicKeyY: bigint,\n        guardianKeyHash: string,\n        signer: ethers.Signer\n    ): Promise<{ receipt: ethers.TransactionReceipt; sequence: bigint }> {\n        const hubWithSigner = this.hubContract.connect(signer) as any;\n\n        const authTuple = {\n            authenticatorData: signature.authenticatorData,\n            clientDataJSON: signature.clientDataJSON,\n            challengeIndex: signature.challengeIndex,\n            typeIndex: signature.typeIndex,\n            r: signature.r,\n            s: signature.s,\n        };\n\n        const messageFee = await this.getMessageFee();\n\n        const tx = await hubWithSigner.addGuardian(\n            authTuple,\n            publicKeyX,\n            publicKeyY,\n            guardianKeyHash,\n            { value: messageFee }\n        );\n\n        const receipt = await tx.wait();\n        const sequence = this._extractSequenceFromReceipt(receipt);\n\n        return { receipt, sequence };\n    }\n\n    /**\n     * Remove a guardian from an identity\n     */\n    async removeGuardian(\n        signature: WebAuthnSignature,\n        publicKeyX: bigint,\n        publicKeyY: bigint,\n        guardianKeyHash: string,\n        signer: ethers.Signer\n    ): Promise<{ receipt: ethers.TransactionReceipt; sequence: bigint }> {\n        const hubWithSigner = this.hubContract.connect(signer) as any;\n\n        const authTuple = {\n            authenticatorData: signature.authenticatorData,\n            clientDataJSON: signature.clientDataJSON,\n            challengeIndex: signature.challengeIndex,\n            typeIndex: signature.typeIndex,\n            r: signature.r,\n            s: signature.s,\n        };\n\n        const messageFee = await this.getMessageFee();\n\n        const tx = await hubWithSigner.removeGuardian(\n            authTuple,\n            publicKeyX,\n            publicKeyY,\n            guardianKeyHash,\n            { value: messageFee }\n        );\n\n        const receipt = await tx.wait();\n        const sequence = this._extractSequenceFromReceipt(receipt);\n\n        return { receipt, sequence };\n    }\n\n    /**\n     * Initiate recovery as a guardian\n     */\n    async initiateRecovery(\n        signature: WebAuthnSignature,\n        publicKeyX: bigint,\n        publicKeyY: bigint,\n        identityToRecover: string,\n        newOwnerKeyHash: string,\n        signer: ethers.Signer\n    ): Promise<{ receipt: ethers.TransactionReceipt; sequence: bigint }> {\n        const hubWithSigner = this.hubContract.connect(signer) as any;\n\n        const authTuple = {\n            authenticatorData: signature.authenticatorData,\n            clientDataJSON: signature.clientDataJSON,\n            challengeIndex: signature.challengeIndex,\n            typeIndex: signature.typeIndex,\n            r: signature.r,\n            s: signature.s,\n        };\n\n        const messageFee = await this.getMessageFee();\n\n        const tx = await hubWithSigner.initiateRecovery(\n            authTuple,\n            publicKeyX,\n            publicKeyY,\n            identityToRecover,\n            newOwnerKeyHash,\n            { value: messageFee }\n        );\n\n        const receipt = await tx.wait();\n        const sequence = this._extractSequenceFromReceipt(receipt);\n\n        return { receipt, sequence };\n    }\n\n    /**\n     * Approve recovery as a guardian\n     */\n    async approveRecovery(\n        signature: WebAuthnSignature,\n        publicKeyX: bigint,\n        publicKeyY: bigint,\n        identityToRecover: string,\n        signer: ethers.Signer\n    ): Promise<{ receipt: ethers.TransactionReceipt; sequence: bigint }> {\n        const hubWithSigner = this.hubContract.connect(signer) as any;\n\n        const authTuple = {\n            authenticatorData: signature.authenticatorData,\n            clientDataJSON: signature.clientDataJSON,\n            challengeIndex: signature.challengeIndex,\n            typeIndex: signature.typeIndex,\n            r: signature.r,\n            s: signature.s,\n        };\n\n        const messageFee = await this.getMessageFee();\n\n        const tx = await hubWithSigner.approveRecovery(\n            authTuple,\n            publicKeyX,\n            publicKeyY,\n            identityToRecover,\n            { value: messageFee }\n        );\n\n        const receipt = await tx.wait();\n        const sequence = this._extractSequenceFromReceipt(receipt);\n\n        return { receipt, sequence };\n    }\n\n    /**\n     * Execute recovery after timelock (anyone can call)\n     */\n    async executeRecovery(\n        identityToRecover: string,\n        newPublicKeyX: bigint,\n        newPublicKeyY: bigint,\n        signer: ethers.Signer\n    ): Promise<{ receipt: ethers.TransactionReceipt; sequence: bigint }> {\n        const hubWithSigner = this.hubContract.connect(signer) as any;\n\n        const messageFee = await this.getMessageFee();\n\n        const tx = await hubWithSigner.executeRecovery(\n            identityToRecover,\n            newPublicKeyX,\n            newPublicKeyY,\n            { value: messageFee }\n        );\n\n        const receipt = await tx.wait();\n        const sequence = this._extractSequenceFromReceipt(receipt);\n\n        return { receipt, sequence };\n    }\n\n    /**\n     * Cancel recovery as owner\n     */\n    async cancelRecovery(\n        signature: WebAuthnSignature,\n        publicKeyX: bigint,\n        publicKeyY: bigint,\n        signer: ethers.Signer\n    ): Promise<{ receipt: ethers.TransactionReceipt; sequence: bigint }> {\n        const hubWithSigner = this.hubContract.connect(signer) as any;\n\n        const authTuple = {\n            authenticatorData: signature.authenticatorData,\n            clientDataJSON: signature.clientDataJSON,\n            challengeIndex: signature.challengeIndex,\n            typeIndex: signature.typeIndex,\n            r: signature.r,\n            s: signature.s,\n        };\n\n        const messageFee = await this.getMessageFee();\n\n        const tx = await hubWithSigner.cancelRecovery(\n            authTuple,\n            publicKeyX,\n            publicKeyY,\n            { value: messageFee }\n        );\n\n        const receipt = await tx.wait();\n        const sequence = this._extractSequenceFromReceipt(receipt);\n\n        return { receipt, sequence };\n    }\n\n    /**\n     * Get guardians for an identity\n     */\n    async getGuardians(identityKeyHash: string): Promise<{\n        guardians: string[];\n        threshold: bigint;\n        isConfigured: boolean;\n    }> {\n        const result = await this.hubContract.getGuardians(identityKeyHash);\n        return {\n            guardians: result.guardians,\n            threshold: result.threshold,\n            isConfigured: result.isConfigured,\n        };\n    }\n\n    /**\n     * Get recovery status for an identity\n     */\n    async getRecoveryStatus(identityKeyHash: string): Promise<{\n        isActive: boolean;\n        newOwnerKeyHash: string;\n        initiatedAt: bigint;\n        approvalCount: bigint;\n        threshold: bigint;\n        canExecuteAt: bigint;\n        expiresAt: bigint;\n    }> {\n        const result = await this.hubContract.getRecoveryStatus(identityKeyHash);\n        return {\n            isActive: result.isActive,\n            newOwnerKeyHash: result.newOwnerKeyHash,\n            initiatedAt: result.initiatedAt,\n            approvalCount: result.approvalCount,\n            threshold: result.threshold,\n            canExecuteAt: result.canExecuteAt,\n            expiresAt: result.expiresAt,\n        };\n    }\n\n    /**\n     * Check if a guardian has approved recovery\n     */\n    async hasGuardianApproved(\n        identityKeyHash: string,\n        guardianKeyHash: string\n    ): Promise<boolean> {\n        return this.hubContract.hasGuardianApproved(identityKeyHash, guardianKeyHash);\n    }\n\n    /**\n     * Helper to extract sequence from transaction receipt\n     */\n    private _extractSequenceFromReceipt(receipt: ethers.TransactionReceipt): bigint {\n        for (const log of receipt.logs) {\n            try {\n                const parsed = this.hubContract.interface.parseLog({\n                    topics: log.topics as string[],\n                    data: log.data,\n                });\n                if (parsed?.name === 'Dispatch') {\n                    return BigInt(parsed.args.sequence);\n                }\n            } catch {\n                // Not a Hub event, skip\n            }\n        }\n        return 0n;\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","/**\n * Veridex Protocol SDK - EVM Hub Client Adapter\n * \n * Adapts EVMClient to work with SessionManager's HubClient interface.\n * Provides a clean integration layer between session management and chain clients.\n */\n\nimport type { HubClient } from '../../sessions/index.js';\nimport type { RegisterSessionParams, RevokeSessionParams } from '../../types.js';\nimport type { EVMClient } from './EVMClient.js';\nimport type { ethers } from 'ethers';\n\n/**\n * Adapter that makes EVMClient compatible with SessionManager's HubClient interface\n * \n * Usage:\n * ```typescript\n * const hubAdapter = new EVMHubClientAdapter(evmClient, signer);\n * const sessionManager = new SessionManager(\n *   credential,\n *   hubAdapter,\n *   config\n * );\n * ```\n */\nexport class EVMHubClientAdapter implements HubClient {\n    constructor(\n        private evmClient: EVMClient,\n        private signer: ethers.Signer\n    ) {}\n    \n    /**\n     * Register a session on the Hub\n     * \n     * @param params Registration parameters with Passkey signature\n     * @returns Promise that resolves when registration completes\n     */\n    async registerSession(params: RegisterSessionParams): Promise<void> {\n        // Call EVMClient's registerSession method\n        await this.evmClient.registerSession(params, this.signer);\n    }\n    \n    /**\n     * Revoke a session on the Hub\n     * \n     * @param params Revocation parameters with Passkey signature\n     * @returns Promise that resolves when revocation completes\n     */\n    async revokeSession(params: RevokeSessionParams): Promise<void> {\n        // Call EVMClient's revokeSession method\n        await this.evmClient.revokeSession(params, this.signer);\n    }\n    \n    /**\n     * Update the signer (e.g., when switching accounts)\n     * \n     * @param signer New Ethereum signer\n     */\n    updateSigner(signer: ethers.Signer): void {\n        this.signer = signer;\n    }\n}\n"],"mappings":"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","names":["ethers","hex","ethers","address"]}

package/dist/chains/solana/index.d.mts

@@ -0,0 +1,116 @@
+import * as _solana_web3_js from '@solana/web3.js';
+import { Connection, PublicKey } from '@solana/web3.js';
+import { C as ChainClient, a as ChainConfig, T as TransferParams, E as ExecuteParams, B as BridgeParams, W as WebAuthnSignature, D as DispatchResult, V as VaultCreationResult } from '../../types-ChIsqCiw.mjs';
+
+interface SolanaClientConfig {
+    wormholeChainId: number;
+    rpcUrl: string;
+    programId: string;
+    wormholeCoreBridge: string;
+    tokenBridge: string;
+    network?: 'mainnet' | 'devnet' | 'testnet';
+    commitment?: 'processed' | 'confirmed' | 'finalized';
+}
+/**
+ * Solana implementation of the ChainClient interface
+ */
+declare class SolanaClient implements ChainClient {
+    private config;
+    private connection;
+    private programId;
+    constructor(config: SolanaClientConfig);
+    getConfig(): ChainConfig;
+    getNonce(userKeyHash: string): Promise<bigint>;
+    getMessageFee(): Promise<bigint>;
+    buildTransferPayload(params: TransferParams): Promise<string>;
+    buildExecutePayload(params: ExecuteParams): Promise<string>;
+    buildBridgePayload(params: BridgeParams): Promise<string>;
+    dispatch(signature: WebAuthnSignature, publicKeyX: bigint, publicKeyY: bigint, targetChain: number, actionPayload: string, nonce: bigint, signer: any): Promise<DispatchResult>;
+    /**
+     * Dispatch an action via relayer (gasless)
+     * Note: On Solana, this still goes through the Hub chain
+     * Solana is a spoke-only chain in Veridex architecture
+     */
+    dispatchGasless(signature: WebAuthnSignature, publicKeyX: bigint, publicKeyY: bigint, targetChain: number, actionPayload: string, nonce: bigint, relayerUrl: string): Promise<DispatchResult>;
+    getVaultAddress(userKeyHash: string): Promise<string | null>;
+    /**
+     * Compute vault address using PDA (Program Derived Address)
+     * Seeds: ["vault", userKeyHash]
+     */
+    computeVaultAddress(userKeyHash: string): string;
+    private computeVaultAddressFromHash;
+    vaultExists(userKeyHash: string): Promise<boolean>;
+    createVault(userKeyHash: string, signer: any): Promise<VaultCreationResult>;
+    createVaultSponsored?(userKeyHash: string, sponsorPrivateKey: string, rpcUrl?: string): Promise<VaultCreationResult>;
+    /**
+     * Create a vault via the relayer (sponsored/gasless)
+     * This is the recommended way to create Solana vaults
+     */
+    createVaultViaRelayer(userKeyHash: string, relayerUrl: string): Promise<VaultCreationResult>;
+    /**
+     * Get vault info via relayer (includes existence check)
+     */
+    getVaultViaRelayer(userKeyHash: string, relayerUrl: string): Promise<{
+        vaultAddress: string;
+        exists: boolean;
+    }>;
+    estimateVaultCreationGas(userKeyHash: string): Promise<bigint>;
+    getFactoryAddress(): string | undefined;
+    getImplementationAddress(): string | undefined;
+    /**
+     * Get native SOL balance
+     */
+    getNativeBalance(address: string): Promise<bigint>;
+    /**
+     * Get SPL token balance
+     */
+    getTokenBalance(tokenAddress: string, ownerAddress: string): Promise<bigint>;
+    /**
+     * Compute key hash from public key coordinates
+     * Matches EVM keccak256(abi.encode(publicKeyX, publicKeyY))
+     */
+    private computeKeyHash;
+    /**
+     * Build message for signing (matches Hub chain format)
+     */
+    private buildMessage;
+    /**
+     * Get connection instance for advanced usage
+     */
+    getConnection(): Connection;
+    /**
+     * Get program ID
+     */
+    getProgramId(): PublicKey;
+    /**
+     * Get current slot
+     */
+    getSlot(): Promise<number>;
+    /**
+     * Get transaction status
+     */
+    getTransaction(signature: string, commitment?: 'confirmed' | 'finalized'): Promise<_solana_web3_js.VersionedTransactionResponse | null>;
+    /**
+     * Check if a recovery VAA has been executed on this spoke
+     *
+     * @param vaaHash - Hash of the recovery VAA
+     * @returns Whether the VAA has been processed
+     */
+    isRecoveryExecuted(vaaHash: string): Promise<boolean>;
+    /**
+     * Get vault owner after potential recovery
+     *
+     * @param vaultAddress - Vault address to check
+     * @returns Current owner key hash
+     */
+    getVaultOwner(vaultAddress: string): Promise<string>;
+    /**
+     * Get authorized signers for a vault
+     *
+     * @param vaultAddress - Vault address to check
+     * @returns Array of authorized signer key hashes
+     */
+    getAuthorizedSigners(vaultAddress: string): Promise<string[]>;
+}
+
+export { SolanaClient, type SolanaClientConfig };

package/dist/chains/solana/index.d.ts

@@ -0,0 +1,116 @@
+import * as _solana_web3_js from '@solana/web3.js';
+import { Connection, PublicKey } from '@solana/web3.js';
+import { C as ChainClient, a as ChainConfig, T as TransferParams, E as ExecuteParams, B as BridgeParams, W as WebAuthnSignature, D as DispatchResult, V as VaultCreationResult } from '../../types-ChIsqCiw.js';
+
+interface SolanaClientConfig {
+    wormholeChainId: number;
+    rpcUrl: string;
+    programId: string;
+    wormholeCoreBridge: string;
+    tokenBridge: string;
+    network?: 'mainnet' | 'devnet' | 'testnet';
+    commitment?: 'processed' | 'confirmed' | 'finalized';
+}
+/**
+ * Solana implementation of the ChainClient interface
+ */
+declare class SolanaClient implements ChainClient {
+    private config;
+    private connection;
+    private programId;
+    constructor(config: SolanaClientConfig);
+    getConfig(): ChainConfig;
+    getNonce(userKeyHash: string): Promise<bigint>;
+    getMessageFee(): Promise<bigint>;
+    buildTransferPayload(params: TransferParams): Promise<string>;
+    buildExecutePayload(params: ExecuteParams): Promise<string>;
+    buildBridgePayload(params: BridgeParams): Promise<string>;
+    dispatch(signature: WebAuthnSignature, publicKeyX: bigint, publicKeyY: bigint, targetChain: number, actionPayload: string, nonce: bigint, signer: any): Promise<DispatchResult>;
+    /**
+     * Dispatch an action via relayer (gasless)
+     * Note: On Solana, this still goes through the Hub chain
+     * Solana is a spoke-only chain in Veridex architecture
+     */
+    dispatchGasless(signature: WebAuthnSignature, publicKeyX: bigint, publicKeyY: bigint, targetChain: number, actionPayload: string, nonce: bigint, relayerUrl: string): Promise<DispatchResult>;
+    getVaultAddress(userKeyHash: string): Promise<string | null>;
+    /**
+     * Compute vault address using PDA (Program Derived Address)
+     * Seeds: ["vault", userKeyHash]
+     */
+    computeVaultAddress(userKeyHash: string): string;
+    private computeVaultAddressFromHash;
+    vaultExists(userKeyHash: string): Promise<boolean>;
+    createVault(userKeyHash: string, signer: any): Promise<VaultCreationResult>;
+    createVaultSponsored?(userKeyHash: string, sponsorPrivateKey: string, rpcUrl?: string): Promise<VaultCreationResult>;
+    /**
+     * Create a vault via the relayer (sponsored/gasless)
+     * This is the recommended way to create Solana vaults
+     */
+    createVaultViaRelayer(userKeyHash: string, relayerUrl: string): Promise<VaultCreationResult>;
+    /**
+     * Get vault info via relayer (includes existence check)
+     */
+    getVaultViaRelayer(userKeyHash: string, relayerUrl: string): Promise<{
+        vaultAddress: string;
+        exists: boolean;
+    }>;
+    estimateVaultCreationGas(userKeyHash: string): Promise<bigint>;
+    getFactoryAddress(): string | undefined;
+    getImplementationAddress(): string | undefined;
+    /**
+     * Get native SOL balance
+     */
+    getNativeBalance(address: string): Promise<bigint>;
+    /**
+     * Get SPL token balance
+     */
+    getTokenBalance(tokenAddress: string, ownerAddress: string): Promise<bigint>;
+    /**
+     * Compute key hash from public key coordinates
+     * Matches EVM keccak256(abi.encode(publicKeyX, publicKeyY))
+     */
+    private computeKeyHash;
+    /**
+     * Build message for signing (matches Hub chain format)
+     */
+    private buildMessage;
+    /**
+     * Get connection instance for advanced usage
+     */
+    getConnection(): Connection;
+    /**
+     * Get program ID
+     */
+    getProgramId(): PublicKey;
+    /**
+     * Get current slot
+     */
+    getSlot(): Promise<number>;
+    /**
+     * Get transaction status
+     */
+    getTransaction(signature: string, commitment?: 'confirmed' | 'finalized'): Promise<_solana_web3_js.VersionedTransactionResponse | null>;
+    /**
+     * Check if a recovery VAA has been executed on this spoke
+     *
+     * @param vaaHash - Hash of the recovery VAA
+     * @returns Whether the VAA has been processed
+     */
+    isRecoveryExecuted(vaaHash: string): Promise<boolean>;
+    /**
+     * Get vault owner after potential recovery
+     *
+     * @param vaultAddress - Vault address to check
+     * @returns Current owner key hash
+     */
+    getVaultOwner(vaultAddress: string): Promise<string>;
+    /**
+     * Get authorized signers for a vault
+     *
+     * @param vaultAddress - Vault address to check
+     * @returns Array of authorized signer key hashes
+     */
+    getAuthorizedSigners(vaultAddress: string): Promise<string[]>;
+}
+
+export { SolanaClient, type SolanaClientConfig };