primitives

type AnyOperator ¶ added in v0.5.0

type AnyOperator []any

AnyOperator - represents SQL's `ANY (array expression)` operator. Useful to replace multiple comparators joined with OR. i.e. allows to replace `field1 >= v1 OR field1 >= v2 OR field1 >= v3` with `field1 >= ANY(v1, v2, v3)`

func Any[T any](slice []T) AnyOperator

type Block ¶

type Block struct {
	Block    string
	Operator ComparisonOperator
}

Block is a primitive of KeyFilter that filters search in comparison to block number.

func (f *Block) Accept(visitor Visitor)

type Comparator ¶

type Comparator struct {
	Name             string
	ValueComparators []ValueComparator
}

Comparator is used to filter over values that belong to key data.

func (f *Comparator) Accept(visitor Visitor)

type ComparisonOperator ¶

type ComparisonOperator int

const (
	Eq ComparisonOperator = iota
	Neq
	Gt
	Lt
	Gte
	Lte
)

func (cmpOp ComparisonOperator) String() string

type Confidence ¶

type Confidence struct {
	ConfidenceLevel
}

Confidence is a primitive of KeyFilter that filters search to results that have a certain level of finalization. Confidence maps to different concepts on different blockchains.

func (f *Confidence) Accept(visitor Visitor)

type ConfidenceLevel ¶

type ConfidenceLevel string

const (
	Finalized   ConfidenceLevel = "finalized"
	Unconfirmed ConfidenceLevel = "unconfirmed"
	Safe        ConfidenceLevel = "safe"
)

func ConfidenceLevelFromString(value string) (ConfidenceLevel, error)

type Primitive ¶

type Primitive interface {
	Accept(visitor Visitor)
}

Primitive is the basic building block for KeyFilter.

type Timestamp ¶

type Timestamp struct {
	Timestamp uint64
	Operator  ComparisonOperator
}

Timestamp is a primitive of KeyFilter that filters search in comparison to timestamp.

func (f *Timestamp) Accept(visitor Visitor)

type TxHash ¶

type TxHash struct {
	TxHash string
}

TxHash is a primitive of KeyFilter that filters search to results that contain txHash.

func (f *TxHash) Accept(visitor Visitor)

type ValueComparator ¶

type ValueComparator struct {
	Value    any
	Operator ComparisonOperator
}

type Visitor ¶

type Visitor interface {
	Comparator(primitive Comparator)
	Block(primitive Block)
	Confidence(primitive Confidence)
	Timestamp(primitive Timestamp)
	TxHash(primitive TxHash)
}

Visitor should have a per chain per db type implementation that converts primitives to db queries.