Generating Solana Projects

Goal: Create production-ready Solana blockchain projects with Anchor framework and Next.js frontend.

Workflow

1. •Gather requirements: Ask user for project name, program functionality, required instructions, and frontend features
2. •Generate project structure: Create complete directory tree following Anchor conventions
3. •Create Rust smart contract: Generate lib.rs, state.rs, errors.rs, and instruction handlers in programs/
4. •Create configuration files: Generate Anchor.toml, Cargo.toml, package.json, tsconfig.json with version 0.32.1
5. •Create tests: Generate TypeScript test file with Anchor testing framework setup
6. •Create Next.js frontend: Generate wallet provider setup, Anchor client, and UI components in app/
7. •Provide setup instructions: Tell user to run anchor keys list, update program IDs, build, deploy, and test

Critical versions

Always use these exact versions for compatibility:

• •Anchor: 0.32.1
• •anchor-lang (Rust): 0.32.1
• •@coral-xyz/anchor (JS): ^0.32.1
• •@solana/web3.js: ^1.87.6
• •Next.js: 14.0.4

Project structure template

{project-name}/
├── Anchor.toml
├── Cargo.toml (workspace)
├── package.json
├── programs/{program-name}/
│   ├── Cargo.toml
│   └── src/
│       ├── lib.rs
│       ├── state.rs
│       ├── errors.rs
│       └── instructions/
├── tests/{program-name}.ts
└── app/ (Next.js)
    ├── package.json
    └── src/
        ├── pages/_app.tsx
        ├── components/
        └── utils/anchorSetup.ts

Important reminders

After generation, user must:

1. •Generate program ID: anchor keys list
2. •Update program ID in three locations: Anchor.toml, lib.rs (declare_id!), anchorSetup.ts
3. •Build before deploying: anchor build generates IDL and types needed by frontend

For detailed templates, code snippets, and examples, see reference.md and examples.md.