NadName Agent

# 🌐 NadName Agent v2.0 - .nad Names on Monad

> Register permanent .nad names on Monad blockchain via Nad Name Service with real API integration

**TL;DR:** Get `yourname.nad` on Monad. One-time fee, lifetime ownership. Now with real NAD API integration and accurate pricing!

## What is NNS?

**Nad Name Service (NNS)** is a web3 name service built on Monad blockchain that maps human-readable names like `agent.nad` to cryptocurrency addresses and metadata.

- **Permanent ownership** — One-time registration fee, no renewals
- **NFT-based** — Names are tradeable NFTs
- **Emoji support** — Use 🦞.nad or 你好.nad
- **Fast & cheap** — Built on Monad, the fastest blockchain
- **Profile customization** — Set avatar, social links, text records

### Key Details
- **Blockchain**: Monad (Chain ID: 143)
- **RPC**: https://rpc.monad.xyz
- **Contract**: 0xE18a7550AA35895c87A1069d1B775Fa275Bc93Fb
- **Website**: https://app.nad.domains
- **Docs**: https://docs.nad.domains

---

## 🔐 Security & Wallet Setup

### Option 1: Environment Variable (Recommended ✅)

```bash
export PRIVATE_KEY="0x..."
node scripts/check-name.js myname
```

> ✅ **Safest**: Private key exists only in memory, never saved to disk.

### Option 2: Managed Mode (Encrypted)

```bash
node scripts/register-name.js --managed --name myname
```

> ✅ **Secure**: Creates encrypted keystore, password-protected.

### ⚠️ Critical Security Rules

1. **NEVER** hardcode private keys in scripts
2. **NEVER** commit private keys to git
3. **NEVER** auto-detect wallet paths (security risk)
4. **ONLY** use PRIVATE_KEY env var or --managed encrypted keystore
5. Private key files should be chmod `600`

---

## 🚀 Quick Start

### 1️⃣ Check Name Availability

```bash
# Check if name is available and get pricing
node scripts/check-name.js myname

# Output example:
# ✅ myname.nad is available!
# 💰 Price: 649 MON (base price)
# 🎄 Discount: 50% (Christmas special)
# 💸 Final price: 324.5 MON
```

### 2️⃣ Register Name

```bash
# Usi...

# 🌐 NadName Agent

Register .nad names on Monad blockchain via Nad Name Service (NNS).

## Quick Start

```bash
# Install dependencies
npm install

# Check name availability
node scripts/check-name.js myname

# Register name (set PRIVATE_KEY first)
export PRIVATE_KEY="0x..."
node scripts/register-name.js --name myname

# List owned names
node scripts/my-names.js
```

## Security Features

✅ No hardcoded private keys  
✅ Environment variable or encrypted keystore only  
✅ No auto-detection of external wallet paths  
✅ Proper file permissions (600) for sensitive data  
✅ AES-256-GCM encryption for managed keystores  

## Documentation

See [SKILL.md](SKILL.md) for complete documentation and usage examples.

## Important Notes

- **Permanent ownership**: .nad names never expire
- **One-time fee**: No renewal costs
- **NFT-based**: Names are tradeable NFTs
- **Emoji support**: Use 🦞.nad or 你好.nad
- **Monad blockchain**: Fast and cheap transactions