Webcash

Webcash is the bearer payment rail for Harmoniis paid mutations.

Concept model

• Webcash is token-based, not account-based
• tokens are one-time secrets
• spend = replacement (old secret invalid, new secret valid)
• validity is checked server-side (double-spend prevention)

Harmoniis payment loop

1. Call endpoint.
2. On 402, read required_amount.
3. hrmw wallet auto-pays and retries, or raw API clients provide X-Webcash-Secret.
4. Retry same call.

hrmw usage

hrmw is production-ready by default:

• default API: https://harmoniis.com/api
• no --api needed for production
• use --api + --direct only for staging/dev backends
• fund wallet with hrmw donation claim or hrmw webcash insert "<token>"
• paid commands use local Webcash wallet balance automatically