Wallet Actions

Use APIs to interact with your users’ wallets

Crossmint’s Smart Wallet SDK is headless by design, enabling you to fine tune the customer experience.

The SDK provides several functions to simplify the process of embedding the wallet in your app, including fetching the assets for display, signing messages, and signing transactions.

• Fetching the wallet's contents
• Signing messages
• Signing transactions

Fetching NFTs

The SDK includes a client-side utility function to fetch the NFTs. Simply pass the address and chain you’d like to retrieve the NFTs for. There is also a server-side API that can fetch NFTs for a given wallet address.

In the Crossmint console, create an API key with the wallets:nfts.read scope. This scope supports both client-side and server-side API keys. Ensure you pick right type of API key for your implementation and never use a server-side key in the client-side of your application.

import { EVMSmartWallet } from "@crossmint/client-sdk-smart-wallet";

async function getNFTs(wallet: EVMSmartWallet) {
    return await wallet.nfts();
}

Example response

[
  {
    "chain": "chain-slug",
    "contractAddress": "0x_contract_address",
    "tokenId": "1",
    "metadata": {
      // removed for brevity
    },
    "locator": "<chain>:<contract_address>:<token_id>",
    "tokenStandard": "erc-721" | "erc-1155"
  }
]

Fetching Fungible Tokens

Checking the fungible token balance on testnets may result in empty responses as these are not indexed as thoroughly as mainnets. Consider using the production API for this endpoint in your testing.

Example response

Note that the tokenBalance is returned in hexadecimal format. You’ll need to parse that in your application.

[
    {
        "contractAddress": "0x14196f08a4fa0b66b7331bc40dd6bcd8a1deea9f",
        "tokenBalance": "0x000000000000000000000000000000000000000000000000000000025a9a5b80",
        "tokenMetadata": {
            "decimals": 6,
            "logo": null,
            "name": "USD Coin",
            "symbol": "USDC"
        }
    }
]