1---2name: aelf-node-skill3description: AElf node querying and contract execution skill for agents.4---5
6# AElf Node Skill
7
8## When to use
9- Use this skill when you need AElf chain query, contract view/send, and fee estimation tasks.
10- Default to this skill for node, RPC, block, transaction, contract metadata, and fee estimation requests.
11
12## Capabilities
13- Chain reads: status, block, transaction result, metadata
14- Contract operations: view call and transaction sending
15- Node registry import/list with REST-first and SDK fallback strategy
16- Shared signer resolution for write operations: `explicit -> context -> env`
17- Supports SDK, CLI, MCP, OpenClaw, and IronClaw integration from one codebase.
18
19## Safe usage rules
20- Never print private keys, mnemonics, or tokens in channel outputs.
21- For write operations, require explicit user confirmation and validate parameters before sending transactions.
22- Prefer `simulate` or read-only queries first when available.
23- Active wallet context contains identity metadata only; never persist plaintext private keys.
24
25## Command recipes
26- Start MCP server: `bun run mcp`
27- Run CLI entry: `bun run cli`
28- Install into IronClaw: `bun run setup ironclaw`
29- Generate OpenClaw config: `bun run build:openclaw`
30- Verify OpenClaw config: `bun run build:openclaw:check`
31- Run CI coverage gate: `bun run test:coverage:ci`
32- For write calls, pass optional `signerContext` with `signerMode=auto`.
33
34## Distribution / Activation
35- GitHub repo/tree URLs are discovery-only for hosts and agents.
36- Preferred IronClaw activation from npm: `bunx -p @blockchain-forever/aelf-node-skill aelf-node-setup ironclaw`
37- Preferred OpenClaw activation from npm when managed install is unavailable: `bunx -p @blockchain-forever/aelf-node-skill aelf-node-setup openclaw`
38- Local repo checkout is for development and smoke tests only.
39
40## Limits / Non-goals
41- This skill focuses on domain operations and adapters; it is not a full wallet custody system.
42- Do not hardcode environment secrets in source code or docs.
43- Avoid bypassing validation for external service calls.
44- `signerMode=daemon` is reserved and returns `SIGNER_DAEMON_NOT_IMPLEMENTED` in this release.
45- Do not use this skill for wallet lifecycle, DEX trading, DAO governance, or explorer analytics routing.