solforge 0.1.5 → 0.1.6

package/README.md

@@ -1,5 +1,8 @@
 # SolForge
 
+[![npm version](https://badge.fury.io/js/solforge.svg)](https://badge.fury.io/js/solforge)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
 **SolForge** is a powerful Solana localnet orchestration tool that simplifies the process of setting up and managing local Solana development environments. It allows you to clone mainnet programs and tokens to your local validator, making it easy to develop and test Solana applications with real-world data.
 
 ## ✨ Features
@@ -15,15 +18,27 @@
 - 🎨 **Beautiful CLI** - Colorful, intuitive command-line interface
 - 🌐 **REST API** - Background API server for programmatic access to validator operations
 
-## 🚀 Quick Start
+## 📦 Installation
 
 ### Prerequisites
 
-- [Bun](https://bun.sh) runtime
 - [Solana CLI tools](https://docs.solana.com/cli/install-solana-cli-tools) installed and configured
-- Node.js 18+ (for compatibility)
+- Node.js 18+ or [Bun](https://bun.sh) runtime
 
-### Installation
+### Install from npm (Recommended)
+
+```bash
+# Install globally with npm
+npm install -g solforge
+
+# Or with bun
+bun install -g solforge
+
+# Or with yarn
+yarn global add solforge
+```
+
+### Install from Source
 
 ```bash
 # Clone the repository
@@ -33,14 +48,20 @@ cd solforge
 # Install dependencies
 bun install
 
-# Build the project
-bun run build
+# Build and install globally
+bun run build:npm
+npm install -g .
+```
 
-# Install globally (optional)
-bun run build:binary
-bun run install:binary
+### Verify Installation
+
+```bash
+solforge --version
+solforge --help
 ```
 
+## 🚀 Quick Start
+
 ### Basic Usage
 
 1. **Initialize a new project**:
@@ -78,8 +99,8 @@ solforge start
 # API available at http://127.0.0.1:3000/api
 curl http://127.0.0.1:3000/api/health
 
-# Mint tokens via API
-curl -X POST http://127.0.0.1:3000/api/tokens/USDC/mint \
+# Mint tokens via API (using mint address)
+curl -X POST http://127.0.0.1:3000/api/tokens/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v/mint \
   -H "Content-Type: application/json" \
   -d '{"walletAddress": "YOUR_WALLET_ADDRESS", "amount": 1000}'
 
@@ -121,11 +142,14 @@ Start a localnet validator with the current configuration.
 ```bash
 solforge start                # Start with default settings
 solforge start --debug        # Start with debug logging
+solforge start --network      # Make API server accessible over network
+solforge start --debug --network  # Debug mode + network access
 ```
 
 **Options:**
 
 - `--debug` - Enable debug logging to see detailed command output
+- `--network` - Make API server accessible over network (binds to 0.0.0.0 instead of 127.0.0.1)
 
 #### `solforge list`
 
@@ -228,6 +252,25 @@ When run without arguments, `solforge mint` will:
 - Prompt for amount to mint
 - Handle SPL token account creation automatically
 
+#### `solforge api-server [options]`
+
+Start the API server as a standalone service (without validator).
+
+```bash
+solforge api-server                                    # Start on default port 3000
+solforge api-server --port 8080                       # Custom port
+solforge api-server --host 0.0.0.0                    # Network accessible
+solforge api-server --rpc-url http://localhost:8899   # Custom RPC
+```
+
+**Options:**
+
+- `-p, --port <port>` - Port for API server (default: 3000)
+- `--host <host>` - Host to bind to (default: 127.0.0.1, use 0.0.0.0 for network access)
+- `--rpc-url <url>` - Validator RPC URL (default: http://127.0.0.1:8899)
+- `--faucet-url <url>` - Validator faucet URL (default: http://127.0.0.1:9900)
+- `--work-dir <dir>` - Work directory (default: ./.solforge)
+
 #### `solforge reset`
 
 Reset localnet ledger (coming soon).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "solforge",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "Solana localnet orchestration tool for cloning mainnet programs and tokens",
   "module": "index.ts",
   "type": "module",

package/src/commands/start.ts

@@ -593,7 +593,7 @@ export async function startCommand(
       );
       console.log(
         chalk.gray(
-          `  - POST http://${endpointHost}:${apiServerPort}/api/tokens/{symbol}/mint - Mint tokens`
+          `  - POST http://${endpointHost}:${apiServerPort}/api/tokens/{mintAddress}/mint - Mint tokens`
         )
       );
       console.log(

package/src/services/api-server.ts

@@ -122,9 +122,9 @@ export class APIServer {
     });
 
     // Mint tokens to a wallet
-    router.post("/tokens/:symbol/mint", async (req, res) => {
+    router.post("/tokens/:mintAddress/mint", async (req, res) => {
       try {
-        const { symbol } = req.params;
+        const { mintAddress } = req.params;
         const { walletAddress, amount } = req.body;
 
         if (!walletAddress || !amount) {
@@ -133,6 +133,15 @@ export class APIServer {
           });
         }
 
+        // Validate mint address
+        try {
+          new PublicKey(mintAddress);
+        } catch {
+          return res.status(400).json({
+            error: "Invalid mint address",
+          });
+        }
+
         // Validate wallet address
         try {
           new PublicKey(walletAddress);
@@ -150,7 +159,7 @@ export class APIServer {
         }
 
         const result = await this.mintTokenToWallet(
-          symbol,
+          mintAddress,
           walletAddress,
           amount
         );
@@ -327,17 +336,19 @@ export class APIServer {
   }
 
   private async mintTokenToWallet(
-    symbol: string,
+    mintAddress: string,
     walletAddress: string,
     amount: number
   ): Promise<any> {
     const clonedTokens = await this.getClonedTokens();
     const token = clonedTokens.find(
-      (t) => t.config.symbol.toLowerCase() === symbol.toLowerCase()
+      (t) => t.config.mainnetMint === mintAddress
     );
 
     if (!token) {
-      throw new Error(`Token ${symbol} not found in cloned tokens`);
+      throw new Error(
+        `Token with mint address ${mintAddress} not found in cloned tokens`
+      );
     }
 
     // Use the shared minting function from the mint command