signers

Documentation

Overview

Package signers associates signers and their corresponding keys.

Index

• Constants
• Variables
• func ConvertKeys(xpubs [][]byte) ([]chainkd.XPub, error)
• func Idgenerate(prefix string) (string, uint64)
• func Path(s *Signer, ks keySpace, itemIndexes ...uint64) [][]byte
• type Signer
  • func Create(ctx context.Context, db dbm.DB, typ string, xpubs []chainkd.XPub, quorum int, ...) (*Signer, error)
  • func Find(ctx context.Context, db dbm.DB, typ, id string) (*Signer, error)
  • func New(id, typ string, xpubs [][]byte, 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 ConvertKeys

func ConvertKeys(xpubs [][]byte) ([]chainkd.XPub, error)

func Idgenerate

func Idgenerate(prefix string) (string, uint64)

see the SQL function next_cahin_id in schema.sql on https://github.com/chain/chain

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 {
	ID       string
	Type     string
	XPubs    []chainkd.XPub
	Quorum   int
	KeyIndex uint64
}

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(ctx context.Context, db dbm.DB, typ string, xpubs []chainkd.XPub, quorum int, clientToken string) (*Signer, error)

Create creates and stores a Signer in the database

func Find

func Find(ctx context.Context, db dbm.DB, typ, id string) (*Signer, error)

Find retrieves a Signer from the database using the type and id.

func New

func New(id, typ string, xpubs [][]byte, quorum int, keyIndex uint64) (*Signer, error)