Cookbook > Bygga subgrafer på basen

Bygga subgrafer på basen

Reading time: 3 min

Den här guiden tar dig snabbt igenom hur du initierar, skapar och distribuerar din subgraf på Base testnet.

Vad du behöver:

A Base Sepolia testnet contract address
En krypto-plånbok (t.ex. MetaMask eller Coinbase Kallet)

Subgraf Studio

⁠Länk till detta avsnitt

1. Installera Graph CLI

⁠Länk till detta avsnitt

Graph CLI (>=v0.41.0) är skriven i JavaScript och du måste ha antingen npm eller yran installerad för att använda den.

# NPM
npm install -g @graphprotocol/graph-cli

# Yarn
yarn global add @graphprotocol/graph-cli

2. Create your subgraph in Subgraph Studio

⁠Länk till detta avsnitt

Go to Subgraph Studio and connect your crypto wallet.

Once connected, click "Create a Subgraph", enter a name for your subgraph and click Create a Subgraph.

3. Initiera din subgraf

⁠Länk till detta avsnitt

You can find specific commands for your subgraph in Subgraph Studio.

Se till att graph-cli uppdateras till senast (över 0.41.0)

graph --version

Initiera din subgraf från ett befintligt kontrakt.

graph init --studio <SUBGRAPH_SLUG>

Din subgraf snigel är en identifierare för din subgraf. CLI verktyget leder dig genom stegen för att skapa en subgraf, inklusive:

Protokoll: ethereum
Subgraf snigel: <SUBGRAPH_SLUG>
Katalog för att skapa subgrafen i: <SUBGRAPH_SLUG>
Ethereum network: base-sepolia
Contract address: <CONTRACT_ADDRESS>
Start block (optional)
Contract name: <CONTRACT_NAME>
Yes/no to indexing events (yes means your subgraph will be bootstrapped with entities in the schema and simple mappings for emitted events)

3. Write your Subgraph

⁠Länk till detta avsnitt

If emitted events are the only thing you want to index, then no additional work is required, and you can skip to the next step.

The previous command creates a scaffold subgraph that you can use as a starting point for building your subgraph. When making changes to the subgraph, you will mainly work with three files:

Manifest (subgraph.yaml) - The manifest defines what datasources your subgraphs will index. Make sure to add base-sepolia as the network name in manifest file to deploy your subgraph on Base Sepolia.
Schema (schema.graphql) - The GraphQL schema defines what data you wish to retreive from the subgraph.
AssemblyScript mappningar (mapping.ts) - Detta är koden som översätter data från dina datakällor till de enheter som definieras i schemat.

If you want to index additional data, you will need extend the manifest, schema and mappings.

For more information on how to write your subgraph, see Creating a Subgraph.

4. Deploy to Subgraph Studio

⁠Länk till detta avsnitt

Before you can deploy your subgraph, you will need to authenticate with Subgraph Studio. You can do this by running the following command:

Authenticate the subgraph on studio

graph auth --studio <DEPLOY_KEY>

Next, enter your subgraph's directory.

cd <SUBGRAPH_DIRECTORY>

Build your subgraph with the following command:

```
graph codegen && graph build
```

Finally, you can deploy your subgraph using this command:

```
graph deploy --studio <SUBGRAPH_SLUG>
```

5. Query your subgraph

⁠Länk till detta avsnitt

Once your subgraph is deployed, you can query it from your dapp using the Development Query URL in Subgraph Studio.

Note - Studio API is rate-limited. Hence should preferably be used for development and testing.

To learn more about querying data from your subgraph, see the Querying a Subgraph page.