trust-wallet-cli
Trust Wallet CLI (`twak`) — install, create wallets, check balances, send tokens, swap, view history, set price alerts, DCA automations, limit orders, manage ERC-20 approvals, check token risk, browse trending/DApps, and run x402 micropayments. Use whenever the user wants to use the twak CLI, manage a crypto wallet from the terminal, send or swap tokens via command line, check portfolio, create price alerts, set up DCA, create limit orders, approve ERC-20 spenders, or interact with Trust Wallet from a shell. Also covers MCP server setup for AI agents.
How do I install this agent skill?
npx skills add https://github.com/trustwallet/tw-agent-skills --skill trust-wallet-cliIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The Trust Wallet CLI skill provides a comprehensive suite of tools for managing cryptocurrency wallets, performing swaps, and interacting with on-chain identity and commerce protocols. It follows industry security best practices by emphasizing local signing, using the OS keychain for secrets, and implementing safety caps for transactions. No malicious patterns or security vulnerabilities were detected.
- Socketwarn
1 alert: gptSecurity
- Snykwarn
Risk: MEDIUM · 2 issues
- ZeroLeakspass
Score: 93/100 · 2 sections analyzed
What does this agent skill do?
Trust Wallet CLI (twak)
Command-line interface for multichain crypto wallet operations. Install with npm install -g @trustwallet/cli.
If the Trust Wallet plugin's twak MCP server is running (see the trust-wallet-mcp skill), do not install the CLI or run twak setup: run commands with the same version as that server, npx -y @trustwallet/cli@1 <command>, and the same TWAK_HOME, since both use the same files.
Quick Start
Read references/setup.md for installation and authentication.
Reference Guide
Read the reference that matches the user's task:
| Task | Reference | When to read |
|---|---|---|
| Install, auth, env vars | references/setup.md | First time setup, "install twak", "configure API keys" |
| List supported chains, chain keys | references/setup.md | "what chains are supported", "list chains", "show chain keys", "what is the chain key for X" |
| Create wallet, keychain, sign, register | references/wallet.md | "create wallet", "keychain", "sign message", "wallet status", "register wallet with backend" |
| Balance, holdings, portfolio | references/balance.md | "check balance", "portfolio", "token holdings" |
| Send tokens, ENS transfers | references/send.md | "send ETH", "transfer to", "vitalik.eth" |
USD limit, maximum slippage, twak config | references/limits.md | USD_LIMIT_EXCEEDED, USD_VALUE_UNVERIFIED, SLIPPAGE_EXCEEDED, "raise the limit", "max slippage", "twak config" |
| Swap tokens, cross-chain | references/swap.md | "swap ETH for USDC", "bridge", "cross-chain swap" |
| Buy/sell crypto with fiat | references/onramp.md | "buy ETH with USD", "onramp", "offramp", "fiat", "sell crypto for cash" |
| Prices, trending, DApps | references/market.md | "price of", "trending tokens", "dapps" |
| Transaction history | references/history.md | "tx history", "transaction details" |
| Price alerts | references/alerts.md | "alert when ETH", "price alert", "notify me" |
| DCA & limit orders | references/automations.md | "DCA", "dollar cost average", "limit order", "recurring swap", "buy when price" |
| ERC-20 approve/revoke | references/erc20.md | "approve spender", "check allowance", "revoke" |
| Token risk checks | references/token-risk.md | "is this token safe", "honeypot check", "audit status" |
| x402 micropayments | references/x402.md | "x402", "micropayment", "payment-gated API", "preview payment", "quote endpoint cost", "how much does this API charge" |
| BNB Hack competition register/status | references/compete.md | "register for the competition", "BNB hack", "AI trading agent edition", "compete", "registration status" |
| Register/manage ERC-8004 agent identities | references/erc8004.md | "register agent identity", "erc8004", "agent NFT", "agentURI", "agent metadata", "identity registry", "mint agent" |
| Agent job escrows (ERC-8183 Agentic Commerce) | references/erc8183.md | "erc8183", "agentic commerce", "job escrow", "create job", "fund job", "submit deliverable", "settle job", "dispute policy", "policy-info", "agent payment escrow", "evaluator router" |
| Run MCP / REST server for AI agents | MCP server section below | "MCP server", "twak serve", "connect an agent", "REST API" |
Read references/setup.md alongside any other reference if the CLI isn't installed yet.
MCP server
twak serve starts an MCP server on stdio exposing wallet actions to AI agents. Flags:
--rest— start a REST HTTP server instead of the MCP stdio server--port <n>— REST server port (default3000)--host <host>— REST bind host (default127.0.0.1; use0.0.0.0to expose externally)--password <password>— wallet password (falls back toTWAK_WALLET_PASSWORDenv var, then OS keychain)--auto-lock <minutes>— auto-lock the wallet after N minutes of inactivity--wc-project-id <id>— WalletConnect project ID override (default: Trust Wallet's project; or setWALLETCONNECT_PROJECT_ID). A stored WalletConnect session (seereferences/wallet.md) is resumed at startup.--watch— background watcher that fires DCA/limit automations; requires the local agent wallet (seereferences/automations.md)--watch-interval <duration>— automation poll interval when--watchis set, e.g.30s,5m,1h(default 60s, min 5s)--read-only— serve only tools that read (prices, quotes, balances, history, addresses), over MCP or REST. Tools that sign or change state are neither listed nor callable: calling one returnsREAD_ONLY(REST: 403). The wallet is fixed at startup (a resumed WalletConnect session, otherwise the local agent wallet), sinceswitch_wallet_modeis not served. Cannot be combined with--watch.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/trustwallet/tw-agent-skills/trust-wallet-cli">View trust-wallet-cli on skillZs</a>