walle - GitLite

KO | EN

gitlite — search

#javascript #llm #golang #rust #deep-learning #docker #macos #awesome #kubernetes #awesome-list #security #mcp #openai #open-source

walle

(★ 55)

Terminal-first EVM wallet with WalletConnect v2, ERC-20 transfers, and custom RPC support

파일 탐색기

최종 버전 다운로드 (.zip)

- pre-commit
- prepare-commit-msg
- walle.js
- - add-new-chain.jpeg
  - add-new-token.jpeg
  - confirm-walletconnect.jpeg
  - confirm.jpeg
  - connect-walletconnect.jpeg
  - home.jpeg
  - select-chain.jpeg
  - sign-message.jpeg
  - transfer.jpeg
- 500.png
- logo.png
- - ActionItem.tsx
  - AsyncButton.tsx
  - Button.tsx
  - ButtonLink.tsx
  - Checkbox.tsx
  - Divider.tsx
  - Error.tsx
  - index.ts
  - Input.tsx
  - InputBox.tsx
  - Link.tsx
  - List.tsx
  - Loader.tsx
  - Menu.tsx
  - TextButton.tsx
  - TransactionDetails.tsx
- - index.ts
  - types.ts
- - index.ts
  - useAddressResolver.ts
  - useAsync.ts
  - useChain.ts
  - useClipboard.ts
  - useContract.ts
  - useDidMountEffect.ts
  - useEstimate.ts
  - useGasPrice.ts
  - useInput.ts
  - useKey.ts
  - usePrevious.ts
  - useSelection.ts
  - useTokens.ts
  - useWallet.ts
  - useWalletConnectRequestHandler.ts
- - index.ts
  - WalletConnectHandler.tsx
  - WelcomeLayout.tsx
- - index.ts
- - createWithSubscribeSelector.ts
  - deserialize.ts
  - index.ts
  - initSubscribers.ts
  - runStoreAutosave.ts
  - serialize.ts
- - bigintifyTx.ts
  - clamp.ts
  - formatNumber.ts
  - fs.ts
  - getDerivationPath.ts
  - index.ts
  - isDefined.ts
  - isNumeric.ts
  - toUtf8String.ts
- App.tsx
- index.tsx
- Router.tsx
- routes.tsx
- wallet-connect.ts
.eslintrc.js
.gitignore
.prettierrc
esbuild.config.js
LICENSE
package.json
pnpm-lock.yaml
README.md
SECURITY.md
tsconfig.json

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<p align="center">
  <img src="github/logo.png" height="200" alt="Walle logo">
</p>

# Walle - CLI Crypto Wallet for EVM Networks

Terminal-first wallet for everyday EVM actions: manage accounts, send native and ERC-20 transfers, and approve WalletConnect v2 requests from your command line.

[![npm version](https://img.shields.io/npm/v/%40walleproject%2Fcli?logo=npm&logoColor=white)](https://www.npmjs.com/package/@walleproject/cli)
[![license](https://img.shields.io/npm/l/%40walleproject%2Fcli)](https://raw.githubusercontent.com/Pobepto/walle/main/LICENSE)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
[![WalletConnect v2](https://img.shields.io/badge/WalletConnect-v2-3B99FC?logo=walletconnect&logoColor=white)](https://walletconnect.com/)
[![Interface CLI](https://img.shields.io/badge/interface-CLI-1f2937)](https://github.com/Pobepto/walle)

## What is Walle?

Walle is a **CLI crypto wallet** and **terminal EVM wallet** for Ethereum-compatible networks.

It focuses on practical wallet workflows in terminal UI:

- wallet creation and account management
- mnemonic/private key import
- native coin and ERC-20 transfer flows
- WalletConnect v2 request handling
- custom RPC chain setup

## Screenshots

![Home](https://raw.githubusercontent.com/Pobepto/walle/main/github/screenshots/home.jpeg)
![Transfer](https://raw.githubusercontent.com/Pobepto/walle/main/github/screenshots/transfer.jpeg)
![Add New Chain](https://raw.githubusercontent.com/Pobepto/walle/main/github/screenshots/add-new-chain.jpeg)
![Add New Token](https://raw.githubusercontent.com/Pobepto/walle/main/github/screenshots/add-new-token.jpeg)
![Switch Chain](https://raw.githubusercontent.com/Pobepto/walle/main/github/screenshots/select-chain.jpeg)
![Connect WalletConnect](https://raw.githubusercontent.com/Pobepto/walle/main/github/screenshots/connect-walletconnect.jpeg)
![Confirm WalletConnect Request](https://raw.githubusercontent.com/Pobepto/walle/main/github/screenshots/confirm-walletconnect.jpeg)
![Sign Message](https://raw.githubusercontent.com/Pobepto/walle/main/github/screenshots/sign-message.jpeg)

## Key Features (Implemented)

- Works with EVM chains, including custom RPC networks.
- Supports multiple wallet accounts and chain switching.
- Supports native transfers and **ERC-20 transfer** / approve flows.
- Supports transaction confirmation with **EIP-1559** gas fields.
- Supports **mnemonic/private key import**.
- Supports WalletConnect v2 session approval and request handling.
- Stores wallet data encrypted on disk using ethers wallet encryption.

## Planned Features (Roadmap)

- Better support for WalletConnect typed data signing flows.
- Expanded contract interaction UX.
- NFT-related features.
- Support for non-EVM networks.

## Installation

```bash
npm i -g @walleproject/cli
```

Alternative package managers:

```bash
yarn global add @walleproject/cli
pnpm add -g @walleproject/cli
```

## Quick Start

```bash
walle
```

- Use `Tab` to switch active panels.
- Use arrow keys (`Up` / `Down`) to navigate actions.
- Check the in-app Help section for shortcuts and flow hints.

## WalletConnect v2 Support Matrix

Current status is based on request handlers in the codebase.

| Method                   | Status        |
| ------------------------ | ------------- |
| `personal_sign`          | Supported     |
| `eth_sign`               | Supported     |
| `eth_sendTransaction`    | Supported     |
| `eth_signTransaction`    | Supported     |
| `eth_signTypedData`      | Not supported |
| `eth_signTypedData_v3`   | Not supported |
| `eth_signTypedData_v4`   | Not supported |
| `eth_sendRawTransaction` | Not supported |

## Tech Stack

- TypeScript
- Node.js CLI + Ink (React for CLIs)
- ethers.js
- WalletConnect Sign Client v2
- Zustand state management

## Developer Workflow

```bash
git clone https://github.com/Pobepto/walle.git
cd walle
npm install
```

Useful scripts:

- `npm run dev` - build in watch mode
- `npm run build` - production build
- `npm run check` - TypeScript type-check
- `npm run format` - format source files

## Security Notes

- Keep your mnemonic phrase and private keys offline and never share them.
- Use dedicated wallets for testing and limit balances in hot wallets.
- Verify recipient addresses, chain IDs, and contract addresses before confirming.
- Wallet encryption reduces risk, but local machine compromise can still expose funds.
- This project is provided **as-is**, has **no formal security audit**, and is used **at your own risk**.
- You use this software entirely at your own risk and are solely responsible for transaction outcomes and private key storage.
- See `SECURITY.md` for supported versions, vulnerability reporting, and disclaimer details.

## Contributing

Contributions are welcome.

- Open an issue for bugs or feature ideas.
- Submit a pull request with a clear description and reproduction steps (if bug fix).
- Keep changes focused and aligned with existing code style.

## License

MIT License. See `LICENSE`.