#pool #pair #astroport #contracts #smart-contracts #math #pcl

astroport-pcl-common

Common package contains math tools and utils for Astroport PCL pairs

3 releases (stable)

2.0.0-rc.1-tokenfactory Apr 22, 2024
1.1.1 Mar 26, 2024

#1556 in Magic Beans

Download history 211/week @ 2024-03-25 28/week @ 2024-04-01 95/week @ 2024-04-22

134 downloads per month

GPL-3.0-only

335KB
7.5K SLoC

Astroport Core

codecov

Multi pool type automated market-maker (AMM) protocol powered by smart contracts on the Terra blockchain.

Contracts diagram

contract diagram

General Contracts

Name Description
factory Pool creation factory
pair Pair with x*y=k curve
pair_stable Pair with stableswap invariant curve
pair_stable_bluna Pair with stableswap invariant curve handling bLUNA rewards for LPs
token CW20 (ERC20 equivalent) token implementation
router Multi-hop trade router
oracle TWAP oracles for x*y=k pool types
whitelist CW1 whitelist contract

Tokenomics Contracts

Tokenomics related smart contracts are hosted on ../contracts/tokenomics.

Name Description
generator Rewards generator for liquidity providers
generator_proxy_to_mirror Rewards generator proxy for liquidity providers
maker Fee collector and swapper
staking xASTRO staking contract
vesting ASTRO distributor for generator rewards
xastro_token xASTRO token contract

Building Contracts

You will need Rust 1.64.0+ with wasm32-unknown-unknown target installed.

You can compile each contract:

Go to contract directory and run

cargo wasm
cp ../../target/wasm32-unknown-unknown/release/astroport_token.wasm .
ls -l astroport_token.wasm
sha256sum astroport_token.wasm

You can run tests for all contracts

Run the following from the repository root

cargo test

For a production-ready (compressed) build:

Run the following from the repository root

./scripts/build_release.sh

The optimized contracts are generated in the artifacts/ directory.

Deployment

You can find versions and commits for actually deployed contracts here.

Docs

Docs can be generated using cargo doc --no-deps

Bug Bounty

The contracts in this repo are included in a bug bounty program.

Dependencies

~11MB
~218K SLoC