wallet

package
v0.9.7-rc2 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Jun 18, 2021 License: Apache-2.0, MIT Imports: 32 Imported by: 4

Documentation

Index

Constants

View Source 
const (
	Lock
	Unlock
)
View Source 
const (
	MTUnknown = MsgType("unknown")

	// Signing message CID. MsgMeta.Extra contains raw cbor message bytes
	MTChainMsg = MsgType("message")

	// Signing a blockheader. signing raw cbor block bytes (MsgMeta.Extra is empty)
	MTBlock = MsgType("block")

	// Signing a deal proposal. signing raw cbor proposal bytes (MsgMeta.Extra is empty)
	MTDealProposal = MsgType("dealproposal")
	// extra is nil, 'toSign' is cbor raw bytes of 'DrawRandomParams'
	//  following types follow above rule
	MTDrawRandomParam = MsgType("drawrandomparam")
	MTSignedVoucher   = MsgType("signedvoucher")
	MTStorageAsk      = MsgType("storageask")
	MTAskResponse     = MsgType("askresponse")
	MTNetWorkResponse = MsgType("networkresposne")

	// reference : storagemarket/impl/remotecli.go:330
	// sign storagemarket.ClientDeal.ProposalCid,
	// MsgMeta.Extra is nil, 'toSign' is market.ClientDealProposal
	// storagemarket.ClientDeal.ProposalCid equals cborutil.AsIpld(market.ClientDealProposal).Cid()
	MTClientDeal = MsgType("clientdeal")

	MTProviderDealState = MsgType("providerdealstate")
)
View Source 
const (
	SigTypeUnknown = SigType(math.MaxUint8)

	SigTypeSecp256k1 = SigType(iota)
	SigTypeBLS
)
View Source 
const StringEmpty = ""
View Source 
const TestPassword = "test-password"

Variables

View Source 
var DSBackendType = reflect.TypeOf(&DSBackend{})

DSBackendType is the reflect type of the DSBackend.

View Source 
var ErrDecrypt = errors.New("could not decrypt key with given password")
View Source 
var ErrInvalidPassword = errors.New("password matching failed")
View Source 
var ErrKeyInfoNotFound = fmt.Errorf("key info not found")
View Source 
var ErrRepeatPassword = errors.New("set password more than once")
View Source 
var (
	NilAddress = Address{}
)

Functions

This section is empty.

Types

type Address added in v0.9.7 

type Address = address.Address

type AddressScope added in v0.9.7 

type AddressScope struct {
	Root      bool      // is root auth,  true : can get all addresses in the wallet
	Addresses []Address // when root==false, should fill a scope of wallet addresses
}

type Backend 

type Backend interface {
	// Addresses returns a list of all accounts currently stored in this backend.
	Addresses() []address.Address

	// Contains returns true if this backend stores the passed in address.
	HasAddress(address.Address) bool

	// Sign cryptographically signs data with the private key associated with an address.
	SignBytes([]byte, address.Address) (*crypto.Signature, error)

	// GetKeyInfo will return the keyinfo associated with address `addr`
	// iff backend contains the addr.
	GetKeyInfo(address.Address) (*crypto.KeyInfo, error)

	GetKeyInfoPassphrase(address.Address, []byte) (*crypto.KeyInfo, error)

	LockWallet() error
	UnLockWallet(string) error
	WalletState() int
}

Backend is the interface to represent different storage backends that can contain many addresses.

type Cid added in v0.9.7 

type Cid = cid.Cid

type CryptoJSON added in v0.9.1 

type CryptoJSON struct {
	Cipher       string                 `json:"cipher"`
	CipherText   string                 `json:"ciphertext"`
	CipherParams cipherParams           `json:"cipherparams"`
	KDF          string                 `json:"kdf"`
	KDFParams    map[string]interface{} `json:"kdfparams"`
	MAC          string                 `json:"mac"`
}

type DSBackend 

type DSBackend struct {
	PassphraseConf config.PassphraseConfig
	// contains filtered or unexported fields
}

DSBackend is a wallet backend implementation for storing addresses in a datastore.

func NewDSBackend 

func NewDSBackend(ds repo.Datastore, passphraseCfg config.PassphraseConfig, password string) (*DSBackend, error)

NewDSBackend constructs a new backend using the passed in datastore.

func (*DSBackend) Addresses 

func (backend *DSBackend) Addresses() []address.Address

Addresses returns a list of all addresses that are stored in this backend.

func (*DSBackend) GetKeyInfo 

func (backend *DSBackend) GetKeyInfo(addr address.Address) (*crypto.KeyInfo, error)

GetKeyInfo will return the private & public keys associated with address `addr` iff backend contains the addr.

func (*DSBackend) GetKeyInfoPassphrase added in v0.9.1 

func (backend *DSBackend) GetKeyInfoPassphrase(addr address.Address, password []byte) (*crypto.KeyInfo, error)

func (*DSBackend) HasAddress 

func (backend *DSBackend) HasAddress(addr address.Address) bool

HasAddress checks if the passed in address is stored in this backend. Safe for concurrent access.

func (*DSBackend) HasPassword added in v0.9.4 

func (backend *DSBackend) HasPassword() bool

func (*DSBackend) ImportKey 

func (backend *DSBackend) ImportKey(ki *crypto.KeyInfo) error

ImportKey loads the address in `ai` and KeyInfo `ki` into the backend

func (*DSBackend) LockWallet added in v0.9.7 

func (backend *DSBackend) LockWallet() error

func (*DSBackend) NewAddress 

func (backend *DSBackend) NewAddress(protocol address.Protocol) (address.Address, error)

NewAddress creates a new address and stores it. Safe for concurrent access.

func (*DSBackend) SetPassword added in v0.9.1 

func (backend *DSBackend) SetPassword(password string) error

func (*DSBackend) SignBytes 

func (backend *DSBackend) SignBytes(data []byte, addr address.Address) (*crypto.Signature, error)

SignBytes cryptographically signs `data` using the private key `priv`.

func (*DSBackend) UnLockWallet added in v0.9.7 

func (backend *DSBackend) UnLockWallet(password string) error

func (*DSBackend) WalletState added in v0.9.4 

func (backend *DSBackend) WalletState() int

type Importer 

type Importer interface {
	// ImportKey imports the key described by the given keyinfo
	// into the backend
	ImportKey(*crypto.KeyInfo) error
}

Importer is a specialization of a wallet backend that can import new keys into its permanent storage. Disk backed wallets can do this, hardware wallets generally cannot.

type KeccakState added in v0.9.1 

type KeccakState interface {
	hash.Hash
	Read([]byte) (int, error)
}

KeccakState wraps sha3.state. In addition to the usual hash methods, it also supports Read to get a variable amount of data from the hash state. Read is faster than Sum because it doesn't copy the internal state, but also modifies the internal state.

type Key added in v0.9.1 

type Key struct {
	ID uuid.UUID // Version 4 "random" for unique id not derived from key data
	// to simplify lookups we also store the address
	Address address.Address
	KeyInfo *crypto.KeyInfo
}

func (*Key) MarshalJSON added in v0.9.1 

func (k *Key) MarshalJSON() (j []byte, err error)

func (*Key) UnmarshalJSON added in v0.9.1 

func (k *Key) UnmarshalJSON(j []byte) (err error)

type KeyInfo added in v0.9.7 

type KeyInfo struct {
	Type       KeyType
	PrivateKey []byte
}

type KeyType added in v0.9.7 

type KeyType string

KeyType defines a type of a key 

const (
	KTUnknown   KeyType = "unknown"
	KTBLS       KeyType = "bls"
	KTSecp256k1 KeyType = "secp256k1"
)

func SignType2Key added in v0.9.7 

func SignType2Key(kt SigType) KeyType

func (*KeyType) UnmarshalJSON added in v0.9.7 

func (kt *KeyType) UnmarshalJSON(bb []byte) error

type MethodNum added in v0.9.7 

type MethodNum = abi.MethodNum

type MsgMeta 

type MsgMeta struct {
	Type MsgType
	// Additional data related to what is signed. Should be verifiable with the
	// signed bytes (e.g. CID(Extra).Bytes() == toSign)
	Extra []byte
}

type MsgType 

type MsgType string

type SigType added in v0.9.7 

type SigType = crypto.SigType

func KeyType2Sign added in v0.9.7 

func KeyType2Sign(kt KeyType) SigType

type Signature added in v0.9.7 

type Signature = crypto.Signature

type TokenAmount added in v0.9.7 

type TokenAmount = abi.TokenAmount

type Wallet 

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

wallet manages the locally stored addresses.

func New 

func New(backends ...Backend) *Wallet

New constructs a new wallet, that manages addresses in all the passed in backends.

func (*Wallet) Addresses 

func (w *Wallet) Addresses() []address.Address

Addresses retrieves all stored addresses. Safe for concurrent access. Always sorted in the same order.

func (*Wallet) Backends 

func (w *Wallet) Backends(typ reflect.Type) []Backend

Backends returns backends by their type.

func (*Wallet) DSBacked added in v0.9.1 

func (w *Wallet) DSBacked() (*DSBackend, error)

func (*Wallet) Export 

func (w *Wallet) Export(addr address.Address, password string) (*crypto.KeyInfo, error)

Export returns the KeyInfos for the given wallet addresses

func (*Wallet) Find 

func (w *Wallet) Find(addr address.Address) (Backend, error)

Find searches through all backends and returns the one storing the passed in address. Safe for concurrent access.

func (*Wallet) GetPubKeyForAddress 

func (w *Wallet) GetPubKeyForAddress(addr address.Address) ([]byte, error)

GetPubKeyForAddress returns the public key in the keystore associated with the given address.

func (*Wallet) HasAddress 

func (w *Wallet) HasAddress(a address.Address) bool

HasAddress checks if the given address is stored. Safe for concurrent access.

func (*Wallet) HasPassword added in v0.9.4 

func (w *Wallet) HasPassword() bool

func (*Wallet) Import 

func (w *Wallet) Import(ki *crypto.KeyInfo) (address.Address, error)

Import adds the given keyinfo to the wallet

func (*Wallet) LockWallet added in v0.9.7 

func (w *Wallet) LockWallet() error

func (*Wallet) NewAddress added in v0.9.1 

func (w *Wallet) NewAddress(p address.Protocol) (address.Address, error)

NewAddress creates a new account address on the default wallet backend.

func (*Wallet) NewKeyInfo 

func (w *Wallet) NewKeyInfo() (*crypto.KeyInfo, error)

NewKeyInfo creates a new KeyInfo struct in the wallet backend and returns it

func (*Wallet) SetPassword added in v0.9.1 

func (w *Wallet) SetPassword(password string) error

func (*Wallet) SignBytes 

func (w *Wallet) SignBytes(data []byte, addr address.Address) (*crypto.Signature, error)

SignBytes cryptographically signs `data` using the private key corresponding to address `addr`

func (*Wallet) UnLockWallet added in v0.9.7 

func (w *Wallet) UnLockWallet(password string) error

func (*Wallet) WalletSign 

func (w *Wallet) WalletSign(addr address.Address, msg []byte, meta MsgMeta) (*crypto.Signature, error)

func (*Wallet) WalletState added in v0.9.4 

func (w *Wallet) WalletState() int

type WalletIntersection added in v0.9.4 

type WalletIntersection interface {
	HasAddress(a address.Address) bool
	Addresses() []address.Address
	NewAddress(p address.Protocol) (address.Address, error)
	Import(ki *crypto.KeyInfo) (address.Address, error)
	Export(addr address.Address, password string) (*crypto.KeyInfo, error)
	WalletSign(keyAddr address.Address, msg []byte, meta MsgMeta) (*crypto.Signature, error)
	HasPassword() bool
}

WalletIntersection nolint

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.