pow

Documentation

Index

• Constants
• Variables
• type Hash
• type Worker
  • func New(hash Hash, numWorkers ...int) *Worker
  • func (w *Worker) LeadingZeros(data []byte) (int, error)
  • func (w *Worker) LeadingZerosWithNonce(msg []byte, nonce uint64) (int, error)
  • func (w *Worker) Mine(ctx context.Context, msg []byte, target int) (uint64, error)

Constants

const NonceBytes = 8

NonceBytes specifies the number of bytes required for the nonce.

Variables

var (
	ErrCancelled = errors.New("canceled")
	ErrDone      = errors.New("done")
)

errors returned by the PoW

Types

type Hash

type Hash interface {
	// Size returns the length, in bytes, of a digest resulting from the given hash function.
	Size() int
	// New returns a new hash.Hash calculating the given hash function.
	New() hash.Hash
}

Hash identifies a cryptographic hash function that is implemented in another package.

type Worker

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

The Worker provides PoW functionality using an arbitrary hash function.

func New

func New(hash Hash, numWorkers ...int) *Worker

New creates a new PoW based on the provided hash. The optional numWorkers specifies how many go routines are used to mine.

func (*Worker) LeadingZeros

func (w *Worker) LeadingZeros(data []byte) (int, error)

LeadingZeros returns the number of leading zeros in the digest of the given data.

func (*Worker) LeadingZerosWithNonce

func (w *Worker) LeadingZerosWithNonce(msg []byte, nonce uint64) (int, error)

LeadingZerosWithNonce returns the number of leading zeros in the digest after the provided 8-byte nonce is appended to msg.

func (*Worker) Mine

func (w *Worker) Mine(ctx context.Context, msg []byte, target int) (uint64, error)

Mine performs the PoW. It appends the 8-byte nonce to the provided msg and tries to find a nonce until the target number of leading zeroes is reached. The computation can be be canceled using the provided ctx.