Documentation ¶
Index ¶
- func AllInvariants(k Keeper) sdk.Invariant
- func NewMsgServerImpl(keeper Keeper) types.MsgServer
- func NonnegativeBalanceInvariant(k ViewKeeper) sdk.Invariant
- func RegisterInvariants(ir sdk.InvariantRegistry, k Keeper)
- func TotalSupply(k Keeper) sdk.Invariant
- type BalancesIndexes
- type BaseKeeper
- func (k BaseKeeper) AllBalances(ctx context.Context, req *types.QueryAllBalancesRequest) (*types.QueryAllBalancesResponse, error)
- func (k BaseKeeper) Balance(ctx context.Context, req *types.QueryBalanceRequest) (*types.QueryBalanceResponse, error)
- func (k BaseKeeper) BurnCoins(ctx context.Context, moduleName string, amounts sdk.Coins) error
- func (k BaseKeeper) DelegateCoins(ctx context.Context, delegatorAddr, moduleAccAddr sdk.AccAddress, ...) error
- func (k BaseKeeper) DelegateCoinsFromAccountToModule(ctx context.Context, senderAddr sdk.AccAddress, recipientModule string, ...) error
- func (k BaseKeeper) DenomMetadata(c context.Context, req *types.QueryDenomMetadataRequest) (*types.QueryDenomMetadataResponse, error)
- func (k BaseKeeper) DenomMetadataByQueryString(c context.Context, req *types.QueryDenomMetadataByQueryStringRequest) (*types.QueryDenomMetadataByQueryStringResponse, error)
- func (k BaseKeeper) DenomOwners(ctx context.Context, req *types.QueryDenomOwnersRequest) (*types.QueryDenomOwnersResponse, error)
- func (k BaseKeeper) DenomOwnersByQuery(ctx context.Context, req *types.QueryDenomOwnersByQueryRequest) (*types.QueryDenomOwnersByQueryResponse, error)
- func (k BaseKeeper) DenomsMetadata(c context.Context, req *types.QueryDenomsMetadataRequest) (*types.QueryDenomsMetadataResponse, error)
- func (k BaseKeeper) ExportGenesis(ctx context.Context) *types.GenesisState
- func (k BaseKeeper) GetAllDenomMetaData(ctx context.Context) []types.Metadata
- func (k BaseKeeper) GetDenomMetaData(ctx context.Context, denom string) (types.Metadata, bool)
- func (k BaseKeeper) GetPaginatedTotalSupply(ctx context.Context, pagination *query.PageRequest) (sdk.Coins, *query.PageResponse, error)
- func (k BaseKeeper) GetSupply(ctx context.Context, denom string) sdk.Coin
- func (k BaseKeeper) HasDenomMetaData(ctx context.Context, denom string) bool
- func (k BaseKeeper) HasSupply(ctx context.Context, denom string) bool
- func (k BaseKeeper) InitGenesis(ctx context.Context, genState *types.GenesisState)
- func (k BaseKeeper) IterateAllDenomMetaData(ctx context.Context, cb func(types.Metadata) bool)
- func (k BaseKeeper) MintCoins(ctx context.Context, moduleName string, amounts sdk.Coins) error
- func (k BaseKeeper) Params(ctx context.Context, req *types.QueryParamsRequest) (*types.QueryParamsResponse, error)
- func (k BaseKeeper) SendCoinsFromAccountToModule(ctx context.Context, senderAddr sdk.AccAddress, recipientModule string, ...) error
- func (k BaseKeeper) SendCoinsFromModuleToAccount(ctx context.Context, senderModule string, recipientAddr sdk.AccAddress, ...) error
- func (k BaseKeeper) SendCoinsFromModuleToModule(ctx context.Context, senderModule, recipientModule string, amt sdk.Coins) error
- func (k BaseKeeper) SendEnabled(goCtx context.Context, req *types.QuerySendEnabledRequest) (*types.QuerySendEnabledResponse, error)
- func (k BaseKeeper) SetDenomMetaData(ctx context.Context, denomMetaData types.Metadata)
- func (k BaseKeeper) SpendableBalanceByDenom(ctx context.Context, req *types.QuerySpendableBalanceByDenomRequest) (*types.QuerySpendableBalanceByDenomResponse, error)
- func (k BaseKeeper) SpendableBalances(ctx context.Context, req *types.QuerySpendableBalancesRequest) (*types.QuerySpendableBalancesResponse, error)
- func (k BaseKeeper) SupplyOf(c context.Context, req *types.QuerySupplyOfRequest) (*types.QuerySupplyOfResponse, error)
- func (k BaseKeeper) TotalSupply(ctx context.Context, req *types.QueryTotalSupplyRequest) (*types.QueryTotalSupplyResponse, error)
- func (k BaseKeeper) UndelegateCoins(ctx context.Context, moduleAccAddr, delegatorAddr sdk.AccAddress, ...) error
- func (k BaseKeeper) UndelegateCoinsFromModuleToAccount(ctx context.Context, senderModule string, recipientAddr sdk.AccAddress, ...) error
- func (k BaseKeeper) WithMintCoinsRestriction(check types.MintingRestrictionFn) BaseKeeper
- type BaseSendKeeper
- func (k BaseSendKeeper) AppendSendRestriction(restriction types.SendRestrictionFn)
- func (k BaseSendKeeper) BlockedAddr(addr sdk.AccAddress) bool
- func (k BaseSendKeeper) ClearSendRestriction()
- func (k BaseSendKeeper) DeleteSendEnabled(ctx context.Context, denoms ...string)
- func (k BaseSendKeeper) GetAllSendEnabledEntries(ctx context.Context) []types.SendEnabled
- func (k BaseSendKeeper) GetAuthority() string
- func (k BaseSendKeeper) GetBlockedAddresses() map[string]bool
- func (k BaseSendKeeper) GetParams(ctx context.Context) (params types.Params)
- func (k BaseSendKeeper) GetSendEnabledEntry(ctx context.Context, denom string) (types.SendEnabled, bool)
- func (k BaseSendKeeper) InputOutputCoins(ctx context.Context, input types.Input, outputs []types.Output) error
- func (k BaseSendKeeper) IsSendEnabledCoin(ctx context.Context, coin sdk.Coin) bool
- func (k BaseSendKeeper) IsSendEnabledCoins(ctx context.Context, coins ...sdk.Coin) error
- func (k BaseSendKeeper) IsSendEnabledDenom(ctx context.Context, denom string) bool
- func (k BaseSendKeeper) IterateSendEnabledEntries(ctx context.Context, cb func(denom string, sendEnabled bool) bool)
- func (k BaseSendKeeper) PrependSendRestriction(restriction types.SendRestrictionFn)
- func (k BaseSendKeeper) SendCoins(ctx context.Context, fromAddr, toAddr sdk.AccAddress, amt sdk.Coins) error
- func (k BaseSendKeeper) SetAllSendEnabled(ctx context.Context, entries []*types.SendEnabled)
- func (k BaseSendKeeper) SetParams(ctx context.Context, params types.Params) error
- func (k BaseSendKeeper) SetSendEnabled(ctx context.Context, denom string, value bool)
- type BaseViewKeeper
- func (k BaseViewKeeper) GetAccountsBalances(ctx context.Context) []types.Balance
- func (k BaseViewKeeper) GetAllBalances(ctx context.Context, addr sdk.AccAddress) sdk.Coins
- func (k BaseViewKeeper) GetBalance(ctx context.Context, addr sdk.AccAddress, denom string) sdk.Coin
- func (k BaseViewKeeper) HasBalance(ctx context.Context, addr sdk.AccAddress, amt sdk.Coin) bool
- func (k BaseViewKeeper) IterateAccountBalances(ctx context.Context, addr sdk.AccAddress, cb func(sdk.Coin) bool)
- func (k BaseViewKeeper) IterateAllBalances(ctx context.Context, cb func(sdk.AccAddress, sdk.Coin) bool)
- func (k BaseViewKeeper) IterateTotalSupply(ctx context.Context, cb func(sdk.Coin) bool)
- func (k BaseViewKeeper) LockedCoins(ctx context.Context, addr sdk.AccAddress) sdk.Coins
- func (k BaseViewKeeper) Logger() log.Logger
- func (k BaseViewKeeper) SpendableCoin(ctx context.Context, addr sdk.AccAddress, denom string) sdk.Coin
- func (k BaseViewKeeper) SpendableCoins(ctx context.Context, addr sdk.AccAddress) sdk.Coins
- func (k BaseViewKeeper) ValidateBalance(ctx context.Context, addr sdk.AccAddress) error
- type Keeper
- type Migrator
- type Querier
- type SendKeeper
- type ViewKeeper
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func AllInvariants ¶
AllInvariants runs all invariants of the X/bank module.
func NewMsgServerImpl ¶ added in v0.40.0
NewMsgServerImpl returns an implementation of the bank MsgServer interface for the provided Keeper.
func NonnegativeBalanceInvariant ¶
func NonnegativeBalanceInvariant(k ViewKeeper) sdk.Invariant
NonnegativeBalanceInvariant checks that all accounts in the application have non-negative balances
func RegisterInvariants ¶
func RegisterInvariants(ir sdk.InvariantRegistry, k Keeper)
RegisterInvariants registers the bank module invariants
func TotalSupply ¶
TotalSupply checks that the total supply reflects all the coins held in accounts
Types ¶
type BalancesIndexes ¶ added in v0.50.1
type BalancesIndexes struct {
Denom *indexes.ReversePair[sdk.AccAddress, string, math.Int]
}
func (BalancesIndexes) IndexesList ¶ added in v0.50.1
func (b BalancesIndexes) IndexesList() []collections.Index[collections.Pair[sdk.AccAddress, string], math.Int]
type BaseKeeper ¶
type BaseKeeper struct { BaseSendKeeper // contains filtered or unexported fields }
BaseKeeper manages transfers between accounts. It implements the Keeper interface.
func NewBaseKeeper ¶
func NewBaseKeeper( cdc codec.BinaryCodec, storeService store.KVStoreService, ak types.AccountKeeper, blockedAddrs map[string]bool, authority string, logger log.Logger, ) BaseKeeper
NewBaseKeeper returns a new BaseKeeper object with a given codec, dedicated store key, an AccountKeeper implementation, and a parameter Subspace used to store and fetch module parameters. The BaseKeeper also accepts a blocklist map. This blocklist describes the set of addresses that are not allowed to receive funds through direct and explicit actions, for example, by using a MsgSend or by using a SendCoinsFromModuleToAccount execution.
func (BaseKeeper) AllBalances ¶ added in v0.40.0
func (k BaseKeeper) AllBalances(ctx context.Context, req *types.QueryAllBalancesRequest) (*types.QueryAllBalancesResponse, error)
AllBalances implements the Query/AllBalances gRPC method
func (BaseKeeper) Balance ¶ added in v0.40.0
func (k BaseKeeper) Balance(ctx context.Context, req *types.QueryBalanceRequest) (*types.QueryBalanceResponse, error)
Balance implements the Query/Balance gRPC method
func (BaseKeeper) BurnCoins ¶
BurnCoins burns coins deletes coins from the balance of the module account. It will panic if the module account does not exist or is unauthorized.
func (BaseKeeper) DelegateCoins ¶
func (k BaseKeeper) DelegateCoins(ctx context.Context, delegatorAddr, moduleAccAddr sdk.AccAddress, amt sdk.Coins) error
DelegateCoins performs delegation by deducting amt coins from an account with address addr. For vesting accounts, delegations amounts are tracked for both vesting and vested coins. The coins are then transferred from the delegator address to a ModuleAccount address. If any of the delegation amounts are negative, an error is returned.
func (BaseKeeper) DelegateCoinsFromAccountToModule ¶
func (k BaseKeeper) DelegateCoinsFromAccountToModule( ctx context.Context, senderAddr sdk.AccAddress, recipientModule string, amt sdk.Coins, ) error
DelegateCoinsFromAccountToModule delegates coins and transfers them from a delegator account to a module account. It will panic if the module account does not exist or is unauthorized.
func (BaseKeeper) DenomMetadata ¶ added in v0.40.1
func (k BaseKeeper) DenomMetadata(c context.Context, req *types.QueryDenomMetadataRequest) (*types.QueryDenomMetadataResponse, error)
DenomMetadata implements Query/DenomMetadata gRPC method.
func (BaseKeeper) DenomMetadataByQueryString ¶ added in v0.50.1
func (k BaseKeeper) DenomMetadataByQueryString(c context.Context, req *types.QueryDenomMetadataByQueryStringRequest) (*types.QueryDenomMetadataByQueryStringResponse, error)
DenomMetadataByQueryString is identical to DenomMetadata query, but receives request via query string.
func (BaseKeeper) DenomOwners ¶ added in v0.46.0
func (k BaseKeeper) DenomOwners( ctx context.Context, req *types.QueryDenomOwnersRequest, ) (*types.QueryDenomOwnersResponse, error)
func (BaseKeeper) DenomOwnersByQuery ¶ added in v0.50.3
func (k BaseKeeper) DenomOwnersByQuery(ctx context.Context, req *types.QueryDenomOwnersByQueryRequest) (*types.QueryDenomOwnersByQueryResponse, error)
DenomOwnersByQuery is identical to DenomOwner query, but receives denom values via query string.
func (BaseKeeper) DenomsMetadata ¶ added in v0.40.1
func (k BaseKeeper) DenomsMetadata(c context.Context, req *types.QueryDenomsMetadataRequest) (*types.QueryDenomsMetadataResponse, error)
DenomsMetadata implements Query/DenomsMetadata gRPC method.
func (BaseKeeper) ExportGenesis ¶ added in v0.40.0
func (k BaseKeeper) ExportGenesis(ctx context.Context) *types.GenesisState
ExportGenesis returns the bank module's genesis state.
func (BaseKeeper) GetAllDenomMetaData ¶ added in v0.40.0
func (k BaseKeeper) GetAllDenomMetaData(ctx context.Context) []types.Metadata
GetAllDenomMetaData retrieves all denominations metadata
func (BaseKeeper) GetDenomMetaData ¶ added in v0.40.0
GetDenomMetaData retrieves the denomination metadata. returns the metadata and true if the denom exists, false otherwise.
func (BaseKeeper) GetPaginatedTotalSupply ¶ added in v0.43.0
func (k BaseKeeper) GetPaginatedTotalSupply(ctx context.Context, pagination *query.PageRequest) (sdk.Coins, *query.PageResponse, error)
GetPaginatedTotalSupply queries for the supply, ignoring 0 coins, with a given pagination
func (BaseKeeper) HasDenomMetaData ¶ added in v0.46.0
func (k BaseKeeper) HasDenomMetaData(ctx context.Context, denom string) bool
HasDenomMetaData checks if the denomination metadata exists in store.
func (BaseKeeper) HasSupply ¶ added in v0.45.0
func (k BaseKeeper) HasSupply(ctx context.Context, denom string) bool
HasSupply checks if the supply coin exists in store.
func (BaseKeeper) InitGenesis ¶ added in v0.40.0
func (k BaseKeeper) InitGenesis(ctx context.Context, genState *types.GenesisState)
InitGenesis initializes the bank module's state from a given genesis state.
func (BaseKeeper) IterateAllDenomMetaData ¶ added in v0.40.0
IterateAllDenomMetaData iterates over all the denominations metadata and provides the metadata to a callback. If true is returned from the callback, iteration is halted.
func (BaseKeeper) MintCoins ¶
MintCoins creates new coins from thin air and adds it to the module account. It will panic if the module account does not exist or is unauthorized.
func (BaseKeeper) Params ¶ added in v0.40.0
func (k BaseKeeper) Params(ctx context.Context, req *types.QueryParamsRequest) (*types.QueryParamsResponse, error)
Params implements the gRPC service handler for querying x/bank parameters.
func (BaseKeeper) SendCoinsFromAccountToModule ¶
func (k BaseKeeper) SendCoinsFromAccountToModule( ctx context.Context, senderAddr sdk.AccAddress, recipientModule string, amt sdk.Coins, ) error
SendCoinsFromAccountToModule transfers coins from an AccAddress to a ModuleAccount. It will panic if the module account does not exist.
func (BaseKeeper) SendCoinsFromModuleToAccount ¶
func (k BaseKeeper) SendCoinsFromModuleToAccount( ctx context.Context, senderModule string, recipientAddr sdk.AccAddress, amt sdk.Coins, ) error
SendCoinsFromModuleToAccount transfers coins from a ModuleAccount to an AccAddress. It will panic if the module account does not exist. An error is returned if the recipient address is black-listed or if sending the tokens fails.
func (BaseKeeper) SendCoinsFromModuleToModule ¶
func (k BaseKeeper) SendCoinsFromModuleToModule( ctx context.Context, senderModule, recipientModule string, amt sdk.Coins, ) error
SendCoinsFromModuleToModule transfers coins from a ModuleAccount to another. It will panic if either module account does not exist.
func (BaseKeeper) SendEnabled ¶ added in v0.47.0
func (k BaseKeeper) SendEnabled(goCtx context.Context, req *types.QuerySendEnabledRequest) (*types.QuerySendEnabledResponse, error)
func (BaseKeeper) SetDenomMetaData ¶ added in v0.40.0
func (k BaseKeeper) SetDenomMetaData(ctx context.Context, denomMetaData types.Metadata)
SetDenomMetaData sets the denominations metadata
func (BaseKeeper) SpendableBalanceByDenom ¶ added in v0.47.0
func (k BaseKeeper) SpendableBalanceByDenom(ctx context.Context, req *types.QuerySpendableBalanceByDenomRequest) (*types.QuerySpendableBalanceByDenomResponse, error)
SpendableBalanceByDenom implements a gRPC query handler for retrieving an account's spendable balance for a specific denom.
func (BaseKeeper) SpendableBalances ¶ added in v0.45.2
func (k BaseKeeper) SpendableBalances(ctx context.Context, req *types.QuerySpendableBalancesRequest) (*types.QuerySpendableBalancesResponse, error)
SpendableBalances implements a gRPC query handler for retrieving an account's spendable balances.
func (BaseKeeper) SupplyOf ¶ added in v0.40.0
func (k BaseKeeper) SupplyOf(c context.Context, req *types.QuerySupplyOfRequest) (*types.QuerySupplyOfResponse, error)
SupplyOf implements the Query/SupplyOf gRPC method
func (BaseKeeper) TotalSupply ¶ added in v0.40.0
func (k BaseKeeper) TotalSupply(ctx context.Context, req *types.QueryTotalSupplyRequest) (*types.QueryTotalSupplyResponse, error)
TotalSupply implements the Query/TotalSupply gRPC method
func (BaseKeeper) UndelegateCoins ¶
func (k BaseKeeper) UndelegateCoins(ctx context.Context, moduleAccAddr, delegatorAddr sdk.AccAddress, amt sdk.Coins) error
UndelegateCoins performs undelegation by crediting amt coins to an account with address addr. For vesting accounts, undelegation amounts are tracked for both vesting and vested coins. The coins are then transferred from a ModuleAccount address to the delegator address. If any of the undelegation amounts are negative, an error is returned.
func (BaseKeeper) UndelegateCoinsFromModuleToAccount ¶
func (k BaseKeeper) UndelegateCoinsFromModuleToAccount( ctx context.Context, senderModule string, recipientAddr sdk.AccAddress, amt sdk.Coins, ) error
UndelegateCoinsFromModuleToAccount undelegates the unbonding coins and transfers them from a module account to the delegator account. It will panic if the module account does not exist or is unauthorized.
func (BaseKeeper) WithMintCoinsRestriction ¶ added in v0.44.7
func (k BaseKeeper) WithMintCoinsRestriction(check types.MintingRestrictionFn) BaseKeeper
WithMintCoinsRestriction restricts the bank Keeper used within a specific module to have restricted permissions on minting via function passed in parameter. Previous restriction functions can be nested as such:
bankKeeper.WithMintCoinsRestriction(restriction1).WithMintCoinsRestriction(restriction2)
type BaseSendKeeper ¶
type BaseSendKeeper struct { BaseViewKeeper // contains filtered or unexported fields }
BaseSendKeeper only allows transfers between accounts without the possibility of creating coins. It implements the SendKeeper interface.
func NewBaseSendKeeper ¶
func NewBaseSendKeeper( cdc codec.BinaryCodec, storeService store.KVStoreService, ak types.AccountKeeper, blockedAddrs map[string]bool, authority string, logger log.Logger, ) BaseSendKeeper
func (BaseSendKeeper) AppendSendRestriction ¶ added in v0.50.1
func (k BaseSendKeeper) AppendSendRestriction(restriction types.SendRestrictionFn)
AppendSendRestriction adds the provided SendRestrictionFn to run after previously provided restrictions.
func (BaseSendKeeper) BlockedAddr ¶ added in v0.40.0
func (k BaseSendKeeper) BlockedAddr(addr sdk.AccAddress) bool
BlockedAddr checks if a given address is restricted from receiving funds.
func (BaseSendKeeper) ClearSendRestriction ¶ added in v0.50.1
func (k BaseSendKeeper) ClearSendRestriction()
ClearSendRestriction removes the send restriction (if there is one).
func (BaseSendKeeper) DeleteSendEnabled ¶ added in v0.47.0
func (k BaseSendKeeper) DeleteSendEnabled(ctx context.Context, denoms ...string)
DeleteSendEnabled deletes the SendEnabled flags for one or more denoms. If a denom is provided that doesn't have a SendEnabled entry, it is ignored.
func (BaseSendKeeper) GetAllSendEnabledEntries ¶ added in v0.47.0
func (k BaseSendKeeper) GetAllSendEnabledEntries(ctx context.Context) []types.SendEnabled
GetAllSendEnabledEntries gets all the SendEnabled entries that are stored. Any denominations not returned use the default value (set in Params).
func (BaseSendKeeper) GetAuthority ¶ added in v0.47.0
func (k BaseSendKeeper) GetAuthority() string
GetAuthority returns the x/bank module's authority.
func (BaseSendKeeper) GetBlockedAddresses ¶ added in v0.47.0
func (k BaseSendKeeper) GetBlockedAddresses() map[string]bool
GetBlockedAddresses returns the full list of addresses restricted from receiving funds.
func (BaseSendKeeper) GetParams ¶ added in v0.40.0
func (k BaseSendKeeper) GetParams(ctx context.Context) (params types.Params)
GetParams returns the total set of bank parameters.
func (BaseSendKeeper) GetSendEnabledEntry ¶ added in v0.47.0
func (k BaseSendKeeper) GetSendEnabledEntry(ctx context.Context, denom string) (types.SendEnabled, bool)
GetSendEnabledEntry gets a SendEnabled entry for the given denom. The second return argument is true iff a specific entry exists for the given denom.
func (BaseSendKeeper) InputOutputCoins ¶
func (k BaseSendKeeper) InputOutputCoins(ctx context.Context, input types.Input, outputs []types.Output) error
InputOutputCoins performs multi-send functionality. It accepts an input that corresponds to a series of outputs. It returns an error if the input and outputs don't line up or if any single transfer of tokens fails.
func (BaseSendKeeper) IsSendEnabledCoin ¶ added in v0.43.0
IsSendEnabledCoin returns the current SendEnabled status of the provided coin's denom
func (BaseSendKeeper) IsSendEnabledCoins ¶ added in v0.43.0
IsSendEnabledCoins checks the coins provided and returns an ErrSendDisabled if any of the coins are not configured for sending. Returns nil if sending is enabled for all provided coins.
func (BaseSendKeeper) IsSendEnabledDenom ¶ added in v0.47.0
func (k BaseSendKeeper) IsSendEnabledDenom(ctx context.Context, denom string) bool
IsSendEnabledDenom returns the current SendEnabled status of the provided denom.
func (BaseSendKeeper) IterateSendEnabledEntries ¶ added in v0.47.0
func (k BaseSendKeeper) IterateSendEnabledEntries(ctx context.Context, cb func(denom string, sendEnabled bool) bool)
IterateSendEnabledEntries iterates over all the SendEnabled entries.
func (BaseSendKeeper) PrependSendRestriction ¶ added in v0.50.1
func (k BaseSendKeeper) PrependSendRestriction(restriction types.SendRestrictionFn)
PrependSendRestriction adds the provided SendRestrictionFn to run before previously provided restrictions.
func (BaseSendKeeper) SendCoins ¶
func (k BaseSendKeeper) SendCoins(ctx context.Context, fromAddr, toAddr sdk.AccAddress, amt sdk.Coins) error
SendCoins transfers amt coins from a sending account to a receiving account. An error is returned upon failure.
func (BaseSendKeeper) SetAllSendEnabled ¶ added in v0.47.0
func (k BaseSendKeeper) SetAllSendEnabled(ctx context.Context, entries []*types.SendEnabled)
SetAllSendEnabled sets all the provided SendEnabled entries in the bank store.
func (BaseSendKeeper) SetParams ¶ added in v0.40.0
SetParams sets the total set of bank parameters.
Note: params.SendEnabled is deprecated but it should be here regardless.
func (BaseSendKeeper) SetSendEnabled ¶
func (k BaseSendKeeper) SetSendEnabled(ctx context.Context, denom string, value bool)
SetSendEnabled sets the SendEnabled flag for a denom to the provided value.
type BaseViewKeeper ¶
type BaseViewKeeper struct { Schema collections.Schema Supply collections.Map[string, math.Int] DenomMetadata collections.Map[string, types.Metadata] SendEnabled collections.Map[string, bool] Balances *collections.IndexedMap[collections.Pair[sdk.AccAddress, string], math.Int, BalancesIndexes] Params collections.Item[types.Params] // contains filtered or unexported fields }
BaseViewKeeper implements a read only keeper implementation of ViewKeeper.
func NewBaseViewKeeper ¶
func NewBaseViewKeeper(cdc codec.BinaryCodec, storeService store.KVStoreService, ak types.AccountKeeper, logger log.Logger) BaseViewKeeper
NewBaseViewKeeper returns a new BaseViewKeeper.
func (BaseViewKeeper) GetAccountsBalances ¶ added in v0.40.0
func (k BaseViewKeeper) GetAccountsBalances(ctx context.Context) []types.Balance
GetAccountsBalances returns all the accounts balances from the store.
func (BaseViewKeeper) GetAllBalances ¶
func (k BaseViewKeeper) GetAllBalances(ctx context.Context, addr sdk.AccAddress) sdk.Coins
GetAllBalances returns all the account balances for the given account address.
func (BaseViewKeeper) GetBalance ¶
func (k BaseViewKeeper) GetBalance(ctx context.Context, addr sdk.AccAddress, denom string) sdk.Coin
GetBalance returns the balance of a specific denomination for a given account by address.
func (BaseViewKeeper) HasBalance ¶
func (k BaseViewKeeper) HasBalance(ctx context.Context, addr sdk.AccAddress, amt sdk.Coin) bool
HasBalance returns whether or not an account has at least amt balance.
func (BaseViewKeeper) IterateAccountBalances ¶
func (k BaseViewKeeper) IterateAccountBalances(ctx context.Context, addr sdk.AccAddress, cb func(sdk.Coin) bool)
IterateAccountBalances iterates over the balances of a single account and provides the token balance to a callback. If true is returned from the callback, iteration is halted.
func (BaseViewKeeper) IterateAllBalances ¶
func (k BaseViewKeeper) IterateAllBalances(ctx context.Context, cb func(sdk.AccAddress, sdk.Coin) bool)
IterateAllBalances iterates over all the balances of all accounts and denominations that are provided to a callback. If true is returned from the callback, iteration is halted.
func (BaseViewKeeper) IterateTotalSupply ¶ added in v0.43.0
IterateTotalSupply iterates over the total supply calling the given cb (callback) function with the balance of each coin. The iteration stops if the callback returns true.
func (BaseViewKeeper) LockedCoins ¶
func (k BaseViewKeeper) LockedCoins(ctx context.Context, addr sdk.AccAddress) sdk.Coins
LockedCoins returns all the coins that are not spendable (i.e. locked) for an account by address. For standard accounts, the result will always be no coins. For vesting accounts, LockedCoins is delegated to the concrete vesting account type.
func (BaseViewKeeper) Logger ¶
func (k BaseViewKeeper) Logger() log.Logger
Logger returns a module-specific logger.
func (BaseViewKeeper) SpendableCoin ¶ added in v0.47.0
func (k BaseViewKeeper) SpendableCoin(ctx context.Context, addr sdk.AccAddress, denom string) sdk.Coin
SpendableCoin returns the balance of specific denomination of spendable coins for an account by address. If the account has no spendable coin, a zero Coin is returned.
func (BaseViewKeeper) SpendableCoins ¶
func (k BaseViewKeeper) SpendableCoins(ctx context.Context, addr sdk.AccAddress) sdk.Coins
SpendableCoins returns the total balances of spendable coins for an account by address. If the account has no spendable coins, an empty Coins slice is returned.
func (BaseViewKeeper) ValidateBalance ¶
func (k BaseViewKeeper) ValidateBalance(ctx context.Context, addr sdk.AccAddress) error
ValidateBalance validates all balances for a given account address returning an error if any balance is invalid. It will check for vesting account types and validate the balances against the original vesting balances.
CONTRACT: ValidateBalance should only be called upon genesis state. In the case of vesting accounts, balances may change in a valid manner that would otherwise yield an error from this call.
type Keeper ¶
type Keeper interface { SendKeeper WithMintCoinsRestriction(types.MintingRestrictionFn) BaseKeeper InitGenesis(context.Context, *types.GenesisState) ExportGenesis(context.Context) *types.GenesisState GetSupply(ctx context.Context, denom string) sdk.Coin HasSupply(ctx context.Context, denom string) bool GetPaginatedTotalSupply(ctx context.Context, pagination *query.PageRequest) (sdk.Coins, *query.PageResponse, error) IterateTotalSupply(ctx context.Context, cb func(sdk.Coin) bool) GetDenomMetaData(ctx context.Context, denom string) (types.Metadata, bool) HasDenomMetaData(ctx context.Context, denom string) bool SetDenomMetaData(ctx context.Context, denomMetaData types.Metadata) GetAllDenomMetaData(ctx context.Context) []types.Metadata IterateAllDenomMetaData(ctx context.Context, cb func(types.Metadata) bool) SendCoinsFromModuleToAccount(ctx context.Context, senderModule string, recipientAddr sdk.AccAddress, amt sdk.Coins) error SendCoinsFromModuleToModule(ctx context.Context, senderModule, recipientModule string, amt sdk.Coins) error SendCoinsFromAccountToModule(ctx context.Context, senderAddr sdk.AccAddress, recipientModule string, amt sdk.Coins) error DelegateCoinsFromAccountToModule(ctx context.Context, senderAddr sdk.AccAddress, recipientModule string, amt sdk.Coins) error UndelegateCoinsFromModuleToAccount(ctx context.Context, senderModule string, recipientAddr sdk.AccAddress, amt sdk.Coins) error MintCoins(ctx context.Context, moduleName string, amt sdk.Coins) error BurnCoins(ctx context.Context, moduleName string, amt sdk.Coins) error DelegateCoins(ctx context.Context, delegatorAddr, moduleAccAddr sdk.AccAddress, amt sdk.Coins) error UndelegateCoins(ctx context.Context, moduleAccAddr, delegatorAddr sdk.AccAddress, amt sdk.Coins) error types.QueryServer }
Keeper defines a module interface that facilitates the transfer of coins between accounts.
type Migrator ¶ added in v0.43.0
type Migrator struct {
// contains filtered or unexported fields
}
Migrator is a struct for handling in-place store migrations.
func NewMigrator ¶ added in v0.43.0
func NewMigrator(keeper BaseKeeper, legacySubspace exported.Subspace) Migrator
NewMigrator returns a new Migrator.
func (Migrator) Migrate1to2 ¶ added in v0.43.0
Migrate1to2 migrates from version 1 to 2.
func (Migrator) Migrate2to3 ¶ added in v0.46.0
Migrate2to3 migrates x/bank storage from version 2 to 3.
func (Migrator) Migrate3to4 ¶ added in v0.47.0
Migrate3to4 migrates x/bank storage from version 3 to 4.
func (Migrator) MigrateSendEnabledParams ¶ added in v0.47.6
MigrateSendEnabledParams get params from x/params and update the bank params.
type Querier ¶ added in v0.50.1
type Querier struct {
BaseKeeper
}
func NewQuerier ¶
func NewQuerier(keeper *BaseKeeper) Querier
type SendKeeper ¶
type SendKeeper interface { ViewKeeper AppendSendRestriction(restriction types.SendRestrictionFn) PrependSendRestriction(restriction types.SendRestrictionFn) ClearSendRestriction() InputOutputCoins(ctx context.Context, input types.Input, outputs []types.Output) error SendCoins(ctx context.Context, fromAddr, toAddr sdk.AccAddress, amt sdk.Coins) error GetParams(ctx context.Context) types.Params SetParams(ctx context.Context, params types.Params) error IsSendEnabledDenom(ctx context.Context, denom string) bool GetSendEnabledEntry(ctx context.Context, denom string) (types.SendEnabled, bool) SetSendEnabled(ctx context.Context, denom string, value bool) SetAllSendEnabled(ctx context.Context, sendEnableds []*types.SendEnabled) DeleteSendEnabled(ctx context.Context, denoms ...string) IterateSendEnabledEntries(ctx context.Context, cb func(denom string, sendEnabled bool) (stop bool)) GetAllSendEnabledEntries(ctx context.Context) []types.SendEnabled IsSendEnabledCoin(ctx context.Context, coin sdk.Coin) bool IsSendEnabledCoins(ctx context.Context, coins ...sdk.Coin) error BlockedAddr(addr sdk.AccAddress) bool GetBlockedAddresses() map[string]bool GetAuthority() string }
SendKeeper defines a module interface that facilitates the transfer of coins between accounts without the possibility of creating coins.
type ViewKeeper ¶
type ViewKeeper interface { ValidateBalance(ctx context.Context, addr sdk.AccAddress) error HasBalance(ctx context.Context, addr sdk.AccAddress, amt sdk.Coin) bool GetAllBalances(ctx context.Context, addr sdk.AccAddress) sdk.Coins GetAccountsBalances(ctx context.Context) []types.Balance GetBalance(ctx context.Context, addr sdk.AccAddress, denom string) sdk.Coin LockedCoins(ctx context.Context, addr sdk.AccAddress) sdk.Coins SpendableCoins(ctx context.Context, addr sdk.AccAddress) sdk.Coins SpendableCoin(ctx context.Context, addr sdk.AccAddress, denom string) sdk.Coin IterateAccountBalances(ctx context.Context, addr sdk.AccAddress, cb func(coin sdk.Coin) (stop bool)) IterateAllBalances(ctx context.Context, cb func(address sdk.AccAddress, coin sdk.Coin) (stop bool)) }
ViewKeeper defines a module interface that facilitates read only access to account balances.