zama-testnet

Zama Testnet App — Rich-styled CLI for Zama fully homomorphic encryption (FHE) testnet with confidential smart contract deployment, testnet ETH faucet claims, airdrop participation, Sepolia network integration, TFHE operations, and terminal interface for privacy-preserving blockchain development

  _            _              _    
 | |          | |            | |   
 | |_ ___  ___| |_ _ __   ___| |_  
 | __/ _ \/ __| __| '_ \ / _ \ __| 
 | ||  __/\__ \ |_| | | |  __/ |_  
  \__\___||___/\__|_| |_|\___|\__| 

Zama Testnet App

Rich-styled CLI for Zama FHE testnet — deploy confidential contracts, claim testnet ETH, and participate in the airdrop.

Features • Getting Started • Configuration • Usage • Project Structure • FAQ

---

Official Links

Resource	URL
Zama	https://www.zama.ai
fhEVM	https://www.zama.ai/products-and-services/fhevm
Zama Docs	https://docs.zama.ai
fhEVM Docs	https://docs.zama.ai/fhevm
TFHE-rs	https://docs.zama.ai/tfhe-rs
Zama Protocol	https://docs.zama.org/protocol
Relayer Testnet	https://relayer.testnet.zama.org
GitHub (Zama)	https://github.com/zama-ai
fhEVM Repo	https://github.com/zama-ai/fhevm
Discord	https://discord.gg/zama
Community Forum	https://community.zama.ai

---

Features

Feature Status Install Dependencies ✓ Settings (RPC, Private Key) ✓ About Zama & FHE Info ✓ Node Updates ✓ Testnet Updates ✓

Feature Status Technical Airdrop Strategies ✓ Deploy Contract (clone + script) ✓ Sepolia Faucet (Claim ETH) ✓ Submit Contract Address ✓ Rich Terminal UI ✓

---

Getting Started

Prerequisites

• Python 3.8 or higher
• Git (for cloning deployment repo)
• Bash (for deploy script; Git Bash on Windows)

Install

# Clone or navigate to project
cd zama-testnet-app

# Install dependencies
pip install -r requirements.txt

# Run the application
python main.py

Windows: Double-click run.bat to launch.

Dependencies

Package	Version	Purpose
rich	≥13.0.0	Terminal formatting, panels, tables, prompts

---

Configuration

Settings are stored in config.json (created on first run). Never commit config.json — it may contain your private key.

Example config.json:

{
  "rpc_url": "https://ethereum-sepolia-rpc.publicnode.com",
  "private_key": "",
  "contract_address": ""
}

Example with private key (use with caution):

{
  "rpc_url": "https://ethereum-sepolia-rpc.publicnode.com",
  "private_key": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
  "contract_address": "0x..."
}

---

Usage

Interactive menu-driven CLI:

┌─────────────────────────────────────────────────────────┐
│                         Menu                             │
├────┬────────────────────────────────────────────────────┤
│ [1]│ Install Dependencies                                │
│ [2]│ Settings                                            │
│ [3]│ About Zama                                          │
│ [4]│ Node Updates                                        │
│ [5]│ Testnet Updates                                     │
│ [6]│ Technical Airdrop Strategies                        │
│ [7]│ Deploy Contract                                     │
│ [8]│ Sepolia Faucet (Claim ETH)                          │
│ [9]│ Submit Contract Address                             │
│ [0]│ Exit                                                │
└────┴────────────────────────────────────────────────────┘

Select option [1]: 

Typical workflow: 1 → 2 (set RPC) → 8 (claim ETH) → 7 (deploy) → 9 (submit address).

---

Project Structure

zama-testnet-app/
├── main.py              # Main application entry point
├── run.bat              # Windows launcher
├── requirements.txt     # Python dependencies
├── config.json         # User config (gitignored)
├── .gitignore
├── README.md
├── tags.txt             # GitHub topics
└── about/
    └── hashtags.txt     # Community hashtags

---

FAQ

What is Zama?

Zama is an open-source cryptography company specializing in Fully Homomorphic Encryption (FHE) for blockchain and AI. Their fhEVM enables confidential smart contracts on EVM chains — computations run on encrypted data without decryption.

What is fhEVM?

fhEVM is Zama's framework for confidential smart contracts on Ethereum and EVM-compatible chains. It uses FHE so transactions and state stay encrypted on-chain while remaining composable and programmable in Solidity.

Why Sepolia?

Zama Protocol testnet runs on Ethereum Sepolia. You need Sepolia ETH to deploy contracts — use the built-in Sepolia Faucet option or external faucets like sepoliafaucet.com.

How do I deploy a contract?

Use menu option 7. The app clones the zama-testnet repo and runs deploy-zama-contract.sh. You'll be prompted for your private key and RPC URL. Ensure you have Sepolia ETH first (option 8).

Is my private key safe?

The private key is stored locally in config.json and never sent to this app's servers. Still, storing keys in plaintext is risky — use only for testnet wallets with no real funds.

Where do I submit my contract address?

Use menu option 9. It opens the official Google Form and saves your address to config. Paste the deployed contract address into the form to participate in the airdrop.

Git/Bash not found on Windows?

Install Git for Windows — it includes Git Bash. The deploy script requires Bash. Alternatively, clone and run the script manually from a terminal.

---

Disclaimer

This project is for educational and testnet use only. It is not affiliated with Zama.ai. Use at your own risk. Never use mainnet wallets or real funds. Testnet tokens have no monetary value.

---

Support this project

0x7F3a8E4c1D6f9A5e0B3d7C8a2F4e6D1b9C5a0312

---

If this helped you, consider giving a ⭐