ethsig

package module

Go to main page

Versions in this module

v0

v0.5.2

Mar 20, 2026

Changes in this version

+ func EncodeSignature(r, s, v *big.Int, chainID *big.Int) ([]byte, error)

+ func NormalizeRecoveryID(v *big.Int, chainID *big.Int) (byte, error)

v0.5.1

Mar 18, 2026

v0.5.0

Mar 9, 2026

v0.4.0

Feb 27, 2026

Changes in this version

+ var ErrHDDerivationFailed = errors.New("HD key derivation failed")

+ var ErrHDWalletAlreadyExists = errors.New("HD wallet already exists")

+ var ErrHDWalletClosed = errors.New("HD wallet is closed")

+ var ErrHDWalletDecryptFailed = errors.New("HD wallet decryption failed")

+ var ErrHDWalletInvalidVersion = errors.New("unsupported HD wallet version")

+ var ErrHDWalletNotFound = errors.New("HD wallet file not found")

+ var ErrInvalidDerivationRange = errors.New("invalid derivation range: start must be less than end")

+ var ErrMnemonicInvalid = errors.New("invalid BIP-39 mnemonic")

+ func IsHDWalletError(err error) bool

type ErrorType

+ const ErrorTypeHDWallet

+ type HDWalletSigner struct

+ func NewHDWalletSigner(wallet *keystore.HDWallet, index uint32) (*HDWalletSigner, error)

+ func (s *HDWalletSigner) Close() error

+ func (s *HDWalletSigner) GetAddress() common.Address

+ func (s *HDWalletSigner) PersonalSign(data string) ([]byte, error)

+ func (s *HDWalletSigner) SignEIP191Message(message string) ([]byte, error)

+ func (s *HDWalletSigner) SignHash(hashedData common.Hash) ([]byte, error)

+ func (s *HDWalletSigner) SignRawMessage(raw []byte) ([]byte, error)

+ func (s *HDWalletSigner) SignTransactionWithChainID(tx *types.Transaction, chainID *big.Int) (*types.Transaction, error)

+ func (s *HDWalletSigner) SignTypedData(typedData eip712.TypedData) ([]byte, error)

type TypedError

+ func NewHDWalletError(message string, cause error) *TypedError

v0.3.1

Feb 20, 2026

v0.3.0

Feb 5, 2026

v0.2.2

Feb 5, 2026

v0.2.1

Feb 5, 2026

v0.2.0

Jan 9, 2026

v0.1.0

Nov 26, 2025

v0.0.1

Nov 6, 2025

Changes in this version

+ var ErrAddressInvalid = errors.New("invalid Ethereum address format")

+ var ErrAddressZero = errors.New("address is zero address")

+ var ErrChainIDInvalid = errors.New("chainID must be positive")

+ var ErrChainIDNil = errors.New("chainID is nil")

+ var ErrConfigurationInvalid = errors.New("invalid configuration")

+ var ErrCryptoOperationFailed = errors.New("cryptographic operation failed")

+ var ErrEIP712DomainUndefined = errors.New("domain is undefined")

+ var ErrEIP712HashFailed = errors.New("failed to hash EIP-712 data")

+ var ErrEIP712InvalidStructure = errors.New("invalid EIP-712 structure")

+ var ErrEIP712TypeNotFound = errors.New("EIP-712 type not found")

+ var ErrHashFailed = errors.New("hash operation failed")

+ var ErrInvalidEIP191MessagePrefix = errors.New("invalid EIP191 message prefix")

+ var ErrInvalidSignatureLen = errors.New("invalid signature length")

+ var ErrKeystoreCreateFailed = errors.New("failed to create keystore")

+ var ErrKeystoreDecryptFailed = errors.New("keystore decryption failed")

+ var ErrKeystoreDirectoryEmpty = errors.New("keystore directory cannot be empty")

+ var ErrKeystoreExportNotSupported = errors.New("private key export not supported with keystore-based implementation")

+ var ErrKeystoreImportFailed = errors.New("keystore import failed")

+ var ErrKeystoreNoFilesFound = errors.New("no keystore files found in directory")

+ var ErrKeystoreNotFound = errors.New("keystore file not found")

+ var ErrKeystorePathEmpty = errors.New("keystore path cannot be empty")

+ var ErrMemorySafety = errors.New("memory safety violation")

+ var ErrMessageInvalid = errors.New("invalid message format")

+ var ErrNotAuthorized = errors.New("not authorized to perform operation")

+ var ErrParameterInvalid = errors.New("invalid parameter value")

+ var ErrParameterMissing = errors.New("required parameter missing")

+ var ErrPermissionDenied = errors.New("permission denied")

+ var ErrPrivateKeyInvalid = errors.New("invalid private key")

+ var ErrPublicKeyInvalid = errors.New("invalid public key")

+ var ErrSecurityViolation = errors.New("security violation detected")

+ var ErrSignatureRecoveryFailed = errors.New("signature recovery failed")

+ var ErrSignatureValidationFailed = errors.New("signature validation failed")

+ var ErrSignerAddressMismatch = errors.New("address mismatch in signer")

+ var ErrSignerInvalidType = errors.New("invalid signer type")

+ var ErrSignerNotFound = errors.New("signer not found")

+ var ErrSignerNotImplemented = errors.New("signer does not implement required interface")

+ var ErrTimingAttack = errors.New("potential timing attack detected")

+ var ErrTransactionInvalid = errors.New("invalid transaction")

+ var ErrTransactionNil = errors.New("transaction is nil")

+ var ErrTransactionSignFailed = errors.New("transaction signing failed")

+ var ErrTypedDataInvalid = errors.New("invalid typed data structure")

+ var LightScryptConfig = KeystoreScryptConfig

+ var StandardScryptConfig = KeystoreScryptConfig

+ func ConvertRSV2SigBytes(r [32]byte, s [32]byte, v uint8) []byte

+ func ConvertRSV2SigHex(r [32]byte, s [32]byte, v uint8) string

+ func ConvertSigBytes2RSV(sig []byte) (r [32]byte, s [32]byte, v uint8, err error)

+ func ConvertSigHex2RSV(sigHex string) (r [32]byte, s [32]byte, v uint8, err error)

+ func DenormalizeSignatureV(signature []byte) []byte

+ func DenormalizeV(v uint8) uint8

+ func FormatSignatureHex(r [32]byte, s [32]byte, v uint8) string

+ func GetAddress(signer any) (common.Address, error)

+ func GetAddressWithExactGetter(getter AddressGetter) common.Address

+ func IsAuthorizationError(err error) bool

+ func IsConfigurationError(err error) bool

+ func IsEIP712Error(err error) bool

+ func IsKeystoreError(err error) bool

+ func IsSecurityError(err error) bool

+ func IsSignatureError(err error) bool

+ func IsSignerError(err error) bool

+ func IsTransactionError(err error) bool

+ func IsValidationError(err error) bool

+ func NewBindSignerFn(txSigner any, chainID *big.Int) (bind.SignerFn, error)

+ func NormalizeSignatureV(signature []byte) []byte

+ func NormalizeV(v uint8) uint8

+ func ParseSignatureComponents(sig []byte) (r *big.Int, s *big.Int, v uint8, err error)

+ func PersonalSign(signer any, data string) ([]byte, error)

+ func PersonalSignWithEIP191(signer EIP191Signer, data string) ([]byte, error)

+ func PersonalSignWithExactSigner(signer PersonalSigner, data string) ([]byte, error)

+ func PersonalSignWithHash(signer HashSigner, data string) ([]byte, error)

+ func SecureZeroize(data []byte)

+ func SecureZeroizeString(str *string)

+ func SignEIP191Message(signer any, message string) ([]byte, error)

+ func SignEIP191MessageWithExactSigner(signer EIP191Signer, message string) ([]byte, error)

+ func SignEIP191MessageWithRawMessageSigner(signer RawMessageSigner, message string) ([]byte, error)

+ func SignHash(signer any, hashedData common.Hash) ([]byte, error)

+ func SignHashWithExactSigner(signer HashSigner, hashedData common.Hash) ([]byte, error)

+ func SignHashWithRawMessageSigner(signer RawMessageSigner, hashedData common.Hash) ([]byte, error)

+ func SignRawMessage(signer any, raw []byte) ([]byte, error)

+ func SignRawMessageWithHashSigner(signer HashSigner, raw []byte) ([]byte, error)

+ func SignTransaction(signer any, tx *types.Transaction, chainID *big.Int) (*types.Transaction, error)

+ func SignTransactionWithExactSigner(signer TransactionSigner, tx *types.Transaction, chainID *big.Int) (*types.Transaction, error)

+ func SignTransactionWithHashSigner(signer HashSigner, tx *types.Transaction, chainID *big.Int) (*types.Transaction, error)

+ func SignTypedData(signer any, typedData eip712.TypedData) ([]byte, error)

+ func SignTypedDataWithEIP191(signer EIP191Signer, typedData eip712.TypedData) ([]byte, error)

+ func SignTypedDataWithExactSigner(signer TypedDataSigner, typedData eip712.TypedData) ([]byte, error)

+ func SignTypedDataWithHash(signer HashSigner, typedData eip712.TypedData) ([]byte, error)

+ func StructToRSV(rsv RSV) (r [32]byte, s [32]byte, v uint8)

+ func ValidateAddress(address common.Address) error

+ func ValidateChainID(chainID *big.Int) error

+ func ValidateEIP191Message(message []byte) error

+ func ValidateSignature(signer common.Address, hashedData common.Hash, signature []byte) (bool, error)

+ func ValidateSignatureLength(signature []byte) error

+ type AddressGetter interface

+ GetAddress func() common.Address

+ type EIP191Signer interface

+ SignEIP191Message func(message string) ([]byte, error)

+ type ErrorType int

+ const ErrorTypeAuthorization

+ const ErrorTypeConfiguration

+ const ErrorTypeCryptographic

+ const ErrorTypeEIP712

+ const ErrorTypeKeystore

+ const ErrorTypeSecurity

+ const ErrorTypeSignature

+ const ErrorTypeSigner

+ const ErrorTypeTransaction

+ const ErrorTypeValidation

+ type EthPrivateKeySigner struct

+ func NewEthPrivateKeySigner(privateKey *ecdsa.PrivateKey) *EthPrivateKeySigner

+ func NewEthPrivateKeySignerFromPrivateKeyHex(privateKeyHex string) (*EthPrivateKeySigner, error)

+ func (s *EthPrivateKeySigner) GetAddress() common.Address

+ func (s *EthPrivateKeySigner) PersonalSign(data string) ([]byte, error)

+ func (s *EthPrivateKeySigner) SignEIP191Message(message string) ([]byte, error)

+ func (s *EthPrivateKeySigner) SignHash(hashedData common.Hash) ([]byte, error)

+ func (s *EthPrivateKeySigner) SignRawMessage(raw []byte) ([]byte, error)

+ func (s *EthPrivateKeySigner) SignTransactionWithChainID(tx *types.Transaction, chainID *big.Int) (*types.Transaction, error)

+ func (s *EthPrivateKeySigner) SignTypedData(typedData eip712.TypedData) ([]byte, error)

+ type HashSigner interface

+ SignHash func(hashedData common.Hash) ([]byte, error)

+ type KeystoreScryptConfig struct

+ N int

+ P int

+ type KeystoreSigner struct

+ func NewKeystoreSigner(ks *keystore.KeyStore, address common.Address, password string) (*KeystoreSigner, error)

+ func NewKeystoreSignerFromDirectory(keystoreDir string, address common.Address, password string, ...) (*KeystoreSigner, error)

+ func NewKeystoreSignerFromFile(keystoreFile string, address common.Address, password string, ...) (*KeystoreSigner, error)

+ func NewKeystoreSignerFromPath(keystorePath string, address common.Address, password string, ...) (*KeystoreSigner, error)

+ func (s *KeystoreSigner) Close()

+ func (s *KeystoreSigner) GetAddress() common.Address

+ func (s *KeystoreSigner) PersonalSign(data string) ([]byte, error)

+ func (s *KeystoreSigner) SignEIP191Message(message string) ([]byte, error)

+ func (s *KeystoreSigner) SignHash(hashedData common.Hash) ([]byte, error)

+ func (s *KeystoreSigner) SignRawMessage(raw []byte) ([]byte, error)

+ func (s *KeystoreSigner) SignTransactionWithChainID(tx *types.Transaction, chainID *big.Int) (*types.Transaction, error)

+ func (s *KeystoreSigner) SignTypedData(typedData eip712.TypedData) ([]byte, error)

+ type PersonalSigner interface

+ PersonalSign func(data string) ([]byte, error)

+ type RSV struct

+ R [32]byte

+ S [32]byte

+ V uint8

+ func RSVToStruct(r [32]byte, s [32]byte, v uint8) RSV

+ type RawMessageSigner interface

+ SignRawMessage func(raw []byte) ([]byte, error)

+ type SecureBytes struct

+ func NewSecureBytes(data []byte) *SecureBytes

+ func NewSecureBytesFromString(data string) *SecureBytes

+ func (sb *SecureBytes) Bytes() []byte

+ func (sb *SecureBytes) ConstantTimeCompare(other *SecureBytes) bool

+ func (sb *SecureBytes) IsZeroized() bool

+ func (sb *SecureBytes) Len() int

+ func (sb *SecureBytes) String() string

+ func (sb *SecureBytes) Zeroize()

+ type Signer struct

+ func NewSigner(signer any) *Signer

+ func (s *Signer) Close() error

+ func (s *Signer) GetAddress() common.Address

+ func (s *Signer) PersonalSign(data string) ([]byte, error)

+ func (s *Signer) SafeGetAddress() (common.Address, error)

+ func (s *Signer) SignEIP191Message(message string) ([]byte, error)

+ func (s *Signer) SignHash(hashedData common.Hash) ([]byte, error)

+ func (s *Signer) SignRawMessage(raw []byte) ([]byte, error)

+ func (s *Signer) SignTransactionWithChainID(tx *types.Transaction, chainID *big.Int) (*types.Transaction, error)

+ func (s *Signer) SignTypedData(typedData eip712.TypedData) ([]byte, error)

+ type TransactionSigner interface

+ SignTransactionWithChainID func(tx *types.Transaction, chainID *big.Int) (*types.Transaction, error)

+ type TypedDataSigner interface

+ SignTypedData func(typedData eip712.TypedData) ([]byte, error)

+ type TypedError struct

+ Cause error

+ Message string

+ Type ErrorType

+ func NewAuthorizationError(message string, cause error) *TypedError

+ func NewConfigurationError(message string, cause error) *TypedError

+ func NewEIP712Error(message string, cause error) *TypedError

+ func NewKeystoreError(message string, cause error) *TypedError

+ func NewSecurityError(message string, cause error) *TypedError

+ func NewSignatureError(message string, cause error) *TypedError

+ func NewSignerError(message string, cause error) *TypedError

+ func NewTransactionError(message string, cause error) *TypedError

+ func NewTypedError(errorType ErrorType, message string, cause error) *TypedError

+ func NewValidationError(message string, cause error) *TypedError

+ func (e *TypedError) Error() string

+ func (e *TypedError) Unwrap() error

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL