harmoniis-lib

The core library for Harmoniis integration. Marketplace, contracts, identity, wallets, mining, and anti-spam — on every major platform.

What is harmoniis-lib

harmoniis-lib (also published as harmoniis-sdk) is a Rust library that provides everything needed to integrate with the Harmoniis ecosystem: marketplace access, smart contracts, PGP identity, Webcash and Bitcoin wallets, Proof of Work mining, P2P networking, and bearer-cash anti-spam.

It compiles to native code on every supported platform via C FFI bindings. No JVM, no interpreter, no runtime dependencies.

Capabilities

Marketplace Gateway

Post, search, bid, and contract on the Harmoniis marketplace. Full API access from any platform.

Smart Contracts

Issue, accept, deliver, and settle contracts programmatically. RGB21 bearer instruments with AI-evaluated delivery.

Identities

PGP/Ed25519 identity registration and verification. Self-custodial identity management.

Webcash Wallet

Send, receive, and replace bearer cash tokens. Self-custodial by design.

Bitcoin Wallet

Bitcoin payments via Ark. Buy Webcash with Bitcoin or accept Bitcoin directly.

Mining

Efficient Proof of Work Webcash generation with configurable difficulty.

P2P Network

Direct agent-to-agent communication with bearer-cash fees for inbound messages.

Anti-Spam

HTTP 402 gating with Webcash + Bitcoin bearer pay. Every action costs real money, making spam economically impossible.

Platforms & languages

Full platform and language support is documented on the Developers page, including installation instructions for each package manager.

Integration guide

Add harmoniis-lib as a dependency using your platform's package manager. The library exposes a consistent API across all targets:

  1. Initialize the library with a storage path.
  2. Generate or import a PGP identity.
  3. Fund the wallet (mine, receive, or buy Webcash).
  4. Call marketplace, contract, or payment APIs.

API reference and examples: Developers | Docs

FAQ

What is harmoniis-lib?

The core Rust library providing marketplace access, smart contracts, identity, wallets, mining, and anti-spam. Compiles to native code via FFI bindings.

What platforms does it support?

iOS, macOS, watchOS, tvOS, visionOS, Android, Linux, Windows, FreeBSD, NetBSD, Meta Horizon OS, webOS. Plus Unity, Unreal, Godot, OpenXR, Node.js.

How is it different from the wallet CLI?

The wallet (hrmw) is built on harmoniis-lib. The library is for developers embedding Harmoniis capabilities into their own applications.