sowa 1.1.0

A Solana Wallet CLI
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90

# SoWa - Solana Wallet CLI

Sowa (SOlana-WAllet) is a command-line interface tool for managing Solana wallets and performing basic operations on the Solana blockchain.

## Features

- Create new Solana accounts
- Check account balances
- Send SOL transactions
- View transaction history
- Configurable RPC endpoint

## Installation

### Prerequisites

- Rust and Cargo
- Git

### Building from source

1. Clone the repository:
   ```
   git clone https://github.com/yourusername/sowa.git
   cd sowa
   ```

2. Build the project:
   ```
   cargo build --release
   ```

3. The binary will be available at `target/release/sowa`

## Usage

You can run Sowa using either `cargo run` or the compiled binary directly. Here are some example commands:

### Create a new account

```
cargo run -- create-account
```

This will generate a new keypair and save it to `~/.config/sowa/keypair.json`.

### Check account balance

```
cargo run -- balance <PUBKEY>
```

Replace `<PUBKEY>` with the address you want to check.

### Send SOL

```
cargo run -- send <TO_PUBKEY> <AMOUNT>
```

This sends the specified amount of SOL to the given address.

### View transaction history

```
cargo run -- history
```

This command displays the transaction history for the current account.

### Configure RPC URL

View current RPC URL:
```
cargo run -- config
```

Update RPC URL:
```
cargo run -- config <NEW_RPC_URL>
```

## Configuration

Sowa stores its configuration in `~/.config/sowa/config.json`. The default RPC URL is set to the Solana devnet. You can change this to mainnet-beta or testnet as needed.

## Security Notes

- The keypair is stored locally at `~/.config/sowa/keypair.json`. Keep this file safe and do not share it with anyone.
- Always double-check addresses when sending transactions to avoid losing funds.