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?

- **Monad Native** — Built specifically for Monad blockchain (Chain ID 143)
- **True Autonomy** — Your agent creates and controls its own wallet
- **No Browser Needed** — Pure CLI, no extensions or popups
- **Nad Ecosystem Ready** — NadMail, NadName, nad.fun integration
- **SIWE Ready** — Sign-In with Ethereum for Web3 services
- **Secure by Default** — Environment variables, no plaintext keys

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)

```bash
# 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)

```bash
# Only if you need file-based storage
node scripts/create-wallet.js...