reference.conf

# =============================================================================
# reference.conf — Full default configuration for java-tron
# =============================================================================
#
# This file defines the default value for every configuration parameter.
# It is packaged inside the jar and loaded automatically via Typesafe Config's
# standard mechanism: ConfigFactory.defaultReference().
#
# Loading priority (highest wins):
#   1. User's external config file (e.g. config.conf passed via -c flag)
#   2. This file (reference.conf, bundled in jar)
#
# When a user's config.conf omits a parameter, the value from this file is
# used as the fallback. This ensures the node always has a complete and valid
# configuration, even if the user only overrides a few parameters.
#
# Maintenance rules:
#   - Every parameter that the code reads must have an entry here
#   - Values must match the bean field initializers in the corresponding
#     XxxConfig.java classes (VmConfig, NodeConfig, CommitteeConfig, etc.)
#   - Keep the section order and key order identical to config.conf for
#     easy side-by-side comparison
#   - When adding a new parameter: add it here AND in the bean class
#
# Key naming rules (required for ConfigBeanFactory auto-binding):
#   - Use standard camelCase: maxConnections, syncFetchBatchNum, etc.
#
# Keys that cannot auto-bind (handled manually in bean fromConfig):
#
#   1. committee.pBFTExpireNum — lowercase "p" then uppercase "BFT":
#      setPBFTExpireNum -> property "PBFTExpireNum" (capital P),
#      mismatches config key "pBFTExpireNum" (lowercase p).
#
#   2. node.isOpenFullTcpDisconnect — boolean "is" prefix:
#      getter isOpenFullTcpDisconnect() -> property "openFullTcpDisconnect",
#      mismatches config key "isOpenFullTcpDisconnect".
#
#   3. node.shutdown.BlockTime/BlockHeight/BlockCount — PascalCase keys:
#      setBlockTime -> property "blockTime", mismatches "BlockTime".
#
# =============================================================================

net {
  # type is deprecated and has no effect.
  # type = mainnet
}

storage {
  # Database engine: "LEVELDB" or "ROCKSDB" (ARM only supports ROCKSDB)
  db.engine = "LEVELDB"
  db.sync = false
  db.directory = "database"

  # Index directory (legacy, not consumed by any runtime code, kept for CLI/test compatibility)
  index.directory = "index"
  index.switch = "on"

  # Whether to write transaction result in transactionRetStore
  transHistory.switch = "on"

  # Per-database LevelDB option overrides. Default: empty (all databases use global defaults).
  # setting can improve leveldb performance .... start, deprecated for arm
  # node: if this will increase process fds, you may check your ulimit if 'too many open files' error occurs
  # see https://github.com/tronprotocol/tips/blob/master/tip-343.md for detail
  # if you find block sync has lower performance, you can try this settings
  # default = {
  #   maxOpenFiles = 100
  # }
  # defaultM = {
  #   maxOpenFiles = 500
  # }
  # defaultL = {
  #   maxOpenFiles = 1000
  # }
  # setting can improve leveldb performance .... end, deprecated for arm

  # Example per-database overrides:
  #   {
  #     name = "account",
  #     path = "storage_directory_test",
  #     createIfMissing = true,
  #     paranoidChecks = true,
  #     verifyChecksums = true,
  #     compressionType = 1,        // compressed with snappy
  #     blockSize = 4096,           // 4  KB =         4 * 1024 B
  #     writeBufferSize = 10485760, // 10 MB = 10 * 1024 * 1024 B
  #     cacheSize = 10485760,       // 10 MB = 10 * 1024 * 1024 B
  #     maxOpenFiles = 100
  #   }
  properties = []

  needToUpdateAsset = true

  # RocksDB settings (only used when db.engine = "ROCKSDB")
  # Strongly recommend NOT modifying unless you know every item's meaning clearly.
  dbSettings = {
    levelNumber = 7
    compactThreads = 0          // 0 = auto: max(availableProcessors, 1)
    blocksize = 16              // n * KB
    maxBytesForLevelBase = 256  // n * MB
    maxBytesForLevelMultiplier = 10
    level0FileNumCompactionTrigger = 2
    targetFileSizeBase = 64     // n * MB
    targetFileSizeMultiplier = 1
    maxOpenFiles = 5000
  }

  balance.history.lookup = false

  # Checkpoint version for snapshot mechanism. Version 2 enables V2 snapshot.
  checkpoint.version = 1
  checkpoint.sync = true

  # Estimated number of block transactions (default 1000, min 100, max 10000).
  # Total cached transactions = 65536 * txCache.estimatedTransactions
  txCache.estimatedTransactions = 1000
  # If true, transaction cache initialization will be faster.
  txCache.initOptimization = false

  # Number of blocks flushed to db in each batch during node syncing.
  snapshot.maxFlushCount = 1

  # Database backup settings (RocksDB only)
  backup = {
    enable = false
    propPath = "prop.properties"
    bak1path = "bak1/database/"
    bak2path = "bak2/database/"
    frequency = 10000
  }

  # Data root setting, for check data, currently only reward-vi is used.
  # merkleRoot = {
  #   reward-vi = 9debcb9924055500aaae98cdee10501c5c39d4daa75800a996f4bdda73dbccd8 // main-net
  # }
}

node.discovery = {
  enable = false
  persist = false
  external.ip = ""
}

# Custom stop condition
# node.shutdown = {
#   BlockTime  = "54 59 08 * * ?"   # if block header time in persistent db matched
#   BlockHeight = 33350800           # if block header height in persistent db matched
#   BlockCount = 12                  # block sync count after node start
# }

node.backup {
  port = 10001
  priority = 0
  keepAliveInterval = 3000
  members = [
    # "ip",
    # "ip"
  ]
}

# Algorithm for generating public key from private key. Do not modify to avoid forks.
crypto {
  engine = "eckey"
}

# Energy limit block number (config key has typo "enery" preserved for backward compatibility)
enery.limit.block.num = 4727890

# Actuator whitelist — empty means all actuators allowed
actuator {
  whitelist = []
}

node.metrics = {
  prometheus {
    enable = false
    port = 9527
  }

  storageEnable = false

  influxdb {
    ip = ""
    port = 8086
    database = "metrics"
    metricsReportInterval = 10
  }
}

node {
  # Trust node for solidity node (example: "127.0.0.1:50051").
  # Empty string here = "not configured"; Args.java bridge converts "" → null so the
  # runtime behavior matches develop (trustNodeAddr is null unless user sets the key).
  trustNode = ""

  # Expose extension api to public or not
  walletExtensionApi = false

  listen.port = 18888
  connection.timeout = 2
  fetchBlock.timeout = 500

  # Number of blocks to fetch in one batch during sync. Range: [100, 2000].
  syncFetchBatchNum = 2000

  # Number of validate sign threads, default availableProcessors
  # Number of validate sign threads, 0 = auto (availableProcessors)
  validateSignThreadNum = 0

  maxConnections = 30
  minConnections = 8
  minActiveConnections = 3
  maxConnectionsWithSameIp = 2
  maxHttpConnectNumber = 50
  minParticipationRate = 0

  # Whether to enable shielded transaction API
  allowShieldedTransactionApi = false

  # Whether to print config log at startup
  openPrintLog = true

  # If true, SR packs transactions into a block in descending order of fee;
  # otherwise, packs by receive timestamp.
  openTransactionSort = false

  # Threshold for broadcast transactions received from each peer per second,
  # transactions exceeding this are discarded
  maxTps = 1000
  # Max block inv hashes accepted per peer per second. Minimum: 1.
  maxBlockInvPerSecond = 10

  isOpenFullTcpDisconnect = false
  inactiveThreshold = 600       // seconds
  tcpNettyWorkThreadNum = 0
  udpNettyWorkThreadNum = 1
  maxFastForwardNum = 4
  activeConnectFactor = 0.1
  connectFactor = 0.6
  # Legacy alias `maxActiveNodesWithSameIp` is still accepted from user config
  # (see NodeConfig alias-fallback) but is intentionally NOT defaulted here —
  # shipping it in reference.conf would always mask the modern `maxConnectionsWithSameIp`.
  channel.read.timeout = 0
  metricsEnable = false

  p2p {
    version = 11111   # Mainnet:11111; Nile:201910292; Shasta:1
  }

  active = [
    # Active establish connection in any case
    # "ip:port",
    # "ip:port"
  ]

  passive = [
    # Passive accept connection in any case
    # "ip:port",
    # "ip:port"
  ]

  fastForward = [
    "100.27.171.62:18888",
    "15.188.6.125:18888"
  ]

  http {
    fullNodeEnable = true
    fullNodePort = 8090
    solidityEnable = true
    solidityPort = 8091
    PBFTEnable = true
    PBFTPort = 8092
  }

  rpc {
    enable = true
    port = 50051
    solidityEnable = true
    solidityPort = 50061
    PBFTEnable = true
    PBFTPort = 50071

    # Number of gRPC threads, 0 = auto (availableProcessors / 2)
    thread = 0

    # Maximum concurrent calls per incoming connection
    # No limit on concurrent calls per connection
    maxConcurrentCallsPerConnection = 2147483647

    # HTTP/2 flow control window (bytes), default 1MB
    flowControlWindow = 1048576

    # Connection idle timeout (ms). No limit by default.
    maxConnectionIdleInMillis = 9223372036854775807

    # Connection max age (ms). No limit by default.
    maxConnectionAgeInMillis = 9223372036854775807

    # Maximum message size (bytes), default 4MB
    maxMessageSize = 4194304

    # Maximum header list size (bytes), default 8192
    maxHeaderListSize = 8192

    # RST_STREAM frames allowed per connection per period, 0 = no limit
    maxRstStream = 0

    # Seconds per period for gRPC RST_STREAM limit
    secondsPerWindow = 0

    # Minimum effective connections required to broadcast transactions
    minEffectiveConnection = 1

    # Reflection service switch for grpcurl tool
    reflectionService = false
    trxCacheEnable = false
  }

  # Number of solidity threads in FullNode.
  # Increase if solidity rpc/http interface timeouts occur.
  # Default: number of cpu cores.
  # Number of solidity threads, 0 = auto (availableProcessors)
  solidity.threads = 0

  # Maximum percentage of producing block interval (provides time for broadcast etc.)
  blockProducedTimeOut = 50

  # Maximum transactions from network layer per second
  netMaxTrxPerSecond = 700

  # Whether to enable node detection function
  nodeDetectEnable = false

  # Use IPv6 address for node discovery and TCP connection
  enableIpv6 = false

  # If node's highest block is below all peers, try to acquire new connection
  effectiveCheckEnable = false

  # Dynamic loading configuration function
  dynamicConfig = {
    enable = false
    checkInterval = 600
  }

  # Block solidification check
  unsolidifiedBlockCheck = false
  maxUnsolidifiedBlocks = 54
  blockCacheTimeout = 60

  # TCP and transaction limits
  receiveTcpMinDataLength = 2048
  maxTransactionPendingSize = 2000
  pendingTransactionTimeout = 60000

  # Consensus agreement
  agreeNodeCount = 0

  # Shielded transaction (ZK)
  zenTokenId = "000000"
  shieldedTransInPendingMaxCounts = 10

  # Contract proto validation thread pool (0 = auto: availableProcessors)
  validContractProto.threads = 0

  dns {
    treeUrls = [
      # "tree://AKMQMNAJJBL73LXWPXDI4I5ZWWIZ4AWO34DWQ636QOBBXNFXH3LQS@main.trondisco.net",
    ]
    publish = false
    dnsDomain = ""
    dnsPrivate = ""
    knownUrls = []
    staticNodes = []
    maxMergeSize = 0
    changeThreshold = 0.0
    serverType = ""
    accessKeyId = ""
    accessKeySecret = ""
    aliyunDnsEndpoint = ""
    awsRegion = ""
    awsHostZoneId = ""
  }

  # Open history query APIs on lite FullNode (may return null for some queries)
  openHistoryQueryWhenLiteFN = false

  jsonrpc {
    httpFullNodeEnable = false
    httpFullNodePort = 8545
    httpSolidityEnable = false
    httpSolidityPort = 8555
    httpPBFTEnable = false
    httpPBFTPort = 8565

    # Maximum blocks range for eth_getLogs, >0 otherwise no limit
    maxBlockRange = 5000

    # Maximum topics within a topic criteria, >0 otherwise no limit
    maxSubTopics = 1000

    # Maximum number for blockFilter
    maxBlockFilterNum = 50000
  }

  # Disabled API list (works for http, rpc and pbft, not jsonrpc). Case insensitive.
  disabledApi = [
    # "getaccount",
    # "getnowblock2"
  ]
}

## Rate limiter config
rate.limiter = {
  # Strategies: GlobalPreemptibleAdapter, QpsRateLimiterAdapter, IPQPSRateLimiterAdapter
  # Default: QpsRateLimiterAdapter with qps=1000

  http = [
    # {
    #   component = "GetNowBlockServlet",
    #   strategy = "GlobalPreemptibleAdapter",
    #   paramString = "permit=1"
    # },
    # {
    #   component = "GetAccountServlet",
    #   strategy = "IPQPSRateLimiterAdapter",
    #   paramString = "qps=1"
    # },
    # {
    #   component = "ListWitnessesServlet",
    #   strategy = "QpsRateLimiterAdapter",
    #   paramString = "qps=1"
    # }
  ]

  rpc = [
    # {
    #   component = "protocol.Wallet/GetBlockByLatestNum2",
    #   strategy = "GlobalPreemptibleAdapter",
    #   paramString = "permit=1"
    # },
    # {
    #   component = "protocol.Wallet/GetAccount",
    #   strategy = "IPQPSRateLimiterAdapter",
    #   paramString = "qps=1"
    # },
    # {
    #   component = "protocol.Wallet/ListWitnesses",
    #   strategy = "QpsRateLimiterAdapter",
    #   paramString = "qps=1"
    # }
  ]

  p2p = {
    syncBlockChain = 3.0
    fetchInvData = 3.0
    disconnect = 1.0
  }

  global.qps = 50000
  global.ip.qps = 10000
  global.api.qps = 1000
}

seed.node = {
  ip.list = [
    "3.225.171.164:18888",
    "52.8.46.215:18888",
    "3.79.71.167:18888",
    "108.128.110.16:18888",
    "18.133.82.227:18888",
    "35.180.81.133:18888",
    "13.210.151.5:18888",
    "18.231.27.82:18888",
    "3.12.212.122:18888",
    "52.24.128.7:18888",
    "15.207.144.3:18888",
    "3.39.38.55:18888",
    "54.151.226.240:18888",
    "35.174.93.198:18888",
    "18.210.241.149:18888",
    "54.177.115.127:18888",
    "54.254.131.82:18888",
    "18.167.171.167:18888",
    "54.167.11.177:18888",
    "35.74.7.196:18888",
    "52.196.244.176:18888",
    "54.248.129.19:18888",
    "43.198.142.160:18888",
    "3.0.214.7:18888",
    "54.153.59.116:18888",
    "54.153.94.160:18888",
    "54.82.161.39:18888",
    "54.179.207.68:18888",
    "18.142.82.44:18888",
    "18.163.230.203:18888",
    # "[2a05:d014:1f2f:2600:1b15:921:d60b:4c60]:18888",  // use this if support ipv6
    # "[2600:1f18:7260:f400:8947:ebf3:78a0:282b]:18888",  // use this if support ipv6
  ]
}

genesis.block = {
  assets = [
    {
      accountName = "Zion"
      accountType = "AssetIssue"
      address = "TLLM21wteSPs4hKjbxgmH1L6poyMjeTbHm"
      balance = "99000000000000000"
    },
    {
      accountName = "Sun"
      accountType = "AssetIssue"
      address = "TXmVpin5vq5gdZsciyyjdZgKRUju4st1wM"
      balance = "0"
    },
    {
      accountName = "Blackhole"
      accountType = "AssetIssue"
      address = "TLsV52sRDL79HXGGm9yzwKibb6BeruhUzy"
      balance = "-9223372036854775808"
    }
  ]

  witnesses = [
    {
      address: THKJYuUmMKKARNf7s2VT51g5uPY6KEqnat,
      url = "http://GR1.com",
      voteCount = 100000026
    },
    {
      address: TVDmPWGYxgi5DNeW8hXrzrhY8Y6zgxPNg4,
      url = "http://GR2.com",
      voteCount = 100000025
    },
    {
      address: TWKZN1JJPFydd5rMgMCV5aZTSiwmoksSZv,
      url = "http://GR3.com",
      voteCount = 100000024
    },
    {
      address: TDarXEG2rAD57oa7JTK785Yb2Et32UzY32,
      url = "http://GR4.com",
      voteCount = 100000023
    },
    {
      address: TAmFfS4Tmm8yKeoqZN8x51ASwdQBdnVizt,
      url = "http://GR5.com",
      voteCount = 100000022
    },
    {
      address: TK6V5Pw2UWQWpySnZyCDZaAvu1y48oRgXN,
      url = "http://GR6.com",
      voteCount = 100000021
    },
    {
      address: TGqFJPFiEqdZx52ZR4QcKHz4Zr3QXA24VL,
      url = "http://GR7.com",
      voteCount = 100000020
    },
    {
      address: TC1ZCj9Ne3j5v3TLx5ZCDLD55MU9g3XqQW,
      url = "http://GR8.com",
      voteCount = 100000019
    },
    {
      address: TWm3id3mrQ42guf7c4oVpYExyTYnEGy3JL,
      url = "http://GR9.com",
      voteCount = 100000018
    },
    {
      address: TCvwc3FV3ssq2rD82rMmjhT4PVXYTsFcKV,
      url = "http://GR10.com",
      voteCount = 100000017
    },
    {
      address: TFuC2Qge4GxA2U9abKxk1pw3YZvGM5XRir,
      url = "http://GR11.com",
      voteCount = 100000016
    },
    {
      address: TNGoca1VHC6Y5Jd2B1VFpFEhizVk92Rz85,
      url = "http://GR12.com",
      voteCount = 100000015
    },
    {
      address: TLCjmH6SqGK8twZ9XrBDWpBbfyvEXihhNS,
      url = "http://GR13.com",
      voteCount = 100000014
    },
    {
      address: TEEzguTtCihbRPfjf1CvW8Euxz1kKuvtR9,
      url = "http://GR14.com",
      voteCount = 100000013
    },
    {
      address: TZHvwiw9cehbMxrtTbmAexm9oPo4eFFvLS,
      url = "http://GR15.com",
      voteCount = 100000012
    },
    {
      address: TGK6iAKgBmHeQyp5hn3imB71EDnFPkXiPR,
      url = "http://GR16.com",
      voteCount = 100000011
    },
    {
      address: TLaqfGrxZ3dykAFps7M2B4gETTX1yixPgN,
      url = "http://GR17.com",
      voteCount = 100000010
    },
    {
      address: TX3ZceVew6yLC5hWTXnjrUFtiFfUDGKGty,
      url = "http://GR18.com",
      voteCount = 100000009
    },
    {
      address: TYednHaV9zXpnPchSywVpnseQxY9Pxw4do,
      url = "http://GR19.com",
      voteCount = 100000008
    },
    {
      address: TCf5cqLffPccEY7hcsabiFnMfdipfyryvr,
      url = "http://GR20.com",
      voteCount = 100000007
    },
    {
      address: TAa14iLEKPAetX49mzaxZmH6saRxcX7dT5,
      url = "http://GR21.com",
      voteCount = 100000006
    },
    {
      address: TBYsHxDmFaRmfCF3jZNmgeJE8sDnTNKHbz,
      url = "http://GR22.com",
      voteCount = 100000005
    },
    {
      address: TEVAq8dmSQyTYK7uP1ZnZpa6MBVR83GsV6,
      url = "http://GR23.com",
      voteCount = 100000004
    },
    {
      address: TRKJzrZxN34YyB8aBqqPDt7g4fv6sieemz,
      url = "http://GR24.com",
      voteCount = 100000003
    },
    {
      address: TRMP6SKeFUt5NtMLzJv8kdpYuHRnEGjGfe,
      url = "http://GR25.com",
      voteCount = 100000002
    },
    {
      address: TDbNE1VajxjpgM5p7FyGNDASt3UVoFbiD3,
      url = "http://GR26.com",
      voteCount = 100000001
    },
    {
      address: TLTDZBcPoJ8tZ6TTEeEqEvwYFk2wgotSfD,
      url = "http://GR27.com",
      voteCount = 100000000
    }
  ]

  timestamp = "0"

  parentHash = "0xe58f33f9baf9305dc6f82b9f1934ea8f0ade2defb951258d50167028c780351f"
}

# Optional. Used when the witness account has set witnessPermission.
# localWitnessAccountAddress =

localwitness = [
]

# localwitnesskeystore = [
#   "localwitnesskeystore.json"
# ]

block = {
  needSyncCheck = false
  maintenanceTimeInterval = 21600000   // 6 hours (ms)
  proposalExpireTime = 259200000       // 3 days (ms), controlled by committee proposal
  checkFrozenTime = 1                  // maintenance periods to check frozen balance (test only)
}

# Transaction reference block: "solid" or "head". Default "solid". "head" may cause TaPos error.
trx.reference.block = "solid"

# Transaction expiration time in milliseconds.
trx.expiration.timeInMilliseconds = 60000

vm = {
  supportConstant = false
  maxEnergyLimitForConstant = 100000000
  minTimeRatio = 0.0
  maxTimeRatio = 5.0
  saveInternalTx = false
  lruCacheSize = 500
  vmTrace = false

  # Whether to store featured internal transactions (freeze, vote, etc.)
  saveFeaturedInternalTx = false

  # Whether to store details of CANCELALLUNFREEZEV2 opcode internal transactions
  saveCancelAllUnfreezeV2Details = false

  # Max execution time (ms) for re-executed transactions during packaging
  longRunningTime = 10

  # Whether to support estimate energy API
  estimateEnergy = false

  # Max retry time for executing transaction in estimating energy
  estimateEnergyMaxRetry = 3
}

# Governance proposal toggle parameters. All default to 0 (disabled).
# Controlled by on-chain committee proposals, not manual configuration.
# Setting them in config is only for private chain testing.
committee = {
  allowCreationOfContracts = 0
  allowMultiSign = 0
  allowAdaptiveEnergy = 0
  allowDelegateResource = 0
  allowSameTokenName = 0
  allowTvmTransferTrc10 = 0
  allowTvmConstantinople = 0
  allowTvmSolidity059 = 0
  forbidTransferToContract = 0
  allowShieldedTRC20Transaction = 0
  allowTvmIstanbul = 0
  allowMarketTransaction = 0
  allowProtoFilterNum = 0
  allowAccountStateRoot = 0
  changedDelegation = 0
  allowPBFT = 0
  pBFTExpireNum = 20
  allowTransactionFeePool = 0
  allowBlackHoleOptimization = 0
  allowNewResourceModel = 0
  allowReceiptsMerkleRoot = 0
  allowTvmFreeze = 0
  allowTvmVote = 0
  unfreezeDelayDays = 0
  allowTvmLondon = 0
  allowTvmCompatibleEvm = 0
  allowHigherLimitForMaxCpuTimeOfOneTx = 0
  allowNewRewardAlgorithm = 0
  allowOptimizedReturnValueOfChainId = 0
  allowTvmShangHai = 0
  allowOldRewardOpt = 0
  allowEnergyAdjustment = 0
  allowStrictMath = 0
  consensusLogicOptimization = 0
  allowTvmCancun = 0
  allowTvmBlob = 0
  allowTvmOsaka = 0
  allowAccountAssetOptimization = 0
  allowAssetOptimization = 0
  allowNewReward = 0
  memoFee = 0
  allowDelegateOptimization = 0
  allowDynamicEnergy = 0
  dynamicEnergyThreshold = 0
  dynamicEnergyIncreaseFactor = 0
  dynamicEnergyMaxFactor = 0
}

event.subscribe = {
  enable = false

  native = {
    useNativeQueue = true
    bindport = 5555
    sendqueuelength = 1000
  }

  version = 0
  startSyncBlockNum = 0
  path = ""
  server = ""
  dbconfig = ""
  contractParse = true

  topics = [
    {
      triggerName = "block"
      enable = false
      topic = "block"
      solidified = false
    },
    {
      triggerName = "transaction"
      enable = false
      topic = "transaction"
      solidified = false
      ethCompatible = false
    },
    {
      triggerName = "contractevent"
      enable = false
      topic = "contractevent"
    },
    {
      triggerName = "contractlog"
      enable = false
      topic = "contractlog"
      redundancy = false
    },
    {
      triggerName = "solidity"
      enable = true
      topic = "solidity"
    },
    {
      triggerName = "solidityevent"
      enable = false
      topic = "solidityevent"
    },
    {
      triggerName = "soliditylog"
      enable = false
      topic = "soliditylog"
      redundancy = false
    }
  ]

  filter = {
    fromblock = ""
    toblock = ""
    contractAddress = [
      ""
    ]
    contractTopic = [
      ""
    ]
  }
}