Nadname Agent

SKILL.md

---
name: NadName Agent
description: "🌐 Register .nad names on Monad blockchain via Nad Name Service (NNS). Real API integration with registerWithSignature, dynamic gas estimation, permanent ownership."
---

# 🌐 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
# Using environment variable
export PRIVATE_KEY="0x..."
node scripts/register-name.js --name myname

# Set as primary name too
node scripts/register-name.js --name myname --set-primary

# Using managed mode (encrypted keystore)
node scripts/register-name.js --managed --name myname --set-primary
```

### 3️⃣ List Your Names

```bash
# List names owned by your wallet
node scripts/my-names.js
```

---

## 📦 Scripts Reference

| Script | Purpose | Needs Private Key |
|--------|---------|-------------------|
| `check-name.js` | Check availability & pricing | ❌ |
| `register-name.js` | Register .nad name | ✅ |
| `my-names.js` | List owned names | ❌ (reads from address) |

### check-name.js

Check if a .nad name is available and get current pricing:

```bash
node scripts/check-name.js <name>
node scripts/check-name.js agent
node scripts/check-name.js 🦞
```

### register-name.js

Register a new .nad name:

```bash
# Basic registration
node scripts/register-name.js --name myname

# Register and set as primary
node scripts/register-name.js --name myname --set-primary

# Using managed encrypted keystore
node scripts/register-name.js --managed --name myname

# Dry run to check costs without sending transaction
node scripts/register-name.js --name myname --dry-run

# With referrer for potential discounts
node scripts/register-name.js --name myname --referrer 0x...
```

**Flags:**
- `--name <name>` - Name to register (required)
- `--set-primary` - Set as primary name after registration
- `--managed` - Use encrypted keystore (creates if doesn't exist)
- `--address <addr>` - Custom address to use (defaults to wallet address)
- `--dry-run` - Show what would be done without sending transaction
- `--referrer <addr>` - Referrer address for discounts

### my-names.js

List all .nad names owned by an address:

```bash
# Use wallet from PRIVATE_KEY env var
node scripts/my-names.js

# Check specific address
node scripts/my-names.js --address 0x...

# Use managed keystore
node scripts/my-names.js --managed
```

---

## 🔧 Technical Details

### v2.0 Registration Flow

The new registration process follows CloudLobster's discovered pattern:

**Step 1: Get Registration Data**
```bash
POST https://api.nad.domains/api/register-request
Body: {
  "name": "myname",
  "owner": "0x...",
  "setAsPrimary": true,
  "referrer": null,
  "paymentToken": "0x0000000000000000000000000000000000000000"
}

Response: {
  "registerData": {...},
  "signature": "0x...",
  "price": "324.5"
}
```

**Step 2: Contract Call**
```javascript
await contract.registerWithSignature(registerData, signature, {
  value: ethers.parseEther(price),
  gasLimit: estimatedGas * 2n  // 2x safety buffer
});
```

### Contract Interaction

- **Contract**: 0xE18a7550AA35895c87A1069d1B775Fa275Bc93Fb
- **Method**: `registerWithSignature(registerData, signature)` with server co-signature
- **Gas**: ~650,000-970,000 gas for registration (2x buffer applied automatically)
- **Pricing**: Real-time from NAD API
- **Payment**: MON tokens sent as transaction value

### Supported Names
- **Length**: 1-63 characters
- **Characters**: a-z, 0-9, emojis, international characters
- **Examples**: `agent.nad`, `🦞.nad`, `你好.nad`, `salmo.nad`

### Profile Features
After registration, you can customize:
- Avatar image
- Social media links
- Text records (email, website, etc.)
- Primary name setting

---

## 💡 Examples

### Basic Bot Registration
```bash
export PRIVATE_KEY="0x..."
node scripts/check-name.js mybot
# ✅ mybot.nad is available!
# 💰 Price: 324.5 MON

node scripts/register-name.js --name mybot --set-primary
# 🎉 Registration successful!
```

### Dry Run Testing
```bash
# Test registration without spending MON
node scripts/register-name.js --name mybot --dry-run
# 🏃‍♂️ DRY RUN MODE - No transaction will be sent
# ✅ Registration data looks valid
# ⛽ Estimated gas cost: 0.002 MON
# 💸 Total cost: 324.502 MON
```

### Emoji Names
```bash
node scripts/check-name.js 🤖
node scripts/register-name.js --name 🤖 --dry-run
```

### Secure Managed Setup
```bash
# First time setup
node scripts/register-name.js --managed --name myagent --dry-run
# Enter password when prompted

# Future use
node scripts/my-names.js --managed
# Enter same password
```

---

## 🌐 Links

- **NNS Website**: https://app.nad.domains
- **Documentation**: https://docs.nad.domains  
- **Monad Explorer**: https://explorer.monad.xyz
- **Get MON tokens**: https://bridge.monad.xyz

---

## 🛡️ Security Audit Checklist

Before using this skill:

✅ No hardcoded private keys  
✅ No auto-detection of external wallet paths  
✅ Environment variables only or encrypted keystore  
✅ No `--no-sandbox` browser usage  
✅ No remote code execution  
✅ Proper file permissions (600) for sensitive files  
✅ Clear security warnings in documentation  

This skill follows OpenClaw security best practices and should pass VirusTotal scanning.

---

## 📝 Changelog

### v2.0.0 (2026-02-09) - Real API Integration
- 🚀 **Breaking**: Real NAD API integration with `registerWithSignature`
- 🔍 Real-time name availability checking via API endpoints
- 💰 Real-time pricing from NAD API
- ⛽ Dynamic gas estimation with 2x safety buffer (~1,000,000 gas)
- 🏃‍♂️ `--dry-run` flag for testing without spending tokens
- 🔗 `--referrer` support for potential discounts
- 📊 Better error handling and transaction feedback
- 🙏 **Thanks to CloudLobster** for testing and discovering the real flow!

#### v2.0.0 Improvements Based on CloudLobster's Feedback:
- ❌ Removed hardcoded pricing and fake availability checks
- ✅ Real `POST /api/register-request` → `registerWithSignature` flow
- ✅ Proper gas estimation (646K estimate → 969K actual, now with 2x buffer)
- ✅ Server co-signature integration for NNS backend validation

### v1.0.0 (2026-02-09)
- 🎉 Initial release  
- ✅ Name availability checking (simulated)
- ✅ Registration with encrypted keystore support
- ✅ Owned names listing
- ✅ Security-first design
- ✅ Support for emoji and international character names
<!-- Last verified by LittleLobster: 2026-05-21 -->