Try It Out¶
Download Our Sample Codebase¶
To run the demo and test your integration with the Cactus Custody SDK, follow the steps below.
Checksum Validation For Security¶
You can verify the integrity of the downloaded file by comparing its SHA256 hash with the value below.
SHA256 Checksum¶
How to validate¶
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:¶
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¶
| Path | Description |
|---|---|
| proxy/CustodyDemo.java | Entry point. Main API proxy corresponding to the API documentation |
| util/CustodyHttpUtil.java | Encapsulates HTTP headers required for calling the custody APIs |
| util/ConfigUtil.java | Holds static configuration values such as URLs and key paths |
| util/DateUtil.java | Helper for time/date formatting and calculation |
| util/HttpClientUtil.java | Generic HTTP utility for making requests |
| util/IOUtil.java | File and IO utility helpers |
| util/SignUtil.java | Handles digital signature creation and verification |
Cactus Custody API Limitations¶
- Business lines and wallets must be created manually in the admin web portal (not via API).
- Each enterprise account has a unique API Key and AK ID.
- Access control is achieved by assigning different permissions to business lines.
- Wallet IDs are assigned by the system and cannot be edited. Example of a wallet ID :
CHEVMS5368231100 - Business Line IDs can be found in the Business Line Management section on the portal.