Files
next.orly.dev/pkg/bbolt/serial.go
woikos 9fed1261ad Add BBolt database backend for HDD-optimized archival relays (v0.48.0)
- BBolt B+tree backend with sequential access patterns for spinning disks
- Write batching (5000 events / 128MB / 30s flush) to reduce disk thrashing
- Adjacency list storage for graph data (one key per vertex, not per edge)
- Bloom filter for fast negative edge existence checks (~12MB for 10M edges)
- No query cache (saves RAM, B+tree reads are fast enough on HDD)
- Migration tool: orly migrate --from badger --to bbolt
- Configuration: ORLY_BBOLT_* environment variables

Files modified:
- app/config/config.go: Added BBolt configuration options
- main.go: Added migrate subcommand and BBolt config wiring
- pkg/database/factory.go: Added BBolt factory registration
- pkg/bbolt/*: New BBolt database backend implementation

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-06 06:50:58 +01:00

170 lines
3.9 KiB
Go

//go:build !(js && wasm)
package bbolt
import (
"encoding/binary"
bolt "go.etcd.io/bbolt"
"lol.mleku.dev/chk"
)
const (
serialCounterKey = "serial_counter"
pubkeySerialCounterKey = "pubkey_serial_counter"
)
// initSerialCounters initializes or loads the serial counters from _meta bucket
func (b *B) initSerialCounters() error {
return b.db.Update(func(tx *bolt.Tx) error {
bucket := tx.Bucket(bucketMeta)
if bucket == nil {
return nil
}
// Load event serial counter
val := bucket.Get([]byte(serialCounterKey))
if val == nil {
b.nextSerial = 1
buf := make([]byte, 8)
binary.BigEndian.PutUint64(buf, 1)
if err := bucket.Put([]byte(serialCounterKey), buf); err != nil {
return err
}
} else {
b.nextSerial = binary.BigEndian.Uint64(val)
}
// Load pubkey serial counter
val = bucket.Get([]byte(pubkeySerialCounterKey))
if val == nil {
b.nextPubkeySeq = 1
buf := make([]byte, 8)
binary.BigEndian.PutUint64(buf, 1)
if err := bucket.Put([]byte(pubkeySerialCounterKey), buf); err != nil {
return err
}
} else {
b.nextPubkeySeq = binary.BigEndian.Uint64(val)
}
return nil
})
}
// persistSerialCounters saves the current serial counters to disk
func (b *B) persistSerialCounters() error {
b.serialMu.Lock()
eventSerial := b.nextSerial
pubkeySerial := b.nextPubkeySeq
b.serialMu.Unlock()
return b.db.Update(func(tx *bolt.Tx) error {
bucket := tx.Bucket(bucketMeta)
if bucket == nil {
return nil
}
buf := make([]byte, 8)
binary.BigEndian.PutUint64(buf, eventSerial)
if err := bucket.Put([]byte(serialCounterKey), buf); chk.E(err) {
return err
}
binary.BigEndian.PutUint64(buf, pubkeySerial)
if err := bucket.Put([]byte(pubkeySerialCounterKey), buf); chk.E(err) {
return err
}
return nil
})
}
// getNextEventSerial returns the next event serial number (thread-safe)
func (b *B) getNextEventSerial() uint64 {
b.serialMu.Lock()
defer b.serialMu.Unlock()
serial := b.nextSerial
b.nextSerial++
// Persist every 1000 to reduce disk writes
if b.nextSerial%1000 == 0 {
go func() {
if err := b.persistSerialCounters(); chk.E(err) {
b.Logger.Warningf("bbolt: failed to persist serial counters: %v", err)
}
}()
}
return serial
}
// getNextPubkeySerial returns the next pubkey serial number (thread-safe)
func (b *B) getNextPubkeySerial() uint64 {
b.serialMu.Lock()
defer b.serialMu.Unlock()
serial := b.nextPubkeySeq
b.nextPubkeySeq++
// Persist every 1000 to reduce disk writes
if b.nextPubkeySeq%1000 == 0 {
go func() {
if err := b.persistSerialCounters(); chk.E(err) {
b.Logger.Warningf("bbolt: failed to persist serial counters: %v", err)
}
}()
}
return serial
}
// getOrCreatePubkeySerial gets or creates a serial for a pubkey
func (b *B) getOrCreatePubkeySerial(tx *bolt.Tx, pubkey []byte) (uint64, error) {
pksBucket := tx.Bucket(bucketPks)
spkBucket := tx.Bucket(bucketSpk)
if pksBucket == nil || spkBucket == nil {
return 0, nil
}
// Check if pubkey already has a serial
pubkeyHash := hashPubkey(pubkey)
val := pksBucket.Get(pubkeyHash)
if val != nil {
return decodeUint40(val), nil
}
// Create new serial
serial := b.getNextPubkeySerial()
serialKey := makeSerialKey(serial)
// Store pubkey_hash -> serial
serialBuf := make([]byte, 5)
encodeUint40(serial, serialBuf)
if err := pksBucket.Put(pubkeyHash, serialBuf); err != nil {
return 0, err
}
// Store serial -> full pubkey
fullPubkey := make([]byte, 32)
copy(fullPubkey, pubkey)
if err := spkBucket.Put(serialKey, fullPubkey); err != nil {
return 0, err
}
return serial, nil
}
// getPubkeyBySerial retrieves the full 32-byte pubkey from a serial
func (b *B) getPubkeyBySerial(tx *bolt.Tx, serial uint64) ([]byte, error) {
spkBucket := tx.Bucket(bucketSpk)
if spkBucket == nil {
return nil, nil
}
serialKey := makeSerialKey(serial)
return spkBucket.Get(serialKey), nil
}