Skip to main content

Config Settings

Table Metadata​

PropertyConfiguration
Natural Key(s)config_setting_id, closed_at
Partition Field(s)closed_at (MONTH partition)
Clustered Field(s)last_modified_ledger
Documentationdbt docs

Column Details​

NameDescriptionData TypeDomain ValuesRequired?Notes
config_setting_idConfig setting id typesintegerYes
contract_max_size_bytesMax size of contractintegerNo
ledger_max_instructionsMax instructions per ledgerintegerNo
tx_max_instructionsMax instructions per transactionintegerNo
fee_rate_per_instructions_incrementFee for instructions incrementintegerNo
tx_memory_limitTransaction memory limitintegerNo
ledger_max_read_ledger_entriesMax read ledger entries per ledgerintegerNo
ledger_max_read_bytesMax read bytes per ledgerintegerNo
ledger_max_write_ledger_entriesMax write ledger entries per ledgerintegerNo
ledger_max_write_bytesMax write bytes per ledgerintegerNo
tx_max_read_ledger_entriesMax read ledger entries per transactionintegerNo
tx_max_read_bytesMax read bytes per transactionintegerNo
tx_max_write_ledger_entriesMax write ledger entries per transactionintegerNo
tx_max_write_bytesMax write bytes per transactionintegerNo
fee_read_ledger_entryFee for read ledger entryintegerNo
fee_write_ledger_entryFee for write ledger entryintegerNo
fee_read_1kbFee per 1kb readintegerNo
bucket_list_target_size_bytesBucket list target sizeintegerNo
write_fee_1kb_bucket_list_lowWrite fee for bucket list per 1kbintegerNo
write_fee_1kb_bucket_list_highWrite fee for bucket list per 1kbintegerNo
bucket_list_write_fee_growth_factorWrite growth fee for bucket listintegerNo
fee_historical_1kbFee for historical storage per 1kbintegerNo
tx_max_contract_events_size_bytesMax transaction contract event sizeintegerNo
fee_contract_events_1kbFee for contract event size per 1kbintegerNo
ledger_max_txs_size_bytesMax ledger transaction sizeintegerNo
tx_max_size_bytesMax transaction sizeintegerNo
fee_tx_size_1kbFee for transaction size per 1kbintegerNo
contract_cost_params_cpu_insnsConstant and linear model parameters for cost parameters for CPUarray[record]No
contract_cost_params_mem_bytesConstant and linear model parameters for cost parameters for memoryarray[record]No
contract_data_key_size_bytesMax size of contract data keysintegerNo
contract_data_entry_size_bytesMax size of contract data entriesintegerNo
max_entry_ttlMax TTL that can be set for an entry (sequence created at + this)integerNo
auto_bump_ledgersAutomatic bump ledgers amountintegerNo
persistent_rent_rate_denominatorPersistent entry rent rate denominatorintegerNo
temp_rent_rate_denominatorTemporary entry rent rate denominatorintegerNo
bucket_list_size_window_sample_sizeBucket list size window sample sizeintegerNo
eviction_scan_sizeEviction scan sizeintegerNo
starting_eviction_scan_levelStarting eviction scan levelintegerNo
ledger_max_tx_countMax transactions in a ledgerintegerNo
bucket_list_size_windowBucket list size windowarray[integer]No
min_temporary_ttlThe minimum number of entries for which a temporary entry can live on the ledgerintegerNo
min_persistent_ttlThe minimum number of entries for which a persisted entry can live on the ledgerintegerNo
max_entries_to_archiveMaximum number of entries that emit archival meta in a single ledgerintegerNo
last_modified_ledgerThe ledger sequence number when the ledger entry (this unique signer for the account) was modified. Deletions do not count as a modification and will report the prior modification sequence numberintegerYes
ledger_entry_changeCode that describes the ledger entry change type that was applied to the ledger entry.integerYes
deletedIndicates whether the ledger entry (balance id) has been deleted or not. Once an entry is deleted, it cannot be recovered.booleanYes
batch_idString representation of the run id for a given DAG in Airflow. Takes the form of scheduled__<batch_end_date>-<dag_alias>. Batch ids are unique to the batch and help with monitoring and rerun capabilitiesstringYes
batch_run_dateThe start date for the batch interval. When taken with the date in the batch_id, the date represents the interval of ledgers processed. The batch run date can be seen as a proxy of closed_at for a ledger.datetimeYes
batch_insert_tsThe timestamp in UTC when a batch of records was inserted into the database. This field can help identify if a batch executed in real time or as part of a backfilltimestampYes
closed_atTimestamp in UTC when this ledger closed and committed to the network. Ledgers are expected to close ~every 5 secondstimestampYes
ledger_sequenceThe sequence number of this ledger. It represents the order of the ledger within the Stellar blockchain. Each ledger has a unique sequence number that increments with every new ledger, ensuring that ledgers are processed in the correct order.integerYes
ledger_max_disk_read_entriesMaximum number of ledger entries a single ledger may read from disk.integerNoProtocol 23 (CAP-66) successor to ledger_max_read_ledger_entries, which now covers in-memory state only.
ledger_max_disk_read_bytesMaximum number of bytes a single ledger may read from disk.integerNoProtocol 23 (CAP-66) successor to ledger_max_read_bytes.
tx_max_disk_read_entriesMaximum number of ledger entries a single transaction may read from disk.integerNoProtocol 23 (CAP-66) successor to tx_max_read_ledger_entries.
tx_max_disk_read_bytesMaximum number of bytes a single transaction may read from disk.integerNoProtocol 23 (CAP-66) successor to tx_max_read_bytes.
fee_disk_read_ledger_entryFee in stroops charged per ledger entry read from disk.integerNoProtocol 23 (CAP-66) successor to fee_read_ledger_entry.
fee_disk_read_1kbFee in stroops charged per 1KB read from disk.integerNoProtocol 23 (CAP-66) successor to fee_read_1kb.
fee_write_1kbFee in stroops charged per 1KB written to the live Soroban state.integerNoProtocol 23 (CAP-62) rename of the bucket-list write fee.
soroban_state_target_size_bytesTarget size in bytes of the live Soroban state, used as the inflection point for rent fee growth.integerNoProtocol 23 (CAP-62) successor to bucket_list_target_size_bytes.
rent_fee_1kb_soroban_state_size_lowRent fee in stroops per 1KB when the live Soroban state is below the target size.integerNoProtocol 23 (CAP-62) successor to write_fee_1kb_bucket_list_low.
rent_fee_1kb_soroban_state_size_highRent fee in stroops per 1KB when the live Soroban state is above the target size.integerNoProtocol 23 (CAP-62) successor to write_fee_1kb_bucket_list_high.
soroban_state_rent_fee_growth_factorMultiplier applied to the rent fee once the live Soroban state exceeds the target size.integerNoProtocol 23 (CAP-62) successor to bucket_list_write_fee_growth_factor.
live_soroban_state_size_window_sample_sizeNumber of samples retained in the sliding window used to average the live Soroban state size.integerNoProtocol 23 (CAP-62) successor to bucket_list_size_window_sample_size.
live_soroban_state_size_window_sample_periodNumber of ledgers between samples of the live Soroban state size.integerNo
live_soroban_state_size_windowThe sliding window of sampled live Soroban state sizes used to compute rent fees.array[integer]NoProtocol 23 (CAP-62) successor to bucket_list_size_window. Repeated field.
ledger_max_dependent_tx_clustersMaximum number of dependent transaction clusters per ledger.integerNoProtocol 23 (CAP-63) parallelism-friendly transaction scheduling setting.
tx_max_footprint_entriesMaximum number of footprint entries per transaction.integerNoProtocol 23 ledger cost extension.
ledger_target_close_time_millisecondsTarget ledger close time in milliseconds.integerNoProtocol 23 SCP timing setting.
nomination_timeout_initial_millisecondsInitial SCP nomination timeout in milliseconds.integerNoProtocol 23 SCP timing setting.
nomination_timeout_increment_millisecondsSCP nomination timeout increment in milliseconds.integerNoProtocol 23 SCP timing setting.
ballot_timeout_initial_millisecondsInitial SCP ballot timeout in milliseconds.integerNoProtocol 23 SCP timing setting.
ballot_timeout_increment_millisecondsSCP ballot timeout increment in milliseconds.integerNoProtocol 23 SCP timing setting.
frozen_ledger_keysArray of base64-encoded ledger keys frozen by validator governance.array[string]NoProtocol 26 (CAP-77). Repeated field.
frozen_ledger_keys_to_freezeArray of base64-encoded ledger keys to freeze in this delta update.array[string]NoProtocol 26 (CAP-77). Repeated field.
frozen_ledger_keys_to_unfreezeArray of base64-encoded ledger keys to unfreeze in this delta update.array[string]NoProtocol 26 (CAP-77). Repeated field.
freeze_bypass_txsArray of hex-encoded transaction hashes that bypass frozen key restrictions.array[string]NoProtocol 26 (CAP-77). Repeated field.
freeze_bypass_txs_to_addArray of hex-encoded transaction hashes to add to the freeze bypass list.array[string]NoProtocol 26 (CAP-77). Repeated field.
freeze_bypass_txs_to_removeArray of hex-encoded transaction hashes to remove from the freeze bypass list.array[string]NoProtocol 26 (CAP-77). Repeated field.