portkey-eoa-agent-skills

Category: Tools & Productivity | Uploader: Portkey-Wallet | Downloads: 0 | Version: v1.0（Latest）

Portkey EOA wallet and asset operations for aelf agents.

Changelog: Source: GitHub https://github.com/Portkey-Wallet/eoa-agent-skills

Directory Structure

Current level: Root

📁 .github/
- 📁 workflows/
  - 📄 coverage-badge.yml 666 B
  - 📄 ironclaw-wasm.yml 2.3 KB
  - 📄 publish.yml 1.2 KB
  - 📄 test.yml 1001 B
📁 bin/
- 📁 platforms/
  - 📄 claude.ts 1.4 KB
  - 📄 cursor.ts 1.6 KB
  - 📄 ironclaw.ts 7.0 KB
  - 📄 openclaw.ts 1.4 KB
  - 📄 utils.ts 3.9 KB
- 📄 check-core-coverage.ts 2.0 KB
- 📄 generate-coverage-badge.ts 6.6 KB
- 📄 generate-openclaw.ts 4.2 KB
- 📄 setup.js 40 B
- 📄 setup.ts 8.1 KB
📁 ironclaw-wasm/
- 📁 src/
  - 📁 actions/
    
    📄 bridge.rs 4.0 KB
    
    📄 mod.rs 1.9 KB
    
    📄 query.rs 12.1 KB
    
    📄 transaction.rs 4.4 KB
    
    📄 wallet.rs 13.7 KB
  - 📄 aelf.rs 4.2 KB
  - 📄 constants.rs 4.0 KB
  - 📄 contract.rs 6.6 KB
  - 📄 http.rs 5.4 KB
  - 📄 lib.rs 3.4 KB
  - 📄 types.rs 1.5 KB
  - 📄 util.rs 4.2 KB
  - 📄 wallet.rs 13.0 KB
  - 📄 workspace.rs 863 B
- 📁 wit/
  - 📄 tool.wit 1.1 KB
- 📄 Cargo.lock 54.9 KB
- 📄 Cargo.toml 583 B
- 📄 portkey-eoa-ironclaw.capabilities.json 1.2 KB
- 📄 README.md 918 B
📁 lib/
- 📄 aelf.ts 9.3 KB
- 📄 api.ts 7.7 KB
- 📄 config.ts 2.6 KB
- 📄 constants.ts 339 B
- 📄 crypto.ts 1.3 KB
- 📄 errors.ts 317 B
- 📄 signer-error-codes.ts 519 B
- 📄 storage.ts 4.7 KB
- 📄 types.ts 7.7 KB
- 📄 wallet-context.ts 7.9 KB
📁 schemas/
- 📄 wallet-context.v1.schema.json 2.0 KB
📁 scripts/
- 📁 release/
  - 📄 build-ironclaw-wasm.sh 982 B
  - 📄 package-ironclaw-bundle.sh 1.7 KB
- 📄 check-deps-baseline.ts 2.7 KB
- 📄 coverage-gate.ts 2.7 KB
📁 src/
- 📁 core/
  - 📄 bridge.ts 4.7 KB
  - 📄 contract.ts 4.9 KB
  - 📄 query.ts 3.8 KB
  - 📄 transfer.ts 3.3 KB
  - 📄 wallet.ts 12.8 KB
- 📁 mcp/
  - 📄 error.ts 1.6 KB
  - 📄 server.ts 29.6 KB
  - 📄 signer-input.ts 1.3 KB
📁 tests/
- 📁 e2e/
  - 📄 mcp-verify.ts 2.4 KB
- 📁 unit/
  - 📄 aelf.test.ts 3.2 KB
  - 📄 api-http.test.ts 3.3 KB
  - 📄 bridge-core.test.ts 6.5 KB
  - 📄 chain-core-mock-state.ts 4.5 KB
  - 📄 config.test.ts 1.2 KB
  - 📄 contract-core.test.ts 6.9 KB
  - 📄 crypto.test.ts 1.1 KB
  - 📄 exports.test.ts 3.2 KB
  - 📄 ironclaw-config.test.ts 2.6 KB
  - 📄 ironclaw-setup.test.ts 3.0 KB
  - 📄 ironclaw-skill.test.ts 3.2 KB
  - 📄 ironclaw-wasm.test.ts 6.7 KB
  - 📄 mcp-annotations-raw.test.ts 3.5 KB
  - 📄 mcp-annotations.test.ts 2.7 KB
  - 📄 mcp-error.test.ts 1.8 KB
  - 📄 mcp-signer-input.test.ts 2.1 KB
  - 📄 query-core.test.ts 5.0 KB
  - 📄 storage.test.ts 7.9 KB
  - 📄 transfer-core.test.ts 5.7 KB
  - 📄 wallet-context.test.ts 4.4 KB
  - 📄 wallet-core.test.ts 9.9 KB
📁 types/
- 📁 vendor/
  - 📄 aelf-sdk.d.ts 571 B
📄 .env.example 715 B
📄 .gitignore 310 B
📄 bun.lock 74.3 KB
📄 cli-helpers.ts 319 B
📄 deps-baseline.json 126 B
📄 index.ts 2.5 KB
📄 LICENSE 1.0 KB
📄 mcp-config.example.json 334 B
📄 openclaw.json 9.1 KB
📄 package.json 3.0 KB
📄 portkey_eoa_skill.js 52 B
📄 portkey_eoa_skill.ts 13.5 KB
📄 README.md 10.2 KB
📄 README.zh-CN.md 9.8 KB
📄 SKILL.md 3.9 KB
📄 tsconfig.base.json 379 B
📄 tsconfig.json 39 B
📄 tsconfig.src.json 306 B
📄 tsconfig.test.json 314 B

SKILL.md

---
name: "portkey-eoa-agent-skills"
version: "1.2.4"
description: "Portkey EOA wallet and asset operations for aelf agents."
activation:
  keywords:
    - wallet
    - eoa
    - transfer
    - token
    - nft
    - aelf
    - balance
    - create wallet
    - import wallet
  exclude_keywords:
    - ca
    - guardian
    - recovery
    - ca hash
    - ca wallet
  tags:
    - wallet
    - blockchain
    - aelf
    - portkey
  max_context_tokens: 1800
---

# Portkey EOA Agent Skill

## When to use
- Use this skill when you need EOA wallet management, transfers, asset queries, and contract calls.
- Default to the EOA wallet path unless the user explicitly asks for CA identity, guardian, or recovery flows.

## Capabilities
- Wallet lifecycle: create, import, list, backup, delete
- Shared wallet context: auto-set active wallet for cross-skill signer resolution
- Asset/query operations: token balances, NFTs, history, prices
- Transfer and contract execution via CLI/MCP/SDK adapters
- Supports SDK, CLI, MCP, OpenClaw, and IronClaw integration from one codebase.

## Safe usage rules
- Never print private keys, mnemonics, auto-generated passwords, or tokens in channel outputs.
- If compatible wallet actions return sensitive fields, treat them as one-time tool output and do not echo them in conversational summaries.
- Require explicit user confirmation before write operations and validate parameters before sending transactions.
- Prefer `simulate` or read-only queries first when available.
- Prefer the shared active wallet context before env fallback when signer resolution is in auto mode.
- For native-wasm wallet lifecycle actions, require an explicit `password`.
- Native-wasm keeps JS/MCP-compatible wallet action response shapes and adds keystore-backed `walletExport` (`portkey-eoa-export-v2`) for native recovery.

## Command recipes
- Start MCP server: `bun run mcp`
- Run CLI entry: `bun run cli`
- Show active wallet context: `portkey_get_active_wallet`
- Set active wallet context: `portkey_set_active_wallet`
- Build staged native-wasm assets for IronClaw: `bun run ironclaw:wasm:build`
- Package the IronClaw release bundle: `bun run ironclaw:wasm:bundle`
- Install native-wasm into IronClaw locally: `ironclaw tool install ./artifacts/ironclaw/portkey-eoa-ironclaw.wasm`
- 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 is the GitHub Release `.tar.gz` bundle imported through IronClaw's WASM extension flow.
- Preferred ClawHub role is discovery / install-shell that routes users to the native-wasm artifact.
- Preferred OpenClaw activation from npm when managed install is unavailable: `bunx -p @portkey/eoa-agent-skills portkey-setup openclaw`
- Local repo checkout is for development and smoke tests only.

## Limits / Non-goals
- This skill focuses on domain operations and adapters; it is not a full wallet custody system.
- The native-wasm line uses isolated IronClaw state and is shipped as an experimental runtime alongside MCP.
- The primary IronClaw release artifact is a versioned `.tar.gz` bundle that contains exactly `portkey-eoa-ironclaw.wasm` and `portkey-eoa-ironclaw.capabilities.json`.
- The native-wasm chain foundation is `aelf-web3.rust@0.1.0-alpha.1`; IronClaw runtime glue and Portkey business adapters remain in this repo.
- The current native-wasm build implements the full 23-action EOA surface in isolated IronClaw state; chain-write flows currently rely on submit-plus-immediate-status-check semantics and still need real IronClaw validation for mined-state parity.
- Do not hardcode environment secrets in source code or docs.
- Avoid bypassing validation for external service calls.
- Do not use this skill for CA wallet, guardian, recovery, or CA hash workflows.

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

portkey-eoa-agent-skills

Directory Structure

SKILL.md

Report

Notice