tomevault-io KryptoGO Payment 代幣轉帳/提領任務
你的任務是在用戶的專案中實作 KryptoGO Payment 穩定幣轉帳與提領功能。
串接 Checklist
- 環境確認 - 確認 API Key 已設定
- 轉帳模組 - 建立代幣轉帳功能
- API 端點 - 建立提領/轉帳端點
- 安全驗證 - 加入提領前的身份驗證
- 測試驗證 - 驗證轉帳功能正常
Step 1: 確認環境
詢問用戶：
使用情境：需要什麼轉帳功能？
- 用戶提領（用戶將餘額提領到自己的錢包）
- 獎勵發放（發送代幣到用戶錢包）
- 批次轉帳（批量發送代幣）
代幣與鏈：要轉帳什麼代幣？
- USDT on Arbitrum
- USDC on Arbitrum
用戶輸入: $ARGUMENTS
Step 2: 確認環境變數
Transfer API 只需要 X-STUDIO-API-KEY：
KRYPTOGO_STUDIO_API_KEY
Step 3: 建立轉帳功能
核心功能:
transferTokens(chainId, contractAddress, amount, walletAddress)- 轉帳代幣
Step 4: 建立 API 端點
建議加入提領前的驗證邏輯：
- 驗證用戶身份
- 驗證提領地址格式
- 確認金額合理
- 執行轉帳
Step 5: 測試
- 確認 Studio 帳戶有足夠餘額
- 使用小額（如 0.01）測試轉帳
- 確認回傳
tx_hash可在區塊鏈上查到
API 參考
端點
| 項目 | 說明 |
|---|---|
| 方法 | POST |
| URL | https://wallet.kryptogo.app/v1/studio/api/asset_pro/transfer |
Required Headers
| Header | 說明 |
|---|---|
X-STUDIO-API-KEY |
Studio API Key |
Content-Type |
application/json |
請求參數
| 參數 | 類型 | 必填 | 說明 |
|---|---|---|---|
| chain_id | String | ✓ | 區塊鏈 ID（如 arb） |
| contract_address | String | ✓ | 代幣合約地址 |
| amount | String | ✓ | 轉帳金額 |
| wallet_address | String | ✓ | 目標錢包地址 |
Arbitrum 代幣合約地址
| 代幣 | 合約地址 |
|---|---|
| USDT | 0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9 |
| USDC | 0xff970a61a04b1ca14834a43f5de4533ebddb5cc8 |
成功回應
{
"code": 0,
"data": {
"id": "1-1627380000-1",
"tx_hash": "0x1234567890abcdef",
"transfer_time": 1627380000
}
}
錯誤回應（餘額不足）
{
"code": 4015,
"message": "Balance not enough",
"data": {
"insufficient_amount": "123.456"
}
}
詳細參考文件
- 程式碼範例 (Node.js/Python)
重要注意事項
- 轉帳為不可逆操作，請務必確認地址正確
- 目前無提領限額
- 確認 Studio 帳戶有足夠餘額
- API Key 不可暴露在前端程式碼中
Converted and distributed by TomeVault — claim your Tome and manage your conversions.