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 (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-10-29T11:25:54.000Z (7 months ago)
- Last Synced: 2024-10-29T11:47:54.063Z (7 months ago)
- Language: Go
- Homepage: https://omni.network
- Size: 45.9 MB
- Stars: 86
- Watchers: 6
- Forks: 53
- Open Issues: 42
-
Metadata Files:
- Readme: README.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
## 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
├── cli: Omni command line interface.
├── contracts: Solidity contracts and related software.
├── docs: Resources and website for https://docs.omni.network.
├── e2e: Deployments, testing, and live network management.
├── halo: Omni consensus client.
├── lib: Core libraries used across the Omni stack.
├── monitor: Monitoring service for the network.
├── octane: Cosmos SDK module for the EVM.
├── relayer: Relayer service for cross-chain messages and transactions.
├── scripts: Utility scripts for development and operational tasks.
├── sdk: SDK for building applications with Omni.
├── solver: Reference implementation for SolverNet.
## 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) or reach out to chat with the team.
Follow these steps to set up a functional development environment:
1. Install Docker Desktop.
2. Setup commit signing:
2a. [Create a PGP key pair](https://docs.github.com/en/authentication/managing-commit-signature-verification/generating-a-new-gpg-key)
2b. [Add the public key to Github](https://docs.github.com/en/authentication/managing-commit-signature-verification/adding-a-gpg-key-to-your-github-account).
2c. [Enabled commit signing](https://docs.github.com/en/authentication/managing-commit-signature-verification/signing-commits)
2d. [Troubleshoot any issues](https://gist.github.com/paolocarrasco/18ca8fe6e63490ae1be23e84a7039374)
3. Run `make setup` to initialize your dev environment. See `Makefile` for details.
## Security
Omni has a bug bounty program via Immunefi. You can find more information [here](https://immunefi.com/bug-bounty/omni-network/information/).