solana-balance-cli 1.0.1 → 1.1.0

package/README.md

@@ -2,6 +2,8 @@
 
 A simple command-line tool to check your Solana wallet balance in both SOL and USD.
 
+**Package:** `solana-balance-cli` | **Command:** `sol-balance`
+
 ## Features
 
 - ✅ Fetch real-time Solana wallet balance
@@ -144,6 +146,14 @@ This will prompt you to:
 
 This creates a changeset file in `.changeset/` that describes your changes.
 
+**After creating a changeset, commit and push it:**
+
+```bash
+git add .changeset/
+git commit -m "chore: add changeset"
+git push
+```
+
 #### Versioning and Publishing
 
 To create a new version and update the changelog:
@@ -158,6 +168,14 @@ This will:
 - Generate/update `CHANGELOG.md`
 - Remove used changeset files
 
+**After versioning, commit the changes:**
+
+```bash
+git add .
+git commit -m "chore: version bump"
+git push
+```
+
 To publish to npm:
 
 ```bash
@@ -172,6 +190,9 @@ Or you can publish manually after versioning:
 
 ```bash
 npm run version
+git add .
+git commit -m "chore: version bump"
+git push
 npm publish
 ```
 

package/dist/index.js

@@ -4,13 +4,20 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
 const solana_1 = require("./solana");
 const price_1 = require("./price");
+const tokens_1 = require("./tokens");
+const watch_1 = require("./watch");
 const program = new commander_1.Command();
 program
     .name('sol-balance')
     .description('Check Solana wallet balance in SOL and USD')
-    .version('1.0.0')
+    .version('1.0.0');
+// Balance check command
+program
+    .command('balance')
+    .description('Check Solana wallet balance')
     .argument('<wallet-address>', 'Solana wallet address to check')
-    .action(async (walletAddress) => {
+    .option('-t, --tokens', 'Show SPL token balances and their USD values')
+    .action(async (walletAddress, options) => {
     try {
         console.log('\n🔍 Fetching wallet balance...\n');
         const [balance, price] = await Promise.all([
@@ -21,9 +28,46 @@ program
         console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
         console.log(`📍 Wallet: ${walletAddress}`);
         console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-        console.log(`💰 Balance: ${balance.toFixed(4)} SOL`);
-        console.log(`💵 SOL Price: $${price.toFixed(2)} USD`);
-        console.log(`💸 USD Value: $${usdValue.toFixed(2)} USD`);
+        console.log(`💰 SOL Balance: ${balance.toFixed(4)} SOL`);
+        console.log(`💵 SOL Price: ${price.toFixed(2)} USD`);
+        console.log(`💸 SOL Value: ${usdValue.toFixed(2)} USD`);
+        if (options.tokens) {
+            console.log('\n🪙 Fetching SPL tokens...\n');
+            const tokenAccounts = await (0, tokens_1.getTokenAccounts)(walletAddress);
+            if (tokenAccounts.length === 0) {
+                console.log('No SPL tokens found in this wallet.');
+            }
+            else {
+                const mintAddresses = tokenAccounts.map(token => token.mint);
+                const tokenPrices = await (0, price_1.getTokenPrices)(mintAddresses);
+                let totalTokenValue = 0;
+                console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+                console.log('SPL TOKENS:');
+                console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+                for (const token of tokenAccounts) {
+                    const tokenPrice = tokenPrices.get(token.mint) || 0;
+                    const tokenValue = token.uiAmount * tokenPrice;
+                    totalTokenValue += tokenValue;
+                    console.log(`\n🔹 Token: ${token.mint}`);
+                    console.log(`   Balance: ${token.uiAmount.toFixed(token.decimals)} tokens`);
+                    if (tokenPrice > 0) {
+                        console.log(`   Price: ${tokenPrice.toFixed(6)} USD`);
+                        console.log(`   Value: ${tokenValue.toFixed(2)} USD`);
+                    }
+                    else {
+                        console.log(`   Price: Not available`);
+                        console.log(`   Value: $0.00 USD`);
+                    }
+                }
+                const totalPortfolioValue = usdValue + totalTokenValue;
+                console.log('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+                console.log('PORTFOLIO SUMMARY:');
+                console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+                console.log(`💰 Total SOL Value: ${usdValue.toFixed(2)} USD`);
+                console.log(`🪙 Total Token Value: ${totalTokenValue.toFixed(2)} USD`);
+                console.log(`💎 Total Portfolio Value: ${totalPortfolioValue.toFixed(2)} USD`);
+            }
+        }
         console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n');
     }
     catch (error) {
@@ -36,4 +80,46 @@ program
         process.exit(1);
     }
 });
+// Watch price command
+program
+    .command('watch')
+    .description('Watch SOL price and send notifications when it crosses target prices')
+    .option('--above <price>', 'Send notification when price goes above this value', parseFloat)
+    .option('--below <price>', 'Send notification when price goes below this value', parseFloat)
+    .option('--interval <seconds>', 'Price check interval in seconds (default: 60)', parseFloat, 60)
+    .action(async (options) => {
+    try {
+        // Validate options
+        if (!options.above && !options.below) {
+            console.error('\n❌ Error: You must specify at least one target price (--above or --below)\n');
+            process.exit(1);
+        }
+        if (options.above && isNaN(options.above)) {
+            console.error('\n❌ Error: --above must be a valid number\n');
+            process.exit(1);
+        }
+        if (options.below && isNaN(options.below)) {
+            console.error('\n❌ Error: --below must be a valid number\n');
+            process.exit(1);
+        }
+        if (isNaN(options.interval) || options.interval < 1) {
+            console.error('\n❌ Error: --interval must be a number >= 1\n');
+            process.exit(1);
+        }
+        if (options.above && options.below && options.above <= options.below) {
+            console.error('\n❌ Error: --above price must be greater than --below price\n');
+            process.exit(1);
+        }
+        await (0, watch_1.watchSolanaPrice)(options);
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            console.error(`\n❌ Error: ${error.message}\n`);
+        }
+        else {
+            console.error('\n❌ An unknown error occurred\n');
+        }
+        process.exit(1);
+    }
+});
 program.parse();

package/dist/price.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getSolanaPrice = getSolanaPrice;
+exports.getTokenPrices = getTokenPrices;
 const axios_1 = __importDefault(require("axios"));
 async function getSolanaPrice() {
     try {
@@ -21,3 +22,46 @@ async function getSolanaPrice() {
         throw new Error('Failed to fetch SOL price: Unknown error');
     }
 }
+async function getTokenPrices(mintAddresses) {
+    try {
+        if (mintAddresses.length === 0) {
+            return new Map();
+        }
+        const priceMap = new Map();
+        const batchSize = 50; // Limit batch size to avoid URI too long error
+        // Process tokens in batches
+        for (let i = 0; i < mintAddresses.length; i += batchSize) {
+            const batch = mintAddresses.slice(i, i + batchSize);
+            const contractAddresses = batch.join(',');
+            try {
+                const response = await axios_1.default.get(`https://api.coingecko.com/api/v3/simple/token_price/solana?contract_addresses=${contractAddresses}&vs_currencies=usd`, { timeout: 10000 });
+                for (const mint of batch) {
+                    const mintLower = mint.toLowerCase();
+                    if (response.data[mintLower] && typeof response.data[mintLower].usd === 'number') {
+                        priceMap.set(mint, response.data[mintLower].usd);
+                    }
+                    else {
+                        priceMap.set(mint, 0);
+                    }
+                }
+            }
+            catch (batchError) {
+                // If batch fails, set all tokens in batch to 0 price
+                for (const mint of batch) {
+                    priceMap.set(mint, 0);
+                }
+            }
+            // Small delay between batches to avoid rate limiting
+            if (i + batchSize < mintAddresses.length) {
+                await new Promise(resolve => setTimeout(resolve, 200));
+            }
+        }
+        return priceMap;
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw new Error(`Failed to fetch token prices: ${error.message}`);
+        }
+        throw new Error('Failed to fetch token prices: Unknown error');
+    }
+}

package/dist/tokens.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTokenAccounts = getTokenAccounts;
+const web3_js_1 = require("@solana/web3.js");
+const spl_token_1 = require("@solana/spl-token");
+async function getTokenAccounts(walletAddress) {
+    try {
+        const connection = new web3_js_1.Connection('https://api.mainnet-beta.solana.com', 'confirmed');
+        const publicKey = new web3_js_1.PublicKey(walletAddress);
+        const tokenAccounts = await connection.getParsedTokenAccountsByOwner(publicKey, { programId: spl_token_1.TOKEN_PROGRAM_ID });
+        const tokens = tokenAccounts.value
+            .map((accountInfo) => {
+            const parsedInfo = accountInfo.account.data.parsed.info;
+            const tokenAmount = parsedInfo.tokenAmount;
+            // Only include tokens with non-zero balance
+            if (tokenAmount.uiAmount > 0) {
+                return {
+                    mint: parsedInfo.mint,
+                    balance: parseInt(tokenAmount.amount),
+                    decimals: tokenAmount.decimals,
+                    uiAmount: tokenAmount.uiAmount,
+                };
+            }
+            return null;
+        })
+            .filter((token) => token !== null);
+        return tokens;
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw new Error(`Failed to fetch token accounts: ${error.message}`);
+        }
+        throw new Error('Failed to fetch token accounts: Unknown error');
+    }
+}

package/dist/watch.js

@@ -0,0 +1,85 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.watchSolanaPrice = watchSolanaPrice;
+const node_notifier_1 = __importDefault(require("node-notifier"));
+const price_1 = require("./price");
+async function watchSolanaPrice(options) {
+    const { above, below, interval } = options;
+    console.log('\n🔔 Starting SOL Price Watch Mode\n');
+    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.log('⚙️  Configuration:');
+    if (above) {
+        console.log(`   📈 Alert when price goes ABOVE: $${above.toFixed(2)}`);
+    }
+    if (below) {
+        console.log(`   📉 Alert when price goes BELOW: $${below.toFixed(2)}`);
+    }
+    console.log(`   ⏱️  Check interval: ${interval} seconds`);
+    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.log('\n💡 Press Ctrl+C to stop watching\n');
+    const state = {
+        aboveNotified: false,
+        belowNotified: false,
+    };
+    let isRunning = true;
+    // Handle graceful shutdown
+    process.on('SIGINT', () => {
+        console.log('\n\n👋 Stopping price watch...\n');
+        isRunning = false;
+        process.exit(0);
+    });
+    // Main watch loop
+    while (isRunning) {
+        try {
+            const currentPrice = await (0, price_1.getSolanaPrice)();
+            const timestamp = new Date().toLocaleTimeString();
+            console.log(`[${timestamp}] 💰 Current SOL Price: $${currentPrice.toFixed(2)}`);
+            // Check above threshold
+            if (above && currentPrice >= above && !state.aboveNotified) {
+                const message = `SOL crossed $${above.toFixed(2)} (currently $${currentPrice.toFixed(2)})`;
+                node_notifier_1.default.notify({
+                    title: '🚀 SOL Price Alert - Above Target',
+                    message: message,
+                    sound: true,
+                    wait: false,
+                });
+                console.log(`\n🔔 ALERT: ${message}\n`);
+                state.aboveNotified = true;
+            }
+            // Check below threshold
+            if (below && currentPrice <= below && !state.belowNotified) {
+                const message = `SOL dropped below $${below.toFixed(2)} (currently $${currentPrice.toFixed(2)})`;
+                node_notifier_1.default.notify({
+                    title: '📉 SOL Price Alert - Below Target',
+                    message: message,
+                    sound: true,
+                    wait: false,
+                });
+                console.log(`\n🔔 ALERT: ${message}\n`);
+                state.belowNotified = true;
+            }
+            // Reset notification states when price moves back
+            if (above && currentPrice < above) {
+                state.aboveNotified = false;
+            }
+            if (below && currentPrice > below) {
+                state.belowNotified = false;
+            }
+            // Wait for the specified interval
+            await new Promise(resolve => setTimeout(resolve, interval * 1000));
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                console.error(`❌ Error fetching price: ${error.message}`);
+            }
+            else {
+                console.error('❌ Unknown error occurred');
+            }
+            // Wait before retrying
+            await new Promise(resolve => setTimeout(resolve, interval * 1000));
+        }
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "solana-balance-cli",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "CLI tool to check Solana wallet balance in SOL and USD",
   "main": "dist/index.js",
   "bin": {
@@ -40,9 +40,12 @@
     "url": ""
   },
   "dependencies": {
+    "@solana/spl-token": "^0.4.14",
     "@solana/web3.js": "^1.98.4",
+    "@types/node-notifier": "^8.0.5",
     "axios": "^1.13.2",
-    "commander": "^14.0.2"
+    "commander": "^14.0.2",
+    "node-notifier": "^10.0.1"
   },
   "devDependencies": {
     "@changesets/cli": "^2.29.8",