nodpay 0.2.28 → 0.2.30

package/SKILL.md

@@ -111,7 +111,13 @@ First tx deploys the wallet. Pass all params for first tx; after that `--safe` a
 npx nodpay txs --safe <SAFE>
 ```
 
-Check before proposing — shows nonce, pending ops, and wallet status.
+**Always run `txs` before proposing.** Do not assume a previous transaction is still pending — the human may have approved or rejected it without telling you. Check actual on-chain state first.
+
+```bash
+npx nodpay gasprice --chain <CHAIN>
+```
+
+Returns current gas price and estimated gas cost (`estimatedGasCost.deploy` for first tx, `.call` for subsequent). Use when proposing a sweep: `maxSendable = balance - estimatedGasCost.deploy`.
 
 ---
 

package/bin/nodpay.mjs

@@ -15,6 +15,10 @@ if (command === 'propose') {
   const scriptPath = new URL('../scripts/txs.mjs', import.meta.url).pathname;
   process.argv = [process.argv[0], scriptPath, ...process.argv.slice(3)];
   await import(scriptPath);
+} else if (command === 'gasprice') {
+  const scriptPath = new URL('../scripts/gasprice.mjs', import.meta.url).pathname;
+  process.argv = [process.argv[0], scriptPath, ...process.argv.slice(3)];
+  await import(scriptPath);
 } else if (command === 'version' || command === '--version' || command === '-v') {
   const { readFileSync } = await import('fs');
   const pkg = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
@@ -26,11 +30,13 @@ Commands:
   keygen    Generate (or reuse) agent keypair
   propose   Propose a transaction for human approval
   txs       List pending and completed transactions
+  gasprice  Get current gas price and estimated gas cost per chain
 
 Examples:
   nodpay keygen
   nodpay propose --safe 0x... --to 0x... --value-eth 0.01 --chain base
   nodpay txs --safe 0x...
+  nodpay gasprice --chain base
 
 Docs: https://nodpay.ai/skill.md`);
   process.exit(command ? 1 : 0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nodpay",
-  "version": "0.2.28",
+  "version": "0.2.30",
   "description": "NodPay CLI — propose on-chain payments from agent-human shared wallets",
   "type": "module",
   "bin": {

package/scripts/gasprice.mjs

@@ -0,0 +1,95 @@
+#!/usr/bin/env node
+/**
+ * Get current gas price and estimated gas cost for a NodPay transaction.
+ *
+ * Useful before proposing a sweep ("send all funds") — lets you calculate
+ * how much ETH to leave for gas before proposing the full balance.
+ *
+ * Usage:
+ *   npx nodpay gasprice --chain <CHAIN>
+ *
+ * Output:
+ *   {
+ *     "chain": "base",
+ *     "chainId": "8453",
+ *     "gasPriceGwei": "0.0012",
+ *     "estimatedGasCost": {
+ *       "deploy": "0.000152",   // first tx (Safe not yet deployed)
+ *       "call": "0.000043"      // subsequent txs
+ *     }
+ *   }
+ *
+ * The agent should use:
+ *   maxSendable = balance - estimatedGasCost.deploy  (if nonce 0 / counterfactual)
+ *   maxSendable = balance - estimatedGasCost.call    (if Safe already deployed)
+ */
+
+import { ethers } from 'ethers';
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+const NETWORKS = require('@nodpay/core/networks');
+
+const args = process.argv.slice(2);
+function getArg(name) {
+  const idx = args.indexOf(name);
+  return idx !== -1 ? args[idx + 1] : undefined;
+}
+
+const chainArg = getArg('--chain');
+if (!chainArg) {
+  const allChains = { ...NETWORKS.mainnet, ...NETWORKS.testnet };
+  console.error(JSON.stringify({ error: '--chain is required. Supported: ' + Object.keys(allChains).join(', ') }));
+  process.exit(1);
+}
+
+const allChains = { ...NETWORKS.mainnet, ...NETWORKS.testnet };
+const net = allChains[chainArg];
+if (!net) {
+  console.error(JSON.stringify({ error: `Unknown chain "${chainArg}". Supported: ${Object.keys(allChains).join(', ')}` }));
+  process.exit(1);
+}
+
+// Gas baselines from bundler simulation (same as propose.mjs)
+const BUNDLER_BASELINE = {
+  deploy: { vgl: 2653312n, cgl: 213422n, pvg: 194498n },
+  call:   { vgl:  500000n, cgl: 218222n, pvg: 176846n },
+};
+const P256_DELTA = 400000n - 27000n; // FCL vs precompile
+const HAS_P256_PRECOMPILE = new Set(['1', '8453', '42161', '10', '137', '11155111', '84532']);
+const SAFETY = 12n; // 1.2x
+
+function totalGasUnits(isCounterfactual, chainId) {
+  const base = isCounterfactual ? BUNDLER_BASELINE.deploy : BUNDLER_BASELINE.call;
+  let vgl = base.vgl;
+  if (!HAS_P256_PRECOMPILE.has(String(chainId))) vgl += P256_DELTA;
+  const vglS = vgl * SAFETY / 10n;
+  const cglS = base.cgl * SAFETY / 10n;
+  const pvgS = base.pvg * SAFETY / 10n;
+  return vglS + cglS + pvgS;
+}
+
+try {
+  const provider = new ethers.JsonRpcProvider(net.rpcUrl);
+  const feeData = await provider.getFeeData();
+  const gasPrice = feeData.gasPrice || ethers.parseUnits('20', 'gwei');
+  const FEE_MULTIPLIER = 3n; // same buffer as propose.mjs (propose→approve window)
+
+  const effectiveGasPrice = gasPrice * FEE_MULTIPLIER;
+
+  const deployCost = totalGasUnits(true, net.chainId) * effectiveGasPrice;
+  const callCost   = totalGasUnits(false, net.chainId) * effectiveGasPrice;
+
+  console.log(JSON.stringify({
+    chain: chainArg,
+    chainId: String(net.chainId),
+    gasPriceGwei: ethers.formatUnits(gasPrice, 'gwei'),
+    effectiveGasPriceGwei: ethers.formatUnits(effectiveGasPrice, 'gwei'),
+    estimatedGasCost: {
+      deploy: ethers.formatEther(deployCost),  // nonce 0 / counterfactual Safe
+      call:   ethers.formatEther(callCost),    // Safe already deployed
+    },
+  }, null, 2));
+} catch (err) {
+  console.error(JSON.stringify({ error: err.message }));
+  process.exit(1);
+}

package/scripts/txs.mjs

@@ -124,7 +124,8 @@ try {
     }
   }
 
-  console.log(JSON.stringify(data, null, 2));
+  // BigInt values from @nodpay/core (e.g. decoded value) must be serialized as strings
+  console.log(JSON.stringify(data, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2));
 } catch (err) {
   console.error(JSON.stringify({ error: err.message }));
   process.exit(1);