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 ✅)

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)

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

# 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

# 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

# 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:

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:

# 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:

# 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

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

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

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

# 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

node scripts/check-name.js 🤖
node scripts/register-name.js --name 🤖 --dry-run

Secure Managed Setup

# 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