crypto

Documentation

Index

• Constants
• func CompressPubkey(pubkey *ecdsa.PublicKey) []byte
• func DecompressPubkey(pubkey []byte) (*ecdsa.PublicKey, error)
• func Ecrecover(hash, sig []byte) ([]byte, error)
• func FromECDSAPub(pub *ecdsa.PublicKey) []byte
• func HexToECDSA(hexkey string) (*ecdsa.PrivateKey, error)
• func Keccak256(data ...[]byte) []byte
• func LoadECDSA(file string) (*ecdsa.PrivateKey, error)
• func S256() elliptic.Curve
• func SigToPub(hash, sig []byte) (*ecdsa.PublicKey, error)
• func Sign(hash []byte, prv *ecdsa.PrivateKey) ([]byte, error)
• func ToECDSA(d []byte) (*ecdsa.PrivateKey, error)
• func ToECDSAUnsafe(d []byte) *ecdsa.PrivateKey
• func UnmarshalPubkey(pub []byte) (*ecdsa.PublicKey, error)
• func VerifySignature(pubkey, hash, signature []byte) bool
• type Address
  • func BytesToAddress(b []byte) Address
  • func PubkeyToAddress(p ecdsa.PublicKey) Address
  • func (a *Address) SetBytes(b []byte)

Constants

const AddressLength = 20

const DigestLength = 32

DigestLength sets the signature digest exact length

const RecoveryIDOffset = 64

RecoveryIDOffset points to the byte offset within the signature that contains the recovery id.

const SignatureLength = 64 + 1 // 64 bytes ECDSA signature + 1 byte recovery id

SignatureLength indicates the byte length required to carry a signature with recovery id.

Functions

func CompressPubkey

func CompressPubkey(pubkey *ecdsa.PublicKey) []byte

CompressPubkey encodes a public key to the 33-byte compressed format.

func DecompressPubkey

func DecompressPubkey(pubkey []byte) (*ecdsa.PublicKey, error)

DecompressPubkey parses a public key in the 33-byte compressed format.

func Ecrecover

func Ecrecover(hash, sig []byte) ([]byte, error)

Ecrecover returns the uncompressed public key that created the given signature.

func FromECDSAPub

func FromECDSAPub(pub *ecdsa.PublicKey) []byte

func HexToECDSA

func HexToECDSA(hexkey string) (*ecdsa.PrivateKey, error)

HexToECDSA parses a secp256k1 private key.

func Keccak256

func Keccak256(data ...[]byte) []byte

Keccak256 calculates and returns the Keccak256 hash of the input data.

func LoadECDSA

func LoadECDSA(file string) (*ecdsa.PrivateKey, error)

LoadECDSA loads a secp256k1 private key from the given file.

func S256

func S256() elliptic.Curve

S256 returns an instance of the secp256k1 curve.

func SigToPub

func SigToPub(hash, sig []byte) (*ecdsa.PublicKey, error)

SigToPub returns the public key that created the given signature.

func Sign

func Sign(hash []byte, prv *ecdsa.PrivateKey) ([]byte, error)

Sign calculates an ECDSA signature.

This function is susceptible to chosen plaintext attacks that can leak information about the private key that is used for signing. Callers must be aware that the given hash cannot be chosen by an adversery. Common solution is to hash any input before calculating the signature.

The produced signature is in the [R || S || V] format where V is 0 or 1.

func ToECDSA

func ToECDSA(d []byte) (*ecdsa.PrivateKey, error)

ToECDSA creates a private key with the given D value.

func ToECDSAUnsafe

func ToECDSAUnsafe(d []byte) *ecdsa.PrivateKey

ToECDSAUnsafe blindly converts a binary blob to a private key. It should almost never be used unless you are sure the input is valid and want to avoid hitting errors due to bad origin encoding (0 prefixes cut off).

func UnmarshalPubkey

func UnmarshalPubkey(pub []byte) (*ecdsa.PublicKey, error)

UnmarshalPubkey converts bytes to a secp256k1 public key.

func VerifySignature

func VerifySignature(pubkey, hash, signature []byte) bool

VerifySignature checks that the given public key created signature over hash. The public key should be in compressed (33 bytes) or uncompressed (65 bytes) format. The signature should have the 64 byte [R || S] format.

Types

type Address

type Address [AddressLength]byte

Address represents the 20 byte address of an Ethereum account.

func BytesToAddress

func BytesToAddress(b []byte) Address

BytesToAddress returns Address with value b. If b is larger than len(h), b will be cropped from the left.

func PubkeyToAddress

func PubkeyToAddress(p ecdsa.PublicKey) Address

func (*Address) SetBytes

func (a *Address) SetBytes(b []byte)

SetBytes sets the address to the value of b. If b is larger than len(a) it will panic.