Skip to content

Latest commit

 

History

History
72 lines (45 loc) · 1.74 KB

README.md

File metadata and controls

72 lines (45 loc) · 1.74 KB

Resources

Validation

Validation must pass for the tokenlist to work on Uniswap.

Local Testing

The tokens.json is validated against Uniswap's tokenlist schema.

To test locally,

Install dependencies

$ npm install

Run test script

$ npm start

If there is an error, the error will be output to the terminal.

GitHub Workflow & Issue Templates

A GitHub workflow is included that automatically tests for validation any time there is a push or pull request. GitHub Issue Templates have been included to help manage new and existing tokens.

Branch Protection Rules

A best practice would be to create a new branch for any change and create a pull request to master. I recommend branch protection rules to prevent invalid changes from being merged into the repository.

Settings -> Branches

Branch protection rules -> Add rule

Branch name pattern: master or main

Check the boxes for

  • Require status checks to pass before merging
  • Require branches to be up to date before merging
  • build (may not be available until you save the page once)
  • Include administrators

Save changes

Deploying your list

You can paste the link to your raw json file in Uniswap.

More information can be found at github/uniswap/token-lists#deploying-your-list

After you've used the tokenlist on Uniswap, Uniswap will discover any change you make to the tokenlist as long as you follow the Semantic versioning instructions.

License

Apache-2.0