2019-11-23 17:57:05 +00:00
|
|
|
package types
|
2019-10-09 14:22:53 +00:00
|
|
|
|
2022-03-21 14:18:36 +00:00
|
|
|
import (
|
|
|
|
"github.com/ethereum/go-ethereum/common/hexutil"
|
|
|
|
)
|
|
|
|
|
2019-10-09 14:22:53 +00:00
|
|
|
const (
|
|
|
|
// TopicLength is the expected length of the topic, in bytes
|
2019-10-28 13:50:33 +00:00
|
|
|
TopicLength = 4
|
|
|
|
// BloomFilterSize is the expected length of a bloom filter byte array, in bytes
|
|
|
|
BloomFilterSize = 64
|
2019-10-09 14:22:53 +00:00
|
|
|
)
|
|
|
|
|
|
|
|
// TopicType represents a cryptographically secure, probabilistic partial
|
|
|
|
// classifications of a message, determined as the first (left) 4 bytes of the
|
|
|
|
// SHA3 hash of some arbitrary data given by the original author of the message.
|
|
|
|
type TopicType [TopicLength]byte
|
|
|
|
|
|
|
|
// BytesToTopic converts from the byte array representation of a topic
|
|
|
|
// into the TopicType type.
|
|
|
|
func BytesToTopic(b []byte) (t TopicType) {
|
|
|
|
sz := TopicLength
|
|
|
|
if x := len(b); x < TopicLength {
|
|
|
|
sz = x
|
|
|
|
}
|
|
|
|
for i := 0; i < sz; i++ {
|
|
|
|
t[i] = b[i]
|
|
|
|
}
|
|
|
|
return t
|
|
|
|
}
|
|
|
|
|
|
|
|
// String converts a topic byte array to a string representation.
|
2024-08-21 17:45:32 +00:00
|
|
|
func (t TopicType) String() string {
|
2019-11-23 17:57:05 +00:00
|
|
|
return EncodeHex(t[:])
|
2019-10-09 14:22:53 +00:00
|
|
|
}
|
|
|
|
|
2024-11-25 16:32:16 +00:00
|
|
|
func (t TopicType) Bytes() []byte {
|
|
|
|
return TopicTypeToByteArray(t)
|
|
|
|
}
|
|
|
|
|
2019-10-09 14:22:53 +00:00
|
|
|
// MarshalText returns the hex representation of t.
|
|
|
|
func (t TopicType) MarshalText() ([]byte, error) {
|
2019-11-23 17:57:05 +00:00
|
|
|
return HexBytes(t[:]).MarshalText()
|
2019-10-09 14:22:53 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
// UnmarshalText parses a hex representation to a topic.
|
|
|
|
func (t *TopicType) UnmarshalText(input []byte) error {
|
2019-11-23 17:57:05 +00:00
|
|
|
return UnmarshalFixedText("Topic", input, t[:])
|
2019-10-09 14:22:53 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
// TopicToBloom converts the topic (4 bytes) to the bloom filter (64 bytes)
|
|
|
|
func TopicToBloom(topic TopicType) []byte {
|
|
|
|
b := make([]byte, BloomFilterSize)
|
|
|
|
var index [3]int
|
|
|
|
for j := 0; j < 3; j++ {
|
|
|
|
index[j] = int(topic[j])
|
|
|
|
if (topic[3] & (1 << uint(j))) != 0 {
|
|
|
|
index[j] += 256
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
for j := 0; j < 3; j++ {
|
|
|
|
byteIndex := index[j] / 8
|
|
|
|
bitIndex := index[j] % 8
|
|
|
|
b[byteIndex] = (1 << uint(bitIndex))
|
|
|
|
}
|
|
|
|
return b
|
|
|
|
}
|
|
|
|
|
2019-10-28 13:50:33 +00:00
|
|
|
// BloomFilterMatch returns true if a sample matches a bloom filter
|
2019-10-09 14:22:53 +00:00
|
|
|
func BloomFilterMatch(filter, sample []byte) bool {
|
|
|
|
if filter == nil {
|
|
|
|
return true
|
|
|
|
}
|
|
|
|
|
|
|
|
for i := 0; i < BloomFilterSize; i++ {
|
|
|
|
f := filter[i]
|
|
|
|
s := sample[i]
|
|
|
|
if (f | s) != f {
|
|
|
|
return false
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
return true
|
|
|
|
}
|
|
|
|
|
2019-10-28 13:50:33 +00:00
|
|
|
// MakeFullNodeBloom returns a bloom filter which matches all topics
|
2019-10-09 14:22:53 +00:00
|
|
|
func MakeFullNodeBloom() []byte {
|
|
|
|
bloom := make([]byte, BloomFilterSize)
|
|
|
|
for i := 0; i < BloomFilterSize; i++ {
|
|
|
|
bloom[i] = 0xFF
|
|
|
|
}
|
|
|
|
return bloom
|
|
|
|
}
|
2022-03-21 14:18:36 +00:00
|
|
|
|
|
|
|
func StringToTopic(s string) (t TopicType) {
|
|
|
|
str, _ := hexutil.Decode(s)
|
|
|
|
return BytesToTopic(str)
|
|
|
|
}
|
|
|
|
|
|
|
|
func TopicTypeToByteArray(t TopicType) []byte {
|
2022-09-27 22:59:02 +00:00
|
|
|
return t[:4]
|
2022-03-21 14:18:36 +00:00
|
|
|
}
|