@veridex/sdk 1.0.0-beta.1

package/dist/types.d.ts

@@ -0,0 +1,407 @@
+/**
+ * Veridex Protocol SDK - Type Definitions
+ */
+interface VeridexConfig {
+    hubChainId: number;
+    hubRpcUrl: string;
+    hubContractAddress: string;
+    relayerUrl?: string;
+}
+interface ChainConfig {
+    name: string;
+    chainId: number;
+    wormholeChainId: number;
+    hubChainId?: number;
+    rpcUrl: string;
+    explorerUrl: string;
+    isEvm: boolean;
+    contracts: {
+        hub?: string;
+        vaultFactory?: string;
+        vaultImplementation?: string;
+        wormholeCoreBridge: string;
+        tokenBridge?: string;
+    };
+}
+interface PasskeyCredential {
+    credentialId: string;
+    publicKeyX: bigint;
+    publicKeyY: bigint;
+    keyHash: string;
+}
+interface WebAuthnSignature {
+    authenticatorData: string;
+    clientDataJSON: string;
+    challengeIndex: number;
+    typeIndex: number;
+    r: bigint;
+    s: bigint;
+}
+interface TransferParams {
+    targetChain: number;
+    token: string;
+    recipient: string;
+    amount: bigint;
+}
+interface ExecuteParams {
+    targetChain: number;
+    target: string;
+    value: bigint;
+    data: string;
+}
+interface BridgeParams {
+    sourceChain: number;
+    token: string;
+    amount: bigint;
+    destinationChain: number;
+    recipient: string;
+}
+interface DispatchResult {
+    transactionHash: string;
+    sequence: bigint;
+    userKeyHash: string;
+    targetChain: number;
+}
+interface TransferAction {
+    type: 'transfer';
+    token: string;
+    recipient: string;
+    amount: bigint;
+}
+interface BridgeAction {
+    type: 'bridge';
+    token: string;
+    amount: bigint;
+    targetChain: number;
+    recipient: string;
+}
+/**
+ * Wormhole Query proof for optimistic execution
+ * Allows ~5-7 second latency vs ~120+ seconds for VAA
+ */
+interface QueryProof {
+    /** Raw query response bytes from Wormhole Guardians */
+    queryResponse: string;
+    /** Guardian signatures (13/19 quorum) */
+    signatures: string;
+}
+/**
+ * User preference for execution path
+ */
+type ExecutionPath = 'query' | 'vaa' | 'auto';
+/**
+ * Result from query-based submission
+ */
+interface QuerySubmissionResult {
+    /** Whether submission succeeded */
+    success: boolean;
+    /** Transaction hash on spoke chain */
+    txHash?: string;
+    /** Execution path used ('query' or 'vaa') */
+    path: ExecutionPath;
+    /** Latency in milliseconds */
+    latencyMs?: number;
+    /** Error message if failed */
+    error?: string;
+    /** Whether fallback to VAA was triggered */
+    fellBack?: boolean;
+}
+/**
+ * Session key structure for temporary authentication
+ * Enables native L1 speed for repeat transactions without biometric auth
+ */
+interface SessionKey {
+    /** Hash of the temporary session public key */
+    sessionKeyHash: string;
+    /** Unix timestamp when session expires */
+    expiry: number;
+    /** Maximum transaction value for this session (0 = unlimited) */
+    maxValue: bigint;
+    /** Whether session was manually revoked */
+    revoked: boolean;
+}
+/**
+ * Result from session validation query
+ */
+interface SessionValidationResult {
+    /** Whether session is currently active */
+    active: boolean;
+    /** Session expiry timestamp (0 if inactive) */
+    expiry: number;
+    /** Maximum transaction value (0 if inactive) */
+    maxValue: bigint;
+    /** Index in sessions array */
+    sessionIndex: number;
+}
+/**
+ * Parameters for registering a new session
+ */
+interface RegisterSessionParams {
+    /** Signature for Passkey authentication */
+    signature: WebAuthnSignature;
+    /** User's Passkey public key X coordinate */
+    publicKeyX: bigint;
+    /** User's Passkey public key Y coordinate */
+    publicKeyY: bigint;
+    /** Hash of the temporary session public key */
+    sessionKeyHash: string;
+    /** Session duration in seconds (max 24 hours) */
+    duration: number;
+    /** Maximum transaction value (0 = unlimited) */
+    maxValue: bigint;
+    /** Whether to require user verification */
+    requireUV: boolean;
+}
+/**
+ * Parameters for revoking a session
+ */
+interface RevokeSessionParams {
+    /** Signature for Passkey authentication */
+    signature: WebAuthnSignature;
+    /** User's Passkey public key X coordinate */
+    publicKeyX: bigint;
+    /** User's Passkey public key Y coordinate */
+    publicKeyY: bigint;
+    /** Hash of the session key to revoke */
+    sessionKeyHash: string;
+    /** Whether to require user verification */
+    requireUV: boolean;
+}
+/**
+ * Identity state for multi-key management
+ * First passkey registered becomes the immutable identity root
+ */
+interface IdentityState {
+    /** Identity key hash (first passkey's keyHash) */
+    identity: string;
+    /** Number of authorized keys */
+    keyCount: number;
+    /** Maximum allowed keys per identity */
+    maxKeys: number;
+    /** Whether the specified key is the root identity */
+    isRoot: boolean;
+}
+/**
+ * Result from registering a backup passkey
+ */
+interface AddBackupKeyResult {
+    /** Transaction hash on Hub chain */
+    transactionHash: string;
+    /** Wormhole sequence number for cross-chain sync */
+    sequence: bigint;
+    /** The identity the key was added to */
+    identity: string;
+    /** The new key hash that was added */
+    newKeyHash: string;
+    /** Total number of keys after addition */
+    keyCount: number;
+}
+/**
+ * Result from removing a passkey
+ */
+interface RemoveKeyResult {
+    /** Transaction hash on Hub chain */
+    transactionHash: string;
+    /** Wormhole sequence number for cross-chain sync */
+    sequence: bigint;
+    /** The identity the key was removed from */
+    identity: string;
+    /** The key hash that was removed */
+    removedKeyHash: string;
+    /** Remaining number of keys after removal */
+    keyCount: number;
+}
+/**
+ * Authorized key information
+ */
+interface AuthorizedKey {
+    /** Key hash of the authorized passkey */
+    keyHash: string;
+    /** Whether this key is the root identity key */
+    isRoot: boolean;
+}
+/**
+ * Guardian configuration for an identity
+ */
+interface GuardianConfig {
+    /** Array of guardian key hashes */
+    guardians: string[];
+    /** Required approvals for recovery (M-of-N) */
+    threshold: bigint;
+    /** Whether guardians have been configured */
+    isConfigured: boolean;
+}
+/**
+ * Recovery status for an identity
+ */
+interface RecoveryStatus {
+    /** Whether a recovery is currently active */
+    isActive: boolean;
+    /** Proposed new owner key hash */
+    newOwnerKeyHash: string;
+    /** Timestamp when recovery was initiated */
+    initiatedAt: bigint;
+    /** Current number of guardian approvals */
+    approvalCount: bigint;
+    /** Required approvals for recovery */
+    threshold: bigint;
+    /** Timestamp when recovery can be executed (after timelock) */
+    canExecuteAt: bigint;
+    /** Timestamp when recovery expires */
+    expiresAt: bigint;
+}
+/**
+ * Result from setting up guardians
+ */
+interface SetupGuardiansResult {
+    /** Transaction hash on Hub chain */
+    transactionHash: string;
+    /** Wormhole sequence number for cross-chain sync */
+    sequence: bigint;
+    /** The identity guardians were set up for */
+    identity: string;
+    /** Array of guardian key hashes */
+    guardians: string[];
+    /** Required approvals for recovery */
+    threshold: bigint;
+}
+/**
+ * Result from adding a guardian
+ */
+interface AddGuardianResult {
+    /** Transaction hash on Hub chain */
+    transactionHash: string;
+    /** Wormhole sequence number for cross-chain sync */
+    sequence: bigint;
+    /** The identity the guardian was added to */
+    identity: string;
+    /** The guardian key hash that was added */
+    guardianKeyHash: string;
+}
+/**
+ * Result from removing a guardian
+ */
+interface RemoveGuardianResult {
+    /** Transaction hash on Hub chain */
+    transactionHash: string;
+    /** Wormhole sequence number for cross-chain sync */
+    sequence: bigint;
+    /** The identity the guardian was removed from */
+    identity: string;
+    /** The guardian key hash that was removed */
+    guardianKeyHash: string;
+}
+/**
+ * Result from initiating recovery
+ */
+interface InitiateRecoveryResult {
+    /** Transaction hash on Hub chain */
+    transactionHash: string;
+    /** Wormhole sequence number for cross-chain sync */
+    sequence: bigint;
+    /** The identity being recovered */
+    identity: string;
+    /** Proposed new owner key hash */
+    newOwnerKeyHash: string;
+    /** Timestamp when recovery can be executed */
+    canExecuteAt: bigint;
+}
+/**
+ * Result from approving recovery
+ */
+interface ApproveRecoveryResult {
+    /** Transaction hash on Hub chain */
+    transactionHash: string;
+    /** Wormhole sequence number for cross-chain sync */
+    sequence: bigint;
+    /** The identity being recovered */
+    identity: string;
+    /** The guardian who approved */
+    guardianKeyHash: string;
+    /** Current approval count */
+    approvalCount: bigint;
+    /** Required approvals */
+    threshold: bigint;
+}
+/**
+ * Result from executing recovery
+ */
+interface ExecuteRecoveryResult {
+    /** Transaction hash on Hub chain */
+    transactionHash: string;
+    /** Wormhole sequence number for cross-chain sync */
+    sequence: bigint;
+    /** The identity that was recovered */
+    identity: string;
+    /** The new owner key hash */
+    newOwnerKeyHash: string;
+}
+/**
+ * Result from cancelling recovery
+ */
+interface CancelRecoveryResult {
+    /** Transaction hash on Hub chain */
+    transactionHash: string;
+    /** Wormhole sequence number for cross-chain sync */
+    sequence: bigint;
+    /** The identity whose recovery was cancelled */
+    identity: string;
+}
+interface ExecuteAction {
+    type: 'execute';
+    target: string;
+    value: bigint;
+    data: string;
+}
+interface ConfigAction {
+    type: 'config';
+    configType: number;
+    configData: string;
+}
+type ActionPayload = TransferAction | BridgeAction | ExecuteAction | ConfigAction | {
+    type: string;
+    raw: string;
+};
+interface VAA {
+    version: number;
+    guardianSetIndex: number;
+    signatures: VAASignature[];
+    timestamp: number;
+    nonce: number;
+    emitterChain: number;
+    emitterAddress: string;
+    sequence: bigint;
+    consistencyLevel: number;
+    payload: string;
+    hash: string;
+}
+interface VAASignature {
+    guardianIndex: number;
+    signature: string;
+}
+interface VeridexPayload {
+    version: number;
+    userKeyHash: string;
+    targetChain: number;
+    nonce: bigint;
+    publicKeyX: bigint;
+    publicKeyY: bigint;
+    actionPayload: string;
+}
+interface VaultInfo {
+    address: string;
+    ownerKeyHash: string;
+    chain: string;
+    wormholeChainId: number;
+}
+interface TestResult {
+    success: boolean;
+    sourceChain: string;
+    targetChain: string;
+    txHash?: string;
+    vaaSequence?: bigint;
+    error?: string;
+    duration?: number;
+}
+
+export type { ActionPayload, AddBackupKeyResult, AddGuardianResult, ApproveRecoveryResult, AuthorizedKey, BridgeAction, BridgeParams, CancelRecoveryResult, ChainConfig, ConfigAction, DispatchResult, ExecuteAction, ExecuteParams, ExecuteRecoveryResult, ExecutionPath, GuardianConfig, IdentityState, InitiateRecoveryResult, PasskeyCredential, QueryProof, QuerySubmissionResult, RecoveryStatus, RegisterSessionParams, RemoveGuardianResult, RemoveKeyResult, RevokeSessionParams, SessionKey, SessionValidationResult, SetupGuardiansResult, TestResult, TransferAction, TransferParams, VAA, VAASignature, VaultInfo, VeridexConfig, VeridexPayload, WebAuthnSignature };

package/dist/types.js

@@ -0,0 +1,19 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/types.ts
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["/**\n * Veridex Protocol SDK - Type Definitions\n */\n\n// ============================================================================\n// Configuration Types\n// ============================================================================\n\nexport interface VeridexConfig {\n  hubChainId: number;\n  hubRpcUrl: string;\n  hubContractAddress: string;\n  relayerUrl?: string;\n}\n\nexport interface ChainConfig {\n  name: string;\n  chainId: number;\n  wormholeChainId: number;\n  hubChainId?: number; // Wormhole chain ID of the Hub (for cross-chain auth)\n  rpcUrl: string;\n  explorerUrl: string;\n  isEvm: boolean;\n  contracts: {\n    hub?: string;\n    vaultFactory?: string;\n    vaultImplementation?: string;\n    wormholeCoreBridge: string;\n    tokenBridge?: string;\n  };\n}\n\n// ============================================================================\n// Credential Types\n// ============================================================================\n\nexport interface PasskeyCredential {\n  credentialId: string;\n  publicKeyX: bigint;\n  publicKeyY: bigint;\n  keyHash: string;\n}\n\nexport interface WebAuthnSignature {\n  authenticatorData: string;\n  clientDataJSON: string;\n  challengeIndex: number;\n  typeIndex: number;\n  r: bigint;\n  s: bigint;\n}\n\n// ============================================================================\n// Action Types\n// ============================================================================\n\nexport interface TransferParams {\n  targetChain: number;\n  token: string; // address or \"native\"\n  recipient: string;\n  amount: bigint;\n}\n\nexport interface ExecuteParams {\n  targetChain: number;\n  target: string;\n  value: bigint;\n  data: string;\n}\n\nexport interface BridgeParams {\n  sourceChain: number; // Chain where vault holds the tokens\n  token: string; // Token address (or \"native\" for native token)\n  amount: bigint;\n  destinationChain: number; // Wormhole chain ID of destination\n  recipient: string; // Recipient address on destination chain (hex string)\n}\n\nexport interface DispatchResult {\n  transactionHash: string;\n  sequence: bigint;\n  userKeyHash: string;\n  targetChain: number;\n}\n\n// ============================================================================\n// Action Payload Types\n// ============================================================================\n\nexport interface TransferAction {\n  type: 'transfer';\n  token: string;\n  recipient: string;\n  amount: bigint;\n}\n\nexport interface BridgeAction {\n  type: 'bridge';\n  token: string;\n  amount: bigint;\n  targetChain: number;\n  recipient: string;\n}\n\n// ============================================================================\n// Query Types (Issue #9/#10/#11/#12)\n// ============================================================================\n\n/**\n * Wormhole Query proof for optimistic execution\n * Allows ~5-7 second latency vs ~120+ seconds for VAA\n */\nexport interface QueryProof {\n  /** Raw query response bytes from Wormhole Guardians */\n  queryResponse: string; // hex\n  /** Guardian signatures (13/19 quorum) */\n  signatures: string; // hex\n}\n\n/**\n * User preference for execution path\n */\nexport type ExecutionPath = 'query' | 'vaa' | 'auto';\n\n/**\n * Result from query-based submission\n */\nexport interface QuerySubmissionResult {\n  /** Whether submission succeeded */\n  success: boolean;\n  /** Transaction hash on spoke chain */\n  txHash?: string;\n  /** Execution path used ('query' or 'vaa') */\n  path: ExecutionPath;\n  /** Latency in milliseconds */\n  latencyMs?: number;\n  /** Error message if failed */\n  error?: string;\n  /** Whether fallback to VAA was triggered */\n  fellBack?: boolean;\n}\n\n// ============================================================================\n// Session Key Types (Issue #13)\n// ============================================================================\n\n/**\n * Session key structure for temporary authentication\n * Enables native L1 speed for repeat transactions without biometric auth\n */\nexport interface SessionKey {\n  /** Hash of the temporary session public key */\n  sessionKeyHash: string;\n  /** Unix timestamp when session expires */\n  expiry: number;\n  /** Maximum transaction value for this session (0 = unlimited) */\n  maxValue: bigint;\n  /** Whether session was manually revoked */\n  revoked: boolean;\n}\n\n/**\n * Result from session validation query\n */\nexport interface SessionValidationResult {\n  /** Whether session is currently active */\n  active: boolean;\n  /** Session expiry timestamp (0 if inactive) */\n  expiry: number;\n  /** Maximum transaction value (0 if inactive) */\n  maxValue: bigint;\n  /** Index in sessions array */\n  sessionIndex: number;\n}\n\n/**\n * Parameters for registering a new session\n */\nexport interface RegisterSessionParams {\n  /** Signature for Passkey authentication */\n  signature: WebAuthnSignature;\n  /** User's Passkey public key X coordinate */\n  publicKeyX: bigint;\n  /** User's Passkey public key Y coordinate */\n  publicKeyY: bigint;\n  /** Hash of the temporary session public key */\n  sessionKeyHash: string;\n  /** Session duration in seconds (max 24 hours) */\n  duration: number;\n  /** Maximum transaction value (0 = unlimited) */\n  maxValue: bigint;\n  /** Whether to require user verification */\n  requireUV: boolean;\n}\n\n/**\n * Parameters for revoking a session\n */\nexport interface RevokeSessionParams {\n  /** Signature for Passkey authentication */\n  signature: WebAuthnSignature;\n  /** User's Passkey public key X coordinate */\n  publicKeyX: bigint;\n  /** User's Passkey public key Y coordinate */\n  publicKeyY: bigint;\n  /** Hash of the session key to revoke */\n  sessionKeyHash: string;\n  /** Whether to require user verification */\n  requireUV: boolean;\n}\n\n// ============================================================================\n// Backup Passkey / Multi-Key Identity Types (Issue #22)\n// ============================================================================\n\n/**\n * Identity state for multi-key management\n * First passkey registered becomes the immutable identity root\n */\nexport interface IdentityState {\n  /** Identity key hash (first passkey's keyHash) */\n  identity: string;\n  /** Number of authorized keys */\n  keyCount: number;\n  /** Maximum allowed keys per identity */\n  maxKeys: number;\n  /** Whether the specified key is the root identity */\n  isRoot: boolean;\n}\n\n/**\n * Result from registering a backup passkey\n */\nexport interface AddBackupKeyResult {\n  /** Transaction hash on Hub chain */\n  transactionHash: string;\n  /** Wormhole sequence number for cross-chain sync */\n  sequence: bigint;\n  /** The identity the key was added to */\n  identity: string;\n  /** The new key hash that was added */\n  newKeyHash: string;\n  /** Total number of keys after addition */\n  keyCount: number;\n}\n\n/**\n * Result from removing a passkey\n */\nexport interface RemoveKeyResult {\n  /** Transaction hash on Hub chain */\n  transactionHash: string;\n  /** Wormhole sequence number for cross-chain sync */\n  sequence: bigint;\n  /** The identity the key was removed from */\n  identity: string;\n  /** The key hash that was removed */\n  removedKeyHash: string;\n  /** Remaining number of keys after removal */\n  keyCount: number;\n}\n\n/**\n * Authorized key information\n */\nexport interface AuthorizedKey {\n  /** Key hash of the authorized passkey */\n  keyHash: string;\n  /** Whether this key is the root identity key */\n  isRoot: boolean;\n}\n\n// =============================================================================\n//                      SOCIAL RECOVERY TYPES (Issue #23)\n// =============================================================================\n\n/**\n * Guardian configuration for an identity\n */\nexport interface GuardianConfig {\n  /** Array of guardian key hashes */\n  guardians: string[];\n  /** Required approvals for recovery (M-of-N) */\n  threshold: bigint;\n  /** Whether guardians have been configured */\n  isConfigured: boolean;\n}\n\n/**\n * Recovery status for an identity\n */\nexport interface RecoveryStatus {\n  /** Whether a recovery is currently active */\n  isActive: boolean;\n  /** Proposed new owner key hash */\n  newOwnerKeyHash: string;\n  /** Timestamp when recovery was initiated */\n  initiatedAt: bigint;\n  /** Current number of guardian approvals */\n  approvalCount: bigint;\n  /** Required approvals for recovery */\n  threshold: bigint;\n  /** Timestamp when recovery can be executed (after timelock) */\n  canExecuteAt: bigint;\n  /** Timestamp when recovery expires */\n  expiresAt: bigint;\n}\n\n/**\n * Result from setting up guardians\n */\nexport interface SetupGuardiansResult {\n  /** Transaction hash on Hub chain */\n  transactionHash: string;\n  /** Wormhole sequence number for cross-chain sync */\n  sequence: bigint;\n  /** The identity guardians were set up for */\n  identity: string;\n  /** Array of guardian key hashes */\n  guardians: string[];\n  /** Required approvals for recovery */\n  threshold: bigint;\n}\n\n/**\n * Result from adding a guardian\n */\nexport interface AddGuardianResult {\n  /** Transaction hash on Hub chain */\n  transactionHash: string;\n  /** Wormhole sequence number for cross-chain sync */\n  sequence: bigint;\n  /** The identity the guardian was added to */\n  identity: string;\n  /** The guardian key hash that was added */\n  guardianKeyHash: string;\n}\n\n/**\n * Result from removing a guardian\n */\nexport interface RemoveGuardianResult {\n  /** Transaction hash on Hub chain */\n  transactionHash: string;\n  /** Wormhole sequence number for cross-chain sync */\n  sequence: bigint;\n  /** The identity the guardian was removed from */\n  identity: string;\n  /** The guardian key hash that was removed */\n  guardianKeyHash: string;\n}\n\n/**\n * Result from initiating recovery\n */\nexport interface InitiateRecoveryResult {\n  /** Transaction hash on Hub chain */\n  transactionHash: string;\n  /** Wormhole sequence number for cross-chain sync */\n  sequence: bigint;\n  /** The identity being recovered */\n  identity: string;\n  /** Proposed new owner key hash */\n  newOwnerKeyHash: string;\n  /** Timestamp when recovery can be executed */\n  canExecuteAt: bigint;\n}\n\n/**\n * Result from approving recovery\n */\nexport interface ApproveRecoveryResult {\n  /** Transaction hash on Hub chain */\n  transactionHash: string;\n  /** Wormhole sequence number for cross-chain sync */\n  sequence: bigint;\n  /** The identity being recovered */\n  identity: string;\n  /** The guardian who approved */\n  guardianKeyHash: string;\n  /** Current approval count */\n  approvalCount: bigint;\n  /** Required approvals */\n  threshold: bigint;\n}\n\n/**\n * Result from executing recovery\n */\nexport interface ExecuteRecoveryResult {\n  /** Transaction hash on Hub chain */\n  transactionHash: string;\n  /** Wormhole sequence number for cross-chain sync */\n  sequence: bigint;\n  /** The identity that was recovered */\n  identity: string;\n  /** The new owner key hash */\n  newOwnerKeyHash: string;\n}\n\n/**\n * Result from cancelling recovery\n */\nexport interface CancelRecoveryResult {\n  /** Transaction hash on Hub chain */\n  transactionHash: string;\n  /** Wormhole sequence number for cross-chain sync */\n  sequence: bigint;\n  /** The identity whose recovery was cancelled */\n  identity: string;\n}\n\nexport interface ExecuteAction {\n  type: 'execute';\n  target: string;\n  value: bigint;\n  data: string;\n}\n\nexport interface ConfigAction {\n  type: 'config';\n  configType: number;\n  configData: string;\n}\n\nexport type ActionPayload = TransferAction | BridgeAction | ExecuteAction | ConfigAction | { type: string; raw: string };\n\n// ============================================================================\n// VAA Types\n// ============================================================================\n\nexport interface VAA {\n  version: number;\n  guardianSetIndex: number;\n  signatures: VAASignature[];\n  timestamp: number;\n  nonce: number;\n  emitterChain: number;\n  emitterAddress: string;\n  sequence: bigint;\n  consistencyLevel: number;\n  payload: string;\n  hash: string; // keccak256 of the body (for verification)\n}\n\nexport interface VAASignature {\n  guardianIndex: number;\n  signature: string;\n}\n\nexport interface VeridexPayload {\n  version: number;\n  userKeyHash: string;\n  targetChain: number;\n  nonce: bigint;\n  publicKeyX: bigint;\n  publicKeyY: bigint;\n  actionPayload: string;\n}\n\n// ============================================================================\n// Vault Types\n// ============================================================================\n\nexport interface VaultInfo {\n  address: string;\n  ownerKeyHash: string;\n  chain: string;\n  wormholeChainId: number;\n}\n\n// ============================================================================\n// Test Result Types\n// ============================================================================\n\nexport interface TestResult {\n  success: boolean;\n  sourceChain: string;\n  targetChain: string;\n  txHash?: string;\n  vaaSequence?: bigint;\n  error?: string;\n  duration?: number;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/types.mjs

@@ -0,0 +1 @@
+//# sourceMappingURL=types.mjs.map

package/dist/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/utils.d.mts

@@ -0,0 +1,81 @@
+import { ChainConfig } from './types.mjs';
+
+/**
+ * Veridex Protocol SDK - Utility Functions
+ */
+
+/**
+ * Base64URL encode a buffer
+ */
+declare function base64URLEncode(buffer: Uint8Array): string;
+/**
+ * Base64URL decode a string
+ */
+declare function base64URLDecode(str: string): Uint8Array;
+/**
+ * Parse DER-encoded ECDSA signature to r and s values
+ */
+declare function parseDERSignature(signature: Uint8Array): {
+    r: Uint8Array;
+    s: Uint8Array;
+};
+/**
+ * Encode signature for Solidity verification
+ */
+declare function encodeSignatureForSolidity(r: bigint, s: bigint): string;
+/**
+ * Compute key hash from public key coordinates
+ */
+declare function computeKeyHash(publicKeyX: bigint, publicKeyY: bigint): string;
+/**
+ * Get chain config by name
+ */
+declare function getChainConfig(chainName: string, testnet?: boolean): ChainConfig | undefined;
+/**
+ * Get chain config by Wormhole chain ID
+ */
+declare function getChainByWormholeId(wormholeChainId: number, testnet?: boolean): ChainConfig | undefined;
+/**
+ * Get chain config by EVM chain ID
+ */
+declare function getChainByEvmId(evmChainId: number, testnet?: boolean): ChainConfig | undefined;
+/**
+ * Check if a chain is EVM-compatible
+ */
+declare function isEvmChain(wormholeChainId: number): boolean;
+/**
+ * Get all supported chains
+ */
+declare function getSupportedChains(testnet?: boolean): ChainConfig[];
+/**
+ * Get transaction explorer URL
+ */
+declare function getTxExplorerUrl(chain: ChainConfig, txHash: string): string;
+/**
+ * Get address explorer URL
+ */
+declare function getAddressExplorerUrl(chain: ChainConfig, address: string): string;
+/**
+ * Validate an EVM address
+ */
+declare function isValidEvmAddress(address: string): boolean;
+/**
+ * Validate a bytes32 hex string
+ */
+declare function isValidBytes32(hex: string): boolean;
+/**
+ * Validate a Wormhole chain ID
+ */
+declare function isValidWormholeChainId(chainId: number): boolean;
+/**
+ * Retry a function with exponential backoff
+ */
+declare function retryWithBackoff<T>(fn: () => Promise<T>, options?: {
+    maxRetries?: number;
+    initialDelayMs?: number;
+    maxDelayMs?: number;
+    backoffMultiplier?: number;
+    onRetry?: (attempt: number, error: Error) => void;
+}): Promise<T>;
+
+export { base64URLDecode, base64URLEncode, computeKeyHash, encodeSignatureForSolidity, getAddressExplorerUrl, getChainByEvmId, getChainByWormholeId, getChainConfig, getSupportedChains, getTxExplorerUrl, isEvmChain, isValidBytes32, isValidEvmAddress, isValidWormholeChainId, parseDERSignature, retryWithBackoff };

package/dist/utils.d.ts

@@ -0,0 +1,81 @@
+import { ChainConfig } from './types.js';
+
+/**
+ * Veridex Protocol SDK - Utility Functions
+ */
+
+/**
+ * Base64URL encode a buffer
+ */
+declare function base64URLEncode(buffer: Uint8Array): string;
+/**
+ * Base64URL decode a string
+ */
+declare function base64URLDecode(str: string): Uint8Array;
+/**
+ * Parse DER-encoded ECDSA signature to r and s values
+ */
+declare function parseDERSignature(signature: Uint8Array): {
+    r: Uint8Array;
+    s: Uint8Array;
+};
+/**
+ * Encode signature for Solidity verification
+ */
+declare function encodeSignatureForSolidity(r: bigint, s: bigint): string;
+/**
+ * Compute key hash from public key coordinates
+ */
+declare function computeKeyHash(publicKeyX: bigint, publicKeyY: bigint): string;
+/**
+ * Get chain config by name
+ */
+declare function getChainConfig(chainName: string, testnet?: boolean): ChainConfig | undefined;
+/**
+ * Get chain config by Wormhole chain ID
+ */
+declare function getChainByWormholeId(wormholeChainId: number, testnet?: boolean): ChainConfig | undefined;
+/**
+ * Get chain config by EVM chain ID
+ */
+declare function getChainByEvmId(evmChainId: number, testnet?: boolean): ChainConfig | undefined;
+/**
+ * Check if a chain is EVM-compatible
+ */
+declare function isEvmChain(wormholeChainId: number): boolean;
+/**
+ * Get all supported chains
+ */
+declare function getSupportedChains(testnet?: boolean): ChainConfig[];
+/**
+ * Get transaction explorer URL
+ */
+declare function getTxExplorerUrl(chain: ChainConfig, txHash: string): string;
+/**
+ * Get address explorer URL
+ */
+declare function getAddressExplorerUrl(chain: ChainConfig, address: string): string;
+/**
+ * Validate an EVM address
+ */
+declare function isValidEvmAddress(address: string): boolean;
+/**
+ * Validate a bytes32 hex string
+ */
+declare function isValidBytes32(hex: string): boolean;
+/**
+ * Validate a Wormhole chain ID
+ */
+declare function isValidWormholeChainId(chainId: number): boolean;
+/**
+ * Retry a function with exponential backoff
+ */
+declare function retryWithBackoff<T>(fn: () => Promise<T>, options?: {
+    maxRetries?: number;
+    initialDelayMs?: number;
+    maxDelayMs?: number;
+    backoffMultiplier?: number;
+    onRetry?: (attempt: number, error: Error) => void;
+}): Promise<T>;
+
+export { base64URLDecode, base64URLEncode, computeKeyHash, encodeSignatureForSolidity, getAddressExplorerUrl, getChainByEvmId, getChainByWormholeId, getChainConfig, getSupportedChains, getTxExplorerUrl, isEvmChain, isValidBytes32, isValidEvmAddress, isValidWormholeChainId, parseDERSignature, retryWithBackoff };