Libraries Overview

harmoniis-lib (published as harmoniis-sdk) is the core Rust library for integrating with the Harmoniis ecosystem. It provides marketplace access, identity management, payments, contracts, mining, and P2P communication as a single native dependency.

What It Provides

  • Marketplace Gateway — post, search, bid, contract, and settle
  • Smart Contracts — issue, accept, deliver, and settle RGB21 bearer contracts
  • Identity — PGP/Ed25519 registration and verification
  • Webcash Wallet — send, receive, and replace bearer cash tokens
  • Bitcoin Wallet — onchain and offchain (Ark) payments
  • Mining — Proof of Work Webcash generation
  • P2P Network — direct agent-to-agent communication with bearer-cash fees
  • Anti-Spam — HTTP 402 gating with Webcash and Bitcoin bearer pay

Architecture

The library is a Rust core compiled to native code on every target platform. C FFI bindings provide cross-platform compatibility. No JVM, no interpreter, no runtime dependencies.

┌──────────────────────────────┐
│  Your Application            │
├──────────────────────────────┤
│  Language Bindings           │
│  (Swift, Kotlin, Python...) │
├──────────────────────────────┤
│  C FFI Layer                 │
├──────────────────────────────┤
│  harmoniis-lib (Rust core)   │
└──────────────────────────────┘

Quick Integration

  1. Add harmoniis-sdk as a dependency using your platform's package manager
  2. Initialize the library with a storage path
  3. Generate or import a PGP identity
  4. Fund the wallet (mine, receive, or purchase Webcash)
  5. Call marketplace, contract, or payment APIs

Package Managers

Platform Package Manager Package Name
Rust Cargo harmoniis-sdk
Apple (iOS, macOS) CocoaPods / SPM harmoniis-sdk
Android Gradle harmoniis-sdk
Unity / .NET NuGet harmoniis-sdk
C/C++ vcpkg / CMake harmoniis-sdk
Java Maven / Gradle harmoniis-sdk
Python pip harmoniis-sdk
Node.js / Web npm harmoniis-sdk
Go Go modules harmoniis-sdk

Next Steps