@sage-protocol/cli 0.8.2 → 0.8.4

package/dist/cli/commands/stake-status.js

@@ -11,19 +11,21 @@ function register(program) {
   .option('--governor <address>', 'Governor address to check')
   .option('--address <address>', 'Address to check (defaults to connected wallet)')
   .option('-v, --verbose', 'Show detailed output')
+  .option('--json', 'Output JSON', false)
   .action(async (opts) => {
     try {
-      ui.configure({ verbose: opts.verbose });
+      ui.configure({ verbose: opts.verbose, json: opts.json });
+      const show = !opts.json;
 
       const WalletManager = require('../wallet-manager');
       const { resolveGovContext } = require('../utils/gov-context');
 
       const invokedAsStakeStatus = process.argv.includes('stake-status');
-      if (invokedAsStakeStatus) {
+      if (invokedAsStakeStatus && show) {
         ui.warn('`sage stake-status` is deprecated. Use `sage voting-status` (governance uses delegation, not staking).');
       }
 
-      const rpcUrl = process.env.RPC_URL || process.env.BASE_SEPOLIA_RPC || 'https://base-sepolia.publicnode.com';
+      const rpcUrl = process.env.SAGE_RPC_URL || process.env.RPC_URL || process.env.BASE_SEPOLIA_RPC || 'https://base-sepolia.publicnode.com';
       const provider = new ethers.JsonRpcProvider(rpcUrl);
 
       // Get wallet manager and connect
@@ -32,11 +34,13 @@ function register(program) {
       const signer = walletManager.getSigner();
       const address = opts.address || await signer.getAddress();
 
-      ui.header('Voting Power Status');
-      ui.keyValue([
-        ['Address', address],
-        ['RPC', rpcUrl]
-      ]);
+      if (show) {
+        ui.header('Voting Power Status');
+        ui.keyValue([
+          ['Address', address],
+          ['RPC', rpcUrl]
+        ]);
+      }
       
       // Resolve governance context
       const ctx = await resolveGovContext({ 
@@ -48,14 +52,17 @@ function register(program) {
       });
       
       if (!ctx.governor) {
-        ui.error('No Governor found');
+        if (show) ui.error('No Governor found');
+        else ui.json({ ok: false, error: 'No Governor found' });
         return;
       }
 
-      ui.keyValue([
-        ['Governor', ctx.governor],
-        ['SubDAO', ctx.subdao || 'N/A']
-      ]);
+      if (show) {
+        ui.keyValue([
+          ['Governor', ctx.governor],
+          ['SubDAO', ctx.subdao || 'N/A']
+        ]);
+      }
       
       // Get Governor's voting token and multiplier status
       const govABI = [
@@ -78,19 +85,21 @@ function register(program) {
       const baseVotesTokenAddr = await governor.baseVotesToken().catch(() => votingToken);
       const isWrapperMode = isMultiplierEnabled || (baseVotesTokenAddr && baseVotesTokenAddr !== votingToken);
 
-      if (isWrapperMode) {
-        ui.keyValue([
-          ['Voting Token (wrapper)', votingToken],
-          ['Base Token (SXXX)', baseVotesTokenAddr],
-          ['NFT Multipliers', isMultiplierEnabled ? 'Enabled' : 'Unknown']
-        ]);
-      } else {
-        ui.keyValue([
-          ['Voting Token', votingToken],
-          ['NFT Multipliers', 'Disabled']
-        ]);
+      if (show) {
+        if (isWrapperMode) {
+          ui.keyValue([
+            ['Voting Token (wrapper)', votingToken],
+            ['Base Token (SXXX)', baseVotesTokenAddr],
+            ['NFT Multipliers', isMultiplierEnabled ? 'Enabled' : 'Unknown']
+          ]);
+        } else {
+          ui.keyValue([
+            ['Voting Token', votingToken],
+            ['NFT Multipliers', 'Disabled']
+          ]);
+        }
+        ui.info(`Proposal Threshold: ${ethers.formatEther(threshold)} tokens`);
       }
-      ui.info(`Proposal Threshold: ${ethers.formatEther(threshold)} tokens`);
       
       // In multiplier mode, governor.token() is an IVotes wrapper (MultipliedVotes) which is NOT an ERC20,
       // so ERC20 calls (name/symbol/decimals/balanceOf) can revert. Always read ERC20 metadata from the base token.
@@ -117,35 +126,39 @@ function register(program) {
         provider.getBlockNumber()
       ]);
       
-      ui.newline();
-      ui.header('Token Details');
-      ui.keyValue([
-        ['Name', name],
-        ['Symbol', symbol],
-        ['Decimals', decimals],
-        ['Balance', `${ethers.formatUnits(balance, decimals)} ${symbol}`],
-        ['Delegates to', delegates]
-      ]);
+      if (show) {
+        ui.newline();
+        ui.header('Token Details');
+        ui.keyValue([
+          ['Name', name],
+          ['Symbol', symbol],
+          ['Decimals', decimals],
+          ['Balance', `${ethers.formatUnits(balance, decimals)} ${symbol}`],
+          ['Delegates to', delegates]
+        ]);
+      }
       
       // Check voting power at different blocks
       const blocksToCheck = [currentBlock - 1, currentBlock - 2, currentBlock - 5];
-      ui.newline();
-      ui.header('Voting Power History');
+      if (show) {
+        ui.newline();
+        ui.header('Voting Power History');
+      }
 
       for (const block of blocksToCheck) {
         try {
           const votes = await votesToken.getPastVotes(address, block);
           const formattedVotes = ethers.formatUnits(votes, decimals);
           const status = votes >= threshold ? ui.symbols.check : ui.symbols.cross;
-          ui.output(`   Block ${block}: ${formattedVotes} ${symbol} ${status}`);
+          if (show) ui.output(`   Block ${block}: ${formattedVotes} ${symbol} ${status}`);
         } catch (e) {
-          ui.output(`   Block ${block}: Error - ${e.message}`);
+          if (show) ui.output(`   Block ${block}: Error - ${e.message}`);
         }
       }
       
       // Note: stakeToken() removed from SubDAO contracts (threshold-based governance)
       // Voting power now comes from SXXX token delegation, not staking
-      if (ctx.subdao) {
+      if (ctx.subdao && show) {
         ui.newline();
         ui.header('Governance Model');
         ui.output('   This SubDAO uses threshold-based governance.');
@@ -154,8 +167,10 @@ function register(program) {
       
       // Summary
       const currentVotes = await votesToken.getPastVotes(address, currentBlock - 1).catch(() => 0n);
-      ui.newline();
-      ui.header('Summary');
+      if (show) {
+        ui.newline();
+        ui.header('Summary');
+      }
 
       // If multipliers are enabled, show both base and effective voting power
       if (isWrapperMode) {
@@ -163,32 +178,91 @@ function register(program) {
           const [baseVotes, multiplier, effectiveVotes] = await governor.getVotingBreakdown(address);
           const multiplierDisplay = (Number(multiplier) / 10000).toFixed(2);
           const canPropose = effectiveVotes >= threshold;
-          ui.keyValue([
-            ['Base Voting Power', `${ethers.formatUnits(baseVotes, decimals)} ${symbol}`],
-            ['NFT Multiplier', `${multiplierDisplay}x`],
-            ['Effective Voting Power', `${ethers.formatUnits(effectiveVotes, decimals)} votes`],
-            ['Proposal Threshold', `${ethers.formatEther(threshold)} tokens`],
-            ['Can Propose', canPropose ? 'YES' : 'NO']
-          ]);
+          if (show) {
+            ui.keyValue([
+              ['Base Voting Power', `${ethers.formatUnits(baseVotes, decimals)} ${symbol}`],
+              ['NFT Multiplier', `${multiplierDisplay}x`],
+              ['Effective Voting Power', `${ethers.formatUnits(effectiveVotes, decimals)} votes`],
+              ['Proposal Threshold', `${ethers.formatEther(threshold)} tokens`],
+              ['Can Propose', canPropose ? 'YES' : 'NO']
+            ]);
+          } else {
+            ui.json({
+              ok: true,
+              address,
+              rpcUrl,
+              governor: ctx.governor,
+              subdao: ctx.subdao || null,
+              votingToken,
+              baseToken: baseVotesTokenAddr,
+              isMultiplierEnabled: !!isMultiplierEnabled,
+              threshold: threshold.toString(),
+              balance: balance.toString(),
+              delegates,
+              baseVotes: baseVotes.toString(),
+              multiplier: multiplier.toString(),
+              effectiveVotes: effectiveVotes.toString(),
+              canPropose
+            });
+            return;
+          }
         } catch (e) {
           // Fallback if getVotingBreakdown fails
           const canPropose = currentVotes >= threshold;
+          if (show) {
+            ui.keyValue([
+              ['Current Voting Power', `${ethers.formatUnits(currentVotes, decimals)} ${symbol}`],
+              ['Proposal Threshold', `${ethers.formatEther(threshold)} tokens`],
+              ['Can Propose', canPropose ? 'YES' : 'NO']
+            ]);
+          } else {
+            ui.json({
+              ok: true,
+              address,
+              rpcUrl,
+              governor: ctx.governor,
+              subdao: ctx.subdao || null,
+              votingToken,
+              baseToken: baseVotesTokenAddr,
+              isMultiplierEnabled: !!isMultiplierEnabled,
+              threshold: threshold.toString(),
+              balance: balance.toString(),
+              delegates,
+              currentVotes: currentVotes.toString(),
+              canPropose
+            });
+            return;
+          }
+        }
+      } else {
+        const canPropose = currentVotes >= threshold;
+        if (show) {
           ui.keyValue([
             ['Current Voting Power', `${ethers.formatUnits(currentVotes, decimals)} ${symbol}`],
             ['Proposal Threshold', `${ethers.formatEther(threshold)} tokens`],
             ['Can Propose', canPropose ? 'YES' : 'NO']
           ]);
+        } else {
+          ui.json({
+            ok: true,
+            address,
+            rpcUrl,
+            governor: ctx.governor,
+            subdao: ctx.subdao || null,
+            votingToken,
+            baseToken: baseVotesTokenAddr,
+            isMultiplierEnabled: !!isMultiplierEnabled,
+            threshold: threshold.toString(),
+            balance: balance.toString(),
+            delegates,
+            currentVotes: currentVotes.toString(),
+            canPropose
+          });
+          return;
         }
-      } else {
-        const canPropose = currentVotes >= threshold;
-        ui.keyValue([
-          ['Current Voting Power', `${ethers.formatUnits(currentVotes, decimals)} ${symbol}`],
-          ['Proposal Threshold', `${ethers.formatEther(threshold)} tokens`],
-          ['Can Propose', canPropose ? 'YES' : 'NO']
-        ]);
       }
       
-      if (currentVotes < threshold) {
+      if (show && currentVotes < threshold) {
         ui.newline();
         ui.info('To gain voting power:');
         if (balance === 0n) {

package/dist/cli/commands/sxxx.js

@@ -22,10 +22,14 @@ function register(program) {
           try {
             ui.configure({ verbose: opts.verbose });
             const { ethers } = require('ethers');
-            const rpcUrl = cliConfig.resolveRpcUrl();
+            const rpcUrl = cliConfig.resolveRpcUrl({ allowEnv: true });
             const provider = new ethers.JsonRpcProvider(rpcUrl);
             const tokenAddress = cliConfig.resolveAddress('SXXX_TOKEN_ADDRESS');
             if (!tokenAddress) throw new Error('SXXX_TOKEN_ADDRESS not set');
+            const code = await provider.getCode(tokenAddress);
+            if (!code || code === '0x' || code === '0x0') {
+              throw new Error(`SXXX contract not found at ${tokenAddress}. Check SAGE_RPC_URL/CHAIN_ID or import addresses.`);
+            }
             let targetAddress = address;
             // 1) Prefer configured default account from profile
             if (!targetAddress) {
@@ -46,9 +50,38 @@ function register(program) {
               } catch (_) {}
             }
             if (!targetAddress) throw new Error('No address provided and could not resolve wallet account');
-            const abi = ['function balanceOf(address) view returns (uint256)'];
+            const abi = ['function balanceOf(address) view returns (uint256)', 'function symbol() view returns (string)'];
             const token = new ethers.Contract(tokenAddress, abi, provider);
-            const bal = await token.balanceOf(targetAddress);
+
+            // Verify contract exists and is an ERC20
+            try {
+              const code = await provider.getCode(tokenAddress);
+              if (code === '0x') {
+                ui.error(`SXXX contract not deployed at ${tokenAddress}`);
+                ui.info('   This may mean the address is incorrect or the network is wrong.');
+                ui.info('   Check: RPC_URL, SXXX_TOKEN_ADDRESS, or run `sage doctor` for diagnostics.');
+                process.exit(1);
+              }
+            } catch (codeErr) {
+              // Ignore code check failure, proceed with balance check
+            }
+
+            let bal;
+            try {
+              bal = await token.balanceOf(targetAddress);
+            } catch (balErr) {
+              const errMsg = balErr.message || String(balErr);
+              if (errMsg.includes('BAD_DATA') || errMsg.includes('could not decode result')) {
+                ui.error(`Contract at ${tokenAddress} returned invalid data for balanceOf()`);
+                ui.info('   This usually means the address is not an ERC20 token contract.');
+                ui.info('   Possible fixes:');
+                ui.info('     - Check SXXX_TOKEN_ADDRESS is correct for your network');
+                ui.info('     - Verify RPC_URL points to the correct chain (Base Sepolia)');
+                ui.info('     - Run `sage doctor` for full diagnostics');
+                process.exit(1);
+              }
+              throw balErr;
+            }
             ui.success(`SXXX Balance for ${ui.formatAddress(targetAddress)}: ${ui.formatToken(bal, { symbol: 'SXXX' })}`);
           } catch (error) {
             handleCLIError('sxxx:balance', error, { exit: true });
@@ -62,7 +95,7 @@ function register(program) {
         .action(async (opts) => {
           try {
             ui.configure({ verbose: opts.verbose });
-            const rpcUrl = cliConfig.resolveRpcUrl();
+            const rpcUrl = cliConfig.resolveRpcUrl({ allowEnv: true });
             const tokenAddress = cliConfig.resolveAddress('SXXX_TOKEN_ADDRESS');
             if (!tokenAddress) throw new Error('SXXX_TOKEN_ADDRESS not set (configure via .env or .sage profile)');
             const provider = new ethers.JsonRpcProvider(rpcUrl);

package/dist/cli/contracts/index.js

@@ -8,7 +8,8 @@
 const { ethers } = require('ethers');
 
 // Default RPC URL
-const DEFAULT_RPC = process.env.RPC_URL
+const DEFAULT_RPC = process.env.SAGE_RPC_URL
+  || process.env.RPC_URL
   || process.env.BASE_SEPOLIA_RPC
   || 'https://base-sepolia.publicnode.com';
 

package/dist/cli/utils/aliases.js

@@ -56,6 +56,8 @@ const COMMAND_CATALOG = {
       'execute',
       'status',
       'inspect',
+      'decode',
+      'summary',
       'watch',
       'power',
       'preflight',
@@ -83,14 +85,22 @@ const COMMAND_CATALOG = {
       'votes',
       'snapshot-power',
       'config',
-      'timelock-info',
-      'authority'
+      'timelock',
+      'authority',
+      // Added missing subcommands
+      'decode',
+      'summary',
+      'cache-show',
+      'last',
+      'cancel',
+      'cancelability'
     ],
     subcommandAliases: {
       ls: 'list',
       exec: 'execute',
       q: 'queue',
-      status: 'status'
+      status: 'status',
+      'timelock-info': 'timelock'
     }
   },
   library: {
@@ -225,6 +235,54 @@ const COMMAND_CATALOG = {
     needsSubcommand: false,
     subcommands: ['list', 'run'],
     subcommandAliases: { ls: 'list' }
+  },
+  nft: {
+    aliases: [],
+    needsSubcommand: true,
+    subcommands: ['doctor', 'list-tiers', 'my-multiplier', 'tier', 'mint', 'public-mint', 'auction'],
+    subcommandAliases: { list: 'list-tiers', tiers: 'list-tiers' }
+  },
+  sbt: {
+    aliases: [],
+    needsSubcommand: true,
+    subcommands: ['list-reasons', 'doctor', 'mint', 'revoke', 'propose-mint', 'propose-revoke'],
+    subcommandAliases: { list: 'list-reasons' }
+  },
+  council: {
+    aliases: [],
+    needsSubcommand: true,
+    subcommands: ['doctor', 'set-config', 'allow', 'show', 'suggest-allowlist', 'exec', 'schedule'],
+    subcommandAliases: { status: 'doctor' }
+  },
+  profile: {
+    aliases: [],
+    needsSubcommand: true,
+    subcommands: ['get', 'set', 'upload', 'interactive'],
+    subcommandAliases: { show: 'get' }
+  },
+  members: {
+    aliases: [],
+    needsSubcommand: true,
+    subcommands: ['list', 'current-stake'],
+    subcommandAliases: {}
+  },
+  multiplier: {
+    aliases: [],
+    needsSubcommand: true,
+    subcommands: ['status', 'calculate', 'describe', 'propose-tier', 'auction'],
+    subcommandAliases: {}
+  },
+  boost: {
+    aliases: [],
+    needsSubcommand: true,
+    subcommands: ['list', 'create', 'set-merkle-root', 'status', 'finalize', 'claim', 'fund'],
+    subcommandAliases: {}
+  },
+  'voting-status': {
+    aliases: [],
+    needsSubcommand: false,
+    subcommands: [],
+    subcommandAliases: {}
   }
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sage-protocol/cli",
-  "version": "0.8.2",
+  "version": "0.8.4",
   "description": "Sage Protocol CLI for managing AI prompt libraries",
   "bin": {
     "sage": "./bin/sage.js"