@veridex/sdk 1.1.5 → 1.1.7

package/dist/queries/index.mjs

@@ -1,19 +1,333 @@
 import {
   QueryPortfolioError,
-  queryPortfolio
-} from "../chunk-NVRAQPSF.mjs";
-import {
-  QueryHubStateError,
-  queryHubState
-} from "../chunk-XDIIFIW6.mjs";
-import {
   WORMHOLE_QUERY_CHAIN_IDS,
   WORMHOLE_QUERY_PROXY_URLS,
-  WORMHOLE_QUERY_RATE_LIMIT_PER_SECOND
-} from "../chunk-72ZA3OYQ.mjs";
+  WORMHOLE_QUERY_RATE_LIMIT_PER_SECOND,
+  queryPortfolio
+} from "../chunk-UF5NWMSQ.mjs";
 import "../chunk-GEVTBQH2.mjs";
 import "../chunk-VABK3ID3.mjs";
-import "../chunk-KYOOTSRA.mjs";
+import {
+  MAINNET_CHAINS,
+  TESTNET_CHAINS
+} from "../chunk-KYOOTSRA.mjs";
+
+// src/queries/hubState.ts
+import axios from "axios";
+import { Buffer } from "buffer";
+import { ethers } from "ethers";
+import {
+  EthCallQueryRequest,
+  EthCallQueryResponse,
+  PerChainQueryRequest,
+  QueryRequest,
+  QueryResponse,
+  hexToUint8Array,
+  isValidHexString
+} from "@wormhole-foundation/wormhole-query-sdk";
+var QueryHubStateError = class extends Error {
+  code;
+  cause;
+  constructor(code, message, cause) {
+    super(message);
+    this.name = "QueryHubStateError";
+    this.code = code;
+    this.cause = cause;
+  }
+};
+function resolveNetwork(options) {
+  if (options?.network) return options.network;
+  const envCandidates = [
+    globalThis?.process?.env?.NEXT_PUBLIC_VERIDEX_NETWORK,
+    globalThis?.process?.env?.VERIDEX_NETWORK,
+    globalThis?.process?.env?.NEXT_PUBLIC_WORMHOLE_NETWORK,
+    globalThis?.process?.env?.WORMHOLE_NETWORK
+  ].filter(Boolean);
+  const env = envCandidates[0]?.toLowerCase();
+  if (env === "mainnet" || env === "testnet") return env;
+  return "testnet";
+}
+function concatBytes(parts) {
+  const total = parts.reduce((sum, p) => sum + p.length, 0);
+  const out = new Uint8Array(total);
+  let offset = 0;
+  for (const p of parts) {
+    out.set(p, offset);
+    offset += p.length;
+  }
+  return out;
+}
+function signaturesToProofBytes(signatures) {
+  const chunks = [];
+  for (const sig of signatures) {
+    if (typeof sig !== "string" || sig.length !== 132 || !/^[0-9a-fA-F]+$/.test(sig)) {
+      throw new QueryHubStateError(
+        "PROXY_RESPONSE_INVALID",
+        `Invalid guardian signature format (expected 132 hex chars): ${String(sig)}`
+      );
+    }
+    chunks.push(hexToUint8Array(`0x${sig}`));
+  }
+  return concatBytes(chunks);
+}
+function decodeQueryBytes(bytes) {
+  if (typeof bytes !== "string" || bytes.length === 0) {
+    throw new QueryHubStateError("PROXY_RESPONSE_INVALID", "Missing query response bytes");
+  }
+  if (isValidHexString(bytes)) {
+    return hexToUint8Array(bytes);
+  }
+  try {
+    if (typeof atob === "function") {
+      const raw = atob(bytes);
+      const arr = new Uint8Array(raw.length);
+      for (let i = 0; i < raw.length; i++) arr[i] = raw.charCodeAt(i);
+      return arr;
+    }
+  } catch {
+  }
+  try {
+    return new Uint8Array(Buffer.from(bytes, "base64"));
+  } catch (cause) {
+    throw new QueryHubStateError("PROXY_RESPONSE_INVALID", "Unrecognized query response bytes encoding", cause);
+  }
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function withExponentialBackoff(fn, maxAttempts) {
+  let attempt = 0;
+  let lastError;
+  while (attempt < maxAttempts) {
+    try {
+      return await fn();
+    } catch (err) {
+      lastError = err;
+      attempt += 1;
+      if (attempt >= maxAttempts) break;
+      const baseMs = 250;
+      const backoffMs = Math.min(5e3, baseMs * 2 ** (attempt - 1));
+      const jitterMs = Math.floor(Math.random() * 100);
+      await sleep(backoffMs + jitterMs);
+    }
+  }
+  throw lastError;
+}
+function getHubConfig(network) {
+  if (network === "testnet") {
+    const baseSepolia = TESTNET_CHAINS.baseSepolia;
+    if (!baseSepolia?.contracts?.hub) {
+      throw new QueryHubStateError("MISSING_HUB_ADDRESS", "Missing Base Sepolia hub address in SDK constants");
+    }
+    return {
+      wormholeChainId: baseSepolia.wormholeChainId,
+      hubAddress: baseSepolia.contracts.hub,
+      endpoint: WORMHOLE_QUERY_PROXY_URLS.testnet,
+      rpcUrl: baseSepolia.rpcUrl
+    };
+  }
+  if (network === "mainnet") {
+    const base = MAINNET_CHAINS.base;
+    const hubAddress = base?.contracts?.hub;
+    if (!hubAddress) {
+      throw new QueryHubStateError(
+        "MISSING_HUB_ADDRESS",
+        "Missing mainnet hub address in SDK constants (MAINNET_CHAINS.base.contracts.hub)"
+      );
+    }
+    return {
+      wormholeChainId: base.wormholeChainId,
+      hubAddress,
+      endpoint: WORMHOLE_QUERY_PROXY_URLS.mainnet,
+      rpcUrl: base.rpcUrl
+    };
+  }
+  throw new QueryHubStateError("UNSUPPORTED_NETWORK", `Unsupported network: ${network}`);
+}
+function encodeHubCalls(hubAddress, userKeyHash) {
+  const nonceAbiCandidates = [
+    "function getUserNonce(bytes32 userKeyHash) view returns (uint256)",
+    "function userNonces(bytes32 userKeyHash) view returns (uint256)",
+    "function getNonceByHash(bytes32 userKeyHash) view returns (uint256)"
+  ];
+  const registeredAbiCandidates = [
+    "function registeredKeys(bytes32 userKeyHash) view returns (bool)",
+    "function isKeyRegisteredByHash(bytes32 userKeyHash) view returns (bool)"
+  ];
+  const actionHashAbiCandidates = [
+    "function getUserLastActionHash(bytes32 userKeyHash) view returns (bytes32)",
+    "function userLastActionHash(bytes32 userKeyHash) view returns (bytes32)"
+  ];
+  const iface = new ethers.Interface([
+    ...nonceAbiCandidates,
+    ...registeredAbiCandidates,
+    ...actionHashAbiCandidates
+  ]);
+  const nonceFnNames = ["getUserNonce", "userNonces", "getNonceByHash"];
+  const regFnNames = ["registeredKeys", "isKeyRegisteredByHash"];
+  const actionHashFnNames = ["getUserLastActionHash", "userLastActionHash"];
+  return [
+    ...nonceFnNames.map((fn) => ({
+      to: hubAddress,
+      data: iface.encodeFunctionData(fn, [userKeyHash])
+    })),
+    ...regFnNames.map((fn) => ({
+      to: hubAddress,
+      data: iface.encodeFunctionData(fn, [userKeyHash])
+    })),
+    ...actionHashFnNames.map((fn) => ({
+      to: hubAddress,
+      data: iface.encodeFunctionData(fn, [userKeyHash])
+    }))
+  ];
+}
+function decodeFirstNonce(results) {
+  const candidates = [
+    "function getUserNonce(bytes32 userKeyHash) view returns (uint256)",
+    "function userNonces(bytes32 userKeyHash) view returns (uint256)",
+    "function getNonceByHash(bytes32 userKeyHash) view returns (uint256)"
+  ];
+  const iface = new ethers.Interface(candidates);
+  const fnNames = ["getUserNonce", "userNonces", "getNonceByHash"];
+  for (let idx = 0; idx < fnNames.length; idx++) {
+    const fnName = fnNames[idx];
+    try {
+      const data = results[idx];
+      if (!data || data === "0x") continue;
+      const decoded = iface.decodeFunctionResult(fnName, data);
+      return decoded[0];
+    } catch {
+    }
+  }
+  throw new QueryHubStateError("QUERY_RESPONSE_INVALID", "Unable to decode user nonce from query response");
+}
+function decodeFirstIsRegistered(results) {
+  const nonceCandidateCount = 3;
+  const candidates = [
+    "function registeredKeys(bytes32 userKeyHash) view returns (bool)",
+    "function isKeyRegisteredByHash(bytes32 userKeyHash) view returns (bool)"
+  ];
+  const iface = new ethers.Interface(candidates);
+  const fnNames = ["registeredKeys", "isKeyRegisteredByHash"];
+  for (let i = 0; i < fnNames.length; i++) {
+    const fnName = fnNames[i];
+    try {
+      const data = results[nonceCandidateCount + i];
+      if (!data || data === "0x") continue;
+      const decoded = iface.decodeFunctionResult(fnName, data);
+      return Boolean(decoded[0]);
+    } catch {
+    }
+  }
+  return false;
+}
+function decodeLastActionHash(results) {
+  const nonceCandidateCount = 3;
+  const registeredCandidateCount = 2;
+  const actionHashOffset = nonceCandidateCount + registeredCandidateCount;
+  const candidates = [
+    "function getUserLastActionHash(bytes32 userKeyHash) view returns (bytes32)",
+    "function userLastActionHash(bytes32 userKeyHash) view returns (bytes32)"
+  ];
+  const iface = new ethers.Interface(candidates);
+  const fnNames = ["getUserLastActionHash", "userLastActionHash"];
+  for (let i = 0; i < fnNames.length; i++) {
+    const fnName = fnNames[i];
+    try {
+      const data = results[actionHashOffset + i];
+      if (!data || data === "0x") continue;
+      const decoded = iface.decodeFunctionResult(fnName, data);
+      return decoded[0];
+    } catch {
+    }
+  }
+  return ethers.ZeroHash;
+}
+async function queryHubState(userKeyHash, apiKey, options) {
+  if (typeof userKeyHash !== "string" || userKeyHash.length === 0) {
+    throw new QueryHubStateError("INVALID_ARGUMENT", "userKeyHash is required");
+  }
+  if (!isValidHexString(userKeyHash) || hexToUint8Array(userKeyHash).length !== 32) {
+    throw new QueryHubStateError("INVALID_ARGUMENT", "userKeyHash must be a 32-byte hex string");
+  }
+  if (typeof apiKey !== "string" || apiKey.length === 0) {
+    throw new QueryHubStateError("INVALID_ARGUMENT", "apiKey is required");
+  }
+  const network = resolveNetwork(options);
+  const maxAgeSeconds = options?.maxAge ?? 60;
+  const maxAttempts = options?.maxAttempts ?? 4;
+  const { wormholeChainId, hubAddress, endpoint, rpcUrl } = getHubConfig(network);
+  const provider = new ethers.JsonRpcProvider(rpcUrl);
+  const callData = encodeHubCalls(hubAddress, userKeyHash);
+  const doFetch = async () => {
+    try {
+      const latestBlock = await provider.getBlockNumber();
+      const blockTag = Math.max(0, latestBlock - 2);
+      const request = new QueryRequest(Date.now() & 4294967295, [
+        new PerChainQueryRequest(wormholeChainId, new EthCallQueryRequest(blockTag, callData))
+      ]);
+      const requestHex = Buffer.from(request.serialize()).toString("hex");
+      const response = await axios.post(
+        endpoint,
+        { bytes: requestHex },
+        {
+          headers: {
+            "X-API-Key": apiKey,
+            "Content-Type": "application/json"
+          },
+          timeout: 1e4
+        }
+      );
+      const data = response.data;
+      const signatures = data?.signatures;
+      const bytes = data?.bytes;
+      if (!Array.isArray(signatures) || typeof bytes !== "string") {
+        throw new QueryHubStateError("PROXY_RESPONSE_INVALID", "Query Proxy response missing signatures/bytes");
+      }
+      const proof = signaturesToProofBytes(signatures);
+      const queryBytes = decodeQueryBytes(bytes);
+      const parsed = QueryResponse.from(queryBytes);
+      const perChain = parsed.responses.find((r) => r.chainId === wormholeChainId);
+      if (!perChain) {
+        throw new QueryHubStateError("QUERY_RESPONSE_INVALID", "Missing per-chain response for hub chain");
+      }
+      const chainResp = EthCallQueryResponse.from(perChain.response.serialize());
+      const blockTime = Number(chainResp.blockTime);
+      const nowSeconds = Math.floor(Date.now() / 1e3);
+      if (nowSeconds - blockTime > maxAgeSeconds) {
+        throw new QueryHubStateError(
+          "ATTESTATION_STALE",
+          `Guardian attestation is stale (blockTime=${blockTime}, now=${nowSeconds}, maxAge=${maxAgeSeconds}s)`
+        );
+      }
+      const nonce = decodeFirstNonce(chainResp.results);
+      const isRegistered = decodeFirstIsRegistered(chainResp.results);
+      const lastActionHash = decodeLastActionHash(chainResp.results);
+      return {
+        nonce,
+        isRegistered,
+        blockTime,
+        proof,
+        lastActionHash
+      };
+    } catch (err) {
+      if (err instanceof QueryHubStateError) throw err;
+      if (axios.isAxiosError(err)) {
+        const ax = err;
+        const status = ax.response?.status;
+        const statusText = ax.response?.statusText;
+        const details = typeof ax.response?.data === "string" ? ax.response?.data : void 0;
+        throw new QueryHubStateError(
+          "PROXY_HTTP_ERROR",
+          `Query Proxy request failed${status ? ` (${status} ${statusText ?? ""})` : ""}${details ? `: ${details}` : ""}`,
+          err
+        );
+      }
+      throw new QueryHubStateError("PROXY_HTTP_ERROR", "Query Proxy request failed", err);
+    }
+  };
+  return await withExponentialBackoff(doFetch, maxAttempts);
+}
 export {
   QueryHubStateError,
   QueryPortfolioError,

package/dist/queries/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
+{"version":3,"sources":["../../src/queries/hubState.ts"],"sourcesContent":["import axios, { AxiosError } from 'axios';\nimport { Buffer } from 'buffer';\nimport { ethers } from 'ethers';\nimport {\n  EthCallQueryRequest,\n  EthCallQueryResponse,\n  PerChainQueryRequest,\n  QueryRequest,\n  QueryResponse,\n  hexToUint8Array,\n  isValidHexString,\n} from '@wormhole-foundation/wormhole-query-sdk';\n\nimport { MAINNET_CHAINS, TESTNET_CHAINS } from '../constants.js';\nimport { WORMHOLE_QUERY_PROXY_URLS } from './constants.js';\n\nexport type QueryHubStateNetwork = 'testnet' | 'mainnet';\n\nexport type QueryHubStateOptions = {\n  /** Max response age in seconds (default: 60). */\n  maxAge?: number;\n  network?: QueryHubStateNetwork;\n  /** Maximum attempts including the first try (default: 4). */\n  maxAttempts?: number;\n};\n\nexport type HubStateResult = {\n  nonce: bigint;\n  isRegistered: boolean;\n  blockTime: number;\n  proof: Uint8Array;\n  /** Last action hash (Issue #9/#10 - for action-hash binding) */\n  lastActionHash?: string;\n};\n\nexport type QueryHubStateErrorCode =\n  | 'INVALID_ARGUMENT'\n  | 'UNSUPPORTED_NETWORK'\n  | 'MISSING_HUB_ADDRESS'\n  | 'PROXY_HTTP_ERROR'\n  | 'PROXY_RESPONSE_INVALID'\n  | 'ATTESTATION_STALE'\n  | 'QUERY_RESPONSE_INVALID';\n\nexport class QueryHubStateError extends Error {\n  code: QueryHubStateErrorCode;\n  cause?: unknown;\n\n  constructor(code: QueryHubStateErrorCode, message: string, cause?: unknown) {\n    super(message);\n    this.name = 'QueryHubStateError';\n    this.code = code;\n    this.cause = cause;\n  }\n}\n\nfunction resolveNetwork(options?: QueryHubStateOptions): QueryHubStateNetwork {\n  if (options?.network) return options.network;\n\n  const envCandidates = [\n    (globalThis as any)?.process?.env?.NEXT_PUBLIC_VERIDEX_NETWORK,\n    (globalThis as any)?.process?.env?.VERIDEX_NETWORK,\n    (globalThis as any)?.process?.env?.NEXT_PUBLIC_WORMHOLE_NETWORK,\n    (globalThis as any)?.process?.env?.WORMHOLE_NETWORK,\n  ].filter(Boolean);\n\n  const env = (envCandidates[0] as string | undefined)?.toLowerCase();\n  if (env === 'mainnet' || env === 'testnet') return env;\n\n  // Default to testnet to support Base Sepolia out-of-the-box.\n  return 'testnet';\n}\n\nfunction concatBytes(parts: Uint8Array[]): Uint8Array {\n  const total = parts.reduce((sum, p) => sum + p.length, 0);\n  const out = new Uint8Array(total);\n  let offset = 0;\n  for (const p of parts) {\n    out.set(p, offset);\n    offset += p.length;\n  }\n  return out;\n}\n\nfunction signaturesToProofBytes(signatures: string[]): Uint8Array {\n  const chunks: Uint8Array[] = [];\n\n  for (const sig of signatures) {\n    if (typeof sig !== 'string' || sig.length !== 132 || !/^[0-9a-fA-F]+$/.test(sig)) {\n      throw new QueryHubStateError(\n        'PROXY_RESPONSE_INVALID',\n        `Invalid guardian signature format (expected 132 hex chars): ${String(sig)}`\n      );\n    }\n    // Avoid Node Buffer-backed Uint8Array (can surface as SharedArrayBuffer in DTS types).\n    chunks.push(hexToUint8Array(`0x${sig}`));\n  }\n\n  return concatBytes(chunks);\n}\n\nfunction decodeQueryBytes(bytes: string): Uint8Array {\n  if (typeof bytes !== 'string' || bytes.length === 0) {\n    throw new QueryHubStateError('PROXY_RESPONSE_INVALID', 'Missing query response bytes');\n  }\n\n  // Query Proxy commonly returns a 0x-prefixed hex string.\n  if (isValidHexString(bytes)) {\n    return hexToUint8Array(bytes);\n  }\n\n  // Fallback: attempt base64 decoding.\n  try {\n    if (typeof atob === 'function') {\n      const raw = atob(bytes);\n      const arr = new Uint8Array(raw.length);\n      for (let i = 0; i < raw.length; i++) arr[i] = raw.charCodeAt(i);\n      return arr;\n    }\n  } catch {\n    // ignore\n  }\n\n  try {\n    return new Uint8Array(Buffer.from(bytes, 'base64'));\n  } catch (cause) {\n    throw new QueryHubStateError('PROXY_RESPONSE_INVALID', 'Unrecognized query response bytes encoding', cause);\n  }\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\nasync function withExponentialBackoff<T>(\n  fn: () => Promise<T>,\n  maxAttempts: number\n): Promise<T> {\n  let attempt = 0;\n  let lastError: unknown;\n\n  while (attempt < maxAttempts) {\n    try {\n      return await fn();\n    } catch (err) {\n      lastError = err;\n      attempt += 1;\n      if (attempt >= maxAttempts) break;\n\n      const baseMs = 250;\n      const backoffMs = Math.min(5_000, baseMs * 2 ** (attempt - 1));\n      const jitterMs = Math.floor(Math.random() * 100);\n      await sleep(backoffMs + jitterMs);\n    }\n  }\n\n  throw lastError;\n}\n\nfunction getHubConfig(network: QueryHubStateNetwork): {\n  wormholeChainId: number;\n  hubAddress: string;\n  endpoint: string;\n  rpcUrl: string;\n} {\n  if (network === 'testnet') {\n    const baseSepolia = TESTNET_CHAINS.baseSepolia;\n    if (!baseSepolia?.contracts?.hub) {\n      throw new QueryHubStateError('MISSING_HUB_ADDRESS', 'Missing Base Sepolia hub address in SDK constants');\n    }\n\n    return {\n      wormholeChainId: baseSepolia.wormholeChainId,\n      hubAddress: baseSepolia.contracts.hub,\n      endpoint: WORMHOLE_QUERY_PROXY_URLS.testnet,\n      rpcUrl: baseSepolia.rpcUrl,\n    };\n  }\n\n  if (network === 'mainnet') {\n    const base = MAINNET_CHAINS.base;\n    const hubAddress = (base?.contracts as any)?.hub as string | undefined;\n\n    if (!hubAddress) {\n      throw new QueryHubStateError(\n        'MISSING_HUB_ADDRESS',\n        'Missing mainnet hub address in SDK constants (MAINNET_CHAINS.base.contracts.hub)'\n      );\n    }\n\n    return {\n      wormholeChainId: base.wormholeChainId,\n      hubAddress,\n      endpoint: WORMHOLE_QUERY_PROXY_URLS.mainnet,\n      rpcUrl: base.rpcUrl,\n    };\n  }\n\n  throw new QueryHubStateError('UNSUPPORTED_NETWORK', `Unsupported network: ${network}`);\n}\n\nfunction encodeHubCalls(hubAddress: string, userKeyHash: string): { to: string; data: string }[] {\n  // Support both the spec name and known on-chain variants.\n  const nonceAbiCandidates = [\n    'function getUserNonce(bytes32 userKeyHash) view returns (uint256)',\n    'function userNonces(bytes32 userKeyHash) view returns (uint256)',\n    'function getNonceByHash(bytes32 userKeyHash) view returns (uint256)',\n  ];\n\n  const registeredAbiCandidates = [\n    'function registeredKeys(bytes32 userKeyHash) view returns (bool)',\n    'function isKeyRegisteredByHash(bytes32 userKeyHash) view returns (bool)',\n  ];\n\n  // Issue #9/#10: Add getUserLastActionHash for action-hash binding\n  const actionHashAbiCandidates = [\n    'function getUserLastActionHash(bytes32 userKeyHash) view returns (bytes32)',\n    'function userLastActionHash(bytes32 userKeyHash) view returns (bytes32)',\n  ];\n\n  // We encode *all* candidates; the proxy will execute each call, and we decode the first successful one.\n  // This makes the client resilient to Hub ABI differences across deployments.\n  const iface = new ethers.Interface([\n    ...nonceAbiCandidates,\n    ...registeredAbiCandidates,\n    ...actionHashAbiCandidates,\n  ]);\n\n  const nonceFnNames = ['getUserNonce', 'userNonces', 'getNonceByHash'] as const;\n  const regFnNames = ['registeredKeys', 'isKeyRegisteredByHash'] as const;\n  const actionHashFnNames = ['getUserLastActionHash', 'userLastActionHash'] as const;\n\n  return [\n    ...nonceFnNames.map((fn) => ({\n      to: hubAddress,\n      data: iface.encodeFunctionData(fn, [userKeyHash]),\n    })),\n    ...regFnNames.map((fn) => ({\n      to: hubAddress,\n      data: iface.encodeFunctionData(fn, [userKeyHash]),\n    })),\n    ...actionHashFnNames.map((fn) => ({\n      to: hubAddress,\n      data: iface.encodeFunctionData(fn, [userKeyHash]),\n    })),\n  ];\n}\n\nfunction decodeFirstNonce(results: string[]): bigint {\n  const candidates = [\n    'function getUserNonce(bytes32 userKeyHash) view returns (uint256)',\n    'function userNonces(bytes32 userKeyHash) view returns (uint256)',\n    'function getNonceByHash(bytes32 userKeyHash) view returns (uint256)',\n  ];\n  const iface = new ethers.Interface(candidates);\n  const fnNames = ['getUserNonce', 'userNonces', 'getNonceByHash'] as const;\n\n  for (let idx = 0; idx < fnNames.length; idx++) {\n    const fnName = fnNames[idx];\n    try {\n      const data = results[idx];\n      if (!data || data === '0x') continue;\n      const decoded = iface.decodeFunctionResult(fnName, data);\n      return decoded[0] as bigint;\n    } catch {\n      // keep trying\n    }\n  }\n\n  throw new QueryHubStateError('QUERY_RESPONSE_INVALID', 'Unable to decode user nonce from query response');\n}\n\nfunction decodeFirstIsRegistered(results: string[]): boolean {\n  const nonceCandidateCount = 3;\n  const candidates = [\n    'function registeredKeys(bytes32 userKeyHash) view returns (bool)',\n    'function isKeyRegisteredByHash(bytes32 userKeyHash) view returns (bool)',\n  ];\n  const iface = new ethers.Interface(candidates);\n  const fnNames = ['registeredKeys', 'isKeyRegisteredByHash'] as const;\n\n  for (let i = 0; i < fnNames.length; i++) {\n    const fnName = fnNames[i];\n    try {\n      const data = results[nonceCandidateCount + i];\n      if (!data || data === '0x') continue;\n      const decoded = iface.decodeFunctionResult(fnName, data);\n      return Boolean(decoded[0]);\n    } catch {\n      // keep trying\n    }\n  }\n\n  // If the hub deployment doesn’t support registration, treat as false.\n  return false;\n}\n\n/** * Decode last action hash from query results (Issue #9/#10)\n * Returns zero hash if not available (backwards compatibility)\n */\nfunction decodeLastActionHash(results: string[]): string {\n  const nonceCandidateCount = 3;\n  const registeredCandidateCount = 2;\n  const actionHashOffset = nonceCandidateCount + registeredCandidateCount;\n\n  const candidates = [\n    'function getUserLastActionHash(bytes32 userKeyHash) view returns (bytes32)',\n    'function userLastActionHash(bytes32 userKeyHash) view returns (bytes32)',\n  ];\n  const iface = new ethers.Interface(candidates);\n  const fnNames = ['getUserLastActionHash', 'userLastActionHash'] as const;\n\n  for (let i = 0; i < fnNames.length; i++) {\n    const fnName = fnNames[i];\n    try {\n      const data = results[actionHashOffset + i];\n      if (!data || data === '0x') continue;\n      const decoded = iface.decodeFunctionResult(fnName, data);\n      return decoded[0] as string;\n    } catch {\n      // keep trying\n    }\n  }\n\n  // Backwards compatibility: return zero hash if not available\n  return ethers.ZeroHash;\n}\n\n/** * Fetch Guardian-attested Hub state directly from the Wormhole Query Proxy.\n *\n * Client-side only: this avoids relayer API costs and produces a Guardian-signed proof\n * that can be forwarded to the relayer for on-chain verification/submission.\n */\nexport async function queryHubState(\n  userKeyHash: string,\n  apiKey: string,\n  options?: QueryHubStateOptions\n): Promise<HubStateResult> {\n  if (typeof userKeyHash !== 'string' || userKeyHash.length === 0) {\n    throw new QueryHubStateError('INVALID_ARGUMENT', 'userKeyHash is required');\n  }\n  if (!isValidHexString(userKeyHash) || hexToUint8Array(userKeyHash).length !== 32) {\n    throw new QueryHubStateError('INVALID_ARGUMENT', 'userKeyHash must be a 32-byte hex string');\n  }\n  if (typeof apiKey !== 'string' || apiKey.length === 0) {\n    throw new QueryHubStateError('INVALID_ARGUMENT', 'apiKey is required');\n  }\n\n  const network = resolveNetwork(options);\n  const maxAgeSeconds = options?.maxAge ?? 60;\n  const maxAttempts = options?.maxAttempts ?? 4;\n\n  const { wormholeChainId, hubAddress, endpoint, rpcUrl } = getHubConfig(network);\n\n  const provider = new ethers.JsonRpcProvider(rpcUrl);\n\n  const callData = encodeHubCalls(hubAddress, userKeyHash);\n\n  const doFetch = async () => {\n    try {\n      const latestBlock = await provider.getBlockNumber();\n      const blockTag = Math.max(0, latestBlock - 2);\n\n      const request = new QueryRequest(Date.now() & 0xffffffff, [\n        new PerChainQueryRequest(wormholeChainId, new EthCallQueryRequest(blockTag, callData)),\n      ]);\n\n      // Wormhole Query Proxy expects raw hex WITHOUT 0x prefix\n      const requestHex = Buffer.from(request.serialize()).toString('hex');\n\n      const response = await axios.post(\n        endpoint,\n        { bytes: requestHex },\n        {\n          headers: {\n            'X-API-Key': apiKey,\n            'Content-Type': 'application/json',\n          },\n          timeout: 10_000,\n        }\n      );\n\n      const data = response.data as any;\n      const signatures = data?.signatures as string[] | undefined;\n      const bytes = data?.bytes as string | undefined;\n\n      if (!Array.isArray(signatures) || typeof bytes !== 'string') {\n        throw new QueryHubStateError('PROXY_RESPONSE_INVALID', 'Query Proxy response missing signatures/bytes');\n      }\n\n      const proof = signaturesToProofBytes(signatures);\n      const queryBytes = decodeQueryBytes(bytes);\n      const parsed = QueryResponse.from(queryBytes);\n\n      const perChain = parsed.responses.find((r) => r.chainId === wormholeChainId);\n      if (!perChain) {\n        throw new QueryHubStateError('QUERY_RESPONSE_INVALID', 'Missing per-chain response for hub chain');\n      }\n\n      // The SDK provides a parser for the chain-specific response.\n      const chainResp = EthCallQueryResponse.from(perChain.response.serialize());\n      const blockTime = Number(chainResp.blockTime);\n\n      const nowSeconds = Math.floor(Date.now() / 1000);\n      if (nowSeconds - blockTime > maxAgeSeconds) {\n        throw new QueryHubStateError(\n          'ATTESTATION_STALE',\n          `Guardian attestation is stale (blockTime=${blockTime}, now=${nowSeconds}, maxAge=${maxAgeSeconds}s)`\n        );\n      }\n\n      const nonce = decodeFirstNonce(chainResp.results);\n      const isRegistered = decodeFirstIsRegistered(chainResp.results);\n      const lastActionHash = decodeLastActionHash(chainResp.results);\n\n      return {\n        nonce,\n        isRegistered,\n        blockTime,\n        proof,\n        lastActionHash,\n      } satisfies HubStateResult;\n    } catch (err) {\n      if (err instanceof QueryHubStateError) throw err;\n      if (axios.isAxiosError(err)) {\n        const ax = err as AxiosError;\n        const status = ax.response?.status;\n        const statusText = ax.response?.statusText;\n        const details = typeof ax.response?.data === 'string' ? ax.response?.data : undefined;\n\n        throw new QueryHubStateError(\n          'PROXY_HTTP_ERROR',\n          `Query Proxy request failed${status ? ` (${status} ${statusText ?? ''})` : ''}${details ? `: ${details}` : ''}`,\n          err\n        );\n      }\n\n      throw new QueryHubStateError('PROXY_HTTP_ERROR', 'Query Proxy request failed', err);\n    }\n  };\n\n  return await withExponentialBackoff(doFetch, maxAttempts);\n}\n"],"mappings":"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","names":[]}

package/dist/{types-DP2CQT8p.d.mts → types-CdlEbixV.d.mts}

@@ -17,6 +17,8 @@ interface VeridexConfig {
      * API key for relayer service authentication
      */
     relayerApiKey?: string;
+    /** Locally trusted v3 destination metadata, keyed by transport chain ID. */
+    dispatchDestinations?: Record<number, DispatchDestinationV3>;
     /**
      * API key for Wormhole Query Proxy requests (optional).
      * If omitted, the SDK will fall back to `relayerApiKey` for Queries.
@@ -42,6 +44,8 @@ interface VeridexConfig {
      * Allows platforms to pay for their users' vault creation
      */
     integratorSponsorKey?: string;
+    /** @deprecated Enables legacy in-process raw private-key sponsorship. Prefer relayerUrl. */
+    allowLegacyPrivateKeyFallback?: boolean;
     /**
      * Additional chain RPC URLs for multi-chain sponsored vault creation
      * Maps Wormhole chain ID to RPC URL
@@ -53,6 +57,12 @@ interface VeridexConfig {
      */
     preparedTransferTtl?: number;
 }
+interface DispatchDestinationV3 {
+    targetChain: number;
+    veridexChainId: number;
+    executor: string;
+    minTier: number;
+}
 interface WalletManagerConfig {
     /**
      * Whether to cache computed addresses in memory
@@ -181,6 +191,7 @@ interface PasskeyCredential {
     publicKeyX: bigint;
     publicKeyY: bigint;
     keyHash: string;
+    assurance?: any;
 }
 interface WebAuthnSignature {
     authenticatorData: string;
@@ -573,4 +584,4 @@ interface BridgeResult extends DispatchResult {
     timestamp: number;
 }
 
-export type { AuthorizedKey as A, BridgeParams as B, ChainClient as C, DispatchResult as D, ExecuteParams as E, IdentityState as I, PasskeyCredential as P, ReceiveAddress as R, SessionValidationResult as S, TransferParams as T, UnifiedIdentity as U, VaultCreationResult as V, WebAuthnSignature as W, ChainConfig as a, WalletManagerConfig as b, ChainAddress as c, VAA as d, VeridexPayload as e, PreparedTransfer as f, PreparedBridge as g, VeridexConfig as h, BridgeResult as i, TransferResult as j, VaultInfo as k, AddBackupKeyResult as l, RemoveKeyResult as m, ConfigParams as n, TransferAction as o, BridgeAction as p, ExecuteAction as q, ConfigAction as r, ActionPayload as s, VAASignature as t, TestResult as u, TransactionHistoryEntry as v, CrossChainFees as w, RegisterSessionParams as x, RevokeSessionParams as y };
+export type { AuthorizedKey as A, BridgeParams as B, ChainClient as C, DispatchDestinationV3 as D, ExecuteParams as E, IdentityState as I, PasskeyCredential as P, ReceiveAddress as R, SessionValidationResult as S, TransferParams as T, UnifiedIdentity as U, VaultCreationResult as V, WebAuthnSignature as W, ChainConfig as a, DispatchResult as b, WalletManagerConfig as c, ChainAddress as d, VAA as e, VeridexPayload as f, PreparedTransfer as g, PreparedBridge as h, VeridexConfig as i, BridgeResult as j, TransferResult as k, VaultInfo as l, AddBackupKeyResult as m, RemoveKeyResult as n, ConfigParams as o, TransferAction as p, BridgeAction as q, ExecuteAction as r, ConfigAction as s, ActionPayload as t, VAASignature as u, TestResult as v, TransactionHistoryEntry as w, CrossChainFees as x, RegisterSessionParams as y, RevokeSessionParams as z };

package/dist/types.d.mts

@@ -44,6 +44,7 @@ interface PasskeyCredential {
     publicKeyX: bigint;
     publicKeyY: bigint;
     keyHash: string;
+    assurance?: any;
 }
 interface WebAuthnSignature {
     authenticatorData: string;

package/dist/types.js.map

@@ -1 +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    /** Wormhole guardian signature verifier (Stacks Phase 2) */\n    wormholeVerifier?: string;\n    /** VAA-authorized vault for cross-chain transfers (Stacks Phase 2) */\n    vaultVaa?: string;\n    /** Agent marketplace contract (Monad Agent Gateway) */\n    serviceDirectory?: string;\n    /** ACP-204 P-256 verifier wrapper (Avalanche) */\n    p256Verifier?: string;\n    /** ICM Spoke for cross-L1 session bridging (Avalanche Teleporter) */\n    icmSpoke?: string;\n    /** Chainlink AVAX/USD price feed (Avalanche) */\n    chainlinkAvaxUsd?: string;\n    /** Chainlink USDC/USD price feed (Avalanche) */\n    chainlinkUsdcUsd?: string;\n    /** Chainlink USDT/USD price feed (Avalanche) */\n    chainlinkUsdtUsd?: 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":[]}
+{"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    /** Wormhole guardian signature verifier (Stacks Phase 2) */\n    wormholeVerifier?: string;\n    /** VAA-authorized vault for cross-chain transfers (Stacks Phase 2) */\n    vaultVaa?: string;\n    /** Agent marketplace contract (Monad Agent Gateway) */\n    serviceDirectory?: string;\n    /** ACP-204 P-256 verifier wrapper (Avalanche) */\n    p256Verifier?: string;\n    /** ICM Spoke for cross-L1 session bridging (Avalanche Teleporter) */\n    icmSpoke?: string;\n    /** Chainlink AVAX/USD price feed (Avalanche) */\n    chainlinkAvaxUsd?: string;\n    /** Chainlink USDC/USD price feed (Avalanche) */\n    chainlinkUsdcUsd?: string;\n    /** Chainlink USDT/USD price feed (Avalanche) */\n    chainlinkUsdtUsd?: 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  assurance?: any;\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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veridex/sdk",
-  "version": "1.1.5",
+  "version": "1.1.7",
   "description": "Veridex Protocol SDK - Client library for Passkey-based cross-chain authentication",
   "author": "Veridex Protocol <team@veridex.network>",
   "license": "MIT",
@@ -108,6 +108,11 @@
       "types": "./dist/auth/prepareAuth.d.ts",
       "import": "./dist/auth/prepareAuth.mjs",
       "require": "./dist/auth/prepareAuth.js"
+    },
+    "./platform": {
+      "types": "./dist/platform/index.d.ts",
+      "import": "./dist/platform/index.mjs",
+      "require": "./dist/platform/index.js"
     }
   },
   "scripts": {
@@ -133,6 +138,7 @@
     "@solana/web3.js": "^1.95.4",
     "@wormhole-foundation/sdk": "^0.10.0",
     "@wormhole-foundation/wormhole-query-sdk": "^0.0.14",
+    "@veridex/platform-events": "0.1.0",
     "axios": "^1.7.9",
     "ethers": "^6.11.1",
     "js-sha3": "^0.9.3",

package/dist/chunk-72ZA3OYQ.mjs

@@ -1,20 +0,0 @@
-// src/queries/constants.ts
-var WORMHOLE_QUERY_PROXY_URLS = {
-  mainnet: "https://query.wormhole.com/v1/query",
-  testnet: "https://testnet.query.wormhole.com/v1/query"
-};
-var WORMHOLE_QUERY_RATE_LIMIT_PER_SECOND = 6;
-var WORMHOLE_QUERY_CHAIN_IDS = {
-  ETHEREUM: 2,
-  POLYGON: 5,
-  ARBITRUM: 23,
-  OPTIMISM: 24,
-  BASE: 30
-};
-
-export {
-  WORMHOLE_QUERY_PROXY_URLS,
-  WORMHOLE_QUERY_RATE_LIMIT_PER_SECOND,
-  WORMHOLE_QUERY_CHAIN_IDS
-};
-//# sourceMappingURL=chunk-72ZA3OYQ.mjs.map

package/dist/chunk-72ZA3OYQ.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/queries/constants.ts"],"sourcesContent":["export const WORMHOLE_QUERY_PROXY_URLS = {\n  mainnet: 'https://query.wormhole.com/v1/query',\n  testnet: 'https://testnet.query.wormhole.com/v1/query',\n} as const;\n\n/**\n * Wormhole Query Proxy rate limit: 6 queries per second.\n * SDK callers should throttle requests accordingly.\n */\nexport const WORMHOLE_QUERY_RATE_LIMIT_PER_SECOND = 6;\n\n/**\n * Convenience set of Wormhole chain IDs commonly supported by Queries.\n * This is not an exhaustive list of all Wormhole chains.\n */\nexport const WORMHOLE_QUERY_CHAIN_IDS = {\n  ETHEREUM: 2,\n  POLYGON: 5,\n  ARBITRUM: 23,\n  OPTIMISM: 24,\n  BASE: 30,\n} as const;\n"],"mappings":";AAAO,IAAM,4BAA4B;AAAA,EACvC,SAAS;AAAA,EACT,SAAS;AACX;AAMO,IAAM,uCAAuC;AAM7C,IAAM,2BAA2B;AAAA,EACtC,UAAU;AAAA,EACV,SAAS;AAAA,EACT,UAAU;AAAA,EACV,UAAU;AAAA,EACV,MAAM;AACR;","names":[]}