Guides

Learn how to use the webcash protocol and webycash tools.

How to use the webyc CLI

Install

cargo install webylib

Setup

Initialize a new webcash wallet. Your secrets are stored locally.

webyc setup

Network selection

Use --network to switch between testnet and production.

webyc --network testnet webyc --network production

Mine (testnet)

webyc --network testnet mine

Insert webcash

webyc insert <webcash_secret>

Pay

webyc pay <amount>

Check balance

webyc check

Wallet info

webyc info

Mining guide

For testnet mining, use the webyc CLI. Testnet difficulty is low (16 bits) so CPU mining completes in seconds.

webyc --network testnet mine

Production mining: harmoniis-wallet

Production difficulty needs a GPU-class miner. harmoniis-wallet (hrmw) implements webcash mining with CUDA (NVIDIA), Vulkan/wgpu (AMD, Intel, and Apple Silicon via Metal), then CPU fallback. Installers and docs: harmoniis.com/wallet.

Install via the scripts on harmoniis.com/wallet, Windows PowerShell installer, or cargo install harmoniis-wallet from the repository. After hrmw setup, benchmark and run the miner:

hrmw webminer bench hrmw webminer start -f --accept-terms hrmw webminer start -f --backend gpu --accept-terms
  • Apple Silicon: no CUDA; use --backend auto or gpu so wgpu uses the built-in GPU (Metal). Run hrmw webminer bench to confirm which backend is active.
  • NVIDIA desktop/server: CUDA is preferred when drivers are installed; same commands, backend order is CUDA → Vulkan → CPU.
  • Cloud GPUs: harmoniis-wallet supports rented instances (e.g. Vast.ai) with hrmw webminer cloud start after API key setup—see the repository README for cloud workflow, status, stop, and recovery.

Developing with webycash-sdk

The webycash-sdk provides native webcash protocol integration for every major platform. One Rust core, platform bindings on top. Available for Rust, TypeScript, Python, Swift, Kotlin, Go, C++, C#, and Java.

SDK Documentation API Reference

Understanding Webcash

Webcash is e-cash made to pay, not to store value. The protocol uses a central server to prevent double-spending. Webcash secrets are bearer instruments: whoever holds the secret can spend it. There is no account, no identity requirement, and no fees.

Gresham's law states that bad money drives out good money. The purpose of webcash is to be the best and most simple e-cash for HTTP 402 payments. Unlike shitcoins that are designed for crypto gambling and speculation, webcash is designed for actual payment. Agent-to-agent settlement, P2P transfers, and anti-spam gates.

Webcash does not pretend to store value. It works like a voucher system that can be split and fractioned. You receive webcash, you replace it to transfer ownership, and the server ensures each webcash is spent exactly once. That is the entire protocol.