Ca agent skills
Portkey CA wallet skill for registration, recovery, guardian flows, transfers, and contract calls on aelf.
npx -y skills add Portkey-Wallet/ca-agent-skillsAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 5 stars5 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Portkey CA wallet registration/auth/guardian/transfer operations for agents.
SKILL.md
5.1 KB, as published. Nobody here has run it
Portkey CA Agent Skill
When to use
- Use this skill when you need CA wallet auth, guardian flow, and transaction operations on aelf.
- Default to this skill for CA identity, guardian, recovery, register, and CA transfer workflows.
Capabilities
- Auth operations: verifier, email code, register, recover, status
- Query operations: account, guardian, assets, chain config, transfer preflight
- Tx operations: transfer, contract call, approvals, keystore workflows
- Shared wallet context: auto-set active CA profile for cross-skill signer resolution
- Supports SDK, CLI, MCP, OpenClaw, and IronClaw integration from one codebase.
Safe usage rules
- Never print private keys, mnemonics, or tokens in channel outputs.
- For write operations, require explicit user confirmation and validate parameters before sending transactions.
- Prefer read-only preflight checks first when available.
- Route
Get*and other read-only contract methods throughview-call/callContractViewMethod, notforward-call. - Route
forward-call/managerForwardCallonly to state-changing methods. - For
Empty-input view methods such asGetConfig, omit params entirely so the runtime performs.call()with no arguments. - Treat backend
3002 / Guardian not exist.as an unregistered account and route toregister. - Before
transfer/cross-chain-transfer, runtransfer-preflightto decide whether the path is:- direct transfer
- one-time guardian approval
- transfer-limit modification
- wallet security upgrade / guardian sync
- Recommended stable write path is:
recover-and-save- poll
manager-sync-statuson the target chain - collect fresh
transferApproveproofs - submit
transfer/cross-chain-transferwithloginEmail + password
- Older AA/CA accounts recovered on
AELFand then written ontDVVare a high-risk sync scenario; always checkmanager-sync-statusbefore the firstforward-call/ claim / transfer ontDVV. transfer-preflightreports both the transferred asset balance and the chain default fee-token balance (feeSymbol/feeBalance/feeDecimals) when deciding one-time approval eligibility.send-code/verify-codesupporttransferApprovefor one-time transfer approval proof collection.transfer,cross-chain-transfer, and transfer-relatedforward-callaccept optionalguardiansApproved.transfer,cross-chain-transfer, and genericforward-callnow block early when the current manager has not yet synced to the target chain.- CLI write commands can resolve signer directly from CA keystore options (
loginEmail/password/keystoreFile) instead of relying on a previous in-memoryunlock. wallet-statusreturnsrecommendedAction/userHintwhen a local keystore exists but is still locked.recommendedAction=unlockis the next machine step;userHintexplains how to verify the selectedloginEmail/keystoreFilefirst and then route torecover-and-saveonly if the password was truly forgotten.VirtualTransactionCreatedis forwarded-write evidence only; it is not a decoded view payload and not a standalone proof that a read-only contract query succeeded.
Command recipes
- Start MCP server:
bun run mcp - Run CLI entry:
bun run portkey_query_skill.ts chain-info - Run transfer preflight:
bun run portkey_query_skill.ts transfer-preflight --ca-hash <hash> --ca-address <addr> --chain-id tDVV --symbol ELF --amount 100000000 - Run manager sync status:
bun run portkey_query_skill.ts manager-sync-status --ca-hash <hash> --chain-id tDVV --manager-address <addr-from-recover-and-save-or-selected-signer> - Read active wallet context:
portkey_get_active_wallet - Set active wallet context:
portkey_set_active_wallet - Install into IronClaw:
bun run setup ironclaw - Generate OpenClaw config:
bun run build:openclaw - Verify OpenClaw config:
bun run build:openclaw:check - Run CI coverage gate:
bun run test:coverage:ci
Distribution / Activation
- GitHub repo/tree URLs are discovery-only for hosts and agents.
- Preferred IronClaw activation from npm:
bunx -p @portkey/ca-agent-skills portkey-ca-setup ironclaw - Preferred OpenClaw activation from npm when managed install is unavailable:
bunx -p @portkey/ca-agent-skills portkey-ca-setup openclaw - Local repo checkout is for development and smoke tests only.
- Migration note:
portkey-setupwas removed in2.0.0; useportkey-ca-setupfor npm-based activation.
Limits / Non-goals
- This skill focuses on domain operations and adapters; it is not a full wallet custody system.
- Do not hardcode environment secrets in source code or docs.
- Avoid bypassing validation for external service calls.
- Do not use this skill for EOA mnemonic/private-key wallet lifecycle flows.