Skip to content

graphprotocol/contracts

Folders and files

NameName
Last commit message
Last commit date
Feb 13, 2024
Aug 15, 2024
May 17, 2024
Dec 5, 2024
Oct 1, 2024
Jun 7, 2024
Feb 23, 2024
Sep 2, 2021
May 20, 2024
Oct 12, 2021
May 20, 2024
Oct 1, 2024

Repository files navigation

The Graph

The Graph Protocol

A decentralized network for querying and indexing blockchain data.

Build CI E2E

PackagesDevelopmentDocsContributingSecurityLicense


The Graph is an indexing protocol for querying networks like Ethereum, IPFS, Polygon, and other blockchains. Anyone can build and Publish open APIs, called subgraphs, making data easily accessible.

Packages

This repository is a Yarn workspaces monorepo containing the following packages:

Package Latest version Description
contracts npm version Contracts enabling the open and permissionless decentralized network known as The Graph protocol.
eslint-graph-config npm version Shared linting and formatting rules for TypeScript projects.
horizon npm version Contracts for Graph Horizon, the next iteration of The Graph protocol.
sdk npm version TypeScript based SDK to interact with the protocol contracts
solhint-graph-config npm version Shared linting and formatting rules for Solidity projects.
solhint-plugin-graph npm version Plugin for Solhint with specific Graph linting rules.
subgraph-service npm version Contracts for the Subgraph data service in Graph Horizon.
token-distribution - Contracts managing token locks for network participants

Development

Setup

To set up this project you'll need git and yarn installed. Note that Yarn v4 is required to install the dependencies and build the project.

From your command line:

# Enable Yarn v4
corepack enable
yarn set version stable

# Clone this repository
$ git clone https://github.com/graphprotocol/contracts

# Go into the repository
$ cd contracts

# Install dependencies
$ yarn

# Build projects
$ yarn build

Versioning and publishing packages

We use changesets to manage package versioning, this ensures that all packages are versioned together in a consistent manner and helps with generating changelogs.

Step 1: Creating a changeset

A changeset is a file that describes the changes that have been made to the packages in the repository. To create a changeset, run the following command from the root of the repository:

$ yarn changeset

Changeset files are stored in the .changeset directory until they are packaged into a release. You can commit these files and even merge them into your main branch without publishing a release.

Step 2: Creating a package release

When you are ready to create a new package release, run the following command to package all changesets, this will also bump package versions and dependencies:

$ yarn changeset version

Step 3: Tagging the release

Note: this step is meant to be run on the main branch.

After creating a package release, you will need to tag the release commit with the version number. To do this, run the following command from the root of the repository:

$ yarn changeset tag
$ git push --follow-tags

Step 4: Publishing a package release

Note: this step is meant to be run on the main branch.

Packages are published and distributed via NPM. To publish a package, run the following command from the root of the repository:

# Publish the package
$ yarn npm publish --access public --tag <tag>

Alternatively, there is a GitHub action that can be manually triggered to publish a package.

Documentation

Coming soon

For now, each package has its own README with more specific documentation you can check out.

Contributing

Contributions are welcomed and encouraged! You can do so by:

  • Creating an issue
  • Opening a PR

If you are opening a PR, it is a good idea to first go to The Graph Discord or The Graph Forum and discuss your idea! Discussions on the forum or Discord are another great way to contribute.

Security

If you find a bug or security issue please go through the official channel, The Graph Security Bounties on Immunefi. Responsible disclosure procedures must be followed to receive bounties.

License

Copyright © 2021 The Graph Foundation

Licensed under GPL license.