身份验证

headers = {
  "Biz-Api-Key": {YOUR_API_KEY}.hex(),
  "Biz-Api-Nonce": {Nonce},
  "Biz-Api-Signature": {YOUR_API_SIGNATURE}.hex(),
}

• Biz-Api-Key：用于请求的 API Key。更多详情，请参阅 API Key。
• Biz-Api-Nonce：随机数。随机数是以毫秒为单位的当前 Unix 时间戳。
• Biz-Api-Signature：API 签名。要了解如何计算 API 签名，请参阅计算 API 签名。

​

API Key 和 API Secret

​

API Key

​

API Secret

• API Key 包含在 API 请求中，使 Cobo 支付服务能够识别客户端。使用前您需要在 Cobo Portal 上注册 API Key。
• API Secret 用于生成每个 API 请求的签名。Cobo 支付服务验证签名以确认请求的真实性和防止篡改。

​

生成 API Key 和 API Secret

​

使用 OpenSSL

openssl genpkey -algorithm ed25519 -out private_key.pem

openssl pkey -in private_key.pem -pubout -out public_key.pem

echo "Private Key (Hex):"
openssl pkey -in private_key.pem -text | grep 'priv:' -A 3 | tail -n +2 | tr -d ':\n ' && echo

echo "Public Key (Hex):"
openssl pkey -pubin -in public_key.pem -text | grep 'pub:' -A 3 | tail -n +2 | tr -d ':\n ' && echo

Private Key (Hex):
06f78882576ec0e05b1e51a33548da7e8cf958c190ba96be77b1c671f98a2b5f
Public Key (Hex):
5987dedc180167b7ab1d27e6009e5065d10d764cd85d7b64f8c968ca40326e28

​

使用 Python 库

1. 安装 PyNaCl Python 库。 在终端窗口中，运行以下命令：
   pip install PyNaCl
   
2. 生成密钥对。 从 Python 库导入函数生成基于 Ed25519 算法的密钥对，如下所示：
   from nacl.signing import SigningKey
   # 创建密钥对。
   sk = SigningKey.generate()
   # 打印十六进制格式的私钥
   print("私钥:", sk.encode().hex())
   # 打印十六进制格式的公钥
   print("公钥:", sk.verify_key.encode().hex())
   

​

注册 API Key

​

随机数

​

计算 API 签名

1. 首先，基于您的请求拼接出一个字符串，如下所示： str_to_sign = {METHOD}|{PATH}|{TIMESTAMP}|{PARAMS}|{BODY}

   字段	描述	示例
   METHOD	HTTP 方法。	GET
   PATH	API 端点。	/v2/payments/topup/address
   TIMESTAMP	以毫秒为单位的当前 Unix 时间戳。该值必须与请求头中的随机数相同。	1718587017026
   PARAMS	（如有）查询参数。	chain_id=ETH&limit=10
   BODY	（如有）原始请求包体的字符串格式。	{"name":"Default","wallet_subtype":"Asset","wallet_type":"Custodial"}

2. 使用 hashlib 库对字符串进行两次 SHA-256 哈希，如下所示：
   import hashlib
   content_hash = hashlib.sha256(hashlib.sha256(str_to_sign.encode()).digest()).digest()
   
3. 使用 API Secret 对字符串进行签名，如下所示：
   from nacl.signing import SigningKey
   
   # 创建 Ed25519 签名密钥。将 `api_secret` 替换为您的 API Secret
   sk = SigningKey(bytes.fromhex(api_secret))
   # 签署哈希后的消息
   signature = sk.sign(content_hash).signature.hex()