dagfullblocktests

Documentation

Index

• func Generate(includeLargeReorg bool) (tests [][]TestInstance, err error)
• type AcceptedBlock
  • func (b AcceptedBlock) FullBlockTestInstance()
• type ExpectedTip
• type ExpectedTips
  • func (b ExpectedTips) FullBlockTestInstance()
• type OrphanOrRejectedBlock
  • func (b OrphanOrRejectedBlock) FullBlockTestInstance()
• type RejectedBlock
  • func (b RejectedBlock) FullBlockTestInstance()
• type RejectedNonCanonicalBlock
  • func (b RejectedNonCanonicalBlock) FullBlockTestInstance()
• type TestInstance

Functions

func Generate

func Generate(includeLargeReorg bool) (tests [][]TestInstance, err error)

Generate returns a slice of tests that can be used to exercise the consensus validation rules. The tests are intended to be flexible enough to allow both unit-style tests directly against the blockchain code as well as integration style tests over the peer-to-peer network. To achieve that goal, each test contains additional information about the expected result, however that information can be ignored when doing comparison tests between two independent versions over the peer-to-peer network.

Types

type AcceptedBlock

type AcceptedBlock struct {
	Name        string
	Block       *wire.MsgBlock
	Height      int32
	IsMainChain bool
	IsOrphan    bool
}

AcceptedBlock defines a test instance that expects a block to be accepted to the blockchain either by extending the main chain, on a side chain, or as an orphan.

func (AcceptedBlock) FullBlockTestInstance

func (b AcceptedBlock) FullBlockTestInstance()

FullBlockTestInstance only exists to allow AcceptedBlock to be treated as a TestInstance.

This implements the TestInstance interface.

type ExpectedTip

type ExpectedTip struct {
	Name   string
	Block  *wire.MsgBlock
	Height int32
}

ExpectedTip defines a test instance that expects a block to be the current tip of the main chain.

type ExpectedTips

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

func (ExpectedTips) FullBlockTestInstance

func (b ExpectedTips) FullBlockTestInstance()

FullBlockTestInstance only exists to allow ExpectedTip to be treated as a TestInstance.

This implements the TestInstance interface.

type OrphanOrRejectedBlock

type OrphanOrRejectedBlock struct {
	Name   string
	Block  *wire.MsgBlock
	Height int32
}

OrphanOrRejectedBlock defines a test instance that expects a block to either be accepted as an orphan or rejected. This is useful since some implementations might optimize the immediate rejection of orphan blocks when their parent was previously rejected, while others might accept it as an orphan that eventually gets flushed (since the parent can never be accepted to ultimately link it).

func (OrphanOrRejectedBlock) FullBlockTestInstance

func (b OrphanOrRejectedBlock) FullBlockTestInstance()

FullBlockTestInstance only exists to allow OrphanOrRejectedBlock to be treated as a TestInstance.

This implements the TestInstance interface.

type RejectedBlock

type RejectedBlock struct {
	Name       string
	Block      *wire.MsgBlock
	Height     int32
	RejectCode blockdag.ErrorCode
}

RejectedBlock defines a test instance that expects a block to be rejected by the blockchain consensus rules.

func (RejectedBlock) FullBlockTestInstance

func (b RejectedBlock) FullBlockTestInstance()

FullBlockTestInstance only exists to allow RejectedBlock to be treated as a TestInstance.

This implements the TestInstance interface.

type RejectedNonCanonicalBlock

type RejectedNonCanonicalBlock struct {
	Name     string
	RawBlock []byte
	Height   int32
}

RejectedNonCanonicalBlock defines a test instance that expects a serialized block that is not canonical and therefore should be rejected.

func (RejectedNonCanonicalBlock) FullBlockTestInstance

func (b RejectedNonCanonicalBlock) FullBlockTestInstance()

FullBlockTestInstance only exists to allow RejectedNonCanonicalBlock to be treated as a TestInstance.

This implements the TestInstance interface.

type TestInstance

type TestInstance interface {
	FullBlockTestInstance()
}

TestInstance is an interface that describes a specific test instance returned by the tests generated in this package. It should be type asserted to one of the concrete test instance types in order to test accordingly.