types

package
v0.2.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Nov 8, 2019 License: Apache-2.0 Imports: 30 Imported by: 0

Documentation

Index

Constants

View Source 
const (

	// AddrLen defines a valid address length
	AddrLen = 20
	// Bech32PrefixAccAddr defines the Bech32 prefix of an account's address
	Bech32MainPrefix = "hashgard"

	// Atom in https://github.com/satoshilabs/slips/blob/master/slip-0044.md
	TokenType = 118

	// BIP44Prefix is the parts of the BIP44 HD path that are fixed by
	// what we used during the fundraiser.
	FullFundraiserPath = "44'/118'/0'/0/0"

	// PrefixAccount is the prefix for account keys
	PrefixAccount = "acc"
	// PrefixValidator is the prefix for validator keys
	PrefixValidator = "val"
	// PrefixConsensus is the prefix for consensus keys
	PrefixConsensus = "cons"
	// PrefixPublic is the prefix for public keys
	PrefixPublic = "pub"
	// PrefixOperator is the prefix for operator keys
	PrefixOperator = "oper"

	// PrefixAddress is the prefix for addresses
	PrefixAddress = "addr"

	// Bech32PrefixAccAddr defines the Bech32 prefix of an account's address
	Bech32PrefixAccAddr = Bech32MainPrefix
	// Bech32PrefixAccPub defines the Bech32 prefix of an account's public key
	Bech32PrefixAccPub = Bech32MainPrefix + PrefixPublic
	// Bech32PrefixValAddr defines the Bech32 prefix of a validator's operator address
	Bech32PrefixValAddr = Bech32MainPrefix + PrefixValidator + PrefixOperator
	// Bech32PrefixValPub defines the Bech32 prefix of a validator's operator public key
	Bech32PrefixValPub = Bech32MainPrefix + PrefixValidator + PrefixOperator + PrefixPublic
	// Bech32PrefixConsAddr defines the Bech32 prefix of a consensus node address
	Bech32PrefixConsAddr = Bech32MainPrefix + PrefixValidator + PrefixConsensus
	// Bech32PrefixConsPub defines the Bech32 prefix of a consensus node public key
	Bech32PrefixConsPub = Bech32MainPrefix + PrefixValidator + PrefixConsensus + PrefixPublic
)
View Source 
const (
	Precision = 18

	// bytes required to represent the above precision
	// Ceiling[Log2[999 999 999 999 999 999]]
	DecimalPrecisionBits = 60
)

number of decimal places

View Source 
const (
	// Base error codes
	CodeOK                 CodeType = 0
	CodeInternal           CodeType = 1
	CodeTxDecode           CodeType = 2
	CodeInvalidSequence    CodeType = 3
	CodeUnauthorized       CodeType = 4
	CodeInsufficientFunds  CodeType = 5
	CodeUnknownRequest     CodeType = 6
	CodeInvalidAddress     CodeType = 7
	CodeInvalidPubKey      CodeType = 8
	CodeUnknownAddress     CodeType = 9
	CodeInsufficientTokens CodeType = 10
	CodeInvalidTokens      CodeType = 11
	CodeOutOfGas           CodeType = 12
	CodeMemoTooLarge       CodeType = 13
	CodeInsufficientFee    CodeType = 14
	CodeTooManySignatures  CodeType = 15
	CodeGasOverflow        CodeType = 16
	CodeNoSignatures       CodeType = 17

	// CodespaceRoot is a codespace for error codes in this file only.
	// Notice that 0 is an "unset" codespace, which can be overridden with
	// Error.WithDefaultCodespace().
	CodespaceUndefined CodespaceType = ""
	CodespaceRoot      CodespaceType = "sdk"
)

SDK error codes

View Source 
const (

	// default bond denomination
	DefaultBondDenom = "share"

	// Delay, in blocks, between when validator updates are returned to the
	// consensus-engine and when they are applied. For example, if
	// ValidatorUpdateDelay is set to X, and if a validator set update is
	// returned with new validators at the end of block 10, then the new
	// validators are expected to sign blocks beginning at block 11+X.
	//
	// This value is constant as this should not change without a hard fork.
	// For Tendermint this should be set to 1 block, for more details see:
	// https://tendermint.com/docs/spec/abci/apps.html#endblock
	ValidatorUpdateDelay int64 = 1
)

staking constants

View Source 
const (
	Unbonded  BondStatus = 0x00
	Unbonding BondStatus = 0x01
	Bonded    BondStatus = 0x02

	BondStatusUnbonded  = "Unbonded"
	BondStatusUnbonding = "Unbonding"
	BondStatusBonded    = "Bonded"
)

staking constants

View Source 
const (
	StoreTypeMulti     = types.StoreTypeMulti
	StoreTypeDB        = types.StoreTypeDB
	StoreTypeIAVL      = types.StoreTypeIAVL
	StoreTypeTransient = types.StoreTypeTransient
)

nolint - reexport

View Source 
const SortableTimeFormat = "2006-01-02T15:04:05.000000000"

Slight modification of the RFC3339Nano but it right pads all zeros and drops the time zone info

Variables

View Source 
var (
	EventTypeMessage = "message"

	AttributeKeyAction = "action"
	AttributeKeyModule = "module"
	AttributeKeySender = "sender"
	AttributeKeyAmount = "amount"
)

Common event types and attribute keys

View Source 
var (
	// This is set at compile time. Could be cleveldb, defaults is goleveldb.
	DBBackend = ""
)
View Source 
var PowerReduction = NewIntFromBigInt(new(big.Int).Exp(big.NewInt(10), big.NewInt(18), nil))

PowerReduction is the amount of staking shares required for 1 unit of consensus-engine power

Functions

func AppendMsgToErr 

func AppendMsgToErr(msg string, err string) string

appends a message to the head of the given error

func Bech32ifyAccPub 

func Bech32ifyAccPub(pub crypto.PubKey) (string, error)

Bech32ifyAccPub returns a Bech32 encoded string containing the Bech32PrefixAccPub prefix for a given account PubKey.

func Bech32ifyConsPub 

func Bech32ifyConsPub(pub crypto.PubKey) (string, error)

Bech32ifyConsPub returns a Bech32 encoded string containing the Bech32PrefixConsPub prefixfor a given consensus node's PubKey.

func Bech32ifyValPub 

func Bech32ifyValPub(pub crypto.PubKey) (string, error)

Bech32ifyValPub returns a Bech32 encoded string containing the Bech32PrefixValPub prefix for a given validator operator's PubKey.

func CodeToDefaultMsg 

func CodeToDefaultMsg(code CodeType) string

NOTE: Don't stringer this, we'll put better messages in later.

func CopyBytes 

func CopyBytes(bz []byte) (ret []byte)

copy bytes

func DecEq 

func DecEq(t *testing.T, exp, got Dec) (*testing.T, bool, string, string, string)

intended to be used with require/assert: require.True(DecEq(...))

func DecsEqual 

func DecsEqual(d1s, d2s []Dec) bool

test if two decimal arrays are equal

func DiffKVStores 

func DiffKVStores(a KVStore, b KVStore, prefixesToSkip [][]byte) (kvA cmn.KVPair, kvB cmn.KVPair, count int64, equal bool)

Compare two KVstores, return either the first key/value pair at which they differ and whether or not they are equal, skipping value comparison for a set of provided prefixes

func FormatInvariant 

func FormatInvariant(module, name, msg string) string

FormatInvariant returns a standardized invariant message.

func FormatTimeBytes 

func FormatTimeBytes(t time.Time) []byte

Formats a time.Time into a []byte that can be sorted

func GetAccPubKeyBech32 

func GetAccPubKeyBech32(pubkey string) (pk crypto.PubKey, err error)

GetAccPubKeyBech32 creates a PubKey for an account with a given public key string using the Bech32 Bech32PrefixAccPub prefix.

func GetConsPubKeyBech32 

func GetConsPubKeyBech32(pubkey string) (pk crypto.PubKey, err error)

GetConsPubKeyBech32 creates a PubKey for a consensus node with a given public key string using the Bech32 Bech32PrefixConsPub prefix.

func GetFromBech32 

func GetFromBech32(bech32str, prefix string) ([]byte, error)

GetFromBech32 decodes a bytestring from a Bech32 encoded string.

func GetValPubKeyBech32 

func GetValPubKeyBech32(pubkey string) (pk crypto.PubKey, err error)

GetValPubKeyBech32 creates a PubKey for a validator's operator with a given public key string using the Bech32 Bech32PrefixValPub prefix.

func InclusiveEndBytes 

func InclusiveEndBytes(inclusiveBytes []byte) (exclusiveBytes []byte)

InclusiveEndBytes returns the []byte that would end a range query such that the input would be included

func IntEq 

func IntEq(t *testing.T, exp, got Int) (*testing.T, bool, string, string, string)

intended to be used with require/assert: require.True(IntEq(...))

func MustBech32ifyAccPub 

func MustBech32ifyAccPub(pub crypto.PubKey) string

MustBech32ifyAccPub returns the result of Bech32ifyAccPub panicing on failure.

func MustBech32ifyConsPub 

func MustBech32ifyConsPub(pub crypto.PubKey) string

MustBech32ifyConsPub returns the result of Bech32ifyConsPub panicing on failure.

func MustBech32ifyValPub 

func MustBech32ifyValPub(pub crypto.PubKey) string

MustBech32ifyValPub returns the result of Bech32ifyValPub panicing on failure.

func MustGetAccPubKeyBech32 

func MustGetAccPubKeyBech32(pubkey string) (pk crypto.PubKey)

MustGetAccPubKeyBech32 returns the result of GetAccPubKeyBech32 panicing on failure.

func MustGetConsPubKeyBech32 

func MustGetConsPubKeyBech32(pubkey string) (pk crypto.PubKey)

MustGetConsPubKeyBech32 returns the result of GetConsPubKeyBech32 panicing on failure.

func MustGetValPubKeyBech32 

func MustGetValPubKeyBech32(pubkey string) (pk crypto.PubKey)

MustGetValPubKeyBech32 returns the result of GetValPubKeyBech32 panicing on failure.

func MustSortJSON 

func MustSortJSON(toSortJSON []byte) []byte

MustSortJSON is like SortJSON but panic if an error occurs, e.g., if the passed JSON isn't valid.

func NewDecFromStr 

func NewDecFromStr(str string) (d Dec, err Error)

create a decimal from an input decimal string. valid must come in the form: 

(-) whole integers (.) decimal integers

examples of acceptable input include: 

-123.456
456.7890
345
-456789

NOTE - An error will return if more decimal places are provided in the string than the constant Precision.

CONTRACT - This function does not mutate the input str.

func NewKVStoreKeys 

func NewKVStoreKeys(names ...string) map[string]*KVStoreKey

NewKVStoreKeys returns a map of new pointers to KVStoreKey's. Uses pointers so keys don't collide.

func NewLevelDB 

func NewLevelDB(name, dir string) (db dbm.DB, err error)

NewLevelDB instantiate a new LevelDB instance according to DBBackend.

func NewTransientStoreKeys 

func NewTransientStoreKeys(names ...string) map[string]*TransientStoreKey

NewTransientStoreKeys constructs a new map of TransientStoreKey's Must return pointers according to the ocap principle

func ParseTimeBytes 

func ParseTimeBytes(bz []byte) (time.Time, error)

Parses a []byte encoded using FormatTimeKey back into a time.Time

func PrefixEndBytes 

func PrefixEndBytes(prefix []byte) []byte

PrefixEndBytes returns the []byte that would end a range query for all []byte with a certain prefix Deals with last byte of prefix being FF without overflowing

func RegisterCodec 

func RegisterCodec(cdc *codec.Codec)

Register the sdk message type

func RegisterDenom 

func RegisterDenom(denom string, unit Dec) error

RegisterDenom registers a denomination with a corresponding unit. If the denomination is already registered, an error will be returned.

func SharesToConsensusPower 

func SharesToConsensusPower(shares Int) int64

SharesToConsensusPower - convert input shares to potential consensus-engine power

func SortJSON 

func SortJSON(toSortJSON []byte) ([]byte, error)

SortedJSON takes any JSON and returns it sorted by keys. Also, all white-spaces are removed. This method can be used to canonicalize JSON to be returned by GetSignBytes, e.g. for the ledger integration. If the passed JSON isn't valid it will return an error.

func Uint64ToBigEndian 

func Uint64ToBigEndian(i uint64) []byte

Uint64ToBigEndian - marshals uint64 to a bigendian byte slice so it can be sorted

func UintOverflow 

func UintOverflow(i *big.Int) error

UintOverflow returns true if a given unsigned integer overflows and false otherwise.

func VerifyAddressFormat 

func VerifyAddressFormat(bz []byte) error

VerifyAddressFormat verifies that the provided bytes form a valid address according to the default address rules or a custom address verifier set by GetConfig().SetAddressVerifier()

Types

type ABCIMessageLog 

type ABCIMessageLog struct {
	MsgIndex uint16 `json:"msg_index"`
	Success  bool   `json:"success"`
	Log      string `json:"log"`

	// Events contains a slice of Event objects that were emitted during some
	// execution.
	Events StringEvents `json:"events"`
}

ABCIMessageLog defines a structure containing an indexed tx ABCI message log.

func NewABCIMessageLog 

func NewABCIMessageLog(i uint16, success bool, log string, events Events) ABCIMessageLog

type ABCIMessageLogs 

type ABCIMessageLogs []ABCIMessageLog

ABCIMessageLogs represents a slice of ABCIMessageLog.

func ParseABCILogs 

func ParseABCILogs(logs string) (res ABCIMessageLogs, err error)

ParseABCILogs attempts to parse a stringified ABCI tx log into a slice of ABCIMessageLog types. It returns an error upon JSON decoding failure.

func (ABCIMessageLogs) String 

func (logs ABCIMessageLogs) String() (str string)

String implements the fmt.Stringer interface for the ABCIMessageLogs type.

type AccAddress 

type AccAddress []byte

AccAddress a wrapper around bytes meant to represent an account address. When marshaled to a string or JSON, it uses Bech32.

func AccAddressFromBech32 

func AccAddressFromBech32(address string) (addr AccAddress, err error)

AccAddressFromBech32 creates an AccAddress from a Bech32 string.

func AccAddressFromHex 

func AccAddressFromHex(address string) (addr AccAddress, err error)

AccAddressFromHex creates an AccAddress from a hex string.

func (AccAddress) Bytes 

func (aa AccAddress) Bytes() []byte

Bytes returns the raw address bytes.

func (AccAddress) Empty 

func (aa AccAddress) Empty() bool

Returns boolean for whether an AccAddress is empty

func (AccAddress) Equals 

func (aa AccAddress) Equals(aa2 Address) bool

Returns boolean for whether two AccAddresses are Equal

func (AccAddress) Format 

func (aa AccAddress) Format(s fmt.State, verb rune)

Format implements the fmt.Formatter interface. nolint: errcheck

func (AccAddress) Marshal 

func (aa AccAddress) Marshal() ([]byte, error)

Marshal returns the raw address bytes. It is needed for protobuf compatibility.

func (AccAddress) MarshalJSON 

func (aa AccAddress) MarshalJSON() ([]byte, error)

MarshalJSON marshals to JSON using Bech32.

func (AccAddress) MarshalYAML 

func (aa AccAddress) MarshalYAML() (interface{}, error)

MarshalYAML marshals to YAML using Bech32.

func (AccAddress) String 

func (aa AccAddress) String() string

String implements the Stringer interface.

func (*AccAddress) Unmarshal 

func (aa *AccAddress) Unmarshal(data []byte) error

Unmarshal sets the address to the given data. It is needed for protobuf compatibility.

func (*AccAddress) UnmarshalJSON 

func (aa *AccAddress) UnmarshalJSON(data []byte) error

UnmarshalJSON unmarshals from JSON assuming Bech32 encoding.

func (*AccAddress) UnmarshalYAML 

func (aa *AccAddress) UnmarshalYAML(data []byte) error

UnmarshalYAML unmarshals from JSON assuming Bech32 encoding.

type Address 

type Address interface {
	Equals(Address) bool
	Empty() bool
	Marshal() ([]byte, error)
	MarshalJSON() ([]byte, error)
	Bytes() []byte
	String() string
	Format(s fmt.State, verb rune)
}

Address is a common interface for different types of addresses used by the SDK

type AnteHandler 

type AnteHandler func(ctx Context, tx Tx, simulate bool) (newCtx Context, result Result, abort bool)

AnteHandler authenticates transactions, before their internal messages are handled. If newCtx.IsZero(), ctx is used instead.

type Attribute 

type Attribute struct {
	Key   string `json:"key"`
	Value string `json:"value,omitempty"`
}

Attribute defines an attribute wrapper where the key and value are strings instead of raw bytes.

func NewAttribute 

func NewAttribute(k, v string) Attribute

NewAttribute returns a new key/value Attribute object.

func (Attribute) String 

func (a Attribute) String() string

func (Attribute) ToKVPair 

func (a Attribute) ToKVPair() cmn.KVPair

ToKVPair converts an Attribute object into a Tendermint key/value pair.

type BeginBlocker 

type BeginBlocker func(ctx Context, req abci.RequestBeginBlock) abci.ResponseBeginBlock

BeginBlocker runs code before the transactions in a block

Note: applications which set create_empty_blocks=false will not have regular block timing and should use e.g. BFT timestamps rather than block height for any periodic BeginBlock logic

type BondStatus 

type BondStatus byte

BondStatus is the status of a validator

func (BondStatus) Equal 

func (b BondStatus) Equal(b2 BondStatus) bool

Equal compares two BondStatus instances

func (BondStatus) String 

func (b BondStatus) String() string

String implements the Stringer interface for BondStatus.

type CacheKVStore 

type CacheKVStore = types.CacheKVStore

nolint - reexport

type CacheMultiStore 

type CacheMultiStore = types.CacheMultiStore

nolint - reexport

type CacheWrap 

type CacheWrap = types.CacheWrap

nolint - reexport

type CacheWrapper 

type CacheWrapper = types.CacheWrapper

nolint - reexport

type CodeType 

type CodeType uint32

CodeType - ABCI code identifier within codespace

func (CodeType) IsOK 

func (code CodeType) IsOK() bool

IsOK - is everything okay?

type CodespaceType 

type CodespaceType string

CodespaceType - codespace identifier

type CommitID 

type CommitID = types.CommitID

nolint - reexport

type CommitKVStore 

type CommitKVStore = types.CommitKVStore

nolint - reexport

type CommitMultiStore 

type CommitMultiStore = types.CommitMultiStore

nolint - reexport

type CommitStore 

type CommitStore = types.CommitStore

nolint - reexport

type Committer 

type Committer = types.Committer

nolint - reexport

type Config 

type Config struct {
	// contains filtered or unexported fields
}

Config is the structure that holds the SDK configuration parameters. This could be used to initialize certain configuration parameters for the SDK.

func GetConfig 

func GetConfig() *Config

GetConfig returns the config instance for the SDK.

func (*Config) GetAddressVerifier 

func (config *Config) GetAddressVerifier() func([]byte) error

GetAddressVerifier returns the function to verify that addresses have the correct format

func (*Config) GetBech32AccountAddrPrefix 

func (config *Config) GetBech32AccountAddrPrefix() string

GetBech32AccountAddrPrefix returns the Bech32 prefix for account address

func (*Config) GetBech32AccountPubPrefix 

func (config *Config) GetBech32AccountPubPrefix() string

GetBech32AccountPubPrefix returns the Bech32 prefix for account public key

func (*Config) GetBech32ConsensusAddrPrefix 

func (config *Config) GetBech32ConsensusAddrPrefix() string

GetBech32ConsensusAddrPrefix returns the Bech32 prefix for consensus node address

func (*Config) GetBech32ConsensusPubPrefix 

func (config *Config) GetBech32ConsensusPubPrefix() string

GetBech32ConsensusPubPrefix returns the Bech32 prefix for consensus node public key

func (*Config) GetBech32ValidatorAddrPrefix 

func (config *Config) GetBech32ValidatorAddrPrefix() string

GetBech32ValidatorAddrPrefix returns the Bech32 prefix for validator address

func (*Config) GetBech32ValidatorPubPrefix 

func (config *Config) GetBech32ValidatorPubPrefix() string

GetBech32ValidatorPubPrefix returns the Bech32 prefix for validator public key

func (*Config) GetFullFundraiserPath 

func (config *Config) GetFullFundraiserPath() string

Get the FullFundraiserPath (BIP44Prefix) on the config

func (*Config) GetTokenType 

func (config *Config) GetTokenType() uint32

Get the BIP-0044 TokenType code on the config

func (*Config) GetTxEncoder 

func (config *Config) GetTxEncoder() TxEncoder

GetTxEncoder return function to encode transactions

func (*Config) Seal 

func (config *Config) Seal() *Config

Seal seals the config such that the config state could not be modified further

func (*Config) SetAddressVerifier 

func (config *Config) SetAddressVerifier(addressVerifier func([]byte) error)

SetAddressVerifier builds the Config with the provided function for verifying that addresses have the correct format

func (*Config) SetBech32PrefixForAccount 

func (config *Config) SetBech32PrefixForAccount(addressPrefix, pubKeyPrefix string)

SetBech32PrefixForAccount builds the Config with Bech32 addressPrefix and publKeyPrefix for accounts and returns the config instance

func (*Config) SetBech32PrefixForConsensusNode 

func (config *Config) SetBech32PrefixForConsensusNode(addressPrefix, pubKeyPrefix string)

SetBech32PrefixForConsensusNode builds the Config with Bech32 addressPrefix and publKeyPrefix for consensus nodes and returns the config instance

func (*Config) SetBech32PrefixForValidator 

func (config *Config) SetBech32PrefixForValidator(addressPrefix, pubKeyPrefix string)

SetBech32PrefixForValidator builds the Config with Bech32 addressPrefix and publKeyPrefix for validators 

and returns the config instance

func (*Config) SetFullFundraiserPath 

func (config *Config) SetFullFundraiserPath(fullFundraiserPath string)

Set the FullFundraiserPath (BIP44Prefix) on the config

func (*Config) SetTokenType 

func (config *Config) SetTokenType(tokenType uint32)

Set the BIP-0044 TokenType code on the config

func (*Config) SetTxEncoder 

func (config *Config) SetTxEncoder(encoder TxEncoder)

SetTxEncoder builds the Config with TxEncoder used to marshal StdTx to bytes

type ConsAddress 

type ConsAddress []byte

ConsAddress defines a wrapper around bytes meant to present a consensus node. When marshaled to a string or JSON, it uses Bech32.

func ConsAddressFromBech32 

func ConsAddressFromBech32(address string) (addr ConsAddress, err error)

ConsAddressFromBech32 creates a ConsAddress from a Bech32 string.

func ConsAddressFromHex 

func ConsAddressFromHex(address string) (addr ConsAddress, err error)

ConsAddressFromHex creates a ConsAddress from a hex string.

func GetConsAddress 

func GetConsAddress(pubkey crypto.PubKey) ConsAddress

get ConsAddress from pubkey

func (ConsAddress) Bytes 

func (ca ConsAddress) Bytes() []byte

Bytes returns the raw address bytes.

func (ConsAddress) Empty 

func (ca ConsAddress) Empty() bool

Returns boolean for whether an ConsAddress is empty

func (ConsAddress) Equals 

func (ca ConsAddress) Equals(ca2 Address) bool

Returns boolean for whether two ConsAddress are Equal

func (ConsAddress) Format 

func (ca ConsAddress) Format(s fmt.State, verb rune)

Format implements the fmt.Formatter interface. nolint: errcheck

func (ConsAddress) Marshal 

func (ca ConsAddress) Marshal() ([]byte, error)

Marshal returns the raw address bytes. It is needed for protobuf compatibility.

func (ConsAddress) MarshalJSON 

func (ca ConsAddress) MarshalJSON() ([]byte, error)

MarshalJSON marshals to JSON using Bech32.

func (ConsAddress) MarshalYAML 

func (ca ConsAddress) MarshalYAML() (interface{}, error)

MarshalYAML marshals to YAML using Bech32.

func (ConsAddress) String 

func (ca ConsAddress) String() string

String implements the Stringer interface.

func (*ConsAddress) Unmarshal 

func (ca *ConsAddress) Unmarshal(data []byte) error

Unmarshal sets the address to the given data. It is needed for protobuf compatibility.

func (*ConsAddress) UnmarshalJSON 

func (ca *ConsAddress) UnmarshalJSON(data []byte) error

UnmarshalJSON unmarshals from JSON assuming Bech32 encoding.

func (*ConsAddress) UnmarshalYAML 

func (ca *ConsAddress) UnmarshalYAML(data []byte) error

UnmarshalYAML unmarshals from YAML assuming Bech32 encoding.

type Context 

type Context struct {
	// contains filtered or unexported fields
}

Context is an immutable object contains all information needed to process a request.

It contains a context.Context object inside if you want to use that, but please do not over-use it. We try to keep all data structured and standard additions here would be better just to add to the Context struct

func NewContext 

func NewContext(ms MultiStore, header abci.Header, isCheckTx bool, logger log.Logger) Context

create a new context

func (Context) BlockGasMeter 

func (c Context) BlockGasMeter() GasMeter

func (Context) BlockHeader 

func (c Context) BlockHeader() abci.Header

clone the header before returning

func (Context) BlockHeight 

func (c Context) BlockHeight() int64

func (Context) BlockTime 

func (c Context) BlockTime() time.Time

func (Context) CacheContext 

func (c Context) CacheContext() (cc Context, writeCache func())

CacheContext returns a new Context with the multi-store cached and a new EventManager. The cached context is written to the context when writeCache is called.

func (Context) ChainID 

func (c Context) ChainID() string

func (Context) ConsensusParams 

func (c Context) ConsensusParams() *abci.ConsensusParams

func (Context) Context 

func (c Context) Context() context.Context

Read-only accessors

func (Context) EventManager 

func (c Context) EventManager() *EventManager

func (Context) GasMeter 

func (c Context) GasMeter() GasMeter

func (Context) IsCheckTx 

func (c Context) IsCheckTx() bool

func (Context) IsZero 

func (c Context) IsZero() bool

TODO: remove???

func (Context) KVStore 

func (c Context) KVStore(key StoreKey) KVStore

KVStore fetches a KVStore from the MultiStore.

func (Context) Logger 

func (c Context) Logger() log.Logger

func (Context) MinGasPrices 

func (c Context) MinGasPrices() DecTokens

func (Context) MultiStore 

func (c Context) MultiStore() MultiStore

func (Context) TransientStore 

func (c Context) TransientStore(key StoreKey) KVStore

TransientStore fetches a TransientStore from the MultiStore.

func (Context) TxBytes 

func (c Context) TxBytes() []byte

func (Context) Value 

func (c Context) Value(key interface{}) interface{}

Value is deprecated, provided for backwards compatibility Please use 

ctx.Context().Value(key)

instead of 

ctx.Value(key)

func (Context) VoteInfos 

func (c Context) VoteInfos() []abci.VoteInfo

func (Context) WithBlockGasMeter 

func (c Context) WithBlockGasMeter(meter GasMeter) Context

func (Context) WithBlockHeader 

func (c Context) WithBlockHeader(header abci.Header) Context

func (Context) WithBlockHeight 

func (c Context) WithBlockHeight(height int64) Context

func (Context) WithBlockTime 

func (c Context) WithBlockTime(newTime time.Time) Context

func (Context) WithChainID 

func (c Context) WithChainID(chainID string) Context

func (Context) WithConsensusParams 

func (c Context) WithConsensusParams(params *abci.ConsensusParams) Context

func (Context) WithContext 

func (c Context) WithContext(ctx context.Context) Context

func (Context) WithEventManager 

func (c Context) WithEventManager(em *EventManager) Context

func (Context) WithGasMeter 

func (c Context) WithGasMeter(meter GasMeter) Context

func (Context) WithIsCheckTx 

func (c Context) WithIsCheckTx(isCheckTx bool) Context

func (Context) WithLogger 

func (c Context) WithLogger(logger log.Logger) Context

func (Context) WithMinGasPrices 

func (c Context) WithMinGasPrices(gasPrices DecTokens) Context

func (Context) WithMultiStore 

func (c Context) WithMultiStore(ms MultiStore) Context

func (Context) WithProposer 

func (c Context) WithProposer(addr ConsAddress) Context

func (Context) WithTxBytes 

func (c Context) WithTxBytes(txBytes []byte) Context

func (Context) WithValue 

func (c Context) WithValue(key, value interface{}) Context

WithValue is deprecated, provided for backwards compatibility Please use 

ctx = ctx.WithContext(context.WithValue(ctx.Context(), key, false))

instead of 

ctx = ctx.WithValue(key, false)

func (Context) WithVoteInfos 

func (c Context) WithVoteInfos(voteInfo []abci.VoteInfo) Context

type Dec 

type Dec struct {
	*big.Int `json:"int"`
}

NOTE: never use new(Dec) or else we will panic unmarshalling into the nil embedded big.Int

func GetDenomUnit 

func GetDenomUnit(denom string) (Dec, bool)

GetDenomUnit returns a unit for a given denomination if it exists. A boolean is returned if the denomination is registered.

func MaxDec 

func MaxDec(d1, d2 Dec) Dec

maximum decimal between two

func MinDec 

func MinDec(d1, d2 Dec) Dec

minimum decimal between two

func MustNewDecFromStr 

func MustNewDecFromStr(s string) Dec

Decimal from string, panic on error

func NewDec 

func NewDec(i int64) Dec

create a new Dec from integer assuming whole number

func NewDecFromBigInt 

func NewDecFromBigInt(i *big.Int) Dec

create a new Dec from big integer assuming whole numbers CONTRACT: prec <= Precision

func NewDecFromBigIntWithPrec 

func NewDecFromBigIntWithPrec(i *big.Int, prec int64) Dec

create a new Dec from big integer assuming whole numbers CONTRACT: prec <= Precision

func NewDecFromInt 

func NewDecFromInt(i Int) Dec

create a new Dec from big integer assuming whole numbers CONTRACT: prec <= Precision

func NewDecFromIntWithPrec 

func NewDecFromIntWithPrec(i Int, prec int64) Dec

create a new Dec from big integer with decimal place at prec CONTRACT: prec <= Precision

func NewDecWithPrec 

func NewDecWithPrec(i, prec int64) Dec

create a new Dec from integer with decimal place at prec CONTRACT: prec <= Precision

func OneDec 

func OneDec() Dec

func SmallestDec 

func SmallestDec() Dec

func ZeroDec 

func ZeroDec() Dec

nolint - common values

func (Dec) Abs 

func (d Dec) Abs() Dec

func (Dec) Add 

func (d Dec) Add(d2 Dec) Dec

addition

func (Dec) Ceil 

func (d Dec) Ceil() Dec

Ceil returns the smallest interger value (as a decimal) that is greater than or equal to the given decimal.

func (Dec) Equal 

func (d Dec) Equal(d2 Dec) bool

func (Dec) Format 

func (d Dec) Format(s fmt.State, verb rune)

format decimal state

func (Dec) GT 

func (d Dec) GT(d2 Dec) bool

func (Dec) GTE 

func (d Dec) GTE(d2 Dec) bool

func (Dec) IsInteger 

func (d Dec) IsInteger() bool

is integer, e.g. decimals are zero

func (Dec) IsNegative 

func (d Dec) IsNegative() bool

func (Dec) IsNil 

func (d Dec) IsNil() bool

______________________________________________________________________________________________ nolint

func (Dec) IsPositive 

func (d Dec) IsPositive() bool

func (Dec) IsZero 

func (d Dec) IsZero() bool

func (Dec) LT 

func (d Dec) LT(d2 Dec) bool

func (Dec) LTE 

func (d Dec) LTE(d2 Dec) bool

func (Dec) MarshalAmino 

func (d Dec) MarshalAmino() (string, error)

wraps d.MarshalText()

func (Dec) MarshalJSON 

func (d Dec) MarshalJSON() ([]byte, error)

MarshalJSON marshals the decimal

func (Dec) MarshalYAML 

func (d Dec) MarshalYAML() (interface{}, error)

MarshalYAML returns Ythe AML representation.

func (Dec) Mul 

func (d Dec) Mul(d2 Dec) Dec

multiplication

func (Dec) MulInt 

func (d Dec) MulInt(i Int) Dec

multiplication

func (Dec) MulInt64 

func (d Dec) MulInt64(i int64) Dec

MulInt64 - multiplication with int64

func (Dec) MulTruncate 

func (d Dec) MulTruncate(d2 Dec) Dec

multiplication truncate

func (Dec) Neg 

func (d Dec) Neg() Dec

func (Dec) Quo 

func (d Dec) Quo(d2 Dec) Dec

quotient

func (Dec) QuoInt 

func (d Dec) QuoInt(i Int) Dec

quotient

func (Dec) QuoInt64 

func (d Dec) QuoInt64(i int64) Dec

QuoInt64 - quotient with int64

func (Dec) QuoRoundUp 

func (d Dec) QuoRoundUp(d2 Dec) Dec

quotient, round up

func (Dec) QuoTruncate 

func (d Dec) QuoTruncate(d2 Dec) Dec

quotient truncate

func (Dec) RoundInt 

func (d Dec) RoundInt() Int

RoundInt round the decimal using bankers rounding

func (Dec) RoundInt64 

func (d Dec) RoundInt64() int64

RoundInt64 rounds the decimal using bankers rounding

func (Dec) String 

func (d Dec) String() string

func (Dec) Sub 

func (d Dec) Sub(d2 Dec) Dec

subtraction

func (Dec) TruncateDec 

func (d Dec) TruncateDec() Dec

TruncateDec truncates the decimals from the number and returns a Dec

func (Dec) TruncateInt 

func (d Dec) TruncateInt() Int

TruncateInt truncates the decimals from the number and returns an Int

func (Dec) TruncateInt64 

func (d Dec) TruncateInt64() int64

TruncateInt64 truncates the decimals from the number and returns an int64

func (*Dec) UnmarshalAmino 

func (d *Dec) UnmarshalAmino(text string) (err error)

requires a valid JSON string - strings quotes and calls UnmarshalText

func (*Dec) UnmarshalJSON 

func (d *Dec) UnmarshalJSON(bz []byte) error

UnmarshalJSON defines custom decoding scheme

type DecToken 

type DecToken struct {
	Denom  string `json:"denom"`
	Amount Dec    `json:"amount"`
}

Tokens which can have additional decimal points

func NewDecToken 

func NewDecToken(denom string, amount Int) DecToken

func NewDecTokenFromDec 

func NewDecTokenFromDec(denom string, amount Dec) DecToken

func NewDecTokenFromToken 

func NewDecTokenFromToken(token Token) DecToken

func NewInt64DecToken 

func NewInt64DecToken(denom string, amount int64) DecToken

NewInt64DecToken returns a new DecToken with a denomination and amount. It will panic if the amount is negative or denom is invalid.

func ParseDecToken 

func ParseDecToken(tokenStr string) (token DecToken, err error)

ParseDecToken parses a decimal token from a string, returning an error if invalid. An empty string is considered invalid.

func (DecToken) Add 

func (token DecToken) Add(tokenB DecToken) DecToken

Adds amounts of two tokens with same denom

func (DecToken) IsEqual 

func (token DecToken) IsEqual(other DecToken) bool

IsEqual returns true if the two sets of Tokens have the same value.

func (DecToken) IsGTE 

func (token DecToken) IsGTE(other DecToken) bool

IsGTE returns true if they are the same type and the receiver is an equal or greater value.

func (DecToken) IsLT 

func (token DecToken) IsLT(other DecToken) bool

IsLT returns true if they are the same type and the receiver is a smaller value.

func (DecToken) IsNegative 

func (token DecToken) IsNegative() bool

IsNegative returns true if the token amount is negative and false otherwise.

TODO: Remove once unsigned integers are used.

func (DecToken) IsPositive 

func (token DecToken) IsPositive() bool

IsPositive returns true if token amount is positive.

TODO: Remove once unsigned integers are used.

func (DecToken) IsZero 

func (token DecToken) IsZero() bool

IsZero returns if the DecToken amount is zero.

func (DecToken) String 

func (token DecToken) String() string

String implements the Stringer interface for DecToken. It returns a human-readable representation of a decimal token.

func (DecToken) Sub 

func (token DecToken) Sub(tokenB DecToken) DecToken

Subtracts amounts of two tokens with same denom

func (DecToken) TruncateDecimal 

func (token DecToken) TruncateDecimal() (Token, DecToken)

TruncateDecimal returns a Token with a truncated decimal and a DecToken for the change. Note, the change may be zero.

type DecTokens 

type DecTokens []DecToken

tokens with decimal

func NewDecTokens 

func NewDecTokens(tokens Tokens) DecTokens

func ParseDecTokens 

func ParseDecTokens(tokensStr string) (DecTokens, error)

ParseDecTokens will parse out a list of decimal tokens separated by commas. If nothing is provided, it returns nil DecTokens. Returned decimal tokens are sorted.

func (DecTokens) Add 

func (tokens DecTokens) Add(tokensB DecTokens) DecTokens

Add adds two sets of DecTokens.

NOTE: Add operates under the invariant that tokens are sorted by denominations.

CONTRACT: Add will never return Tokens where one Token has a non-positive amount. In otherwords, IsValid will always return true.

func (DecTokens) AmountOf 

func (tokens DecTokens) AmountOf(denom string) Dec

returns the amount of a denom from dectokens

func (DecTokens) Empty 

func (tokens DecTokens) Empty() bool

Empty returns true if there are no tokens and false otherwise.

func (DecTokens) Intersect 

func (tokens DecTokens) Intersect(tokensB DecTokens) DecTokens

Intersect will return a new set of tokens which contains the minimum DecToken for common denoms found in both `tokens` and `tokensB`. For denoms not common to both `tokens` and `tokensB` the minimum is considered to be 0, thus they are not added to the final set.In other words, trim any denom amount from token which exceeds that of tokenB, such that (token.Intersect(tokenB)).IsLTE(tokenB).

func (DecTokens) IsAllPositive 

func (tokens DecTokens) IsAllPositive() bool

IsAllPositive returns true if there is at least one token and all currencies have a positive value.

TODO: Remove once unsigned integers are used.

func (DecTokens) IsAnyNegative 

func (tokens DecTokens) IsAnyNegative() bool

IsAnyNegative returns true if there is at least one token whose amount is negative; returns false otherwise. It returns false if the DecTokens set is empty too.

TODO: Remove once unsigned integers are used.

func (DecTokens) IsEqual 

func (tokens DecTokens) IsEqual(tokensB DecTokens) bool

IsEqual returns true if the two sets of DecTokens have the same value.

func (DecTokens) IsValid 

func (tokens DecTokens) IsValid() bool

IsValid asserts the DecTokens are sorted, have positive amount, and Denom does not contain upper case characters.

func (DecTokens) IsZero 

func (tokens DecTokens) IsZero() bool

return whether all tokens are zero

func (DecTokens) Len 

func (tokens DecTokens) Len() int

nolint

func (DecTokens) Less 

func (tokens DecTokens) Less(i, j int) bool

func (DecTokens) MulDec 

func (tokens DecTokens) MulDec(d Dec) DecTokens

MulDec multiplies all the tokens by a decimal.

CONTRACT: No zero tokens will be returned.

func (DecTokens) MulDecTruncate 

func (tokens DecTokens) MulDecTruncate(d Dec) DecTokens

MulDecTruncate multiplies all the decimal tokens by a decimal, truncating. It panics if d is zero.

CONTRACT: No zero tokens will be returned.

func (DecTokens) QuoDec 

func (tokens DecTokens) QuoDec(d Dec) DecTokens

QuoDec divides all the decimal tokens by a decimal. It panics if d is zero.

CONTRACT: No zero tokens will be returned.

func (DecTokens) QuoDecTruncate 

func (tokens DecTokens) QuoDecTruncate(d Dec) DecTokens

QuoDecTruncate divides all the decimal tokens by a decimal, truncating. It panics if d is zero.

CONTRACT: No zero tokens will be returned.

func (DecTokens) SafeSub 

func (tokens DecTokens) SafeSub(tokensB DecTokens) (DecTokens, bool)

SafeSub performs the same arithmetic as Sub but returns a boolean if any negative token amount was returned.

func (DecTokens) Sort 

func (tokens DecTokens) Sort() DecTokens

Sort is a helper function to sort the set of decimal tokens in-place.

func (DecTokens) String 

func (tokens DecTokens) String() string

String implements the Stringer interface for DecTokens. It returns a human-readable representation of decimal tokens.

func (DecTokens) Sub 

func (tokens DecTokens) Sub(tokensB DecTokens) DecTokens

Sub subtracts a set of DecTokens from another (adds the inverse).

func (DecTokens) Swap 

func (tokens DecTokens) Swap(i, j int)

func (DecTokens) TruncateDecimal 

func (tokens DecTokens) TruncateDecimal() (truncatedTokens Tokens, changeTokens DecTokens)

TruncateDecimal returns the tokens with truncated decimals and returns the change. Note, it will not return any zero-amount tokens in either the truncated or change tokens.

type EndBlocker 

type EndBlocker func(ctx Context, req abci.RequestEndBlock) abci.ResponseEndBlock

EndBlocker runs code after the transactions in a block and return updates to the validator set

Note: applications which set create_empty_blocks=false will not have regular block timing and should use e.g. BFT timestamps rather than block height for any periodic EndBlock logic

type Error 

type Error interface {

	// convenience
	TraceSDK(format string, args ...interface{}) Error

	// set codespace
	WithDefaultCodespace(CodespaceType) Error

	Code() CodeType
	Codespace() CodespaceType
	ABCILog() string
	Result() Result
	QueryResult() abci.ResponseQuery
	// contains filtered or unexported methods
}

sdk Error type

func ErrGasOverflow 

func ErrGasOverflow(msg string) Error

func ErrInsufficientFee 

func ErrInsufficientFee(msg string) Error

func ErrInsufficientFunds 

func ErrInsufficientFunds(msg string) Error

func ErrInsufficientTokens 

func ErrInsufficientTokens(msg string) Error

func ErrInternal 

func ErrInternal(msg string) Error

nolint

func ErrInvalidAddress 

func ErrInvalidAddress(msg string) Error

func ErrInvalidPubKey 

func ErrInvalidPubKey(msg string) Error

func ErrInvalidSequence 

func ErrInvalidSequence(msg string) Error

func ErrInvalidTokens 

func ErrInvalidTokens(msg string) Error

func ErrMemoTooLarge 

func ErrMemoTooLarge(msg string) Error

func ErrNoSignatures 

func ErrNoSignatures(msg string) Error

func ErrOutOfGas 

func ErrOutOfGas(msg string) Error

func ErrTooManySignatures 

func ErrTooManySignatures(msg string) Error

func ErrTxDecode 

func ErrTxDecode(msg string) Error

func ErrUnauthorized 

func ErrUnauthorized(msg string) Error

func ErrUnknownAddress 

func ErrUnknownAddress(msg string) Error

func ErrUnknownRequest 

func ErrUnknownRequest(msg string) Error

func NewError 

func NewError(codespace CodespaceType, code CodeType, format string, args ...interface{}) Error

NewError - create an error.

type ErrorGasOverflow 

type ErrorGasOverflow = types.ErrorGasOverflow

nolint - reexport

type ErrorOutOfGas 

type ErrorOutOfGas = types.ErrorOutOfGas

nolint - reexport

type Event 

type Event abci.Event

Event is a type alias for an ABCI Event

func NewEvent 

func NewEvent(ty string, attrs ...Attribute) Event

NewEvent creates a new Event object with a given type and slice of one or more attributes.

func (Event) AppendAttributes 

func (e Event) AppendAttributes(attrs ...Attribute) Event

AppendAttributes adds one or more attributes to an Event.

type EventManager 

type EventManager struct {
	// contains filtered or unexported fields
}

EventManager implements a simple wrapper around a slice of Event objects that can be emitted from.

func NewEventManager 

func NewEventManager() *EventManager

func (EventManager) ABCIEvents 

func (em EventManager) ABCIEvents() []abci.Event

ABCIEvents returns all stored Event objects as abci.Event objects.

func (*EventManager) EmitEvent 

func (em *EventManager) EmitEvent(event Event)

EmitEvent stores a single Event object.

func (*EventManager) EmitEvents 

func (em *EventManager) EmitEvents(events Events)

EmitEvents stores a series of Event objects.

func (*EventManager) Events 

func (em *EventManager) Events() Events

type Events 

type Events []Event

Events defines a slice of Event objects

func EmptyEvents 

func EmptyEvents() Events

EmptyEvents returns an empty slice of events.

func (Events) AppendEvent 

func (e Events) AppendEvent(event Event) Events

AppendEvent adds an Event to a slice of events.

func (Events) AppendEvents 

func (e Events) AppendEvents(events Events) Events

AppendEvents adds a slice of Event objects to an exist slice of Event objects.

func (Events) ToABCIEvents 

func (e Events) ToABCIEvents() []abci.Event

ToABCIEvents converts a slice of Event objects to a slice of abci.Event objects.

type Gas 

type Gas = types.Gas

nolint - reexport

type GasConfig 

type GasConfig = types.GasConfig

nolint - reexport

type GasMeter 

type GasMeter = types.GasMeter

nolint - reexport

func NewGasMeter 

func NewGasMeter(limit Gas) GasMeter

nolint - reexport

func NewInfiniteGasMeter 

func NewInfiniteGasMeter() GasMeter

nolint - reexport

type Handler 

type Handler func(ctx Context, msg Msg) Result

Handler defines the core of the state transition function of an application.

type InitChainer 

type InitChainer func(ctx Context, req abci.RequestInitChain) abci.ResponseInitChain

InitChainer initializes application state at genesis

type Int 

type Int struct {
	// contains filtered or unexported fields
}

Int wraps integer with 256 bit range bound Checks overflow, underflow and division by zero Exists in range from -(2^maxBitLen-1) to 2^maxBitLen-1

func MaxInt 

func MaxInt(i, i2 Int) Int

MaxInt returns the maximum between two integers.

func MinInt 

func MinInt(i1, i2 Int) Int

return the minimum of the ints

func NewInt 

func NewInt(n int64) Int

NewInt constructs Int from int64

func NewIntFromBigInt 

func NewIntFromBigInt(i *big.Int) Int

NewIntFromBigInt constructs Int from big.Int

func NewIntFromString 

func NewIntFromString(s string) (res Int, ok bool)

NewIntFromString constructs Int from string

func NewIntWithDecimal 

func NewIntWithDecimal(n int64, dec int) Int

NewIntWithDecimal constructs Int with decimal Result value is n*10^dec

func OneInt 

func OneInt() Int

OneInt returns Int value with one

func SharesFromConsensusPower 

func SharesFromConsensusPower(power int64) Int

SharesFromConsensusPower - convert input power to shares

func ZeroInt 

func ZeroInt() Int

ZeroInt returns Int value with zero

func (Int) Add 

func (i Int) Add(i2 Int) (res Int)

Add adds Int from another

func (Int) AddRaw 

func (i Int) AddRaw(i2 int64) Int

AddRaw adds int64 to Int

func (Int) BigInt 

func (i Int) BigInt() *big.Int

BigInt converts Int to big.Int

func (Int) Equal 

func (i Int) Equal(i2 Int) bool

Equal compares two Ints

func (Int) GT 

func (i Int) GT(i2 Int) bool

GT returns true if first Int is greater than second

func (Int) GTE 

func (i Int) GTE(i2 Int) bool

GTE returns true if receiver Int is greater than or equal to the parameter Int.

func (Int) Int64 

func (i Int) Int64() int64

Int64 converts Int to int64 Panics if the value is out of range

func (Int) IsInt64 

func (i Int) IsInt64() bool

IsInt64 returns true if Int64() not panics

func (Int) IsNegative 

func (i Int) IsNegative() bool

IsNegative returns true if Int is negative

func (Int) IsPositive 

func (i Int) IsPositive() bool

IsPositive returns true if Int is positive

func (Int) IsZero 

func (i Int) IsZero() bool

IsZero returns true if Int is zero

func (Int) LT 

func (i Int) LT(i2 Int) bool

LT returns true if first Int is lesser than second

func (Int) LTE 

func (i Int) LTE(i2 Int) bool

LTE returns true if first Int is less than or equal to second

func (Int) MarshalAmino 

func (i Int) MarshalAmino() (string, error)

MarshalAmino defines custom encoding scheme

func (Int) MarshalJSON 

func (i Int) MarshalJSON() ([]byte, error)

MarshalJSON defines custom encoding scheme

func (Int) MarshalYAML 

func (i Int) MarshalYAML() (interface{}, error)

MarshalYAML returns Ythe AML representation.

func (Int) Mod 

func (i Int) Mod(i2 Int) Int

Mod returns remainder after dividing with Int

func (Int) ModRaw 

func (i Int) ModRaw(i2 int64) Int

ModRaw returns remainder after dividing with int64

func (Int) Mul 

func (i Int) Mul(i2 Int) (res Int)

Mul multiples two Ints

func (Int) MulRaw 

func (i Int) MulRaw(i2 int64) Int

MulRaw multipies Int and int64

func (Int) Neg 

func (i Int) Neg() (res Int)

Neg negates Int

func (Int) Quo 

func (i Int) Quo(i2 Int) (res Int)

Quo divides Int with Int

func (Int) QuoRaw 

func (i Int) QuoRaw(i2 int64) Int

QuoRaw divides Int with int64

func (Int) Sign 

func (i Int) Sign() int

Sign returns sign of Int

func (Int) String 

func (i Int) String() string

Human readable string

func (Int) Sub 

func (i Int) Sub(i2 Int) (res Int)

Sub subtracts Int from another

func (Int) SubRaw 

func (i Int) SubRaw(i2 int64) Int

SubRaw subtracts int64 from Int

func (Int) ToDec 

func (i Int) ToDec() Dec

ToDec converts Int to Dec

func (*Int) UnmarshalAmino 

func (i *Int) UnmarshalAmino(text string) error

UnmarshalAmino defines custom decoding scheme

func (*Int) UnmarshalJSON 

func (i *Int) UnmarshalJSON(bz []byte) error

UnmarshalJSON defines custom decoding scheme

type Invariant 

type Invariant func(ctx Context) (string, bool)

An Invariant is a function which tests a particular invariant. The invariant returns a descriptive message about what happened and a boolean indicating whether the invariant has been broken. The simulator will then halt and print the logs.

type InvariantRegistry 

type InvariantRegistry interface {
	RegisterRoute(moduleName, route string, invar Invariant)
}

expected interface for registering invariants

type Invariants 

type Invariants []Invariant

Invariants defines a group of invariants

type Iterator 

type Iterator = types.Iterator

nolint - reexport

func KVStorePrefixIterator 

func KVStorePrefixIterator(kvs KVStore, prefix []byte) Iterator

Iterator over all the keys with a certain prefix in ascending order

func KVStoreReversePrefixIterator 

func KVStoreReversePrefixIterator(kvs KVStore, prefix []byte) Iterator

Iterator over all the keys with a certain prefix in descending order.

type KVPair 

type KVPair = types.KVPair

key-value result for iterator queries

type KVStore 

type KVStore = types.KVStore

nolint - reexport

type KVStoreKey 

type KVStoreKey = types.KVStoreKey

nolint - reexport

func NewKVStoreKey 

func NewKVStoreKey(name string) *KVStoreKey

NewKVStoreKey returns a new pointer to a KVStoreKey. Use a pointer so keys don't collide.

type Msg 

type Msg interface {

	// Return the message type.
	// Must be alphanumeric or empty.
	Route() string

	// Returns a human-readable string for the message, intended for utilization
	// within tags
	Type() string

	// ValidateBasic does a simple validation check that
	// doesn't require access to any other information.
	ValidateBasic() Error

	// Get the canonical byte representation of the Msg.
	GetSignBytes() []byte

	// Signers returns the addrs of signers that must sign.
	// CONTRACT: All signatures must be present to be valid.
	// CONTRACT: Returns addrs in some deterministic order.
	GetSigners() []AccAddress
}

Transactions messages must fulfill the Msg

type MultiStore 

type MultiStore = types.MultiStore

nolint - reexport

type PeerFilter 

type PeerFilter func(info string) abci.ResponseQuery

PeerFilter responds to p2p filtering queries from Tendermint

type PruningOptions 

type PruningOptions = types.PruningOptions

nolint - reexport

type Querier 

type Querier = func(ctx Context, path []string, req abci.RequestQuery) (res []byte, err Error)

Type for querier functions on keepers to implement to handle custom queries

type QueryRouter 

type QueryRouter interface {
	AddRoute(r string, h Querier) QueryRouter
	Route(path string) Querier
}

QueryRouter provides queryables for each query path.

type Queryable 

type Queryable = types.Queryable

nolint - reexport

type Request 

type Request = Context

Proposed rename, not done to avoid API breakage

type Result 

type Result struct {
	// Code is the response code, is stored back on the chain.
	Code CodeType

	// Codespace is the string referring to the domain of an error
	Codespace CodespaceType

	// Data is any data returned from the app.
	// Data has to be length prefixed in order to separate
	// results from multiple msgs executions
	Data []byte

	// Log contains the txs log information. NOTE: nondeterministic.
	Log string

	// GasWanted is the maximum units of work we allow this tx to perform.
	GasWanted uint64

	// GasUsed is the amount of gas actually consumed. NOTE: unimplemented
	GasUsed uint64

	// Events contains a slice of Event objects that were emitted during some
	// execution.
	Events Events
}

Result is the union of ResponseFormat and ResponseCheckTx.

func (Result) IsOK 

func (res Result) IsOK() bool

TODO: In the future, more codes may be OK.

type Router 

type Router interface {
	AddRoute(r string, h Handler) Router
	Route(path string) Handler
}

Router provides handlers for each transaction type.

type SearchTxsResult 

type SearchTxsResult struct {
	TotalCount int          `json:"total_count"` // Count of all txs
	Count      int          `json:"count"`       // Count of txs in current page
	PageNumber int          `json:"page_number"` // Index of current page, start from 1
	PageTotal  int          `json:"page_total"`  // Count of total pages
	Limit      int          `json:"limit"`       // Max count txs per page
	Txs        []TxResponse `json:"txs"`         // List of txs in current page
}

SearchTxsResult defines a structure for querying txs pageable

func NewSearchTxsResult 

func NewSearchTxsResult(totalCount, count, page, limit int, txs []TxResponse) SearchTxsResult

type Store 

type Store = types.Store

nolint - reexport

type StoreKey 

type StoreKey = types.StoreKey

nolint - reexport

type StoreType 

type StoreType = types.StoreType

nolint - reexport

type StringEvent 

type StringEvent struct {
	Type       string      `json:"type,omitempty"`
	Attributes []Attribute `json:"attributes,omitempty"`
}

StringAttribute defines en Event object wrapper where all the attributes contain key/value pairs that are strings instead of raw bytes.

func StringifyEvent 

func StringifyEvent(e abci.Event) StringEvent

StringifyEvent converts an Event object to a StringEvent object.

type StringEvents 

type StringEvents []StringEvent

StringAttributes defines a slice of StringEvents objects.

func StringifyEvents 

func StringifyEvents(events []abci.Event) StringEvents

StringifyEvents converts a slice of Event objects into a slice of StringEvent objects.

func (StringEvents) Flatten 

func (se StringEvents) Flatten() StringEvents

Flatten returns a flattened version of StringEvents by grouping all attributes per unique event type.

func (StringEvents) String 

func (se StringEvents) String() string

type TestMsg 

type TestMsg struct {
	// contains filtered or unexported fields
}

msg type for testing

func NewTestMsg 

func NewTestMsg(addrs ...AccAddress) *TestMsg

func (*TestMsg) GetSignBytes 

func (msg *TestMsg) GetSignBytes() []byte

func (*TestMsg) GetSigners 

func (msg *TestMsg) GetSigners() []AccAddress

func (*TestMsg) Route 

func (msg *TestMsg) Route() string

nolint

func (*TestMsg) Type 

func (msg *TestMsg) Type() string

func (*TestMsg) ValidateBasic 

func (msg *TestMsg) ValidateBasic() Error

type Token 

type Token struct {
	Denom string `json:"denom"`

	// To allow the use of unsigned integers (see: #1273) a larger refactor will
	// need to be made. So we use signed integers for now with safety measures in
	// place preventing negative values being used.
	Amount Int `json:"amount"`
}

Token hold some amount of one currency.

CONTRACT: A token will never hold a negative amount of any denomination.

TODO: Make field members private for further safety.

func ConvertToken 

func ConvertToken(token Token, denom string) (Token, error)

ConvertToken attempts to convert a token to a given denomination. If the given denomination is invalid or if neither denomination is registered, an error is returned.

func NewInt64Token 

func NewInt64Token(denom string, amount int64) Token

NewInt64Token returns a new token with a denomination and amount. It will panic if the amount is negative.

func NewToken 

func NewToken(denom string, amount Int) Token

NewToken returns a new token with a denomination and amount. It will panic if the amount is negative.

func ParseToken 

func ParseToken(tokenStr string) (token Token, err error)

ParseToken parses a cli input for one token type, returning errors if invalid. This returns an error on an empty string as well.

func (Token) Add 

func (token Token) Add(tokenB Token) Token

Adds amounts of two tokens with same denom. If the tokens differ in denom then it panics.

func (Token) IsEqual 

func (token Token) IsEqual(other Token) bool

IsEqual returns true if the two sets of Tokens have the same value

func (Token) IsGTE 

func (token Token) IsGTE(other Token) bool

IsGTE returns true if they are the same type and the receiver is an equal or greater value

func (Token) IsLT 

func (token Token) IsLT(other Token) bool

IsLT returns true if they are the same type and the receiver is a smaller value

func (Token) IsNegative 

func (token Token) IsNegative() bool

IsNegative returns true if the token amount is negative and false otherwise.

TODO: Remove once unsigned integers are used.

func (Token) IsPositive 

func (token Token) IsPositive() bool

IsPositive returns true if token amount is positive.

TODO: Remove once unsigned integers are used.

func (Token) IsValid 

func (token Token) IsValid() bool

IsValid returns true if the Token has a non-negative amount and the denom is vaild.

func (Token) IsZero 

func (token Token) IsZero() bool

IsZero returns if this represents no money

func (Token) String 

func (token Token) String() string

String provides a human-readable representation of a token

func (Token) Sub 

func (token Token) Sub(tokenB Token) Token

Subtracts amounts of two tokens with same denom. If the tokens differ in denom then it panics.

type Tokens 

type Tokens []Token

Tokens is a set of Token, one per currency

func NewTokens 

func NewTokens(tokens ...Token) Tokens

NewTokens constructs a new token set.

func ParseTokens 

func ParseTokens(tokensStr string) (Tokens, error)

ParseTokens will parse out a list of tokens separated by commas. If nothing is provided, it returns nil Tokens. Returned tokens are sorted.

func (Tokens) Add 

func (tokens Tokens) Add(tokensB Tokens) Tokens

Add adds two sets of tokens.

e.g. {2A} + {A, 2B} = {3A, 2B} {2A} + {0B} = {2A}

NOTE: Add operates under the invariant that tokens are sorted by denominations.

CONTRACT: Add will never return Tokens where one Token has a non-positive amount. In otherwords, IsValid will always return true.

func (Tokens) AmountOf 

func (tokens Tokens) AmountOf(denom string) Int

Returns the amount of a denom from tokens

func (Tokens) DenomsSubsetOf 

func (tokens Tokens) DenomsSubsetOf(tokensB Tokens) bool

DenomsSubsetOf returns true if receiver's denom set is subset of tokensB's denoms.

func (Tokens) Empty 

func (tokens Tokens) Empty() bool

Empty returns true if there are no tokens and false otherwise.

func (Tokens) IsAllGT 

func (tokens Tokens) IsAllGT(tokensB Tokens) bool

IsAllGT returns true if for every denom in tokensB, the denom is present at a greater amount in tokens.

func (Tokens) IsAllGTE 

func (tokens Tokens) IsAllGTE(tokensB Tokens) bool

IsAllGTE returns false if for any denom in tokensB, the denom is present at a smaller amount in tokens; else returns true.

func (Tokens) IsAllLT 

func (tokens Tokens) IsAllLT(tokensB Tokens) bool

IsAllLT returns True iff for every denom in tokens, the denom is present at a smaller amount in tokensB.

func (Tokens) IsAllLTE 

func (tokens Tokens) IsAllLTE(tokensB Tokens) bool

IsAllLTE returns true iff for every denom in tokens, the denom is present at a smaller or equal amount in tokensB.

func (Tokens) IsAllPositive 

func (tokens Tokens) IsAllPositive() bool

IsAllPositive returns true if there is at least one token and all currencies have a positive value.

func (Tokens) IsAnyGT 

func (tokens Tokens) IsAnyGT(tokensB Tokens) bool

IsAnyGT returns true iff for any denom in tokens, the denom is present at a greater amount in tokensB.

e.g. {2A, 3B}.IsAnyGT{A} = true {2A, 3B}.IsAnyGT{5C} = false {}.IsAnyGT{5C} = false {2A, 3B}.IsAnyGT{} = false

func (Tokens) IsAnyGTE 

func (tokens Tokens) IsAnyGTE(tokensB Tokens) bool

IsAnyGTE returns true iff tokens contains at least one denom that is present at a greater or equal amount in tokensB; it returns false otherwise.

NOTE: IsAnyGTE operates under the invariant that both token sets are sorted by denominations and there exists no zero tokens.

func (Tokens) IsAnyNegative 

func (tokens Tokens) IsAnyNegative() bool

IsAnyNegative returns true if there is at least one token whose amount is negative; returns false otherwise. It returns false if the token set is empty too.

TODO: Remove once unsigned integers are used.

func (Tokens) IsEqual 

func (tokens Tokens) IsEqual(tokensB Tokens) bool

IsEqual returns true if the two sets of Tokens have the same value

func (Tokens) IsValid 

func (tokens Tokens) IsValid() bool

IsValid asserts the Tokens are sorted, have positive amount, and Denom does not contain upper case characters.

func (Tokens) IsZero 

func (tokens Tokens) IsZero() bool

IsZero returns true if there are no tokens or all tokens are zero.

func (Tokens) Len 

func (tokens Tokens) Len() int

nolint

func (Tokens) Less 

func (tokens Tokens) Less(i, j int) bool

func (Tokens) MarshalJSON 

func (tokens Tokens) MarshalJSON() ([]byte, error)

MarshalJSON implements a custom JSON marshaller for the Tokens type to allow nil Tokens to be encoded as an empty array.

func (Tokens) SafeSub 

func (tokens Tokens) SafeSub(tokensB Tokens) (Tokens, bool)

SafeSub performs the same arithmetic as Sub but returns a boolean if any negative token amount was returned.

func (Tokens) Sort 

func (tokens Tokens) Sort() Tokens

Sort is a helper function to sort the set of tokens inplace

func (Tokens) String 

func (tokens Tokens) String() string

func (Tokens) Sub 

func (tokens Tokens) Sub(tokensB Tokens) Tokens

Sub subtracts a set of tokens from another.

e.g. {2A, 3B} - {A} = {A, 3B} {2A} - {0B} = {2A} {A, B} - {A} = {B}

CONTRACT: Sub will never return Tokens where one Token has a non-positive amount. In otherwords, IsValid will always return true.

func (Tokens) Swap 

func (tokens Tokens) Swap(i, j int)

type TraceContext 

type TraceContext = types.TraceContext

TraceContext contains TraceKVStore context data. It will be written with every trace operation.

type TransientStoreKey 

type TransientStoreKey = types.TransientStoreKey

nolint - reexport

func NewTransientStoreKey 

func NewTransientStoreKey(name string) *TransientStoreKey

Constructs new TransientStoreKey Must return a pointer according to the ocap principle

type Tx 

type Tx interface {
	// Gets the all the transaction's messages.
	GetMsgs() []Msg

	// ValidateBasic does a simple and lightweight validation check that doesn't
	// require access to any other information.
	ValidateBasic() Error
}

Transactions objects must fulfill the Tx

type TxDecoder 

type TxDecoder func(txBytes []byte) (Tx, Error)

TxDecoder unmarshals transaction bytes

type TxEncoder 

type TxEncoder func(tx Tx) ([]byte, error)

TxEncoder marshals transaction to bytes

type TxResponse 

type TxResponse struct {
	Height    int64           `json:"height"`
	TxHash    string          `json:"txhash"`
	Code      uint32          `json:"code,omitempty"`
	Data      string          `json:"data,omitempty"`
	RawLog    string          `json:"raw_log,omitempty"`
	Logs      ABCIMessageLogs `json:"logs,omitempty"`
	Info      string          `json:"info,omitempty"`
	GasWanted int64           `json:"gas_wanted,omitempty"`
	GasUsed   int64           `json:"gas_used,omitempty"`
	Codespace string          `json:"codespace,omitempty"`
	Tx        Tx              `json:"tx,omitempty"`
	Timestamp string          `json:"timestamp,omitempty"`

	// DEPRECATED: Remove in the next next major release in favor of using the
	// ABCIMessageLog.Events field.
	Events StringEvents `json:"events,omitempty"`
}

TxResponse defines a structure containing relevant tx data and metadata. The tags are stringified and the log is JSON decoded.

func NewResponseFormatBroadcastTx 

func NewResponseFormatBroadcastTx(res *ctypes.ResultBroadcastTx) TxResponse

NewResponseFormatBroadcastTx returns a TxResponse given a ResultBroadcastTx from tendermint

func NewResponseFormatBroadcastTxCommit 

func NewResponseFormatBroadcastTxCommit(res *ctypes.ResultBroadcastTxCommit) TxResponse

NewResponseFormatBroadcastTxCommit returns a TxResponse given a ResultBroadcastTxCommit from tendermint.

func NewResponseResultTx 

func NewResponseResultTx(res *ctypes.ResultTx, tx Tx, timestamp string) TxResponse

NewResponseResultTx returns a TxResponse given a ResultTx from tendermint

func (TxResponse) Empty 

func (r TxResponse) Empty() bool

Empty returns true if the response is empty

func (TxResponse) String 

func (r TxResponse) String() string

type Uint 

type Uint struct {
	// contains filtered or unexported fields
}

Uint wraps integer with 256 bit range bound Checks overflow, underflow and division by zero Exists in range from 0 to 2^256-1

func MaxUint 

func MaxUint(u1, u2 Uint) Uint

Return the maximum of the Uints

func MinUint 

func MinUint(u1, u2 Uint) Uint

Return the minimum of the Uints

func NewUint 

func NewUint(n uint64) Uint

NewUint constructs Uint from int64

func NewUintFromBigInt 

func NewUintFromBigInt(i *big.Int) Uint

NewUintFromBigUint constructs Uint from big.Uint

func NewUintFromString 

func NewUintFromString(s string) Uint

NewUintFromString constructs Uint from string

func OneUint 

func OneUint() Uint

OneUint returns Uint value with one.

func ParseUint 

func ParseUint(s string) (Uint, error)

ParseUint reads a string-encoded Uint value and return a Uint.

func ZeroUint 

func ZeroUint() Uint

ZeroUint returns unsigned zero.

func (Uint) Add 

func (u Uint) Add(u2 Uint) Uint

Add adds Uint from another

func (Uint) AddUint64 

func (u Uint) AddUint64(u2 uint64) Uint

Add convert uint64 and add it to Uint

func (Uint) Equal 

func (u Uint) Equal(u2 Uint) bool

Equal compares two Uints

func (Uint) GT 

func (u Uint) GT(u2 Uint) bool

GT returns true if first Uint is greater than second

func (Uint) GTE 

func (u Uint) GTE(u2 Uint) bool

GTE returns true if first Uint is greater than second

func (Uint) IsZero 

func (u Uint) IsZero() bool

IsZero returns 1 if the uint equals to 0.

func (Uint) LT 

func (u Uint) LT(u2 Uint) bool

LT returns true if first Uint is lesser than second

func (Uint) LTE 

func (u Uint) LTE(u2 Uint) bool

LTE returns true if first Uint is lesser than or equal to the second

func (Uint) MarshalAmino 

func (u Uint) MarshalAmino() (string, error)

MarshalAmino defines custom encoding scheme

func (Uint) MarshalJSON 

func (u Uint) MarshalJSON() ([]byte, error)

MarshalJSON defines custom encoding scheme

func (Uint) Mul 

func (u Uint) Mul(u2 Uint) (res Uint)

Mul multiplies two Uints

func (Uint) MulUint64 

func (u Uint) MulUint64(u2 uint64) (res Uint)

Mul multiplies two Uints

func (Uint) Quo 

func (u Uint) Quo(u2 Uint) (res Uint)

Quo divides Uint with Uint

func (Uint) QuoUint64 

func (u Uint) QuoUint64(u2 uint64) Uint

Quo divides Uint with uint64

func (Uint) String 

func (u Uint) String() string

Human readable string

func (Uint) Sub 

func (u Uint) Sub(u2 Uint) Uint

Sub adds Uint from another

func (Uint) SubUint64 

func (u Uint) SubUint64(u2 uint64) Uint

SubUint64 adds Uint from another

func (Uint) Uint64 

func (u Uint) Uint64() uint64

Uint64 converts Uint to uint64 Panics if the value is out of range

func (*Uint) UnmarshalAmino 

func (u *Uint) UnmarshalAmino(text string) error

UnmarshalAmino defines custom decoding scheme

func (*Uint) UnmarshalJSON 

func (u *Uint) UnmarshalJSON(bz []byte) error

UnmarshalJSON defines custom decoding scheme

type ValAddress 

type ValAddress []byte

ValAddress defines a wrapper around bytes meant to present a validator's operator. When marshaled to a string or JSON, it uses Bech32.

func ValAddressFromBech32 

func ValAddressFromBech32(address string) (addr ValAddress, err error)

ValAddressFromBech32 creates a ValAddress from a Bech32 string.

func ValAddressFromHex 

func ValAddressFromHex(address string) (addr ValAddress, err error)

ValAddressFromHex creates a ValAddress from a hex string.

func (ValAddress) Bytes 

func (va ValAddress) Bytes() []byte

Bytes returns the raw address bytes.

func (ValAddress) Empty 

func (va ValAddress) Empty() bool

Returns boolean for whether an AccAddress is empty

func (ValAddress) Equals 

func (va ValAddress) Equals(va2 Address) bool

Returns boolean for whether two ValAddresses are Equal

func (ValAddress) Format 

func (va ValAddress) Format(s fmt.State, verb rune)

Format implements the fmt.Formatter interface. nolint: errcheck

func (ValAddress) Marshal 

func (va ValAddress) Marshal() ([]byte, error)

Marshal returns the raw address bytes. It is needed for protobuf compatibility.

func (ValAddress) MarshalJSON 

func (va ValAddress) MarshalJSON() ([]byte, error)

MarshalJSON marshals to JSON using Bech32.

func (ValAddress) MarshalYAML 

func (va ValAddress) MarshalYAML() (interface{}, error)

MarshalYAML marshals to YAML using Bech32.

func (ValAddress) String 

func (va ValAddress) String() string

String implements the Stringer interface.

func (*ValAddress) Unmarshal 

func (va *ValAddress) Unmarshal(data []byte) error

Unmarshal sets the address to the given data. It is needed for protobuf compatibility.

func (*ValAddress) UnmarshalJSON 

func (va *ValAddress) UnmarshalJSON(data []byte) error

UnmarshalJSON unmarshals from JSON assuming Bech32 encoding.

func (*ValAddress) UnmarshalYAML 

func (va *ValAddress) UnmarshalYAML(data []byte) error

UnmarshalYAML unmarshals from YAML assuming Bech32 encoding.

Source Files

View all Source files

Directories

Path Synopsis
Package module contains application module patterns and associated "manager" functionality.
 Package module contains application module patterns and associated "manager" functionality.
Package rest provides HTTP types and primitives for REST requests validation and responses handling.
 Package rest provides HTTP types and primitives for REST requests validation and responses handling.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.