67 releases (29 stable)

3.15.0 Oct 1, 2024
3.14.0 Jun 4, 2024
3.13.0 Apr 26, 2024
3.7.0 Feb 13, 2024
0.14.0 Jul 25, 2022

#1 in #fees

Download history 37/week @ 2024-07-01 26/week @ 2024-07-08 66/week @ 2024-07-15 55/week @ 2024-07-22 202/week @ 2024-07-29 36/week @ 2024-08-05 42/week @ 2024-08-12 32/week @ 2024-08-19 61/week @ 2024-08-26 30/week @ 2024-09-02 63/week @ 2024-09-09 69/week @ 2024-09-16 186/week @ 2024-09-23 244/week @ 2024-09-30 28/week @ 2024-10-07 52/week @ 2024-10-14

512 downloads per month
Used in 22 crates (21 directly)

Apache-2.0

14KB
224 lines

SG1 Spec: Fair Burn

TODO 7/28/23 add deprecation note in favor of core/fairburn

Fair Burn is a specification for processing fees in Stargaze, influenced by EIP-1559.

With Fair Burn, a portion of fees are burned, and the remaining portion is distributed to stakers. Currently, 50% is burned, and 50% go to stakers.

Fair Burn also includes a way to incentivize custom smart contract development by distributing some of the fee to a developer address. This developer fee is substracted from the amount burned.

For example, if a developer address is provided, 40% fees will be burned, 10% will go to the developer address, and 50% will go to the Community Pool.

Governance Parameters

const FEE_BURN_PERCENT: u64 = 50;      // 50%
const DEV_INCENTIVE_PERCENT: u64 = 10; // 10%

API

Contracts can use Fair Burn via one of the following functions.

/// Burn and distribute fees and return an error if the fee is not enough
checked_fair_burn(info: &MessageInfo, fee: u128, developer: Option<Addr>) -> Result<Vec<SubMsg>, FeeError>

/// Burn and distribute fees, assuming the right fee is passed in
fair_burn(fee: u128, developer: Option<Addr>) -> Vec<SubMsg>

Custom contract developers can pass in a a developer address that will receive 10% of all fees.

Dependencies

~4–6MB
~126K SLoC