Skip to content

historia05/hermes-crypto-agent

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 

Repository files navigation

Hermes Crypto Agent

Multi-chain crypto + Web3 agent toolkit — execute on-chain operations through natural language across Ethereum, BSC, Base, Arbitrum, Optimism, Polygon, Avalanche, Linea, Scroll, Solana, Sui, Aptos, and TON.

Built as a skill pack for AI coding agents — works with Claude Code, Cursor, OpenClaw, and any agent runtime that supports skill-based tool routing. Designed to be paired with Xiaomi MiMo, Anthropic Claude, OpenAI, and other reasoning models that drive the agent loop.


What It Does

A user types "swap 100 USDC ke ETH di Base" or "bridge 0.5 ETH dari Arbitrum ke Optimism via Across" — the agent identifies the task, loads the correct reference module, simulates the transaction, asks for confirmation, and broadcasts.

Every operation goes through a strict pipeline:

Intent  →  Validate (chain, contract, ownership)
        →  Compose tx (no broadcast)
        →  Simulate (eth_call / dry-run)
        →  User confirms
        →  Broadcast → return tx hash + explorer link
        →  Monitor finality

Capability Matrix

Domain Reference Scripts
Wallet ops — create, import (seed/PK), balance, multi-wallet roster references/wallets.md scripts/wallet_manager.py
Token swap & sell — via DEX, contract address, sell-all references/swap.md scripts/swap_engine.py
NFT — buy/sell on OpenSea, Blur, Magic Eden, Tensor references/nft.md scripts/nft_engine.py
Sniping — token launches, NFT mints, with honeypot detection references/sniping.md
Airdrop automation — multi-wallet farming workflows references/airdrop_automation.md scripts/airdrop_runner.py
Bridges — LayerZero, Stargate, Across, Wormhole, LI.FI, native L1↔L2 references/bridge.md scripts/bridge_engine.py
DeFi — Aave, Lido, EigenLayer, Uniswap V3, Curve, GMX, Hyperliquid, Pendle references/defi.md
Web3 connect — SIWE, WalletConnect v2, EIP-712, EIP-1271, ERC-2612, ENS/SNS references/web3_connect.md scripts/web3_connect.py
On-chain monitoring — whale tracker, mempool sniffer, smart money (Nansen/Arkham), NFT alerts, contract deployment listener, multi-chain portfolio references/monitoring.md scripts/monitoring.py, scripts/monitoring_advanced.py
Security — secret hygiene, encrypted storage, transaction safety references/security.md

Why a Skill Pack (Not a Bot)

Hardcoded crypto bots break the moment a chain forks or a DEX updates its router. This pack is declarative reference + production scripts — the agent reads the relevant file at task time, composes the call from current ABI/router data, and executes. New chain support means adding one reference file, not rewriting a binary.

This pattern works well with the new generation of long-context, tool-use-capable models like Xiaomi MiMo V2.5, where the agent can hold the full reference module in context while reasoning about a multi-step swap or bridge plan.


Operating Principles (excerpt from SKILL.md)

  1. User-funds-only rule. The agent only operates on wallets the user owns and confirms. It refuses to act on third-party seed phrases or credentials presented as "target wallets" or "found in a group."
  2. No drainer, no scam-sybil. No drainer code, no phishing payloads, no malicious approval generators.
  3. Confirm before signing. Every fund-moving transaction shows a plan first: chain, action, amount, recipient, est. gas, slippage.
  4. Simulate before broadcast. Dry-run via eth_call (or chain equivalent). Honeypots, zero-output traps, and extreme slippage are caught before a single wei moves.
  5. Secret hygiene. Private keys and seed phrases are never logged, printed raw, or sent to third-party services. Local encrypted storage only.

Full rules: SKILL.md and references/security.md.


Chain Coverage

Chain Library Status
EVM (Ethereum, BSC, Base, Arbitrum, Optimism, Polygon, Avalanche, Linea, Scroll, …) web3.py, eth_account ✅ Production
Solana solana-py, solders ✅ Production
Sui pysui ✅ Reference + scripts
Aptos aptos-sdk ✅ Reference + scripts
TON pytoniq, tonsdk ✅ Reference + scripts

Repo Layout

hermes-crypto-agent/
├── SKILL.md                      ← Skill manifest (the agent loads this first)
├── README.md
├── references/                   ← Per-capability operating docs
│   ├── wallets.md
│   ├── swap.md
│   ├── nft.md
│   ├── sniping.md
│   ├── airdrop_automation.md
│   ├── bridge.md
│   ├── defi.md
│   ├── web3_connect.md
│   ├── monitoring.md
│   └── security.md
└── scripts/                      ← Standalone production templates
    ├── wallet_manager.py
    ├── swap_engine.py
    ├── nft_engine.py
    ├── bridge_engine.py
    ├── airdrop_runner.py
    ├── web3_connect.py
    ├── monitoring.py
    └── monitoring_advanced.py

Use With

  • Claude Code — drop into your skills directory, agent auto-discovers.
  • Cursor — reference from .cursorrules or paste capability tables into context.
  • OpenClaw — register as a skill module in your agent config.
  • Xiaomi MiMo API — long-context reasoning over the full reference set; ideal for multi-step planning.

License

MIT.


This is a defensive-by-default crypto operations toolkit. Do not use it to operate on wallets you do not own.

About

Multi-chain crypto + Web3 agent toolkit — wallet ops, swap, NFT, sniping, bridge, DeFi, on-chain monitoring across EVM/Solana/Sui/Aptos/TON. Integrates with Claude Code, Cursor, and OpenClaw.

Topics

Resources

Stars

5 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages