Osmosis
As the largest DEX in the Cosmos, Osmosis is a source of liquidity for over 50 sovereign blockchains connected via IBC. Pioneering in its approach, Osmosis offers a dynamic trading and liquidity provision experience, integrating non-IBC assets from other ecosystems, including: Bitcoin, Ethereum, Solana, Avalanche, and Polkadot. Initially adopting Balancer-style pools, Osmosis now also features a concentrated liquidity model that is orders of magnitude more capital efficient, meaning that significantly less liquidity is required to handle the same amount of trading volume with minimal slippage.
As a true Layer 1 appchain, Osmosis has greater control over the full blockchain stack than traditional smart contract DEXs, which must follow the code of the parent chain that it is built on. This fine-grained control has enabled, for example, the development of Superfluid Staking, an extension of Proof of Stake that allows assets at the application layer to be staked to secure the chain. The customizability of appchains also allows implementing features like the Protocol Revenue module, which enables Osmosis to conduct on-chain cyclic arbitrage on behalf of OSMO stakers, balancing prices across pools while generating real yield revenue from this volume. Additionally, as a sovereign appchain, Osmosis governance can vote on upgrades to the protocol. One example of this was the introduction of a Taker Fee, which switched on the collection of exchange fees to generate a diverse yield from Osmosis volume and distribute it to OSMO stakers.
Osmosis is bringing the centralized exchange experience to the decentralized world by building a cross-chain DEX and trading suite that aims to interconnect all chains via IBC. To reach this goal, Osmosis hosts an ever-expanding suite of DeFi applications, including: lending/borrowing, margin trading, strategy vaults, perpetuals, fiat on-ramping, NFTs, stablecoins, etc.—all of the functionalities that centralized exchanges offer, and more, but in the trust-minimized environment of decentralized finance.
System Requirements
This system spec has been tested by many users and validators and found
to be comfortable:
- Quad Core or larger AMD or Intel (amd64) CPU
- ARM CPUs like the Apple M1 are not supported at this time.
- 64GB RAM (A lot can be in swap)
- 1TB NVMe Storage
- 100MBPS bidirectional internet connection
You can run Osmosis on lower-spec hardware for each component, but you
may find that it is not highly performant or prone to crashing.
Documentation
For the most up to date documentation please visit
docs.osmosis.zone
Joining the Mainnet
Please visit the official instructions on how to join the Mainnet
here.
Thank you for supporting a healthy blockchain network and community by
running an Osmosis node!
Contributing
The contributing guide for Osmosis explains the branching structure, how
to use the SDK fork, and how to make / test updates to SDK branches.
Container Images
Release and development workflows publish images to GitHub Container Registry:
ghcr.io/osmosis-labs/osmosisghcr.io/osmosis-labs/osmosis-cosmovisorghcr.io/osmosis-labs/osmosis-devghcr.io/osmosis-labs/osmosis-dev-cosmovisorghcr.io/osmosis-labs/osmosis-e2e-init-chain
Release tags keep their version and variant suffixes, for example
ghcr.io/osmosis-labs/osmosis:32.0.0-alpine. The publishing workflows authenticate
with the repository's GITHUB_TOKEN and grant contents: read and
packages: write; Docker Hub credentials are no longer required.
After the first publish, a package administrator must set each new package's
visibility to public to allow anonymous pulls. If a package already exists,
ensure this repository has write access under the package's Actions settings.
See GitHub's container registry documentation.
Historical images remain on Docker Hub. E2E's pinned pre-upgrade images and the
legacy upgrade-handler generator still use those images. When selecting a new
pre-upgrade image published to GHCR, update both its repository and tag in
tests/e2e/containers/config.go.
LocalOsmosis
LocalOsmosis is a containerized local Osmosis testnet used for trying out new features locally.
LocalOsmosis documentation can be found here
