Nad Wallet

🔐 Nad Wallet - Monad Chain Identity for AI Agents

> Every autonomous agent needs a wallet on Monad. Create one without human help.

TL;DR: Programmatic wallet creation on Monad blockchain. SIWE auth for NadMail, MON balance checks, ecosystem integration.

Why Nad Wallet?

Create and manage Monad chain wallets programmatically for the Nad ecosystem.

⚠️ Security First

| ✅ DO | ❌ DON'T | |-------|----------| | Use NAD_PRIVATE_KEY environment variable | Store private keys in plain text files | | Set wallet files to chmod 600 | Commit wallet files to git | | Use --env mode (recommended) | Use console.log(privateKey) | | Back up mnemonics offline | Share private keys or mnemonics | | Store files in ~/.nad-wallet/ only | Auto-detect wallets outside ~/.nad-wallet/ |

🔒 Security Standards: Identical to Base Wallet security practices but adapted for Monad/Nad ecosystem.

Network Information

| Property | Value | |----------|-------| | Blockchain | Monad | | Chain ID | 143 | | RPC URL | https://rpc.monad.xyz | | Explorer | https://explorer.monad.xyz | | Native Token | MON | | Ecosystem | nad.fun, NadMail, NadName |

Quick Start

Create a New Wallet (Recommended)

# Output as environment variable format (safest)
node scripts/create-wallet.js --env
Output example:
export NAD_WALLET_ADDRESS="0x..."
export NAD_PRIVATE_KEY="0x..."

Then copy to your shell or .env file.

Create with File Storage (Opt-in)

# Only if you need file-based storage
node scripts/create-wallet.js --managed my-agent

⚠️ This stores private key in ~/.nad-wallet/wallets/my-agent.json

Usage Examples

Load Wallet from Environment

const { ethers } = require('ethers');
// ✅ SECURE: Load from environment variable
const wallet = new ethers.Wallet(process.env.NAD_PRIVATE_KEY);
console.log('Address:', wallet.address);
// ❌ NEVER: console.log('Private Key:', wallet.privateKey);

Connect to Monad

const provider = new ethers.JsonRpcProvider('https://rpc.monad.xyz');
const connectedWallet = wallet.connect(provider);
// Check balance
const balance = await provider.getBalance(wallet.address);
console.log('Balance:', ethers.formatEther(balance), 'MON');

Sign Message (SIWE for NadMail)

const message = nadmail.ai wants you to sign in with your Ethereum account:
${wallet.address}
Sign in to NadMail
URI: https://nadmail.ai
Version: 1
Chain ID: 143
Nonce: ${nonce}
Issued At: ${new Date().toISOString()};
const signature = await wallet.signMessage(message);

Send Transaction

const provider = new ethers.JsonRpcProvider('https://rpc.monad.xyz');
const connectedWallet = wallet.connect(provider);
const tx = await connectedWallet.sendTransaction({
  to: recipientAddress,
  value: ethers.parseEther('0.1') // 0.1 MON
});
const receipt = await tx.wait();
console.log('TX Hash:', tx.hash);
console.log('Explorer:', https://explorer.monad.xyz/tx/${tx.hash});

Scripts

| Script | Description | |--------|-------------| | create-wallet.js --env | Create wallet, output as env vars (recommended) | | create-wallet.js --managed [name] | Create wallet, save to file (opt-in) | | create-wallet.js --json | Create wallet, output as JSON | | nadmail-register.js --handle [name] | Register for NadMail with SIWE | | check-balance.js [address] | Check MON wallet balance |

NadMail Integration

Register for NadMail (Web3 email for Nad ecosystem) using your wallet signature.

Environment Variable Method (Recommended)

# Set your private key
export NAD_PRIVATE_KEY="0x..."
Register with your desired handle
node scripts/nadmail-register.js --handle littlelobster

Managed Wallet Method

# First create a managed wallet
node scripts/create-wallet.js --managed my-agent
Then register for NadMail
node scripts/nadmail-register.js --wallet my-agent --handle littlelobster

What Happens During Registration

1. Start Auth - Request authentication message from NadMail API 2. Sign Message - Use your private key to sign the SIWE message 3. Agent Register - Submit signature and handle to complete registration 4. Save Token - Store access token in ~/.nad-wallet/nadmail-token.json

Check Balance

# Using environment variable
NAD_PRIVATE_KEY="0x..." node scripts/check-balance.js
Using managed wallet
node scripts/check-balance.js my-wallet
Using specific address
node scripts/check-balance.js 0x1234...5678

Example output:

💰 Nad Wallet Balance Check
==================================================
Address: 0x1234...5678
Network: Monad (Chain ID 143)
RPC: https://rpc.monad.xyz
💎 Balance: 42.5 MON
Wei: 42500000000000000000
🔗 Explorer: https://explorer.monad.xyz/address/0x1234...5678
🌐 Nad Ecosystem:
  • nad.fun - Meme token platform
  • NadMail (nadmail.ai) - Web3 email  
  • NadName (app.nad.domains) - Domain names

File Structure

~/.nad-wallet/
├── wallets/              # Managed wallet storage
│   ├── my-agent.json     # Wallet file (600 perms)
│   └── my-agent.mnemonic # Backup phrase (400 perms)
├── nadmail-token.json    # NadMail API token (600 perms)
└── audit.log            # Operation audit log (600 perms)

Nad Ecosystem Services

🎭 nad.fun

📧 NadMail (nadmail.ai)

🌐 NadName (app.nad.domains)

📝 Audit Logging

All operations are logged to ~/.nad-wallet/audit.log with:

Security Best Practices

Environment Variables

# ✅ Recommended approach
export NAD_PRIVATE_KEY="0x..."
export NAD_WALLET_ADDRESS="0x..."
Use in scripts
node scripts/check-balance.js
node scripts/nadmail-register.js --handle myname

File Storage (Use with caution)

const fs = require('fs');
const path = require('path');
// Store with restricted permissions (only if absolutely necessary)
const filepath = path.join(process.env.HOME, '.nad-wallet', 'wallets', 'wallet.json');
fs.writeFileSync(filepath, JSON.stringify({ 
  address: wallet.address,
  privateKey: wallet.privateKey // Only store if absolutely necessary
}), { mode: 0o600 }); // Owner read/write only

.gitignore

Add to your project's .gitignore:

# Nad Wallet files - NEVER commit!
.nad-wallet/
*.wallet.json
*.mnemonic
private-key*
nad-private-key*
Environment files
.env
.env.local

Differences from Base Wallet

| Aspect | Base Wallet | Nad Wallet | |--------|-------------|------------| | Blockchain | Base (8453) | Monad (143) | | RPC | https://mainnet.base.org | https://rpc.monad.xyz | | Explorer | basescan.org | explorer.monad.xyz | | Native Token | ETH | MON | | Email Service | BaseMail | NadMail | | Config Directory | ~/.base-wallet/ | ~/.nad-wallet/ | | Wallet Directory | ~/.openclaw/wallets/ | ~/.nad-wallet/wallets/ | | Environment Variable | PRIVATE_KEY | NAD_PRIVATE_KEY | | Ecosystem | Base ecosystem | nad.fun, NadMail, NadName |

Migration from Base Wallet

If you have Base Wallet experience:

1. Same security model - All security practices are identical 2. Different network - Chain ID 143 instead of 8453 3. Different token - MON instead of ETH 4. Different services - NadMail instead of BaseMail 5. Different directories - ~/.nad-wallet/ instead of ~/.base-wallet/

Installation & Setup

# Navigate to skill directory
cd /path/to/nad-wallet
Install dependencies
npm install
Create your first wallet
node scripts/create-wallet.js --env
Check balance
NAD_PRIVATE_KEY="0x..." node scripts/check-balance.js
Register for NadMail
NAD_PRIVATE_KEY="0x..." node scripts/nadmail-register.js --handle myname

Dependencies

{
  "ethers": "^6.0.0"
}

No additional dependencies required. Pure Node.js + ethers.js.

Troubleshooting

Common Issues

1. "Wallet not found" - Solution: Set NAD_PRIVATE_KEY environment variable or create managed wallet

2. "Registration failed" - Check internet connection - Verify handle is available - Ensure wallet has MON for gas fees

3. "Permission denied" - Check file permissions: chmod 600 ~/.nad-wallet/wallets/*.json - Verify directory permissions: chmod 700 ~/.nad-wallet/

Environment Variable Not Set

# Check if set
echo $NAD_PRIVATE_KEY
Set temporarily
export NAD_PRIVATE_KEY="0x..."
Set permanently (add to ~/.bashrc or ~/.zshrc)
echo 'export NAD_PRIVATE_KEY="0x..."' >> ~/.bashrc

Changelog

v1.0.0 (2026-02-09)

License

MIT License - Build awesome things with Nad Wallet! 🚀

Create a New Wallet (Recommended)

# Output as environment variable format (safest)
node scripts/create-wallet.js --env
Output example:
export NAD_WALLET_ADDRESS="0x..."
export NAD_PRIVATE_KEY="0x..."

Then copy to your shell or .env file.

Create with File Storage (Opt-in)

# Only if you need file-based storage
node scripts/create-wallet.js --managed my-agent

⚠️ This stores private key in ~/.nad-wallet/wallets/my-agent.json

Common Issues

1. "Wallet not found" - Solution: Set NAD_PRIVATE_KEY environment variable or create managed wallet

2. "Registration failed" - Check internet connection - Verify handle is available - Ensure wallet has MON for gas fees

3. "Permission denied" - Check file permissions: chmod 600 ~/.nad-wallet/wallets/*.json - Verify directory permissions: chmod 700 ~/.nad-wallet/

Environment Variable Not Set

# Check if set
echo $NAD_PRIVATE_KEY
Set temporarily
export NAD_PRIVATE_KEY="0x..."
Set permanently (add to ~/.bashrc or ~/.zshrc)
echo 'export NAD_PRIVATE_KEY="0x..."' >> ~/.bashrc