跳转至

试用示例

下载示例代码库

要运行 Demo 并测试您与 Cactus Custody SDK 的集成,请按照以下步骤操作。

下载 Java SDK

安全性校验和验证

您可以通过将下载文件的 SHA256 哈希值与下面的值进行比较来验证文件的完整性。

SHA256 校验和

a72275911dced05d97f6dcbdd16714ac36a25cbd8b6107bfb83938458fd7d3fd

如何验证

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

如果输出的 SHA256 哈希值与上述提供的值一致,则说明文件完整、安全,可以使用。

前置条件

在开始之前,请确保您已完成准备工作中概述的步骤,其中包括:

  • 在 Cactus Custody 网页门户上设置您的企业账户
  • 获取您的 API 凭证(AK ID、API Key)

执行步骤

设置签名密钥路径

在 util/ConfigUtil.java 中更新以下行:

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

启动演示程序

运行 proxy/CustodyDemo.java 中的 main 方法。

请确保修改 ConfigUtil.java 中的配置以反映您的环境变量和账户特定值。


文件夹结构

路径描述
proxy/CustodyDemo.java程序入口。主要 API 代理,对应 API 文档
util/CustodyHttpUtil.java封装调用 Custody API 所需的 HTTP Header 信息
util/ConfigUtil.java存放静态配置值,如请求 URL、密钥路径等
util/DateUtil.java时间/日期格式化与计算辅助类
util/HttpClientUtil.java通用 HTTP 请求工具类
util/IOUtil.java文件与 IO 操作辅助工具类
util/SignUtil.java数字签名的创建与验证工具类

Cactus Custody API 限制

  1. 业务线和钱包必须在管理网页门户中手动创建(不能通过 API 创建)。
  2. 每个企业账户都有唯一的 API Key 和 AK ID。
  3. 通过为业务线分配不同的权限来实现访问控制。
  4. 钱包 ID 由系统自动分配且不可编辑。钱包 ID 示例:CHEVMS5368231100。
  5. 业务线ID可以在门户的业务线管理部分找到。