connext / monorepo

Connext is a modular stack for trust-minimized, generalized communication between blockchains.
https://docs.connext.network
MIT License
293 stars 173 forks source link
blockchain connext crosschain ethereum interoperability protocol
Logo [![Test Sops][sops-shield]][sops-url] [![Deploy Testnet][deploy-testnet-shield]][deploy-testnet-url] [![Build Test Deploy][build-test-deploy-shield]][build-test-deploy-url] [![Discord][discord-shield]][discord-url] [![Twitter][twitter-shield]][twitter-url]

About Connext

Connext is a public infrastructure powering fast, trust-minimized communication between blockchains.

Useful Links
Explore the docs »

View Mainnet Bridge
View Testnet Bridge (Connext Bacco)

Report Bug
Bug Bounty Program

Request Feature

Connext Architecture

The Connext architecture can be seen as a layered system, as follows :

Layer Protocol/Stakeholders
Application Layer Crosschain Applications (xApps), SDK
Liquidity Layer Routers, Sequencer
Messaging - Execution Layer Lighthouse, Sequencer
Messaging - Verification Layer Watcher
Messaging - Transport Layer AMBs

About Connext

Connext is a modular stack for trust-minimized, generalized communication between blockchains. Read More

Architecture

(⬆️ back to top)

First time setup

Use Node version 18.x. And Make sure you are on the latest yarn version:

To set up the containers, use Docker. If Docker is not already installed on your system, you can easily install it by clicking here.

Try running yarn to update everything. If you have issues, try deleting node_modules and yarn.lock. After deleting yarn.lock run touch yarn.lock since it does not like if there is no lock file.

Dev Environment

Setup Environment, by initiating the build:

Here yarn: Install deps, create symlinks, hoist packages. & yarn build:all: Build all packages.

To run RabbitMQ with the management plugin using Docker, run the following command:

docker run -it --rm --name rabbitmq -p 5672:5672 -p 15672:15672 rabbitmq:3.10-management

This command will download the latest RabbitMQ image with the management plugin and start a container with the name rabbitmq.

To run Redis, execute the following command:

docker run -it --rm --name redis -p 6379:6379 redis

This command will download the latest Redis image and start a container with the name Redis.

And now you are all ready to interact with Monorepo.

Individual commands can be run against workspaces as so (example for nxtp-utils package):

yarn workspace @connext/nxtp-utils test

You should be able to do everything from the root and not need to go into the individual package dirs. For example, adding an npm package:

yarn workspace @connext/nxtp-txservice add ethers

Run router:

Running Test

Run test:

Adding Packages

To add a new package that can be shared by the rest of the repo, you can use some convenience scripts that we have installed:

yarn tsp create @connext/test-lib --template node-lib

Note: The tsp tool is not required, it just makes boilerplate generation easier. If you want, you can copy paste stuff from other packages. Documentation on the tool is here.

To add the lib to be a dependency of a consuming app (i.e. the router):

yarn tsp add @connext/test-lib --cwd packages/router

Again, this can all be done without the tool, all it does is add some files and make some config changes.

Note: We use node-lib as the template for all the packages. There are some other included templates like browser-lib which didn't work with our bundling. We might need to revisit things for bundling reqs.

Publishing Packages

Contributing

Contributions are what makes the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

(⬆️ back to top)

License

Distributed under the MIT License. See LICENSE.txt for more information.

(⬆️ back to top)

Project Link: https://github.com/connext/monorepo

(⬆️ back to top)