ethsecp256k1

Documentation

Index

• Constants
• Variables
• type PrivKey
  • func GenPrivKey() *PrivKey
  • func GenPrivKeyFromSecret(secret []byte) *PrivKey
  • func (privKey PrivKey) Bytes() []byte
  • func (*PrivKey) Descriptor() ([]byte, []int)
  • func (privKey PrivKey) Equals(other tmcrypto.PrivKey) bool
  • func (m *PrivKey) GetKey() []byte
  • func (m *PrivKey) Marshal() (dAtA []byte, err error)
  • func (privKey PrivKey) MarshalAmino() ([]byte, error)
  • func (privKey PrivKey) MarshalAminoJSON() ([]byte, error)
  • func (m *PrivKey) MarshalTo(dAtA []byte) (int, error)
  • func (m *PrivKey) MarshalToSizedBuffer(dAtA []byte) (int, error)
  • func (*PrivKey) ProtoMessage()
  • func (privKey PrivKey) PubKey() tmcrypto.PubKey
  • func (m *PrivKey) Reset()
  • func (privKey *PrivKey) Sign(digestBz []byte) ([]byte, error)
  • func (m *PrivKey) Size() (n int)
  • func (m *PrivKey) String() string
  • func (privKey PrivKey) ToECDSA() (*ecdsa.PrivateKey, error)
  • func (privKey PrivKey) Type() string
  • func (m *PrivKey) Unmarshal(dAtA []byte) error
  • func (privKey *PrivKey) UnmarshalAmino(bz []byte) error
  • func (privKey *PrivKey) UnmarshalAminoJSON(bz []byte) error
  • func (m *PrivKey) XXX_DiscardUnknown()
  • func (m *PrivKey) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)
  • func (m *PrivKey) XXX_Merge(src proto.Message)
  • func (m *PrivKey) XXX_Size() int
  • func (m *PrivKey) XXX_Unmarshal(b []byte) error
• type PubKey
  • func (pubKey *PubKey) Address() tmcrypto.Address
  • func (pubKey *PubKey) Bytes() []byte
  • func (*PubKey) Descriptor() ([]byte, []int)
  • func (pubKey *PubKey) Equals(other tmcrypto.PubKey) bool
  • func (m *PubKey) GetKey() []byte
  • func (m *PubKey) Marshal() (dAtA []byte, err error)
  • func (pubKey PubKey) MarshalAmino() ([]byte, error)
  • func (pubKey PubKey) MarshalAminoJSON() ([]byte, error)
  • func (m *PubKey) MarshalTo(dAtA []byte) (int, error)
  • func (m *PubKey) MarshalToSizedBuffer(dAtA []byte) (int, error)
  • func (*PubKey) ProtoMessage()
  • func (m *PubKey) Reset()
  • func (m *PubKey) Size() (n int)
  • func (pubKey *PubKey) String() string
  • func (pubKey *PubKey) Type() string
  • func (m *PubKey) Unmarshal(dAtA []byte) error
  • func (pubKey *PubKey) UnmarshalAmino(bz []byte) error
  • func (pubKey *PubKey) UnmarshalAminoJSON(bz []byte) error
  • func (pubKey PubKey) VerifySignature(msg, sig []byte) bool
  • func (m *PubKey) XXX_DiscardUnknown()
  • func (m *PubKey) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)
  • func (m *PubKey) XXX_Merge(src proto.Message)
  • func (m *PubKey) XXX_Size() int
  • func (m *PubKey) XXX_Unmarshal(b []byte) error

Constants

const (
	Ethsecp256k1PrivKeySize = 32
	Ethsecp256k1keyType     = "eth_secp256k1"
	PubKeyName              = "ethermint/PubKeyEthSecp256k1"
	PrivKeyName             = "ethermint/PrivKeyEthSecp256k1"
)

const PubKeySize = 33

PubKeySize is comprised of 32 bytes for one field element (the x-coordinate), plus one byte for the parity of the y-coordinate.

Variables

var (
	ErrInvalidLengthKeys        = fmt.Errorf("proto: negative length found during unmarshaling")
	ErrIntOverflowKeys          = fmt.Errorf("proto: integer overflow")
	ErrUnexpectedEndOfGroupKeys = fmt.Errorf("proto: unexpected end of group")
)

Types

type PrivKey

type PrivKey struct {
	Key []byte `protobuf:"bytes,1,opt,name=key,proto3" json:"key,omitempty"`
}

PrivKey defines a type alias for an ecdsa.PrivateKey that implements Tendermint's PrivateKey interface.

func GenPrivKey

func GenPrivKey() *PrivKey

GenPrivKey generates a new ECDSA private key on curve secp256k1 private key. It uses OS randomness to generate the private key.

func GenPrivKeyFromSecret

func GenPrivKeyFromSecret(secret []byte) *PrivKey

GenPrivKeyFromSecret hashes the secret with SHA2, and uses that 32 byte output to create the private key.

It makes sure the private key is a valid field element by setting:

c = sha256(secret) k = (c mod (n − 1)) + 1, where n = curve order.

NOTE: secret should be the output of a KDF like bcrypt, if it's derived from user input.

func (PrivKey) Bytes

func (privKey PrivKey) Bytes() []byte

Bytes returns the byte representation of the Private Key.

func (*PrivKey) Descriptor

func (*PrivKey) Descriptor() ([]byte, []int)

func (PrivKey) Equals

func (privKey PrivKey) Equals(other tmcrypto.PrivKey) bool

Equals - you probably don't need to use this. Runs in constant time based on length of the

func (*PrivKey) GetKey

func (m *PrivKey) GetKey() []byte

func (*PrivKey) Marshal

func (m *PrivKey) Marshal() (dAtA []byte, err error)

func (PrivKey) MarshalAmino

func (privKey PrivKey) MarshalAmino() ([]byte, error)

MarshalAmino overrides Amino binary marshalling.

func (PrivKey) MarshalAminoJSON

func (privKey PrivKey) MarshalAminoJSON() ([]byte, error)

MarshalAminoJSON overrides Amino JSON marshalling.

func (*PrivKey) MarshalTo

func (m *PrivKey) MarshalTo(dAtA []byte) (int, error)

func (*PrivKey) MarshalToSizedBuffer

func (m *PrivKey) MarshalToSizedBuffer(dAtA []byte) (int, error)

func (*PrivKey) ProtoMessage

func (*PrivKey) ProtoMessage()

func (PrivKey) PubKey

func (privKey PrivKey) PubKey() tmcrypto.PubKey

PubKey returns the ECDSA private key's public key. If the privkey is not valid it returns a nil value.

func (*PrivKey) Reset

func (m *PrivKey) Reset()

func (*PrivKey) Sign

func (privKey *PrivKey) Sign(digestBz []byte) ([]byte, error)

func (*PrivKey) Size

func (m *PrivKey) Size() (n int)

func (*PrivKey) String

func (m *PrivKey) String() string

func (PrivKey) ToECDSA

func (privKey PrivKey) ToECDSA() (*ecdsa.PrivateKey, error)

ToECDSA returns the ECDSA private key as a reference to ecdsa.PrivateKey type.

func (PrivKey) Type

func (privKey PrivKey) Type() string

func (*PrivKey) Unmarshal

func (m *PrivKey) Unmarshal(dAtA []byte) error

func (*PrivKey) UnmarshalAmino

func (privKey *PrivKey) UnmarshalAmino(bz []byte) error

UnmarshalAmino overrides Amino binary marshalling.

func (*PrivKey) UnmarshalAminoJSON

func (privKey *PrivKey) UnmarshalAminoJSON(bz []byte) error

UnmarshalAminoJSON overrides Amino JSON marshalling.

func (*PrivKey) XXX_DiscardUnknown

func (m *PrivKey) XXX_DiscardUnknown()

func (*PrivKey) XXX_Marshal

func (m *PrivKey) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*PrivKey) XXX_Merge

func (m *PrivKey) XXX_Merge(src proto.Message)

func (*PrivKey) XXX_Size

func (m *PrivKey) XXX_Size() int

func (*PrivKey) XXX_Unmarshal

func (m *PrivKey) XXX_Unmarshal(b []byte) error

type PubKey

type PubKey struct {
	Key []byte `protobuf:"bytes,1,opt,name=key,proto3" json:"key,omitempty"`
}

PubKey defines a type alias for an ecdsa.PublicKey that implements Tendermint's PubKey interface. It represents the 33-byte compressed public key format.

func (*PubKey) Address

func (pubKey *PubKey) Address() tmcrypto.Address

Address returns a Bitcoin style addresses: RIPEMD160(SHA256(pubkey))

func (*PubKey) Bytes

func (pubKey *PubKey) Bytes() []byte

Bytes returns the pubkey byte format.

func (*PubKey) Descriptor

func (*PubKey) Descriptor() ([]byte, []int)

func (*PubKey) Equals

func (pubKey *PubKey) Equals(other tmcrypto.PubKey) bool

func (*PubKey) GetKey

func (m *PubKey) GetKey() []byte

func (*PubKey) Marshal

func (m *PubKey) Marshal() (dAtA []byte, err error)

func (PubKey) MarshalAmino

func (pubKey PubKey) MarshalAmino() ([]byte, error)

MarshalAmino overrides Amino binary marshalling.

func (PubKey) MarshalAminoJSON

func (pubKey PubKey) MarshalAminoJSON() ([]byte, error)

MarshalAminoJSON overrides Amino JSON marshalling.

func (*PubKey) MarshalTo

func (m *PubKey) MarshalTo(dAtA []byte) (int, error)

func (*PubKey) MarshalToSizedBuffer

func (m *PubKey) MarshalToSizedBuffer(dAtA []byte) (int, error)

func (*PubKey) ProtoMessage

func (*PubKey) ProtoMessage()

func (*PubKey) Reset

func (m *PubKey) Reset()

func (*PubKey) Size

func (m *PubKey) Size() (n int)

func (*PubKey) String

func (pubKey *PubKey) String() string

func (*PubKey) Type

func (pubKey *PubKey) Type() string

func (*PubKey) Unmarshal

func (m *PubKey) Unmarshal(dAtA []byte) error

func (*PubKey) UnmarshalAmino

func (pubKey *PubKey) UnmarshalAmino(bz []byte) error

UnmarshalAmino overrides Amino binary marshalling.

func (*PubKey) UnmarshalAminoJSON

func (pubKey *PubKey) UnmarshalAminoJSON(bz []byte) error

UnmarshalAminoJSON overrides Amino JSON marshalling.

func (PubKey) VerifySignature

func (pubKey PubKey) VerifySignature(msg, sig []byte) bool

VerifySignature verifies that the ECDSA public key created a given signature over the provided message. It will calculate the Keccak256 hash of the message prior to verification.

CONTRACT: The signature should be in [R || S] format.

func (*PubKey) XXX_DiscardUnknown

func (m *PubKey) XXX_DiscardUnknown()

func (*PubKey) XXX_Marshal

func (m *PubKey) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)

func (*PubKey) XXX_Merge

func (m *PubKey) XXX_Merge(src proto.Message)

func (*PubKey) XXX_Size

func (m *PubKey) XXX_Size() int

func (*PubKey) XXX_Unmarshal

func (m *PubKey) XXX_Unmarshal(b []byte) error