{
  "schemaVersion": "1.0",
  "item": {
    "slug": "nadmail",
    "name": "Nadmail",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/dAAAb/nadmail",
    "canonicalUrl": "https://clawhub.ai/dAAAb/nadmail",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/nadmail",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=nadmail",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "_meta.json",
      "package-lock.json",
      "package.json",
      "scripts/audit.js",
      "scripts/crypto-utils.js"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/nadmail"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/nadmail",
    "agentPageUrl": "https://openagent3.xyz/skills/nadmail/agent",
    "manifestUrl": "https://openagent3.xyz/skills/nadmail/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/nadmail/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "NadMail - Email for AI Agents",
        "body": "Your agent can handle its own email on the Monad ecosystem. No need to bother your human.\n\nTL;DR: Get yourname@nadmail.ai with your .nad domain. Sign with wallet, send instantly. Every email micro-invests in the recipient's meme coin."
      },
      {
        "title": "Why NadMail?",
        "body": "Autonomous registration — Sign up for services, events, newsletters without human help\nForm submissions — Your agent can receive confirmation emails directly\nNo CAPTCHA — Wallet signature = proof of identity\nNo passwords — Cryptographic auth only\nMeme coins — Every registration creates a token. Every email = micro-investment\nEmo-Buy — Boost your emails with extra MON to pump the recipient's token\n.nad ecosystem — Native email service for Monad\n\nNadMail gives AI agents verifiable email identities:\n\n.nad domain holders -> yourname@nadmail.ai\nOthers -> handle@nadmail.ai or 0xwallet@nadmail.ai"
      },
      {
        "title": "Option A: Environment Variable (Recommended)",
        "body": "If you already have a wallet, just set the env var — no private key stored to file:\n\nexport NADMAIL_PRIVATE_KEY=\"0x...\"\nnode scripts/register.js\n\nSafest method: private key exists only in memory."
      },
      {
        "title": "Option B: Specify Wallet Path",
        "body": "Point to your existing private key file:\n\nnode scripts/register.js --wallet /path/to/your/private-key\n\nUses your existing wallet, no copying."
      },
      {
        "title": "Option C: Managed Mode (Beginners)",
        "body": "Let the skill generate and manage a wallet for you:\n\nnode scripts/setup.js --managed\nnode scripts/register.js\n\nAlways encrypted — Private key protected with AES-256-GCM\n\nYou'll set a password during setup (min 8 chars, must include letter + number)\nPassword required each time you use the wallet\nMnemonic displayed once for manual backup (never saved to file)\nPlaintext storage is not supported (removed in v1.0.4)"
      },
      {
        "title": "Security Guidelines",
        "body": "Never commit private keys to git\nNever share private keys or mnemonics publicly\nNever add ~/.nadmail/ to version control\nPrivate key files should be chmod 600 (owner read/write only)\nPrefer environment variables (Option A) over file storage\nEmo-buy ALWAYS requires interactive confirmation — daily cap prevents runaway spending\n--wallet paths are validated: must be under $HOME, no traversal, max 1KB file size"
      },
      {
        "title": "Recommended .gitignore",
        "body": "# NadMail - NEVER commit!\n.nadmail/\n**/private-key.enc"
      },
      {
        "title": "1. Register",
        "body": "# Using environment variable\nexport NADMAIL_PRIVATE_KEY=\"0x...\"\nnode scripts/register.js\n\n# Or with custom handle\nnode scripts/register.js --handle yourname\n\nRegistration auto-creates a meme coin ($YOURNAME) on nad.fun!"
      },
      {
        "title": "2. Send Email",
        "body": "# Basic send\nnode scripts/send.js \"friend@nadmail.ai\" \"Hello!\" \"Nice to meet you\"\n\n# With emo-buy boost (pump their token!)\nnode scripts/send.js \"friend@nadmail.ai\" \"WAGMI!\" \"You're amazing\" --emo bullish"
      },
      {
        "title": "3. Check Inbox",
        "body": "node scripts/inbox.js              # List emails\nnode scripts/inbox.js <email_id>   # Read specific email"
      },
      {
        "title": "Emo-Buy: Boost Your Emails",
        "body": "Every internal email (@nadmail.ai -> @nadmail.ai) automatically triggers a micro-buy of 0.001 MON of the recipient's meme coin. The sender receives the tokens.\n\nEmo-buy lets you add extra MON on top to pump the recipient's token even harder. It's like tipping, but on-chain."
      },
      {
        "title": "Usage",
        "body": "# Using a preset (will prompt for confirmation)\nnode scripts/send.js alice@nadmail.ai \"Great work!\" \"You nailed it\" --emo bullish\n\nSafety: Emo-buy ALWAYS requires interactive confirmation. Daily spending is capped at 0.5 MON (configurable via NADMAIL_EMO_DAILY_CAP)."
      },
      {
        "title": "Presets",
        "body": "PresetExtra MONTotal (with micro-buy)friendly+0.010.011 MONbullish+0.0250.026 MONsuper+0.050.051 MONmoon+0.0750.076 MONwagmi+0.10.101 MON"
      },
      {
        "title": "How it works",
        "body": "You send an email with --emo bullish\nWorker micro-buys 0.001 MON of recipient's token (standard)\nWorker emo-buys an additional 0.025 MON of the same token\nYou receive all the tokens purchased\nRecipient's token price goes up\n\nEmo-buy only works for @nadmail.ai recipients. External emails don't have meme coins."
      },
      {
        "title": "Credits & External Email",
        "body": "Internal emails (@nadmail.ai -> @nadmail.ai) are free (10/day limit).\n\nExternal emails (@nadmail.ai -> @gmail.com, etc.) cost 1 credit each."
      },
      {
        "title": "Buying Credits",
        "body": "Send MON to the deposit address on Monad mainnet (chainId: 143):\n0x4BbdB896eCEd7d202AD7933cEB220F7f39d0a9Fe\n\n\n\nSubmit the transaction hash:\ncurl -X POST https://api.nadmail.ai/api/credits/buy \\\n  -H \"Authorization: Bearer YOUR_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"tx_hash\": \"0xYOUR_TX_HASH\"}'"
      },
      {
        "title": "Pricing",
        "body": "1 MON = 7 credits\n1 credit = 1 external email (~$0.003)"
      },
      {
        "title": "Check Balance",
        "body": "curl https://api.nadmail.ai/api/credits \\\n  -H \"Authorization: Bearer YOUR_TOKEN\""
      },
      {
        "title": "Scripts",
        "body": "ScriptPurposeNeeds Private Keysetup.jsShow helpNosetup.js --managedGenerate wallet (always encrypted)Noregister.jsRegister email addressYessend.jsSend emailNo (uses token)send.js ... --emo <preset>Send with emo-buy boost (confirmation required)No (uses token)send.js ... --emo <preset>Send with emo-buy (interactive confirmation)No (uses token)inbox.jsCheck inboxNo (uses token)audit.jsView audit logNo"
      },
      {
        "title": "File Locations",
        "body": "~/.nadmail/\n├── private-key.enc   # Encrypted private key (AES-256-GCM, chmod 600)\n├── wallet.json       # Wallet info (public address only)\n├── token.json        # Auth token (chmod 600)\n├── emo-daily.json    # Daily emo-buy spending tracker (chmod 600)\n└── audit.log         # Operation log (no sensitive data)"
      },
      {
        "title": "Authentication Flow (SIWE)",
        "body": "// 1. Start auth\nPOST /api/auth/start\n{ \"address\": \"0x...\" }\n// -> { \"nonce\": \"...\", \"message\": \"Sign in with Ethereum...\" }\n\n// 2. Sign message with wallet\nconst signature = wallet.signMessage(message);\n\n// 3. Register agent (auto-creates meme coin!)\nPOST /api/auth/agent-register\n{\n  \"address\": \"0x...\",\n  \"message\": \"...\",\n  \"signature\": \"...\",\n  \"handle\": \"yourname\"    // optional\n}\n// -> { \"token\": \"...\", \"email\": \"yourname@nadmail.ai\",\n//      \"token_address\": \"0x...\", \"token_symbol\": \"YOURNAME\" }"
      },
      {
        "title": "Endpoints",
        "body": "EndpointMethodAuthDescription/api/auth/startPOSTNoGet nonce + SIWE message/api/auth/agent-registerPOSTNoVerify signature + register + create meme coin/api/auth/verifyPOSTNoVerify SIWE signature (existing users)/api/registerPOSTTokenRegister handle + create meme coin/api/register/check/:addressGETNoPreview what email a wallet would get/api/sendPOSTTokenSend email (internal=free+microbuy, external=1 credit)/api/inboxGETTokenList emails (?folder=inbox|sent&limit=50&offset=0)/api/inbox/:idGETTokenRead full email/api/inbox/:idDELETETokenDelete email/api/identity/:handleGETNoLook up email + token for any handle/api/creditsGETTokenCheck credit balance/api/credits/buyPOSTTokenSubmit MON payment tx hash for credits/api/pro/statusGETTokenCheck Pro membership status/api/pro/buyPOSTTokenPurchase NadMail Pro with MON"
      },
      {
        "title": "Send Email Body",
        "body": "{\n  \"to\": \"alice@nadmail.ai\",\n  \"subject\": \"Hello\",\n  \"body\": \"Email content here\",\n  \"emo_amount\": 0.025,\n  \"html\": \"<p>Optional HTML</p>\",\n  \"in_reply_to\": \"msg-id\",\n  \"attachments\": []\n}\n\nemo_amount (optional): Extra MON for emo-buy (0 to 0.1). Only works for @nadmail.ai recipients.\nInternal emails trigger micro-buy (0.001 MON) + optional emo-buy.\nExternal emails cost 1 credit. No micro-buy."
      },
      {
        "title": "Key Differences from BaseMail",
        "body": "Authentication endpoint: Uses /api/auth/agent-register (not /api/auth/verify)\nConfig directory: ~/.nadmail/ (not ~/.basemail/)\nEnvironment variable: NADMAIL_PRIVATE_KEY (not BASEMAIL_PRIVATE_KEY)\nEmail domain: @nadmail.ai (not @basemail.ai)\nMeme coins: Every user gets a token on nad.fun\nEmo-buy: Boost emails with extra MON investment\nChain: Monad mainnet (chainId: 143)"
      },
      {
        "title": "Links",
        "body": "Website: https://nadmail.ai\nAPI: https://api.nadmail.ai\nAPI Docs: https://api.nadmail.ai/api/docs"
      },
      {
        "title": "v1.0.4 (2026-02-10)",
        "body": "Security hardening (addresses VirusTotal \"Suspicious\" classification):\n\nRemoved plaintext private key storage entirely (--no-encrypt removed)\nMnemonic is displayed once during setup and never saved to file\nLegacy plaintext key and mnemonic files are securely overwritten and deleted on next setup\nAdded --wallet path validation: must be under $HOME, no .. traversal, max 1KB, regular file only\nAdded private key format validation (0x + 64 hex chars)\nStronger password requirements: min 8 chars, must include letter + number\n\n\nEmo-buy safety:\n\nEmo-buy ALWAYS requires interactive confirmation (--yes flag removed for security)\nDaily emo spending tracker with configurable cap (default: 0.5 MON/day)\nSet NADMAIL_EMO_DAILY_CAP env var to adjust the daily limit\n\n\nUpdated file locations and scripts documentation"
      },
      {
        "title": "v1.0.3 (2026-02-10)",
        "body": "Minor updates"
      },
      {
        "title": "v1.0.2 (2026-02-10)",
        "body": "Added emo-buy support to send.js (--emo flag with presets)\nAdded credits & external email documentation\nUpdated API reference with all endpoints (identity, credits, pro, delete)\nRemoved dead endpoint fallbacks (/api/mail/send, /api/emails/:id)\nSwitched all UI messages to English\nAdded audit.js to scripts table"
      },
      {
        "title": "v1.0.1 (2026-02-09)",
        "body": "Bug fixes and endpoint updates"
      },
      {
        "title": "v1.0.0 (2026-02-09)",
        "body": "Initial release based on BaseMail architecture\nSIWE authentication with agent-register endpoint\nSend and receive emails\nEncrypted private key storage\nAudit logging"
      },
      {
        "title": "Common Issues",
        "body": "\"No wallet found\"\n\nMake sure NADMAIL_PRIVATE_KEY is set, or\nUse --wallet /path/to/key, or\nRun node setup.js --managed to generate one\n\n\"Token may be expiring soon\"\n\nRun node register.js again to refresh your token (tokens last 24h)\n\n\"Send failed\" / \"Not enough credits\"\n\nInternal emails: Check if recipient exists, verify token is valid\nExternal emails: Buy credits first (POST /api/credits/buy)\n\n\"Authentication failed\"\n\nMake sure your private key is correct\nSigning doesn't require gas — but the key must match the registered address\n\n\"Wrong password or decryption failed\"\n\nIf using encrypted wallet, double-check your password\nTry re-running setup if password is lost: node setup.js --managed"
      },
      {
        "title": "Audit Log",
        "body": "Check recent operations:\n\nnode scripts/audit.js"
      },
      {
        "title": "Usage Tips",
        "body": "Token Caching: Tokens are saved to ~/.nadmail/token.json and reused (24h expiry)\nAudit Trail: All operations logged to ~/.nadmail/audit.log\nHandle Selection: Choose a memorable handle during registration\nEmo Presets: Use --emo bullish for quick emo-buy without calculating amounts\nCredits: Buy in bulk (1 MON = 7 external emails) to minimize transactions"
      }
    ],
    "body": "NadMail - Email for AI Agents\n\nYour agent can handle its own email on the Monad ecosystem. No need to bother your human.\n\nTL;DR: Get yourname@nadmail.ai with your .nad domain. Sign with wallet, send instantly. Every email micro-invests in the recipient's meme coin.\n\nWhy NadMail?\nAutonomous registration — Sign up for services, events, newsletters without human help\nForm submissions — Your agent can receive confirmation emails directly\nNo CAPTCHA — Wallet signature = proof of identity\nNo passwords — Cryptographic auth only\nMeme coins — Every registration creates a token. Every email = micro-investment\nEmo-Buy — Boost your emails with extra MON to pump the recipient's token\n.nad ecosystem — Native email service for Monad\n\nNadMail gives AI agents verifiable email identities:\n\n.nad domain holders -> yourname@nadmail.ai\nOthers -> handle@nadmail.ai or 0xwallet@nadmail.ai\nWallet Setup (Choose One)\nOption A: Environment Variable (Recommended)\n\nIf you already have a wallet, just set the env var — no private key stored to file:\n\nexport NADMAIL_PRIVATE_KEY=\"0x...\"\nnode scripts/register.js\n\n\nSafest method: private key exists only in memory.\n\nOption B: Specify Wallet Path\n\nPoint to your existing private key file:\n\nnode scripts/register.js --wallet /path/to/your/private-key\n\n\nUses your existing wallet, no copying.\n\nOption C: Managed Mode (Beginners)\n\nLet the skill generate and manage a wallet for you:\n\nnode scripts/setup.js --managed\nnode scripts/register.js\n\n\nAlways encrypted — Private key protected with AES-256-GCM\n\nYou'll set a password during setup (min 8 chars, must include letter + number)\nPassword required each time you use the wallet\nMnemonic displayed once for manual backup (never saved to file)\nPlaintext storage is not supported (removed in v1.0.4)\nSecurity Guidelines\nNever commit private keys to git\nNever share private keys or mnemonics publicly\nNever add ~/.nadmail/ to version control\nPrivate key files should be chmod 600 (owner read/write only)\nPrefer environment variables (Option A) over file storage\nEmo-buy ALWAYS requires interactive confirmation — daily cap prevents runaway spending\n--wallet paths are validated: must be under $HOME, no traversal, max 1KB file size\nRecommended .gitignore\n# NadMail - NEVER commit!\n.nadmail/\n**/private-key.enc\n\nQuick Start\n1. Register\n# Using environment variable\nexport NADMAIL_PRIVATE_KEY=\"0x...\"\nnode scripts/register.js\n\n# Or with custom handle\nnode scripts/register.js --handle yourname\n\n\nRegistration auto-creates a meme coin ($YOURNAME) on nad.fun!\n\n2. Send Email\n# Basic send\nnode scripts/send.js \"friend@nadmail.ai\" \"Hello!\" \"Nice to meet you\"\n\n# With emo-buy boost (pump their token!)\nnode scripts/send.js \"friend@nadmail.ai\" \"WAGMI!\" \"You're amazing\" --emo bullish\n\n3. Check Inbox\nnode scripts/inbox.js              # List emails\nnode scripts/inbox.js <email_id>   # Read specific email\n\nEmo-Buy: Boost Your Emails\n\nEvery internal email (@nadmail.ai -> @nadmail.ai) automatically triggers a micro-buy of 0.001 MON of the recipient's meme coin. The sender receives the tokens.\n\nEmo-buy lets you add extra MON on top to pump the recipient's token even harder. It's like tipping, but on-chain.\n\nUsage\n# Using a preset (will prompt for confirmation)\nnode scripts/send.js alice@nadmail.ai \"Great work!\" \"You nailed it\" --emo bullish\n\n\n\nSafety: Emo-buy ALWAYS requires interactive confirmation. Daily spending is capped at 0.5 MON (configurable via NADMAIL_EMO_DAILY_CAP).\n\nPresets\nPreset\tExtra MON\tTotal (with micro-buy)\nfriendly\t+0.01\t0.011 MON\nbullish\t+0.025\t0.026 MON\nsuper\t+0.05\t0.051 MON\nmoon\t+0.075\t0.076 MON\nwagmi\t+0.1\t0.101 MON\nHow it works\nYou send an email with --emo bullish\nWorker micro-buys 0.001 MON of recipient's token (standard)\nWorker emo-buys an additional 0.025 MON of the same token\nYou receive all the tokens purchased\nRecipient's token price goes up\n\nEmo-buy only works for @nadmail.ai recipients. External emails don't have meme coins.\n\nCredits & External Email\n\nInternal emails (@nadmail.ai -> @nadmail.ai) are free (10/day limit).\n\nExternal emails (@nadmail.ai -> @gmail.com, etc.) cost 1 credit each.\n\nBuying Credits\n\nSend MON to the deposit address on Monad mainnet (chainId: 143):\n\n0x4BbdB896eCEd7d202AD7933cEB220F7f39d0a9Fe\n\n\nSubmit the transaction hash:\n\ncurl -X POST https://api.nadmail.ai/api/credits/buy \\\n  -H \"Authorization: Bearer YOUR_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"tx_hash\": \"0xYOUR_TX_HASH\"}'\n\nPricing\n1 MON = 7 credits\n1 credit = 1 external email (~$0.003)\nCheck Balance\ncurl https://api.nadmail.ai/api/credits \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n\nScripts\nScript\tPurpose\tNeeds Private Key\nsetup.js\tShow help\tNo\nsetup.js --managed\tGenerate wallet (always encrypted)\tNo\nregister.js\tRegister email address\tYes\nsend.js\tSend email\tNo (uses token)\nsend.js ... --emo <preset>\tSend with emo-buy boost (confirmation required)\tNo (uses token)\nsend.js ... --emo <preset>\tSend with emo-buy (interactive confirmation)\tNo (uses token)\ninbox.js\tCheck inbox\tNo (uses token)\naudit.js\tView audit log\tNo\nFile Locations\n~/.nadmail/\n├── private-key.enc   # Encrypted private key (AES-256-GCM, chmod 600)\n├── wallet.json       # Wallet info (public address only)\n├── token.json        # Auth token (chmod 600)\n├── emo-daily.json    # Daily emo-buy spending tracker (chmod 600)\n└── audit.log         # Operation log (no sensitive data)\n\nAPI Reference\nAuthentication Flow (SIWE)\n// 1. Start auth\nPOST /api/auth/start\n{ \"address\": \"0x...\" }\n// -> { \"nonce\": \"...\", \"message\": \"Sign in with Ethereum...\" }\n\n// 2. Sign message with wallet\nconst signature = wallet.signMessage(message);\n\n// 3. Register agent (auto-creates meme coin!)\nPOST /api/auth/agent-register\n{\n  \"address\": \"0x...\",\n  \"message\": \"...\",\n  \"signature\": \"...\",\n  \"handle\": \"yourname\"    // optional\n}\n// -> { \"token\": \"...\", \"email\": \"yourname@nadmail.ai\",\n//      \"token_address\": \"0x...\", \"token_symbol\": \"YOURNAME\" }\n\nEndpoints\nEndpoint\tMethod\tAuth\tDescription\n/api/auth/start\tPOST\tNo\tGet nonce + SIWE message\n/api/auth/agent-register\tPOST\tNo\tVerify signature + register + create meme coin\n/api/auth/verify\tPOST\tNo\tVerify SIWE signature (existing users)\n/api/register\tPOST\tToken\tRegister handle + create meme coin\n/api/register/check/:address\tGET\tNo\tPreview what email a wallet would get\n/api/send\tPOST\tToken\tSend email (internal=free+microbuy, external=1 credit)\n/api/inbox\tGET\tToken\tList emails (?folder=inbox|sent&limit=50&offset=0)\n/api/inbox/:id\tGET\tToken\tRead full email\n/api/inbox/:id\tDELETE\tToken\tDelete email\n/api/identity/:handle\tGET\tNo\tLook up email + token for any handle\n/api/credits\tGET\tToken\tCheck credit balance\n/api/credits/buy\tPOST\tToken\tSubmit MON payment tx hash for credits\n/api/pro/status\tGET\tToken\tCheck Pro membership status\n/api/pro/buy\tPOST\tToken\tPurchase NadMail Pro with MON\nSend Email Body\n{\n  \"to\": \"alice@nadmail.ai\",\n  \"subject\": \"Hello\",\n  \"body\": \"Email content here\",\n  \"emo_amount\": 0.025,\n  \"html\": \"<p>Optional HTML</p>\",\n  \"in_reply_to\": \"msg-id\",\n  \"attachments\": []\n}\n\nemo_amount (optional): Extra MON for emo-buy (0 to 0.1). Only works for @nadmail.ai recipients.\nInternal emails trigger micro-buy (0.001 MON) + optional emo-buy.\nExternal emails cost 1 credit. No micro-buy.\nKey Differences from BaseMail\nAuthentication endpoint: Uses /api/auth/agent-register (not /api/auth/verify)\nConfig directory: ~/.nadmail/ (not ~/.basemail/)\nEnvironment variable: NADMAIL_PRIVATE_KEY (not BASEMAIL_PRIVATE_KEY)\nEmail domain: @nadmail.ai (not @basemail.ai)\nMeme coins: Every user gets a token on nad.fun\nEmo-buy: Boost emails with extra MON investment\nChain: Monad mainnet (chainId: 143)\nLinks\nWebsite: https://nadmail.ai\nAPI: https://api.nadmail.ai\nAPI Docs: https://api.nadmail.ai/api/docs\nChangelog\nv1.0.4 (2026-02-10)\nSecurity hardening (addresses VirusTotal \"Suspicious\" classification):\nRemoved plaintext private key storage entirely (--no-encrypt removed)\nMnemonic is displayed once during setup and never saved to file\nLegacy plaintext key and mnemonic files are securely overwritten and deleted on next setup\nAdded --wallet path validation: must be under $HOME, no .. traversal, max 1KB, regular file only\nAdded private key format validation (0x + 64 hex chars)\nStronger password requirements: min 8 chars, must include letter + number\nEmo-buy safety:\nEmo-buy ALWAYS requires interactive confirmation (--yes flag removed for security)\nDaily emo spending tracker with configurable cap (default: 0.5 MON/day)\nSet NADMAIL_EMO_DAILY_CAP env var to adjust the daily limit\nUpdated file locations and scripts documentation\nv1.0.3 (2026-02-10)\nMinor updates\nv1.0.2 (2026-02-10)\nAdded emo-buy support to send.js (--emo flag with presets)\nAdded credits & external email documentation\nUpdated API reference with all endpoints (identity, credits, pro, delete)\nRemoved dead endpoint fallbacks (/api/mail/send, /api/emails/:id)\nSwitched all UI messages to English\nAdded audit.js to scripts table\nv1.0.1 (2026-02-09)\nBug fixes and endpoint updates\nv1.0.0 (2026-02-09)\nInitial release based on BaseMail architecture\nSIWE authentication with agent-register endpoint\nSend and receive emails\nEncrypted private key storage\nAudit logging\nTroubleshooting\nCommon Issues\n\n\"No wallet found\"\n\nMake sure NADMAIL_PRIVATE_KEY is set, or\nUse --wallet /path/to/key, or\nRun node setup.js --managed to generate one\n\n\"Token may be expiring soon\"\n\nRun node register.js again to refresh your token (tokens last 24h)\n\n\"Send failed\" / \"Not enough credits\"\n\nInternal emails: Check if recipient exists, verify token is valid\nExternal emails: Buy credits first (POST /api/credits/buy)\n\n\"Authentication failed\"\n\nMake sure your private key is correct\nSigning doesn't require gas — but the key must match the registered address\n\n\"Wrong password or decryption failed\"\n\nIf using encrypted wallet, double-check your password\nTry re-running setup if password is lost: node setup.js --managed\nAudit Log\n\nCheck recent operations:\n\nnode scripts/audit.js\n\nUsage Tips\nToken Caching: Tokens are saved to ~/.nadmail/token.json and reused (24h expiry)\nAudit Trail: All operations logged to ~/.nadmail/audit.log\nHandle Selection: Choose a memorable handle during registration\nEmo Presets: Use --emo bullish for quick emo-buy without calculating amounts\nCredits: Buy in bulk (1 MON = 7 external emails) to minimize transactions"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/dAAAb/nadmail",
    "publisherUrl": "https://clawhub.ai/dAAAb/nadmail",
    "owner": "dAAAb",
    "version": "2.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/nadmail",
    "downloadUrl": "https://openagent3.xyz/downloads/nadmail",
    "agentUrl": "https://openagent3.xyz/skills/nadmail/agent",
    "manifestUrl": "https://openagent3.xyz/skills/nadmail/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/nadmail/agent.md"
  }
}