signers

Documentation

Overview

Package signers associates signers and their corresponding keys.

Index

• Constants
• Variables
• func IDGenerate() string
• func Path(s *Signer, ks keySpace, itemIndexes ...uint64) [][]byte
• type Signer
  • func Create(signerType string, xpubs []chainkd.XPub, quorum int, keyIndex uint64) (*Signer, error)

Constants

const (
	AssetKeySpace   keySpace = 0
	AccountKeySpace keySpace = 1
)

Variables

var (
	// ErrBadQuorum is returned by Create when the quorum
	// provided is less than 1 or greater than the number
	// of xpubs provided.
	ErrBadQuorum = errors.New("quorum must be greater than 1 and less than or equal to the length of xpubs")

	// ErrBadXPub is returned by Create when the xpub
	// provided isn't valid.
	ErrBadXPub = errors.New("invalid xpub format")

	// ErrNoXPubs is returned by create when the xpubs
	// slice provided is empty.
	ErrNoXPubs = errors.New("at least one xpub is required")

	// ErrBadType is returned when a find operation
	// retrieves a signer that is not the expected type.
	ErrBadType = errors.New("retrieved type does not match expected type")

	// ErrDupeXPub is returned by create when the same xpub
	// appears twice in a single call.
	ErrDupeXPub = errors.New("xpubs cannot contain the same key more than once")
)

Functions

func IDGenerate

func IDGenerate() string

IDGenerate generate signer unique id

func Path

func Path(s *Signer, ks keySpace, itemIndexes ...uint64) [][]byte

Path returns the complete path for derived keys

Types

type Signer

type Signer struct {
	Type     string         `json:"type"`
	XPubs    []chainkd.XPub `json:"xpubs"`
	Quorum   int            `json:"quorum"`
	KeyIndex uint64         `json:"key_index"`
}

Signer is the abstract concept of a signer, which is composed of a set of keys as well as the amount of signatures needed for quorum.

func Create

func Create(signerType string, xpubs []chainkd.XPub, quorum int, keyIndex uint64) (*Signer, error)

Create creates and stores a Signer in the database