> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crossmint.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Wallets Node

> Manage blockchain wallets, balances, and token transfers

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](#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

| Type               | Format                                  | Example                                        | Use Case                            |
| ------------------ | --------------------------------------- | ---------------------------------------------- | ----------------------------------- |
| **Wallet Address** | Solana address                          | `7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU` | Direct blockchain address reference |
| **Email**          | `email:{email}:{chainType}:smart`       | `email:user@example.com:solana:smart`          | User identification by email        |
| **User ID**        | `userId:{id}:{chainType}:smart`         | `userId:user-123:solana:smart`                 | Custom user identifier              |
| **Phone Number**   | `phoneNumber:{phone}:{chainType}:smart` | `phoneNumber:+1234567890:solana:smart`         | SMS-based identification            |
| **Twitter Handle** | `twitter:{handle}:{chainType}:smart`    | `twitter:username:solana:smart`                | Social media identification         |
| **X Handle**       | `x:{handle}:{chainType}:smart`          | `x:username:solana:smart`                      | X (formerly Twitter) identification |

For more details, see <a href="https://docs.crossmint.com/api-reference/wallets/get-wallet-by-locator" rel="noopener">Wallet Locators</a>.

### 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**

* **Crossmint Generator**: <a href="https://crypto-address-generator.val.run/" rel="noopener noreferrer">[https://crypto-address-generator.val.run/](https://crypto-address-generator.val.run/)</a>

**Local/Terminal (recommended for production)**

1. Install Solana CLI — <a href="https://solana.com/docs/intro/installation" rel="noopener noreferrer">Installation guide</a>
2. Generate a keypair:

```bash theme={null}
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

<Callout type="warning">
  <b>Security best practices</b>

  <ol>
    <li>Never share your private key</li>
    <li>Store in environment variables or secure vaults</li>
    <li>Use different keys for staging vs production</li>
    <li>Back up securely (multiple locations)</li>
    <li>Test with small amounts on testnet first</li>
    <li>Rotate keys periodically</li>
  </ol>
</Callout>

### 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:

* **Circle Faucet**: <a href="https://faucet.circle.com/" rel="noopener noreferrer">[https://faucet.circle.com/](https://faucet.circle.com/)</a>

## Next Steps

<CardGroup cols={2}>
  <Card title="Checkout Node" icon="credit-card" href="/solutions/n8n/nodes/checkout">
    Learn about the Checkout node for automated purchases
  </Card>

  <Card title="Example Workflows" icon="diagram-project" href="/solutions/n8n/example-workflows">
    See the Wallets node in action
  </Card>

  <Card title="Source Code" icon="github" href="https://github.com/crossmint/n8n-nodes-crossmint">
    Browse source code
  </Card>

  <Card title="Ask ChatGPT" icon="comments" href="https://chatgpt.com/g/g-68d13ccc81ac8191a0c3716ce980faff-n8n-crossmint-expert">
    Ask Crossmint Expert GPT for n8n guidance
  </Card>
</CardGroup>