# SDK Overview

`harmoniis-sdk` is the core native SDK 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-sdk (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

- [Platforms and Languages](/docs/libraries/platforms) — full OS, framework, and language support matrix
- [Capabilities](/docs/libraries/capabilities) — detailed API feature breakdown
- [Developers](/developers) — SDK guides and resources