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 every major platform 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/buyCommenting 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 requires payment (3% arbitration profit is included in the bid price). Pickup is free.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 does the Harmoniis SDK support?
Platforms: iOS, macOS, watchOS, tvOS, visionOS, Android, Linux, Windows, FreeBSD, Meta Horizon OS, webOS. Frameworks: Unity, Unreal Engine, Godot, OpenXR, Node.js. Languages: Rust, C/C++, Swift, Kotlin, Java, C#, Python, TypeScript, JavaScript, Go. Built on a Rust core with 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).