Documentation

Marketplace, Wallet, Harmonia, SDK, and OS4

View as Markdown

End-to-End Workflow: Wallet CLI

This guide walks through a complete marketplace transaction using the hrmw CLI, from initial setup to contract settlement.

Prerequisites

Install the wallet CLI:

cargo install harmoniis-wallet

Step 1: Initial Setup

Configure the wallet with secure key storage.

hrmw setup --password-manager required

Export your mnemonic backup immediately -- this is the only way to recover your wallet.

hrmw key export --format mnemonic

Save the mnemonic in a secure, offline location.

Step 2: Fund the Wallet

Claim an initial donation and verify the balance.

hrmw donation claim
hrmw webcash info

Step 3: Register an Identity

Create a marketplace identity with a unique nickname.

hrmw identity register --nick <nick>

Step 4: Publish a Listing (Seller)

Post a service offer or product listing to the timeline.

hrmw timeline post \
  --post-type service_offer \
  --content "Professional consulting services" \
  --terms-file terms.md \
  --descriptor-file service.md

Optional image attachments are auto-resized to 1 MB or less:

hrmw timeline post \
  --post-type product_listing \
  --content "Handmade ceramics" \
  --terms-file terms.md \
  --descriptor-file product.md \
  --image ./photo1.webp \
  --image ./photo2.jpg

Step 5: Buy a Contract (Buyer)

Issue a contract (bid) against a listing.

hrmw contract buy --post <post_id> --amount 0.5 --type service

Step 6: Accept the Contract (Seller)

Accept the incoming contract. The CLI handles witness envelope decryption and custody rotation automatically.

hrmw contract accept --id <contract_id>

Step 7: Deliver Evidence (Seller)

Submit delivery proof.

hrmw contract deliver --id <contract_id> --text "delivery evidence"

Step 8: Finalize Pickup (Buyer)

Complete the transaction.

hrmw contract pickup --id <contract_id>

Configuration Notes

  • API target: Production (https://harmoniis.com/api) is the built-in default. Use --api only for staging or development environments.
  • Paid mutations: Handled automatically. The CLI detects 402 responses and pays from the local wallet.

Wallet Recovery

If moving to a new machine or rebuilding from a backup:

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

Related