FAQ
Frequently Asked Questions
Section titled “Frequently Asked Questions”General
Section titled “General”What is the VoidAI Bridge SDK?
The VoidAI Bridge SDK is a TypeScript library for integrating cross-chain bridging (Bittensor ↔ EVM), token swapping, and CCIP transfers into frontend and backend applications. See the SDK overview for full details.
Which chains are supported?
Currently supported: Bittensor and Ethereum (EVM). Base is active via CCIP. Solana and additional chains are planned.
Should token symbols be uppercase or lowercase?
The API requires lowercase token symbols: tao, wtao, alpha, walpha. Using uppercase will cause request failures.
Fees & Limits
Section titled “Fees & Limits”How are fees calculated?
Bridge fees consist of up to four components:
| Component | Description |
|---|---|
| Network Gas Fee | Cost to execute the transaction on the destination chain. |
| Platform Fee | VoidAI service fee. |
| Tenant Fee | Percentage fee set by you in the Admin Portal. |
| CCIP Fee | Additional fee for Cross-Chain Interoperability Protocol operations. |
See the Fee Schedule for exact amounts per direction.
Is there a minimum bridge amount?
Yes. Minimum amounts vary by token and current network gas conditions. The SDK will return an error if the requested amount is below the minimum.
How do I claim my accumulated tenant fees?
Reward claiming is currently manual. View your accumulated fees in the Admin Portal and request a payout from the Admin — they will transfer funds to your registered wallet. There is no programmatic API for fee claiming at this time.
Transactions
Section titled “Transactions”How long does a bridge transaction take?
| Direction | Typical Duration |
|---|---|
| EVM → Bittensor | 10–20 minutes (depending on finality) |
| Bittensor → EVM | 5–10 minutes |
| CCIP | 20–30 minutes (requires multiple confirmations) |
My transaction is stuck. What should I do?
Check the transaction status via getRecentTransactions or the Admin Portal. Ensure the originating wallet had sufficient gas. If it was a Bittensor batch transaction, check the block explorer for a “Batch Interrupted” error — this usually means one of the batched calls (transfer or remark) failed.
Wallets
Section titled “Wallets”Which wallets are supported?
| Chain | Supported Wallets |
|---|---|
| EVM | MetaMask, Rabbit, Rainbow, WalletConnect-compatible wallets |
| Bittensor | Talisman, Subwallet, Polkadot.js |
| Solana | Phantom, Solflare |
Why does TAO → wTAO require staked TAO?
The TAO → wTAO flow uses the same transferStake + remark mechanism as Alpha → wAlpha. TAO must be staked to the Bridge Hot Wallet for the conversion to proceed — unstaked TAO cannot be used directly in this flow.