# ZCashNames (ZNS)

> Decentralized Domain Name Service for the ZCash Cryptocurrency Ecosystem (.zcash and .zec TLDs).

ZCashNames (ZNS) allows ZCash users to map human-readable domain names (such as `alice.zcash` or `bob.zec`) to Ironwood ZCash Unified Addresses, enabling simple, private, and cryptographic name resolution across ZCash wallets and decentralized applications.

## Key Features

- **Human-Readable ZCash Handles**: Replace long ZCash Unified Addresses with short `.zcash` and `.zec` domain names.
- **Ironwood Integration**: Validates and binds domain names to ZCash Unified Addresses containing an Ironwood receiver (`typecode = 4`, `u1...`).
- **ZK-Prover State Roots**: Built with zero-knowledge proof verification (SP1 zkVM guest prover) to batch-validate domain ownership and state root transitions on ZCash.
- **Decentralized Marketplace**: Buy, sell, transfer, and update domain names with native ZEC payments (denominated in zatoshis).
- **Client-Side Privacy**: Cryptographic keys and seed phrases are stored encrypted locally in browser storage using Ed25519 signatures.

## Supported Top-Level Domains (TLDs)

- `.zcash` (Primary ZCash Name Service TLD)
- `.zec` (Compact ZEC currency TLD)
- `.private`
- `.secure`
- `.safe`

## Address Validation & Cryptography

- **Supported Address Type**: ZCash Mainnet Unified Addresses (`u1...`).
- **Receiver Requirements**: Addresses must contain an Ironwood (`typecode = 4`) receiver, verified via 4-round F4Jumble Feistel unjumbling and BLAKE2b cryptographic decoding.
- **Length Constraint**: Valid Unified Addresses up to 232 characters.

## Technical Specifications

- **Frontend Architecture**: Modern Vanilla JS SPA with responsive glassmorphism design, multi-language i18n support (13 languages), base64url ZIP 321 memo encoding, and responsive QR code generation.
- **Base Currency Unit**: Zatoshis ($1 \text{ ZEC} = 10^8 \text{ zatoshis}$).

## Official Links & Resources

- **Website**: https://zcashnames.co/
- **GitHub Repository**: https://github.com/ZCashNames
- **Documentation / Rules**: https://zcashnames.co/