pinoc 0.2.0

A Rust CLI for Pinocchio programs. It scaffolds a project, builds and deploys it, keeps program IDs in sync, and generates an IDL and a standalone Rust client from it. Sensible defaults, no required configuration.

Installation

cargo install pinoc

# Latest from GitHub
cargo install --git https://github.com/a91y/pinoc --force

# From source
git clone https://github.com/a91y/pinoc.git
cd pinoc && cargo install --path .

Quick start

pinoc init my_app       # scaffold a project
cd my_app
pinoc build             # build + regenerate the IDL
pinoc test              # run tests (mollusk-svm)
pinoc deploy            # deploy to the configured cluster

Commands

Common options:

• pinoc init <name> --with-example — scaffold a worked PDA-account example instead of a no-op program
• pinoc init <name> --no-git — skip git initialization
• pinoc deploy --cluster <cluster> --wallet <path> — override deployment settings
• pinoc build --program-id <ADDRESS> — set the IDL program address for programs that don't call declare_id!
• pinoc clean --no-preserve — clean everything, including keypairs

Project structure

pinoc init produces a blank, buildable program with a single no-op instruction:

my_app/
├── Cargo.toml
├── Pinoc.toml           # deployment configuration
├── src/lib.rs
└── target/deploy/my_app-keypair.json

A full PDA-account creation example, annotated so pinoc idl works out of the box:

my_app/
├── src/
│   ├── lib.rs
│   ├── entrypoint.rs
│   ├── errors.rs
│   ├── instructions/{mod.rs, initialize.rs}
│   └── states/{mod.rs, state.rs, utils.rs}
├── tests/tests.rs
└── target/deploy/my_app-keypair.json

Configuration

Pinoc.toml holds deployment defaults and is optional:

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

Without it, pinoc deploy falls back to solana config get; --cluster/--wallet always override. Create one on demand with pinoc config init.

Key management

pinoc keys list         # list program keypairs and their addresses
pinoc keys sync         # rewrite the program ID in source to match the keypair

keys sync finds the program's own ID declaration anywhere under src/ (either declare_id! or a const ID) and updates it in place.

IDL and client generation

pinoc build regenerates the IDL at target/idl/ on every build, and pinoc client generate renders a standalone Rust client crate from it. Both understand shank programs and programs using native Codama derive macros.

• IDL generation — files produced, generator selection, error handling, the zero-copy padding lint: src/idl/README.md
• Client generation — the shank and Codama generators, CPI variants, fetch_* helpers, output paths: src/client_gen/README.md

Prerequisites

• Rust 1.70+
• Solana CLI
• Node.js/npm (only for the Codama client generator)

Contributing

Fork, branch, make your change with tests, and open a pull request.

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

License

Apache 2.0 — see LICENSE.

Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Pinocchio: anza-xyz/pinocchio

Acknowledgements

Pinoc began as a fork of solana-chio by Arjun.