@voidaisdk/bridge-sdk 0.0.4 → 1.0.0

package/README.md

@@ -1,6 +1,6 @@
 # VoidAI Bridge SDK
 
-[![npm version](https://img.shields.io/npm/v/voidai-sdk.svg)](https://www.npmjs.com/package/voidai-sdk)
+[![npm version](https://img.shields.io/npm/v/@voidaisdk/bridge-sdk.svg)](https://www.npmjs.com/package/@voidaisdk/bridge-sdk)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 **TypeScript SDK for VoidAI Bridge** - Cross-chain asset bridging and routing across Bittensor, Ethereum, Solana, and other supported chains.
@@ -20,11 +20,11 @@ Perfect for building DeFi applications, cross-chain DEXs, or any app that needs
 ## 📦 Installation
 
 ```bash
-npm install voidai-sdk
+npm install @voidaisdk/bridge-sdk
 # or
-yarn add voidai-sdk
+yarn add @voidaisdk/bridge-sdk
 # or
-pnpm add voidai-sdk
+pnpm add @voidaisdk/bridge-sdk
 ```
 
 ### Requirements
@@ -38,7 +38,7 @@ pnpm add voidai-sdk
 ### 1. Initialize the SDK
 
 ```typescript
-import { BridgeSDK } from 'voidai-sdk';
+import { BridgeSDK } from '@voidaisdk/bridge-sdk';
 
 const sdk = new BridgeSDK({
     apiKey: process.env.VOIDAI_API_KEY!,
@@ -170,12 +170,16 @@ console.log('Total fee:', swapFee.totalFee);
 
 **📖 [Full Documentation](docs/README.md)** - Complete API reference, guides, and examples
 
-- [Getting Started Guide](docs/getting-started.md)
-- [SDK Initialization](docs/sdk-initialization.md)
-- [API Reference](docs/api/overview.md)
-- [Frontend Integration Examples](docs/frontend-integration.md)
-- [Error Handling](docs/error-handling.md)
-- [Best Practices](docs/best-practices.md)
+- [Getting Started](docs/getting-started.md) – Installation, authentication, configuration
+- [Wallets](docs/wallets.md) – Bittensor, EVM, Solana wallet connections
+- [Bridge Operations](docs/bridge.md) – Cross-chain bridging
+- [Router Swaps](docs/swap.md) – Token swaps via VoidAI Router
+- [CCIP Routing](docs/ccip.md) – Cross-chain CCIP operations
+- [Transactions](docs/transactions.md) – History, cancel, confirm
+- [Server-Side Usage](docs/server.md) – Backend integration with BridgeSDKServer
+- [API Reference](docs/api-reference.md) – SDK methods and types
+- [FAQ](docs/FAQ.md) – Frequently asked questions
+- [Error Handling](docs/error-handling.md) – Troubleshooting and error codes
 
 ## 💡 Key Features
 
@@ -224,12 +228,12 @@ console.log('Total fee:', swapFee.totalFee);
 For server-side or backend integrations, use `BridgeSDKServer` with both `apiKey` and `secretKey`:
 
 ```typescript
-import { BridgeSDKServer } from 'voidai-sdk';
+import { BridgeSDKServer } from '@voidaisdk/bridge-sdk';
 
 const sdk = new BridgeSDKServer({
     apiKey: process.env.VOIDAI_API_KEY!,
     secretKey: process.env.VOIDAI_SECRET_KEY!,
-    environment: 'production',
+    environment: 'mainnet', // 'devnet' | 'testnet' | 'mainnet'
 });
 
 await sdk.ready;
@@ -245,24 +249,24 @@ const result = await sdk.bridge.bridge({
 
 ## 🔧 Environment Configuration
 
-The SDK supports three environments:
+The SDK supports three environments. The base URL and EVM bridge contract address are set per environment in the SDK config.
 
-| 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                                               | Bridge Contract (EVM)                        | Use Case                   |
+| ----------- | ------------------------------------------------------ | ------------------------------------------- | -------------------------- |
+| `devnet`    | `https://api-sdk-dev.voidai.envistudios.com/api`       | `0x6266ce15aC4f32F096Ff91881dd887a0F4bBa569` | Development & testing      |
+| `testnet`   | `https://sdk-backend.voidai.com/sdk`                   | `0x4aA4396BfD6F268b427077079800F420dF947b63` | Staging / pre-production   |
+| `mainnet`   | `https://sdk.voidai.com/sdk`                           | `0x604e8Ef901C0E69E79463D997ba7D0724A909b84` | Production                 |
 
 ## 📝 Example: Complete Bridge Flow
 
 ```typescript
-import { BridgeSDK } from 'voidai-sdk';
+import { BridgeSDK } from '@voidaisdk/bridge-sdk';
 
 async function bridgeTAO() {
     // 1. Initialize SDK
     const sdk = new BridgeSDK({
         apiKey: process.env.VOIDAI_API_KEY!,
-        environment: 'staging',
+        environment: 'testnet', // or 'mainnet' for production
     });
 
     await sdk.ready;
@@ -365,11 +369,11 @@ bridge-sdk/
 
 ```html
 <script type="module">
-    import { BridgeSDK } from './node_modules/voidai-sdk/dist-browser/voidai-sdk.js';
+    import { BridgeSDK } from './node_modules/@voidaisdk/bridge-sdk/dist-browser/voidai-sdk.js';
 
     const sdk = new BridgeSDK({
         apiKey: 'your-api-key',
-        environment: 'staging',
+        environment: 'mainnet', // 'devnet' | 'testnet' | 'mainnet'
     });
 </script>
 ```
@@ -377,10 +381,10 @@ bridge-sdk/
 ### Bundler (Webpack/Vite/Rollup)
 
 ```typescript
-import { BridgeSDK } from 'voidai-sdk';
+import { BridgeSDK } from '@voidaisdk/bridge-sdk';
 
 // Use normally - bundler will handle it
-const sdk = new BridgeSDK({ apiKey, environment: 'production' });
+const sdk = new BridgeSDK({ apiKey, environment: 'mainnet' }); // 'devnet' | 'testnet' | 'mainnet'
 ```
 
 ## ⚠️ Error Handling
@@ -412,7 +416,7 @@ See [Error Handling Guide](docs/error-handling.md) for detailed patterns.
 - ✅ **Validate user inputs** before passing to SDK
 - ✅ **Keep dependencies updated** - Monitor security advisories
 
-See [Best Practices](docs/best-practices.md) for more guidance.
+See [Full Documentation](docs/README.md) for more guidance.
 
 ## 📖 Examples
 
@@ -429,7 +433,7 @@ Check out the [example frontend app](examples/frontend/) for a complete integrat
 
 - **Documentation**: [Full docs](docs/README.md)
 - **Issues**: [GitHub Issues](https://github.com/your-org/bridge-sdk/issues)
-- **FAQ**: [Troubleshooting Guide](docs/faq.md)
+- **FAQ**: [FAQ](docs/FAQ.md)
 
 ## 📄 License
 

package/dist/api/client.js

@@ -40,7 +40,7 @@ class VoidAIBridgeClient {
     getLoginUrl() {
         const baseUrl = this.config.getBaseUrl();
         const cleanBase = baseUrl.replace(/\/$/, '');
-        return `${cleanBase}/api/v1/auth/login`;
+        return `${cleanBase}/v1/auth/login`;
     }
     /**
      * Get EVM bridge contract address for burn operations.
@@ -222,7 +222,7 @@ class VoidAIBridgeClient {
      * Bridge swap operation
      */
     async bridgeSwap(payload) {
-        return this.post('api/v1/bridge/swap', payload);
+        return this.post('v1/bridge/swap', payload);
     }
     /**
      * Route transaction operation (SWAP / BRIDGE / CCIP)
@@ -234,7 +234,7 @@ class VoidAIBridgeClient {
             ...payload,
             amount: String(payload.amount),
         };
-        return this.post('api/v1/bridge/route-transaction', normalizedPayload);
+        return this.post('v1/bridge/route-transaction', normalizedPayload);
     }
     /**
      * Cancel a CCIP route transaction
@@ -246,7 +246,7 @@ class VoidAIBridgeClient {
             toToken: params.toToken,
             uuid: params.uuid,
         };
-        return this.delete('api/v1/bridge/cancel-ccip', queryParams);
+        return this.delete('v1/bridge/cancel-ccip', queryParams);
     }
     /**
      * Cancel a router swap transaction
@@ -255,13 +255,13 @@ class VoidAIBridgeClient {
         const queryParams = {
             uuid: params.uuid,
         };
-        return this.delete('api/v1/bridge/cancel-router-swap', queryParams);
+        return this.delete('v1/bridge/cancel-router-swap', queryParams);
     }
     /**
      * Cancel a bridge swap transaction
      */
     async cancelBridgeSwap(params) {
-        return this.patch('api/v1/bridge/swap/cancel', params);
+        return this.patch('v1/bridge/swap/cancel', params);
     }
     /**
      * Get recent API transactions (tenant-level)
@@ -271,19 +271,19 @@ class VoidAIBridgeClient {
             page: String(page),
             limit: String(limit),
         };
-        return this.get('api/v1/bridge/api-transactions', queryParams);
+        return this.get('v1/bridge/api-transactions', queryParams);
     }
     /**
      * Manually validate a bridge burn transaction (EVM burn completion)
      */
     async validateBurn(params) {
-        return this.post('api/v1/bridge/validate-burn', params);
+        return this.post('v1/bridge/validate-burn', params);
     }
     /**
      * Manually confirm a CCIP transaction
      */
     async confirmCcipTransaction(params) {
-        const path = `api/v1/bridge/transactions/${encodeURIComponent(params.transactionId)}/tx`;
+        const path = `v1/bridge/transactions/${encodeURIComponent(params.transactionId)}/tx`;
         const body = {
             txnHash: params.txnHash,
             operationType: params.operationType,
@@ -309,7 +309,7 @@ class VoidAIBridgeClient {
         if (options?.chainId !== undefined) {
             params.chain_id = options.chainId;
         }
-        const response = await this.get('api/v1/chain/chains', params);
+        const response = await this.get('v1/chain/chains', params);
         if (!response.success || !response.data) {
             throw new Error(response.message || 'Failed to fetch chains');
         }
@@ -323,7 +323,7 @@ class VoidAIBridgeClient {
             page: String(page),
             limit: String(limit),
         };
-        const response = await this.get('api/v1/asset/assets', queryParams);
+        const response = await this.get('v1/asset/assets', queryParams);
         if (!response.success || !response.data) {
             throw new Error(response.message || 'Failed to fetch assets');
         }
@@ -343,7 +343,7 @@ class VoidAIBridgeClient {
             toToken: params.toToken,
             amount: String(params.amount),
         };
-        return this.get('api/v1/bridge/call-fee', queryParams);
+        return this.get('v1/bridge/call-fee', queryParams);
     }
     /**
      * Get router swap fee estimate
@@ -357,7 +357,7 @@ class VoidAIBridgeClient {
             operationType: params.operationType,
             toAddress: params.toAddress,
         };
-        return this.get('api/v1/router-swap/call-fee', queryParams);
+        return this.get('v1/router-swap/call-fee', queryParams);
     }
     /**
      * Normalize and rethrow errors with backend message (if available) so

package/dist/config.js

@@ -27,15 +27,15 @@ class BridgeConfig {
 exports.BridgeConfig = BridgeConfig;
 BridgeConfig.DEFAULTS = {
     devnet: {
-        baseUrl: 'https://api-sdk-dev.voidai.envistudios.com/',
+        baseUrl: 'https://api-sdk-dev.voidai.envistudios.com/api',
         bridgeContractAddress: '0x6266ce15aC4f32F096Ff91881dd887a0F4bBa569',
     },
     testnet: {
-        baseUrl: 'https://sdk-backend.voidai.com/',
+        baseUrl: 'https://sdk-backend.voidai.com/sdk',
         bridgeContractAddress: '0x4aA4396BfD6F268b427077079800F420dF947b63',
     },
     mainnet: {
-        baseUrl: 'https://api-sdk.voidai.envistudios.com/',
+        baseUrl: 'https://sdk.voidai.com/sdk',
         bridgeContractAddress: '0x604e8Ef901C0E69E79463D997ba7D0724A909b84',
     },
 };