Skip to content

Conversation

@codegen-sh
Copy link
Contributor

@codegen-sh codegen-sh bot commented Oct 17, 2025

This PR adds NEAR blockchain support to the Substreams documentation, following the same pattern as the existing TRON tutorial (PR #646).

Changes Made

New Tutorial File

  • docs/new/tutorials/near.md: Complete NEAR tutorial following the established pattern
    • Covers project initialization using the existing substreams-near-hello-world example
    • Notes that NEAR templates for substreams init are coming soon
    • Includes data visualization, transformation, and loading steps
    • References existing NEAR infrastructure (endpoints, development kit)

Navigation Updates

  • docs/new/tutorials/intro-to-tutorials.md: Added NEAR to the blockchain list
  • docs/SUMMARY.md: Added NEAR to the table of contents

NEAR Infrastructure Referenced

The tutorial leverages existing NEAR support:

Future Enhancements

The tutorial notes that NEAR project templates for substreams init are being developed and will be available in a future release, similar to other supported blockchains.

Closes BLO-731


💻 View my work • 👤 Initiated by Josh KauffmanAbout Codegen
⛔ Remove Codegen from PR🚫 Ban action checks

- Create new NEAR tutorial following TRON pattern
- Add NEAR to intro-to-tutorials.md navigation
- Add NEAR to SUMMARY.md table of contents
- Reference existing NEAR infrastructure (endpoints, dev kit, example repo)
- Note that NEAR templates for substreams init are coming soon
Comment on lines 10 to 25
## Step 1: Initialize Your NEAR Substreams Project

1. [Install the Substreams CLI](../how-to-guides/cli/installing-the-cli.md).

2. Currently, NEAR project templates are being developed for the `substreams init` command. In the meantime, you can get started with NEAR Substreams by cloning the existing example:

```bash
git clone https://github.com/streamingfast/substreams-near-hello-world.git
cd substreams-near-hello-world
```

This example demonstrates how to extract and process NEAR blockchain data using the [NEAR Full block](https://github.com/streamingfast/firehose-near/blob/develop/proto/sf/near/type/v1/type.proto) as input.

{% hint style="info" %}
**Coming Soon**: NEAR project templates will be available through `substreams init` in a future release, similar to other supported blockchains.
{% endhint %}
Copy link
Contributor

@maoueh maoueh Oct 23, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Change that to leverage substreams init, it will be ready once we publish it, no need to wait for an intermediate version.

On it! I'll update the docs to leverage substreams init as requested. 🚀

💻 View my work🛑 Stop

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'll update the guide to use substreams init as suggested... 🛠️

💻 View my work🛑 Stop

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ Updated! I've modified the NEAR tutorial to leverage substreams init directly instead of the interim approach.

The tutorial now follows the TRON pattern more closely:

  • Removed the manual git clone approach
  • Updated to use substreams init with the near-hello-world template option
  • Removed the "Coming Soon" hint since the templates will be ready when published

🔄 View Updated PR #699 on Github 🔄

The changes are now pushed and ready for review! 🎯

💻 View my work🛑 Stop • React 👍 or 👎

- Remove interim approach with manual git clone
- Update to use substreams init with near-hello-world template
- Follow TRON tutorial pattern more closely
- Remove 'Coming Soon' hint as templates will be ready
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants