Website

This website is built using Docusaurus 2.

Local Development

To start a development server:

yarn
npx docusaurus graphql-to-doc
yarn start

To build:

yarn build

To deploy:

yarn deploy

Adding deployments for a new chain or asset

1. Update the gateway-sol submodule:

git submodule update --init --recursive

2. Add any new chains to the table in deployments.mdx and add its explorers in RenderGatewaySolConfig.tsx. For new assets, add the icons to contracts/icons and then list the asset in RenderGatewaySolConfig.tsx

Updating auto-generated docs

Contract Reference Types

The contract types are manually moved built and moved in from the contract repos. Assuming gateway-sol, darknode-sol and ren-client-docs are all in the same directory, then the following steps will update these docs:

cd ../gateway-sol

yarn docs && rm -rf ../docs/ren-client-docs/contracts/gateway-sol && mv docs ../docs/ren-client-docs/contracts/gateway-sol

cd ../darknode-sol

yarn docs && rm -rf ../docs/ren-client-docs/contracts/darknode-sol && mv docs ../docs/ren-client-docs/contracts/darknode-sol

cd ../ren-client-docs

If contracts have been moved around or renamed or added/deleted, then the sidebar in sidebarsContracts.js should be updated.

---

JSON-RPC

The JSON-RPC docs are automatically generated from the OpenAPI spec in ./tools/json-rpc.json.