Design Guide

Overview

Embedding a wallet in your application is really straight-forward using our API's...

First, you create the user's wallet, then:

Recommended:

• Displaying NFT’s to the user
• Permitting someone to send an NFT to marketplaces or other users
  wallets

Optional:

• Viewing other things that a user might hold in their wallet (e.g.
  cryptocurrency)
• Depositing NFTs (and crypto) into their wallet
• View their transaction history
• Linking their wallet to other platforms using WalletConnect

Create a wallet for a user

Creating a wallet for a user is a simple API request:

POST /v1/wallets

//Sample Request
{
  "name": "John Doe's Wallet"
}

//Sample Response
{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "John Doe's Wallet"
}

Displaying NFTs in a users wallet

Your users will want to see two things:

• their entire NFT collection
• the details (graphic, video, music, images, etc) of an NFT once they click on it

Here's how these look in the Fortress App:

You can see the exact API calls we're using in the NFT Balances section.

Withdrawals (Send NFT)

You'll want to let your users withdraw (or send) the NFT to a marketplace or someone else’s wallet to enable gifting, secondary sales on marketplaces, and to take advantage of the web3 ecosystem such as metaverses.

In the Fortress App, sending an NFT looks like this:

You can see the exact API calls we're using in the Deposit/Withdrawals section.

Showing your user their crypto balances

If you (optional) enable your users’ wallets to hold cryptocurrency, showing a user their crypto balances helps them to understand how much crypto they have to pay for gas fees, how much they have to spend, or how much they can use in your application.

In the Fortress App, we show it like this and include a real time crypto price to put things into context:

You can see the exact API calls we're using in the Crypto Balances section.

Depositing crypto & NFTs (from external sources)

If you want to allow users to send crypto and NFTs to their wallet from outside your application, you can easily create a deposit flow. Note that tokens on the same blockchain (e.g. ETH, USDC, and Matic) and NFTs all go to the same address so this flow is really simple.

In the Fortress App it looks like this:

You can see the exact API calls we're using in the Deposit/Withdrawals section.

View the transaction history

Providing a transaction history so users can see what transactions have happened in their wallet is important to the majority of your audience. And this becomes even more useful as you enable more flows, more tokens, and more general functionality.

In the Fortress App it looks like this:

You can see the exact API calls we're using in the Transactions section.

Link the wallet to another platform using WalletConnect

If you want your user's wallets to be linkable to other platforms, such as marketplaces and metaverses, then our WalletConnect option is the key.