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

package/README.md

@@ -1,5 +1,8 @@
 # @veridex/sdk
 
+[![npm version](https://img.shields.io/npm/v/@veridex/sdk.svg)](https://www.npmjs.com/package/@veridex/sdk)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
 Veridex Protocol SDK - Client library for **Passkey-based cross-chain authentication**.
 
 Build applications with WebAuthn/Passkeys (P-256) that work across EVM, Solana, Aptos, Sui, and Starknet.

package/dist/index.d.mts

@@ -1881,6 +1881,24 @@ declare class VeridexSDK {
      * @returns The deterministic vault address
      */
     getVaultAddressForKeyHash(keyHash: string): string;
+    /**
+     * Get the vault address for a specific chain
+     * Each EVM chain has its own factory contract, so vault addresses are chain-specific.
+     *
+     * @param wormholeChainId - The Wormhole chain ID
+     * @param keyHash - Optional key hash (defaults to current credential)
+     * @returns The deterministic vault address for that chain, or null if chain not supported
+     */
+    getVaultAddressForChain(wormholeChainId: number, keyHash?: string): string | null;
+    /**
+     * Get vault balances for a specific chain
+     * Unlike getVaultBalances() which uses the hub chain, this fetches for any EVM chain.
+     *
+     * @param wormholeChainId - The Wormhole chain ID
+     * @param includeZeroBalances - Whether to include tokens with 0 balance
+     * @returns PortfolioBalance with all token balances for that chain
+     */
+    getVaultBalancesForChain(wormholeChainId: number, includeZeroBalances?: boolean): Promise<PortfolioBalance>;
     /**
      * Get unified identity with addresses across chains
      *
@@ -2635,6 +2653,10 @@ declare class RelayerClient {
      * Get relay history for a user
      */
     getRelayHistory(userKeyHash: string, limit?: number, offset?: number): Promise<RelayRequest[]>;
+    /**
+     * SDK version for telemetry
+     */
+    private static readonly SDK_VERSION;
     /**
      * Make an HTTP request to the relayer
      */

package/dist/index.d.ts

@@ -1881,6 +1881,24 @@ declare class VeridexSDK {
      * @returns The deterministic vault address
      */
     getVaultAddressForKeyHash(keyHash: string): string;
+    /**
+     * Get the vault address for a specific chain
+     * Each EVM chain has its own factory contract, so vault addresses are chain-specific.
+     *
+     * @param wormholeChainId - The Wormhole chain ID
+     * @param keyHash - Optional key hash (defaults to current credential)
+     * @returns The deterministic vault address for that chain, or null if chain not supported
+     */
+    getVaultAddressForChain(wormholeChainId: number, keyHash?: string): string | null;
+    /**
+     * Get vault balances for a specific chain
+     * Unlike getVaultBalances() which uses the hub chain, this fetches for any EVM chain.
+     *
+     * @param wormholeChainId - The Wormhole chain ID
+     * @param includeZeroBalances - Whether to include tokens with 0 balance
+     * @returns PortfolioBalance with all token balances for that chain
+     */
+    getVaultBalancesForChain(wormholeChainId: number, includeZeroBalances?: boolean): Promise<PortfolioBalance>;
     /**
      * Get unified identity with addresses across chains
      *
@@ -2635,6 +2653,10 @@ declare class RelayerClient {
      * Get relay history for a user
      */
     getRelayHistory(userKeyHash: string, limit?: number, offset?: number): Promise<RelayRequest[]>;
+    /**
+     * SDK version for telemetry
+     */
+    private static readonly SDK_VERSION;
     /**
      * Make an HTTP request to the relayer
      */

package/dist/index.js

@@ -2984,7 +2984,7 @@ var DEFAULT_CONFIG2 = {
   timeoutMs: 3e4,
   maxRetries: 3
 };
-var RelayerClient = class {
+var RelayerClient = class _RelayerClient {
   baseUrl;
   config;
   constructor(config) {
@@ -3208,12 +3208,17 @@ var RelayerClient = class {
   // ========================================================================
   // Internal Helpers
   // ========================================================================
+  /**
+   * SDK version for telemetry
+   */
+  static SDK_VERSION = "1.0.0-beta.1";
   /**
    * Make an HTTP request to the relayer
    */
   async fetch(path, options = {}) {
     const headers = {
       "Content-Type": "application/json",
+      "User-Agent": `@veridex/sdk/${_RelayerClient.SDK_VERSION}`,
       ...options.headers || {}
     };
     if (this.config.apiKey) {
@@ -9242,6 +9247,93 @@ var VeridexSDK = class {
   getVaultAddressForKeyHash(keyHash) {
     return this.chain.computeVaultAddress(keyHash);
   }
+  /**
+   * Get the vault address for a specific chain
+   * Each EVM chain has its own factory contract, so vault addresses are chain-specific.
+   * 
+   * @param wormholeChainId - The Wormhole chain ID
+   * @param keyHash - Optional key hash (defaults to current credential)
+   * @returns The deterministic vault address for that chain, or null if chain not supported
+   */
+  getVaultAddressForChain(wormholeChainId, keyHash) {
+    const hash = keyHash ?? this.passkey.getCredential()?.keyHash;
+    if (!hash) {
+      throw new Error("No credential set and no keyHash provided");
+    }
+    const credential = { keyHash: hash };
+    const derived = this.chainDetector.deriveVaultAddress(credential, wormholeChainId);
+    return derived?.address ?? null;
+  }
+  /**
+   * Get vault balances for a specific chain
+   * Unlike getVaultBalances() which uses the hub chain, this fetches for any EVM chain.
+   * 
+   * @param wormholeChainId - The Wormhole chain ID
+   * @param includeZeroBalances - Whether to include tokens with 0 balance
+   * @returns PortfolioBalance with all token balances for that chain
+   */
+  async getVaultBalancesForChain(wormholeChainId, includeZeroBalances = false) {
+    const credential = this.passkey.getCredential();
+    if (!credential) {
+      throw new Error("No credential set");
+    }
+    const vaultAddress = this.getVaultAddressForChain(wormholeChainId, credential.keyHash);
+    if (!vaultAddress) {
+      throw new Error(`Cannot derive vault address for chain ${wormholeChainId}`);
+    }
+    const chainConfig = this.chainDetector.getChainConfig(wormholeChainId);
+    if (!chainConfig) {
+      throw new Error(`Unknown chain ${wormholeChainId}`);
+    }
+    if (this.queryApiKey) {
+      try {
+        const tokenList = getAllTokens(wormholeChainId);
+        const erc20Tokens = tokenList.filter((t) => !isNativeToken(t.address)).map((t) => t.address);
+        const rpcUrl = this.chainRpcUrls?.[wormholeChainId] ?? chainConfig.rpcUrl;
+        const result = await queryPortfolio(credential.keyHash, this.queryApiKey, {
+          network: this.testnet ? "testnet" : "mainnet",
+          vaultAddresses: { [wormholeChainId]: vaultAddress },
+          evmTokenAddresses: { [wormholeChainId]: erc20Tokens },
+          rpcUrls: { [wormholeChainId]: rpcUrl },
+          maxAge: 60,
+          timeout: this.testnet ? 15e3 : 1e4,
+          maxAttempts: this.testnet ? 3 : 2
+        });
+        const chain = result.chains.find((c) => c.wormholeChainId === wormholeChainId);
+        if (chain && !chain.error) {
+          const byAssetId = new Map(chain.balances.map((b) => [b.assetId.toLowerCase(), b]));
+          const tokens = tokenList.map((t) => {
+            if (isNativeToken(t.address)) {
+              return null;
+            }
+            const found = byAssetId.get(t.address.toLowerCase());
+            const amount = found?.amount ?? 0n;
+            const formatted = import_ethers15.ethers.formatUnits(amount, t.decimals);
+            return {
+              token: t,
+              balance: amount,
+              formatted,
+              usdValue: found?.usdValue
+            };
+          }).filter((t) => !!t);
+          const native = await this.balance.getNativeBalance(wormholeChainId, vaultAddress);
+          const merged = [native, ...tokens];
+          const filtered = includeZeroBalances ? merged : merged.filter((t) => t.balance > 0n);
+          const totalUsdValue = filtered.reduce((sum, t) => sum + (t.usdValue ?? 0), 0);
+          return {
+            wormholeChainId,
+            chainName: chainConfig.name,
+            address: vaultAddress,
+            tokens: filtered,
+            totalUsdValue: totalUsdValue || void 0,
+            lastUpdated: Date.now()
+          };
+        }
+      } catch {
+      }
+    }
+    return await this.balance.getPortfolioBalance(wormholeChainId, vaultAddress, includeZeroBalances);
+  }
   /**
    * Get unified identity with addresses across chains
    *