fibx

fibx

A command-line tool for DeFi operations on Base, Citrea, HyperEVM, and Monad, powered by Fibrous aggregation and Privy Server Wallets.

Features

• Multi-Chain Support: Base, Citrea, HyperEVM, and Monad
• Token Swaps: Optimal routing via Fibrous aggregation with auto-slippage
• Transfers: Send ETH or any ERC-20 token
• Aave V3: Supply, borrow, repay, and withdraw on Base
• MCP Server: Built-in AI agent integration for Cursor, Claude Desktop, and Antigravity
• Privy Server Wallets: Secure server-side signing
• Private Key Import: Use an existing wallet for local execution
• Simulation: All transactions are simulated before execution
• JSON Output: --json flag for scripting and pipelines

Requirements

• Node.js >= 18
• A running fibx-server instance (for Privy wallet operations)

Usage

Authentication

# Email OTP (uses Privy server wallet)
npx fibx auth login [e-mail]
npx fibx auth verify [e-mail] 123456

# Or import a private key (local signing, no server needed)
npx fibx auth import

# Logout
npx fibx auth logout

# Check status
npx fibx status

Global Options

Use -c or --chain to specify the target chain. Default is base.

Supported: base, citrea, hyperevm, monad

Configuration

You can configure custom RPC URLs to avoid rate limits on public endpoints.

# Set a custom RPC URL for a chain
npx fibx config set-rpc base https://mainnet.base.org

# View current RPC URL
npx fibx config get-rpc base

# List all custom configurations
npx fibx config list

Balance

npx fibx balance
npx fibx balance --chain citrea

Send

npx fibx send 0.001 0xRecipient           # Send native token on Base (ETH)
npx fibx send 10 0xRecipient USDC         # Send ERC-20 on Base
npx fibx send 1 0xRecipient --chain monad # Send on Monad native token (MON)

Swap

npx fibx trade <amount> <from> <to>
npx fibx trade 0.0001 ETH USDC
npx fibx trade 20 USDC DAI
npx fibx trade 1 MON USDC --chain monad

Options: --slippage <n> (default: 0.5%), --approve-max, --json

Note: The trade command automatically detects Wrap (Native -> Wrapped) and Unwrap (Wrapped -> Native) operations and executes them directly via contract calls, bypassing aggregator routing to save gas.

Transaction Status

npx fibx tx-status <hash>
npx fibx tx-status 0x123...abc --chain monad

Wallet Info

npx fibx address              # Print wallet address
npx fibx wallets <email>      # List active wallet

Aave V3 (Base)

npx fibx aave status               # Account health
npx fibx aave supply 1 ETH         # Auto-wraps ETH -> WETH and supplies
npx fibx aave supply 100 USDC      # Supply ERC-20
npx fibx aave borrow 50 USDC       # Borrow
npx fibx aave repay 50 USDC        # Repay
npx fibx aave repay max ETH        # Auto-wraps ETH and repays full WETH debt
npx fibx aave withdraw max ETH     # Withdraws WETH and auto-unwraps to ETH

Note: supply, repay, and withdraw support automatic ETH <-> WETH wrapping/unwrapping on Base.

AI Agent Integration

MCP Server

fibx includes a built-in MCP server for AI editors like Cursor, Claude Desktop, and Antigravity. See MCP.md for setup and usage.

npx fibx mcp-start

Agent Skills

For prompt-based agent integration, see the fibx-skills directory.