Crossmint icon

Crossmint

Hybrid integration: transfer money using Crossmint with external wallet support

Actions7

Overview

This node enables creating a token transfer between wallets on supported blockchains (EVM-compatible chains like Ethereum, Polygon, Base, and Solana). It facilitates sending tokens from an origin wallet to a recipient wallet by specifying the blockchain type, token details, and amount. This is useful for automating token transfers in workflows such as payments, rewards distribution, or asset management across different blockchain networks.

For example, you can use this node to send USDC tokens on the Ethereum Sepolia testnet from one wallet address to another, or transfer tokens between user accounts identified by email or social handles linked to their wallets.

Properties

Name Meaning
Blockchain Type Blockchain type for both origin and recipient wallets (must be the same). Options: EVM (Ethereum Virtual Machine chains like Ethereum, Polygon, Base, etc.), Solana.
Origin Wallet The source wallet for the token transfer. Can be specified by: Address, Email, User ID, Phone Number, Twitter handle, or X handle.
Recipient Wallet The destination wallet for the token transfer. Same modes as Origin Wallet: Address, Email, User ID, Phone Number, Twitter handle, or X handle.
Token Chain The blockchain network where the token resides (e.g., "ethereum-sepolia"). Required to identify the correct token environment.
Token Name The symbol or name of the token to transfer (e.g., "usdc").
Amount The amount of tokens to send, in decimal format (e.g., "10.50"). Must be a positive number.

Output

The node outputs a JSON object with two main parts:

  • simplified-output: A concise summary including:

    • chainType: Blockchain type used.
    • walletType: Type of wallet involved.
    • from: The origin wallet details as provided.
    • to: The recipient wallet details as provided.
    • chain: The specific chain extracted from the response calls.
    • id: Transfer transaction ID.
    • status: Current status of the transfer.
    • approvals: Any approval data related to the transfer.

  • raw: The full raw API response from the transfer creation endpoint.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the Crossmint API.
  • The node makes HTTP requests to either the production or staging Crossmint API endpoints depending on the configured environment.
  • No additional external libraries are required beyond those bundled (ethers.js for EVM wallet handling, solana/web3.js and bs58 for Solana).

Troubleshooting

  • Missing or invalid parameters: The node validates required fields like amount, token chain, token name, and wallet identifiers. Errors will indicate missing or invalid inputs.
  • Invalid wallet mode: If the origin or recipient wallet mode is unsupported, an error will be thrown.
  • Amount validation: The amount must be a valid positive number; otherwise, an error occurs.
  • API errors: Network or API errors will be surfaced as node errors. Check your API key validity and network connectivity.
  • Wallet address format: Wallet addresses must match expected regex patterns; invalid formats cause validation errors.
  • Blockchain type mismatch: Both origin and recipient wallets must use the same blockchain type.

Links and References

Discussion