Skip to content

Aimeedeer/soroban-amm

 
 

Repository files navigation

Contributors Forks Stargazers Issues MIT License


Logo

Aquarius

Aquarius protocol is governed by DAO voting with AQUA tokens. Vote and participate in discussions to shape the future of Aquarius.

Report Bug · Request Feature

Table of Contents
  1. About The Project
  2. Getting Started
  3. Contributing
  4. Contact

About The Project

Aquarius Screen Shot

What is Aquarius?

Aquarius is a liquidity layer built on top of the Stellar network. Using a governance system powered by the AQUA token, holders can vote on proposals to change how the Aquarius protocol functions and vote for which Stellar DEX & AMM markets are incentivized with AQUA rewards. Top-voted markets see their liquidity providers receive hourly rewards paid in AQUA, creating a way to earn extra rewards when supporting markets on Stellar.

What's the Soroban?

Soroban is a smart contracts platform designed to be sensible, built-to-scale, batteries-included, and developer-friendly.

Soroban-powered AMMs

We plan to use Soroban to build Automated Market Maker (AMM) smart contracts and the distribution engine for AQUA liquidity rewards. AQUA rewards will incentivize users to provide liquidity to the Soroban AMM. The distribution engine will run as a set of Soroban smart contracts and will calculate and distribute liquidity rewards to LPs accordingly.

Smart Contracts

  • liquidity_pool - Exchange liquidity pool based on constant product formula (xy=k)
  • liquidity_pool_stableswap - Exchange liquidity pool designed for extremely efficient stablecoin trading and low risk, supplemental fee income for liquidity providers, without an opportunity cost. It allows users to trade between correlated cryptocurrencies with a bespoke low slippage, low fee algorithm.
  • token - SEP-0041 compatible token smart contract designed for liquidity pool share management
  • liquidity_pool_router - entry point and catalogue of liquidity pools which is capable to deploy new pools if necessary

Smart Contracts diagram

(back to top)

Built With

(back to top)

Getting Started

Prerequisites

Development setup

Project built using django framework, so setup is similar to generic django project.

Clone project

git clone git@github.com:AquaToken/soroban-amm.git

Build contracts

task build

Run tests

task test

(Optionally) Deploy & invoke contracts via soroban-cli

check the Soroban documentation: https://soroban.stellar.org/docs/reference/rpc

(back to top)

Contributing

Contributions are what make 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)

Contact

Email: hello@aqua.network Telegram chat: @aquarius_HOME Telegram news: @aqua_token Twitter: @aqua_token GitHub: @AquaToken Discord: @Aquarius Reddit: @AquariusAqua Medium: @aquarius-aqua

Project Link: https://github.com/AquaToken/soroban-amm

(back to top)

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Rust 100.0%