back button

How to build TheGraph’s subgraph? Demonstrate Subgraph Structure on 2key Subgraph — & The Graph (Part 2)

This article is the second part of a 3-piece series:

  1. The Graph and Its Contribution to dApps and Blockchain Development
  2. Demonstrate Subgraph Structure on 2key Subgraph “The Graph”
  3. One Referral Map to Rule Them (Blockchains) All — Using 2 Subgraphs on 2key dApp to generate the referral map

First, let’s jump into the — 2key Subgraphs project on Github, and clone it to a local workspace.

There are 4 important files needed for the Subgraph:

Image for post
2key Network's public Subgraph
  1. Schema.graphql, GraphQL entities definition, such as User, Campaign, and attributes types
  2. The ABI of the contract, which will trigger indexing handlers
  3. Exported handler functions and indexing logic.
  4. Subgraph.yaml, basic config of the Subgraph, contract address that will emit the events, ABI, handlers, event names and entities


Collection of entities. Think of an entity as a relation in a DB.

type Rate @entity {
   id: ID!
   _rate: BigInt!
   _maintainer: Bytes!
   _timeStamp: BigInt!
   _event: PriceUpdated!
}(schema.graphql at Subgraphs repo)


In the subgraph.yaml, we define an event and a handler. The mapping.ts will be the place where we keep these handlers:

Image for post
mapping.ts at 2key subgraph

Each is invoked as a response for an emitted event. For the “UserRegistered” event, the following handler will be emitted:

export function handleUserRegistered(event: UserRegisteredEvent): void{
 let newUser = User.load(event.params._address.toHex());
 if (newUser == null){
   newUser = new User(event.params._address.toHex());
   newUser._timeStamp = event.block.timestamp;
 newUser._name = event.params._name;
 newUser._fullName = event.params._fullName;
 newUser._walletName = event.params._username_walletName;
 newUser._email = event.params._email;
 newUser._updatedTimeStamp = event.block.timestamp;;
}(mapping.ts at Subgraphs repo)


#it's an edited version - only with the most relevant config.
 file: ./schema.graphql
   network: ropsten
     address: "0x0e05fd4224e7e9b5abaaa9cfd56de91cdc95b1cc"
     abi: TwoKeyEventSource
       - Campaign
       - User
       - name: TwoKeyEventSource
         file: ./abis/TwoKeyEventSource.json
       - event: UserRegistered(string,address,string,string,string)
         handler: handleUserRegistered
       - event: Joined(address,address,address)
         handler: handleJoined
     file: ./src/mapping.ts(subgraph.yaml at Subgraphs repo)
  1. source: what address to listen for defined events + ABI.
  2. entities: what are the created entities we could query upon.
  3. eventHandlers: name of an event and the related handler.

Follow the steps to deploy a Subgraph (TheGraph site).

After it is finished, your graph is ready to play with. Use the playground to query and explore your contracts state according to your indexing logic.

Let’s explore our schema according to our schema.graphql

Image for post

The next step is to take the Query URL and fetch it from your app/dApp,

Have fun!

2key is a Layer2 solution to Ethereum Blockchain, that transforms today’s HTTP links into Tomorrow’s Decentralized Web. Creators of the SmartLink.

Learn more @
Follow our updates on
Twitter, TelegramYoutube
Read more