Skip to content

Basic Web3 Wallet Operations

This guide is intended for Web3 application users. Developers who wish to programmatically enable various wallet operations can refer to the developer guides listed below.

Developer Guides

To enable Arcana wallet in the context of a Web3 application, you need to first register your Web3 application and configure user authentication mechanisms using the Arcana Dashboard.

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:

  • Token Assets Tab
  • NFT Assets Tab
  • User Profile Tab
  • Notification Tab

These tab contains 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
  • 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 a 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, the wallet is displayed in the minimized form with a red dot and number indicating a pending transaction.

Once the user takes action on the pending transaction, the notification screen 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 screen. Use the network drop-down list to switch to a different network from the list of configured networks.





Manage Token Assets

Click icon on the bottom left of the Arcana wallet to bring up the token assets screen. 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 screen. 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 screen with 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 screen 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 screen:

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 screen, once the user acts upon any pending requests.

No pending request>

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 user is notified of a pending request.

dApp wallet integration example

Users can click on the wallet to bring up the Full UI wallet visibility mode and review, and approve the personal sign request as displayed in the figure below:

Demo App PersonalSign

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

If the dApp developer has integrated the Arcana Auth SDK and specified the 'Full UI' wallet visibility mode, the Arcana wallet can be minimized using the 'x' icon on the top right corner of the wallet screen. Minimized wallet displays as a circular widget on the dApp window.





During minimized state, if the dApp issues a transaction or if a user action results in a blockchain transaction sign request, the wallet screen shows up again in its maximized form in the dApp window.

Logout

Click icon in the bottom of the Arcana wallet screen. To log out of the Arcana wallet and the dApp, use Logout in the user profile screen.





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.

See also


Last update: January 11, 2023 by shaloo