Scaffolding a NEAR Subgraph

In a code editor, a subgraph will be a folder with a few different folders and files. Usually we'd use the Graph-CLI to initiate a Graph project that sets up those files/folders for us, but the ability to run `graph init` is currently not available for NEAR. So we'll need to scaffold out our project differently.

Before we get that though, we will need The Graph Cli installed to generate, build, and deploy the subgraphs to the Hosted Service. So, install the CLI by running:

Verify the installation was successful by running 'graph' in your terminal.  You should see something like:

Generate a NEAR Subgraph Scaffold

We've made it easy to scaffold out a NEAR subgraph project by creating a NEAR-Subgraph-Template that you can git clone from Github.

Once cloned into your directory, cd into it and open it up in your editor.  Next step is to install the dependencies, but first, ensure you're using node >= 14.17.  Once that's done, run:

And that's it.  The project should be setup and ready for your modifications.  The file structure should look like the pic on the right.

The build folder is where the built code goes.

The schema.ts file in the generated folder is where code generated from the codegen command goes.  More on that later.

subgraph.yaml is the manifest file.

schema.graphql is the entities (models/objects) file.

mapping.ts is the AssemblyScript file that maps data coming off the blockchain to the entities you've defined in schema.graphql.

There are three commands we'll be using going forward provided by graph-cli.

Next Steps

Now that we have our project code setup, we'll go through each of the three files in turn to complete the subgraph.  First up is the subgraph manifest.  See you there.