ethkey

Documentation

Index

• type EIP55Address
  • func EIP55AddressFromAddress(a common.Address) EIP55Address
  • func MustEIP55Address(s string) EIP55Address
  • func NewEIP55Address(s string) (EIP55Address, error)
  • func (a EIP55Address) Address() common.Address
  • func (a EIP55Address) Big() *big.Int
  • func (a EIP55Address) Bytes() []byte
  • func (a EIP55Address) Format(s fmt.State, c rune)
  • func (a EIP55Address) Hash() common.Hash
  • func (a EIP55Address) Hex() string
  • func (a EIP55Address) IsZero() bool
  • func (a *EIP55Address) Scan(value interface{}) error
  • func (a EIP55Address) String() string
  • func (a *EIP55Address) UnmarshalJSON(input []byte) error
  • func (a *EIP55Address) UnmarshalText(input []byte) error
  • func (a EIP55Address) Value() (driver.Value, error)
• type EIP55AddressCollection
  • func (c *EIP55AddressCollection) Scan(value interface{}) error
  • func (c EIP55AddressCollection) Value() (driver.Value, error)
• type EncryptedEthKeyExport
• type Key
  • func (k Key) Type() string
• type KeyV2
  • func FromPrivateKey(privKey *ecdsa.PrivateKey) (key KeyV2)
  • func NewV2() (KeyV2, error)
  • func (key KeyV2) Cmp(key2 KeyV2) int
  • func (key KeyV2) GoString() string
  • func (key KeyV2) ID() string
  • func (key KeyV2) Raw() Raw
  • func (key KeyV2) String() string
  • func (key KeyV2) ToEcdsaPrivKey() *ecdsa.PrivateKey
  • func (key KeyV2) ToEncryptedJSON(password string, scryptParams utils.ScryptParams) (export []byte, err error)
• type Raw
  • func (raw Raw) GoString() string
  • func (raw Raw) Key() KeyV2
  • func (raw Raw) String() string
• type State
  • func (s State) KeyID() string
  • func (s State) LastUsed() time.Time
  • func (s *State) WasUsed()

Types

type EIP55Address

type EIP55Address string

EIP55Address is a new type for string which persists an ethereum address in its original string representation which includes a leading 0x, and EIP55 checksum which is represented by the case of digits A-F.

func EIP55AddressFromAddress

func EIP55AddressFromAddress(a common.Address) EIP55Address

EIP55AddressFromAddress forces an address into EIP55Address format It is safe to panic on error since address.Hex() should ALWAYS generate EIP55Address-compatible hex strings

func MustEIP55Address

func MustEIP55Address(s string) EIP55Address

func NewEIP55Address

func NewEIP55Address(s string) (EIP55Address, error)

NewEIP55Address creates an EIP55Address from a string, an error is returned if:

1) There is no leading 0x 2) The length is wrong 3) There are any non hexadecimal characters 4) The checksum fails

func (EIP55Address) Address

func (a EIP55Address) Address() common.Address

Address returns EIP55Address as a go-ethereum Address type

func (EIP55Address) Big

func (a EIP55Address) Big() *big.Int

Big returns a big.Int representation

func (EIP55Address) Bytes

func (a EIP55Address) Bytes() []byte

Bytes returns the raw bytes

func (EIP55Address) Format

func (a EIP55Address) Format(s fmt.State, c rune)

Format implements fmt.Formatter

func (EIP55Address) Hash

func (a EIP55Address) Hash() common.Hash

Hash returns the Hash

func (EIP55Address) Hex

func (a EIP55Address) Hex() string

Hex is identical to String but makes the API similar to common.Address

func (EIP55Address) IsZero

func (a EIP55Address) IsZero() bool

IsZeroAddress determines whether the address is 0x0000... or not

func (*EIP55Address) Scan

func (a *EIP55Address) Scan(value interface{}) error

Scan reads the database value and returns an instance.

func (EIP55Address) String

func (a EIP55Address) String() string

String implements the stringer interface and is used also by the logger.

func (*EIP55Address) UnmarshalJSON

func (a *EIP55Address) UnmarshalJSON(input []byte) error

UnmarshalJSON parses a hash from a JSON string

func (*EIP55Address) UnmarshalText

func (a *EIP55Address) UnmarshalText(input []byte) error

UnmarshalText parses a hash from plain text

func (EIP55Address) Value

func (a EIP55Address) Value() (driver.Value, error)

Value returns this instance serialized for database storage.

type EIP55AddressCollection

type EIP55AddressCollection []EIP55Address

EIP55AddressCollection is an array of EIP55Addresses.

func (*EIP55AddressCollection) Scan

func (c *EIP55AddressCollection) Scan(value interface{}) error

Scan reads the database value and returns an instance.

func (EIP55AddressCollection) Value

func (c EIP55AddressCollection) Value() (driver.Value, error)

Value returns this instance serialized for database storage.

type EncryptedEthKeyExport

type EncryptedEthKeyExport struct {
	KeyType string              `json:"keyType"`
	Address EIP55Address        `json:"address"`
	Crypto  keystore.CryptoJSON `json:"crypto"`
}

type Key

type Key struct {
	ID        int32
	Address   EIP55Address
	JSON      datatypes.JSON `json:"-"`
	CreatedAt time.Time      `json:"-"`
	UpdatedAt time.Time      `json:"-"`
	DeletedAt *time.Time     `json:"-"`
	// This is the nonce that should be used for the next transaction.
	// Conceptually equivalent to geth's `PendingNonceAt` but more reliable
	// because we have a better view of our own transactions
	// NOTE: Be cautious about using this field, it is provided for convenience
	// only, can go out of date, and should not be relied upon. The source of
	// truth is always the database row for the key.
	NextNonce int64 `json:"-"`
	// IsFunding marks the address as being used for rescuing the  node and the pending transactions
	// Only one key can be IsFunding=true at a time.
	IsFunding bool
}

NOTE: This model refers to the OLD key and is only used for migrations

Key holds the private key metadata for a given address that is used to unlock said key when given a password.

By default, a key is assumed to represent an ethereum account.

func (Key) Type

func (k Key) Type() string

Type returns type of key

type KeyV2

type KeyV2 struct {
	Address      common.Address
	EIP55Address EIP55Address
	// contains filtered or unexported fields
}

func FromPrivateKey

func FromPrivateKey(privKey *ecdsa.PrivateKey) (key KeyV2)

func NewV2

func NewV2() (KeyV2, error)

func (KeyV2) Cmp

func (key KeyV2) Cmp(key2 KeyV2) int

Cmp uses byte-order address comparison to give a stable comparison between two keys

func (KeyV2) GoString

func (key KeyV2) GoString() string

func (KeyV2) ID

func (key KeyV2) ID() string

func (KeyV2) Raw

func (key KeyV2) Raw() Raw

func (KeyV2) String

func (key KeyV2) String() string

func (KeyV2) ToEcdsaPrivKey

func (key KeyV2) ToEcdsaPrivKey() *ecdsa.PrivateKey

func (KeyV2) ToEncryptedJSON

func (key KeyV2) ToEncryptedJSON(password string, scryptParams utils.ScryptParams) (export []byte, err error)

type Raw

type Raw []byte

func (Raw) GoString

func (raw Raw) GoString() string

func (Raw) Key

func (raw Raw) Key() KeyV2

func (Raw) String

func (raw Raw) String() string

type State

type State struct {
	ID         int32
	Address    EIP55Address
	EVMChainID utils.Big
	// NextNonce is used for convenience and rendering in UI but the source of
	// truth is always the DB
	NextNonce int64
	Disabled  bool
	CreatedAt time.Time
	UpdatedAt time.Time
	// contains filtered or unexported fields
}

func (State) KeyID

func (s State) KeyID() string

func (State) LastUsed

func (s State) LastUsed() time.Time

lastUsed is an internal field and ought not be persisted to the database or exposed outside of the application

func (*State) WasUsed

func (s *State) WasUsed()