创建推荐码

为当前用户生成唯一的 8 位推荐码（大写十六进制）。每个用户只能创建一次。

POST /referral/codes
Authorization: Bearer <token>
Content-Type: application/json

请求体

{
  "signature": "0x...",
  "timestamp": 1772010600
}

字段	类型	必填	说明
signature	string	是	EIP-712 签名
timestamp	uint64	是	Unix 时间戳（秒），必须在 5 分钟内

EIP-712 签名

TypeHash: CreateReferralCode(address wallet,uint256 timestamp)

{
  "primaryType": "CreateReferralCode",
  "types": {
    "CreateReferralCode": [
      { "name": "wallet", "type": "address" },
      { "name": "timestamp", "type": "uint256" }
    ]
  },
  "message": {
    "wallet": "0x<your_address>",
    "timestamp": 1772010600
  }
}

响应

{
  "success": true,
  "code": "4DDDC2D4",
  "created_at": 1772010604000
}

字段	类型	说明
success	bool	是否创建成功
code	string	生成的 8 位推荐码
created_at	int64	创建时间（毫秒时间戳）

错误码

HTTP	错误码	说明
400	TIMESTAMP_EXPIRED	时间戳超过 5 分钟有效期
400	INVALID_SIGNATURE_FORMAT	签名格式无效
401	SIGNATURE_INVALID	EIP-712 签名验证失败
409	CODE_ALREADY_EXISTS	已创建过推荐码
500	DB_ERROR	服务端错误

代码示例

Python

import time, requests
from eth_account import Account
from eth_account.messages import encode_typed_data

BASE_URL = "https://api.ztdx.io"
JWT_TOKEN = "your_jwt_token"
PRIVATE_KEY = "your_private_key"

wallet = Account.from_key(PRIVATE_KEY)
timestamp = int(time.time())

# Build EIP-712 typed data
typed_data = {
    "types": {
        "EIP712Domain": [
            {"name": "name", "type": "string"},
            {"name": "version", "type": "string"},
            {"name": "chainId", "type": "uint256"},
        ],
        "CreateReferralCode": [
            {"name": "wallet", "type": "address"},
            {"name": "timestamp", "type": "uint256"},
        ],
    },
    "primaryType": "CreateReferralCode",
    "domain": {"name": "ZTDX", "version": "1", "chainId": 421614},
    "message": {"wallet": wallet.address, "timestamp": timestamp},
}

signable = encode_typed_data(full_message=typed_data)
signed = wallet.sign_message(signable)

resp = requests.post(
    f"{BASE_URL}/referral/codes",
    headers={"Authorization": f"Bearer {JWT_TOKEN}", "Content-Type": "application/json"},
    json={"signature": signed.signature.hex(), "timestamp": timestamp},
)
print(resp.json())
# {"success": true, "code": "4DDDC2D4", "created_at": 1772010604000}