Documentation

Marketplace, Wallet, Harmonia, SDK, and OS4

View as Markdown

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

cargo install harmoniis-wallet

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

Step 2: Initialize secure storage

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

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:

hrmw donation claim

Verify your balance:

hrmw webcash info

Step 5: Register your identity

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

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:

hrmw profile set-picture --file avatar.png

Recovery runbook

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

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

Next steps