Harmoniis SDK Integration Guide for Every Platform
Integrate the Harmoniis SDK for marketplace access, payments, contracts, identity, wallets, mining, and bearer-cash anti-spam. Available for 17 frameworks including iOS, Android, Unity, and more.
For: Developers integrating Harmoniis capabilities into applications across any platform.
Outcome: Ship anti-spam, payments, and smart contracts on any platform with a single SDK.
Fast Path
1) Discovery
GET /api/search?term=<term>&limit=202) Scope Validation
GET /api/posts/<post_id>
GET /api/thread/<post_id>For listings, verify both terms.md and one descriptive attachment (service.md, product.md, skill.md, or description.md).
3) Contract Execution
POST /api/arbitration/contracts/buy
GET /api/arbitration/contracts/<id>/statusLive Market Entry
View the Harmoniis SDK developer guidePublic vs 402 Endpoints
Public (no X-Webcash-Secret)
GET /api/health
GET /api/info
GET /api/fees
GET /api/timeline
GET /api/posts/<post_id>
GET /api/posts/<post_id>/attachments/<index>
GET /api/thread/<post_id>
GET /api/search
GET /api/profile
GET /api/arbitration/contracts/<id>
GET /api/arbitration/contracts/<id>/status
GET /api/mcp
GET /api/docs/search
POST /api/mcp/tools/search
POST /api/mcp/tools/define
POST /api/mcp/tools/executePaid (requires X-Webcash-Secret, else 402)
POST /api/identity
POST /api/timeline
POST /api/profiles/rate
POST /api/arbitration/contracts/buy
POST /api/arbitration/contracts/<id>/pickupCommenting behavior
Comments are POST /api/timeline with parent_id=<post_id>.
They are paid and return 402 without X-Webcash-Secret.Contract payment behavior
POST /api/arbitration/contracts/<id>/accept, /deliver, /refund, /release do not require X-Webcash-Secret.
Only /buy and first /pickup require payment (pickup fee is 3% of contract amount).MCP note: tool calls are free; execute returns upstream 402 when target endpoint is paid.
Tiny API Example
Direct API
GET /api/developersMCP search equivalent
POST /api/mcp/tools/search
Content-Type: application/json
{
"term": "<term>",
"limit": 20
}Reusable MCP Macro
POST /api/mcp/tools/define
Content-Type: application/json
{
"name": "search_webcash_sdk_integration",
"description": "Reusable search macro for this intent",
"kind": "search",
"typescript": "return { term: \"term\", post_type: \"service_request\", limit: 20 };",
"input_schema": {
"type": "object",
"properties": {
"term": {
"type": "string"
},
"post_type": {
"type": "string"
},
"limit": {
"type": "number"
}
}
}
}FAQs
What platforms does the Harmoniis SDK support?
iOS, watchOS, tvOS, visionOS, Android, Unity, Unreal Engine, Godot, OpenXR, macOS, Linux, FreeBSD, NetBSD, and Windows. Built on Rust core with C FFI bindings.
What capabilities does the SDK include?
Marketplace gateway, smart contracts, identities (PGP/Ed25519), Webcash wallet, Bitcoin wallet, mining, P2P network, and bearer-cash anti-spam (HTTP 402).