Wallets
Learn how to manage your master wallets
In a nutshell
To leverage Blockradar’s wallet infrastructure and enable seamless deposits and payments for your customers, you need to create at least one master wallet.
Introduction
Master wallets are the backbone of most actions you can carry out with the Blockradar API. These wallets let you manage stablecoin deposits across multiple blockchains supported by Blockradar. To view the list of supported blockchains on Blockradar.
When you create a master wallet for a specific blockchain, it allows you to manage everything related to that blockchain with the master wallet:
- Generating dedicated addresses for your customers to use for depositing stablecoins on multiple blockchains.
- Whitelisting externally managed addresses for stablecoin deposit monitoring.
- Auto-sweeping: every stablecoin deposited to any of the dedicated addresses is automatically swept into the master wallet.
- Withdrawals: you can easily initiate stablecoin withdrawals from the master wallet address to an external address.
Creating a Wallet
The creation of a master wallet requires four steps:
- Select the blockchain you want to create the wallet for using the Get Blockchains API.
- Add the stablecoins that you need this master wallet to support. You can get the list of supported stablecoins from the API.
- Configure your wallet webhook URL. This will be used for notifications and data synchronization when stablecoins are deposited into any of the dedicated addresses generated through this wallet.
- Fund the master wallet. To enable auto-sweeping of stablecoins from the dedicated addresses to the master wallet and withdrawal to external address, you need to maintain a balance of the native asset on the blockchain in this master wallet.
One dedicated address generated via any of these master wallets can be used to receive deposits on all other blockchain master wallets, provided the blockchains have isEvmCompatible: true
.
This means you can issue your customers a single unique address that can be used to deposit stablecoins on multiple blockchains, without worrying about them sending stablecoins to the wrong blockchain.
Create a Master Wallet
To create a master wallet, go to the dashboard, navigate to the wallets section, and create a wallet to start building a seamless experience for your customers.
Environment
Wallets created in the live environment are isolated to that environment. The same applies to wallets created in the test environment, including the dedicated addresses created for your customers.
Funding
Funding a master wallet is essential for paying the gas fees on the blockchain when auto-sweeping stablecoins from the dedicated addresses to the master wallet and for withdrawals to external wallets.
Test Environment
- Ethereum: Get test ETH here: Alchemy or Infura
- Binance Smart Chain: Get test BNB here: Faucet
- Polygon: Get test MATIC here: Polygon PoS (Amoy)
- Base: Get test ETH here: Alchemy
- Optimism: Get test ETH here: Alchemy
- Arbitrum: Get test ETH here: Alchemy
- Tron: Get test TRX here: Faucet
- Solana: Get test SOL here: Faucet
Live Environment
For the live environment, you can send assets from any wallet or exchange that supports the native assets on each of the blockchains.
Sweeping
Always ensure you have enough balance in your master wallet to avoid delays in auto-sweeping or withdrawals. We will notify you when your master wallet balance is low.
Gas Fees: Test vs Live Environment
Understanding the differences in gas fees between test and live environments is crucial for efficient development and deployment.
Test Gas Fees
In test environment, gas fees are minimal. Testnets are designed to simulate the mainnet environment without the associated real-world costs. As a result, small amounts of gas tokens in a testnet can be used for an extended period. This allows developers to test and iterate their integration without incurring significant expenses.
Live Gas Fees
In a test environment, gas fees represent real-world expenses. These costs can vary significantly based on the blockchain and network congestion. Properly estimating and managing gas fees is essential to ensure the smooth operation of your applications and to avoid excessive costs.
By leveraging testnets for development and testing, you can minimize expenses and ensure your solutions are robust before deploying to the mainnet.
Deposit Finder
In rare cases, you might not receive a webhook from our system after a customer sends stablecoins to any of the addresses issued to them. We have an deposit finder mechanism built internally, but you also have the ability to trigger a rescan of the blockchain for a missing transaction using the Deposit Finder API by providing the transactionHash
or blockNumber
Body parameters
One of the parameters needs to be provided, either the blockNumber
or transactionHash
.
Happy hacking! ❤️