solana-balance-cli 1.0.1

package/LICENSE

@@ -0,0 +1,16 @@
+ISC License
+
+Copyright (c) 2024
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+

package/README.md

@@ -0,0 +1,180 @@
+# Solana Balance CLI
+
+A simple command-line tool to check your Solana wallet balance in both SOL and USD.
+
+## Features
+
+- ✅ Fetch real-time Solana wallet balance
+- ✅ Display balance in SOL
+- ✅ Convert balance to USD using live price data from CoinGecko
+- ✅ Clean, formatted output
+- ✅ Error handling for invalid addresses
+
+## Installation
+
+### Install from npm (Recommended)
+
+```bash
+npm install -g solana-balance-cli
+```
+
+### Install locally
+
+```bash
+npm install solana-balance-cli
+```
+
+### Development Installation
+
+```bash
+git clone <repository-url>
+cd solana-balance-cli
+npm install
+npm run build
+```
+
+## Usage
+
+### Global Installation
+
+After installing globally, you can use the `sol-balance` command from anywhere:
+
+```bash
+sol-balance <WALLET_ADDRESS>
+```
+
+### Local Installation
+
+If installed locally, use it with npx:
+
+```bash
+npx sol-balance <WALLET_ADDRESS>
+```
+
+Or add it to your package.json scripts:
+
+```json
+{
+  "scripts": {
+    "check-balance": "sol-balance"
+  }
+}
+```
+
+### Example
+
+```bash
+sol-balance CuieVDEDtLo7FypA9SbLM9saXFdb1dsshEkyErMqkRQq
+```
+
+### Output
+
+```
+🔍 Fetching wallet balance...
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📍 Wallet: CuieVDEDtLo7FypA9SbLM9saXFdb1dsshEkyErMqkRQq
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+💰 Balance: 0.0057 SOL
+💵 SOL Price: $123.23 USD
+💸 USD Value: $0.71 USD
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## Global Installation (Optional)
+
+To use the tool globally as `sol-balance`:
+
+```bash
+npm link
+```
+
+Then you can run:
+
+```bash
+sol-balance <WALLET_ADDRESS>
+```
+
+## Technologies Used
+
+- **TypeScript** - Type-safe development
+- **@solana/web3.js** - Solana blockchain interaction
+- **axios** - HTTP requests for price data
+- **commander** - CLI framework
+- **CoinGecko API** - Real-time SOL/USD price data
+
+## Project Structure
+
+```
+solana-balance-cli/
+├── src/
+│   ├── index.ts      # Main CLI entry point
+│   ├── solana.ts     # Solana balance fetching logic
+│   └── price.ts      # USD price fetching logic
+├── dist/             # Compiled JavaScript output
+├── package.json
+├── tsconfig.json
+└── README.md
+```
+
+## Error Handling
+
+The tool handles various error scenarios:
+- Invalid wallet addresses
+- Network connection issues
+- API failures
+
+## Development
+
+### Version Management
+
+This project uses [Changesets](https://github.com/changesets/changesets) for version management and changelog generation.
+
+#### Creating a Changeset
+
+When you make changes that should be released:
+
+```bash
+npm run changeset
+```
+
+This will prompt you to:
+1. Select the type of change (major, minor, patch)
+2. Write a summary of the changes
+
+This creates a changeset file in `.changeset/` that describes your changes.
+
+#### Versioning and Publishing
+
+To create a new version and update the changelog:
+
+```bash
+npm run version
+```
+
+This will:
+- Read all changesets
+- Update the version in `package.json`
+- Generate/update `CHANGELOG.md`
+- Remove used changeset files
+
+To publish to npm:
+
+```bash
+npm run release
+```
+
+This will:
+- Build the project
+- Publish to npm using changesets
+
+Or you can publish manually after versioning:
+
+```bash
+npm run version
+npm publish
+```
+
+## License
+
+ISC

package/dist/index.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const solana_1 = require("./solana");
+const price_1 = require("./price");
+const program = new commander_1.Command();
+program
+    .name('sol-balance')
+    .description('Check Solana wallet balance in SOL and USD')
+    .version('1.0.0')
+    .argument('<wallet-address>', 'Solana wallet address to check')
+    .action(async (walletAddress) => {
+    try {
+        console.log('\n🔍 Fetching wallet balance...\n');
+        const [balance, price] = await Promise.all([
+            (0, solana_1.getSolanaBalance)(walletAddress),
+            (0, price_1.getSolanaPrice)()
+        ]);
+        const usdValue = balance * price;
+        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('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n');
+    }
+    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

@@ -0,0 +1,23 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSolanaPrice = getSolanaPrice;
+const axios_1 = __importDefault(require("axios"));
+async function getSolanaPrice() {
+    try {
+        const response = await axios_1.default.get('https://api.coingecko.com/api/v3/simple/price?ids=solana&vs_currencies=usd');
+        const price = response.data.solana.usd;
+        if (typeof price !== 'number') {
+            throw new Error('Invalid price data received');
+        }
+        return price;
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw new Error(`Failed to fetch SOL price: ${error.message}`);
+        }
+        throw new Error('Failed to fetch SOL price: Unknown error');
+    }
+}

package/dist/solana.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSolanaBalance = getSolanaBalance;
+const web3_js_1 = require("@solana/web3.js");
+async function getSolanaBalance(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 balanceInLamports = await connection.getBalance(publicKey);
+        const balanceInSol = balanceInLamports / web3_js_1.LAMPORTS_PER_SOL;
+        return balanceInSol;
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw new Error(`Failed to fetch Solana balance: ${error.message}`);
+        }
+        throw new Error('Failed to fetch Solana balance: Unknown error');
+    }
+}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "solana-balance-cli",
+  "version": "1.0.1",
+  "description": "CLI tool to check Solana wallet balance in SOL and USD",
+  "main": "dist/index.js",
+  "bin": {
+    "sol-balance": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc && node dist/index.js",
+    "prepublishOnly": "npm run build",
+    "changeset": "changeset",
+    "version": "changeset version",
+    "release": "npm run build && changeset publish"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "solana",
+    "wallet",
+    "balance",
+    "cli",
+    "cryptocurrency",
+    "blockchain",
+    "sol"
+  ],
+  "author": "",
+  "license": "ISC",
+  "type": "commonjs",
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "dependencies": {
+    "@solana/web3.js": "^1.98.4",
+    "axios": "^1.13.2",
+    "commander": "^14.0.2"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.29.8",
+    "@types/node": "^25.0.3",
+    "typescript": "^5.9.3"
+  }
+}