@voidaisdk/bridge-sdk 0.0.2 → 0.0.3

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;
@@ -45,7 +46,7 @@ export declare class VoidAIBridgeClient {
      */
     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 +97,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

@@ -80,7 +80,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;
@@ -188,11 +190,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 +207,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 +381,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
@@ -398,7 +406,9 @@ class VoidAIBridgeClient {
             toToken: params.toToken,
             amount: String(params.amount),
         };
-        return this.get('api/v1/bridge/call-fee', queryParams);
+        return this.get('api/v1/bridge/call-fee', queryParams, false, {
+            headers: { 'x-api-key': this.config.apiKey },
+        });
     }
     /**
      * Get router swap fee estimate
@@ -412,7 +422,7 @@ class VoidAIBridgeClient {
             operationType: params.operationType,
             toAddress: params.toAddress,
         };
-        return this.get('api/v1/router-swap/call-fee', queryParams);
+        return this.get('api/v1/router-swap/call-fee', queryParams, false, { headers: { 'x-api-key': this.config.apiKey } });
     }
     /**
      * Normalize and rethrow errors with backend message (if available) so

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));