Need help with protocol?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

172 Stars 89 Forks GNU Affero General Public License v3.0 1.6K Commits 102 Opened issues


UMA Protocol Running on Ethereum

Services available


Need anything else?

Contributors list

UMA Protocol

UMA Logo

<UMAprotocol> Docker Cloud Build Status Coverage Status

GitHub GitHub last commit GitHub commit activity GitHub contributors

Generic badge Generic badge Generic badge Twitter Follow

Documentation 📚

Our docs site is here. It contains tutorials, explainers, and smart contract documentation. If you'd like to view these docs on github instead, check out the documentation folder in the docs repo.

Security and Bug Bounty 🐛

Please see here for details on our bug bounty.

Contributing 🙌

Please see our contributing guidelines.

Developer Information and Tools 👩‍💻

For detailed information on how to initialize and interact with our smart contracts, please see the documentation site.

Install dependencies 👷‍♂️

You'll need to install the long-term support version of nodejs, currently nodejs v14. You will also need to install yarn. Assuming that's done, run

with no args:

If you'd like to completely clear all packages'

and reinstall all deps from scratch, run:
yarn clean-packages

Build the code 🧐

Some code in the repository requires a build step to compile it. To run this build step, use the

(quick build) command:
yarn qbuild

The above command does not include dapps because dapps take a long time to build and they have their own scripts to run locally. However, if you'd like to build everything, you can use the build command:

yarn build

To remove any remnants of previous builds, you can run:

yarn clean

Run tests 🦾

To run tests, you'll need to start ganache on port 9545:

yarn ganache-cli -e 1000000000 -p 9545 -l 9000000 -d

Note: if you're interested in what these args do:

  • -e
    is the amount of ETH to grant the default accounts.
  • -p
    is the port that ganache will listen on.
  • -d
    tells ganache to use a standard set of deterministic accounts on each run.

Then, you can run all of the tests across the repo by running:

yarn test

However, running all of the tests across the repository takes a lot of time. To run the tests for just one package, you can run:

yarn workspace  test

Running the linter 🧽

To run the linter in autofix mode (it will attempt to fix any errors it finds), run:

yarn lint-fix

To run the linter in the default mode, where it will print all errors and not modify code, run:

yarn lint

Packages 📦

Because this repo is a monorepo, it conatains many different npm packages. More will be discussed about these packages in the following sections. However, the basic structure is that each pacakge is listed in the

directory. Each package has its own scripts and dependencies and operates (mostly) independently from the others.

Adding dependencies 👩‍👦

All runtime/production dependencies should be added to the package that needs them. Development dependencies should also generally be installed in packages unless they are needed by code that exists outside of any package.

For more details on packages and the monorepo, please see the next section.

To add a dependency to a package:

yarn workspace  add 

Note: development dependencies are those that are not required by the code that's published to the npm registry. If you're not sure whether a dependency should be dev or not, just ask! To install a dev dependency in a package:

yarn workspace  add  --dev

Note: all root dependencies should be dev dependencies because the root package is not published to npm, so there is no "production" code. To install a dev dependency at root:

yarn add  --dev

After you've installed a dependency, yarn should automatically update the

file. If git doesn't notice any changes in that file, run
to update the lockfile.

Depending on another package in the monorepo 🤝

The standard way to pull a JS element from another package is to reference it like this:

const { importedObject } = require("@uma/some-package")

Note: the require will resolve to the

file specified in the
file. If you'd like to import a different file, you should ensure that that file is exported in the
directive inside the
file. Once you're sure of that, you can import it using the following syntax:
const { importedObject } = require("@uma/some-package/path/to/some/file")

Note: if this file isn't exported by the

directive, it will work locally, but fail when run via an npm installation.

To install this dependency you're using in

, you should run the following command:
yarn lerna add @uma/some-package --scope @uma/my-package

By default, this will symlink the package in

rather than attempting to pull the package via npm. This allows the packages to depend on the in-repo versions of one another. If you'd like to reference a particular version from npm, you can specify that version exactly in the

Using yarn and lerna 🧑‍🍳

This repository is a monorepo. That means that it contains many different, but related packages. It uses yarn workspaces and lerna to manage these packages.

Note: lerna and yarn workspaces have some overlapping functionality. This is because

workspaces and is compatible with
alternatives that don't have workspace functions, like

should be installed globally to use this repo. This means that you can run any yarn command by running:

Once you run

during the install section above, lerna should have been installed locally. After that, you should be able to run lerna commands using yarn:
yarn lerna 

To run a yarn command in a particular sub-package, you can run the following from anywhere in the repo:

yarn workspace  

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.