crypto

Documentation

Index

• Constants
• func CreateAddress(b common.Address, nonce uint64) common.Address
• func CreateAddress2(b common.Address, salt [64]byte, inithash []byte) common.Address
• func Ecrecover(hash, sig []byte) ([]byte, error)
• func FromECDSA(priv *gost3410.PrivateKey) []byte
• func FromECDSAPub(pub *gost3410.PublicKey) []byte
• func GenerateKey() (*gost3410.PrivateKey, error)
• func HashData(kh StreebogState, data []byte) (h common.Hash)
• func HexToECDSA(hexkey string) (*gost3410.PrivateKey, error)
• func Keccak256(data ...[]byte) []byte
• func LoadECDSA(file string) (*gost3410.PrivateKey, error)
• func PubkeyToAddress(p gost3410.PublicKey) common.Address
• func SaveECDSA(file string, key *gost3410.PrivateKey) error
• func SigToPub(hash, sig []byte) (*gost3410.PublicKey, error)
• func Sign(digestHash []byte, prv *gost3410.PrivateKey) ([]byte, error)
• func Streebog256(data ...[]byte) []byte
• func Streebog256Hash(data ...[]byte) (h common.Hash)
• func Streebog512(data ...[]byte) []byte
• func Streebog512Hash(data ...[]byte) (h common.Hash)
• func ToECDSA(d []byte) (*gost3410.PrivateKey, error)
• func ToECDSAUnsafe(d []byte) *gost3410.PrivateKey
• func UnmarshalPubkey(pub []byte) (*gost3410.PublicKey, error)
• func ValidateSignatureValues(v byte, r, s *big.Int, homestead bool) bool
• func VerifySignature(pubkey, digestHash, signature []byte) (bool, error)
• type KeccakState
  • func NewKeccakState() KeccakState
• type StreebogState
  • func NewStreebogState(n int) StreebogState

Constants

const DigestLength = 64

DigestLength sets the signature digest exact length

const RecoveryIDOffset = 128

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

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

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

Functions

func CreateAddress

func CreateAddress(b common.Address, nonce uint64) common.Address

CreateAddress creates an ethereum address given the bytes and the nonce

func CreateAddress2

func CreateAddress2(b common.Address, salt [64]byte, inithash []byte) common.Address

CreateAddress2 creates an ethereum address given the address bytes, initial contract code hash and a salt.

func Ecrecover

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

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

func FromECDSA

func FromECDSA(priv *gost3410.PrivateKey) []byte

FromECDSA exports a private key into a binary dump.

func FromECDSAPub

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

func GenerateKey

func GenerateKey() (*gost3410.PrivateKey, error)

GenerateKey generates a new private key.

func HashData

func HashData(kh StreebogState, data []byte) (h common.Hash)

HashData hashes the provided data using the KeccakState and returns a 32 byte hash

func HexToECDSA

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

HexToECDSA parses a gost3410 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) (*gost3410.PrivateKey, error)

LoadECDSA loads a secp256k1 private key from the given file.

func PubkeyToAddress

func PubkeyToAddress(p gost3410.PublicKey) common.Address

func SaveECDSA

func SaveECDSA(file string, key *gost3410.PrivateKey) error

SaveECDSA saves a secp256k1 private key to the given file with restrictive permissions. The key data is saved hex-encoded.

func SigToPub

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

SigToPub returns the public key that created the given signature.

func Sign

func Sign(digestHash []byte, prv *gost3410.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 digest 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 Streebog256

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

Sreebog256 calculates and returns the Streebog256 hash of the input data.

func Streebog256Hash

func Streebog256Hash(data ...[]byte) (h common.Hash)

Sreebog256Hash calculates and returns the Sreebog256 hash of the input data, converting it to an internal Hash data structure.

func Streebog512

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

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

func Streebog512Hash

func Streebog512Hash(data ...[]byte) (h common.Hash)

Sreebog512Hash calculates and returns the Sreebog512 hash of the input data, converting it to an internal Hash data structure.

func ToECDSA

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

ToECDSA creates a private key with the given D value.

func ToECDSAUnsafe

func ToECDSAUnsafe(d []byte) *gost3410.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) (*gost3410.PublicKey, error)

UnmarshalPubkey converts bytes to a gost3410 public key.

func ValidateSignatureValues

func ValidateSignatureValues(v byte, r, s *big.Int, homestead bool) bool

ValidateSignatureValues verifies whether the signature values are valid with the given chain rules. The v value is assumed to be either 0 or 1.

func VerifySignature

func VerifySignature(pubkey, digestHash, signature []byte) (bool, error)

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

Types

type KeccakState

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.

func NewKeccakState

func NewKeccakState() KeccakState

NewKeccakState creates a new KeccakState

type StreebogState

type StreebogState interface {
	hash.Hash
}

func NewStreebogState

func NewStreebogState(n int) StreebogState

NewStreebogState creates a new StreebogState