Turnkey

Use Turnkey

Actions7

Overview

This node integrates with the Turnkey platform to manage cryptocurrency wallets and related operations within an organization. Specifically, the List Wallets operation retrieves a list of all wallets available under a specified Turnkey organization.

Common scenarios where this node is beneficial include:

Automating wallet management workflows by fetching all wallets for auditing or reporting.
Integrating wallet data into broader financial or blockchain automation pipelines.
Quickly accessing wallet lists to enable further operations like signing transactions or managing accounts.

Example use case: A user wants to retrieve all wallets in their organization to display them in a dashboard or to select one for subsequent transaction signing.

Properties

Name	Meaning
Authentication	Method of authentication; currently supports "API Key"
Organization ID	The unique identifier of the Turnkey organization whose wallets are to be listed

Output

The output is a JSON object containing the list of wallets retrieved from the Turnkey platform for the specified organization. The exact structure depends on the Turnkey API response but typically includes wallet identifiers, names, and metadata.

No binary data is output by this operation.

Example output snippet (conceptual):

{
  "wallets": [
    {
      "walletId": "string",
      "walletName": "string",
      "createdAt": "timestamp",
      ...
    },
    ...
  ]
}

Dependencies

Requires an API key credential for authenticating with the Turnkey platform.
Uses the Turnkey client library (@turnkey/http) and an API key stamper utility (@turnkey/api-key-stamper) internally.
No additional environment variables are explicitly required beyond the API key credential configuration.

Troubleshooting

Common issues:
- Missing or invalid API key credential will cause authentication failures.
- Incorrect or empty Organization ID will result in errors or empty wallet lists.
- Network connectivity issues can prevent communication with the Turnkey API.
Error messages:
- "Failed to execute operation: <message>" indicates an error during the API call or internal processing. Check the message for details such as authentication failure or invalid parameters.
- "Operation listWallets not supported" would occur if the operation parameter is incorrectly set (not applicable here since "listWallets" is valid).
Resolutions:
- Ensure the API key credential is correctly configured and has necessary permissions.
- Verify the Organization ID is correct and belongs to your Turnkey account.
- Confirm network access to the Turnkey API endpoint.

Links and References

Turnkey Platform Documentation (general reference for API and wallet management)
n8n Documentation for configuring credentials and using custom nodes

TurnkeyInstall