DEPLOYMENT.md

Deploying the Solidity Smart Contracts

Running

Deploy functionality exists in cli/cli.ts. You can deploy the contracts to the specified network when used with the migrate command. This script accepts multiple commands that you can print using:

cli/cli.ts --help

For convenience, the script can also be used as a hardhat command with hardhat migrate and it can be also run with:

yarn deploy

The migrate command will:

• Read contracts configuration from a file.
• Parse command-line options to select which network to deploy and the wallet to use.
• Check if contracts were already deployed and skip them.
• Deploy the contracts and wait for each transaction to be mined.
• Write an address book file with the deployed contracts data.

The script accepts multiple parameters that allow to override default values, print the available options with:

yarn deploy -- --help

NOTE: Please run yarn build at least once before running migrate as this command relies on artifacts produced in the compilation process.

Networks

By default, yarn deploy will deploy the contracts to a localhost instance of a development network.

To deploy to a different network execute:

yarn deploy -- --network {networkName}

# Example
yarn deploy -- --network goerli

The network must be configured in the hardhat.config.ts as explained in https://hardhat.org/config.

To deploy using your own wallet add the HD Wallet Config to the hardhat.config.ts file according to https://hardhat.org/config/#hd-wallet-config.

Configuration

A configuration file called graph.<networkName>.yml located in the config folder contains the parameters needed to deploy the contracts. Please edit these params as you see fit.

You can use a different set of configuration options by specifying the file location in the command line:

yarn deploy -- --graph-config another-graph.mainnet.yml

Rules:

• Under the contracts key every contract configuration is defined by its name.
• Every key under a contract name are parameters sent in the contract constructor in the order they are declared.
• YAML anchors can be used to set common values like *governor.
• A special key called __calls let you define a list of parameters that will be set at the end of all the contracts deployment by calling the function defined in the fn key.
• The configuration file can set a parameter to a value read from the AddressBook by using ${{ContractName.AttributeName}}. For example ${{GraphToken.address}}.

Example:

https://github.com/graphprotocol/contracts/blob/master/config/graph.mainnet.yml

Address book

After running the migrate script it will print debugging information on the console and the resulting contract information will be saved on the addresses.json file.

The upmost key of that file is the chainID. This allows to accommodate the deployment information of multiple networks in the same address book.

For each contract deployed, the address book will contain:

• Contract address.
• Constructor arguments.
• Creation code hash.
• Runtime code hash.
• Transaction hash of the deployment.

Order of deployment

Some contracts require the address from previously deployed contracts. For that reason, the order of deployment is as below:

• Controller
• EpochManager
• GNS
• GraphToken
• ServiceRegistry
• Curation
• RewardManager
• Staking
• DisputeManager

Deploying a new testnet

1. Make sure contracts are up to date as you please.
2. yarn deploy-goerli to deploy to Goerli. This will create new contracts with new addresses in addresses.json.
3. Update the package.json and package-lock.json files with the new package version and publish a new npm package with npm publish. You can dry-run the files to be uploaded by running npm publish --dry-run.
4. Merge this update into master, branch off and save for whatever version of the testnet is going on, and then tag this on the github repo, pointing to your branch (ex. at testnet-phase-1 branch). This way we can always get the contract code for testnet, while continuing to do work on mainnet.
5. Pull the updated package into the subgraph, and other apps that depend on the package.json.
6. Send tokens to the whole team using ./cli/cli.ts airdrop

Verifying the deployed smart contracts

Deployed smart contracts can be verified on etherscan and sourcify using built-in commands.

Etherscan

Etherscan verification can be performed by using the hardhat-etherscan plugin. Note: ensure you have set a valid ETHERSCAN_API_KEY in the .env file.

• To verify a single contract, run:

  npx hardhat verify --network {networkName} --contract {FullyQualifiedContractName} {contractAddress} {constructorInitParams}

• To verify all contracts on the address book, run:

  npx hardhat verifyAll --network {networkName} --graph-config {graphConfigFile}

Sourcify

Additionally you can verify contracts on Sourcify.

• To verify a single contract, run:

  npx hardhat sourcify --network {networkName} --contract {FullyQualifiedContractName} {contractAddress}

• To verify all contracts on the address book, run:

  npx hardhat sourcifyAll --network {networkName}