The pool network is a WW-controlled collection of Automated Market Maker (AMM) pools of WW-selected tokens (WW pools) relevant to the chain of the pool network (e.g., Atom-Luna and Atom-Juno LPs on both Terra and Juno chains). The token price exchange in each pool in the local pool network loosely represents the "interchain price" for the token because when the price changes of one pool on one network (e.g., Juno) then the Interchain Command will take action to balance the price of the same pool on the other network(s) (e.g., Terra). These WW pools allow bots to arb the local dexes versus the "interchain price" that effectively decreases price disparities. Currently, users can find price disparities of up to 20% for the same token trading on different Cosmos blockchains.
White Whale's pool network is based on Terraswap, a Uniswap-inspired automated market-maker (AMM) protocol.
The code for the pool network can be found here.
| Name | Description |
|---|---|
terraswap_factory |
Factory used to create pools (pairs) |
terraswap_pair |
Pair (pool) contract |
stableswap_3pool |
Pool with 3 assets. |
terraswap_router |
Allows multi-hob swaps |
terraswap_token |
CW20 (ERC20 equivalent) token implementation. Used for creating LP tokens. |
incentive-factory |
Factory to create incentive contracts for the pools. |
incentive |
Contract spawned by the Incentive Factory to incentivize liquidity provision on specific pools. |
frontend_helper |
Contract to facilitate providing liquidity and locking it for incentives in one go. |
You will need Rust 1.64.0+ with wasm32-unknown-unknown target installed.
You can run unit tests on each contract directory via:
cargo test
To compile each individual contract, you can run:
cargo build
cargo wasm
Or for a production-ready (optimized) build, run the following from the white-whale-core repository:
scripts/build_release.sh
The optimized contracts are generated in the artifacts/ directory.