Documentation
¶
Overview ¶
Package hash provides time-based hashing utilities with optional encryption support. It implements a custom encoding scheme that embeds timestamp information along with data, allowing for data integrity verification and timestamp extraction.
Index ¶
- Variables
- func CryptoTimeHash(data []byte, timestamp int64, key []byte) string
- func DataOfCryptoTimeHash(encoded string, key []byte) []byte
- func DataOfTimeHash(encoded string) []byte
- func FindDataOfTimeHash(encoded string, key []byte) []byte
- func TimeHash(data []byte, timestamp int64) string
- func TimestampOfTimeHash(encoded string) int64
- func ValidateTimeHash(encoded string) bool
Constants ¶
This section is empty.
Variables ¶
var CryptoTimeHashPadding = byte(0x59)
CryptoTimeHashPadding is the padding byte used in encrypted time hash operations. This value is used for both padding data and as part of the integrity check.
var CryptoTimeHashXBit = byte(0x53)
CryptoTimeHashXBit is the XOR bit used for checksum calculations in time hashes. This value helps ensure data integrity during encoding and decoding operations.
var TimeHashBase = []byte{75, 79, 78, 83, 73, 84, 69, 89}
TimeHashBase is the base key used for XOR operations in the time hash algorithm. This constant provides a fixed seed for consistent encoding/decoding operations.
Functions ¶
func CryptoTimeHash ¶
CryptoTimeHash encodes data with an embedded timestamp using AES encryption. This function provides enhanced security by encrypting the data before applying the time hash algorithm, making it suitable for sensitive information.
Parameters:
- data: The byte slice to be encoded and encrypted (cannot be nil or empty)
- timestamp: Unix timestamp in seconds (must be greater than 0)
- key: Encryption key (cannot be nil or empty, will be SHA256 hashed to 32-byte key)
Returns:
- A base62-encoded string containing the encrypted and hashed data with embedded timestamp
- Empty string if input validation fails or encryption fails
The encoding process:
- Validates all input parameters
- Encrypts the data using AES-256-CBC with the provided key
- Applies the TimeHash algorithm to the encrypted data
- Returns the base62-encoded result
Security features:
- AES-256-CBC encryption with random IV
- SHA256 key derivation for consistent 32-byte keys
- Integrity validation through checksums
func DataOfCryptoTimeHash ¶
func DataOfTimeHash ¶
func FindDataOfTimeHash ¶
func TimeHash ¶
TimeHash encodes data with an embedded timestamp using a custom algorithm. The function combines the data with the timestamp and applies XOR operations with padding and checksum validation to create a secure, time-stamped hash.
Parameters:
- data: The byte slice to be encoded (cannot be nil or empty)
- timestamp: Unix timestamp in seconds (must be greater than 0)
Returns:
- A base62-encoded string containing the hashed data with embedded timestamp
- Empty string if input validation fails
The encoding process:
- Validates input parameters
- Applies padding to align data to 8-byte boundaries
- XORs data segments with timestamp-derived keys
- Adds integrity checksums
- Encodes result using base62 encoding
func TimestampOfTimeHash ¶
func ValidateTimeHash ¶
Types ¶
This section is empty.
Source Files