クックブック > Baseでのサブグラフ構築

Baseでのサブグラフ構築

Reading time: 3 min

このガイドでは、Baseテストネットでのサブグラフの初期化、作成、デプロイの方法を素早く説明します.

必要なもの：

A Base Sepolia testnet contract address
暗号ウォレット（例：MetaMaskまたはCoinbase Wallet）

サブグラフスタジオ

⁠このセクションへのリンク

1. Graph CLI のインストール

⁠このセクションへのリンク

The Graph CLI (>=v0.41.0) はJavaScriptで書かれており、使用するには npm または yarn のいずれかをインストールする必要があります。

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

# Yarn
yarn global add @graphprotocol/graph-cli

2. Create your subgraph in Subgraph Studio

⁠このセクションへのリンク

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. サブグラフの初期化

⁠このセクションへのリンク

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

Graph-cliが最新版（0.41.0以上）に更新されていることを確認します。

グラフ --バージョン

既存のコントラクトからサブグラフを初期化します。

graph init --studio <SUBGRAPH_SLUG>

サブグラフのスラッグは、サブグラフの識別子となるものです。CLIツールは、サブグラフを作成するためのステップを説明します。

Protocol: ethereum
Subgraph slug: <SUBGRAPH_SLUG>
Directory to create the subgraph in: <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

⁠このセクションへのリンク

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 Mappings (mapping.ts) - データソースからのデータを、スキーマで定義されたエンティティに変換するコードです。

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

⁠このセクションへのリンク

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

⁠このセクションへのリンク

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.