Skip to content

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 Developers Guide.

Arcana wallet Developer Guide

To enable the Arcana wallet in the context of a Web3 app, developers must first register the app and configure social providers via the Arcana Developer Dashboard to authenticate users.

Next, follow the instructions to integrate the app and then add code to onboard users. The authenticated users can instantly access the Arcana wallet in the context of the app. Developers can add code to bring up the wallet UI in the context of the authenticated users, initiated Web3 wallet operations, and enable authenticated users to sign blockchain transactions.

For more details, see Arcana Auth Quick Start Guide and the Arcana wallet Developers Guide.

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.

Arcana wallet Features

Any Web3 app that integrates with the Arcana Auth SDK can enable authenticated users to sign blockchain transactions using the Arcana wallet UI.

The Arcana wallet UI allows an authenticated user 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 NFTs (ERC-721, ERC-1155)
    • Add NFTs
    • Modify (edit, delete) NFTs
  • View user profile details
  • Monitor blockchain transaction-related activity
  • Export private key
  • Logout

When a user logs in to the app, Arcana wallet is displayed in its minimized form in the app's context. The wallet is positioned on the left or the right side of the app's UI window as configured by the app developer, during app registration and configuration.

Clicking on it displays the maximized wallet UI.

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

The Arcana wallet allows authenticated app users to sign blockchain transactions on various supported blockchain networks. By default, a few of the supported networks are automatically displayed on the wallet home screen. Users can select a different network from the drop-down list. Additional networks can be added to the default list as long as they are supported by Arcana Auth.

To add a network, go to the 'Token Assets' tab in the Arcana wallet and select 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 the updated network list.

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 'Token Assets' tab:

This will bring up a list of default networks available in the current application's context. Choose one of the available networks to switch to a different one.

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 the 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 the and refer to the token assets 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 in a new browser tab. You can complete the process on the provider's website. A notification regarding buying transaction initiation will be displayed in the Arcana wallet. The user can dismiss it and continue to use the wallet while the buying process is underway.

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.

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.

Ramp

If the fiat on-ramp provider Ramp Network is selected, the Ramp UI pops up displaying all the available currencies for the selected chain in the Arcana wallet.

Onramp Money

If the Arcana wallet user chooses Onramp Money as the provider, the following user interface of the provider takes over and helps the user to load the wallet with the required cryptocurrency.

For step-by-step details on buying crypto assets, see the supported provider documentation:

For details on what assets and cryptocurrency, countries are supported by these providers refer to provider documentation:

Current Limitations

  1. Purchased token assets will not be automatically updated in the Arcana wallet assets screen. 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.

  2. 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.

Manage Token Assets

Click the 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 tab on the bottom of the Arcana wallet to bring up the NFT assets tab view and manage NFTs associated with the wallet address. The following NFT operations can be performed by the authenticated Web3 app user through the NFT Assets tab:

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 tab on the bottom of the Arcana wallet to see the user profile 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 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 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 simply shows the transaction details for a review by the user 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.

See also

Last update: June 12, 2023 by shaloo, shalz