3495691493
<!-- The default pull request template is for types feat, fix, or refactor. For other templates, add one of the following parameters to the url: - template=docs.md - template=other.md --> ## Description Closes: #9897 Closes: #9905 Adds server implementation of Group module and wires it up in simapp --- ### Author Checklist *All items are required. Please add a note to the item if the item is not applicable and please add links to any relevant follow up issues.* I have... - [x] included the correct [type prefix](https://github.com/commitizen/conventional-commit-types/blob/v3.0.0/index.json) in the PR title - [ ] added `!` to the type prefix if API or client breaking change - [x] targeted the correct branch (see [PR Targeting](https://github.com/cosmos/cosmos-sdk/blob/master/CONTRIBUTING.md#pr-targeting)) - [x] provided a link to the relevant issue or specification - [x] followed the guidelines for [building modules](https://github.com/cosmos/cosmos-sdk/blob/master/docs/building-modules) - [x] included the necessary unit and integration [tests](https://github.com/cosmos/cosmos-sdk/blob/master/CONTRIBUTING.md#testing) - [ ] added a changelog entry to `CHANGELOG.md` - [x] included comments for [documenting Go code](https://blog.golang.org/godoc) - [ ] updated the relevant documentation or specification - [x] reviewed "Files changed" and left comments if necessary - [ ] confirmed all CI checks have passed ### Reviewers Checklist *All items are required. Please add a note if the item is not applicable and please add your handle next to the items reviewed if you only reviewed selected items.* I have... - [ ] confirmed the correct [type prefix](https://github.com/commitizen/conventional-commit-types/blob/v3.0.0/index.json) in the PR title - [ ] confirmed `!` in the type prefix if API or client breaking change - [ ] confirmed all author checklist items have been addressed - [ ] reviewed state machine logic - [ ] reviewed API design and naming - [ ] reviewed documentation is accurate - [ ] reviewed tests and test coverage - [ ] manually tested (if applicable)
122 lines
3.1 KiB
Go
122 lines
3.1 KiB
Go
// Package math provides helper functions for doing mathematical calculations and parsing for the ecocredit module.
|
|
package math
|
|
|
|
import (
|
|
"fmt"
|
|
|
|
"github.com/cockroachdb/apd/v2"
|
|
|
|
sdkerrors "github.com/cosmos/cosmos-sdk/types/errors"
|
|
"github.com/cosmos/cosmos-sdk/x/group/errors"
|
|
)
|
|
|
|
// Dec is a wrapper struct around apd.Decimal that does no mutation of apd.Decimal's when performing
|
|
// arithmetic, instead creating a new apd.Decimal for every operation ensuring usage is safe.
|
|
//
|
|
// Using apd.Decimal directly can be unsafe because apd operations mutate the underlying Decimal,
|
|
// but when copying the big.Int structure can be shared between Decimal instances causing corruption.
|
|
// This was originally discovered in regen0-network/mainnet#15.
|
|
type Dec struct {
|
|
dec apd.Decimal
|
|
}
|
|
|
|
func NewPositiveDecFromString(s string) (Dec, error) {
|
|
d, err := NewDecFromString(s)
|
|
if err != nil {
|
|
return Dec{}, errors.ErrInvalidDecString.Wrap(err.Error())
|
|
}
|
|
if !d.IsPositive() {
|
|
return Dec{}, errors.ErrInvalidDecString.Wrapf("expected a positive decimal, got %s", s)
|
|
}
|
|
return d, nil
|
|
}
|
|
|
|
func NewNonNegativeDecFromString(s string) (Dec, error) {
|
|
d, err := NewDecFromString(s)
|
|
if err != nil {
|
|
return Dec{}, errors.ErrInvalidDecString.Wrap(err.Error())
|
|
}
|
|
if d.IsNegative() {
|
|
return Dec{}, errors.ErrInvalidDecString.Wrapf("expected a non-negative decimal, got %s", s)
|
|
}
|
|
return d, nil
|
|
}
|
|
|
|
func (x Dec) IsPositive() bool {
|
|
return !x.dec.Negative && !x.dec.IsZero()
|
|
}
|
|
|
|
func NewDecFromString(s string) (Dec, error) {
|
|
d, _, err := apd.NewFromString(s)
|
|
if err != nil {
|
|
return Dec{}, errors.ErrInvalidDecString.Wrap(err.Error())
|
|
}
|
|
return Dec{*d}, nil
|
|
}
|
|
|
|
func (x Dec) String() string {
|
|
return x.dec.Text('f')
|
|
}
|
|
|
|
func NewDecFromInt64(x int64) Dec {
|
|
var res Dec
|
|
res.dec.SetInt64(x)
|
|
return res
|
|
}
|
|
|
|
// Add returns a new Dec with value `x+y` without mutating any argument and error if
|
|
// there is an overflow.
|
|
func (x Dec) Add(y Dec) (Dec, error) {
|
|
var z Dec
|
|
_, err := apd.BaseContext.Add(&z.dec, &x.dec, &y.dec)
|
|
return z, sdkerrors.Wrap(err, "decimal addition error")
|
|
}
|
|
|
|
// Sub returns a new Dec with value `x-y` without mutating any argument and error if
|
|
// there is an overflow.
|
|
func (x Dec) Sub(y Dec) (Dec, error) {
|
|
var z Dec
|
|
_, err := apd.BaseContext.Sub(&z.dec, &x.dec, &y.dec)
|
|
return z, sdkerrors.Wrap(err, "decimal subtraction error")
|
|
}
|
|
|
|
func (x Dec) Int64() (int64, error) {
|
|
return x.dec.Int64()
|
|
}
|
|
|
|
func (x Dec) Cmp(y Dec) int {
|
|
return x.dec.Cmp(&y.dec)
|
|
}
|
|
|
|
func (x Dec) IsEqual(y Dec) bool {
|
|
return x.dec.Cmp(&y.dec) == 0
|
|
}
|
|
|
|
func (x Dec) IsNegative() bool {
|
|
return x.dec.Negative && !x.dec.IsZero()
|
|
}
|
|
|
|
// Add adds x and y
|
|
func Add(x Dec, y Dec) (Dec, error) {
|
|
return x.Add(y)
|
|
}
|
|
|
|
func (x Dec) IsZero() bool {
|
|
return x.dec.IsZero()
|
|
}
|
|
|
|
// SubNonNegative subtracts the value of y from x and returns the result with
|
|
// arbitrary precision. Returns an error if the result is negative.
|
|
func SubNonNegative(x Dec, y Dec) (Dec, error) {
|
|
z, err := x.Sub(y)
|
|
if err != nil {
|
|
return Dec{}, err
|
|
}
|
|
|
|
if z.IsNegative() {
|
|
return z, fmt.Errorf("result negative during non-negative subtraction")
|
|
}
|
|
|
|
return z, nil
|
|
}
|