---
sidebar_position: 4
slug: /use/wallets/install-lethean-cli-wallet-ubuntu
---

# Install Lethean CLI Wallet (Linux)

Download, sync, create a wallet, and start mining.

## 1. Download

```bash
wget https://downloads.lthn.io/lethean-testnet-linux-x86_64-v6.0.1.tar.gz
tar xzf lethean-testnet-linux-x86_64-v6.0.1.tar.gz
cd lethean-testnet-linux-x86_64-v6.0.1
```

Or build from source: see [Building From Sources](/docs/build/building-from-sources).

## 2. Start the daemon

```bash
./lethean-testnet-chain-node --data-dir ./data
```

The daemon will sync the blockchain. On first run this takes a few minutes. You'll see block heights counting up. Wait until it's fully synced (height matches [explorer.lthn.io](https://explorer.lthn.io)).

To connect to the testnet seed node:
```bash
./lethean-testnet-chain-node --data-dir ./data --add-priority-node --use-only-priority-nodes 10.69.69.165:46942
```

## 3. Create a wallet

Open a new terminal in the same directory:

```bash
./lethean-testnet-wallet-cli \
  --generate-new-wallet my-wallet \
  --daemon-address 127.0.0.1:36941
```

You'll be prompted for a password. The wallet will display:
- Your **address** (starts with `iTHN`)
- Your **view key**
- Your **24-word seed phrase** — write this down and store it securely

```
Generated new wallet: iTHNUNiuu3VP1yy8xH2y5iQaABKXurdjqZmzF...
view key: 09a68f5559915664e65dd3ee0b6b0e98...
```

## 4. Check balance

```bash
# Open existing wallet
./lethean-testnet-wallet-cli \
  --wallet-file my-wallet \
  --daemon-address 127.0.0.1:36941
```

The wallet syncs with the daemon and shows your balance:
```
balance unlocked      / [balance total]        ticker    asset id
0.0                                            LTHN      d6329b...  NATIVE
```

## 5. Start mining

In a separate terminal, use the daemon's HTTP mining API:

```bash
curl -X POST http://127.0.0.1:36941/start_mining \
  -H 'Content-Type: application/json' \
  -d '{"miner_address":"YOUR_iTHN_ADDRESS","threads_count":4}'
```

Blocks are mined every ~2 minutes. Each block rewards 1 LTHN. Coins unlock after 10 confirmations (~20 minutes).

To stop mining:
```bash
curl -X POST http://127.0.0.1:36941/stop_mining \
  -H 'Content-Type: application/json'
```

## 6. Wallet RPC mode

For automated services, run the wallet as an RPC server:

```bash
./lethean-testnet-wallet-cli \
  --wallet-file my-wallet \
  --password "YOUR_PASSWORD" \
  --daemon-address 127.0.0.1:36941 \
  --rpc-bind-port 36944 \
  --rpc-bind-ip 127.0.0.1
```

Test it:
```bash
curl -X POST http://127.0.0.1:36944/json_rpc \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":"0","method":"getbalance"}'
```

## Binary reference

| Binary | Description |
|--------|-------------|
| `lethean-testnet-chain-node` | Blockchain daemon (testnet) |
| `lethean-testnet-wallet-cli` | Wallet CLI + RPC server (testnet) |
| `lethean-chain-node` | Blockchain daemon (mainnet) |
| `lethean-wallet-cli` | Wallet CLI + RPC server (mainnet) |

## Address types

| Prefix | Type | Use |
|--------|------|-----|
| `iTHN` | Standard | Regular wallet address |
| `iTHn` | Integrated | Address with embedded payment ID (for exchanges) |
| `iThN` | Auditable | Transparent wallet (for organisations) |
| `iThn` | Auditable integrated | Transparent + payment ID |

> **Verified:** All commands tested on Lethean testnet. Wallet creation, daemon sync, balance check, mining via `/start_mining`, and wallet RPC all confirmed working.
