Skip to content

Commit

Permalink
Update readme.md
Browse files Browse the repository at this point in the history
  • Loading branch information
laloquidity authored Jun 29, 2022
1 parent 71d6141 commit 1d6ed72
Showing 1 changed file with 10 additions and 10 deletions.
20 changes: 10 additions & 10 deletions readme.md
Original file line number Diff line number Diff line change
@@ -1,22 +1,22 @@
![black](https://user-images.githubusercontent.com/76499838/176236578-604faf74-3260-42dd-83bd-2717a5226cb5.png)

Onomy Arch is a bridge extended from AltheaNet's Gravity Bridge that was designed to run on the [Cosmos SDK blockchains](https://github.com/cosmos/cosmos-sdk) like the [Cosmos Hub](https://github.com/cosmos/gaia) focused on maximum design simplicity and efficiency. While initially a Cosmos <-> Ethereum bridge, Onomy has extended Gravity Bridge functionality with Arch by integrating additional chains to create a more inclusive cross-chain DeFi hub. Specifically, Arch pairs with the Onomy ecosystem of applications including the Onomy Exchange (hybrid orderbook + AMM DEX) and Onomy Access (multi-chain mobile wallet application) + more in future.
Onomy Arc is a bridge extended from AltheaNet's Gravity Bridge that was designed to run on the [Cosmos SDK blockchains](https://github.com/cosmos/cosmos-sdk) like the [Cosmos Hub](https://github.com/cosmos/gaia) focused on maximum design simplicity and efficiency. While initially a Cosmos <-> Ethereum bridge, Onomy has extended Gravity Bridge functionality with Arc by integrating additional chains to create a more inclusive cross-chain DeFi hub. Specifically, Arc pairs with the Onomy ecosystem of applications including the Onomy Exchange (hybrid orderbook + AMM DEX) and Onomy Access (multi-chain mobile wallet application) + more in future.

Additional functionality and integrations are audited by NCC Group.

## Documentation

### High level Explanation

Arch enables users to transfer tokens from an integrated chain to Onomy and back again by locking up tokens on integrated chain side, and minting equivalent tokens on the Onomy side. Arch is completely non-custodial, you only need to trust in the security of the Onomy chain itself - not some third party bridge administrators who could run off with your funds. The security of the Onomy chain, and thus Arch, is through the Onomy Validator Guild (OVG) which is comprised of a decentralized network of globally situated independent validator firms.
Arc enables users to transfer tokens from an integrated chain to Onomy and back again by locking up tokens on integrated chain side, and minting equivalent tokens on the Onomy side. Arc is completely non-custodial, you only need to trust in the security of the Onomy chain itself - not some third party bridge administrators who could run off with your funds. The security of the Onomy chain, and thus Arc, is through the Onomy Validator Guild (OVG) which is comprised of a decentralized network of globally situated independent validator firms.

### Code documentation

This documentation lives with the code it references and helps to understand the functions and data structures involved. This is useful if you are reviewing or working on the code.

* [Solidity Ethereum contract documentation](https://github.com/onomyprotocol/onomy-arch/blob/main/solidity/contracts/contract-explanation.md)
* [Solidity Ethereum contract documentation](https://github.com/onomyprotocol/onomy-arc/blob/main/solidity/contracts/contract-explanation.md)

* [Go Cosmos module documentation](https://github.com/onomyprotocol/onomy-arch/tree/main/module/x/gravity/spec)
* [Go Cosmos module documentation](https://github.com/onomyprotocol/onomy-arc/tree/main/module/x/gravity/spec)

### Specs

Expand All @@ -34,7 +34,7 @@ These are mid-level docs on the [design overview page](/docs/design/overview.md)

### Integrated EVM Chains

[Ethereum](https://github.com/onomyprotocol/onomy-arch/tree/main/) | [Avalanche](https://github.com/onomyprotocol/onomy-arch/tree/avax) | [Aurora](https://github.com/onomyprotocol/near-aurora-bridge) | [Polygon](https://github.com/onomyprotocol/onomy-arch/tree/polygon) | [Fantom](https://github.com/onomyprotocol/onomy-arch/tree/fantom) | [Neon](https://github.com/onomyprotocol/onomy-arch/tree/neon) | [Moonbeam](https://github.com/onomyprotocol/onomy-arch/tree/moonbeam)
[Ethereum](https://github.com/onomyprotocol/onomy-arc/tree/main/) | [Avalanche](https://github.com/onomyprotocol/onomy-arc/tree/avax) | [Aurora](https://github.com/onomyprotocol/near-aurora-bridge) | [Polygon](https://github.com/onomyprotocol/onomy-arc/tree/polygon) | [Fantom](https://github.com/onomyprotocol/onomy-arc/tree/fantom) | [Neon](https://github.com/onomyprotocol/onomy-arc/tree/neon) | [Moonbeam](https://github.com/onomyprotocol/onomy-arc/tree/moonbeam)

### Developer Guide

Expand All @@ -50,18 +50,18 @@ To contribute, refer to these guides.

## Status

Arch is running on Onomy Testnet with the Ethereum bridge integrated. Audits have been completed by NCC Group. Additional bridges are ready to be integrated or are under development.
Arc is running on Onomy Testnet with the Ethereum bridge integrated. Audits have been completed by NCC Group. Additional bridges are ready to be integrated or are under development.

It is your responsibility to understand the financial, legal, and other risks of using this software. There is no guarantee of functionality or safety. You use the Arch bridge entirely at your own risk.
It is your responsibility to understand the financial, legal, and other risks of using this software. There is no guarantee of functionality or safety. You use the Arc bridge entirely at your own risk.

## The design of Arch
## The design of Arc

- Trust in the integrity of Arch is anchored on the Onomy Network side. The signing of fraudulent validator set updates and transaction batches meant for the Ethereum contract, for example, is punished by slashing on the Cosmos chain.
- Trust in the integrity of Arc is anchored on the Onomy Network side. The signing of fraudulent validator set updates and transaction batches meant for the Ethereum contract, for example, is punished by slashing on the Cosmos chain.
- It is mandatory for validators to maintain a trusted Ethereum node. This removes all trust and game theory implications that usually arise from independent relayers, once again dramatically simplifying the design.

## Key design Components

- A highly efficient way of mirroring Onomy validator voting onto Ethereum. The Arch solidity contract has validator set updates costing ~500,000 gas ($2 @ 20gwei). This was tested through Althea Net's Gravity Bridge with a snapshot of the Cosmos Hub validator set containing 125 validators. Verifying the votes of the validator set is the most expensive on chain operation Gravity has to perform. Our highly optimized Solidity code provides enormous cost savings. Existing bridges incur more than double the gas costs for signature sets as small as 8 signers.
- A highly efficient way of mirroring Onomy validator voting onto Ethereum. The Arc solidity contract has validator set updates costing ~500,000 gas ($2 @ 20gwei). This was tested through Althea Net's Gravity Bridge with a snapshot of the Cosmos Hub validator set containing 125 validators. Verifying the votes of the validator set is the most expensive on chain operation Gravity has to perform. Our highly optimized Solidity code provides enormous cost savings. Existing bridges incur more than double the gas costs for signature sets as small as 8 signers.
- Transactions from Onomy to other chains are batched, batches have a base cost of ~500,000 gas ($2 @ 20gwei). Batches may contain arbitrary numbers of transactions within the limits of sends per block, allowing for costs to be heavily amortized on high volume bridges.

## Operational parameters ensuring security
Expand Down

0 comments on commit 1d6ed72

Please sign in to comment.