BSV blockchainBSV blockchain

Propagation Service Settings

Related Topic: Propagation Service

Configuration Settings

SettingTypeDefaultEnvironment VariableUsage
IPv6Addressesstring""ipv6_addressesIPv6 multicast addresses for transaction reception
IPv6Interfacestring""ipv6_interfaceNetwork interface for IPv6 multicast (defaults to “en0”)
GRPCMaxConnectionAgetime.Duration90spropagation_grpcMaxConnectionAgeCRITICAL - gRPC connection lifecycle management
HTTPListenAddressstring""propagation_httpListenAddressCRITICAL - HTTP server binding, health checks only run if not empty
HTTPAddresses[]string[]propagation_httpAddressesHTTP client connections
AlwaysUseHTTPboolfalsepropagation_alwaysUseHTTPCRITICAL - Forces HTTP transport over gRPC
HTTPRateLimitint1024propagation_httpRateLimitCRITICAL - HTTP API rate limiting (requests/second)
SendBatchSizeint100propagation_sendBatchSizeBatch processing configuration
SendBatchTimeoutint5propagation_sendBatchTimeoutBatch timeout configuration (milliseconds)
GRPCAddresses[]string[]propagation_grpcAddressesgRPC client connections
GRPCListenAddressstring""propagation_grpcListenAddressCRITICAL - gRPC server binding (service skipped if empty)
IPv6AllowedSources[]string[]propagation_ipv6_allowed_sourcesRestrict UDP sources by IP or CIDR (empty = allow all)
HTTPBodyLimitstring100MBpropagation_httpBodyLimitMaximum HTTP request body size (prevents OOM on oversized requests)

Configuration Dependencies

HTTP Server Management

  • When HTTPListenAddress is not empty, HTTP server starts
  • HTTPRateLimit controls request rate limiting when HTTP server is active

Service Startup

  • Service skipped (not added to ServiceManager) if GRPCListenAddress is empty
  • Service requires gRPC server to be configured for operation

gRPC Server Management

  • When GRPCListenAddress is not empty, gRPC server starts with connection age management
  • GRPCMaxConnectionAge controls connection lifecycle

Transport Selection

  • AlwaysUseHTTP forces HTTP transport over gRPC for transaction operations
  • Affects client-side transport selection in transaction processing

IPv6 Multicast

  • When IPv6Addresses is not empty, starts UDP6 listeners
  • Uses IPv6Interface for network interface selection (defaults to “en0”)

Service Dependencies

DependencyInterfaceUsage
TxStoreblob.StoreCRITICAL - Transaction storage and retrieval
ValidatorClientvalidator.ClientICRITICAL - Transaction validation operations
BlockchainClientblockchain.ClientICRITICAL - Blockchain state verification
ValidatorKafkaProducerkafka.KafkaAsyncProducerICRITICAL - Validator messaging

Validation Rules

SettingValidationImpactWhen Checked
GRPCListenAddressMust not be emptyService skipped if emptyDuring daemon startup
HTTPListenAddressOptional for HTTP serverHTTP server not started if emptyDuring service initialization
IPv6InterfaceDefaults to “en0” if emptyNetwork interface selectionDuring IPv6 listener setup

Configuration Examples

Basic Configuration

propagation_grpcListenAddress = ":8084"
propagation_httpListenAddress = ":8833"

HTTP Rate Limiting

propagation_httpRateLimit = 2048
propagation_alwaysUseHTTP = false

IPv6 Multicast

ipv6_addresses = "ff02::1"
ipv6_interface = "eth0"