Full lesson
solforge
AI-Powered Solana Development Suite 🤖⚡ The next-generation Solana development environment combining blazing-fast localnet performance with integrated AI assistance. Build faster, debug smarter, ship sooner.
What it does
From the project README:
[](https://github.com/nitishxyz/solforge) [](LICENSE) [](https://github.com/litesvm/litesvm) [](AGI_QUICKSTART.md)
- Original
- nitishxyz/solforge
- SuperStack fork
- Blockchains/solforge @
7522934 - Stars
- 23
- Last push (original)
- 2026-01-25
- Languages
- TypeScript, Astro, JavaScript, CSS, Shell, HTML
- Detected stack
- @solana/kitweb3.js
- Categories
- AI & Agents
- Licence
- MIT
- Homepage
- https://solforge.sh
Architecture
495 source files. By extension: .ts Ă—296, .tsx Ă—189, .js Ă—10.
| Top-level directory | Source files |
|---|---|
apps | 347 |
packages | 116 |
infra | 10 |
tests | 10 |
(root) | 6 |
scripts | 6 |
Dapp: devnet deploy pending
⏳ Devnet deploy pending — goes live when the devnet wallet is topped up. This fork's own dapp is not deployed yet, so there is no program address or transaction to show. It is queued in dapp-queue.txt; once devnet SOL is available it is deployed, exercised with real devnet transactions, and this section switches to the live dapp at /dapps/solforge/. Until then, the lesson and step-by-step guide below are complete, and you can run it locally with the commands below.
Key code, explained
Excerpts chosen automatically where the code uses the most Solana concepts, pinned to the fork's commit.
scripts/test-all-parsers.ts L13–36 @ 7522934 · MIT · original * 3. Open explorer: http://localhost:3000 */ import { Connection, Keypair, type PublicKey, SystemProgram, Transaction, sendAndConfirmTransaction, LAMPORTS_PER_SOL,} from "@solana/web3.js";import { TOKEN_PROGRAM_ID, TOKEN_2022_PROGRAM_ID, createInitializeMintInstruction, createInitializeMint2Instruction, createInitializeAccountInstruction, createInitializeAccount2Instruction, createInitializeAccount3Instruction, createMintToInstruction, createMintToCheckedInstruction, createTransferInstruction, createTransferCheckedInstruction,- Line 22
sendAndConfirmTransaction,: Submits the signed transaction to the cluster. - Line 27
TOKEN_2022_PROGRAM_ID,: Targets the Token-2022 program instead of the original Token Program. - Line 33
createMintToInstruction,: Mints new tokens. The mint authority must sign. - Line 35
createTransferInstruction,: An SPL token transfer through the Token Program. - Line 36
createTransferCheckedInstruction,: A checked token transfer, which also verifies the mint and decimals.
packages/server/src/methods/index.ts L193–216 @ 7522934 · MIT · original solforgeAdminCloneTokenAccounts, solforgeCreateTokenAccount, solforgeLoadProgram, solforgeCreateMint, solforgeListMints, solforgeMintTo, solforgeAdoptMintAuthority,}; Object.assign(rpcMethods, adminMethods); export { getAccountInfo, getBalance, getMultipleAccounts, requestAirdrop, sendTransaction, simulateTransaction, getTransaction, getSignatureStatuses, getSignaturesForAddress, getConfirmedTransaction, getLatestBlockhash, getSlot,- Line 198
solforgeMintTo,: Mints new tokens. The mint authority must sign. - Line 209
sendTransaction,: Submits the signed transaction to the cluster. - Line 215
getLatestBlockhash,: Fetches a recent blockhash. Transactions expire if it gets too old.
packages/server/src/methods/admin/mint-to.ts L1–24 @ 7522934 · MIT · originalimport { ACCOUNT_SIZE, AccountLayout, createAssociatedTokenAccountInstruction, createMintToCheckedInstruction, getAssociatedTokenAddressSync, MINT_SIZE, MintLayout, TOKEN_2022_PROGRAM_ID, TOKEN_PROGRAM_ID,} from "@solana/spl-token";import type { TransactionInstruction } from "@solana/web3.js";import { PublicKey, TransactionMessage, VersionedTransaction,} from "@solana/web3.js";import type { RpcMethodHandler } from "../../types";import { sendTransaction as sendTxRpc } from "../transaction/send-transaction"; // Mint via a real SPL Token transaction signed by faucet (must be mint authority)export const solforgeMintTo: RpcMethodHandler = async (id, params, context) => { try { const [mintStr, ownerStr, rawAmount] = params as [- Line 5
createMintToCheckedInstruction,: Mints new tokens. The mint authority must sign. - Line 9
TOKEN_2022_PROGRAM_ID,: Targets the Token-2022 program instead of the original Token Program. - Line 19
import { sendTransaction as sendTxRpc } from "../transaction/send-transaction";: Submits the signed transaction to the cluster.
packages/server/src/lib/parsers/spl-token.ts L1–24 @ 7522934 · MIT · originalimport type { PublicKey, TransactionInstruction } from "@solana/web3.js";import { decodeMintToCheckedInstruction, decodeTransferInstruction, decodeTransferCheckedInstruction, decodeInitializeAccount3Instruction, decodeInitializeImmutableOwnerInstruction, decodeTransferCheckedInstructionUnchecked, decodeTransferInstructionUnchecked, decodeInitializeAccount3InstructionUnchecked, decodeInitializeImmutableOwnerInstructionUnchecked, // Additional core instruction decoders decodeApproveInstruction, decodeApproveCheckedInstruction, decodeRevokeInstruction, decodeSetAuthorityInstruction, decodeMintToInstruction, decodeBurnInstruction, decodeBurnCheckedInstruction, decodeCloseAccountInstruction, decodeFreezeAccountInstruction, decodeThawAccountInstruction, decodeInitializeAccountInstruction, decodeInitializeAccount2Instruction,- Line 3
decodeMintToCheckedInstruction,: Mints new tokens. The mint authority must sign. - Line 5
decodeTransferCheckedInstruction,: A checked token transfer, which also verifies the mint and decimals.
How to run, build and test
These commands come from the repo's own manifests (package.json scripts, Anchor.toml, Cargo, go.mod, Makefile). Check the README for prerequisites and environment variables.
| Directory | Command | Runs |
|---|---|---|
. | npm run build | bun run build:cli:all |
. | npm run lint | bunx @biomejs/biome check apps packages scripts |
apps/chat | npm run dev | vite |
apps/chat | npm run build | tsc -b && vite build |
apps/chat | npm run lint | eslint . |
apps/website | npm run dev | astro dev |
apps/website | npm run build | astro check && astro build |
apps/mobile | npm run start | expo start |
apps/mobile | npm run lint | expo lint |
apps/web | npm run dev | vite |
apps/web | npm run build | vite build |
apps/web | npm run lint | biome lint |
apps/router | npm run dev | bun run --watch src/index.ts |
apps/router | npm run start | bun run src/index.ts |
apps/router | npm run build | bun build src/index.ts --outdir dist --target bun |
apps/cli | npm run dev | bun index.ts |
What you could build from it
- Fork the SuperStack copy and extend it within the AI & Agents gaps listed on the idea page.
- Learn the pattern first: AI agents on Solana
- Learn the pattern first: Building and sending transactions from a client
- Learn the pattern first: Blinks and Solana Actions