← Back to Skills Marketplace
charles-lpd

check-ao-transaction

by charles-lpd · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
190
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install check-ao-transaction
Description
Check transaction status on AO bridge
README (SKILL.md)

Multi Chain Transaction Checker

Trigger

当用户提供交易 ID 或哈希值并询问以下信息时,请使用此技能:

Input

{ "tx_hash": "transaction hash" }

Output

{
  "rawId": 1773755697333,
  "createdAt": "2026-03-17T13:54:57.333Z",
  "updatedAt": "2026-03-17T15:23:03.604Z",
  "txType": "burn",
  "chainType": "arweave",
  "txId": "hcdE4lfIlNEXGp9bV4fggyHMJ3-kha4Zozv7Ax4F-mU",
  "sender": "y3-JfAs4xSwhpIFCvX0sIsAtZMHGxtutQ7yP6xuH4AI",
  "recipient": "y3-JfAs4xSwhpIFCvX0sIsAtZMHGxtutQ7yP6xuH4AI",
  "quantity": "1462196993511",
  "symbol": "AR",
  "decimals": 12,
  "blockHeight": 1878366,
  "fromTokenId": "xU9zFkq3X2ZQ6olwNVvr1vUWIjc3kXTWr7xKQD6dh10",
  "toTokenId": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
  "fee": "300000000000",
  "feeRecipient": "4S58xCqS6uKcrvqb2JlrCWllC2VIBs7qxU15QbWa3ZI",
  "confirmNum": 0,
  "confirmRange": 0,
  "status": "waiting",
  "targetChainTxHash": ""
}

字段类型

export interface BridgeHymxListItem {
  rawId: number
  createdAt: string
  updatedAt: string
  txType: 'burn' | 'mint'
  chainType: string
  txId: string
  sender: string
  recipient: string
  quantity: string
  symbol: string
  decimals: number
  blockHeight: number
  fromTokenId: string
  toTokenId: string
  fee: string
  feeRecipient: string
  confirmNum: number
  confirmRange: number
  status:
    | 'success'
    | 'unPackaged'
    | 'waiting'
    | 'confirmed'
    | 'failed'
    | 'submintAosFailed'
    | 'notOnChain'
  targetChainTxHash: string
}

子段解释:

  • rawId: 游标
  • createdAt: 创建交易的时间。
  • updatedAt: 每当 status 改变会立即更新的时间。
  • txType: 交易类型 mint代表充值, burn 代表提现。
  • chainType: txType 等于 mint 代表 chainType 链到 ao 网络,txType等于 burn 代表 ao 网络 到 chainType 链。
  • txId: 交易哈希。
  • sender: 发起人的地址。
  • recipient: 收款人地址。
  • quantity: 实际到账交易金额,若 fee 不为空,则代表 quantity + fee = 发起人交易时的金额。
  • symbol: TokenSymbol, 是 fromTokenIdsymbol。注意 info 提示
  • decimals: Token 的数额精度。 是 fromTokenIddecimals。 注意 info 提示
  • blockHeight: 当前交易的区块高度。
  • fromTokenId: 存入/铸造 的 tokenId。注意 info 提示
  • toTokenId: 提取/销毁 的 tokenId 。注意 info 提示
  • fee: 手续费。
  • feeRecipient:手续费收款地址。
  • status: 当前交易的状态,根据下方 info 中 status 返回给用户。
  • confirmNum: 总共需要确认多少个区块。
  • confirmRange: 目前已经确认了多少区块。
  • targetChainTxHash: 目标链的哈希。

:::info

  • fromToken/toToken fromTokenIdtoTokenId 要根据交易类型拍判断谁是(存入/铸造)或(提取/销毁),交易类型 txType 确定资产流向——若为 mint (存入/铸造),原始资产为 fromTokenId,目标资产为 toTokenId;若为非 mint (提取/销毁),则方向相反。

  • status: Agent 需根据 txType 判定交易

txType = mint

  • unPackaged待上链
  • waitingconfirmed
    • confirmRange > 0待确认
    • confirmRange \x3C= 0待收款
  • 其他状态 → (如 success, failed, packageing)直接映射至对应的多语言标签。

txType = burn

  • unPackaged待燃烧
  • waiting待执行
  • 其他状态 → (如 success, failed, packageing)直接映射至对应的多语言标签。 :::
Usage Guidance
This skill simply asks for a transaction id and queries https://api.aox.xyz/tx/<txid>. It does not require credentials or read local files. Before installing, confirm you trust the AOX API endpoint (api.aox.xyz) because the skill will send any provided tx id there. Note: there is a small potential runtime mismatch (use of ESM-style export in a script invoked with plain node) that may cause the script to fail on some Node setups — this is a functionality/compatibility issue, not a security concern.
Capability Analysis
Type: OpenClaw Skill Name: check-ao-transaction Version: 1.0.0 The skill is a straightforward utility for checking transaction statuses on the AO bridge via the AOX API (api.aox.xyz). The Node.js script (script/index.js) safely fetches transaction data based on a user-provided hash and performs basic unit conversion, while the SKILL.md provides clear instructions for the agent to interpret the API response without any signs of malicious intent or prompt injection.
Capability Assessment
Purpose & Capability
Name/description (check AO bridge transaction) aligns with the included code and SKILL.md. The only external interaction is an HTTP GET to https://api.aox.xyz/tx/<txid>, which is appropriate for this purpose.
Instruction Scope
SKILL.md instructs the agent to accept a tx hash and return the bridge transaction schema. The runtime script only reads stdin for the tx id, queries the AOX endpoint, converts numeric fields, and outputs JSON. It does not read other files, env vars, or unrelated system state.
Install Mechanism
There is no install spec; this is instruction-plus-small-script only. Nothing is downloaded or written to disk at install time.
Credentials
The skill declares no required environment variables or credentials and the code does not access any secrets or config paths. Network access to the AOX API is the only external interaction, which is proportional to the stated function.
Persistence & Privilege
The skill is not flagged always:true and does not request persistent system-level privileges or modify other skills' configs. It runs on demand.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install check-ao-transaction
  3. After installation, invoke the skill by name or use /check-ao-transaction
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of check-ao-transaction skill. - Allows users to check AO bridge transaction status using transaction hash. - Provides detailed transaction status and metadata in JSON format, including txType, chainType, amount, status, and more. - Supports descriptions of status mappings for different transaction types (mint, burn).
Metadata
Slug check-ao-transaction
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is check-ao-transaction?

Check transaction status on AO bridge. It is an AI Agent Skill for Claude Code / OpenClaw, with 190 downloads so far.

How do I install check-ao-transaction?

Run "/install check-ao-transaction" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is check-ao-transaction free?

Yes, check-ao-transaction is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does check-ao-transaction support?

check-ao-transaction is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created check-ao-transaction?

It is built and maintained by charles-lpd (@charles-lpd); the current version is v1.0.0.

💬 Comments