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.

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.

Clicking on it displays the maximized wallet UI on the left or the right side of the app's UI window as configured by the app developer.

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
• 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 icon on the top right of the Arcana wallet, the wallet switches from maximized to the minimized state but continues to show in the app screen. 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 notification, it disappears and the wallet displays No Pending Requests! message.

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:

• 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 the tab to bring up the wallet token asset screen. Use the network drop-down list to switch to a different network.

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:

• Transak
• Ramp Network
• Onramp Money

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. 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 the first purchase, you may also be required to do KYC formalities as per the terms and conditions of the provider that is selected in the wallet.

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

• Transak User Guide
• Ramp User Guide
• Onramp Money User Documentation

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

• Transak coverage
• Ramp Network coverage
• Onramp Money coverage

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 tab on the bottom right of the Arcana wallet to view the notifications screen.

The notifications tab of the Arcana wallet lists all transactions processed using the 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 app. 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 red dot 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.

>

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 right corner.

In the minimized state, the wallet displays a red dot with a number indicating pending transactions waiting for the user's approval,

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 allows 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 top right arrow icon, 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

• Arcana wallet capabilities
• Configure the Arcana wallet