Motivation

Deploy repo was deploying from workspace version of the contracts, not tagged npm version. This didn't affect the source code deploys as we had frozen the contract code, but needs to be changed nevertheless.

Solution

Update deploy package to use tagged contract versions rather than workspace.

PR Checklist

• [ ] Added Tests
• [ ] Updated Documentation
• [ ] Updated CHANGELOG.md for the appropriate package

Motivation

Want mainnet fork tests for all of the components of the reboot scripts together.

Solution

Create a reboot fork test

PR Checklist

• [ ] Added Tests
• [x] Updated Documentation
• [x] Updated CHANGELOG.md for the appropriate package

Motivation

Currently, the NomadEnv does not have any documentation. This PR adds related documentation and a few small modifications on the Nomad Environment.

Solution

• Wrote and attached the Local Environment docs as a link in the readme (unsure if I should just include the whole markdown in the readme.

PR Checklist

• [x] Added Tests (not required, peer feedback required)
• [x] Updated Documentation
• [x] Updated CHANGELOG.md for the appropriate package

Motivation

Lots of things:

• 'Unit tests' (not really) used to rely on Docker and used to pull containers from the cloud. Now they no longer do. We have achieved > 50% coverage on all unit-testable items.
• We want to be able to fork mainnet and be able to write tests accordingly (for end to end tests on contract upgrades, contract to contract calls, etc.). Local environment is now capable of supporting integration tests on a mainnet fork. *CAVEAT: There will be additional refactoring of LE for being able to test by reading from config files of existing Nomad deployments. Current integration tests are not designed to be done on a forked mainnet. Additional tests that fit mainnet not included within this PR and will most likely be included in a future one.
• Needed to refactor the whole local environment to accept Jest's Docker mocks.

Solution

• Refactored all unit tests of local environment - unit tests no longer pull Docker containers from the cloud.
• Implemented (and tested) local environment's capability to now interact with live contract instances (see wETH used as instantiation)
• Mainnet forked, hardhat funded accounts. Of course, mainnet doesn't have to be just ETH (any Alchemy-supported network)
• Jest Docker mocks implemented on container creation (testing whether or not all modules are able to interact with Docker)
• Docker as optional input into localenv instantiation
• CI Time for all integration tests: (~1200 seconds). LE Unit tests reduced to sub 30 seconds.
• Cleaned up abstractions (included a new abstraction, ForkedNetwork to represent mainnet forks).

PR Checklist

• [x] Added Tests
• [x] Updated Documentation (incoming in a separate document)
• [x] Updated CHANGELOG.md for the appropriate package

Motivation

Integrate Connext Amarok into Nomad BridgeRouter to enable native fast liquidity.

Solution

PR Checklist

• [ ] Added Tests
• [x] Updated Documentation
• [x] Updated CHANGELOG.md for the appropriate package

Motivation

We want to deploy Nomad to Gnosis Chain (xDai)

Solution

Deploy Nomad to Gnosis Chain (xDai)! Save the updated config, governance actions, and verification for posterity + peer review.

PR Checklist

• [ ] Added Tests
• [ ] Updated Documentation
• [ ] Updated CHANGELOG.md for the appropriate package

Motivation

To realise an upgrade (and update the implementation address of the beacons) we need to execute some governance call batches,

Solution

Build a script that reads an updated configuration file (meaning that it has the new implementations) and produce the required call batches in a JSON file

PR Checklist

• [ ] Added Tests
• [x] Updated Documentation
• [x] Updated CHANGELOG.md for the appropriate package

Motivation

We wish to add some reasonable input validation to the optimisticSeconds field

Solution

Ensure optimisticSeconds is greater than 25 minutes & less than 1 year.

PR Checklist

• [ ] Added Tests
• [ ] Updated Documentation
• [ ] Updated CHANGELOG.md for the appropriate package

Motivation

Methodology

• for each asset, totalAffected is equal to the total outstanding bridged amount.
• this equals
  • (1) the amount of that asset ever bridged out to other chains,
  • minus (2) the total amount of that asset ever bridged in to its origin domain
• the resulting figure is the total outstanding amount it is still possible to bridge in
• total amount bridged out can be determined by
  • querying all Send events where token = asset address and taking the sum of amount field
• total amount bridged in can be determined by
  • querying all Receive events where token = asset address and taking the sum of amount field

Solution

Attached in the PR's changelog is a GRAPHQL file demonstrating the queries currently used to get to the target numbers. This is to be deleted upon merge.

PR Checklist

• [ ] Added Tests
• [ ] Updated Documentation
• [ ] Updated CHANGELOG.md for the appropriate package

Motivation

This is a followup to the local environment RFC https://doc.clickup.com/14205595/d/h/dhgmv-10480/8b498d6fedd36f7, which should help contributors and developers set up local testing environments for Nomad.

Solution

The RFC Spec listed here

Changelog:

• Restored and cleaned up previously broken contract and agent deployment abstractions (it works now!)
• Dockerized hardhat and agent image are now ready to use for further integration tests (integration tests themselves are WIP and coming in a later ticket)
• Yarn bootup / yarn start scripts ready for booting up the local environment (further yarn scripts for individual integration tests to be implemented in following PR)
• Removed jokes on variables, set up changelog to track oncoming additions and changes
• Added Bunyan for logging capabilities

Testing:

• Tested multiple times on local machine, with the help of the tooling team @yourbuddyconner @kekonen @luketchang @Imti et. al.
• Documentation and .env.examples updated to fit the currently running setup.

PR Checklist

• [x] Added Tests
• [x] Updated Documentation
• [x] Updated CHANGELOG.md for the appropriate package

Motivation

Enable UI testing of recovery flows

Solution

A mock accountant that implements most basic flows

PR Checklist

• [ ] Added Tests
• [ ] Updated Documentation
• [x] Updated CHANGELOG.md for the appropriate package

Motivation

We'd like the ability to run the fork tests on any chain

Solution

Refactor to use CallBatch domain wherever possible so that the test domain can be changed in one single place in Reboot.t.sol.

PR Checklist

• [ ] Added Tests
• [ ] Updated Documentation
• [ ] Updated CHANGELOG.md for the appropriate package

Motivation

Add watcher enrollment to Avail bridge demo.

Solution

Add enrollment and changes to env vars to pass.

PR Checklist

• [ ] Added Tests
• [x] Updated Documentation
• [ ] Updated CHANGELOG.md for the appropriate package

Package

deploy

Describe the feature you would like

Enable the easy override of the default RPC endpoints that exist in the protocol configuration via an overrides file.

Additional context

No response

Package

deploy, contracts-core, contracts-bridge, contracts-router

Describe the feature you would like

need to design how we will handle versioning between contracts-core, contracts-bridge, contracts-router, and deploy packages

As the contract code changes, the deploy script must sometimes also change (namely, if constructor / initialize / setup function interfaces change)

However, these packages are used in different places which each have different needs

Use cases:

• production deploys: always want to deploy from tagged contract version
• development + staging deploys: probably want to deploy from tagged contract version?
• local environment testing: by default, want the local workspace version; may also want to be able to choose tagged versions too

We cannot just update the package.json of deploy package to choose which contracts to use, as we also need to use the right version of the deploy package itself

Additional context

Relevant: all comments / discussion on this PR: https://github.com/nomad-xyz/monorepo/pull/312