Trade tokens on Canton Network from your terminal.
Non-custodial. Local-first.
trngle is a self-contained terminal application for swapping tokens on Canton Network. It connects to your Loop wallet, fetches live quotes from the operator, and signs every transaction locally with your private key. Nothing is custodial — your keys never leave your machine.
Testnet only — this release trades test tokens on Canton Network testnet. Mainnet support is planned.
macOS / Linux:
curl -fsSL https://cli.trngle.xyz/install.sh | shWindows (PowerShell):
irm https://cli.trngle.xyz/install.ps1 | iexNo dependencies. The installer downloads a single binary and adds it to your PATH.
trngle
A setup wizard runs on first launch:
- Network — select testnet
- Wallet — connect your Loop wallet (ed25519 key + party ID)
- Local API — optionally enable a REST API for programmatic access
Once connected:
❯ quote 100 CC to CBTC
Review the rate, press Y to confirm, and the swap executes on-chain.
| Command | Description |
|---|---|
quote <amount> <from> to <to> |
Request a swap quote (e.g. quote 100 CC to CBTC) |
balance |
Show wallet balances |
address |
Show your wallet address |
trades |
View trade history |
transfers |
View pending incoming transfers |
settings |
Open settings (network, API port, keys) |
theme <name> |
Change color theme |
lang <code> |
Change language (en, fr, it, es, ru, zh) |
help |
Show available commands |
quit |
Exit |
| Asset | Description |
|---|---|
| CC | Canton Coin (Amulet) |
| CBTC | Canton BTC |
- You request a quote — trngle calls the operator API
- You review the price in your terminal
- On confirmation, trngle signs the transaction locally and submits it on-chain via your Loop wallet
- The operator settles the trade — both sides receive their tokens
The operator provides liquidity and settlement. trngle provides the interface. All signing happens on your machine.
trngle can run an optional REST API on localhost for programmatic trading. Enable it during setup or with the --api-only flag.
trngle --api-only --port 8080
Endpoints include /health, /balances, /trade/quote, /trade/{id}/confirm, /trades, /transfers, and a /ws WebSocket for real-time trade events. See docs/API.md for full documentation.
Config is stored at ~/.trngle/config.json. Trade history is in ~/.trngle/history.db.
trngle --trngle-api-url https://your-api.example.com
git clone https://github.com/trngle-xyz/cli.git
cd cli
make build
./trngleRequires Go 1.21+.
macOS / Linux:
curl -fsSL https://cli.trngle.xyz/uninstall.sh | shWindows (PowerShell):
irm https://cli.trngle.xyz/uninstall.ps1 | iexRemoves the binary and optionally your config/history at ~/.trngle/.
