README
@uma/core
This package contains contract artifacts for all UMA smart contracts.
Installing the package
Note: this package should rarely be installed by third parties. For abi, bytecode, and official addresses, please use
the @uma/contracts-node
or @uma/contracts-frontend
packages.
This package should be primarily used to access the full contract source code where necessary. The contracts are
available in contracts/
. If you need direct access to the hardhat artifacts, they are available under artifacts/
.
yarn add @uma/core
Deploying the contracts
To deploy the contracts, we use the hardhat-deploy
package. This may be familiar to users of hardhat
. The deployment
process is faily simple, as a result.
To deploy the entire UMA system on a network of your choice:
export MNEMONIC="Your 12-word phrase here"
export CUSTOM_NODE_URL="Your node url here"
yarn hardhat deploy --network kovan
To deploy a particular contract (along with any dependencies that haven't been deployed on this network):
export MNEMONIC="Your 12-word phrase here"
export CUSTOM_NODE_URL="Your node url here"
yarn hardhat deploy --network kovan --tags LongShortPairCreator
Note: other tags, like dvm
, exist to deploy subsets of contracts.
To perform an etherscan verification on a particular contract address that you have deployed on a public network:
export ETHERSCAN_API_KEY="Your etherscan api key here"
export CUSTOM_NODE_URL="Your node url here"
yarn hardhat verify "Your contract address here" --network kovan
To perform a verification on all the contracts you have deployed on a particular network:
export CUSTOM_NODE_URL="Your node url here"
export ETHERSCAN_API_KEY="Your etherscan api key here"
yarn hardhat etherscan-verify --network kovan --license AGPL-3.0 --force-license
To add a contract to the official UMA deployments, find the networks/[chainId].json
file, and update an existing
contract entry or add a new one.
The following commands are implemented as hardhat tasks that make it easy to interact with deployed contracts via the CLI:
Registers the deployer
account (as defined in the namedAccounts
param in hardhat.config.js
) with the deployed Registry for the network. Optionally registers a custom account.
export MNEMONIC="Your 12-word phrase here"
export CUSTOM_NODE_URL="Your node url here"
yarn hardhat register-accounts --network <NETWORK-NAME> --account <CUSTOM-ACCOUNT>
Whitelist hardcoded identifiers from the config/identifiers.json
file. Optionally whitelists a custom identifier.
export MNEMONIC="Your 12-word phrase here"
export CUSTOM_NODE_URL="Your node url here"
yarn hardhat whitelist-identifiers --network <NETWORK-NAME> --id <CUSTOM-IDENTIFIER>
Sets specified contracts in the deployed Finder. More contracts available to be set can be found in the common/hardhat/tasks/finder.js
script.
export MNEMONIC="Your 12-word phrase here"
export CUSTOM_NODE_URL="Your node url here"
yarn hardhat setup-finder --network <NETWORK-NAME> --registry --bridge --generichandler
Integration tests
Some contracts, such as the Insured bridge, contain end to end integration tests that are run differently to the rest of core's tests. Running these specific tests can be done as follows:
cd ../.. # navigate to the root of the protocol repo
yarn optimsim-up # start the optimism containers. note this will take a long time as a few containers need to be built
cd ./packages/core # move back to this package
yarn test-e2e # run the end to end tests against the optimism containers.