Basic Web3 Wallet Operations
This guide is intended for Web3 application users trying login into an application and use Arcana wallet.
Developers who wish to programmatically enable various wallet operations can refer to the various developer guides listed below.
Wallet Developer Guides
To enable Arcana wallet in the context of a Web3 application, you need to first register your Web3 application and configure social providers using the Arcana Developer Dashboard to authenticate users.
After that, you must install the @arcana/auth
package and follow the instructions to integrate your application.
For more details, see Arcana Auth Quick Start Guide, Developer Guide for user onboarding and the Developer Guide for enabling wallet operations.
Prerequisites
To use the Arcana wallet, you need to log in to a Web3 app that is connected to 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 needs your approval, or it may be visible all the time while using the Web3 app.
Arcana Wallet Features
Any dApp that integrates with Arcana Auth SDK and initializes the AuthProvider
can use the standard Ethereum provider to sign blockchain transactions. Authenticated users can access the Arcana wallet for Web3 wallet operations.
Arcana wallet displays the following tabs located at the bottom of the wallet screen:
These tabs contain interfaces to perform the following Web3 wallet operations:
- 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 cryptocurrency (native, ERC-20)
- Manage NFTs
- List NFT assets
- View NFT details
- Send, share NFTs (ERC-721, ERC-1155)
- Add NFT collections
- Modify (edit, delete) NFT collections
- View user profile details
- Monitor Wallet notifications
- Export private key
- Logout
Sign Transaction
A blockchain transaction sign request can be generated either by the dApp or via user action. The Sign Message wallet screen shows the details of the request. For example, the following figure shows Personal Sign request. The user can scroll down and see details of the request and select one of the options to Reject or Approve the transaction.
If the user does not take any action but chooses to close the transaction request using the icon on the top right of the Arcana wallet screen, the wallet switches from maximized screen state to the minimized state. If there are any pending transactions they are highlighted in the minimized state with a red dot.
Once the user takes action on the pending transaction, the notification tab of the wallet will show a No Pending Requests! message.
Add/Select a Network
Arcana Wallet supports signing transactions on Ethereum, Polygon, and other EVM-compatible networks. You can select the desired network from the drop-down list.
If your network is not listed, you can also add multiple, EVM-compatible networks to the Arcana wallet.
- Click
icon.
- 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 the updated network list.
Switch Network
Click icon to bring up the wallet token asset tab. Use the network drop-down list to switch to a different network from the list of configured networks.
Fiat On-ramp
Arcana wallet supports fiat on-ramping that allows wallet users to buy cryptocurrency (native and ERC20 tokens) easily from any of the supported providers:
Users can purchase the specific token required for the app with either fiat or another cryptocurrency. Also they can purchase the native cryptocurrency with fiat to pay for transaction or gas fees. After a successful purchase via a third-party fiat on-ramp provider, the purchased tokens or currency is automatically deposited in the Arcana wallet address and displayed in the balance.
To buy cryptocurrency, click icon and refer to the token assets wallet tab. Select a chain from the drop-down list. This choice will govern what cryptocurrencies and tokens are available to purchase subject to local country-specific rules.
Click Buy to initiate the fiat on-ramp process for your Arcana wallet.
You will see the list of available fiat on-ramp providers:
Pick up one of the providers and click Proceed. This will bring up the provider-specific user interface. Each provider may ask the user to follow country-specific procedures for KYC and list available cryptocurrencies for the selected chain. Also, the basic minimum purchase amount for a country or cryptocurrency may vary across countries and providers.
For example, 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.
Similarly, if the fiat on-ramp provider Ramp Network is chosen, you will see the Ramp UI displaying all the available currencies for the selected chain in the Arcana wallet.
For the first purchase, you may also be required to do KYC formalities.
If you are new to Transak or Ramp, see Transak User Guide and Ramp User Guide for step by step details on buying crypto assets.
For details on what assets and cryptocurrency, countries are supported by these providers refer to Transak coverage and Ramp Network coverage.
Current Limitations
-
Purchased token assets will not be automatically updated in the Arcana wallet assets tab. Users will need to manually add custom tokens that are purchased via on-ramp providers as these providers do not provide the contract address of the purchased token.
-
You will not see any notifications for a successful purchase in the activity tab of the Arcana wallet. There is no uniform standard whereby on-ramp providers share this information or 'event' regarding purchase. We may add it in future releases.
Manage Token Assets
Click icon on the bottom left of the Arcana wallet to bring up the token assets tab. It displays the following information:
- View, and copy Arcana wallet address
- View wallet address details on the Block Explorer
- Add/Select network
- Refresh the wallet screen
- View 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 Arcana wallet guide.
Manage NFT Assets
Click icon on the bottom of the Arcana wallet to bring up the NFT assets tab. It displays the following information:
- View, and copy Arcana wallet address
- View wallet address details on the Block Explorer
- Refresh the wallet screen
- Add/Select network
- List NFT assets associated with the wallet address
- View NFT details
- Send, and share NFTs
- View NFT transaction activity
- Manage NFT collections
For details, see how to send, share and manage NFTs using Arcana wallet guide.
View User Profile Details
Click icon on the bottom of the Arcana wallet to see the user profile tab displaying these details:
- User name
- Email ID used to log into the wallet
- Network
- Wallet Address
- Option to export the private key
- Logout button
- Minimize / Close button
Wallet Notifications
Click icon on the bottom right of the Arcana wallet to see wallet notifications.
The wallet notifications tab list all transactions processed using the Arcana wallet for different digital assets such as native tokens, custom tokens, and NFTs. It also displays pending blockchain transaction approval requests, if any.
You can view all activities in the list or filter them based on whether the blockchain transactions were initiated by the user or the dApp. Click on the filter icon and choose the desired option.
If you see a red dot on the icon at the bottom left of the Arcana wallet, it indicates a pending blockchain transaction that a user needs to review and act upon.
Click on the icon to see details of the pending transaction and take appropriate action. The figure below shows a pending contract deployment transaction in the wallet notification tab:
Once all pending transactions are processed, you will not see the red dot. The Arcana wallet shows a No Pending Requests! message on the notification tab, once the user acts upon any pending requests.
Notification Example
Pending Personal Sign
Once the user is logged in using one of the available operations, the application can request the user to sign a personal signature request and authorize blockchain connectivity for the user before issuing any other blockchain transaction. Such pending user requests are highlighted when the wallet is minimized so that the user is notified of a pending request.If the wallet is displayed in the minimized state, users can click on it to maximize the wallet to view, approve the personal sign request as displayed in the figure below:
Export Private Key
Click icon 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.
Minimize Wallet
The Arcana wallet can be in one of the two states - maximized or minimized. The wallet UI can be minimized using the 'x' icon on the top right corner of the wallet screen. Minimized wallet displays as a small widget on the application window. To maximize the wallet, simply click on it.
During minimized state, if the dApp issues a transaction or if a user action results in a blockchain transaction that requires approval from the user, then the wallet screen is automatically changed to the maximized state in the application window.
Logout
Click the icon at the bottom of the Arcana wallet screen to bring up the user profile tab. Click Logout in the user profile tab to log out.
That is all!
You are now well-versed with various Arcana wallet screens and how to use the Arcana wallet to perform blockchain transactions.
What's Next?
It is highly recommended that you try out the Arcana sample demo app deployed at the portal:
This sample demo application integrates with Arcana Auth SDK. It is configured to enable dApp users to onboard using passwordless login and Google social authentication. When you bring up this dApp, you will see the Arcana wallet on the bottom right area of the screen. Click on it to log into the wallet and perform blockchain operations.