Crypto APIs icon

Crypto APIs

Interact with Crypto APIs REST API

Actions113

Overview

This node operation "Derive And Sync New Receiving Addresses XRP" under the "HD Wallets" resource interacts with a Crypto APIs REST API to derive and synchronize new receiving addresses specifically for the XRP blockchain. It is useful in scenarios where users manage hierarchical deterministic (HD) wallets and need to programmatically generate fresh receiving addresses for XRP, ensuring wallet address management is automated and synchronized with the blockchain state.

Practical examples include:

  • Automatically generating new XRP receiving addresses for user wallets in a crypto exchange or wallet service.
  • Synchronizing wallet addresses after importing an extended public key to keep track of all derived addresses.
  • Managing multiple XRP accounts by deriving addresses on demand without exposing private keys.

Properties

Name Meaning
blockchain The blockchain network to use; here it should be set to the XRP blockchain identifier.
extendedPublicKey The extended public key (xpub) from which new receiving addresses will be derived.
network The specific XRP network environment (e.g., mainnet, testnet) to operate on.
context Optional string to provide additional context or metadata for the request.
JSON Body A collection of additional parameters to customize the request body sent to the API.

Output

The node outputs a JSON array where each item corresponds to the result of the API call to derive and sync new XRP receiving addresses. The JSON structure typically includes details about the newly derived addresses, such as their public keys, derivation paths, and synchronization status.

If binary data were involved (not indicated here), it would represent raw data related to addresses or transactions, but this operation focuses on JSON data output.

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.
  • The node reads a local OpenAPI specification file (2024-12-12-final.json) bundled with the node to map operations and parameters.
  • Uses internal helper functions to perform HTTP requests to the Crypto APIs endpoints.

Troubleshooting

  • Common issues:

    • Incorrect or missing extended public key can cause failure in deriving addresses.
    • Using an unsupported or incorrect blockchain/network value may lead to errors.
    • Network connectivity or API authentication failures will prevent successful API calls.
  • Error messages:

    • Operation <operationName> not found: Indicates the requested operation is not defined in the API spec or the node configuration; verify the operation name.
    • API response errors (e.g., unauthorized, bad request) will be returned as error messages in the output JSON if "Continue On Fail" is enabled.
  • Resolutions:

    • Ensure all required properties are correctly set.
    • Verify API credentials and network availability.
    • Check that the extended public key is valid and corresponds to the specified blockchain and network.

Links and References

Discussion