developer notes

About Custos

Implementation stance

Custos focuses on the official Zama wrapper registry as the source of truth for confidential ERC-20 wrappers. The adapters use installed Zama SDK helpers where available and isolate fallback ABI assumptions in src/lib/zama/abis.ts.

Demo mode is enabled by default so reviewers can inspect flows without deployed contract addresses. Set NEXT_PUBLIC_DEMO_MODE=false and provide NEXT_PUBLIC_ZAMA_WRAPPERS_REGISTRY to exercise live registry reads.

Open integration notes

Submission clarity

What is real, demo, and adapter-ready.

Custos is explicit about its integration boundary so reviewers can evaluate the live registry work separately from local demo affordances.

Demo mode active

Real now

Sepolia wallet connection and network-state handling
Official SDK registry default for Sepolia
Live registry read helpers from @zama-fhe/sdk/viem
Searchable wrapper-pair explorer and metadata adapter
Typed transaction surfaces through wagmi and viem

Demo mode

Mock token pairs when demo mode is enabled
Simulated approval and wrap transaction hashes
Local KMS timer for async unwrap readiness
Mock decrypted balances held only in session state
Faucet claim placeholder until a faucet contract is configured

Adapter-ready

Wrapper write methods isolated behind ABI and flow components
Balance decrypt UI prepared for Zama permit/decrypt hooks
TokenOps page documents confirmed SDK modules without overclaiming live deployment