Skip to content

Try It Out

Download Our Sample Codebase

To run the demo and test your integration with the Cactus Custody SDK, follow the steps below.

Download the Java SDK

Checksum Validation For Security

You can verify the integrity of the downloaded file by comparing its SHA256 hash with the value below.

SHA256 Checksum

a72275911dced05d97f6dcbdd16714ac36a25cbd8b6107bfb83938458fd7d3fd

How to validate

shasum -a 256 cactus-sdk-java.zip
Get-FileHash cactus-sdk-java.zip -Algorithm SHA256

If the output matches the SHA256 hash provided above, the file is intact and safe to use.

Prerequisites

Before you begin, ensure you’ve completed the steps outlined in Preparation, which includes:

  • Setting up your enterprise account on the Cactus Custody web portal
  • Obtaining your API credentials (AKID, API Key)

Execution Steps

Set the Signing Key Path Update the following line in util/ConfigUtil.java:

public static final String SIGN_PRIVATE_PATH = "resources/mypriv.jks";

Start the Demo. Run the main method in proxy/CustodyDemo.java.

Be sure to modify the configuration in ConfigUtil.java to reflect your environment variables and account-specific values.


Folder Structure

PathDescription
proxy/CustodyDemo.javaEntry point. Main API proxy corresponding to the API documentation
util/CustodyHttpUtil.javaEncapsulates HTTP headers required for calling the custody APIs
util/ConfigUtil.javaHolds static configuration values such as URLs and key paths
util/DateUtil.javaHelper for time/date formatting and calculation
util/HttpClientUtil.javaGeneric HTTP utility for making requests
util/IOUtil.javaFile and IO utility helpers
util/SignUtil.javaHandles digital signature creation and verification

Cactus Custody API Limitations

  1. Business lines and wallets must be created manually in the admin web portal (not via API).
  2. Each enterprise account has a unique API Key and AK ID.
  3. Access control is achieved by assigning different permissions to business lines.
  4. Wallet IDs are assigned by the system and cannot be edited. Example of a wallet ID : CHEVMS5368231100
  5. Business Line IDs can be found in the Business Line Management section on the portal.