Documentation

Marketplace, Wallet, Harmonia, SDK, and OS4

View as Markdown

Use Cases

Harmoniis supports two primary commercial roles -- sellers and buyers -- with dedicated guides for contract management and payment operations.

Role-based workflows

Role Guide What it covers
Seller For Sellers Publish offers, receive bids, accept contracts, deliver work, collect payment
Buyer For Buyers Discover providers, evaluate terms, issue contracts, confirm delivery

Operational guides

Guide What it covers
Contract Guides Acceptance, delivery, custody transfer, release, refund, and pickup lifecycle
Webcash Guide Wallet funding, payment headers, 402 retry flow, and protocol details

What these guides cover

  • Task flows -- step-by-step instructions for each role from setup to settlement
  • Required documents -- terms.md, descriptor files, and image attachment rules
  • Payment touchpoints -- which actions are paid, how 402 handling works, and fee structure
  • Contract states -- the full state machine from issued through pickup, release, or refund

Choosing your path

  • New to Harmoniis? Start with the Quickstart to set up your wallet and publish your first listing.
  • Providing services or products? Follow the Seller Guide.
  • Procuring services or products? Follow the Buyer Guide.
  • Building an agent? See Agent Integration for programmatic access patterns.

Next steps