Chainai

chainai — Ethereum Transactions Skill

⚠️ DISCLAIMER — USE AT YOUR OWN RISK

This tool interacts with real blockchain networks and real funds. The author(s) of this tool are not responsible for any loss of funds, damages, or unintended consequences arising from its use. By using this skill, you accept full responsibility for all operations performed.

🔒 MANDATORY SECURITY REQUIREMENTS FOR ALL AGENTS

Agents MUST take every possible action to safeguard CHAINAI_PRIVATE_KEY and all other private keys from exposure. Specifically:

1. NEVER log, print, echo, or display private keys in any user-facing output, logs, chat messages, or debug traces.
2. NEVER store private keys in plain text files, version control, or any persistent storage that is not explicitly encrypted and access-controlled.
3. NEVER transmit private keys over unencrypted channels or include them in URLs, query parameters, or request bodies to third-party services.
4. NEVER include private keys in error messages, stack traces, or diagnostic output.
5. ALWAYS prefer the CHAINAI_PRIVATE_KEY environment variable over the -k flag to minimize key exposure in shell history and process listings.
6. ALWAYS treat private keys as the highest-sensitivity secret. A leaked private key grants full, irrevocable control over all funds in the associated wallet.

� ADDRESS FORMATTING RULES

1. Always use ERC-55 checksum addresses when passing addresses to any command (wallet addresses, token contract addresses, recipient addresses, etc.).
2. If you do not know the correct checksum, use all lowercase addresses (e.g. 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2 instead of guessing the mixed-case checksum).
3. Never guess a token contract address. If you are unsure of the correct token contract address, always ask the user to provide it. Do not fabricate or assume token addresses.

�🚀 BEFORE YOU BEGIN

1. Verify your private key is set: Run npx chainai@0.0.10 who-am-i to confirm CHAINAI_PRIVATE_KEY is properly configured and resolves to the expected address before proceeding with any other command.
2. No private key? Use npx chainai@0.0.10 gen-wallet to generate a new wallet. Save the returned private key securely (e.g. as an environment variable) — it will not be shown again.
3. Fund your account: You must deposit the necessary funds (native tokens for gas + any tokens you intend to send or swap) to the wallet address before using send, swap, or any transaction-submitting command. Commands will fail if the account has insufficient balance.

Overview

chainai is a non-interactive CLI tool for Ethereum and EVM-compatible blockchain operations. It handles signing, sending, broadcasting transactions, token swaps (1inch Fusion), balance queries, and wallet generation.

Invocation

npx chainai@0.0.10 <command> [options]

• Runtime: Node.js (>=18)
• Non-interactive: All parameters must be passed as arguments or flags. Never prompts for input.

Authentication

Most commands accept a private key via:

• -k, --private-key <key> flag (hex string starting with 0x)
• CHAINAI_PRIVATE_KEY environment variable (fallback when -k is not provided)

Supported Networks

Use -n, --network to specify a network by name, alias, or chain ID. Defaults to mainnet.

Exit Codes

Message Contract

Success (stdout)

CHAINAI_OK: <description>
{ ... }

Errors (stderr)

CHAINAI_ERR: <ERROR_CODE> — <description>

Retry Strategy

For TIMEOUT and EXECUTION_FAILED errors, retry up to 2 times with exponential backoff before escalating.

Commands

gen-wallet

Generate a new random wallet (private key and address).

npx chainai@0.0.10 gen-wallet

Options: None.

Output (stdout):

{
  "address": "0x...",
  "privateKey": "0x..."
}

Usage instructions are printed to stderr.

who-am-i

Return the Ethereum address derived from a private key.

npx chainai@0.0.10 who-am-i -k 0xKEY
# or
CHAINAI_PRIVATE_KEY=0xKEY npx chainai@0.0.10 who-am-i

Options:

Output (stdout):

{
  "address": "0x..."
}

sign-message

Sign a message using EIP-191 personal sign.

npx chainai@0.0.10 sign-message -k 0xKEY -m "Hello World"
npx chainai@0.0.10 sign-message -k 0xKEY -m 0x68656c6c6f --raw

Options:

Output (stdout):

{
  "address": "0x...",
  "message": "<original message>",
  "signature": "0x..."
}

sign

⚠️ CRITICAL SECURITY WARNING: Signs a raw hash (secp256k1) without any prefix. The resulting signature can authorize any on-chain action. Use sign-message instead unless raw hash signing is explicitly required. Before using, verify the hash is legitimate and no safer alternative exists.

npx chainai@0.0.10 sign -k 0xKEY -h 0xHASH

Options:

Output (stdout):

{
  "address": "0x...",
  "hash": "0x...",
  "signature": "0x..."
}