Skip to main content

Using the Terminal

dappTerminal is a browser-based terminal with multi-tab support and fiber-based protocol contexts. This guide covers the core interaction model.


Prompt Format

The prompt indicates your current context:

user@defi>          ← In the global monoid M_G (no active protocol)
user@1inch> ← Inside the 1inch fiber
user@wormhole> ← Inside the Wormhole fiber

The fiber context determines which protocol commands are available without a namespace prefix.


Entering and Exiting Protocol Fibers

Enter a fiber

use <protocol-id>

Examples:

use 1inch
use wormhole
use lifi
use stargate
use coinpaprika

After entering, the prompt changes and protocol commands are accessible without the namespace prefix:

user@defi> use 1inch
user@1inch> swap 1 eth usdc # resolves to 1inch:swap
user@1inch> quote 0.5 eth usdc

Exit a fiber

exit

Returns to the global monoid:

user@1inch> exit
user@defi>

Core Commands

These commands are always available, regardless of which fiber is active:

CommandDescription
helpList available commands (fiber-aware)
use <protocol>Enter a protocol fiber
exitExit current protocol fiber
historyShow command execution log
walletShow wallet connection status
whoamiDisplay connected wallet address
balanceShow wallet token balances
price <symbol>Get token price (routes to 1inch or CoinPaprika)
chart <type>Add chart to analytics panel
clearClear terminal output

Command Syntax

Basic command

command arg1 arg2

Protocol-scoped command (namespace form)

protocol:command arg1 arg2
1inch:swap 1 eth usdc
wormhole:bridge 0.5 eth optimism arbitrum
coinpaprika:cprice BTC

With flags

price BTC --protocol coinpaprika
chart BTC --protocol coinpaprika --line

Arrow keys

  • Up arrow — navigate to previous command in history.
  • Down arrow — navigate forward in history.

Tab completion

Tab triggers the fuzzy resolver (ρ_f) which suggests matching commands based on what you've typed. Results respect fiber context — inside a fiber, only that fiber's commands are suggested.


Multi-Tab Usage

Each tab has its own independent ExecutionContext:

  • Different active protocols per tab.
  • Separate command history.
  • Independent wallet context.

Open a new tab by clicking the + button in the tab bar. You can run 1inch commands in one tab while running Wormhole commands in another.


Protocol Commands (When Inside a Fiber)

When you're inside a fiber (after use <protocol>), unqualified commands resolve against that fiber first:

user@defi> use wormhole
user@wormhole> bridge 1 eth optimism arbitrum # → wormhole:bridge
user@wormhole> quote # → wormhole:quote
user@wormhole> status # → wormhole:status
user@wormhole> help # shows Wormhole commands + global commands

Cross-fiber access is blocked when inside a fiber:

user@wormhole> 1inch:swap 1 eth usdc   # ❌ BLOCKED — cross-fiber access

Exit to M_G first:

user@wormhole> exit
user@defi> 1inch:swap 1 eth usdc # ✅ Works from global context

Wallet Connection

The wallet is connected via RainbowKit (top right of the page). Once connected, wallet state is available to all protocol commands:

whoami
→ Connected: 0x742d...C3B8
→ Chain: Ethereum Mainnet (1)

balance
→ ETH: 1.245
→ USDC: 5,000.00

Some commands (quote, status, search) work without a wallet. Transaction execution always requires a connected wallet.


Fuzzy Matching

If you mistype a command, the fuzzy resolver (ρ_f) suggests the closest match:

user@1inch> swp 1 eth usdc
→ Did you mean: swap?

Getting Help

help           # Show all available commands in current context
help swap # Show help for a specific command

Inside a fiber, help shows that fiber's commands plus essential global commands (help, exit, clear, history, wallet, whoami, balance).