Create your first developer wallet
Create a developer wallet and transfer native tokens to and from wallet
Planbok wallets offer a comprehensive developer solution for securely storing, sending, and managing digital assets on the blockchain. Our all-in-one experience takes care of intricate aspects such as security, transaction monitoring, account recovery flows, and more, ensuring that you or your users can seamlessly handle digital assets without any complications.
Note: The guide below utilises the Ethereum Sepolia Testnet for illustrative purposes, and there will be no transfer of real-world funds. In a production environment, you can create and utilize wallets that support digital assets on the following blockchains and standards:
Ethereum (ETH), Binance Smart Chain (BSC) and Polygon (MATIC), both Testnet and Mainnet
ERC-20 tokens
ERC-721 and ERC-1155 NFTs (non-fungible tokens)
Prerequisites
Create a Developer Account and acquire an API key in the Dashboard.
Please note that you can not repeat idempotencyKey
, except the initial transaction failed as it will raise a 401 error.
1. Create Wallet Set
A wallet set encompasses a cohesive collection of wallets, all under the management of a single cryptographic private key. This allows for the coexistence of wallets from diverse blockchains while sharing a common address.
To establish a wallet set, initiate a request to POST /wallet-sets/developer/create
. Upon creating a wallet set, you will receive a distinctive wallet set secret cipher text, which is used for generating users' wallets and facilitating your users' blockchain transactions.
2. Create Wallet
In the world of Web3, a wallet serves as more than just a storage facility for digital assets; it serves as the foundational framework for all user interactions within the blockchain ecosystem. A wallet consists of a distinctive address and associated metadata that are stored on the blockchain.
To create a wallet, make a request to POST /wallets/developer/create
using the walletSet.id
and walletSetSecretCipherText
from step 1.
3. Acquire Gas Tokens
In web3 and blockchain technology, "gas" refers to a unit of measurement for the computational work required to execute a transaction or perform an operation on the blockchain. Gas is used to quantify the amount of resources a transaction consumes, including computational power and network bandwidth, and it also determines the fees a user must pay to miners or validators to have their transaction included in the blockchain and is always paid in the native currency of that blockchain. For instance, when sending a BEP-20 token on the Binance Smart Chain, the transaction fee would be paid in BNB. Likewise, on the Ethereum network, the fee is denominated in ETH, and the same applies to its Sepolia Testnet, which is the one we are currently utilising. It's essential to have a certain quantity of the native token in your wallet to ensure the seamless processing of transactions.
Acquire Sepolia ETH tokens through the Alchemy Sepolia Faucet and proceed to transfer them to the wallet address provided in the response body from running the previous step.
4. Check Wallet Balance
Make sure the wallet successfully received the Sepolia ETH tokens, before proceeding.
Check the wallet balance by making a request to GET /wallets/{id}/developer/balances
.
5. Transfer Tokens
Make a request to POST /transactions/transfer/developer
with Sepolia ETH's token.id
, created wallet's wallets[0].id
, your destination wallet address
, as well as some predefined values for amount, and gas related request parameters.
6. Check Transaction State
Make a request to GET /transactions/{id}/developer?walletId={walletId}
to return the specific transaction details using the id from previous step response body.
When the transaction.state
is COMPLETE
, this means that the token has sent from the your wallet to the destination wallet.
You can also check the transaction using the txHash
on Sepolia Etherscan, inspect the balance of each wallet and compare with their previous balances.
Last updated