Lido Terra Contracts

This monorepository contains the source code for the smart contracts implementing bAsset Protocol on the Terra blockchain.

You can find information about the architecture, usage, and function of the smart contracts on the official documentation site.

Contracts

Contract	Reference	Description
lido_terra_hub	doc	Manages minted bLunas and bonded Lunas
lido_terra_reward	doc	Manages the distribution of delegation rewards
lido_terra_token	doc	CW20 compliance
lido_terra_airdrop_registry	doc	Manages message fabricators for MIR and ANC airdrops
lido_terra_rewards_dispatcher	doc	Accumulates the rewards from Hub's delegations and manages the rewards
lido_terra_token_stluna	doc	CW20 compliance for stluna
lido_terra_validators_registry	doc	Approved validators whitelist

Development

Environment Setup

• Rust v1.55.0+
• wasm32-unknown-unknown target
• Docker

1. Install rustup via https://rustup.rs/

2. Run the following:

rustup default stable
rustup target add wasm32-unknown-unknown

3. Make sure Docker is installed

Unit / Integration Tests

Each contract contains Rust unit tests embedded within the contract source directories. You can run:

cargo test unit-test
cargo test integration-test

Compiling

After making sure tests pass, you can compile each contract with the following:

RUSTFLAGS='-C link-arg=-s' cargo wasm
cp ../../target/wasm32-unknown-unknown/release/cw1_subkeys.wasm .
ls -l cw1_subkeys.wasm
sha256sum cw1_subkeys.wasm

Production

For production builds, run the following:

docker run --rm -v "$(pwd)":/code \
  --mount type=volume,source="$(basename "$(pwd)")_cache",target=/code/target \
  --mount type=volume,source=registry_cache,target=/usr/local/cargo/registry \
  cosmwasm/workspace-optimizer:0.11.5

This performs several optimizations which can significantly reduce the final size of the contract binaries, which will be available inside the artifacts/ directory.

Documentation

Check you the documentation at https://lidofinance.github.io/terra-docs/.

License

Copyright 2021 Lido

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.