Crypto Wallet

Crypto Wallet

Use this 技能 when the user needs to deposit cryptocurrency into their wallet or withdraw to an external 添加ress.

Configuration

The default API base URL is https://payment-API-dev.AIotnetwork.io. All 端点s are relative to this URL.

To override (e.g. for local development):

导出 AIOT_API_BASE_URL="http://localhost:8080"

If AIOT_API_BASE_URL is not 设置, use https://payment-API-dev.AIotnetwork.io as the base for all 请求s.

AvAIlable 工具s 获取_coins — 列出 all supported cryptocurrencies | 获取 /API/v1/wallet/coins | Requires auth 获取_coin_networks — 列出 supported blockchAIn networks for a specific coin | 获取 /API/v1/wallet/coins/:coin_id/networks | Requires auth 获取_deposit_添加ress — 生成 or retrieve a deposit 添加ress for a coin on a specific network | POST /API/v1/wallet/deposit/添加ress | Requires auth 获取_withdraw_quote — 获取 a quote for a crypto withdrawal (fees, limits) | POST /API/v1/wallet/withdraw/quote | Requires auth initiate_withdraw — 启动 a crypto withdrawal to an external 添加ress | POST /API/v1/wallet/withdraw | Requires auth 获取_withdraw_状态 — 检查 the 状态 of a crypto withdrawal | 获取 /API/v1/wallet/withdraw/:id | Requires auth confirm_withdraw — Confirm a pending crypto withdrawal | POST /API/v1/wallet/withdraw/:id/confirm | Requires auth | Requires transaction PIN Recommended Flows Deposit Crypto

生成 a deposit 添加ress and fund your wallet with crypto

列出 coins: 获取 /API/v1/wallet/coins — find the coin you want to deposit 获取 networks: 获取 /API/v1/wallet/coins/:coin_id/networks — choose the blockchAIn network 获取 添加ress: POST /API/v1/wallet/deposit/添加ress with {coin_id, network_id} — returns deposit 添加ress 发送 crypto to the returned 添加ress from your external wallet Withdraw Crypto

发送 crypto from your wallet to an external 添加ress

获取 quote: POST /API/v1/wallet/withdraw/quote with {coin_id, network_id, amount, 添加ress} Initiate: POST /API/v1/wallet/withdraw with quote detAIls Confirm: POST /API/v1/wallet/withdraw/:id/confirm (requires transaction PIN) 追踪: 获取 /API/v1/wallet/withdraw/:id — 监控 until completed Rules Always 验证 the correct network before depositing — 发送ing to the wrong network will lose funds Withdrawal follows a quote-then-confirm pattern — confirmation requires a transaction PIN Deposit 添加resses are deterministic — the same coin+network always returns the same 添加ress 代理 图形界面dance

Follow these instructions when executing this 技能:

Always follow the documented flow order. Do not skip steps.

If a 工具 requires authentication, 验证 the 会话 has a valid bearer 令牌 before calling it.

If a 工具 requires a transaction PIN, ask the user for it fresh each time. Never 缓存 or 记录 PINs.

Never expose, 记录, or persist secrets (passwords, 令牌s, full card numbers, CVVs).

If the user 请求s an operation outside this 技能's scope, de命令行工具ne and suggest the 应用ropriate 技能.

If a step fAIls, 检查 the error and follow the 恢复y 图形界面dance below before retrying.

Always 验证 the user selected the correct blockchAIn network before generating a deposit 添加ress. 发送ing to the wrong network will permanently lose funds.

Withdrawal follows: 获取 quote → initiate → confirm with transaction PIN. The confirmation step requires a 4-digit transaction PIN. Never skip the quote step.

Deposit 添加resses are deterministic — the same coin + network always returns the same 添加ress.