Skip to main content
The Crossmint Wallets node provides operations for managing blockchain wallets that can hold and transfer digital money like USDC.

​
Operations

​
Get or Create Wallet

Creates a non-custodial smart wallet or retrieves an existing one. You control it via a private key that authorizes all transactions. This operation is idempotent. Parameters:
  • Chain Type — Blockchain type (solana)
  • Owner Type — Optional owner identifier type (email, userId, phone, twitter, x, none)
  • Owner Details — Specific owner information based on the selected type
  • Admin Signer — Private key that authorizes all transactions from this wallet (see Admin Signer Private Key below)

​
Get Wallet

Retrieves wallet details using its locator (address, email, user ID, etc.). Parameters:
  • Wallet — Wallet identifier (address, email, userId, phone, twitter, x)
  • Chain Type — Required for non-address locators (solana)

​
Create Transfer

Sends tokens (like USDC) between wallets. Requires the wallet’s private key to sign and authorize. Parameters:
  • Blockchain Type — solana
  • Origin Wallet — Source wallet
  • Recipient Wallet — Destination wallet
  • Token Chain — Specific network (solana)
  • Token Name — Token symbol/identifier (e.g., usdc)
  • Amount — Token amount

​
Get Balance

Checks token balances for a wallet across one or more networks. Parameters:
  • Wallet — Locator (address, email, userId, phone, twitter, x)
  • Chain Type — Required for non-address locators (solana)
  • Chains — e.g., solana
  • Tokens — Comma-separated list of token symbols

​
Sign Transaction

Signs a transaction with a private key and submits the signature to complete pending transactions. Parameters:
  • Chain — Network for signing
  • Wallet Address — From the Create Transfer response
  • Transaction ID — ID that needs approval
  • Transaction Data — Hash/message to sign from transfer response
  • Signer Address — Address of the external signer
  • Signer Private Key — Private key to sign the transaction
  • Wait for Completion — Poll until final status

​
Wallet Locators

Wallet locators provide a flexible way to identify wallets with different identifiers.

​
Locator Types

TypeFormatExampleUse Case
Wallet AddressSolana address7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsUDirect blockchain address reference
Emailemail:{email}:{chainType}:smartemail:user@example.com:solana:smartUser identification by email
User IDuserId:{id}:{chainType}:smartuserId:user-123:solana:smartCustom user identifier
Phone NumberphoneNumber:{phone}:{chainType}:smartphoneNumber:+1234567890:solana:smartSMS-based identification
Twitter Handletwitter:{handle}:{chainType}:smarttwitter:username:solana:smartSocial media identification
X Handlex:{handle}:{chainType}:smartx:username:solana:smartX (formerly Twitter) identification
For more details, see Wallet Locators.

​
Chain Types

  • Solana — Solana blockchain

​
Admin Signer Private Key

The Admin Signer Private Key is a critical security component that gives you full control over your Crossmint wallet.

​
What is an Admin Signer?

The Admin Signer is the private key that acts as the “master key” for your smart wallet. It’s used to:
  • Authorize all transactions
  • Sign transfer approvals
  • Control wallet permissions and operations

​
Key Requirements

Solana
  • Base58 encoded string
  • Typically 64 bytes when decoded
  • Example: 5Kb8kLf9CJtPkDCe4jfE9TjC8d7X9e3Jh4F6h8F2K3h7J9F4K6h8F2K3h7J9F4K6h

​
Generating Private Keys

Online Tools Local/Terminal (recommended for production)
  1. Install Solana CLI — Installation guide
  2. Generate a keypair:
solana-keygen new --outfile ~/my-wallet.json --no-bip39-passphrase
cat ~/my-wallet.json
Hardware Wallets
  • Export/derive keys securely from Ledger or other hardware wallets
Security best practices
  1. Never share your private key
  2. Store in environment variables or secure vaults
  3. Use different keys for staging vs production
  4. Back up securely (multiple locations)
  5. Test with small amounts on testnet first
  6. Rotate keys periodically

​
How It Works in Crossmint

  1. Wallet Creation — Your private key becomes the admin signer for the smart wallet
  2. Transaction Flow — Create transaction → Crossmint generates approval → Sign with private key → Submit signature
  3. Non-Custodial — You control the key and the wallet

​
Get Test USDC

For testing in the Staging environment, you can get free test USDC:

​
Next Steps

Checkout Node

Learn about the Checkout node for automated purchases

Example Workflows

See the Wallets node in action

Source Code

Browse source code

Ask ChatGPT

Ask Crossmint Expert GPT for n8n guidance
⌘I