diff --git a/CHANGELOG.md b/CHANGELOG.md index 43b86a943c..56617abc91 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -143,3 +143,4 @@ Ref: https://keepachangelog.com/en/1.0.0/ * (docs) [\#490](https://github.com/line/lbm-sdk/pull/490) update documents on x/consortium * (docs) [\#602](https://github.com/line/lbm-sdk/pull/602) update outdated events in specs * (docs) [\#721](https://github.com/line/lbm-sdk/pull/721) update x/foundation specification +* (docs) [\#748](https://github.com/line/lbm-sdk/pull/748) add `GovMint` to x/foundation specification diff --git a/x/foundation/README.md b/x/foundation/README.md index 16c17b437d..1f5c69a1a1 100644 --- a/x/foundation/README.md +++ b/x/foundation/README.md @@ -31,6 +31,7 @@ back these foundation-specific functionalities. * [Msg/Revoke](#msgrevoke) * [Msg/FundTreasury](#msgfundtreasury) * [Msg/WithdrawFromTreasury](#msgwithdrawfromtreasury) + * [Msg/GovMint](#msggovmint) * [Events](#events) * [EventUpdateFoundationParams](#eventupdatefoundationparams) * [EventUpdateDecisionPolicy](#eventupdatedecisionpolicy) @@ -44,6 +45,7 @@ back these foundation-specific functionalities. * [EventRevoke](#eventrevoke) * [EventFundTreasury](#eventfundedtreasury) * [EventWithdrawFromTreasury](#eventwithdrawedfromtreasury) + * [EventGovMint](#eventgovmint) * [Client](#client) * [CLI](#cli) * [gRPC](#grpc) @@ -262,6 +264,12 @@ sending the message `Msg/WithdrawFromTreasury`. value again (irreversible), which means you must set it to a non-zero value in the genesis to make it work. +## GovMint + +When the chain is first started, it may be necessary to mint a large amount of +coins at most once for initial validators or for specific purposes. Newly minted +coins are transferred to the treasury pool. + # State ## Params @@ -476,7 +484,7 @@ Anyone can fund treasury with `MsgFundTreasury`. +++ https://github.com/line/lbm-sdk/blob/392277a33519d289154e8da27f05f9a6788ab076/proto/lbm/foundation/v1/tx.proto#L76-L81 -## Msg/WithdrawFromTresury +## Msg/WithdrawFromTreasury The foundation can withdraw coins from the treasury with `MsgWithdrawFromTreasury`. @@ -489,6 +497,17 @@ The message handling should fail if: * the address which receives the coins has no authorization of `ReceiveFromTreasuryAuthorization`. +## Msg/GovMint + +Massive minting is possible through 'MsgGovMint' up to 1 time after the chain is started. + ++++ https://github.com/line/lbm-sdk/blob/66988a235a0e01f7a1ee76d719d585ff35f0d176/proto/lbm/foundation/v1/tx.proto#L221-L225 + +The message handling should fail if: + +* the authority is not the module's authority. +* The remaining left count is 0. + # Events ## EventUpdateFoundationParams @@ -598,6 +617,14 @@ the treasury. | to | {toAddress} | | amount | {amount} | +## EventGovMint + +`EventGovMint` is an event emitted when coins are minted. + +| Attribute Key | Attribute Value | +|---------------|-----------------| +| amount | {amount} | + # Client ## CLI