dummy

README

Dummy

There are two app's here: the DummyApplication and the PersistentDummyApplication.

DummyApplication

The DummyApplication is a simple merkle key-value store. Transactions of the form key=value are stored as key-value pairs in the tree. Transactions without an = sign set the value to the key. The app has no replay protection (other than what the mempool provides).

PersistentDummyApplication

The PersistentDummyApplication wraps the DummyApplication and provides two additional features:

1. persistence of state across app restarts (using Tendermint's ABCI-Handshake mechanism)
2. validator set changes

The state is persisted in leveldb along with the last block committed, and the Handshake allows any necessary blocks to be replayed. Validator set changes are effected using the following transaction format:

val:pubkey1/power1,addr2/power2,addr3/power3"

where power1 is the new voting power for the validator with pubkey1 (possibly a new one). There is no sybil protection against new validators joining. Validators can be removed by setting their power to 0.

Documentation

Index

• Constants
• func InitDummy(app *PersistentDummyApplication)
• func MakeValSetChangeTx(pubkey []byte, power int64) []byte
• func RandVal(i int) *types.Validator
• func RandVals(cnt int) []*types.Validator
• type DummyApplication
  • func NewDummyApplication() *DummyApplication
  • func (app *DummyApplication) CheckTx(tx []byte) types.ResponseCheckTx
  • func (app *DummyApplication) Commit() types.ResponseCommit
  • func (app *DummyApplication) DeliverTx(tx []byte) types.ResponseDeliverTx
  • func (app *DummyApplication) Info(req types.RequestInfo) (resInfo types.ResponseInfo)
  • func (app *DummyApplication) Query(reqQuery types.RequestQuery) (resQuery types.ResponseQuery)
• type PersistentDummyApplication
  • func NewPersistentDummyApplication(dbDir string) *PersistentDummyApplication
  • func (app *PersistentDummyApplication) BeginBlock(req types.RequestBeginBlock) types.ResponseBeginBlock
  • func (app *PersistentDummyApplication) CheckTx(tx []byte) types.ResponseCheckTx
  • func (app *PersistentDummyApplication) Commit() types.ResponseCommit
  • func (app *PersistentDummyApplication) DeliverTx(tx []byte) types.ResponseDeliverTx
  • func (app *PersistentDummyApplication) EndBlock(req types.RequestEndBlock) types.ResponseEndBlock
  • func (app *PersistentDummyApplication) Info(req types.RequestInfo) types.ResponseInfo
  • func (app *PersistentDummyApplication) InitChain(req types.RequestInitChain) types.ResponseInitChain
  • func (app *PersistentDummyApplication) Query(reqQuery types.RequestQuery) types.ResponseQuery
  • func (app *PersistentDummyApplication) SetLogger(l log.Logger)
  • func (app *PersistentDummyApplication) SetOption(req types.RequestSetOption) types.ResponseSetOption
  • func (app *PersistentDummyApplication) Validators() (validators []*types.Validator)

Constants

const (
	ValidatorSetChangePrefix string = "val:"
)

Functions

func InitDummy

func InitDummy(app *PersistentDummyApplication)

InitDummy initializes the dummy app with some data, which allows tests to pass and is fine as long as you don't make any tx that modify the validator state

func MakeValSetChangeTx

func MakeValSetChangeTx(pubkey []byte, power int64) []byte

func RandVal

func RandVal(i int) *types.Validator

RandVal creates one random validator, with a key derived from the input value

func RandVals

func RandVals(cnt int) []*types.Validator

RandVals returns a list of cnt validators for initializing the application. Note that the keys are deterministically derived from the index in the array, while the power is random (Change this if not desired)

Types

type DummyApplication

type DummyApplication struct {
	types.BaseApplication
	// contains filtered or unexported fields
}

func NewDummyApplication

func NewDummyApplication() *DummyApplication

func (*DummyApplication) CheckTx

func (app *DummyApplication) CheckTx(tx []byte) types.ResponseCheckTx

func (*DummyApplication) Commit

func (app *DummyApplication) Commit() types.ResponseCommit

func (*DummyApplication) DeliverTx

func (app *DummyApplication) DeliverTx(tx []byte) types.ResponseDeliverTx

tx is either "key=value" or just arbitrary bytes

func (*DummyApplication) Info

func (app *DummyApplication) Info(req types.RequestInfo) (resInfo types.ResponseInfo)

func (*DummyApplication) Query

func (app *DummyApplication) Query(reqQuery types.RequestQuery) (resQuery types.ResponseQuery)

type PersistentDummyApplication

type PersistentDummyApplication struct {

	// validator set
	ValUpdates []*types.Validator
	// contains filtered or unexported fields
}

func NewPersistentDummyApplication

func NewPersistentDummyApplication(dbDir string) *PersistentDummyApplication

func (*PersistentDummyApplication) BeginBlock

func (app *PersistentDummyApplication) BeginBlock(req types.RequestBeginBlock) types.ResponseBeginBlock

Track the block hash and header information

func (*PersistentDummyApplication) CheckTx

func (app *PersistentDummyApplication) CheckTx(tx []byte) types.ResponseCheckTx

func (*PersistentDummyApplication) Commit

func (app *PersistentDummyApplication) Commit() types.ResponseCommit

Commit will panic if InitChain was not called

func (*PersistentDummyApplication) DeliverTx

func (app *PersistentDummyApplication) DeliverTx(tx []byte) types.ResponseDeliverTx

tx is either "val:pubkey/power" or "key=value" or just arbitrary bytes

func (*PersistentDummyApplication) EndBlock

func (app *PersistentDummyApplication) EndBlock(req types.RequestEndBlock) types.ResponseEndBlock

Update the validator set

func (*PersistentDummyApplication) Info

func (app *PersistentDummyApplication) Info(req types.RequestInfo) types.ResponseInfo

func (*PersistentDummyApplication) InitChain

func (app *PersistentDummyApplication) InitChain(req types.RequestInitChain) types.ResponseInitChain

Save the validators in the merkle tree

func (*PersistentDummyApplication) Query

func (app *PersistentDummyApplication) Query(reqQuery types.RequestQuery) types.ResponseQuery

func (*PersistentDummyApplication) SetLogger

func (app *PersistentDummyApplication) SetLogger(l log.Logger)

func (*PersistentDummyApplication) SetOption

func (app *PersistentDummyApplication) SetOption(req types.RequestSetOption) types.ResponseSetOption

func (*PersistentDummyApplication) Validators

func (app *PersistentDummyApplication) Validators() (validators []*types.Validator)