Policy settings control BSV Blockchain consensus rules and transaction validation behavior in Teranode. These settings determine what transactions and blocks are considered valid on the BSV Blockchain according to the Bitcoin Protocol.
Configuration Settings
Block Size Limits
Setting
Type
Default
Environment Variable
Usage
BlockMaxSize
int
0 (unlimited)
blockmaxsize
CRITICAL - Maximum block size policy limit
ExcessiveBlockSize
int
4294967296 (4GB)
excessiveblocksize
Excessive block size threshold
Transaction Size and Script Limits
Setting
Type
Default
Environment Variable
Usage
MaxTxSizePolicy
int
10485760 (10MB)
maxtxsizepolicy
CRITICAL - Maximum transaction size policy
MaxOrphanTxSize
int
0 (not wired up; the getInt call is commented out in settings.go)
maxorphantxsize
Maximum orphan transaction size
MaxScriptSizePolicy
int
100000000 (100MB)
maxscriptsizepolicy
CRITICAL - Maximum script size policy
MaxScriptNumLengthPolicy
int
10000
maxscriptnumlengthpolicy
Maximum script number length
MaxOpsPerScriptPolicy
int64
1000000
maxopsperscriptpolicy
Maximum operations per script
Multisig and Signature Limits
Setting
Type
Default
Environment Variable
Usage
MaxPubKeysPerMultisigPolicy
int64
0 (unlimited)
maxpubkeyspermultisigpolicy
Maximum public keys per multisig
MaxTxSigopsCountsPolicy
int64
0 (unlimited)
maxtxsigopscountspolicy
Maximum signature operations per transaction
Memory and Stack Limits
Setting
Type
Default
Environment Variable
Usage
MaxStackMemoryUsagePolicy
int
104857600 (100MB)
maxstackmemoryusagepolicy
CRITICAL - Maximum stack memory usage (policy)
MaxStackMemoryUsageConsensus
int
0 (unlimited)
maxstackmemoryusageconsensus
CRITICAL - Maximum stack memory usage (consensus)
Validation Timeout Settings
Setting
Type
Default
Environment Variable
Usage
MaxStdTxValidationDuration
int
0 (not wired up; the getInt call is commented out in settings.go)
maxstdtxvalidationduration
Maximum validation time for standard transactions (ms)
MaxNonStdTxValidationDuration
int
1000
maxnonstdtxvalidationduration
Bounds the consensus re-run of a transaction that failed a policy script limit (ms); a re-run that does not finish is reported as TxPolicy. 0 means no bound
MaxTxChainValidationBudget
int
0 (not wired up; the getInt call is commented out in settings.go)
maxtxchainvalidationbudget
Total time budget for chain validation (ms)
ValidationClockCPU
bool
false (not wired up; the getBool call is commented out in settings.go)
validationclockcpu
Use CPU time instead of wall-clock for validation timeouts
Data Carrier Settings
Setting
Type
Default
Environment Variable
Usage
DataCarrier
bool
false
datacarrier
Enable relaying of OP_RETURN data carrier transactions
DataCarrierSize
int64
1000000 (1MB)
datacarriersize
Maximum OP_RETURN data size when DataCarrier is enabled
Transaction Chain Limits
Setting
Type
Default
Environment Variable
Usage
LimitAncestorCount
int
0 (not wired up; the getInt call is commented out in settings.go)
limitancestorcount
Maximum unconfirmed ancestor count in mempool
LimitCPFPGroupMembersCount
int
0 (not wired up; the getInt call is commented out in settings.go)
limitcpfpgroupmemberscount
Maximum CPFP group members
Mining and Fee Settings
Setting
Type
Default
Environment Variable
Usage
MinMiningTxFee
float64
0.00000500
minminingtxfee
Minimum transaction fee for mining
AcceptNonStdOutputs
bool
true
acceptnonstdoutputs
CRITICAL - Accept non-standard output scripts
Consolidation Transaction Settings
Setting
Type
Default
Environment Variable
Usage
MinConsolidationFactor
int
20
minconsolidationfactor
Minimum consolidation factor
MaxConsolidationInputScriptSize
int
150
maxconsolidationinputscriptsize
Maximum input script size for consolidation
MinConfConsolidationInput
int
6
minconfconsolidationinput
Minimum confirmations for consolidation input
MinConsolidationInputMaturity
int
6
minconsolidationinputmaturity
Minimum input maturity for consolidation
AcceptNonStdConsolidationInput
bool
false
acceptnonstdconsolidationinput
Accept non-standard consolidation inputs
Configuration Dependencies
Block Size Policy
BlockMaxSize = 0 means unlimited block size (default behavior for BSV)
ExcessiveBlockSize defines the threshold for considering blocks “excessive”
Both settings work together to enforce BSV Blockchain’s unbounded block size philosophy
Script Validation
MaxScriptSizePolicy controls script size limits during validation
MaxScriptNumLengthPolicy limits the length of script numbers
MaxStackMemoryUsagePolicy vs MaxStackMemoryUsageConsensus:
Policy: Enforced during transaction validation
Consensus: Enforced during block validation
Setting consensus to 0 (unlimited) aligns with BSV’s restored protocol
Multisig and Signature Operations
MaxPubKeysPerMultisigPolicy = 0 means unlimited public keys (BSV default)
MaxTxSigopsCountsPolicy = 0 means unlimited signature operations (BSV default)
These unlimited defaults reflect BSV Blockchain’s restoration of original Bitcoin capabilities
Non-Standard Transactions
AcceptNonStdOutputs = true enables acceptance of non-standard output scripts
Required for many BSV applications that use custom script templates
Aligns with BSV’s philosophy of not restricting valid script types