crypto

package
v0.11.0 Latest Latest
Warning

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

 Go to latest Published: Mar 24, 2026 License: MIT Imports: 36 Imported by: 40

Documentation

Index

Constants

View Source 
const (
	DigestSize    = 32
	KeySize       = 32
	PublicKeySize = KeySize
	SecretKeySize = KeySize
	SignatureSize = 64
)
View Source 
const (
	P256RawPubKeySize  = 64 // X(32) || Y(32)
	P1363SignatureSize = 64
)
View Source 
const (
	ProofSize = 32 + 32 + 32
)

Variables

View Source 
var (
	ZeroDigest = Digest{
		0x03, 0x17, 0x0a, 0x2e, 0x75, 0x97, 0xb7, 0xb7, 0xe3, 0xd8, 0x4c, 0x05, 0x39, 0x1d, 0x13, 0x9a,
		0x62, 0xb1, 0x57, 0xe7, 0x87, 0x86, 0xd8, 0xc0, 0x82, 0xf2, 0x9d, 0xcf, 0x4c, 0x11, 0x13, 0x14,
	}
)

Functions

func CertificatePublicKeyToBytes added in v0.11.0 

func CertificatePublicKeyToBytes(cert *x509.Certificate) ([]byte, error)

CertificatePublicKeyToBytes extracts the public key from the provided X.509 certificate. Certificate must contain an ECDSA public key on the NIST P-256 curve.

func ComputeVRF added in v0.5.0 

func ComputeVRF(sk SecretKey, msg []byte) []byte

ComputeVRF generates the VRF value for the byte slice msg using given private key sk.

func Decrypt added in v0.3.0 

func Decrypt(key, encrypted []byte) ([]byte, error)

func ECDSANewPrivateKey added in v0.10.0 

func ECDSANewPrivateKey() (*btcec.PrivateKey, error)

func ECDSAParsePublicKey added in v0.10.0 

func ECDSAParsePublicKey(data []byte) (*btcec.PublicKey, error)

func ECDSAParsePublicKeyFromHex added in v0.10.0 

func ECDSAParsePublicKeyFromHex(hexString string) (*btcec.PublicKey, error)

func ECDSAPrivateKeyFromBytes added in v0.10.0 

func ECDSAPrivateKeyFromBytes(d []byte) (*btcec.PrivateKey, error)

ECDSAPrivateKeyFromBytes creates btcec.PrivateKey from 'd' PrivateKey parameter with appropriate checks.

func ECDSAPrivateKeyFromHexString added in v0.10.0 

func ECDSAPrivateKeyFromHexString(hexString string) (*btcec.PrivateKey, error)

ECDSAPrivateKeyFromHexString creates btcec.PrivateKey from hex string with appropriate checks.

func ECDSARecoverPublicKey added in v0.7.0 

func ECDSARecoverPublicKey(digest, signature []byte) (*btcec.PublicKey, error)

ECDSARecoverPublicKey recovers the public key from the given signature and digest. The signature must be in the [R || S || V] format where V is 27 or 28 (legacy format, not EIP-155). If V is lower than 27, it is converted to the legacy format by adding 27, so acceptable values for V are 0, 1, 27, 28. Signatures after EIP-155 must be converted to the legacy format.

func ECDSASign added in v0.10.0 

func ECDSASign(digest []byte, sk *btcec.PrivateKey) ([]byte, error)

ECDSASign 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 adversary. 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 Encrypt added in v0.3.0 

func Encrypt(key, message []byte) ([]byte, error)

func GenerateKeyPair 

func GenerateKeyPair(seed []byte) (SecretKey, PublicKey, error)

func Groth16Verify added in v0.5.0 

func Groth16Verify(vkBytes []byte, proofBytes []byte, inputsBytes []byte, curve ecc.ID) (bool, error)

func IsRevoked added in v0.11.0 

func IsRevoked(cert *x509.Certificate, revocationLists []*x509.RevocationList) bool

func LoadCertificate added in v0.11.0 

func LoadCertificate(
	certificates []*x509.Certificate, revocations []*x509.RevocationList, ts time.Time,
) (*x509.Certificate, error)

func MustBytesFromBase58 added in v0.5.0 

func MustBytesFromBase58(s string) []byte

func NewFastHash added in v0.6.0 

func NewFastHash() (hash.Hash, error)

func ParseCertificates added in v0.11.0 

func ParseCertificates(data [][]byte) ([]*x509.Certificate, error)

func ParseRevocationLists added in v0.11.0 

func ParseRevocationLists(data [][]byte) ([]*x509.RevocationList, error)

func SecP256Verify added in v0.11.0 

func SecP256Verify(digest, publicKey, signature []byte) (bool, error)

SecP256Verify verifies ECDSA signature on NIST P-256. Public key must be in raw (64-byte) format. Signature must be in 64-byte P1363 format (R(32) || S(32)).

func SharedKey added in v0.3.0 

func SharedKey(sk SecretKey, pk PublicKey, prefix []byte) ([]byte, error)

func SignVRF added in v0.5.0 

func SignVRF(sk SecretKey, msg []byte) ([]byte, error)

func Verify 

func Verify(publicKey PublicKey, sig Signature, data []byte) bool

func VerifyRevocationList added in v0.11.0 

func VerifyRevocationList(revocationList *x509.RevocationList, certificates []*x509.Certificate, ts time.Time) error

func VerifyVRF added in v0.5.0 

func VerifyVRF(pk PublicKey, msg, signature []byte) (bool, []byte, error)

Types

type Digest 

type Digest [DigestSize]byte

func FastHash 

func FastHash(data []byte) (Digest, error)

func Keccak256 

func Keccak256(data []byte) (Digest, error)

func MustDigestFromBase58 added in v0.3.0 

func MustDigestFromBase58(s string) Digest

func MustFastHash added in v0.3.0 

func MustFastHash(data []byte) Digest

func MustKeccak256 added in v0.10.0 

func MustKeccak256(data []byte) Digest

func NewDigestFromBase58 

func NewDigestFromBase58(s string) (Digest, error)

func NewDigestFromBytes added in v0.2.0 

func NewDigestFromBytes(b []byte) (Digest, error)

func SecureHash 

func SecureHash(data []byte) (Digest, error)

func (Digest) Bytes added in v0.2.0 

func (d Digest) Bytes() []byte

func (Digest) Hex added in v0.10.2 

func (d Digest) Hex() string

func (*Digest) IsZero added in v0.11.0 

func (d *Digest) IsZero() bool

func (Digest) MarshalBinary 

func (d Digest) MarshalBinary() ([]byte, error)

func (Digest) MarshalJSON 

func (d Digest) MarshalJSON() ([]byte, error)

func (Digest) ShortString added in v0.3.0 

func (d Digest) ShortString() string

func (Digest) String 

func (d Digest) String() string

func (*Digest) UnmarshalBinary 

func (d *Digest) UnmarshalBinary(data []byte) error

func (*Digest) UnmarshalJSON 

func (d *Digest) UnmarshalJSON(value []byte) error

type IncorrectLengthError added in v0.10.4 

type IncorrectLengthError struct {
	Name        string
	Len         int
	ExpectedLen int
}

func NewIncorrectLengthError added in v0.10.4 

func NewIncorrectLengthError(name string, len int, expectedLen int) IncorrectLengthError

func (IncorrectLengthError) Error added in v0.10.4 

func (e IncorrectLengthError) Error() string

type MerkleTree added in v0.5.0 

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

func NewMerkleTree added in v0.5.0 

func NewMerkleTree() (*MerkleTree, error)

func (*MerkleTree) Push added in v0.5.0 

func (t *MerkleTree) Push(data []byte)

func (*MerkleTree) RebuildRoot added in v0.5.0 

func (t *MerkleTree) RebuildRoot(leaf Digest, proofsRootToLeafsOrder []Digest, index uint64) Digest

func (*MerkleTree) Root added in v0.5.0 

func (t *MerkleTree) Root() Digest

type PublicKey 

type PublicKey [PublicKeySize]byte

func GeneratePublicKey 

func GeneratePublicKey(sk SecretKey) PublicKey

func MustPublicKeyFromBase58 added in v0.3.0 

func MustPublicKeyFromBase58(s string) PublicKey

func NewPublicKeyFromBase58 

func NewPublicKeyFromBase58(s string) (PublicKey, error)

func NewPublicKeyFromBytes added in v0.2.0 

func NewPublicKeyFromBytes(b []byte) (PublicKey, error)

func (*PublicKey) Bytes added in v0.2.0 

func (k *PublicKey) Bytes() []byte

func (PublicKey) MarshalBinary 

func (k PublicKey) MarshalBinary() ([]byte, error)

func (PublicKey) MarshalJSON 

func (k PublicKey) MarshalJSON() ([]byte, error)

func (PublicKey) String added in v0.2.0 

func (k PublicKey) String() string

func (*PublicKey) UnmarshalBinary 

func (k *PublicKey) UnmarshalBinary(data []byte) error

func (*PublicKey) UnmarshalJSON 

func (k *PublicKey) UnmarshalJSON(value []byte) error

func (PublicKey) WriteToBuf added in v0.10.5 

func (k PublicKey) WriteToBuf(buf []byte) error

type SecretKey 

type SecretKey [SecretKeySize]byte

func GenerateSecretKey 

func GenerateSecretKey(seed []byte) SecretKey

func MustSecretKeyFromBase58 added in v0.5.0 

func MustSecretKeyFromBase58(s string) SecretKey

func NewSecretKeyFromBase58 

func NewSecretKeyFromBase58(s string) (SecretKey, error)

func NewSecretKeyFromBytes added in v0.3.0 

func NewSecretKeyFromBytes(b []byte) (SecretKey, error)

func (SecretKey) Bytes added in v0.3.0 

func (k SecretKey) Bytes() []byte

func (SecretKey) MarshalBinary 

func (k SecretKey) MarshalBinary() ([]byte, error)

func (SecretKey) MarshalJSON 

func (k SecretKey) MarshalJSON() ([]byte, error)

func (SecretKey) String added in v0.1.2 

func (k SecretKey) String() string

func (*SecretKey) UnmarshalBinary 

func (k *SecretKey) UnmarshalBinary(data []byte) error

func (*SecretKey) UnmarshalJSON 

func (k *SecretKey) UnmarshalJSON(value []byte) error

type Signature 

type Signature [SignatureSize]byte

func MustSignatureFromBase58 added in v0.3.0 

func MustSignatureFromBase58(s string) Signature

func NewSignatureFromBase58 

func NewSignatureFromBase58(s string) (Signature, error)

func NewSignatureFromBytes added in v0.2.0 

func NewSignatureFromBytes(b []byte) (Signature, error)

func Sign 

func Sign(secretKey SecretKey, data []byte) (Signature, error)

func (Signature) Bytes added in v0.2.0 

func (s Signature) Bytes() []byte

func (Signature) MarshalBinary 

func (s Signature) MarshalBinary() ([]byte, error)

func (Signature) MarshalJSON 

func (s Signature) MarshalJSON() ([]byte, error)

func (Signature) ShortString added in v0.3.0 

func (s Signature) ShortString() string

func (Signature) String added in v0.1.2 

func (s Signature) String() string

func (*Signature) UnmarshalBinary 

func (s *Signature) UnmarshalBinary(data []byte) error

func (*Signature) UnmarshalJSON 

func (s *Signature) UnmarshalJSON(value []byte) error

Source Files

View all Source files

Directories

Path Synopsis
groth16/bls12_381
groth16/bn256

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.