Documentation ¶
Index ¶
- Variables
- func CodeToDefaultMsg(code CodeType) string
- func NewRatFromDecimal(decimalStr string) (f Rat, err Error)
- func StdSignBytes(chainID string, sequences []int64, fee StdFee, msg Msg) []byte
- type Account
- type AccountDecoder
- type AccountMapper
- type Address
- type AnteHandler
- type BeginBlocker
- type CacheKVStore
- type CacheMultiStore
- type CacheWrap
- type CacheWrapper
- type CodeType
- type Coin
- func (coin Coin) IsEqual(other Coin) bool
- func (coin Coin) IsGTE(other Coin) bool
- func (coin Coin) IsNotNegative() bool
- func (coin Coin) IsPositive() bool
- func (coin Coin) IsZero() bool
- func (coin Coin) Minus(coinB Coin) Coin
- func (coin Coin) Plus(coinB Coin) Coin
- func (coin Coin) SameDenomAs(other Coin) bool
- func (coin Coin) String() string
- type Coins
- func (coins Coins) AmountOf(denom string) int64
- func (coins Coins) IsEqual(coinsB Coins) bool
- func (coins Coins) IsGTE(coinsB Coins) bool
- func (coins Coins) IsNotNegative() bool
- func (coins Coins) IsPositive() bool
- func (coins Coins) IsValid() bool
- func (coins Coins) IsZero() bool
- func (coins Coins) Len() int
- func (coins Coins) Less(i, j int) bool
- func (coins Coins) Minus(coinsB Coins) Coins
- func (coins Coins) Negative() Coins
- func (coins Coins) Plus(coinsB Coins) Coins
- func (coins Coins) Sort() Coins
- func (coins Coins) String() string
- func (coins Coins) Swap(i, j int)
- type CommitID
- type CommitKVStore
- type CommitMultiStore
- type CommitStore
- type Committer
- type Context
- func (c Context) BlockHeader() abci.Header
- func (c Context) BlockHeight() int64
- func (c Context) ChainID() string
- func (c Context) GetOp(ver int64) (Op, bool)
- func (c Context) IsCheckTx() bool
- func (c Context) IsZero() bool
- func (c Context) KVStore(key StoreKey) KVStore
- func (c Context) TxBytes() []byte
- func (c Context) Value(key interface{}) interface{}
- func (c Context) WithBlockHeader(header abci.Header) Context
- func (c Context) WithBlockHeight(height int64) Context
- func (c Context) WithCacheWrapper(key interface{}, value CacheWrapper) Context
- func (c Context) WithChainID(chainID string) Context
- func (c Context) WithCloner(key interface{}, value cloner) Context
- func (c Context) WithInt32(key interface{}, value int32) Context
- func (c Context) WithIsCheckTx(isCheckTx bool) Context
- func (c Context) WithMultiStore(ms MultiStore) Context
- func (c Context) WithProtoMsg(key interface{}, value proto.Message) Context
- func (c Context) WithString(key interface{}, value string) Context
- func (c Context) WithTxBytes(txBytes []byte) Context
- func (c Context) WithUint32(key interface{}, value uint32) Context
- func (c Context) WithUint64(key interface{}, value uint64) Context
- func (c Context) WithValue(key interface{}, value interface{}) Context
- type EndBlocker
- type Error
- func ErrGenesisParse(msg string) Error
- func ErrInsufficientCoins(msg string) Error
- func ErrInsufficientFunds(msg string) Error
- func ErrInternal(msg string) Error
- func ErrInvalidAddress(msg string) Error
- func ErrInvalidCoins(msg string) Error
- func ErrInvalidPubKey(msg string) Error
- func ErrInvalidSequence(msg string) Error
- func ErrTxDecode(msg string) Error
- func ErrUnauthorized(msg string) Error
- func ErrUnknownAddress(msg string) Error
- func ErrUnknownRequest(msg string) Error
- func NewError(code CodeType, msg string) Error
- type Handler
- type InitChainer
- type InitGenesis
- type Iterator
- type KVStore
- type KVStoreKey
- type Msg
- type MultiStore
- type Op
- type Queryable
- type Rat
- func (r Rat) Add(r2 Rat) Rat
- func (r Rat) Equal(r2 Rat) bool
- func (r Rat) Evaluate() int64
- func (r Rat) EvaluateBig() *big.Int
- func (r Rat) GT(r2 Rat) bool
- func (r Rat) GetRat() *big.Rat
- func (r Rat) Inv() Rat
- func (r Rat) IsZero() bool
- func (r Rat) LT(r2 Rat) bool
- func (r Rat) Mul(r2 Rat) Rat
- func (r Rat) Quo(r2 Rat) Rat
- func (r Rat) Round(precisionFactor int64) Rat
- func (r Rat) Sub(r2 Rat) Rat
- func (r Rat) ToLeftPadded(totalDigits int8) string
- type Result
- type StdFee
- type StdSignDoc
- type StdSignMsg
- type StdSignature
- type StdTx
- type Store
- type StoreKey
- type StoreType
- type TestMsg
- type Tx
- type TxDecoder
Constants ¶
This section is empty.
Variables ¶
var ( ZeroRat = NewRat(0) // Rat{big.NewRat(0, 1)} OneRat = NewRat(1) // Rat{big.NewRat(1, 1)} )
nolint - common values
Functions ¶
func CodeToDefaultMsg ¶ added in v0.2.0
NOTE: Don't stringer this, we'll put better messages in later.
func NewRatFromDecimal ¶ added in v0.2.0
create a rational from decimal string or integer string
Types ¶
type Account ¶ added in v0.2.0
type Account interface { GetAddress() Address SetAddress(Address) error // errors if already set. GetPubKey() crypto.PubKey // can return nil. SetPubKey(crypto.PubKey) error GetSequence() int64 SetSequence(int64) error GetCoins() Coins SetCoins(Coins) error Get(key interface{}) (value interface{}, err error) Set(key interface{}, value interface{}) error }
Account is a standard account using a sequence number for replay protection and a pubkey for authentication.
type AccountDecoder ¶ added in v0.2.0
AccountDecoder unmarshals account bytes
type AccountMapper ¶ added in v0.2.0
type AccountMapper interface { NewAccountWithAddress(ctx Context, addr Address) Account GetAccount(ctx Context, addr Address) Account SetAccount(ctx Context, acc Account) }
AccountMapper stores and retrieves accounts from stores retrieved from the context.
type Address ¶
Address in go-crypto style
func FeePayer ¶ added in v0.2.0
FeePayer returns the address responsible for paying the fees for the transactions. It's the first address returned by msg.GetSigners(). If GetSigners() is empty, this panics.
func GetAddress ¶ added in v0.2.0
create an Address from a string
type AnteHandler ¶
If newCtx.IsZero(), ctx is used instead.
type BeginBlocker ¶
type BeginBlocker func(ctx Context, req abci.RequestBeginBlock) abci.ResponseBeginBlock
run code before the transactions in a block
type CacheKVStore ¶
type CacheKVStore interface { KVStore // Writes operations to underlying KVStore Write() }
CacheKVStore cache-wraps a KVStore. After calling .Write() on the CacheKVStore, all previously created CacheKVStores on the object expire.
type CacheMultiStore ¶
type CacheMultiStore interface { MultiStore Write() // Writes operations to underlying KVStore }
From MultiStore.CacheMultiStore()....
type CacheWrap ¶
type CacheWrap interface { // Write syncs with the underlying store. Write() // CacheWrap recursively wraps again. CacheWrap() CacheWrap }
CacheWrap() makes the most appropriate cache-wrap. For example, IAVLStore.CacheWrap() returns a CacheKVStore.
CacheWrap() should not return a Committer, since Commit() on cache-wraps make no sense. It can return KVStore, HeapStore, SpaceStore, etc.
type CacheWrapper ¶
type CacheWrapper interface {
CacheWrap() CacheWrap
}
type CodeType ¶ added in v0.2.0
type CodeType uint32
ABCI Response Code
const ( CodeOK CodeType = 0 CodeInternal CodeType = 1 CodeTxDecode CodeType = 2 CodeInvalidSequence CodeType = 3 CodeInsufficientFunds CodeType = 5 CodeUnknownRequest CodeType = 6 CodeInvalidAddress CodeType = 7 CodeInvalidPubKey CodeType = 8 CodeUnknownAddress CodeType = 9 CodeInsufficientCoins CodeType = 10 CodeInvalidCoins CodeType = 11 CodeGenesisParse CodeType = 0xdead // TODO: remove ? // why remove? )
ABCI Response Codes Base SDK reserves 0 - 99.
type Coin ¶
Coin hold some amount of one currency
func ParseCoin ¶
ParseCoin parses a cli input for one coin type, returning errors if invalid. This returns an error on an empty string as well.
func (Coin) IsGTE ¶
IsGTE returns true if they are the same type and the receiver is an equal or greater value
func (Coin) IsNotNegative ¶ added in v0.2.0
IsNotNegative returns true if coin amount is not negative
func (Coin) IsPositive ¶
IsPositive returns true if coin amount is positive
func (Coin) SameDenomAs ¶ added in v0.2.0
SameDenomAs returns true if the two coins are the same denom
type Coins ¶
type Coins []Coin
Coins is a set of Coin, one per currency
func ParseCoins ¶
ParseCoins will parse out a list of coins separated by commas. If nothing is provided, it returns nil Coins. Returned coins are sorted.
func (Coins) IsGTE ¶ added in v0.2.0
IsGTE returns True iff coins is NonNegative(), and for every currency in coinsB, the currency is present at an equal or greater amount in coinsB
func (Coins) IsNotNegative ¶ added in v0.2.0
IsNotNegative returns true if there is no currency with a negative value (even no coins is true here)
func (Coins) IsPositive ¶ added in v0.2.0
IsPositive returns true if there is at least one coin, and all currencies have a positive value
func (Coins) Plus ¶ added in v0.2.0
Plus combines two sets of coins CONTRACT: Plus will never return Coins where one Coin has a 0 amount.
type CommitKVStore ¶
Stores of MultiStore must implement CommitStore.
type CommitMultiStore ¶
type CommitMultiStore interface { Committer MultiStore // Mount a store of type using the given db. // If db == nil, the new store will use the CommitMultiStore db. MountStoreWithDB(key StoreKey, typ StoreType, db dbm.DB) // Panics on a nil key. GetCommitStore(key StoreKey) CommitStore // Panics on a nil key. GetCommitKVStore(key StoreKey) CommitKVStore // Load the latest persisted version. Called once after all // calls to Mount*Store() are complete. LoadLatestVersion() error // Load a specific persisted version. When you load an old // version, or when the last commit attempt didn't complete, // the next commit after loading must be idempotent (return the // same commit id). Otherwise the behavior is undefined. LoadVersion(ver int64) error }
A non-cache MultiStore.
type CommitStore ¶
Stores of MultiStore must implement CommitStore.
type Context ¶
The intent of Context is for it to be an immutable object that can be cloned and updated cheaply with WithValue() and passed forward to the next decorator or handler. For example,
func MsgHandler(ctx Context, tx Tx) Result { ... ctx = ctx.WithValue(key, value) ... }
func NewContext ¶
create a new context
func (Context) BlockHeight ¶
func (Context) GetOp ¶ added in v0.2.0
Returns false if ver <= 0 || ver > len(c.pst.ops). The first operation is version 1.
func (Context) Value ¶
func (c Context) Value(key interface{}) interface{}
context value for the provided key
func (Context) WithBlockHeight ¶
func (Context) WithCacheWrapper ¶ added in v0.2.0
func (c Context) WithCacheWrapper(key interface{}, value CacheWrapper) Context
func (Context) WithChainID ¶
func (Context) WithCloner ¶ added in v0.2.0
func (Context) WithIsCheckTx ¶
func (Context) WithMultiStore ¶
func (c Context) WithMultiStore(ms MultiStore) Context
func (Context) WithProtoMsg ¶ added in v0.2.0
func (Context) WithString ¶ added in v0.2.0
func (Context) WithTxBytes ¶
func (Context) WithUint32 ¶ added in v0.2.0
func (Context) WithUint64 ¶ added in v0.2.0
type EndBlocker ¶
type EndBlocker func(ctx Context, req abci.RequestEndBlock) abci.ResponseEndBlock
run code after the transactions in a block and return updates to the validator set
type Error ¶ added in v0.2.0
type Error interface { Error() string ABCICode() CodeType ABCILog() string Trace(msg string) Error TraceCause(cause error, msg string) Error Cause() error Result() Result QueryResult() abci.ResponseQuery }
sdk Error type
func ErrGenesisParse ¶ added in v0.2.0
func ErrInsufficientCoins ¶ added in v0.2.0
func ErrInsufficientFunds ¶ added in v0.2.0
func ErrInvalidAddress ¶ added in v0.2.0
func ErrInvalidCoins ¶ added in v0.2.0
func ErrInvalidPubKey ¶ added in v0.2.0
func ErrInvalidSequence ¶ added in v0.2.0
func ErrTxDecode ¶ added in v0.2.0
func ErrUnauthorized ¶ added in v0.2.0
func ErrUnknownAddress ¶ added in v0.2.0
func ErrUnknownRequest ¶ added in v0.2.0
type InitChainer ¶
type InitChainer func(ctx Context, req abci.RequestInitChain) abci.ResponseInitChain
initialize application state at genesis
type InitGenesis ¶ added in v0.2.0
type InitGenesis func(ctx Context, data json.RawMessage) error
Run only once on chain initialization, should write genesis state to store or throw an error if some required information was not provided, in which case the application will panic.
type KVStore ¶
type KVStore interface { Store // Get returns nil iff key doesn't exist. Panics on nil key. Get(key []byte) []byte // Has checks if a key exists. Panics on nil key. Has(key []byte) bool // Set sets the key. Panics on nil key. Set(key, value []byte) // Delete deletes the key. Panics on nil key. Delete(key []byte) // Iterator over a domain of keys in ascending order. End is exclusive. // Start must be less than end, or the Iterator is invalid. // CONTRACT: No writes may happen within a domain while an iterator exists over it. Iterator(start, end []byte) Iterator // Iterator over a domain of keys in descending order. End is exclusive. // Start must be greater than end, or the Iterator is invalid. // CONTRACT: No writes may happen within a domain while an iterator exists over it. ReverseIterator(start, end []byte) Iterator }
KVStore is a simple interface to get/set data
type KVStoreKey ¶
type KVStoreKey struct {
// contains filtered or unexported fields
}
KVStoreKey is used for accessing substores. Only the pointer value should ever be used - it functions as a capabilities key.
func NewKVStoreKey ¶
func NewKVStoreKey(name string) *KVStoreKey
NewKVStoreKey returns a new pointer to a KVStoreKey. Use a pointer so keys don't collide.
func (*KVStoreKey) Name ¶ added in v0.2.0
func (key *KVStoreKey) Name() string
func (*KVStoreKey) String ¶ added in v0.2.0
func (key *KVStoreKey) String() string
type Msg ¶
type Msg interface { // Return the message type. // Must be alphanumeric or empty. Type() string // Get some property of the Msg. Get(key interface{}) (value interface{}) // Get the canonical byte representation of the Msg. GetSignBytes() []byte // ValidateBasic does a simple validation check that // doesn't require access to any other information. ValidateBasic() Error // 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() []Address }
Transactions messages must fulfill the Msg
type MultiStore ¶
type Op ¶ added in v0.2.0
type Op struct {
// contains filtered or unexported fields
}
XXX add description
type Queryable ¶
type Queryable interface {
Query(abci.RequestQuery) abci.ResponseQuery
}
Queryable allows a Store to expose internal state to the abci.Query interface. Multistore can route requests to the proper Store.
This is an optional, but useful extension to any CommitStore
type Rat ¶ added in v0.2.0
Rat - extend big.Rat NOTE: never use new(Rat) or else we will panic unmarshalling into the nil embedded big.Rat
func NewRat ¶ added in v0.2.0
New - create a new Rat from integers func NewRat(Numerator int64, Denominator ...int64) Rat { switch len(Denominator) { case 0: return Rat{big.NewRat(Numerator, 1)} case 1: return Rat{big.NewRat(Numerator, Denominator[0])} default: panic("improper use of New, can only have one denominator") } }
func (Rat) EvaluateBig ¶ added in v0.2.0
evaluate the rational using bankers rounding
func (Rat) ToLeftPadded ¶ added in v0.2.0
TODO panic if negative or if totalDigits < len(initStr)??? evaluate as an integer and return left padded string
type Result ¶
type Result struct { // Code is the response code, is stored back on the chain. Code CodeType // Data is any data returned from the app. Data []byte // Log is just debug information. NOTE: nondeterministic. Log string // GasWanted is the maximum units of work we allow this tx to perform. GasWanted int64 // GasUsed is the amount of gas actually consumed. NOTE: not used. GasUsed int64 // Tx fee amount and denom. FeeAmount int64 FeeDenom string // Changes to the validator set. ValidatorUpdates []abci.Validator // Tags are used for transaction indexing and pubsub. Tags []cmn.KVPair }
Result is the union of ResponseDeliverTx and ResponseCheckTx.
type StdFee ¶ added in v0.2.0
StdFee includes the amount of coins paid in fees and the maximum gas to be used by the transaction. The ratio yields an effective "gasprice", which must be above some miminum to be accepted into the mempool.
type StdSignDoc ¶ added in v0.2.0
type StdSignDoc struct { ChainID string `json:"chain_id"` Sequences []int64 `json:"sequences"` FeeBytes []byte `json:"fee_bytes"` MsgBytes []byte `json:"msg_bytes"` AltBytes []byte `json:"alt_bytes"` }
StdSignDoc is replay-prevention structure. It includes the result of msg.GetSignBytes(), as well as the ChainID (prevent cross chain replay) and the Sequence numbers for each signature (prevent inchain replay and enforce tx ordering per account).
type StdSignMsg ¶ added in v0.2.0
StdSignMsg is a convenience structure for passing along a Msg with the other requirements for a StdSignDoc before it is signed. For use in the CLI.
type StdSignature ¶ added in v0.2.0
type StdSignature struct { crypto.PubKey `json:"pub_key"` // optional crypto.Signature `json:"signature"` Sequence int64 `json:"sequence"` }
Standard Signature
type StdTx ¶ added in v0.2.0
type StdTx struct { Msg `json:"msg"` Fee StdFee `json:"fee"` Signatures []StdSignature `json:"signatures"` }
StdTx is a standard way to wrap a Msg with Fee and Signatures. NOTE: the first signature is the FeePayer (Signatures must not be nil).
func (StdTx) GetSignatures ¶ added in v0.2.0
func (tx StdTx) GetSignatures() []StdSignature
type Store ¶
type Store interface { GetStoreType() StoreType CacheWrapper }
type TestMsg ¶
type TestMsg struct {
// contains filtered or unexported fields
}
msg type for testing
func NewTestMsg ¶
func (*TestMsg) GetSignBytes ¶
func (*TestMsg) GetSigners ¶
func (*TestMsg) ValidateBasic ¶
type Tx ¶
type Tx interface { // Gets the Msg. GetMsg() Msg // Signatures returns the signature of signers who signed the Msg. // CONTRACT: Length returned is same as length of // pubkeys returned from MsgKeySigners, and the order // matches. // CONTRACT: If the signature is missing (ie the Msg is // invalid), then the corresponding signature is // .Empty(). GetSignatures() []StdSignature }
Transactions objects must fulfill the Tx