@veridex/sdk 1.0.0-beta.9 → 1.0.1

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

@@ -1,172 +0,0 @@
-import { S as SessionKey } from '../../types-FJL7j6gQ.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, R as RegisterSessionParams, b as RevokeSessionParams, S as SessionValidationResult } from '../../types-ChIsqCiw.js';
-import { RpcProvider } from 'starknet';
-
-/**
- * Veridex Protocol SDK - Starknet Chain Client
- *
- * Production-grade implementation of ChainClient interface for Starknet.
- * Supports custom bridge attestation, gasless execution via Hub dispatch.
- *
- * Security:
- * - Native starknet::eth_signature::verify_eth_signature for validation
- * - Custom bridge with multi-relayer threshold attestations
- * - Replay protection via nonce verification on Hub
- * - Bridge validates source_chain == hub_chain_id (10004 = Base Sepolia)
- *
- * Architecture:
- * - Starknet actions MUST be dispatched via Hub (Base Sepolia)
- * - Hub publishes Wormhole message → relayer monitors → relayer submits attestation
- * - Bridge accumulates attestations → threshold reached → spoke executes
- * - Spoke validates source_chain == hubChainId (NOT targetChain)
- *
- * Custom Bridge:
- * - Bridge address: 0x2c458c1ae64556482b05cc2d3ee5b032ed114d68429dda2062c9849a5a725f8
- * - Chain ID: 50001 (custom range 50000+, reserved for non-Wormhole chains)
- * - Hub Chain ID: 10004 (Base Sepolia - what bridge validates as source)
- */
-
-interface StarknetClientConfig {
-    wormholeChainId: number;
-    rpcUrl: string;
-    spokeContractAddress?: string;
-    bridgeContractAddress?: string;
-    network?: 'mainnet' | 'sepolia' | 'testnet';
-    hubRpcUrl?: string;
-    hubContractAddress?: string;
-}
-declare class StarknetClient implements ChainClient {
-    private config;
-    private provider;
-    private hubRpcUrl?;
-    private hubContractAddress?;
-    constructor(config: StarknetClientConfig);
-    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>;
-    dispatchGasless(signature: WebAuthnSignature, publicKeyX: bigint, publicKeyY: bigint, targetChain: number, actionPayload: string, nonce: bigint, relayerUrl: string): Promise<DispatchResult>;
-    computeVaultAddress(userKeyHash: string): string;
-    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 Starknet vaults
-     *
-     * The relayer will dispatch a vault creation action from Hub via custom bridge to Starknet spoke
-     */
-    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;
-    getNativeBalance(address: string): Promise<bigint>;
-    getProvider(): RpcProvider;
-    /**
-     * Register a session key on the Hub (must be called via Hub client)
-     * Starknet spokes validate sessions via CCQ, but registration happens on Hub
-     *
-     * @throws Error - Session management must be done via Hub chain
-     */
-    registerSession(_params: RegisterSessionParams): Promise<void>;
-    /**
-     * Revoke a session key on the Hub (must be called via Hub client)
-     *
-     * @throws Error - Session management must be done via Hub chain
-     */
-    revokeSession(_params: RevokeSessionParams): Promise<void>;
-    /**
-     * Check if a session is active by querying the Hub
-     * This method queries the Hub contract directly for session validation
-     *
-     * @param userKeyHash - Hash of user's Passkey public key
-     * @param sessionKeyHash - Hash of session key to validate
-     * @returns Session validation result with expiry and limits
-     */
-    isSessionActive(userKeyHash: string, sessionKeyHash: string): Promise<SessionValidationResult>;
-    /**
-     * Get all sessions for a user from the Hub
-     *
-     * @param userKeyHash - Hash of user's Passkey public key
-     * @returns Array of all sessions (active and expired/revoked)
-     */
-    getUserSessions(userKeyHash: string): Promise<SessionKey[]>;
-    /**
-     * Get user state from Hub (comprehensive state query)
-     * Returns key hash, nonce, and last action hash for CCQ validation
-     *
-     * @param userKeyHash - Hash of user's Passkey public key
-     * @returns User state with nonce and last action hash
-     */
-    getUserState(userKeyHash: string): Promise<{
-        keyHash: string;
-        nonce: bigint;
-        lastActionHash: string;
-    }>;
-    /**
-     * Get user's last action hash from Hub
-     * Used for optimistic execution and nonce validation
-     *
-     * @param userKeyHash - Hash of user's Passkey public key
-     * @returns Last action hash (zero hash if no actions)
-     */
-    getUserLastActionHash(userKeyHash: string): Promise<string>;
-    /**
-     * Execute with query-based validation (faster than VAA, ~23s vs 60-90s)
-     * Uses Wormhole CCQ to validate Hub state, then executes on Starknet
-     *
-     * @param params Query execution parameters with CCQ response
-     * @returns Dispatch result with transaction hash
-     *
-     * @remarks
-     * Query-based execution flow:
-     * 1. Query Hub state via Wormhole CCQ
-     * 2. Validate Guardian signatures on query response
-     * 3. Execute on Starknet with validated state
-     * 4. Hub state must be < 60s stale (enforced by QueryVerifier)
-     */
-    executeWithQuery(_params: {
-        userKeyHash: string;
-        queryResponse: Uint8Array;
-        actionType: number;
-        actionPayload: Uint8Array;
-        relayerUrl?: string;
-    }): Promise<DispatchResult>;
-    private computeKeyHash;
-    private buildMessageHash;
-    /**
-     * Get vault address by owner key hash
-     *
-     * @param ownerKeyHash - Owner's passkey hash
-     * @returns Vault address on Starknet (felt252 as hex string)
-     */
-    getVaultAddress(ownerKeyHash: string): Promise<string | null>;
-    /**
-     * Check if vault exists and get basic info
-     *
-     * @param ownerKeyHash - Owner's passkey hash
-     * @returns Vault info or null if not found
-     */
-    getVaultInfo(ownerKeyHash: string): Promise<{
-        address: string;
-        ownerKeyHash: string;
-    } | null>;
-    /**
-     * Check if spoke contract is paused
-     *
-     * @returns Whether the protocol is paused
-     */
-    isProtocolPaused(): Promise<boolean>;
-}
-
-export { StarknetClient, type StarknetClientConfig };

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

@@ -1,182 +0,0 @@
-import { SuiClient as SuiClient$1 } from '@mysten/sui/client';
-import { S as SessionKey } from '../../types-FJL7j6gQ.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, R as RegisterSessionParams, b as RevokeSessionParams, S as SessionValidationResult } from '../../types-ChIsqCiw.js';
-
-/**
- * Veridex Protocol SDK - Sui Chain Client
- *
- * Production-grade implementation of ChainClient interface for Sui.
- * Supports session management, query-based execution, and vault operations.
- *
- * Security:
- * - Native sui::ecdsa_k1::secp256k1_verify for signature validation
- * - CCQ-based session validation with 60s staleness window
- * - Replay protection via nonce verification
- *
- * Note: Sui is a spoke chain. Session registration/revocation happens on Hub.
- */
-
-interface SuiClientConfig {
-    wormholeChainId: number;
-    rpcUrl: string;
-    packageId: string;
-    wormholeCoreBridge: string;
-    tokenBridge?: string;
-    network?: 'mainnet' | 'testnet' | 'devnet';
-    hubRpcUrl?: string;
-    hubContractAddress?: string;
-}
-declare class SuiClient implements ChainClient {
-    private config;
-    private client;
-    private packageId;
-    private hubRpcUrl?;
-    private hubContractAddress?;
-    constructor(config: SuiClientConfig);
-    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>;
-    dispatchGasless(signature: WebAuthnSignature, publicKeyX: bigint, publicKeyY: bigint, targetChain: number, actionPayload: string, nonce: bigint, relayerUrl: string): Promise<DispatchResult>;
-    getVaultAddress(userKeyHash: string): Promise<string | null>;
-    computeVaultAddress(userKeyHash: string): string;
-    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 Sui vaults
-     *
-     * The relayer will dispatch a vault creation action from Hub to Sui spoke
-     */
-    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;
-    getNativeBalance(address: string): Promise<bigint>;
-    getTokenBalance(coinType: string, ownerAddress: string): Promise<bigint>;
-    getClient(): SuiClient$1;
-    getPackageId(): string;
-    /**
-     * Register a session key on the Hub (must be called via Hub client)
-     * Sui spokes validate sessions via CCQ, but registration happens on Hub
-     *
-     * @throws Error - Session management must be done via Hub chain
-     */
-    registerSession(_params: RegisterSessionParams): Promise<void>;
-    /**
-     * Revoke a session key on the Hub (must be called via Hub client)
-     *
-     * @throws Error - Session management must be done via Hub chain
-     */
-    revokeSession(_params: RevokeSessionParams): Promise<void>;
-    /**
-     * Check if a session is active by querying the Hub
-     * This method queries the Hub contract directly for session validation
-     *
-     * @param userKeyHash - Hash of user's Passkey public key
-     * @param sessionKeyHash - Hash of session key to validate
-     * @returns Session validation result with expiry and limits
-     */
-    isSessionActive(_userKeyHash: string, _sessionKeyHash: string): Promise<SessionValidationResult>;
-    /**
-     * Get all sessions for a user from the Hub
-     *
-     * @param userKeyHash - Hash of user's Passkey public key
-     * @returns Array of all sessions (active and expired/revoked)
-     */
-    getUserSessions(userKeyHash: string): Promise<SessionKey[]>;
-    /**
-     * Get user state from Hub (comprehensive state query)
-     * Returns key hash, nonce, and last action hash for CCQ validation
-     *
-     * @param userKeyHash - Hash of user's Passkey public key
-     * @returns User state with nonce and last action hash
-     */
-    getUserState(userKeyHash: string): Promise<{
-        keyHash: string;
-        nonce: bigint;
-        lastActionHash: string;
-    }>;
-    /**
-     * Get user's last action hash from Hub
-     * Used for optimistic execution and nonce validation
-     *
-     * @param userKeyHash - Hash of user's Passkey public key
-     * @returns Last action hash (zero hash if no actions)
-     */
-    getUserLastActionHash(userKeyHash: string): Promise<string>;
-    /**
-     * Execute with query-based validation (faster than VAA, ~23s vs 60-90s)
-     * Uses Wormhole CCQ to validate Hub state, then executes on Sui
-     *
-     * @param params Query execution parameters with CCQ response
-     * @returns Dispatch result with transaction hash
-     *
-     * @remarks
-     * Query-based execution flow:
-     * 1. Query Hub state via Wormhole CCQ
-     * 2. Validate Guardian signatures on query response
-     * 3. Execute on Sui with validated state
-     * 4. Hub state must be < 60s stale (enforced by QueryVerifier)
-     */
-    executeWithQuery(_params: {
-        userKeyHash: string;
-        queryResponse: Uint8Array;
-        actionType: number;
-        actionPayload: Uint8Array;
-        relayerUrl?: string;
-    }): Promise<DispatchResult>;
-    private computeKeyHash;
-    private buildMessageHash;
-    /**
-     * Get vault object ID by owner key hash
-     *
-     * @param ownerKeyHash - Owner's passkey hash (32 bytes as hex)
-     * @param configObjectId - Shared Config object ID
-     * @param registryObjectId - Shared VaultRegistry object ID
-     * @returns Vault object ID or null if not found
-     */
-    getVaultId(ownerKeyHash: string, registryObjectId: string): Promise<string | null>;
-    /**
-     * Get vault owner key hash from vault object
-     *
-     * @param vaultObjectId - Vault object ID
-     * @returns Owner key hash as hex string
-     */
-    getVaultOwner(vaultObjectId: string): Promise<string | null>;
-    /**
-     * Get authorized signers for a vault
-     *
-     * @param vaultObjectId - Vault object ID
-     * @returns Array of authorized signer key hashes
-     */
-    getAuthorizedSigners(vaultObjectId: string): Promise<string[]>;
-    /**
-     * Check if a VAA has been processed (for replay protection)
-     *
-     * @param vaaHash - VAA hash as hex string
-     * @param processedVaasObjectId - ProcessedVAAs shared object ID
-     * @returns Whether the VAA has been processed
-     */
-    isVaaProcessed(vaaHash: string, processedVaasObjectId: string): Promise<boolean>;
-    /**
-     * Check if protocol is paused
-     *
-     * @param configObjectId - Config shared object ID
-     * @returns Whether the protocol is paused
-     */
-    isProtocolPaused(configObjectId: string): Promise<boolean>;
-}
-
-export { SuiClient, type SuiClientConfig };

package/dist/constants.d.ts

@@ -1,150 +0,0 @@
-import { ChainConfig } from './types.js';
-
-/**
- * Veridex Protocol SDK - Constants and Chain Configurations
- */
-
-declare const ACTION_TYPES: {
-    readonly TRANSFER: 1;
-    readonly EXECUTE: 2;
-    readonly CONFIG: 3;
-    readonly BRIDGE: 4;
-};
-declare const ACTION_TRANSFER = 1;
-declare const ACTION_EXECUTE = 2;
-declare const ACTION_CONFIG = 3;
-declare const ACTION_BRIDGE = 4;
-declare const PROTOCOL_VERSION = 1;
-/**
- * Wormhole Chain IDs organized by network
- * @see https://docs.wormhole.com/wormhole/reference/constants
- */
-declare const WORMHOLE_CHAIN_IDS: {
-    readonly MAINNET: {
-        readonly SOLANA: 1;
-        readonly ETHEREUM: 2;
-        readonly TERRA: 3;
-        readonly BSC: 4;
-        readonly POLYGON: 5;
-        readonly AVALANCHE: 6;
-        readonly OASIS: 7;
-        readonly ALGORAND: 8;
-        readonly AURORA: 9;
-        readonly FANTOM: 10;
-        readonly KARURA: 11;
-        readonly ACALA: 12;
-        readonly KLAYTN: 13;
-        readonly CELO: 14;
-        readonly NEAR: 15;
-        readonly MOONBEAM: 16;
-        readonly NEON: 17;
-        readonly TERRA2: 18;
-        readonly INJECTIVE: 19;
-        readonly OSMOSIS: 20;
-        readonly SUI: 21;
-        readonly APTOS: 22;
-        readonly ARBITRUM: 23;
-        readonly OPTIMISM: 24;
-        readonly GNOSIS: 25;
-        readonly PYTHNET: 26;
-        readonly XPLA: 28;
-        readonly BASE: 30;
-        readonly SEI: 32;
-        readonly ROOTSTOCK: 33;
-        readonly SCROLL: 34;
-        readonly MANTLE: 35;
-        readonly BLAST: 36;
-        readonly XLAYER: 37;
-        readonly LINEA: 38;
-        readonly BERACHAIN: 39;
-        readonly SEIEVM: 40;
-    };
-    readonly TESTNET: {
-        readonly SOLANA_DEVNET: 1;
-        readonly GOERLI: 2;
-        readonly BSC_TESTNET: 4;
-        readonly POLYGON_MUMBAI: 5;
-        readonly AVALANCHE_FUJI: 6;
-        readonly FANTOM_TESTNET: 10;
-        readonly CELO_ALFAJORES: 14;
-        readonly MOONBASE_ALPHA: 16;
-        readonly SUI_TESTNET: 21;
-        readonly APTOS_TESTNET: 22;
-        readonly SEPOLIA: 10002;
-        readonly ARBITRUM_SEPOLIA: 10003;
-        readonly BASE_SEPOLIA: 10004;
-        readonly OPTIMISM_SEPOLIA: 10005;
-        readonly HOLESKY: 10006;
-        readonly POLYGON_SEPOLIA: 10007;
-        readonly SEI_ATLANTIC_2: 10066;
-        readonly STARKNET_SEPOLIA: 50001;
-    };
-};
-declare const WORMHOLE_CHAIN_IDS_FLAT: {
-    readonly SOLANA: 1;
-    readonly ETHEREUM: 2;
-    readonly TERRA: 3;
-    readonly BSC: 4;
-    readonly POLYGON: 5;
-    readonly AVALANCHE: 6;
-    readonly OASIS: 7;
-    readonly ALGORAND: 8;
-    readonly AURORA: 9;
-    readonly FANTOM: 10;
-    readonly KARURA: 11;
-    readonly ACALA: 12;
-    readonly KLAYTN: 13;
-    readonly CELO: 14;
-    readonly NEAR: 15;
-    readonly MOONBEAM: 16;
-    readonly NEON: 17;
-    readonly TERRA2: 18;
-    readonly INJECTIVE: 19;
-    readonly OSMOSIS: 20;
-    readonly SUI: 21;
-    readonly APTOS: 22;
-    readonly ARBITRUM: 23;
-    readonly OPTIMISM: 24;
-    readonly GNOSIS: 25;
-    readonly PYTHNET: 26;
-    readonly XPLA: 28;
-    readonly BASE: 30;
-    readonly SEI: 32;
-    readonly ROOTSTOCK: 33;
-    readonly SCROLL: 34;
-    readonly MANTLE: 35;
-    readonly BLAST: 36;
-    readonly XLAYER: 37;
-    readonly LINEA: 38;
-    readonly BERACHAIN: 39;
-    readonly SEIEVM: 40;
-    readonly SOLANA_DEVNET: 1;
-    readonly GOERLI: 2;
-    readonly BSC_TESTNET: 4;
-    readonly POLYGON_MUMBAI: 5;
-    readonly AVALANCHE_FUJI: 6;
-    readonly FANTOM_TESTNET: 10;
-    readonly CELO_ALFAJORES: 14;
-    readonly MOONBASE_ALPHA: 16;
-    readonly SUI_TESTNET: 21;
-    readonly APTOS_TESTNET: 22;
-    readonly ARBITRUM_SEPOLIA: 10003;
-    readonly BASE_SEPOLIA: 10004;
-    readonly OPTIMISM_SEPOLIA: 10005;
-    readonly POLYGON_SEPOLIA: 10007;
-    readonly HOLESKY: 10006;
-    readonly STARKNET_SEPOLIA: 50001;
-};
-declare const TESTNET_CHAINS: Record<string, ChainConfig>;
-declare const MAINNET_CHAINS: Record<string, ChainConfig>;
-declare const WORMHOLE_API: {
-    readonly MAINNET: "https://api.wormholescan.io";
-    readonly TESTNET: "https://api.testnet.wormholescan.io";
-    readonly GUARDIAN_RPC_MAINNET: "https://wormhole-v2-mainnet-api.certus.one";
-    readonly GUARDIAN_RPC_TESTNET: "https://wormhole-v2-testnet-api.certus.one";
-};
-declare const HUB_ABI: readonly ["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)", "function authenticateRawAndDispatch(uint256 r, uint256 s, bytes32 messageHash, uint256 publicKeyX, uint256 publicKeyY, uint16 targetChain, bytes actionPayload, uint256 nonce) external payable returns (uint64 sequence)", "function getNonce(bytes32 userKeyHash) external view returns (uint256)", "function encodeTransferAction(address token, address recipient, uint256 amount) external pure returns (bytes)", "function encodeExecuteAction(address target, uint256 value, bytes data) external pure returns (bytes)", "function encodeBridgeAction(bytes32 token, uint256 amount, uint16 targetChain, bytes32 recipient) external pure returns (bytes)", "function messageFee() external view returns (uint256)", "event Dispatched(bytes32 indexed userKeyHash, uint16 targetChain, uint256 nonce, uint64 sequence, bytes actionPayload)"];
-declare const VAULT_FACTORY_ABI: readonly ["function createVault(bytes32 userKeyHash) external returns (address)", "function getVault(bytes32 userKeyHash) external view returns (address)", "function vaultExists(bytes32 userKeyHash) external view returns (bool)", "event VaultCreated(bytes32 indexed userKeyHash, address vault)"];
-declare const VAULT_ABI: readonly ["function execute(address target, uint256 value, bytes data) external returns (bytes)", "function executeFromHub(bytes32 vaaHash, uint16 emitterChain, bytes32 emitterAddress, bytes payload) external", "function owner() external view returns (bytes32)", "function hub() external view returns (address)", "receive() external payable"];
-
-export { ACTION_BRIDGE, ACTION_CONFIG, ACTION_EXECUTE, ACTION_TRANSFER, ACTION_TYPES, HUB_ABI, MAINNET_CHAINS, PROTOCOL_VERSION, TESTNET_CHAINS, VAULT_ABI, VAULT_FACTORY_ABI, WORMHOLE_API, WORMHOLE_CHAIN_IDS, WORMHOLE_CHAIN_IDS_FLAT };