substreams-dev

Guide Substreams development across manifests, Rust modules, and protobuf schemas.

15|1|Updated Jun 9, 2025
One-click install
npx skills add https://github.com/pinax-network/substreams-solana --skill substreams-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: substreams-dev
Source: https://github.com/pinax-network/substreams-solana/tree/main/.github/skills/substreams-dev
Command: npx skills add https://github.com/pinax-network/substreams-solana --skill substreams-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Substreams development and debugging can be complex across blockchains; this Skill provides expert guidance, practical patterns, and structured workflows to accelerate building Substreams projects, from manifests to Rust modules and protobuf schemas.

Core Features & Use Cases

  • Expert guidance for substreams.yaml manifests, module implementation, and protobuf schema handling.
  • Best practices for debugging, performance optimization, and cross-chain workflows.
  • Use Case: When starting a new Substreams project, generate a starter manifest, scaffold module stubs, and troubleshoot common build and run issues.

Quick Start

Use the substreams-dev skill to outline a development plan for a new Substreams project, listing required files, recommended module types, and a starter command like substreams run for a small test block range.

Frequently Asked Questions about substreams-dev

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scaffold a Substreams manifest and Rust module for a new blockchain project?

A Substreams manifest is a YAML file defining data sources and Rust modules that process blockchain events into structured outputs, requiring protobuf schemas to define the transformed data structure.

What is the best way to debug Substreams Rust modules during development?

Debugging Substreams Rust modules involves applying performance optimization best practices, validating protobuf schema transformations, and testing outputs against a small block range before full deployment.

How does Substreams handle protobuf schemas across different blockchains?

Substreams uses protobuf schemas to structure extracted blockchain data, allowing Rust modules to process and transform events consistently across multiple supported blockchain networks.

Can I use Substreams for cross-chain development workflows without changing my Rust modules?

Substreams supports cross-chain workflows by applying standardized Rust modules and protobuf schemas, though manifest configurations must adapt to the specific data sources of each blockchain network.

Why does my Substreams build fail when parsing the manifest or protobuf definitions?

Substreams build failures often stem from malformed YAML frontmatter in the manifest, incorrect protobuf schema definitions, or missing Rust module dependencies required during the compilation step.