@voidaisdk/bridge-sdk 0.0.2 → 0.0.4

package/README.md

@@ -41,8 +41,8 @@ pnpm add voidai-sdk
 import { BridgeSDK } from 'voidai-sdk';
 
 const sdk = new BridgeSDK({
-  apiKey: process.env.VOIDAI_API_KEY!,
-  environment: 'testnet', // 'devnet' | 'testnet' | 'mainnet'
+    apiKey: process.env.VOIDAI_API_KEY!,
+    environment: 'testnet', // 'devnet' | 'testnet' | 'mainnet'
 });
 
 // Wait for authentication & API key validation
@@ -56,8 +56,8 @@ await sdk.ready;
 ```typescript
 // Get all active chains
 const chains = await sdk.api.getSupportedChains({
-  isActive: true,
-  isCcipSupported: true,
+    isActive: true,
+    isCcipSupported: true,
 });
 
 // Get assets (optionally filtered by chain)
@@ -85,29 +85,31 @@ console.log('Connected:', solanaAccount.address);
 ```typescript
 // Bridge TAO from Bittensor to Ethereum
 const result = await sdk.bridge.bridge({
-  fromWallet: '5DqAEsZi...', // Bittensor address
-  toWallet: '0x742d35...',    // Ethereum address
-  fromToken: 'tao',
-  toToken: 'wtao',
-  fromChain: 'BITTENSOR',
-  toChain: 'ETHEREUM_SEPOLIA',
-  amount: 1.0,
+    fromWallet: '5DqAEsZi...', // Bittensor address
+    toWallet: '0x742d35...', // Ethereum address
+    fromToken: 'tao',
+    toToken: 'wtao',
+    fromChain: 'BITTENSOR',
+    toChain: 'ETHEREUM_SEPOLIA',
+    amount: 1.0,
 });
 
 console.log('Bridge identifier:', result.identifier);
 
 // For EVM burn flows (wTAO → TAO), use the pre-built transaction
 if (result.evmTransaction) {
-  const txHash = await window.ethereum.request({
-    method: 'eth_sendTransaction',
-    params: [{
-      from: ethAccount.address,
-      to: result.evmTransaction.to,
-      data: result.evmTransaction.data,
-      value: result.evmTransaction.value,
-    }],
-  });
-  console.log('Transaction sent:', txHash);
+    const txHash = await window.ethereum.request({
+        method: 'eth_sendTransaction',
+        params: [
+            {
+                from: ethAccount.address,
+                to: result.evmTransaction.to,
+                data: result.evmTransaction.data,
+                value: result.evmTransaction.value,
+            },
+        ],
+    });
+    console.log('Transaction sent:', txHash);
 }
 ```
 
@@ -115,25 +117,27 @@ if (result.evmTransaction) {
 
 ```typescript
 const route = await sdk.bridge.routeSwap({
-  operationType: 'SWAP',
-  originAssetId: 1,
-  destinationAssetId: 2,
-  fromAddress: '0xSource...',
-  toAddress: '0xDestination...',
-  amount: 0.5,
+    operationType: 'SWAP',
+    originAssetId: 1,
+    destinationAssetId: 2,
+    fromAddress: '0xSource...',
+    toAddress: '0xDestination...',
+    amount: 0.5,
 });
 
 if (route.success && route.data) {
-  // Execute via MetaMask
-  await window.ethereum.request({
-    method: 'eth_sendTransaction',
-    params: [{
-      from: '0xSource...',
-      to: route.data.to,
-      data: route.data.data,
-      value: route.data.value,
-    }],
-  });
+    // Execute via MetaMask
+    await window.ethereum.request({
+        method: 'eth_sendTransaction',
+        params: [
+            {
+                from: '0xSource...',
+                to: route.data.to,
+                data: route.data.data,
+                value: route.data.value,
+            },
+        ],
+    });
 }
 ```
 
@@ -142,9 +146,9 @@ if (route.success && route.data) {
 ```typescript
 // Bridge fee estimate
 const bridgeFee = await sdk.bridge.getBridgeFeeEstimate({
-  fromToken: 'tao',
-  toToken: 'wtao',
-  amount: 2.5,
+    fromToken: 'tao',
+    toToken: 'wtao',
+    amount: 2.5,
 });
 
 console.log('Bridge fee:', bridgeFee.data.fee);
@@ -152,11 +156,11 @@ console.log('Recipient will receive:', bridgeFee.data.recipientAmount);
 
 // Router swap fee estimate
 const swapFee = await sdk.bridge.getRouterSwapFeeEstimate({
-  originAssetId: 1,
-  destinationAssetId: 2,
-  amount: 0.75,
-  operationType: 'SWAP',
-  toAddress: '0xDestination...',
+    originAssetId: 1,
+    destinationAssetId: 2,
+    amount: 0.75,
+    operationType: 'SWAP',
+    toAddress: '0xDestination...',
 });
 
 console.log('Total fee:', swapFee.totalFee);
@@ -176,6 +180,7 @@ console.log('Total fee:', swapFee.totalFee);
 ## 💡 Key Features
 
 ### ✅ Multi-Chain Support
+
 - **Bittensor** (TAO, Alpha)
 - **Ethereum** (Mainnet, Sepolia)
 - **Base** (Mainnet, Sepolia)
@@ -183,26 +188,31 @@ console.log('Total fee:', swapFee.totalFee);
 - More chains added regularly
 
 ### ✅ Wallet Integration
+
 - **Bittensor**: Talisman, Subwallet, Polkadot.js
 - **Ethereum**: MetaMask
 - **Solana**: Phantom
 
 ### ✅ Bridge Operations
+
 - TAO ↔ wTAO (Bittensor ↔ Ethereum)
 - Alpha ↔ wAlpha
 - Cross-chain asset transfers
 - Automatic EVM transaction building for burn operations
 
 ### ✅ Routing & Swaps
+
 - Unified route-transaction API
 - SWAP, BRIDGE, and CCIP operations
 - Fee estimation before execution
 
 ### ✅ Frontend vs Backend
+
 - **BridgeSDK** – Frontend usage (apiKey only, no secretKey)
 - **BridgeSDKServer** – Backend usage (apiKey + secretKey for JWT auth, no wallets)
 
 ### ✅ Production Ready
+
 - TypeScript-first with full type definitions
 - Automatic JWT refresh on token expiry
 - Normalized error messages
@@ -217,16 +227,18 @@ For server-side or backend integrations, use `BridgeSDKServer` with both `apiKey
 import { BridgeSDKServer } from 'voidai-sdk';
 
 const sdk = new BridgeSDKServer({
-  apiKey: process.env.VOIDAI_API_KEY!,
-  secretKey: process.env.VOIDAI_SECRET_KEY!,
-  environment: 'production',
+    apiKey: process.env.VOIDAI_API_KEY!,
+    secretKey: process.env.VOIDAI_SECRET_KEY!,
+    environment: 'production',
 });
 
 await sdk.ready;
 
 // Same bridge/api API, no wallets
 const chains = await sdk.api.getSupportedChains();
-const result = await sdk.bridge.bridge({ /* ... */ });
+const result = await sdk.bridge.bridge({
+    /* ... */
+});
 ```
 
 `BridgeSDKServer` exposes `config`, `api`, `bridge`, and `ready` – no `wallets` (use `BridgeSDK` in frontend for that).
@@ -235,11 +247,11 @@ const result = await sdk.bridge.bridge({ /* ... */ });
 
 The SDK supports three environments:
 
-| Environment   | Base URL                                      | Use Case              |
-|---------------|-----------------------------------------------|-----------------------|
-| `development` | `http://localhost:3003`                       | Local development     |
-| `staging`     | `https://api-staging.voidai.envistudios.com` | Testing & QA          |
-| `production`  | `https://api.voidai.envistudios.com`          | Live applications     |
+| Environment   | Base URL                                     | Use Case          |
+| ------------- | -------------------------------------------- | ----------------- |
+| `development` | `http://localhost:3003`                      | Local development |
+| `staging`     | `https://api-staging.voidai.envistudios.com` | Testing & QA      |
+| `production`  | `https://api.voidai.envistudios.com`         | Live applications |
 
 ## 📝 Example: Complete Bridge Flow
 
@@ -247,51 +259,53 @@ The SDK supports three environments:
 import { BridgeSDK } from 'voidai-sdk';
 
 async function bridgeTAO() {
-  // 1. Initialize SDK
-  const sdk = new BridgeSDK({
-    apiKey: process.env.VOIDAI_API_KEY!,
-    environment: 'staging',
-  });
-  
-  await sdk.ready;
+    // 1. Initialize SDK
+    const sdk = new BridgeSDK({
+        apiKey: process.env.VOIDAI_API_KEY!,
+        environment: 'staging',
+    });
 
-  // 2. Connect wallets
-  const bittensorAccount = await sdk.wallets.bittensor.connect();
-  const ethAccount = await sdk.wallets.ethereum.connect();
+    await sdk.ready;
 
-  // 3. Estimate fees
-  const fee = await sdk.bridge.getBridgeFeeEstimate({
-    fromToken: 'tao',
-    toToken: 'wtao',
-    amount: 1.0,
-  });
-  
-  console.log(`Fee: ${fee.data.fee}, You'll receive: ${fee.data.recipientAmount}`);
-
-  // 4. Execute bridge
-  const result = await sdk.bridge.bridge({
-    fromWallet: bittensorAccount.address,
-    toWallet: ethAccount.address,
-    fromToken: 'tao',
-    toToken: 'wtao',
-    fromChain: 'BITTENSOR',
-    toChain: 'ETHEREUM_SEPOLIA',
-    amount: 1.0,
-  });
+    // 2. Connect wallets
+    const bittensorAccount = await sdk.wallets.bittensor.connect();
+    const ethAccount = await sdk.wallets.ethereum.connect();
 
-  console.log('Bridge initiated:', result.identifier);
-  
-  // 5. Execute on-chain transaction (if EVM burn flow)
-  if (result.evmTransaction) {
-    const txHash = await window.ethereum.request({
-      method: 'eth_sendTransaction',
-      params: [{
-        from: ethAccount.address,
-        ...result.evmTransaction,
-      }],
+    // 3. Estimate fees
+    const fee = await sdk.bridge.getBridgeFeeEstimate({
+        fromToken: 'tao',
+        toToken: 'wtao',
+        amount: 1.0,
     });
-    console.log('On-chain tx:', txHash);
-  }
+
+    console.log(`Fee: ${fee.data.fee}, You'll receive: ${fee.data.recipientAmount}`);
+
+    // 4. Execute bridge
+    const result = await sdk.bridge.bridge({
+        fromWallet: bittensorAccount.address,
+        toWallet: ethAccount.address,
+        fromToken: 'tao',
+        toToken: 'wtao',
+        fromChain: 'BITTENSOR',
+        toChain: 'ETHEREUM_SEPOLIA',
+        amount: 1.0,
+    });
+
+    console.log('Bridge initiated:', result.identifier);
+
+    // 5. Execute on-chain transaction (if EVM burn flow)
+    if (result.evmTransaction) {
+        const txHash = await window.ethereum.request({
+            method: 'eth_sendTransaction',
+            params: [
+                {
+                    from: ethAccount.address,
+                    ...result.evmTransaction,
+                },
+            ],
+        });
+        console.log('On-chain tx:', txHash);
+    }
 }
 
 bridgeTAO().catch(console.error);
@@ -351,12 +365,12 @@ bridge-sdk/
 
 ```html
 <script type="module">
-  import { BridgeSDK } from './node_modules/voidai-sdk/dist-browser/voidai-sdk.js';
-  
-  const sdk = new BridgeSDK({
-    apiKey: 'your-api-key',
-    environment: 'staging',
-  });
+    import { BridgeSDK } from './node_modules/voidai-sdk/dist-browser/voidai-sdk.js';
+
+    const sdk = new BridgeSDK({
+        apiKey: 'your-api-key',
+        environment: 'staging',
+    });
 </script>
 ```
 
@@ -375,15 +389,17 @@ The SDK throws `Error` instances with user-friendly messages:
 
 ```typescript
 try {
-  await sdk.bridge.bridge({ /* ... */ });
+    await sdk.bridge.bridge({
+        /* ... */
+    });
 } catch (error) {
-  // error.message contains a clear, actionable message
-  console.error('Bridge failed:', error.message);
-  
-  // Common errors:
-  // - "Session expired or unauthorized..." → Check API key
-  // - "Failed to execute bridge swap" → Check parameters
-  // - "User rejected the connection request" → User cancelled wallet
+    // error.message contains a clear, actionable message
+    console.error('Bridge failed:', error.message);
+
+    // Common errors:
+    // - "Session expired or unauthorized..." → Check API key
+    // - "Failed to execute bridge swap" → Check parameters
+    // - "User rejected the connection request" → User cancelled wallet
 }
 ```
 

package/dist/api/client.d.ts

@@ -1,5 +1,6 @@
+import { AxiosRequestConfig } from 'axios';
 import { BridgeConfig } from '../config';
-import { Chain, Asset, ApiKeyValidationData, BridgeSwapRequest, BridgeSwapResponse, RouteTransactionRequest, RouteTransactionResponse, BridgeFeeEstimateRequest, BridgeFeeEstimateResponse, RouterSwapFeeEstimateRequest, RouterSwapFeeEstimateResponse, CancelCcipRequest, CancelRouterSwapRequest, CancelBridgeSwapRequest, CancelOperationResponse, ApiTransactionsResponse, ValidateBurnRequest, ValidateBurnResponse, CcipTxConfirmationRequest, CcipTxConfirmationResponse } from '../types';
+import { Chain, AssetsApiResponse, ApiKeyValidationData, BridgeSwapRequest, BridgeSwapResponse, RouteTransactionRequest, RouteTransactionResponse, BridgeFeeEstimateRequest, BridgeFeeEstimateResponse, RouterSwapFeeEstimateRequest, RouterSwapFeeEstimateResponse, CancelCcipRequest, CancelRouterSwapRequest, CancelBridgeSwapRequest, CancelOperationResponse, ApiTransactionsResponse, ValidateBurnRequest, ValidateBurnResponse, CcipTxConfirmationRequest, CcipTxConfirmationResponse } from '../types';
 export declare class VoidAIBridgeClient {
     private config;
     private client;
@@ -8,9 +9,7 @@ export declare class VoidAIBridgeClient {
     readonly ready: Promise<void>;
     constructor(config: BridgeConfig);
     /**
-     * Authenticate and set Authorization header for subsequent requests.
-     * New flow: POST /api/v1/auth/login
-     * Fallback: GET /api/v1/auth/validate-api-key (legacy)
+     * Authenticate via POST /api/v1/auth/login and set Authorization header.
      */
     private authenticate;
     private setAccessToken;
@@ -31,21 +30,12 @@ export declare class VoidAIBridgeClient {
     login(): Promise<string>;
     private tryDecodeTokenToValidationData;
     private base64UrlDecode;
-    /**
-     * Validate API key with the backend
-     * @throws Error if API key is invalid
-     */
-    validateApiKey(): Promise<ApiKeyValidationData>;
-    /**
-     * Get validation URL - uses baseUrl from config
-     */
-    private getValidationUrl;
     /**
      * Get validated API key data
      */
     getValidatedApiKeyData(): ApiKeyValidationData | null;
     private getUrl;
-    get<T>(path: string, params?: any, retryAttempted?: boolean): Promise<T>;
+    get<T>(path: string, params?: any, retryAttempted?: boolean, requestConfig?: AxiosRequestConfig): Promise<T>;
     post<T>(path: string, data?: any, retryAttempted?: boolean): Promise<T>;
     delete<T>(path: string, params?: any, retryAttempted?: boolean): Promise<T>;
     patch<T>(path: string, data?: any, retryAttempted?: boolean): Promise<T>;
@@ -96,7 +86,7 @@ export declare class VoidAIBridgeClient {
     /**
      * Get list of supported assets
      */
-    getAssetList(chainId?: string): Promise<Asset[]>;
+    getAssetList(chainId?: string, page?: number, limit?: number): Promise<AssetsApiResponse>;
     /**
      * Get bridge fee estimate
      * @param params - Fee estimation parameters

package/dist/api/client.js

@@ -17,31 +17,15 @@ class VoidAIBridgeClient {
             },
         });
         // Start auth immediately. Requests will await this promise.
-        // New flow: POST /auth/login to get JWT. Fallback to validate-api-key for backward compatibility.
         this.ready = this.authenticate().then(() => undefined);
     }
     /**
-     * Authenticate and set Authorization header for subsequent requests.
-     * New flow: POST /api/v1/auth/login
-     * Fallback: GET /api/v1/auth/validate-api-key (legacy)
+     * Authenticate via POST /api/v1/auth/login and set Authorization header.
      */
     async authenticate() {
-        try {
-            const token = await this.login();
-            this.setAccessToken(token);
-            // Populate validatedApiKeyData from JWT payload (best-effort) so existing getters keep working.
-            this.validatedApiKeyData = this.tryDecodeTokenToValidationData(token);
-        }
-        catch (error) {
-            // If login isn't available or fails unexpectedly, fallback to legacy validation
-            // (do not break current working functionality).
-            try {
-                await this.validateApiKey();
-            }
-            catch (fallbackError) {
-                throw error;
-            }
-        }
+        const token = await this.login();
+        this.setAccessToken(token);
+        this.validatedApiKeyData = this.tryDecodeTokenToValidationData(token);
     }
     setAccessToken(token) {
         this.accessToken = token;
@@ -80,7 +64,9 @@ class VoidAIBridgeClient {
                 headers: { 'Content-Type': 'application/json' },
                 timeout: 10000,
             });
-            if (response.data && response.data.success && response.data.accessToken) {
+            if (response.data &&
+                response.data.success &&
+                response.data.accessToken) {
                 return response.data.accessToken;
             }
             const errorData = response.data;
@@ -128,53 +114,6 @@ class VoidAIBridgeClient {
         // @ts-ignore
         return atob(padded);
     }
-    /**
-     * Validate API key with the backend
-     * @throws Error if API key is invalid
-     */
-    async validateApiKey() {
-        try {
-            // Use a temporary axios instance for validation since baseUrl might be different
-            const validationUrl = this.getValidationUrl();
-            const response = await axios_1.default.get(validationUrl, {
-                headers: {
-                    'api-key': this.config.apiKey,
-                },
-                timeout: 10000,
-            });
-            if (response.data.success) {
-                this.validatedApiKeyData = response.data.data;
-                return response.data.data;
-            }
-            else {
-                const error = new Error(response.data.error.message);
-                error.code = response.data.error.code;
-                throw error;
-            }
-        }
-        catch (error) {
-            // If validation fails, ensure we don't keep stale validated data around.
-            this.validatedApiKeyData = null;
-            if (axios_1.default.isAxiosError(error)) {
-                if (error.response?.status === 401) {
-                    const errorData = error.response.data;
-                    const apiError = new Error(errorData.error?.message || 'API key is invalid or inactive');
-                    apiError.code = errorData.error?.code || 'INVALID_API_KEY';
-                    throw apiError;
-                }
-                throw new Error(`Failed to validate API key: ${error.message}`);
-            }
-            throw error;
-        }
-    }
-    /**
-     * Get validation URL - uses baseUrl from config
-     */
-    getValidationUrl() {
-        const baseUrl = this.config.getBaseUrl();
-        const cleanBase = baseUrl.replace(/\/$/, '');
-        return `${cleanBase}/api/v1/auth/validate-api-key`;
-    }
     /**
      * Get validated API key data
      */
@@ -188,11 +127,14 @@ class VoidAIBridgeClient {
         const cleanPath = path.replace(/^\//, '');
         return `${cleanBase}/${cleanPath}`;
     }
-    async get(path, params, retryAttempted = false) {
+    async get(path, params, retryAttempted = false, requestConfig) {
         await this.ready;
         const url = this.getUrl(path);
         try {
-            const response = await this.client.get(url, { params });
+            const response = await this.client.get(url, {
+                params,
+                ...(requestConfig || {}),
+            });
             return response.data;
         }
         catch (error) {
@@ -202,7 +144,7 @@ class VoidAIBridgeClient {
                 try {
                     await this.authenticate();
                     // Retry the original request once with fresh credentials.
-                    return await this.get(path, params, true);
+                    return await this.get(path, params, true, requestConfig);
                 }
                 catch (retryError) {
                     this.handleError(retryError);
@@ -376,17 +318,20 @@ class VoidAIBridgeClient {
     /**
      * Get list of supported assets
      */
-    async getAssetList(chainId) {
-        const response = await this.get('api/v1/asset/assets');
+    async getAssetList(chainId, page = 1, limit = 20) {
+        const queryParams = {
+            page: String(page),
+            limit: String(limit),
+        };
+        const response = await this.get('api/v1/asset/assets', queryParams);
         if (!response.success || !response.data) {
             throw new Error(response.message || 'Failed to fetch assets');
         }
-        let assets = response.data.assets;
-        // Filter by chainId if provided
+        // Filter by chainId if provided (client-side filtering after pagination)
         if (chainId !== undefined) {
-            assets = assets.filter(asset => asset.chainId === chainId);
+            response.data.assets = response.data.assets.filter((asset) => asset.chainId === chainId);
         }
-        return assets;
+        return response;
     }
     /**
      * Get bridge fee estimate

package/dist/core/bridge.js

@@ -41,7 +41,10 @@ class Bridge {
                         },
                     ],
                     functionName: 'burn',
-                    args: [maybeWithEncoded.encodedData, maybeWithEncoded.signature],
+                    args: [
+                        maybeWithEncoded.encodedData,
+                        maybeWithEncoded.signature,
+                    ],
                 });
                 // Attach the prepared transaction payload in a non-breaking way.
                 maybeWithEncoded.evmTransaction = {

package/dist/index.js

@@ -38,7 +38,7 @@ class BridgeSDK {
         this.wallets = {
             bittensor: new bittensor_1.BittensorWallet(),
             ethereum: new ethereum_1.EthereumWallet(),
-            solana: new solana_1.SolanaWallet()
+            solana: new solana_1.SolanaWallet(),
         };
         this.bridge = new bridge_1.Bridge(this.api);
     }

package/dist/wallet/bittensor.js

@@ -131,7 +131,8 @@ class BittensorWallet {
             return !!injectedWeb3[extensionName];
         }
         const supportedExtensions = ['talisman', 'subwallet-js', 'polkadot-js'];
-        return supportedExtensions.some(name => !!injectedWeb3[name]) || Object.keys(injectedWeb3).length > 0;
+        return (supportedExtensions.some((name) => !!injectedWeb3[name]) ||
+            Object.keys(injectedWeb3).length > 0);
     }
     /**
      * Get the wallet extension instance (for advanced usage)

package/dist/wallet/ethereum.js

@@ -16,7 +16,7 @@ class EthereumWallet {
         if (typeof window === 'undefined') {
             return false;
         }
-        return typeof window.ethereum !== 'undefined' && window.ethereum.isMetaMask;
+        return (typeof window.ethereum !== 'undefined' && window.ethereum.isMetaMask);
     }
     /**
      * Connect to MetaMask wallet
@@ -40,7 +40,7 @@ class EthereumWallet {
             const chainId = await ethereum.request({ method: 'eth_chainId' });
             this.account = {
                 address: accounts[0],
-                chainId: chainId
+                chainId: chainId,
             };
             this.chainId = chainId;
             // Listen for account changes

package/dist/wallet/solana.js

@@ -37,7 +37,7 @@ class SolanaWallet {
             }
             this.account = {
                 address: response.publicKey.toString(),
-                publicKey: response.publicKey.toString()
+                publicKey: response.publicKey.toString(),
             };
             // Listen for disconnect
             solana.on('disconnect', this.handleDisconnect.bind(this));