https://github.com/omni-network/omni

Monorepo for Omni node, contracts and other related tools
https://github.com/omni-network/omni

Last synced: 3 months ago
JSON representation

Monorepo for Omni node, contracts and other related tools

• Host: GitHub
• URL: https://github.com/omni-network/omni
• Owner: omni-network
• License: gpl-3.0
• Created: 2023-12-15T14:10:27.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2024-05-22T10:09:56.000Z (8 months ago)
• Last Synced: 2024-05-22T10:39:15.133Z (8 months ago)
• Language: Go
• Homepage: https://omni.network
• Size: 25.9 MB
• Stars: 56
• Watchers: 6
• Forks: 26
• Open Issues: 12
• Metadata Files:
  • Readme: README.md
  • Contributing: docs/contributing.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Codeowners: .github/CODEOWNERS
  • Security: SECURITY.md

Awesome Lists containing this project

• awesome-avs - Repo
• awesome-avs - Repo

README

        
Omni Monorepo




    Monorepo for Omni node, contracts and other related tools.





    

        

    

    

        

    

    

        

    

    

        

    

    

        

    

    

        

    





    

        

    



## About Omni

This monorepo contains all source code for the Omni protocol. Omni's goal is to make it easy for smart contract developers to source liquidity and users from anywhere. The protocol consists of various components including an EVM and cross-chain messaging.

The [Omni Docs](https://docs.omni.network/) are the best place to get started learning about Omni.

## Quickstart

Ensure [go](https://go.dev/doc/install), [goreleaser](https://goreleaser.com/install/) and [docker](https://docs.docker.com/engine/install/) are installed.

```bash

# Build local docker containers

make build-docker

# Run the end-to-end tests on a local devnet

MANIFEST=devnet1 make e2e-run

# Start a local devnet

make devnet-deploy

# Stop the local devnet

make devnet-clean

```

_If any of above commands fail, see the [troubleshooting section](./e2e/README.md#troubleshooting)._

## Directory Structure


├── contracts: Solidity contracts and related software.

│ ├── core/: Core protocol smart contracts.

│ ├── avs/: Eigen AVS smart contracts.

│ ├── bindings/: Go smart contract bindings.

│ └── allocs/: Predeploy allocations.

├── docs: Documentation resources, including images and diagrams.

├── halo: The Halo instance, including application logic and attestation mechanisms.

│ ├── app: Application logic for Halo.

│ └── cmd: Command-line tools and utilities.

├── lib: Core libraries for various protocol functionalities.

│ ├── cchain: Consensus chain interaction utilities.

│ └── xchain: Cross-chain messaging and utilities.

├── octane: Octane is a modular framework for the EVM.

│ └── evmengine: The EVMEngine cosmos module.

├── relayer: Relayer service for cross-chain messages and transactions.

│ └── app: Application logic for the relayer service.

├── scripts: Utility scripts for development and operational tasks.

└── test: Testing suite for end-to-end, smoke, and utility testing.



## Contributing

We are open to contributions, but don't currently have a formal process for contributors. If you are interested, browse through [open issues](https://github.com/omni-network/omni/issues), read our [code of conduct](./CODE_OF_CONDUCT.md), or chat with the team.

Follow these steps to set up a functional development environment:

1. Install Docker Desktop.

2. [Create a PGP key pair](https://docs.github.com/en/authentication/managing-commit-signature-verification/generating-a-new-gpg-key) and [add the public key to Github](https://docs.github.com/en/authentication/managing-commit-signature-verification/adding-a-gpg-key-to-your-github-account).

3. Run `make setup` to initialize your dev environment. See `Makefile` for details.

## Security

Please refer to [SECURITY.md](./SECURITY.md).