Skip to content

Latest commit

 

History

History
46 lines (31 loc) · 2.18 KB

CONTRIBUTING.md

File metadata and controls

46 lines (31 loc) · 2.18 KB

Contributing to Mpl Toolbox

This is a quick guide to help you contribute to Mpl Toolbox.

Getting started

The root folder has a private package.json containing a few scripts and JavaScript dependencies that help generate IDLs; clients and start a local validator. First, ensure you have pnpm installed and run the following command to install the dependencies.

pnpm install

You will then have access to the following commands.

  • programs:build - Build all programs and fetch all dependant programs.
  • programs:test - Test all programs.
  • programs:debug - Test all programs with logs enabled.
  • programs:clean - Clean all built and fetched programs.
  • clients:js:test - Run the JS client tests.
  • pnpm generate - Shortcut for pnpm generate:idls && pnpm generate:clients.
  • pnpm generate:idls - Generate IDLs for all programs, as configured in the configs/shank.cjs file.
  • pnpm generate:clients - Generate clients using Kinobi, as configured in the configs/kinobi.cjs file.
  • pnpm validator - Start a local validator using Amman, as configured in the configs/validator.cjs file.
  • pnpm validator:debug - Start a local validator using Amman with logs enabled, as configured in the configs/validator.cjs file.
  • pnpm validator:stop - Stop the local validator.
  • pnpm validator:logs - Show the logs of the local validator.

Managing clients

Each client has its own README with instructions on how to get started. You can find them in the clients folder.

In order to generate the clients, run the following command.

pnpm generate

You will need to run pnpm generate to re-generate the clients when something changes in the program(s).

Setting up CI/CD using GitHub actions

Most of the CI/CD should already be set up for you and the .github/.env file can be used to tweak the variables of the workflows.

However, the "Deploy JS Client" workflow — configured in .github/workflows/deploy-js.yml — requires a few more steps to work. See the CONTRIBUTING.md file of the JavaScript client for more information.