solforge 0.2.3 → 0.2.5

package/README.md

@@ -1,523 +1,482 @@
-# SolForge – Lightning-Fast Solana Development Server
+# 🔥 SolForge
 
-A blazing-fast, drop-in replacement for `solana-test-validator` built on LiteSVM. Get a full Solana development environment running in under 1 second with comprehensive RPC support and zero configuration.
+> **Lightning-fast Solana localnet for developers** ⚡
+> Drop-in replacement for `solana-test-validator` with sub-second startup and minimal memory footprint.
 
-## 🚀 Why SolForge?
-
-| Feature           | solana-test-validator | SolForge         |
-| ----------------- | --------------------- | ---------------- |
-| **Startup Time**  | 10-30 seconds         | < 1 second       |
-| **Memory Usage**  | 500MB+                | ~50MB            |
-| **Configuration** | Complex setup         | Zero config      |
-| **Airdrops**      | Rate limited          | Unlimited        |
-| **Database**      | Full ledger           | Ephemeral SQLite |
+[![Version](https://img.shields.io/badge/version-0.2.5-blue)](https://github.com/nitishxyz/solforge)
+[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+[![Powered by LiteSVM](https://img.shields.io/badge/powered%20by-LiteSVM-purple)](https://github.com/litesvm/litesvm)
 
 ## ✨ Features
 
-- ⚡ **Sub-second startup** with LiteSVM in-memory execution
-- 🔄 **Drop-in replacement** for solana-test-validator
-- 💧 **Unlimited airdrops** via real faucet transfers
-- 🗃️ **Smart persistence** with ephemeral SQLite + Drizzle
-- 🔌 **WebSocket support** for signature subscriptions
-- 🧰 **Universal compatibility** with Solana CLI, Anchor, @solana/kit, web3.js
-- 📊 **Rich RPC coverage** (90+ methods implemented)
-- 🖥️ **Built-in GUI dashboard** for airdrops, mints, and asset management
-- 🎯 **CLI tools** for tokens, programs, and accounts
+- **⚡ Blazing Fast**: Sub-second startup, ~50MB memory (vs 500MB+ for test-validator)
+- **🔌 Drop-in Compatible**: Works with Solana CLI, Anchor, web3.js, and @solana/kit
+- **💰 Unlimited Airdrops**: Built-in faucet with no rate limits
+- **🎨 Web GUI**: Interactive dashboard for airdrops, minting, and monitoring
+- **📦 Program Cloning**: Import programs and accounts from mainnet
+- **🔄 WebSocket Support**: Real-time transaction subscriptions (in the works)
+ 
 
-## 📦 Installation & Quick Start
+## 🚀 Quick Install
 
-### Option 1: From Source (Recommended)
+### One-Liner Install (Recommended)
 
 ```bash
-# Clone and install
-git clone https://github.com/nitishxyz/solforge
-cd solforge
-bun install
-
-# Start the server
-bun start
-# or with debug logging
-DEBUG_RPC_LOG=1 bun start
+curl -fsSL https://install.solforge.sh | sh
 ```
 
-### Option 2: Compiled Binary (Coming Soon)
+### Manual Install
 
-```bash
-# Download and run
-curl -L https://github.com/nitishxyz/solforge/releases/latest/download/solforge-$(uname -s)-$(uname -m) -o solforge
-chmod +x solforge
-./solforge  # first run guides you through setup
-```
+Download the latest binary from [GitHub Releases](https://github.com/nitishxyz/solforge/releases) and add to your PATH.
 
-### Option 3: CLI Development
+### NPM/Bun Install
 
 ```bash
-# Use the CLI directly
-bun src/cli/main.ts start
-bun src/cli/main.ts config init  # Create sf.config.json
+# Using npm
+npm install -g solforge
+
+# Using bun
+bun install -g solforge
 ```
 
-## 🎯 Usage Examples
+## 🎯 Quick Start
 
-### With Solana CLI
+### 1️⃣ Start the Localnet
 
 ```bash
-# Connect to SolForge
-solana config set -u http://localhost:8899
+solforge
+```
 
-# Get unlimited airdrops
-solana airdrop 1000
+This starts:
 
-# Deploy programs normally
-solana program deploy ./program.so
-```
+- 🌐 **RPC Server**: `http://127.0.0.1:8899`
+- 📡 **WebSocket**: `ws://127.0.0.1:8900`
+- 🎨 **Web GUI**: `http://127.0.0.1:42069`
 
-### With @solana/kit
+### 2️⃣ Configure Solana CLI
 
-```typescript
-import { createSolanaRpc, generateKeyPairSigner, lamports } from "@solana/kit";
+```bash
+solana config set -u http://127.0.0.1:8899
+```
 
-const rpc = createSolanaRpc("http://localhost:8899");
+### 3️⃣ Get Some SOL
 
-// Get account balance
-const { value: balance } = await rpc.getBalance(address).send();
+```bash
+# Using Solana CLI
+solana airdrop 1000
 
-// Request airdrops (no limits!)
-const signature = await rpc
-  .requestAirdrop(
-    address,
-    lamports(1_000_000_000n), // 1 SOL
-  )
-  .send();
+# Using SolForge CLI
+solforge airdrop --to <PUBKEY> --sol 100
 ```
 
-### With web3.js
+## 📚 Command Reference
 
-```typescript
-import { Connection, PublicKey, LAMPORTS_PER_SOL } from "@solana/web3.js";
+### 🔧 Server Commands
 
-const connection = new Connection("http://localhost:8899");
+#### Start Server
 
-// Get account info
-const accountInfo = await connection.getAccountInfo(publicKey);
+```bash
+# Basic start
+solforge start
 
-// Send transaction
-const signature = await connection.sendTransaction(transaction, [keypair]);
-```
+# Custom ports
+solforge start --port 8899 --ws-port 8900
 
-### With Anchor
+# Bind to 0.0.0.0 for LAN access
+solforge start --network
+```
 
-```typescript
-// anchor.toml - use default settings
-[provider]
-cluster = \"http://127.0.0.1:8899\"
-wallet = \"~/.config/solana/id.json\"
+### 💰 Airdrop Commands
 
-// Deploy and test normally
-anchor build
-anchor deploy
-anchor test --skip-local-validator  # SolForge is already running
-```
+#### Send SOL
 
-## 🖥️ GUI Dashboard
+```bash
+# Airdrop to specific address
+solforge airdrop --to <PUBKEY> --sol 100
 
-Solforge ships a dark-mode dashboard that starts alongside the RPC server. By default it listens on `http://127.0.0.1:42069` and provides:
+# Interactive mode
+solforge airdrop
+```
 
-- Quick airdrops and SPL mints via a faucet-aware form.
-- Live RPC metrics (slot, block height, transaction count, blockhash, faucet balance).
-- Tables of cloned programs and token mints with one-click modals to import additional assets.
+### 🪙 Token Commands
 
-### Launching the Dashboard
+#### Create Token
 
 ```bash
-# Run the interactive CLI (starts RPC + GUI)
-bun src/cli/main.ts
+# Interactive token creation
+solforge mint
 
-# Or start directly
-bun src/cli/main.ts start
+# Create new token
+solforge token create --decimals 9 --supply 1000000
 
-# Open the dashboard
-open http://127.0.0.1:42069
-```
+# Clone from mainnet
+solforge token clone <MINT_ADDRESS>
 
-### GUI API Endpoints
+# Adopt mint authority
+solforge token adopt-authority <MINT_ADDRESS>
+```
 
-The GUI server exposes REST endpoints backed by the same JSON-RPC methods:
+### 📦 Program Commands
 
-| Method & Path             | Description                          |
-| ------------------------- | ------------------------------------ |
-| `GET /api/status`         | Aggregated RPC stats + faucet info   |
-| `GET /api/programs`       | List the registered programs         |
-| `GET /api/tokens`         | Detailed SPL mint metadata           |
-| `POST /api/airdrop`       | Proxy to `requestAirdrop`            |
-| `POST /api/mint`          | Proxy to `solforgeMintTo`            |
-| `POST /api/clone/program` | Proxy to program clone helpers       |
-| `POST /api/clone/token`   | Proxy to token clone helpers         |
+#### Clone Program
 
-Override the GUI port via `sf.config.json` (`gui.port`) or `SOLFORGE_GUI_PORT`.
+```bash
+# Clone program from mainnet
+solforge program clone <PROGRAM_ID>
 
-Run `bun run build:css` before `bun run build:bin` to embed the latest Tailwind styles in the standalone binary.
+# Clone with accounts
+solforge program clone <PROGRAM_ID> --with-accounts
 
+# Clone specific accounts
+solforge program accounts clone <PROGRAM_ID> --limit 100
 
-## 🔧 Configuration
+# Load local program
+solforge program load --file ./program.so --id <PROGRAM_ID>
+```
 
-SolForge works with zero configuration, but can be customized via environment variables or config file.
+### ⚙️ Configuration Commands
 
-### Environment Variables
+#### Initialize Config
 
 ```bash
-# Server settings
-export RPC_PORT=8899              # HTTP port (WS uses port+1)
-export DEBUG_RPC_LOG=1            # Log all RPC calls
+# Create default config
+solforge config init
 
-# Database
-export SOLFORGE_DB_MODE=ephemeral # or 'persistent'
-export SOLFORGE_DB_PATH=.solforge/db.db
+# Get config value
+solforge config get server.rpcPort
 
-# Faucet
-export SOLFORGE_FAUCET_LAMPORTS=1000000000000000  # 1M SOL
+# Set config value
+solforge config set server.rpcPort 9999
 ```
 
-### Config File (sf.config.json)
+## 📝 Configuration File
 
-```bash
-# Generate default config
-bun src/cli/main.ts config init
-
-# Edit configuration
-bun src/cli/main.ts config set server.rpcPort 9000
-bun src/cli/main.ts config get server.db.mode
-```
+Create `sf.config.json` in your project root:
 
 ```json
 {
-  \"server\": {
-    \"rpcPort\": 8899,
-    \"wsPort\": 8900,
-    \"db\": {
-      \"mode\": \"ephemeral\",
-      \"path\": \".solforge/db.db\"
-    }
+  "server": {
+    "rpcPort": 8899,
+    "wsPort": 8900,
   },
-  \"svm\": {
-    \"initialLamports\": \"1000000000000000\",
-    \"faucetSOL\": 1000
+  "svm": {
+    "initialLamports": "1000000000000000",
+    "faucetSOL": 1000
   },
-  \"clone\": {
-    \"endpoint\": \"https://api.mainnet-beta.solana.com\",
-    \"programs\": [],
-    \"tokens\": [],
-    \"programAccounts\": []
+  "clone": {
+    "endpoint": "https://api.mainnet-beta.solana.com",
+    "programs": [
+      "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
+      "11111111111111111111111111111111"
+    ],
+    "tokens": ["So11111111111111111111111111111111111111112"],
+    "programAccounts": [
+      {
+        "programId": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
+        "limit": 10
+      }
+    ]
   },
-  \"gui\": {
-    \"enabled\": true,
-    \"port\": 42069
+  "gui": {
+    "enabled": true,
+    "port": 42069
   },
-  \"bootstrap\": {
-    \"airdrops\": []
+  "bootstrap": {
+    "airdrops": [
+      {
+        "address": "YOUR_WALLET_ADDRESS",
+        "amountSol": 100
+      }
+    ]
   }
 }
 ```
 
-## 🛠️ CLI Tools
-
-SolForge includes powerful CLI tools for development:
+### 🔑 Configuration Options
 
-```bash
-# Airdrop SOL to any address
-bun src/cli/main.ts airdrop --to <pubkey> --sol 100
-
-# Interactive token minting
-bun src/cli/main.ts mint
+| Option                | Description                                 | Default                               |
+| --------------------- | ------------------------------------------- | ------------------------------------- |
+| `server.rpcPort`      | HTTP RPC port                               | `8899`                                |
+| `server.wsPort`       | WebSocket port                              | `8900`                                |
+| `server.network`      | Bind to `0.0.0.0` for LAN access            | `false`                               |
+| `svm.initialLamports` | Initial lamports for accounts               | `1000000000000000`                    |
+| `svm.faucetSOL`       | SOL amount per airdrop                      | `1000`                                |
+| `clone.endpoint`      | RPC endpoint for cloning                    | `https://api.mainnet-beta.solana.com` |
+| `clone.programs`      | Program IDs to clone on startup             | `[]`                                  |
+| `clone.tokens`        | Token mints to clone on startup             | `[]`                                  |
+| `gui.enabled`         | Enable web GUI                              | `true`                                |
+| `gui.port`            | GUI port                                    | `42069`                               |
+| `bootstrap.airdrops`  | Auto-airdrops on startup                    | `[]`                                  |
 
-# Clone mainnet programs and data
-bun src/cli/main.ts program clone <program-id>
-bun src/cli/main.ts token clone <mint-address>
+## 🌍 Environment Variables
 
-# Manage configuration
-bun src/cli/main.ts config init
-bun src/cli/main.ts config set server.rpcPort 9000
-```
+Override configuration with environment variables:
 
-## 📡 RPC Method Coverage
-
-### ✅ Fully Implemented (90+ methods)
-
-**Account Operations**
-
-- `getAccountInfo`, `getMultipleAccounts`, `getBalance`
-- `getParsedAccountInfo`, `getProgramAccounts`
+```bash
+# Server settings
+export RPC_PORT=8899
+export SOLFORGE_GUI_PORT=3000
 
-**Transaction Operations**
+# Debug mode
+export DEBUG_RPC_LOG=1  # Log all RPC calls
 
-- `sendTransaction`, `simulateTransaction`, `getTransaction`
-- `getSignatureStatuses`, `getSignaturesForAddress`
+# Start with env vars
+solforge start
+```
 
-**Block & Slot Operations**
+## 🔌 Integration Examples
 
-- `getLatestBlockhash`, `getBlock`, `getBlocks`, `getBlockHeight`
-- `getSlot`, `getSlotLeader`, `getSlotLeaders`
+### Anchor Framework
 
-**System & Network**
+Configure `Anchor.toml`:
 
-- `getHealth`, `getVersion`, `getGenesisHash`, `getEpochInfo`
-- `getSupply`, `getInflationRate`, `getVoteAccounts`
+```toml
+[provider]
+cluster = "http://127.0.0.1:8899"
+wallet = "~/.config/solana/id.json"
 
-**Fee Operations**
+[scripts]
+test = "solforge start && anchor test --skip-local-validator"
+```
 
-- `getFeeForMessage`, `getFees`, `getRecentPrioritizationFees`
+### @solana/web3.js
 
-**WebSocket Subscriptions**
+```javascript
+import { Connection, LAMPORTS_PER_SOL, PublicKey } from "@solana/web3.js";
 
-- `signatureSubscribe/Unsubscribe` ✅ (real-time notifications)
-- Other subscriptions (stubbed but functional)
+const connection = new Connection("http://127.0.0.1:8899", "confirmed");
 
-### ⚠️ Minimal/Stubbed
+// Request airdrop
+const signature = await connection.requestAirdrop(
+  new PublicKey("YOUR_WALLET"),
+  100 * LAMPORTS_PER_SOL,
+);
 
-- Token-specific RPCs (returns defaults unless indexed)
-- Some advanced cluster RPCs (simplified for local dev)
+// Get balance
+const balance = await connection.getBalance(publicKey);
+```
 
-## 💾 Data & Persistence
+### @solana/kit (Recommended)
 
-### Ephemeral Mode (Default)
+```typescript
+import { createSolanaRpc } from "@solana/kit";
+import { address, lamports } from "@solana/web3.js";
 
-- SQLite database recreated on each restart
-- Perfect for testing and development
-- Stores full transaction history during session
+const rpc = createSolanaRpc("http://127.0.0.1:8899");
 
-### Persistent Mode
+// Request airdrop
+await rpc
+  .requestAirdrop(address("YOUR_WALLET"), lamports(1_000_000_000n))
+  .send();
 
-```bash
-# Enable persistent storage
-export SOLFORGE_DB_MODE=persistent
-bun start
+// Get balance
+const balance = await rpc.getBalance(address("YOUR_WALLET")).send();
 ```
 
-### Database Schema
-
-```sql
--- Transactions with full metadata
-CREATE TABLE transactions (
-  signature TEXT PRIMARY KEY,
-  slot INTEGER,
-  raw_transaction BLOB,  -- Full transaction data
-  logs TEXT,            -- JSON array of logs
-  status TEXT,          -- success/error
-  fee INTEGER,
-  timestamp INTEGER
-);
+## 🎨 Web GUI
 
--- Account snapshots
-CREATE TABLE accounts (
-  address TEXT PRIMARY KEY,
-  lamports INTEGER,
-  owner TEXT,
-  data_len INTEGER,
-  last_slot INTEGER
-);
+The built-in GUI provides:
 
--- Address to signature mapping
-CREATE TABLE address_signatures (
-  address TEXT,
-  signature TEXT,
-  slot INTEGER
-);
-```
+- **📊 Dashboard**: Current slot, block height, recent transactions
+- **💸 Airdrop Tool**: Quick SOL distribution interface
+- **🪙 Token Minter**: Create and mint SPL tokens
+- **📈 Status Monitor**: Real-time localnet statistics
 
-## 🔌 WebSocket Support
+Access at: `http://127.0.0.1:42069`
 
-```javascript
-const ws = new WebSocket("ws://localhost:8900");
-
-// Subscribe to signature updates
-ws.send(
-  JSON.stringify({
-    jsonrpc: "2.0",
-    id: 1,
-    method: "signatureSubscribe",
-    params: ["<signature>", { commitment: "confirmed" }],
-  }),
-);
+## 🏗️ Building from Source
 
-// Receive real-time notifications
-ws.onmessage = (event) => {
-  const response = JSON.parse(event.data);
-  console.log("Signature update:", response);
-};
-```
+### Prerequisites
 
-## 🧪 Testing & Validation
+- [Bun](https://bun.sh) runtime installed
+
+### Build Steps
 
 ```bash
-# Run comprehensive test suite
-bun run test-client.ts
+# Clone repository
+git clone https://github.com/nitishxyz/solforge.git
+cd solforge
 
-# Test specific functionality
-bun test
+# Install dependencies
+bun install
 
-# Validate against real programs
-anchor test --skip-local-validator
-```
+# Run from source
+bun src/cli/main.ts start
 
-## 🏗️ Architecture Overview
+# Build binary
+bun run build:bin
 
-```
-SolForge
-├── 🧠 LiteSVM Core           # In-memory execution engine
-├── 🌐 HTTP Server            # JSON-RPC over HTTP
-├── 🔌 WebSocket Server       # Real-time subscriptions
-├── 🗃️ SQLite + Drizzle       # Ephemeral data indexing
-├── 💧 Smart Faucet          # Unlimited SOL distribution
-└── 🎯 CLI Tools             # Developer utilities
+# Build for all platforms
+bun run build:bin:all
 ```
 
-### Key Components
+### Platform-Specific Builds
 
-- **`index.ts`**: Main server entry point
-- **`server/`**: HTTP and WebSocket servers
-- **`server/methods/`**: Modular RPC implementations
-- **`src/cli/`**: Command-line interface
-- **`src/config/`**: Configuration management
-- **`src/db/`**: Database schema and operations
+```bash
+# macOS (Apple Silicon)
+bun run build:bin:darwin-arm64
 
-## 🤝 Development
+# macOS (Intel)
+bun run build:bin:darwin-x64
 
-### Adding New RPC Methods
+# Linux x64
+bun run build:bin:linux-x64
 
-1. Create method file: `server/methods/your-method.ts`
-2. Implement the `RpcMethodHandler` interface
-3. Export from `server/methods/index.ts`
-4. Add to `rpcMethods` object
+# Linux ARM64
+bun run build:bin:linux-arm64
 
-```typescript
-// server/methods/your-method.ts
-import type { RpcMethodHandler } from \"../types\";
-
-export const yourMethod: RpcMethodHandler = (id, params, context) => {
-  try {
-    const result = context.svm.someOperation();
-    return context.createSuccessResponse(id, result);
-  } catch (error: any) {
-    return context.createErrorResponse(id, -32603, \"Internal error\");
-  }
-};
+# Windows
+bun run build:bin:windows-x64
 ```
 
-### Project Structure
+## 🗂️ Project Structure
 
 ```
 solforge/
-├── index.ts                     # Main entry point
-├── server/                      # Core server
-│   ├── rpc-server.ts           # HTTP server
-│   ├── ws-server.ts            # WebSocket server
-│   ├── methods/                # RPC method implementations
-│   │   ├── account/           # Account methods
-│   │   ├── transaction/       # Transaction methods
-│   │   └── index.ts          # Method registry
-│   └── lib/                   # Utilities
-├── src/                       # CLI and config
-│   ├── cli/                  # Command-line interface
-│   ├── config/               # Configuration management
-│   └── db/                   # Database operations
-├── test-client.ts            # Integration tests
-└── docs/                     # Documentation
+├── src/
+│   ├── cli/           # CLI commands and routing
+│   ├── config/        # Configuration management
+│   ├── db/            # Database schemas and operations
+│   ├── rpc/           # RPC server bootstrap
+│   └── gui/           # Web GUI (React)
+├── server/
+│   ├── methods/       # RPC method implementations
+│   ├── lib/           # Shared utilities
+│   └── types.ts       # TypeScript definitions
+├── scripts/           # Build and setup scripts
+└── sf.config.json     # Configuration file
 ```
 
-### Development Guidelines
+## 🔍 Troubleshooting
 
-- Use **Bun exclusively** (no npm/yarn/node)
-- Keep files **under 200 lines** (split when larger)
-- Follow **kebab-case** for filenames
-- Write **comprehensive tests**
-- Use **TypeScript strictly**
+### Port Already in Use
 
-## 🐛 Troubleshooting
+```bash
+# Use different port
+solforge start --port 9999
 
-### Common Issues
+# Or update config
+solforge config set server.rpcPort 9999
+```
 
-**Server won't start**
+### GUI Not Loading
 
 ```bash
-# Check if port is in use
-lsof -i :8899
+# Check if port is available
+lsof -i :42069
 
-# Use different port
-RPC_PORT=9000 bun start
+# Use different GUI port
+export SOLFORGE_GUI_PORT=3000
+solforge start
 ```
 
-**Anchor deploy fails**
+
+
+### Connection Refused
 
 ```bash
-# Ensure relaxed validation (default)
+# Verify server is running
+curl http://127.0.0.1:8899/health
+
 # Check logs with debug mode
-DEBUG_RPC_LOG=1 bun start
+DEBUG_RPC_LOG=1 solforge start
 ```
 
-**WebSocket connection issues**
+## 📊 Performance Comparison
 
-```bash
-# WebSocket runs on RPC_PORT + 1
-# Default: ws://localhost:8900
-```
+| Metric           | SolForge | solana-test-validator |
+| ---------------- | -------- | --------------------- |
+| Startup Time     | < 1s     | 10-30s                |
+| Memory Usage     | ~50MB    | 500MB+                |
+| CPU Usage (idle) | < 1%     | 5-10%                 |
+| Airdrop Speed    | Instant  | Rate limited          |
+| Program Deploy   | < 100ms  | 1-2s                  |
+
+## 🤝 Contributing
+
+We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
 
-**Airdrop not working**
+### Development Workflow
 
 ```bash
-# Check faucet was created
-ls .solforge/faucet.json
+# Run tests
+bun test
+
+# Lint code
+bun run lint
 
-# Manual airdrop via CLI
-bun src/cli/main.ts airdrop --to <address> --sol 10
+# Format code
+bun run format
 ```
 
-## 🔮 Roadmap
+## 📚 API Coverage
 
-### v0.3.0 - Enhanced RPC Coverage
+### ✅ Fully Implemented (90+ methods)
 
-- [ ] Complete token RPC implementations
-- [ ] Advanced subscription support
-- [ ] Improved error handling
+- Account operations
+- Transaction submission/simulation
+- Block/slot queries
+- Token operations
+- Program deployment
+- WebSocket subscriptions (signatures)
 
-### v0.4.0 - Developer Experience
+### 🚧 Partial Support
 
-- [ ] Web-based dashboard
-- [ ] Time-travel debugging
-- [ ] Snapshot/restore functionality
+- Stake operations
+- Vote accounts
+- Advanced subscriptions
 
-### v0.5.0 - Production Features
+### 📋 Planned
 
-- [ ] Clustering support
-- [ ] Metrics and monitoring
-- [ ] Plugin architecture
+- Snapshot/restore
+- Time-travel debugging
+- Multi-tenant support
 
-## 📄 License
+## 🛠️ Advanced Usage
 
-MIT License - see LICENSE file for details.
+### Custom Program Development
 
-## 🤝 Contributing
+```bash
+# Deploy custom program
+solana program deploy ./my-program.so
 
-We welcome contributions! Please see:
+# Clone and modify existing program
+solforge program clone <PROGRAM_ID>
+```
 
-- [AGENTS.md](./AGENTS.md) - Development guidelines
-- [PROJECT_STRUCTURE.md](./PROJECT_STRUCTURE.md) - Architecture details
-- [SOLFORGE.md](./SOLFORGE.md) - Vision and roadmap
+### CI/CD Integration
 
-## 🙏 Acknowledgments
+```yaml
+# GitHub Actions example
+- name: Setup SolForge
+  run: |
+    curl -fsSL https://install.solforge.sh | sh
+    solforge start &
+    sleep 2
 
-Built with ❤️ using:
+- name: Run Tests
+  run: |
+    anchor test --skip-local-validator
+```
 
-- [LiteSVM](https://github.com/litesvm/litesvm) - Fast Solana VM
-- [Bun](https://bun.sh) - Lightning-fast JavaScript runtime
-- [Drizzle](https://drizzle.team) - TypeScript SQL toolkit
+## 📄 License
 
----
+MIT License - see [LICENSE](LICENSE) file for details.
 
-**⚡ Ready to build on Solana at lightning speed?**
+## 🔗 Links
 
-```bash
-git clone https://github.com/nitishxyz/solforge
-cd solforge && bun install && bun start
-```
+- **GitHub**: [github.com/nitishxyz/solforge](https://github.com/nitishxyz/solforge)
+- **Issues**: [Report bugs or request features](https://github.com/nitishxyz/solforge/issues)
+- **Discord**: [Join our community](#) _(coming soon)_
+
+## 🙏 Acknowledgments
+
+- Built on [LiteSVM](https://github.com/litesvm/litesvm) - Fast SVM implementation
+- Powered by [Bun](https://bun.sh) - All-in-one JavaScript runtime
+- Inspired by the Solana developer community
+
+---
 
-_Happy coding! 🦀_
+<p align="center">
+  Made with ❤️ for Solana developers
+</p>