nodpay 0.2.0 → 0.2.2

package/README.md

@@ -1,48 +1,48 @@
-# NodPay
+# nodpay
 
-> Two minds, one wallet.
+Agent toolkit for [NodPay](https://nodpay.ai) — propose on-chain payments from a shared wallet.
 
-AI agents propose on-chain payments. Humans approve with one tap. Self-custodial 2-of-3 multisig powered by [Safe](https://safe.global).
+> **This package is for AI agents.** If you're a human, visit [nodpay.ai](https://nodpay.ai).
 
-## Install
+## What NodPay does
 
-```bash
-npx nodpay propose --safe 0x... --to 0x... --value-eth 0.01 --signer-type passkey
-```
-
-No install needed — `npx` handles everything.
-
-## What it does
+You (an AI agent) and your human share a 2-of-3 multisig wallet. You propose transactions; the human approves or rejects each one. You cannot spend without their approval.
 
-1. **Agent** generates a key and sends the user a wallet creation link
-2. **User** opens the link, creates a passkey wallet in 30 seconds
-3. **Agent** proposes transactions → user approves or rejects each one
-
-The wallet is an ERC-4337 Safe multisig. The agent holds 1 key, the user holds 2 (passkey + recovery). The agent cannot spend without human approval.
-
-## Quick start
+## Usage
 
 ```bash
-# 1. Generate an agent key
-node -e "const w=require('ethers').Wallet.createRandom();console.log(w.address,w.privateKey)"
-
-# 2. Send user: https://nodpay.ai/?agent=YOUR_ADDRESS
-
-# 3. After user creates wallet, propose a transaction:
+# No install needed
 NODPAY_AGENT_KEY=0x... npx nodpay propose \
   --safe 0xWALLET --to 0xRECIPIENT --value-eth 0.01 \
-  --signer-type passkey --passkey-x 0x... --passkey-y 0x... --recovery 0x...
+  --signer-type passkey --passkey-x 0x... --passkey-y 0x...
 ```
 
-## Docs
+## Full guide
+
+**[nodpay.ai/skill.md](https://nodpay.ai/skill.md)** — complete setup + integration guide for agents (key generation, wallet creation, proposing, error handling).
+
+## How it works
+
+1. Agent generates a key → sends user a wallet creation link
+2. User creates a passkey wallet at nodpay.ai (30 seconds)
+3. Agent proposes transactions with `npx nodpay propose`
+4. User approves/rejects on their phone
 
-- **Full agent guide**: [nodpay.ai/skill.md](https://nodpay.ai/skill.md)
-- **Website**: [nodpay.ai](https://nodpay.ai)
+## Env
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `NODPAY_AGENT_KEY` | ✅ | Agent's private key (hex) |
 
 ## Supported chains
 
 Ethereum · Base · Arbitrum · Optimism · Polygon · Sepolia · Base Sepolia
 
+## Related
+
+- [`@nodpay/core`](https://www.npmjs.com/package/@nodpay/core) — Protocol primitives (hash, decode, verify)
+- [nodpay.ai](https://nodpay.ai) — Web app
+
 ## License
 
 MIT

package/SKILL.md

@@ -44,6 +44,8 @@ node -e "const w=require('ethers').Wallet.createRandom();console.log('Address:',
 
 Store the private key as `NODPAY_AGENT_KEY` in your environment. The address is your public agent identity.
 
+**⚠️ Storing the env var may trigger a restart.** Complete all config/env changes and wait for the restart to finish BEFORE sending any message to the user. Do not send messages and update config in parallel — the restart will truncate your message.
+
 ### 2. Send the user a wallet link
 
 Replace `YOUR_AGENT_ADDRESS` with your EOA address and send:
@@ -68,6 +70,8 @@ Recovery Signer: 0x...
 
 **Store all fields** — you need them for proposing transactions.
 
+**After wallet creation**, tell the user their wallet is ready and the address works on any supported chain. Briefly offer: *"Want to try a test transaction on a testnet first?"* — only guide to testnets (Sepolia, etc.) if the user says yes.
+
 #### Wallet file management
 
 Store wallet info in `.nodpay/wallets/` in your workspace root:
@@ -87,7 +91,6 @@ Each wallet file:
   "passkeyX": "0x...",
   "passkeyY": "0x...",
   "recovery": "0x...",
-  "chain": "sepolia",
   "createdAt": "2025-01-01"
 }
 ```
@@ -172,7 +175,9 @@ Chain config (RPC, bundler, explorer) is auto-resolved from `references/networks
 
 ### Supported Chains
 
-`sepolia`, `ethereum`, `base`, `base_sepolia`, `arbitrum`, `optimism`, `polygon`
+`ethereum`, `base`, `arbitrum`, `optimism`, `polygon`, `sepolia`, `base_sepolia`
+
+The wallet address is the same across all chains (counterfactual). Chain is only relevant at transaction time. **Do not assume a default chain.** When the user asks to send, ask which chain if not specified.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nodpay",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "NodPay CLI — propose on-chain payments from agent-human shared wallets",
   "type": "module",
   "bin": {
@@ -9,7 +9,6 @@
   "files": [
     "bin/",
     "scripts/",
-    "references/",
     "SKILL.md"
   ],
   "repository": {
@@ -28,6 +27,9 @@
   ],
   "author": "xhyumiracle",
   "license": "MIT",
+  "scripts": {
+    "postpublish": "curl -s https://purge.jsdelivr.net/npm/nodpay@latest/SKILL.md > /dev/null && echo 'jsdelivr cache purged'"
+  },
   "dependencies": {
     "@nodpay/core": "^0.1.0",
     "@safe-global/relay-kit": "^4.1.1",

package/scripts/propose.mjs

@@ -10,7 +10,7 @@
  *   NODPAY_AGENT_KEY  - Agent signer private key
  *   SAFE_ADDRESS       - Deployed Safe address (can be overridden with --safe)
  *   RPC_URL            - RPC endpoint
- *   CHAIN_ID           - Chain ID (default: 11155111)
+ *   CHAIN_ID           - Chain ID (required, no default)
  *
  * Args:
  *   --to <address>           - Recipient address
@@ -37,8 +37,12 @@ const __dirname = dirname(fileURLToPath(import.meta.url));
 const PENDING_DIR = join(__dirname, '..', '.pending-txs');
 mkdirSync(PENDING_DIR, { recursive: true });
 
-const RPC_URL = process.env.RPC_URL || 'https://ethereum-sepolia-rpc.publicnode.com';
-const CHAIN_ID = process.env.CHAIN_ID || '11155111';
+const RPC_URL = process.env.RPC_URL;
+const CHAIN_ID = process.env.CHAIN_ID;
+if (!RPC_URL || !CHAIN_ID) {
+  console.error('Error: RPC_URL and CHAIN_ID environment variables are required.\nSet them for your target chain. See references/networks.json for supported chains.');
+  process.exit(1);
+}
 const ENTRYPOINT_ADDRESS = ENTRYPOINT;
 const NODPAY_AGENT_KEY = process.env.NODPAY_AGENT_KEY;
 const DEFAULT_SAFE = process.env.SAFE_ADDRESS;

package/references/networks.json

@@ -1,84 +0,0 @@
-{
-  "mainnet": {
-    "ethereum": {
-      "name": "Ethereum",
-      "chainId": 1,
-      "rpcUrl": "https://ethereum-rpc.publicnode.com",
-      "txServiceUrl": "https://safe-transaction-mainnet.safe.global",
-      "safePrefix": "eth",
-      "explorerUrl": "https://etherscan.io",
-      "explorerTxPath": "/tx/",
-      "explorerAddrPath": "/address/",
-      "nativeCurrency": "ETH"
-    },
-    "base": {
-      "name": "Base",
-      "chainId": 8453,
-      "rpcUrl": "https://base-rpc.publicnode.com",
-      "txServiceUrl": "https://safe-transaction-base.safe.global",
-      "safePrefix": "base",
-      "explorerUrl": "https://basescan.org",
-      "explorerTxPath": "/tx/",
-      "explorerAddrPath": "/address/",
-      "nativeCurrency": "ETH",
-      "gasSponsored": true
-    },
-    "arbitrum": {
-      "name": "Arbitrum",
-      "chainId": 42161,
-      "rpcUrl": "https://arbitrum-one-rpc.publicnode.com",
-      "txServiceUrl": "https://safe-transaction-arbitrum.safe.global",
-      "safePrefix": "arb1",
-      "explorerUrl": "https://arbiscan.io",
-      "explorerTxPath": "/tx/",
-      "explorerAddrPath": "/address/",
-      "nativeCurrency": "ETH"
-    },
-    "polygon": {
-      "name": "Polygon",
-      "chainId": 137,
-      "rpcUrl": "https://polygon-bor-rpc.publicnode.com",
-      "txServiceUrl": "https://safe-transaction-polygon.safe.global",
-      "safePrefix": "matic",
-      "explorerUrl": "https://polygonscan.com",
-      "explorerTxPath": "/tx/",
-      "explorerAddrPath": "/address/",
-      "nativeCurrency": "MATIC"
-    },
-    "optimism": {
-      "name": "Optimism",
-      "chainId": 10,
-      "rpcUrl": "https://optimism-rpc.publicnode.com",
-      "txServiceUrl": "https://safe-transaction-optimism.safe.global",
-      "safePrefix": "oeth",
-      "explorerUrl": "https://optimistic.etherscan.io",
-      "explorerTxPath": "/tx/",
-      "explorerAddrPath": "/address/",
-      "nativeCurrency": "ETH"
-    }
-  },
-  "testnet": {
-    "sepolia": {
-      "name": "Sepolia (Ethereum)",
-      "chainId": 11155111,
-      "rpcUrl": "https://ethereum-sepolia-rpc.publicnode.com",
-      "txServiceUrl": "https://safe-transaction-sepolia.safe.global",
-      "safePrefix": "sep",
-      "explorerUrl": "https://sepolia.etherscan.io",
-      "explorerTxPath": "/tx/",
-      "explorerAddrPath": "/address/",
-      "nativeCurrency": "ETH"
-    },
-    "base_sepolia": {
-      "name": "Base Sepolia",
-      "chainId": 84532,
-      "rpcUrl": "https://base-sepolia-rpc.publicnode.com",
-      "txServiceUrl": "https://safe-transaction-base-sepolia.safe.global",
-      "safePrefix": "basesep",
-      "explorerUrl": "https://sepolia.basescan.org",
-      "explorerTxPath": "/tx/",
-      "explorerAddrPath": "/address/",
-      "nativeCurrency": "ETH"
-    }
-  }
-}