Crossmint icon

Crossmint

Hybrid integration: transfer money using Crossmint with external wallet support

Actions6

Overview

The "Get or Create Wallet" operation in the Crossmint node allows users to either retrieve an existing blockchain wallet or create a new one on supported blockchains. This operation supports multiple blockchain types, specifically Ethereum Virtual Machine (EVM) compatible chains and Solana.

This node is beneficial in scenarios where you need to programmatically manage wallets for users or companies without manually handling private keys. For example, it can be used to onboard users by creating wallets linked to their email, phone number, or social media handles, enabling seamless blockchain interactions such as token transfers or balance checks later on.

Practical examples:

  • Creating a new wallet for a user identified by their email address on the Ethereum blockchain.
  • Retrieving an existing wallet associated with a Twitter handle on Solana.
  • Automatically provisioning wallets for customers in a dApp backend based on user IDs.

Properties

Name Meaning
Chain Type Blockchain type for the wallet. Options: EVM (Ethereum Virtual Machine), Solana
Owner Type (Optional) Type of user locator to identify the wallet owner. Options: None, Email, User ID, Phone Number, Twitter Handle, X Handle
Owner Email Email address of the wallet owner (required if Owner Type is Email)
Owner User ID User ID of the wallet owner (required if Owner Type is User ID)
Owner Phone Number Phone number of the wallet owner with country code (required if Owner Type is Phone Number)
Owner Twitter Handle Twitter handle of the wallet owner without '@' (required if Owner Type is Twitter Handle)
Owner X Handle X handle of the wallet owner without '@' (required if Owner Type is X Handle)

Output

The output JSON contains the wallet information returned from the Crossmint API after creating or retrieving the wallet. This typically includes details such as wallet address, chain type, owner identifier, and configuration metadata.

No binary data output is produced by this operation.

Example output structure (simplified):

{
  "id": "wallet-id",
  "address": "0x1234567890abcdef...",
  "chainType": "evm",
  "owner": "email:user@example.com",
  "type": "smart",
  "config": {
    "adminSigner": {
      "type": "api-key"
    }
  }
}

Dependencies

  • Requires an API key credential for authenticating with the Crossmint API.
  • The node makes HTTP requests to the Crossmint API endpoints, which differ based on environment (Production or Staging).
  • No additional external dependencies are required beyond network access to Crossmint's API.

Troubleshooting

  • Missing Required Fields: If you select an owner type other than "None", you must provide the corresponding owner identifier (e.g., email, user ID). Failure to do so will result in an error indicating the missing field.
  • Invalid Chain Type: Only "evm" and "solana" are supported chain types. Using unsupported values will cause errors.
  • API Key Issues: Ensure that a valid API key credential is configured. Authentication failures will return errors from the Crossmint API.
  • Network Errors: Connectivity issues to the Crossmint API endpoint may cause request failures.
  • Unexpected API Responses: If the API returns unexpected data or errors, verify the input parameters and consult Crossmint API documentation.

Common error messages:

  • "Please specify the [field]" — indicates a required parameter was not provided.
  • "Unsupported locator type" — indicates an invalid owner type was selected.
  • API authentication errors — check API key validity and permissions.

Links and References

This summary focuses exclusively on the "Wallet" resource and the "Get or Create Wallet" operation as requested.

Discussion