Crypto APIs icon

Crypto APIs

Interact with Crypto APIs REST API

Actions113

Overview

This node operation, "Derive And Sync New Receiving Addresses EVM" under the "HD Wallets" resource, interacts with a Crypto APIs REST API to derive and synchronize new receiving addresses for Ethereum Virtual Machine (EVM) compatible blockchains. It uses an extended public key (xPub) to generate new wallet addresses on a specified blockchain network.

Common scenarios where this node is beneficial include:

  • Automatically generating new receiving addresses for wallets in EVM-compatible blockchains like Ethereum, Binance Smart Chain, Polygon, etc.
  • Synchronizing wallet addresses derived from an HD wallet to keep track of all generated addresses.
  • Integrating address derivation into automated workflows for crypto payment processing or wallet management.

Practical example:

  • A user wants to generate new receiving addresses for their Ethereum wallet using an extended public key and keep them synchronized for incoming payments. This node can be used to derive those addresses programmatically within an n8n workflow.

Properties

Name Meaning
blockchain The target blockchain network for which to derive addresses (e.g., Ethereum, BSC).
extendedPublicKey The extended public key (xPub) used to derive new receiving addresses.
network The specific network within the blockchain (e.g., mainnet, testnet) to operate on.
context Optional string to provide additional context or metadata for the request.
JSON Body Additional parameters as a JSON collection to customize the API request body if needed.

Output

The output is a JSON array containing the results returned by the Crypto APIs endpoint for deriving and syncing new receiving addresses. Each item in the output array corresponds to a derived address or related data returned by the API.

If the API supports binary data output, it would typically represent associated cryptographic material or files, but this node primarily outputs JSON data representing wallet addresses and synchronization status.

Dependencies

  • Requires an active connection to the Crypto APIs REST API service.
  • Needs an API authentication token or API key credential configured in n8n to authorize requests.
  • Relies on the presence of the extended public key and correct blockchain/network identifiers.
  • Uses internal helper functions to make HTTP requests to the Crypto APIs endpoints.

Troubleshooting

  • Common issues:

    • Invalid or malformed extended public key leading to API errors.
    • Incorrect blockchain or network names causing the API to reject the request.
    • Missing required parameters resulting in validation errors.
    • Network connectivity or authentication failures with the Crypto APIs service.
  • Error messages and resolutions:

    • "Operation <operationName> not found": Indicates the requested operation is not defined; ensure the operation name matches exactly.
    • API response errors about invalid keys or parameters: Verify that the extended public key and blockchain/network values are correct and supported.
    • Authentication errors: Confirm that the API key credential is properly set up and has necessary permissions.
    • If the node returns an error object in the output JSON, check the error message for details and adjust input parameters accordingly.

Links and References

Discussion