--- name: coinfello description: 'Interact with CoinFello using the @coinfello/agent-cli to create a smart account, sign in with SIWE, manage delegations, send prompts with server-driven ERC-20 token subdelegations, and check transaction status. Use when the user wants to send crypto transactions via natural language prompts, manage smart account delegations, or check CoinFello transaction results.' compatibility: Requires Node.js 20+ (npx is included with Node.js). metadata: clawdbot: emoji: '👋' homepage: 'https://coinfello.com' requires: bins: ['node', 'npx'] env: - name: COINFELLO_BASE_URL description: 'Base URL for the CoinFello API server' required: false default: 'https://app.coinfello.com/' - name: RPC_BASE_URL description: 'QuickNode RPC base URL (e.g. https://your-endpoint-name)' required: false - name: RPC_API_KEY description: 'QuickNode API key' required: false - name: RPC_URL_OVERRIDE description: 'Custom RPC URL override for development/testing (overrides all other RPC settings)' required: false ---

CoinFello CLI Skill

Use the npx @coinfello/agent-cli@latest CLI to interact with CoinFello. The CLI handles smart account creation, SIWE authentication, delegation management, prompt-based transactions, and transaction status checks.

Prerequisites

• Node.js 20 or later (npx is included with Node.js)

The CLI is available via npx @coinfello/agent-cli@latest. No manual build step is required.

Environment Variables

| Variable | Required | Default | Description | | -------------------- | -------- | ---------------------------- | ---------------------------------------------------------------------------------- | | COINFELLO_BASE_URL | No | https://app.coinfello.com/ | Base URL for the CoinFello API | | RPC_BASE_URL | No | — | QuickNode RPC base URL (e.g. https://your-endpoint-name) | | RPC_API_KEY | No | — | QuickNode API key | | RPC_URL_OVERRIDE | No | — | Custom RPC URL override for development/testing (overrides all other RPC settings) |

If both RPC_BASE_URL and RPC_API_KEY are set, the CLI routes RPC requests through QuickNode for supported chains (Ethereum, Polygon, BSC, Linea, Base, Base Sepolia, Optimism, Arbitrum, Ethereum Sepolia). If either is missing or the chain is not supported, it falls back to the chain's default public RPC.

Set RPC_URL_OVERRIDE (e.g. http://127.0.0.1:8545) to route all RPC calls through a custom URL, regardless of chain or other RPC settings.

Security Notice

This skill performs the following sensitive operations:

• Key generation and storage: By default, create_account generates a hardware-backed P256 key in the macOS Secure Enclave (or TPM 2.0 where available). The private key never leaves the hardware and cannot be exported — only public key coordinates and a key tag are saved to ~/.clawdbot/skills/coinfello/config.json. If hardware key support is not available, the CLI warns and falls back to a software private key. You can also explicitly opt into a plaintext software key by passing --use-unsafe-private-key, which stores a raw private key in the config file — this is intended only for development and testing.
• Signer daemon: Running signer-daemon start authenticates once via Touch ID / password and caches the authorization. All subsequent signing operations reuse this cached context, eliminating repeated auth prompts. The daemon communicates over a user-scoped Unix domain socket with restricted permissions (0600). If the daemon is not running, signing operations fall back to direct execution (prompting Touch ID each time).
• Session token storage: Running sign_in stores a SIWE session token in the same config file.
• Delegation signing: Running send_prompt may receive a delegation request from the server, which is saved to a local file. Running approve_delegation_request creates and signs the delegation, then submits it to the CoinFello API.

Users should ensure they trust the CoinFello API endpoint configured via COINFELLO_BASE_URL before running delegation flows.

Quick Start

# 1. Start the signing daemon (optional, but avoids repeated Touch ID prompts)
npx @coinfello/agent-cli@latest signer-daemon start

# 2. Create a smart account (uses Secure Enclave by default)
npx @coinfello/agent-cli@latest create_account

# 3. Sign in to CoinFello with your smart account (SIWE)
npx @coinfello/agent-cli@latest sign_in

# 4. Send a natural language prompt — if a delegation is needed, it will be saved for review
npx @coinfello/agent-cli@latest send_prompt "send 5 USDC to 0xRecipient..."

# 5. Approve the delegation request (if one was saved by send_prompt)
npx @coinfello/agent-cli@latest approve_delegation_request

Commands

create_account

Creates a MetaMask Hybrid smart account. By default, the signing key is generated in the macOS Secure Enclave (hardware-backed, non-exportable). If Secure Enclave is unavailable, the CLI warns and falls back to a software key. Pass --use-unsafe-private-key to explicitly use a plaintext software key (development/testing only).

npx @coinfello/agent-cli@latest create_account [--use-unsafe-private-key]

• Default (Secure Enclave): Generates a P256 key in hardware; saves key_tag, public_key_x, public_key_y, key_id, and smart_account_address to ~/.clawdbot/skills/coinfello/config.json. The private key never leaves the Secure Enclave.
• --use-unsafe-private-key: Generates a random secp256k1 private key and stores it in plaintext in the config file. Use only for development and testing.
• Must be run before send_prompt

get_account

Displays the current smart account address from local config.

npx @coinfello/agent-cli@latest get_account

• Prints the stored smart_account_address
• Exits with an error if no account has been created yet

sign_in

Authenticates with CoinFello using Sign-In with Ethereum (SIWE) and your smart account. Saves the session token to local config.

npx @coinfello/agent-cli@latest sign_in

• Signs in using the private key stored in config
• Saves the session token to ~/.clawdbot/skills/coinfello/config.json
• The session token is loaded automatically for subsequent send_prompt calls
• Must be run after create_account and before send_prompt for authenticated flows

set_delegation

Stores a signed parent delegation (JSON) in local config.

npx @coinfello/agent-cli@latest set_delegation '<delegation-json>'

• — A JSON string representing a Delegation object from MetaMask Smart Accounts Kit

new_chat

Clears the saved chat session ID from local config so the next send_prompt starts a fresh conversation.

npx @coinfello/agent-cli@latest new_chat

• Removes chat_id from ~/.clawdbot/skills/coinfello/config.json
• Use this when you want to reset conversation context (for example, after context-window errors)

signer-daemon

Manages the Secure Enclave signing daemon. Starting the daemon authenticates once via Touch ID / password and caches the authorization, so subsequent signing operations (account creation, sign-in, delegation signing) do not prompt again.

npx @coinfello/agent-cli@latest signer-daemon start    # Start daemon (one-time auth)
npx @coinfello/agent-cli@latest signer-daemon status   # Check if daemon is running
npx @coinfello/agent-cli@latest signer-daemon stop     # Stop the daemon

...