{"_id":"@axon-chain/axon-skills","_rev":"5-4d5231650335f8cbaf9887ba81116d68","name":"@axon-chain/axon-skills","dist-tags":{"latest":"0.2.0"},"versions":{"0.1.0":{"name":"@axon-chain/axon-skills","version":"0.1.0","keywords":["axon","openclaw","skills","validator","wallet"],"license":"Apache-2.0","_id":"@axon-chain/axon-skills@0.1.0","maintainers":[{"name":"axonchain","email":"nelsoncopeiro801@gmail.com"}],"bin":{"axon-skills":"bin/axon-skills.js"},"dist":{"shasum":"b8f371970c782771e6c331de1fbe5895ea61614d","tarball":"https://registry.npmjs.org/@axon-chain/axon-skills/-/axon-skills-0.1.0.tgz","fileCount":14,"integrity":"sha512-CTvnO1mPdrXnjKzFrKadsuz3PqZJzsrRY9Q68Eo6rj2rnSap61YlO5SAD7MUmHLzhIrzI6yNgtyULNOpUGh6Qg==","signatures":[{"sig":"MEQCIGtsdE/QMY7BV/BUrwbJOm6MPkq0hZt9OmWI7GuN/32dAiA36xOcHWeUyuGxuAEmWQV5qkNBeYhHjIzGXiykPfjnAA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":26009},"type":"module","engines":{"node":">=18"},"scripts":{"test":"node --test"},"_npmUser":{"name":"axonchain","email":"nelsoncopeiro801@gmail.com"},"_npmVersion":"11.6.2","description":"OpenClaw-installable Axon mainnet skills for validator operators and ordinary users.","directories":{},"_nodeVersion":"24.12.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/axon-skills_0.1.0_1773742832871_0.5117038136767984","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"name":"@axon-chain/axon-skills","version":"0.1.5","keywords":["axon","openclaw","skills","validator","wallet"],"license":"Apache-2.0","_id":"@axon-chain/axon-skills@0.1.5","maintainers":[{"name":"axonchain","email":"nelsoncopeiro801@gmail.com"}],"bin":{"axon-skills":"bin/axon-skills.js"},"dist":{"shasum":"34374db8ebb58c42e6c1a47604bc8e9cbfad266d","tarball":"https://registry.npmjs.org/@axon-chain/axon-skills/-/axon-skills-0.1.5.tgz","fileCount":14,"integrity":"sha512-fxVf9sAS4ZcDkbO+dQnyGCWsGS8ht2o1favYHSL3b91lGWSJWGdg8/VD3pPxIaSqo9sgjDCSg6CtLcBy3La2Mg==","signatures":[{"sig":"MEQCIFoVVdEaHjSDBqhqLJf28RZpZ2H/VfW8uswAGZDXdL3/AiBMWXcW/fcburECKnQ9f7+i+9DTmJZ4r0aI/0JbUJUISw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":31408},"type":"module","engines":{"node":">=18"},"scripts":{"test":"node --test"},"_npmUser":{"name":"axonchain","email":"nelsoncopeiro801@gmail.com"},"_npmVersion":"11.6.2","description":"OpenClaw-installable Axon mainnet skills for validator operators and ordinary users.","directories":{},"_nodeVersion":"24.12.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/axon-skills_0.1.5_1773894086521_0.5245106745803985","host":"s3://npm-registry-packages-npm-production"}},"0.1.6":{"name":"@axon-chain/axon-skills","version":"0.1.6","keywords":["axon","openclaw","ai-agent","skills","validator","wallet"],"license":"Apache-2.0","_id":"@axon-chain/axon-skills@0.1.6","maintainers":[{"name":"axonchain","email":"nelsoncopeiro801@gmail.com"}],"bin":{"axon-skills":"bin/axon-skills.js"},"dist":{"shasum":"fc3f534eeb271822a51090b6dbeb2b40c7dad05c","tarball":"https://registry.npmjs.org/@axon-chain/axon-skills/-/axon-skills-0.1.6.tgz","fileCount":14,"integrity":"sha512-ogtNofm8SX2jyXoZKrFGOvBfxSOk0G7o7VwLoubxQqKdE0+RS7QZX2uMT7dyZJU0dm5M2xDyGilqzcn5gweMZQ==","signatures":[{"sig":"MEUCIQDHECpuvdGcF63Q/+CcMNpqBQ1Jt5hoM9r3zhkRjEvL5QIgCVXROgFZv03E+2RSNYIoGLdvuhwVijKpv+qUIiY0eBs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":34444},"type":"module","engines":{"node":">=18"},"scripts":{"test":"node --test"},"_npmUser":{"name":"axonchain","email":"nelsoncopeiro801@gmail.com"},"_npmVersion":"11.6.2","description":"Installable Axon skill bundles that teach AI agents how to handle Axon mainnet wallet and validator workflows.","directories":{},"_nodeVersion":"24.12.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/axon-skills_0.1.6_1773894652085_0.6884567731303546","host":"s3://npm-registry-packages-npm-production"}},"0.1.7":{"name":"@axon-chain/axon-skills","version":"0.1.7","keywords":["axon","openclaw","ai-agent","skills","validator","wallet"],"license":"Apache-2.0","_id":"@axon-chain/axon-skills@0.1.7","maintainers":[{"name":"axonchain","email":"nelsoncopeiro801@gmail.com"}],"bin":{"axon-skills":"bin/axon-skills.js"},"dist":{"shasum":"cc873852a79be2aa88d076a2a2e70b34c5e27152","tarball":"https://registry.npmjs.org/@axon-chain/axon-skills/-/axon-skills-0.1.7.tgz","fileCount":14,"integrity":"sha512-IjMpXvK9DP6teAmUxa+sr1kvSVNqkcQtNJX4GuhPznxCVhEvKiogCTvDb6E1+C2PtQR9+WcXfCHL6i9YHbr0aQ==","signatures":[{"sig":"MEYCIQDfD8k3C7LzJxoILybYHq6KW6+YgTRMQ2jWMfPKWBXZiwIhAPB0PXsR52VvUtSUPfs/dw+nkfL3W1Pt3kUlrZGBrRxy","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":41685},"type":"module","engines":{"node":">=18"},"scripts":{"test":"node --test"},"_npmUser":{"name":"axonchain","email":"nelsoncopeiro801@gmail.com"},"_npmVersion":"11.6.2","description":"Installable Axon skill bundles that teach AI agents how to handle Axon mainnet wallet and validator workflows.","directories":{},"_nodeVersion":"24.12.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/axon-skills_0.1.7_1773896032966_0.5085743574016546","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@axon-chain/axon-skills","version":"0.2.0","description":"Installable Axon skill bundles that teach AI agents how to handle Axon mainnet wallet and validator workflows.","type":"module","bin":{"axon-skills":"bin/axon-skills.js"},"scripts":{"test":"node --test"},"engines":{"node":">=18"},"publishConfig":{"access":"public"},"keywords":["axon","openclaw","ai-agent","skills","validator","wallet"],"license":"Apache-2.0","_id":"@axon-chain/axon-skills@0.2.0","_nodeVersion":"24.12.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-hnjm9WRakU5NqnQumZwClGA+J2aic7smZH987MlELziEgrL2VNUv4ThA9QTJro1gA0iHCIBFDszx7j7fV8q0+A==","shasum":"5b2a18926cd02707303b1a556a312aacfdff8d6b","tarball":"https://registry.npmjs.org/@axon-chain/axon-skills/-/axon-skills-0.2.0.tgz","fileCount":16,"unpackedSize":53088,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDCTYv61QZIjpyLJGa1lurMoRfd9HzcU9QvTHA0VTgkSgIgCA3wplmdgHW1VdmT5FC3BqiNxGN5Ge3a8B+wyLMqIlM="}]},"_npmUser":{"name":"axonchain","email":"nelsoncopeiro801@gmail.com"},"directories":{},"maintainers":[{"name":"axonchain","email":"nelsoncopeiro801@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/axon-skills_0.2.0_1774145986749_0.10633952873259589"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-17T10:20:32.736Z","modified":"2026-03-22T02:19:46.997Z","0.1.0":"2026-03-17T10:20:33.033Z","0.1.5":"2026-03-19T04:21:26.679Z","0.1.6":"2026-03-19T04:30:52.272Z","0.1.7":"2026-03-19T04:53:53.112Z","0.2.0":"2026-03-22T02:19:46.892Z"},"license":"Apache-2.0","keywords":["axon","openclaw","ai-agent","skills","validator","wallet"],"description":"Installable Axon skill bundles that teach AI agents how to handle Axon mainnet wallet and validator workflows.","maintainers":[{"name":"axonchain","email":"nelsoncopeiro801@gmail.com"}],"readme":"# @axon-chain/axon-skills\n\nInstall official Axon skill bundles for AI agents with `npx`.\n\nThis package is not a node launcher, wallet app, or SDK. It is a distribution package that copies curated Axon skill folders into agent skill roots so tools such as OpenClaw can discover them and load them at the right time.\n\n## What Axon Is\n\nAxon is the Axon Chain mainnet project. The official GitHub README describes it as a general-purpose blockchain for AI agents with:\n\n- an independent L1 network\n- full EVM compatibility\n- agent-native on-chain capabilities\n- validator and Agent participation flows\n- wallet, RPC, SDK, and contract integration surfaces\n\nFor this package, the important operating facts are:\n\n- node-facing Cosmos chain ID: `axon_8210-1`\n- wallet-facing EVM chain ID: `8210`\n- native token: `AXON`\n- public JSON-RPC: `https://mainnet-rpc.axonchain.ai/`\n\nThis package exists so an agent can answer three questions without first opening the Axon repository:\n\n- What is Axon?\n- Which Axon workflow is this request asking for?\n- Which official Axon resources should I use next?\n\nAfter installation, the agent gets:\n\n- `axon-validator-node`: an operator playbook for Axon mainnet validator, Agent-validator, and sync-node work\n- `axon-mainnet-user`: a user-and-Agent playbook for Axon mainnet users, non-validator Agents, balances, transfers, and public RPC reads\n\nInstall this package when you want the agent to understand:\n\n- what Axon task it is handling\n- which skill it should trigger\n- which chain IDs, RPC endpoints, and guardrails apply\n- which reference files it should read next for exact steps\n\n## What The Agent Can Do\n\nWith these installed skills, an agent can:\n\n- explain what Axon is at a high level and separate wallet flows from validator flows\n- configure Axon in MetaMask or other EVM wallets with the correct chain ID and RPC\n- inspect chain state through the public JSON-RPC endpoint\n- guide validator and sync-node bootstrap using the official public scripts\n- help check funding, sync state, `create-validator`, Agent registration, and heartbeat flows\n- point builders to the official SDKs, contract interfaces, release artifacts, and mainnet files\n\n## Role Guide\n\nThis package is now structured around three user intents:\n\n- ordinary users who only need wallet access, transfers, balances, and public RPC usage\n- users who want to become an active Agent and understand how Agent rewards work\n- users who want to become a validator and understand validator duties and validator-side rewards\n\nThe package still installs two skills, but each skill owns a clear scope:\n\n- `axon-mainnet-user` covers ordinary-user flows and non-validator active-Agent flows\n- `axon-validator-node` covers validator and agent-validator flows\n\n## Ordinary Users: How To Use Axon\n\nOrdinary users do not need to run a node or become a validator.\n\nThey typically need to:\n\n- add Axon mainnet to an EVM wallet with chain ID `8210`\n- hold `AXON` for transfers and gas\n- check balances and send transfers\n- inspect public chain state through `https://mainnet-rpc.axonchain.ai/`\n- connect EVM applications that support Axon mainnet\n\nThis path should trigger `axon-mainnet-user`.\n\n## Active Agent: Lifecycle And Reward Logic\n\nUsers who want to participate as active Agents without validator duties should stay in `axon-mainnet-user`, because the user skill now includes dedicated Agent guidance for:\n\n- how to register an Agent\n- how to keep the Agent online and active\n- what causes reputation to rise or fall\n- how Agent-side rewards are split between reputation rewards and contribution rewards\n- when stake matters for non-validator Agent earnings\n\nAt a high level:\n\n- a registered Agent is not the same thing as a validator\n- a non-validator Agent can still earn Agent-side rewards\n- becoming an active Agent does not require validator duties\n\n## Validators: Duties And Reward Logic\n\nUsers who want to become validators should also use `axon-validator-node`.\n\nThat skill now separates:\n\n- the operational path to become a validator\n- validator rights and obligations\n- the extra steps to become an Agent validator\n- validator mining and reward mechanics\n\nAt a high level:\n\n- validators must be funded, synced, and created on chain before operating\n- validators must protect signing keys and avoid downtime and double-signing\n- validator-side rewards depend on proposer selection and validator-pool distribution\n- Agent validators additionally depend on heartbeat freshness, reputation, and stake-weighted mining power\n\n## Included skills\n\n- `validator`: installs `axon-validator-node` for validator, Agent-validator, and sync-node operations\n- `user`: installs `axon-mainnet-user` for wallet setup, active-Agent flows, balances, transfers, and public RPC usage\n- `all`: installs both skills\n\n## Install\n\n```bash\nnpx @axon-chain/axon-skills install validator\nnpx @axon-chain/axon-skills install user\nnpx @axon-chain/axon-skills install all\n```\n\nDefault installs copy skills into both agent roots:\n\n- `${OPENCLAW_STATE_DIR:-~/.openclaw}/skills`\n- `${AGENTS_SKILLS_DIR:-${AGENTS_HOME:-~/.agents}/skills}`\n\nRepeat installs replace the packaged skill folders in place so updates are easy to roll out.\n\n## Commands\n\n```bash\nnpx @axon-chain/axon-skills list\nnpx @axon-chain/axon-skills install validator\nnpx @axon-chain/axon-skills install user\nnpx @axon-chain/axon-skills install all\nnpx @axon-chain/axon-skills install all --dry-run\nnpx @axon-chain/axon-skills install validator --dest /path/to/skills\n```\n\n## How Agents Use It\n\nThe installed folders are normal skill folders with `SKILL.md` entrypoints and bundled references. An agent reads the skill metadata to decide when to trigger it, then reads the body and reference files to answer Axon-specific requests safely.\n\nIn practice:\n\n- wallet, public RPC, Agent registration, active-Agent, and Agent-reward requests should trigger `axon-mainnet-user`\n- validator, sync, recovery, validator-economics, and agent-validator requests should trigger `axon-validator-node`\n- the package gives the agent domain rules and routing, not a running service\n\n## Official GitHub References\n\nUse these as the source of truth when more detail is needed:\n\n- Project overview and mainnet facts: [github.com/axon-chain/axon/blob/main/README.md](https://github.com/axon-chain/axon/blob/main/README.md)\n- Latest releases: [github.com/axon-chain/axon/releases/latest](https://github.com/axon-chain/axon/releases/latest)\n- Mainnet genesis: [github.com/axon-chain/axon/blob/main/docs/mainnet/genesis.json](https://github.com/axon-chain/axon/blob/main/docs/mainnet/genesis.json)\n- Mainnet bootstrap peers: [github.com/axon-chain/axon/blob/main/docs/mainnet/bootstrap_peers.txt](https://github.com/axon-chain/axon/blob/main/docs/mainnet/bootstrap_peers.txt)\n- Validator startup script: [github.com/axon-chain/axon/blob/main/scripts/start_validator_node.sh](https://github.com/axon-chain/axon/blob/main/scripts/start_validator_node.sh)\n- Sync-node startup script: [github.com/axon-chain/axon/blob/main/scripts/start_sync_node.sh](https://github.com/axon-chain/axon/blob/main/scripts/start_sync_node.sh)\n- TypeScript SDK: [github.com/axon-chain/axon/tree/main/sdk/typescript](https://github.com/axon-chain/axon/tree/main/sdk/typescript)\n- Python SDK: [github.com/axon-chain/axon/tree/main/sdk/python](https://github.com/axon-chain/axon/tree/main/sdk/python)\n- Solidity interfaces and precompile bindings: [github.com/axon-chain/axon/tree/main/contracts/interfaces](https://github.com/axon-chain/axon/tree/main/contracts/interfaces)\n- Agent heartbeat daemon: [github.com/axon-chain/axon/blob/main/tools/agent-daemon/README_EN.md](https://github.com/axon-chain/axon/blob/main/tools/agent-daemon/README_EN.md)\n\n## Verify\n\n```bash\nopenclaw skills list\n```\n\nIf OpenClaw is not installed on the current machine, inspect the installed skill folders directly under the target roots and confirm `SKILL.md` exists in each installed directory.\n","readmeFilename":"README.md"}