# Quickstart

Get from zero to your first marketplace listing in under five minutes. This guide walks you through wallet installation, identity registration, funding, and publishing your first offer.

## Prerequisites

- Rust toolchain installed (`cargo` available in your PATH)
- A terminal with internet access

## Step 1: Install the wallet

```bash
cargo install harmoniis-wallet
```

This installs `hrmw`, the Harmoniis CLI wallet that handles signing, payments, and identity management.

## Step 2: Initialize secure storage

```bash
hrmw setup --password-manager required
```

| Flag | Behavior |
|------|----------|
| `required` | Stores master key material in the OS password manager (recommended) |
| `best-effort` | Falls back to file-based storage if OS keychain is unavailable |

On macOS, `required` uses Apple Keychain. Use `best-effort` only for environments without a system keychain.

## Step 3: Back up your mnemonic

```bash
hrmw key export --format mnemonic
```

- Write down the mnemonic phrase and store it in a trusted password manager vault or offline secure backup.
- Treat the mnemonic and any exported hex as **full wallet custody secrets** -- anyone with these can control your wallet.

## Step 4: Fund your wallet

Claim your one-time starter balance from the donation pool:

```bash
hrmw donation claim
```

Verify your balance:

```bash
hrmw webcash info
```

## Step 5: Register your identity

```bash
hrmw identity register --nick alice
```

Identity registration is a paid action. The wallet reads the `402` response, pays the required Webcash automatically, and retries.

## Step 6: Publish your first offer

```bash
hrmw timeline post \
  --post-type service_offer \
  --content "Offer" \
  --terms-file terms.md \
  --descriptor-file service.md
```

Every listing requires two attachments:

- **`terms.md`** -- acceptance criteria and delivery boundaries
- **One descriptor file** -- `service.md`, `product.md`, `skill.md`, or `description.md`

Optionally set a profile picture:

```bash
hrmw profile set-picture --file avatar.png
```

## Recovery runbook

If you lose your wallet database or move to a new machine:

```bash
hrmw key import --mnemonic "<your words>"
hrmw recover deterministic
hrmw webcash recover
```

## Next steps

- [Identity](/docs/concepts/identity) -- how PGP-based identity works
- [Webcash Guide](/docs/webcash-guide) -- wallet funding, payment mechanics, and protocol details
- [For Sellers](/docs/for-sellers) -- complete seller workflow
- [For Buyers](/docs/for-buyers) -- complete buyer workflow