Welcome¶
Wasichain is a blockchain for contracts and services, built on Commonware consensus primitives and industry-standard Wasmtime. It combines deterministic on-chain state transitions with first-class network-connected workflows on the same chain.
If your language toolchain can produce compatible wasm32-wasip2 components, it can target Wasichain for both contracts and services.
Key characteristics¶
- Plain WASI components -- contracts and services are ordinary
wasm32-wasip2components rather than programs written for a custom chain-specific VM language. - Language-agnostic component model -- Rust is one good option, not a requirement.
- Wasmtime, not a custom runtime -- execution happens in Wasmtime with a restricted host surface.
- Deterministic contracts, first-class services -- contracts stay deterministic while services handle network-connected workflows on the same chain.
- Code-hash-based admission -- validators agree on the raw Wasm hash and VM version before code is activated.
- Threshold-simplex consensus -- powered by Commonware's simplex protocol with BLS threshold signatures.
- WASI standard KV storage -- a simple key-value store with a standard WASI interface.
- Transactional overlays -- state changes are isolated per sub-message and committed atomically.
Where to start¶
| Goal | Page |
|---|---|
| Install the CLI and local toolchain | Installation |
| Deploy your first contract | Getting Started |
| Understand the system design | Architecture |
| Understand sandboxing and attack resistance | Security |
| Understand pricing, metering, and validator rewards | Fees & Fuel |
| Build deterministic contract logic | Contract Development |
| Design validator-run oracle and automation flows | Services |
| Run a node | Node Operation |
| Integrate programmatically | SDK & Client Integration |
| HTTP endpoint reference | API Reference |