Basic Wallet Operations
This guide explains the Web3 operations of the Arcana wallet and how users can access different functions through its UI. Developers looking to enable these operations programmatically in their apps can refer to the Arcana wallet Developer Guides.
Prerequisites
-
To use the Arcana wallet, users must log in to a Web3 app that is integrated with the Arcana Auth SDK.
-
Depending on the type of blockchain signing experience set up by the app developer, the Arcana wallet may appear only when a blockchain transaction is triggered, or it may be visible at all times once the user logs in.
Wallet Display
When a user logs into an app integrated with the Arcana Auth SDK, they can access the Arcana wallet from within the app context itself. Users are not required to install any wallet extension.
The wallet shows up on the left or right side of the app screen based on how the developer specifies the wallet position parameter during the SDK integration. At first, the wallet appears in a compact form within the app.
Users can click on it to maximize the wallet view.
Starter Tips
Upon first logging into the app integrated with the Arcana Auth SDK, the wallet starter tips activate automatically for each authenticated user.
The starter tips showcase different wallet screens. It demonstrates various screen elements for accessing wallet features. Users can navigate the tips using the Next and Previous buttons at the bottom of the wallet screen. Users can access the wallet home screen by using the Skip button at the top right.
Arcana wallet Features
Authenticated users can perform the following Web3 wallet operations through the wallet UI:
- Sign (approve, reject) blockchain transactions
- Add and configure network settings
- Switch networks
- Manage token assets (native and custom)
- Check account balance
- List token assets
- Add custom tokens (ERC-20)
- Send and receive tokens
- Buy/Sell cryptocurrency
- Manage NFTs
- List NFT assets
- View NFT details
- Send NFTs (ERC-721, ERC-1155)
- Add NFTs
- Modify (edit, delete) NFTs
- View user profile details
- Monitor blockchain transaction activity
- Export private key
- Logout
Users can access various Web3 wallet operations supported by the Arcana wallet using the following tabs located at the bottom of the wallet:
Token Assets Tab 
NFT Assets Tab
User Profile Tab
Activity Notifications Tab
Sign Transaction
A blockchain sign transaction can be triggered either by the app, programmatically, or in response to a user action in the Arcana wallet UI. A blockchain transaction results in a notification, as displayed in the figure below. Users can scroll down and see details of the request before selecting one of the options to Reject or Approve the transaction.
If the user does not take any action for the transaction notification but chooses to ignore it using the 'Do this later' option, in the Arcana wallet, the wallet switches to the 'Token Assets' tab view.
Pending transactions are highlighted in the minimized wallet state with a red dot.
Once the user takes action on the pending transaction notification, it disappears from the 'Activity' tab view.
Add/Select a Network
By default, the Arcana wallet UI displays a pre-configured list of blockchain networks. Users can select a different network from the drop-down list or add newer networks that are supported by the product.
To add or select a network, click the dropdown next to the blockchain network icon on the top right: 
You can either choose one of the available networks to switch or add a new one.
- Click Add Network
- Add the following details:
- Network Name: Name of the network. For example, Shardeum
- RPC URL: https://liberty10.shardeum.org
- Chain ID: 8080
- Currency Symbol: SHM
- Explorer URL (Optional): https://explorer.liberty10.shardeum.org/
Once you click Save, the newly added network is automatically selected as the current active chain in wallet UI.
Switch Network
To switch the existing network using the wallet UI, click on the dropdown next to the network icon on the top right of the wallet UI:
You will see a list of pre-configured blockchain networks available in the current application's context. Simply click one of the available networks to switch networks.
Buy/Sell Crypto
Arcana wallet allows users to buy and sell crypto by integrating with third-party providers.
Fiat On-ramp
Fiat on-ramping allows Arcana wallet users to buy cryptocurrency using fiat through one of the supported providers:
Users can purchase ERC20 or native tokens for supported blockchains from the chosen on-ramp provider. The Arcana wallet balance updates automatically after the transaction completes.
Select the 'Tokens' tab in the Arcana wallet. Select one of the chains from the drop-down list of pre-configured blockchain networks. This choice will govern what cryptocurrencies and tokens can be purchased, subject to local country-specific rules.
Click Buy to initiate the fiat on-ramp process through the Arcana wallet on the selected blockchain network.
You will see the list of available fiat on-ramp providers:
Pick up one of the providers and click Proceed. Clicking will open the provider-specific interface in a new tab. Arcana wallet will notify you of the 'buy' process. Dismiss it and continue to use the wallet while the crypto purchase happens in parallel on another tab on the provider's site.
Fiat on-ramp providers may ask the user to follow country-specific procedures for KYC and list available cryptocurrencies for the selected chain. Note that the basic minimum purchase amount for a country or cryptocurrency may vary across countries and providers.
Transak
Transak requires each user to complete KYC by submitting country-specific identification documents. Once the verification is complete, the user can purchase the cryptocurrency with Transak. This verification is a one-time thing and subsequent purchases will not require this additional step. The figure below shows an example of a purchase transaction using Transak.
For step-by-step details on buying crypto assets, see the supported provider documentation:
For details on what assets and cryptocurrency, countries these providers support, refer to provider documentation:
Current Limitations
-
Purchased ERC20, ERC721 token assets will not be automatically updated in the Arcana wallet assets screen. Users will need to manually add custom tokens purchased via on-ramp providers, as these providers do not provide the contract address of the purchased token.
-
You will not see any activity listed for a successful purchase when you click on the notification tab of the Arcana wallet UI. There is no uniform standard whereby on-ramp providers share this information or 'event' regarding purchase. We may add it in future releases.
Fiat Off-ramp
Fiat off-ramping allows Arcana wallet users to sell cryptocurrency using fiat through one of the supported providers:
Users can initiate ERC20 tokens or native cryptocurrency sell transactions for supported blockchains via Arcana wallet. The chosen off-ramp provider executes the 'sell' and deposits proceeds into the configured bank account. The Arcana wallet updates the balance automatically when the transaction completes.
Click the 'Tokens' tab in the Arcana wallet. Select one of the chains from the drop-down list of pre-configured blockchain networks. This choice will govern what cryptocurrencies and tokens can be sold, subject to local country-specific rules.
Click Sell to initiate the fiat off-ramp process through the Arcana wallet on the selected blockchain network.
The list of available fiat off-ramp providers is displayed:
Pick up one of the providers and click Proceed.
Clicking opens the provider-specific interface in a new tab. Proceed on the provider site to sell. Arcana wallet notifies you of the 'sell' initiation. Dismiss it and resume wallet use in another tab; selling happens in parallel at the provider site.
Fiat off-ramp providers may ask the user to follow country-specific procedures for KYC and list available cryptocurrencies for the selected chain. Note that the basic maximum sell amount for a country or cryptocurrency may vary across countries and providers.
Transak
Transak requires each user to complete KYC by submitting country-specific identification documents. Once the verification is complete, the user can sell cryptocurrency via Transak. This verification is a one-time thing; subsequent purchases will not require this additional step. The figure below shows an example of a sell transaction using Transak.
For step-by-step details on buying crypto assets, see the supported provider documentation:
For details on what assets and cryptocurrencies, countries these providers support, refer to provider documentation:
The activity tab in the Arcana wallet UI will display the details of the 'sell' transaction issued from the wallet.
Manage Token Assets
Click the 'Tokens' tab on the bottom left of the Arcana wallet to bring up the token assets screen. It displays the following information:
- View, and copy the Arcana wallet address
- View wallet address details on the Block Explorer
- Add/Select network
- Refresh the wallet UI
- View the total wallet balance in the native currency
- List native and custom tokens in the wallet
- Add new custom tokens
- Send and receive native and custom tokens
- View token asset activities - which native or custom tokens requests were sent, whether the status is confirmed or pending, etc.
For more details, see how to view, select, send, receive tokens, add custom tokens using the Arcana wallet UI.
Manage NFT Assets
Click the 'NFT' tab on the bottom of the Arcana wallet UI to view and manage NFTs associated with the wallet address on the selected blockchain network. The following NFT operations can be performed by the authenticated user:
General Wallet Operations
- View, and copy the Arcana wallet address
- View wallet address details on the 'Block Explorer' associated with the selected network
- Refresh the wallet UI
- Add/Select network
NFT Operations
- List NFT assets associated with the wallet address
- View NFT details
- Send NFT
- Receive NFT
-
Manage NFTs
- Add an NFT
- Edit NFT entry
- Delete NFT entry
For details, see how Web3 app users can send NFTs, manage NFTs and monitor NFT transactions through the Arcana wallet.
View User Profile Details
Click the 'Profile' tab on the bottom of the Arcana wallet to see the user profile details:
- User name
- Email ID used to log into the wallet
- Active Network
- Wallet Address
- Option to export the private key
- Logout button
- Minimize / Close button
Wallet Notifications
Click the 'Activity' tab on the bottom right of the Arcana wallet to view the wallet notifications screen.
The activity tab lists all transactions processed through the wallet for different digital assets such as native tokens, custom tokens, and NFTs. It also displays pending blockchain transactions, if any.
Notification Example
Pending Contract Deployment Request
When a contract deployment request notification shows up, the user can click on 'Do it later' option. The request will be listed as a pending request in the 'Activity' tab of the wallet.A red dot on the 'Activity' tab icon at the bottom right of the Arcana wallet indicates a pending blockchain transaction.
Click on the red dot to see details of the pending transaction and take appropriate action.
Export Private Key
Click the tab on the bottom left of the Arcana wallet to see the user profile screen. It provides an option to export the user's private key. For details, see how to export a user's private key guide.
Minimized Wallet State
The Arcana wallet is displayed as an embedded wallet within the context of the Web3 app that is integrated with The Arcana Auth SDK.
Right after a user authenticates, the wallet is displayed in its minimized state.
On clicking, it expands to display the wallet in its maximized state. It can be minimized again by clicking the '∨' icon on the top in the wallet UI.
View Transaction Summary & Details
If a blockchain transaction is triggered via the app that requires the user's approval, the user will see a transaction notification. If the wallet was in a minimized state at the time the request was generated, then the notification will show up with a summary of the transaction along with the buttons to approve or reject.
The user can click on the top right arrow icon in the transaction notification to view its details.
Here is an example of how an eth_sendTransaction triggers a transaction notification and approval request for the user. The send transaction notification summary is displayed:
In the case of the send transaction request or sign transaction request, the notification details allow the user to edit the gas fees before approving the request.
For other transactions that do not involve gas fees such as personal sign or signature requests, the notification details allow users to review transaction message details before taking an action to approve or reject.
Here is an example of a signature request notification summary:
On clicking the topmost arrow icon, the user can see the signature request transaction notification details view:
Logout
Click the tab at the bottom of the Arcana wallet UI to bring up the user profile tab view. Click Logout in the user profile tab view to log out.
That is all!
You are now well-versed with the Arcana wallet UI and how to perform blockchain transactions using the same.
What's Next?
Besides the basic Web3 wallet operations, the authenticated users can use the Arcana wallet to view and export their private keys and manage crypto assets such as tokens and NFTs.