UTXO Persister Service Settings
Related Topic: UTXO Persister Service
Configuration Settings
| Setting | Type | Default | Environment Variable | Usage |
|---|---|---|---|---|
| UTXOPersisterBufferSize | string | “256KB” | utxoPersister_buffer_size | CRITICAL - Buffer size for UTXO file I/O operations |
| UTXOPersisterDirect | bool | true | direct | Direct I/O operations control |
Configuration Dependencies
Buffer Management
-
UTXOPersisterBufferSizeis parsed using bytesize.Parse() -
Used for buffered I/O operations when reading/writing UTXO files
-
The default of
256KBapplies to every consumer -
The values below are the fallbacks used only when the configured value fails to parse, and they differ by consumer rather than by direction:
- The file storer’s write buffer falls back to 128KB
- The block persister’s subtree-data read buffer falls back to 128KB
- The utxo-additions, utxo-deletions and previous-utxo-set read buffers fall back to 4096 bytes
I/O Operations
UTXOPersisterDirectcontrols direct I/O behavior- Affects how buffer operations are performed
Service Dependencies
| Dependency | Interface | Usage |
|---|---|---|
| BlockStore | blob.Store | CRITICAL - UTXO set storage and retrieval |
| BlockchainClient | blockchain.ClientI | CRITICAL - Blockchain operations and block notifications |
Validation Rules
| Setting | Validation | Impact | When Checked |
|---|---|---|---|
| UTXOPersisterBufferSize | Must be valid byte size format | I/O performance | During service initialization |
| UTXOPersisterDirect | Controls I/O operation mode | Performance behavior | During service initialization |
Configuration Examples
Basic Configuration
utxoPersister_buffer_size = "256KB"
direct = truePerformance Tuning
utxoPersister_buffer_size = "1MB"
direct = trueMemory Constrained
utxoPersister_buffer_size = "1KB"
direct = falseNode Software › Nodes › Run Teranode › Reference › Configuration › Service Settings