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
- Portfolio: Cross-chain portfolio overview with USD valuations and DeFi positions
- Token Swaps: Optimal routing via Fibrous aggregation with auto-slippage
- Transfers: Send ETH or any ERC-20 token
- Aave V3: Supply, borrow, repay, withdraw, and browse markets on Base
- MCP Server: Built-in AI agent integration for Cursor, Claude Desktop, and Antigravity
- Agent Skills: Prompt-based AI skills via fibx-skills
- Privy Server Wallets: Secure server-side signing — private keys never leave Privy's TEE
- Private Key Import: Use an existing wallet for local execution
- Simulation: All transactions are simulated before execution
- Dry‑Run Mode:
--simulate flag estimates gas without sending a transaction
- JSON Output:
--json flag for scripting and pipelines
Supported Chains
| Base | ETH | ✅ |
| Citrea | cBTC | — |
| HyperEVM | HYPE | — |
| Monad | MON | — |
Installation
Run directly with npx (no install needed):
npx fibx status
Or install globally:
npm install -g fibx
Requirements
- Node.js >= 18
- A running fibx-server instance (required for Privy wallet operations; not needed for private key imports)
Usage
Authentication
npx fibx auth login user@example.com
npx fibx auth verify user@example.com 123456
npx fibx auth import
npx fibx status
npx fibx auth logout
Global Options
-c, --chain <name> | Target chain (base, citrea, hyperevm, monad) | base |
--json | Output results as JSON | false |
Balance
npx fibx balance
npx fibx balance --chain citrea
Portfolio
Consolidated cross-chain portfolio view with USD valuations:
npx fibx portfolio
npx fibx portfolio --json
Shows all token holdings across Base, Citrea, HyperEVM, and Monad with USD values. Includes DeFi positions (Aave V3 collateral/debt) and total portfolio net worth. Token prices are sourced live from Fibrous.
Send
npx fibx send 0.001 0xRecipient
npx fibx send 10 0xRecipient USDC
npx fibx send 1 0xRecipient --chain monad
npx fibx send 0.1 0xRecipient --simulate
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
npx fibx trade 0.1 ETH USDC --simulate
Options: --slippage <n> (default: 0.5%), --approve-max, --simulate, --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
npx fibx wallets
Aave V3 (Base)
npx fibx aave status
npx fibx aave markets
npx fibx aave supply 1 ETH
npx fibx aave supply 100 USDC
npx fibx aave borrow 50 USDC
npx fibx aave repay 50 USDC
npx fibx aave repay max ETH
npx fibx aave withdraw max ETH
npx fibx aave supply 1 ETH --simulate
Note: supply, repay, and withdraw support automatic ETH <-> WETH wrapping/unwrapping on Base.
Configuration
Set custom RPC URLs to avoid rate limits on public endpoints:
npx fibx config set-rpc base https://mainnet.base.org
npx fibx config get-rpc base
npx fibx config reset-rpc base
npx fibx config reset-rpc
npx fibx config list
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 available tools.
npx fibx mcp-start
Agent Skills
For prompt-based agent integration (Claude Code, Cursor, etc.), see the fibx-skills repository.
Related Links
License
MIT