forge-solana-sdk 2.1.3 → 2.2.0

package/README.md

@@ -1,10 +1,12 @@
-# FORGE SDK
+# FORGE
 
 ![npm](https://img.shields.io/npm/v/forge-solana-sdk)
 ![npm](https://img.shields.io/npm/dm/forge-solana-sdk)
 ![License](https://img.shields.io/npm/l/forge-solana-sdk)
 
-Intent-driven app assembly on Solana. Infrastructure that survives.
+**Intent-driven Solana program assembly.** Generate production-ready Anchor programs from natural language. Modern CPI helpers included.
+
+> ⚡ **FORGE generates code, not excuses.**
 
 ## ⚡ Install
 
@@ -16,7 +18,15 @@ npm install -g forge-solana-sdk
 
 ### Initialize a project
 ```bash
+# Basic project
 forge init my-project
+
+# With intent-driven CPI generation
+forge init my-project --intent "transfer 100 tokens safely"
+
+# With specific Anchor version
+forge init my-project --anchor-version 0.31.0
+
 cd my-project
 ```
 
@@ -25,27 +35,159 @@ cd my-project
 forge status
 ```
 
+Enhanced status checks include:
+- ✅ Version compatibility warnings
+- ✅ Rust edition 2024 requirements
+- ✅ Anchor CLI vs project version matching
+- ✅ Network configuration
+
+### Generate TypeScript SDK
+```bash
+forge generate-sdk
+
+# Or specify custom output directory
+forge generate-sdk ./my-sdk
+```
+
 ### Deploy to Solana
 ```bash
 forge deploy
 ```
 
+### Update FORGE
+```bash
+forge update
+```
+
+**Smart Update System:**
+- ✅ Checks current vs latest version
+- ✅ Auto-updates via npm when needed
+- ✅ Shows clear progress feedback
+- ✅ No manual version management required
+
 ## 📋 Prerequisites
 
 - **Node.js** 18+
-- **Rust** 1.70+
+- **Rust** 1.85.0+ (required for edition 2024 compatibility)
 - **Solana CLI** (latest)
-- **Anchor CLI** 0.29.0
+- **Anchor CLI** 0.29.0+
+
+⚠️ **Important**: Rust 1.85.0+ is required for modern Anchor dependencies. Update with: `rustup update stable`
 
 ## 🎯 What FORGE Does
 
-FORGE generates production-ready Anchor programs from intent. It creates the boilerplate so you focus on business logic.
+FORGE transforms natural language intents into production-ready Solana programs. Modern, safe, and future-proof code generation.
+
+### Core Features
+- ✅ **Intent-Driven Generation**: `"transfer 100 tokens safely"` → Modern CPI code
+- ✅ **Complete Anchor Workspace**: Ready-to-build projects with proper structure
+- ✅ **Client SDK Generation**: Auto-generated TypeScript SDK for program interaction
+- ✅ **Modern CPI Helpers**: `transfer_checked`, `mint_to`, PDA signers with `ctx.bumps`
+- ✅ **Version Compatibility**: Auto-aligns Anchor versions (CLI vs project)
+- ✅ **Production Ready**: IDL features, proper dependencies, deployment configs
+
+### Generated Code Quality
+- 🔒 **Safe Operations**: Uses `anchor_spl::token_interface` for Token & Token-2022
+- 🎯 **Modern Patterns**: `InterfaceAccount`, `Interface` types (Anchor 0.31+ compatible)
+- ⚡ **Optimized**: Minimal boilerplate, maximum functionality
+- 🚀 **Future-Proof**: Edition 2024 compatible, latest Anchor best practices
+
+### Supported CPI Intents
+- 💸 **Token Transfers**: `"transfer 100 tokens safely"` → `transfer_checked`
+- 🪙 **Token Minting**: `"mint 500 tokens to user"` → `mint_to` with PDA authority
+- 🎫 **ATA Creation**: `"create associated token account"` → `create_associated_token_account`
+- 📊 **Token Metadata**: `"create metadata for token"` → MPL Token Metadata CPIs
+
+**Example Generated Code:**
+```rust
+// From: forge init --intent "transfer 100 tokens safely"
+token_interface::transfer_checked(
+    CpiContext::new(
+        ctx.accounts.token_program.to_account_info(),
+        TransferChecked {
+            from: ctx.accounts.from.to_account_info(),
+            to: ctx.accounts.to.to_account_info(),
+            authority: ctx.accounts.authority.to_account_info(),
+            mint: ctx.accounts.mint.to_account_info(),
+        },
+    ),
+    100, // amount
+    decimals, // automatic decimals lookup
+)?;
+```
+
+**Client SDK Generated:**
+```typescript
+// Auto-generated TypeScript client
+const client = new TokenTransferClient(connection, wallet);
+await client.transferTokens(amount, from, to, mint, authority);
+```
+
+## 🚀 SDK Generation
+
+FORGE can automatically generate production-ready TypeScript SDKs from your Anchor programs. The generated SDK includes:
+
+- **Type-Safe Client**: Full TypeScript client with proper types for all instructions and accounts
+- **PDA Helpers**: Utility functions to find program-derived addresses
+- **Package Template**: Ready-to-publish npm package with proper dependencies
+- **Modern Standards**: Uses latest Anchor patterns and best practices
+
+### SDK Features
+
+- ✅ **Zero-config generation** from Anchor IDL
+- ✅ **Type-safe method calls** with full IntelliSense
+- ✅ **PDA finder utilities** for program addresses
+- ✅ **Production-ready package** structure
+- ✅ **Anchor integration** with latest patterns
+
+### Generated SDK Structure
+
+```
+my-program-sdk/
+├── package.json      # Ready-to-publish npm package
+├── types.ts          # Auto-generated TypeScript types
+├── client.ts         # Program interaction client
+├── pdas.ts           # PDA finder utilities
+├── index.ts          # Main exports
+└── tsconfig.json     # TypeScript configuration
+```
+
+### Using Generated SDKs
+
+```typescript
+import { MyProgramClient } from 'my-program-sdk';
+import { Connection, Keypair } from '@solana/web3.js';
+
+// Initialize client
+const connection = new Connection('https://api.mainnet-beta.solana.com');
+const client = new MyProgramClient(connection);
+
+// Call program methods with full type safety
+const txId = await client.myInstruction({
+  accounts: {
+    user: userPublicKey,
+    // ... other accounts
+  },
+  args: {
+    amount: 1000,
+    // ... other args
+  }
+});
+```
+
+## 🛠️ Troubleshooting
 
-- ✅ Generates complete Anchor workspace
-- ✅ Creates Cargo.toml with proper dependencies
-- ✅ Sets up lib.rs with Anchor framework
-- ✅ Configures Anchor.toml for deployment
-- ✅ Works with real Solana networks
+### Version Compatibility Issues
+If you encounter build errors:
+
+1. **Update Rust**: `rustup update stable` (requires 1.85.0+)
+2. **Check versions**: `forge status` (shows mismatches)
+3. **Specify version**: `forge init --anchor-version 0.32.1`
+
+### Common Errors
+- `edition2024` errors → Update Rust to 1.85.0+
+- Version mismatches → Use `forge status` to check alignment
+- Build failures → Ensure Anchor CLI matches project versions
 
 ## 🚫 What FORGE Does NOT Do
 
@@ -69,41 +211,122 @@ You must have:
 
 | Command | Description |
 |---------|-------------|
-| `forge init <name>` | Create new Anchor project |
-| `forge status` | Check environment and tools |
-| `forge deploy` | Deploy program to Solana |
+| `forge init <name>` | Create new Anchor project with optional intent |
+| `forge init <name> --intent "transfer tokens"` | Generate CPI code from natural language |
+| `forge init <name> --anchor-version 0.31.0` | Specify Anchor version for project |
+| `forge generate-sdk [dir]` | Generate TypeScript SDK from Anchor program |
+| `forge status` | Check environment, versions, and compatibility |
+| `forge update` | Update FORGE to latest version |
+| `forge deploy` | Deploy program to Solana network |
 
 ## 📖 Examples
 
+### Basic Project Creation
 ```bash
-# Create a token program
-forge init my-token
-
-# Check everything is ready
+# Simple Anchor project
+forge init my-project
+cd my-project
 forge status
+```
 
-# Deploy to devnet
-forge deploy
+### Intent-Driven CPI Generation
+```bash
+# Generate token transfer program
+forge init token-transfer --intent "transfer 100 tokens safely"
+cd token-transfer
+
+# Modern CPI code is automatically generated:
+# - transfer_checked with decimals validation
+# - InterfaceAccount<TokenAccount> types
+# - Proper error handling
+
+anchor build  # ✅ Works immediately
+anchor test   # ✅ Ready for testing
 ```
 
-## 🏗️ Architecture
+### Client SDK Generation
+```bash
+# Generate program with auto-generated TypeScript SDK
+forge init token-transfer --intent "transfer tokens safely"
+
+# Project structure includes:
+# ├── programs/token-transfer/src/lib.rs  # Anchor program
+# └── client/                             # Auto-generated SDK
+#     ├── index.ts                        # Client class
+#     ├── idl.ts                          # Program IDL
+#     ├── package.json                    # SDK package
+#     └── tsconfig.json                   # TypeScript config
+
+# Build and use the SDK
+cd client && npm install && npm run build
+
+# Use in your frontend/dApp:
+import { TokenTransferClient } from './client';
+const client = new TokenTransferClient(connection, wallet);
+await client.transferTokens(amount, from, to, mint, authority);
+```
+
+### SDK Generation
+```bash
+# Generate SDK after building your program
+cd my-project
+anchor build
+forge generate-sdk
+
+# SDK appears in ./sdk/ directory
+cd sdk
+npm install
+npm run build
+
+# Publish your SDK
+npm publish
+```
+
+### Advanced Usage
+```bash
+# Mint tokens with PDA authority
+forge init token-minter --intent "mint 500 tokens to user"
 
+# Custom Anchor version
+forge init legacy-project --anchor-version 0.30.1
+
+# Stay updated
+forge update
 ```
-FORGE CLI (npm)
-├── forge-sdk-solana - Node.js CLI tool
-└── forge-runtime - Rust runtime (crates.io)
 
-Both work together for complete Solana development
+## 🏗️ Architecture
+
+```
+FORGE Ecosystem
+├── forge-solana-sdk (npm) - Node.js CLI tool
+│   ├── Intent parsing & code generation
+│   ├── Version compatibility management
+│   ├── Project scaffolding
+│   └── Deployment orchestration
+│
+└── forge-runtime (crates.io) - Rust runtime library
+    └── Future: Enhanced runtime capabilities
 ```
 
+**Current Focus**: CLI-first approach with intent-driven generation. Runtime library for future enhancements.
+
 ## 🐛 Support
 
-This is infrastructure. If it breaks:
-1. File an issue on GitHub
-2. Include your `forge status` output
-3. Describe what you expected vs what happened
+**FORGE is infrastructure, not a tutorial.** If you need help:
+
+### Getting Help
+1. **Run diagnostics first**: `forge status` (includes version compatibility checks)
+2. **Check prerequisites**: Ensure Rust 1.85.0+, Node 18+, Anchor CLI installed
+3. **File an issue**: Include `forge status` output and error details
+4. **Describe expected vs actual**: What did you expect? What happened instead?
+
+### Before Asking
+- ✅ Have you run `forge status`?
+- ✅ Is your Rust version 1.85.0+?
+- ✅ Are you in an Anchor project directory?
+- ✅ Have you tried `forge update`?
 
-If you don't understand Solana, learn Solana first.
+**If you don't understand Solana concepts, learn Solana first.** FORGE assumes basic blockchain knowledge.
 
 ## 📄 License
 
@@ -117,4 +340,4 @@ MIT - [https://github.com/forge-protocol/forge/blob/main/LICENSE](https://github
 
 ---
 
-**FORGE: Infrastructure, not cosplay.** ⚡
+**FORGE: Intent → Code. No magic, just infrastructure.** ⚡

package/dist/cli.js

@@ -6,11 +6,12 @@ const ascii_js_1 = require("./ascii.js");
 const init_js_1 = require("./commands/init.js");
 const deploy_js_1 = require("./commands/deploy.js");
 const status_js_1 = require("./commands/status.js");
+const generate_sdk_js_1 = require("./commands/generate-sdk.js");
 const program = new commander_1.Command();
 program
     .name('forge')
     .description('FORGE - Intent-driven app assembly on Solana')
-    .version('2.1.3');
+    .version('2.2.0');
 program
     .command('init [projectName]')
     .description('Initialize a new FORGE project')
@@ -25,15 +26,33 @@ program
     .action(async () => {
     await (0, deploy_js_1.deployCommand)();
 });
+program
+    .command('generate-sdk [outputDir]')
+    .description('Generate TypeScript SDK from Anchor program')
+    .action(async (outputDir) => {
+    await (0, generate_sdk_js_1.generateSdkCommand)(outputDir);
+});
 program
     .command('status')
     .description('Check FORGE status and environment')
     .action(async () => {
     await (0, status_js_1.statusCommand)();
 });
+program
+    .command('update')
+    .description('Update FORGE to the latest version')
+    .action(async () => {
+    await (0, status_js_1.updateCommand)();
+});
 // Show logo on help
 program.on('--help', () => {
     console.log(ascii_js_1.logo);
+    console.log('\nCommands:');
+    console.log('  init          Create new Anchor projects');
+    console.log('  generate-sdk  Generate TypeScript SDK from program');
+    console.log('  status        Check environment & versions');
+    console.log('  update        Update FORGE to latest version');
+    console.log('  deploy        Deploy to Solana network');
     console.log('\nFORGE does not:');
     console.log('- host your code');
     console.log('- manage your keys');

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;AAEA,yCAAoC;AACpC,yCAAkC;AAClC,gDAAiD;AACjD,oDAAqD;AACrD,oDAAqD;AAErD,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,OAAO,CAAC;KACb,WAAW,CAAC,8CAA8C,CAAC;KAC3D,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,oBAAoB,CAAC;KAC7B,WAAW,CAAC,gCAAgC,CAAC;KAC7C,MAAM,CAAC,uBAAuB,EAAE,8DAA8D,CAAC;KAC/F,MAAM,CAAC,gCAAgC,EAAE,0CAA0C,EAAE,QAAQ,CAAC;KAC9F,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE;IACrC,MAAM,IAAA,qBAAW,EAAC,WAAW,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;AACxE,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,0BAA0B,CAAC;KACvC,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,IAAA,yBAAa,GAAE,CAAC;AACxB,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,oCAAoC,CAAC;KACjD,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,IAAA,yBAAa,GAAE,CAAC;AACxB,CAAC,CAAC,CAAC;AAEL,oBAAoB;AACpB,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;IACxB,OAAO,CAAC,GAAG,CAAC,eAAI,CAAC,CAAC;IAClB,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IACjC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAChC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAClC,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;AAC/C,CAAC,CAAC,CAAC;AAEH,kBAAkB;AAClB,OAAO,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;AAEA,yCAAoC;AACpC,yCAAkC;AAClC,gDAAiD;AACjD,oDAAqD;AACrD,oDAAoE;AACpE,gEAAgE;AAEhE,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,OAAO,CAAC;KACb,WAAW,CAAC,8CAA8C,CAAC;KAC3D,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,oBAAoB,CAAC;KAC7B,WAAW,CAAC,gCAAgC,CAAC;KAC7C,MAAM,CAAC,uBAAuB,EAAE,8DAA8D,CAAC;KAC/F,MAAM,CAAC,gCAAgC,EAAE,0CAA0C,EAAE,QAAQ,CAAC;KAC9F,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE;IACrC,MAAM,IAAA,qBAAW,EAAC,WAAW,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;AACxE,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,0BAA0B,CAAC;KACvC,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,IAAA,yBAAa,GAAE,CAAC;AACxB,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,0BAA0B,CAAC;KACnC,WAAW,CAAC,6CAA6C,CAAC;KAC1D,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE;IAC1B,MAAM,IAAA,oCAAkB,EAAC,SAAS,CAAC,CAAC;AACtC,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,oCAAoC,CAAC;KACjD,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,IAAA,yBAAa,GAAE,CAAC;AACxB,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,oCAAoC,CAAC;KACjD,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,IAAA,yBAAa,GAAE,CAAC;AACxB,CAAC,CAAC,CAAC;AAEL,oBAAoB;AACpB,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;IACxB,OAAO,CAAC,GAAG,CAAC,eAAI,CAAC,CAAC;IAClB,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC3B,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC;IACpE,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;IAC5D,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;IAC9D,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;IACxD,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IACjC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAChC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAClC,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;AAC/C,CAAC,CAAC,CAAC;AAEH,kBAAkB;AAClB,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/commands/generate-sdk.d.ts

@@ -0,0 +1,2 @@
+export declare function generateSdkCommand(outputDir?: string): Promise<void>;
+//# sourceMappingURL=generate-sdk.d.ts.map

package/dist/commands/generate-sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-sdk.d.ts","sourceRoot":"","sources":["../../src/commands/generate-sdk.ts"],"names":[],"mappings":"AAsCA,wBAAsB,kBAAkB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyD1E"}