Check Transaction Skill
This skill allows users to check the status of a blockchain transaction by providing a TxId.
It queries the AOX transaction API (https://api.aox.xyz/tx/[txid]) and returns a human-readable summary of the transaction.
API Endpoint
URL: https://api.aox.xyz/tx/[txid]
Method: GET
Authentication: None required
Example Request:
curl -s "https://api.aox.xyz/tx/ZKmbSYqAYGMJKVldJ6nqDG_wT9SRBy44YDa6XNrfIUs"
Example JSON Response:
{
"rawId": 1773112604581,
"createdAt": "2026-03-10T03:16:44.581Z",
"updatedAt": "2026-03-10T03:22:18.7Z",
"txType": "mint",
"chainType": "arweave",
"txId": "ZKmbSYqAYGMJKVldJ6nqDG_wT9SRBy44YDa6XNrfIUs",
"sender": "kRdpOYaT5pUUiNFDaUymqO1VcybZpAfNPnNdls-A134",
"recipient": "kRdpOYaT5pUUiNFDaUymqO1VcybZpAfNPnNdls-A134",
"quantity": "25100000000000",
"symbol": "AR",
"decimals": 12,
"blockHeight": 1873352,
"fromTokenId": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"toTokenId": "xU9zFkq3X2ZQ6olwNVvr1vUWIjc3kXTWr7xKQD6dh10",
"fee": "0",
"feeRecipient": "",
"confirmNum": 10,
"confirmRange": -1670,
"status": "waiting",
"targetChainTxHash": ""
}
Skill Usage
User Queries:
Example Input: "Check transaction ZKmbSYqAYGMJKVldJ6nqDG_wT9SRBy44YDa6XNrfIUs"
Output: Returns status, amount, sender, receiver, confirmations, and timestamp
Example Input: "Status of TxId ZKmbSYqAYGMJKVldJ6nqDG_wT9SRBy44YDa6XNrfIUs"
Output: Structured transaction info
CLI Example:
Query a transaction
curl -s "https://api.aox.xyz/tx/ZKmbSYqAYGMJKVldJ6nqDG_wT9SRBy44YDa6XNrfIUs"
Sample Output (Human-Readable):
Transaction Status: ⏳ Waiting
TxId: ZKmbSYqAYGMJKVldJ6nqDG_wT9SRBy44YDa6XNrfIUs
Type: mint
Chain: arweave
From: kRdpOYaT5pUUiNFDaUymqO1VcybZpAfNPnNdls-A134
To: kRdpOYaT5pUUiNFDaUymqO1VcybZpAfNPnNdls-A134
Amount: 25.1 AR (quantity: 25100000000000, decimals: 12)
Block Height: 1873352
From Token ID: AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
To Token ID: xU9zFkq3X2ZQ6olwNVvr1vUWIjc3kXTWr7xKQD6dh10
Fee: 0
Confirmations: 10
Confirm Range: -1670
Target Chain Tx Hash: (empty)
Created At: 2026-03-10T03:16:44.581Z
Updated At: 2026-03-10T03:22:18.7Z
Notes & Best Practices
- 1. TxId format: Must start with 0x or valid AOX format.
- Error handling: If the TxId is invalid or not found, the API will return an error:
{
"error": "Transaction not found"
}
- 3. Confirmations: Include confirmNum to show network confirmation count.
- No API key required: Public endpoint, no authentication needed.
- JSON vs human-readable: The agent should format the JSON into readable message.
- Amount calculation: amount = quantity / (10^decimals)
- Status mapping:
- waiting → ⏳ Waiting
- success → ✅ Success
- failed → ❌ Failed
- 8. Target chain hash: If targetChainTxHash exists, display for cross-chain info.
References
- - AOX Transaction API: https://api.aox.xyz/docs
- Example AO blockchain explorer: https://aox.xyz
检查交易技能
该技能允许用户通过提供交易ID（TxId）来检查区块链交易的状态。
它查询AOX交易API（https://api.aox.xyz/tx/[txid]）并返回人类可读的交易摘要。
API端点
URL：https://api.aox.xyz/tx/[txid]
方法：GET
认证：无需认证
示例请求：
curl -s https://api.aox.xyz/tx/ZKmbSYqAYGMJKVldJ6nqDG_wT9SRBy44YDa6XNrfIUs
示例JSON响应：
{
rawId: 1773112604581,
createdAt: 2026-03-10T03:16:44.581Z,
updatedAt: 2026-03-10T03:22:18.7Z,
txType: mint,
chainType: arweave,
txId: ZKmbSYqAYGMJKVldJ6nqDG_wT9SRBy44YDa6XNrfIUs,
sender: kRdpOYaT5pUUiNFDaUymqO1VcybZpAfNPnNdls-A134,
recipient: kRdpOYaT5pUUiNFDaUymqO1VcybZpAfNPnNdls-A134,
quantity: 25100000000000,
symbol: AR,
decimals: 12,
blockHeight: 1873352,
fromTokenId: AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA,
toTokenId: xU9zFkq3X2ZQ6olwNVvr1vUWIjc3kXTWr7xKQD6dh10,
fee: 0,
feeRecipient: ,
confirmNum: 10,
confirmRange: -1670,
status: waiting,
targetChainTxHash:
}
技能使用
用户查询：
示例输入：检查交易 ZKmbSYqAYGMJKVldJ6nqDG_wT9SRBy44YDa6XNrfIUs
输出：返回状态、金额、发送方、接收方、确认次数和时间戳
示例输入：交易ID ZKmbSYqAYGMJKVldJ6nqDG_wT9SRBy44YDa6XNrfIUs 的状态
输出：结构化交易信息
CLI示例：
查询交易
curl -s https://api.aox.xyz/tx/ZKmbSYqAYGMJKVldJ6nqDG_wT9SRBy44YDa6XNrfIUs
示例输出（人类可读）：
交易状态：⏳ 等待中
交易ID：ZKmbSYqAYGMJKVldJ6nqDG_wT9SRBy44YDa6XNrfIUs
类型：铸造
链：arweave
发送方：kRdpOYaT5pUUiNFDaUymqO1VcybZpAfNPnNdls-A134
接收方：kRdpOYaT5pUUiNFDaUymqO1VcybZpAfNPnNdls-A134
金额：25.1 AR（数量：25100000000000，小数位：12）
区块高度：1873352
来源代币ID：AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
目标代币ID：xU9zFkq3X2ZQ6olwNVvr1vUWIjc3kXTWr7xKQD6dh10
手续费：0
确认次数：10
确认范围：-1670
目标链交易哈希：（空）
创建时间：2026-03-10T03:16:44.581Z
更新时间：2026-03-10T03:22:18.7Z
注意事项与最佳实践
- 1. 交易ID格式：必须以0x开头或为有效的AOX格式。
- 错误处理：如果交易ID无效或未找到，API将返回错误：
{
error: Transaction not found
}
- 3. 确认次数：包含confirmNum以显示网络确认次数。
- 无需API密钥：公共端点，无需认证。
- JSON与人类可读：代理应将JSON格式化为可读消息。
- 金额计算：金额 = 数量 / (10^小数位)
- 状态映射：
- waiting → ⏳ 等待中
- success → ✅ 成功
- failed → ❌ 失败
- 8. 目标链哈希：如果targetChainTxHash存在，则显示跨链信息。
参考资料
- - AOX交易API：https://api.aox.xyz/docs
- 示例AO区块链浏览器：https://aox.xyz
