Concepts

This SDK enables private token balances on EVM chains. Balances are encrypted on-chain using ElGamal encryption, and transfers are verified by zero-knowledge proofs -- the chain confirms validity without seeing amounts. All decryption and proving happens client-side.

These pages explain the architecture behind the SDK. You don't need to read them to use it, but they help when you want to understand what's happening under the hood.

architectureArchitecture

How Runtime, Account, Client, and Chain fit together.

keyKeys & Addresses

The dual-key model (ESK + CSK) and ZK addresses.

extensionActions & Extensions

viem's `.extend()` pattern and how the SDK uses it.

syncTransaction Lifecycle

The prepare/sign/send flow and progress callbacks.