GoodWallet
v1.5.6Crypto wallet for sending, swapping, trading perps, betting on Polymarket, earning DeFi yield, and signing across EVM, Solana, Bitcoin, Doge, and XRP. Use wh...
Like a lobster shell, security has layers — review code before you run it.
Runtime requirements
Install
npm i -g goodwalletGoodwallet
Crypto wallet CLI. Run goodwallet --help for the latest commands, flags, chains, and usage.
Update
Before running any other command, check for updates:
goodwallet update— check for a new version.- If outdated, run
goodwallet update --installbefore proceeding.
Rules
- Summarize outcomes in plain language; don't dump raw CLI output unless asked.
- Never fabricate values. Only report what the CLI returns.
- Read before write: inspect balances/quotes/positions before proposing any state-changing action.
- Confirm before executing any command that moves funds or creates exposure:
send,swap --execute,trade --deposit/--withdraw/--market,bet --deposit/--withdraw/--market,earn --deposit/--withdraw, and everysigncommand. - Don't reveal internal wallet details unless the user asks.
Auth
goodwallet auth— show the returned URL to the user.goodwallet auth --pair— run immediately; polls until the browser flow completes.goodwallet auth --logout— disconnect.
Signing Safety
All credentials and MPC key shares are stored locally at ~/.config/goodwallet/. No full private key ever exists — only a single MPC key share is stored on device. Signing uses 2-party MPC with a remote co-signer at sign.goodwallet.dev (operated by GoodDollar). The agent API at agent.goodwallet.dev issues signing room UUIDs and enforces transaction-policy checks (token allowlists, spend limits, malicious-contract detection) before co-signing, so most harmful payloads are rejected server-side. Both services communicate over HTTPS/WSS. Still, confirm with the user before running any sign command so they understand what they're approving.
Error Recovery
- Auth timeout → restart
auth+auth --pair. - Insufficient funds → suggest checking balances or reducing amount.
- No swap route → suggest different token, amount, or chain.
- Any other failure → report the error plainly, don't retry automatically.
Comments
Loading comments...
