Pinoc

Setup Solana Pinocchio projects blazingly fast ⚡

Built by:

A modern Rust CLI to bootstrap Solana Pinocchio programs with built-in build, deploy, and testing tools.

• Zero Configuration: Get started in seconds with sensible defaults
• Best Practices: Project structure follows Solana development conventions
• Developer Experience: Intuitive commands that feel natural
• Production Ready: Built-in testing, deployment, and key management

• 🏗️ Instant Project Scaffolding - Create production-ready projects in seconds
• 📁 Optimized Structure - Best-practice directory layout out of the box
• 🔨 Unified Commands - Build, test, and deploy with simple commands
• 🧹 Smart Cleaning - Clean build artifacts while preserving keypairs
• 📦 Package Discovery - Find and add Pinocchio packages effortlessly
• 🧪 Built-in Testing - Comprehensive testing with mollusk-svm
• 🔐 Keypair Management - Automatic generation and secure storage
• 🔑 Program ID Sync - Keep your program IDs consistent automatically
• ⚙️ Configuration Management - Simple deployment configuration with Pinoc.toml

cargo install pinoc

cargo install --git https://github.com/a91y/pinoc --force

git clone https://github.com/a91y/pinoc.git
cd pinoc
cargo build --release
cargo install --path .

# Install pinoc
cargo install pinoc

# Create a new project
pinoc init my_awesome_app

# Navigate to your project
cd my_awesome_app

# Build and test
pinoc build
pinoc test

# Deploy to Solana
pinoc deploy

That's it! You now have a fully functional Solana program ready for development.

• pinoc init <name> --no-git - Skip git initialization
• pinoc init <name> --no-boilerplate - Create minimal project structure
• pinoc clean --no-preserve - Clean everything including keypairs
• pinoc deploy --cluster <cluster> --wallet <path> - Override deployment settings

my_project/
├── Cargo.toml              # Project configuration
├── README.md               # Documentation
├── .gitignore              # Git ignore rules
├── Pinoc.toml              # Deployment configuration
├── src/
│   ├── lib.rs              # Main library
│   ├── entrypoint.rs       # Program entrypoint
│   ├── errors.rs           # Error definitions
│   ├── instructions/       # Program instructions
│   │   ├── mod.rs
│   │   └── initialize.rs
│   └── states/             # Account states
│       ├── mod.rs
│       ├── state.rs
│       └── utils.rs
├── tests/
│   └── tests.rs            # Unit tests
└── target/deploy/
    └── my_project-keypair.json  # Program keypair

Perfect for quick prototypes or learning:

my_minimal_project/
├── Cargo.toml              # Minimal configuration
├── README.md               # Basic documentation
├── .gitignore              # Git ignore rules
├── Pinoc.toml              # Deployment configuration
├── src/
│   └── lib.rs              # Minimal program structure
└── target/deploy/
    └── my_minimal_project-keypair.json

Pinoc uses Pinoc.toml for deployment settings:

[provider]
cluster = "localhost"
wallet = "~/.config/solana/id.json"

Override settings per deployment:

# Deploy to devnet with custom wallet
pinoc deploy --cluster devnet --wallet ./custom-keypair.json

Keep your program IDs synchronized:

# Check key consistency
pinoc keys list

# Sync program ID in lib.rs with keypair
pinoc keys sync

Example output:

✅ Program key is already consistent!
🔑 Program ID: 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM
📝 No update needed in src/lib.rs

Clean build artifacts while preserving important files:

# Clean target directory (preserves keypairs)
pinoc clean

# Clean everything including keypairs
pinoc clean --no-preserve

Ensure you have these tools installed:

• Rust (1.70+) - Install here
• Solana CLI - Install guide
• Git - For version control

We welcome contributions! Here's how to get started:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Make your changes
4. Test thoroughly
5. Commit with clear messages (git commit -m 'Add amazing feature')
6. Push to your branch (git push origin feature/amazing-feature)
7. Open a Pull Request

git clone https://github.com/a91y/pinoc.git
cd pinoc
cargo build --release
cargo install --path .

# Test your changes
pinoc init test-project
cd test-project
pinoc build

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

• 📖 Documentation: Pinocchio Docs
• 🐛 Issues: GitHub Issues
• 💬 Discussions: GitHub Discussions
• 📦 Crates.io: pinoc