types

type BlobItem ¶ added in v0.19.0

type BlobItem interface {
	Key() []byte
	ValueCopy(dst []byte) ([]byte, error)
}

BlobItem represents a value returned by an iterator

type BlobIterator ¶ added in v0.19.0

type BlobIterator interface {
	Rewind()
	Seek(prefix []byte)
	Valid() bool
	ValidForPrefix(prefix []byte) bool
	Next()
	Item() BlobItem
	Close()
	Err() error
}

BlobIterator provides key iteration over the blob store.

Important lifecycle constraint: items returned by `Item()` must only be accessed while the underlying transaction used to create the iterator is still active. Implementations may validate transaction state at access time (for example `ValueCopy` may fail if the transaction has been committed or rolled back). Typical usage iterates and accesses item values within the same transaction scope.

type BlobIteratorOptions ¶ added in v0.19.0

type BlobIteratorOptions struct {
	Prefix  []byte
	Reverse bool
}

BlobIteratorOptions configures blob iterator creation

type BlockMetadata ¶ added in v0.20.0

type BlockMetadata struct {
	cbor.StructAsArray
	ID       uint64
	Type     uint
	Height   uint64
	PrevHash []byte
}

BlockMetadata contains metadata for a block stored in blob. IMPORTANT: Field order must remain [ID, Type, Height, PrevHash] because cbor.StructAsArray encodes/decodes by position. Changing the order would break deserialization of existing stored data.

type BlockTombstonedError ¶ added in v0.39.1

type BlockTombstonedError struct {
	Slot uint64
	Hash []byte
}

BlockTombstonedError is the typed form of ErrBlockTombstoned, returned by blob plugins on every tombstone observation (GetBlock and iterator ValueCopy). It carries the (slot, hash) of the tombstoned block so an archive-proxy wrapper can resolve it without having to parse the blob key — the wrapper extracts it via:

var t *types.BlockTombstonedError
if errors.As(err, &t) { fetchFromArchive(t.Slot, t.Hash) }

func (e *BlockTombstonedError) Error() string

func (e *BlockTombstonedError) Unwrap() error

type NodeSettings ¶ added in v0.31.0

type NodeSettings struct {
	StorageMode string
	Network     string
}

NodeSettings holds immutable node configuration that is persisted on first sync and enforced on every subsequent startup.

type Rat ¶

type Rat struct {
	*big.Rat
}

func (r *Rat) Scan(val any) error

func (r Rat) Value() (driver.Value, error)

type SignedURL ¶ added in v0.22.0

type SignedURL struct {
	URL     url.URL
	Expires time.Time
}

SignedURL is a url that has been pre-signed and has an expiration time

type Txn ¶ added in v0.19.0

type Txn interface {
	Commit() error
	Rollback() error
}

Txn is a simple transaction handle for commit/rollback only. Database layer (Txn) coordinates metadata and blob operations separately.

type Uint64 ¶

type Uint64 uint64

func (u *Uint64) Scan(val any) error

func (u Uint64) Value() (driver.Value, error)

type UtxoKey ¶ added in v0.37.0

type UtxoKey struct {
	TxId      []byte
	OutputIdx uint32
}

UtxoKey identifies a UTxO row by its transaction id and output index. Used as a parameter type for batch UTxO operations across the metadata-store interface (e.g. MarkUtxosDeletedAtSlot). The fixed-size UtxoRef in database/cbor_cache.go is for in-memory map keys; this variable-length form matches the byte slices stored on the UTxO row directly.