There is a large number of network-related settings that can be customized in Symbol.
The easiest way to change them is by using Symbol Bootstrap’s custom presets (read Using Symbol Bootstrap): Put the settings in a YAML file and pass it to symbol-bootstrap config using the -c parameter.
These settings can also be directly provided to catapult-client through .properties files. The header of each of the tables below indicates which file contains that table’s properties.
Note
For node-related properties, read the Configuring node properties guide.
resources/config-network.properties v1.0.2.0
| Property | Type | Default value PRIVATE | Default value MAINNET | |||
|---|---|---|---|---|---|---|
| network | ||||||
identifier | NetworkIdentifier | private-test | public | |||
| Network identifier. | ||||||
nodeEqualityStrategy | NodeIdentityEqualityStrategy | host | host | |||
| Node equality strategy. | ||||||
nemesisSignerPublicKey | Key | |||||
| Nemesis public key. | ||||||
generationHashSeed | catapult::GenerationHashSeed | |||||
| Nemesis generation hash seed. | ||||||
epochAdjustment | utils::TimeSpan | 1573430400s | 1615853185s | |||
| Nemesis epoch time adjustment. | ||||||
| chain | ||||||
enableVerifiableState | bool | false | true | |||
true if block chain should calculate state hashes so that state is fully verifiable at each block. | ||||||
enableVerifiableReceipts | bool | false | true | |||
true if block chain should calculate receipts so that state changes are fully verifiable at each block. | ||||||
currencyMosaicId | MosaicId | |||||
| Mosaic id used as primary chain currency. | ||||||
harvestingMosaicId | MosaicId | |||||
| Mosaic id used to provide harvesting ability. | ||||||
blockGenerationTargetTime | utils::TimeSpan | 30s | 30s | |||
| Targeted time between blocks. | ||||||
blockTimeSmoothingFactor | uint32_t | 3000 | 3000 | |||
| Smoothing factor in thousandths. If this value is non-zero, the network will be biased in favor of evenly spaced blocks. Note: A higher value makes the network more biased. Note: This can lower security because it will increase the influence of time relative to importance. | ||||||
importanceGrouping | uint64_t | 39 | 720 | |||
| Number of blocks that should be treated as a group for importance purposes. Note: Importances will only be calculated at blocks that are multiples of this grouping number. | ||||||
importanceActivityPercentage | uint8_t | 5 | 5 | |||
| Percentage of importance resulting from fee generation and beneficiary usage. | ||||||
maxRollbackBlocks | uint32_t | 40 | 0 | |||
| Maximum number of blocks that can be rolled back. | ||||||
maxDifficultyBlocks | uint32_t | 60 | 60 | |||
| Maximum number of blocks to use in a difficulty calculation. | ||||||
defaultDynamicFeeMultiplier | BlockFeeMultiplier | 10'000 | 100 | |||
| Default multiplier to use for dynamic fees. | ||||||
maxTransactionLifetime | utils::TimeSpan | 24h | 6h | |||
| Maximum lifetime a transaction can have before it expires. | ||||||
maxBlockFutureTime | utils::TimeSpan | 500ms | 300ms | |||
| Maximum future time of a block that can be accepted. | ||||||
initialCurrencyAtomicUnits | Amount | 8'999'999'998'000'000 | 7'842'928'625'000'000 | |||
| Initial currency atomic units available in the network. | ||||||
maxMosaicAtomicUnits | Amount | 9'000'000'000'000'000 | 8'999'999'999'000'000 | |||
| Maximum atomic units (total-supply * 10 ^ divisibility) of a mosaic allowed in the network. | ||||||
totalChainImportance | Importance | 17'000'000 | 7'842'928'625'000'000 | |||
| Total whole importance units available in the network. | ||||||
minHarvesterBalance | Amount | 500 | 10'000'000'000 | |||
| Minimum number of harvesting mosaic atomic units needed for an account to be eligible for harvesting. | ||||||
maxHarvesterBalance | Amount | 4'000'000 | 50'000'000'000'000 | |||
| Maximum number of harvesting mosaic atomic units needed for an account to be eligible for harvesting. | ||||||
minVoterBalance | Amount | 50'000 | 3'000'000'000'000 | |||
| Minimum number of harvesting mosaic atomic units needed for an account to be eligible for voting. | ||||||
votingSetGrouping | uint64_t | 78 | 1440 | |||
| Number of blocks that should be treated as a group for voting set purposes. Note: Voting sets will only be calculated at blocks that are multiples of this grouping number. | ||||||
maxVotingKeysPerAccount | uint8_t | 3 | 3 | |||
| Maximum number of voting keys that can be registered at once per account. | ||||||
minVotingKeyLifetime | uint32_t | 72 | 112 | |||
| Minimum number of finalization rounds for which voting key can be registered. | ||||||
maxVotingKeyLifetime | uint32_t | 26280 | 360 | |||
| Maximum number of finalization rounds for which voting key can be registered. | ||||||
harvestBeneficiaryPercentage | uint8_t | 10 | 25 | |||
| Percentage of the harvested fee that is collected by the beneficiary account. | ||||||
harvestNetworkPercentage | uint8_t | 5 | 5 | |||
| Percentage of the harvested fee that is collected by the network. | ||||||
harvestNetworkFeeSinkAddress | Address | |||||
| Address of the harvest network fee sink account. | ||||||
maxTransactionsPerBlock | uint32_t | 200'000 | 6'000 | |||
| Maximum number of transactions per block. | ||||||
| fork_heights | ||||||
totalVotingBalanceCalculationFix | Height | 528'000 | 528'000 | |||
| Height of fork to fix TotalVotingBalance calculation. | ||||||
| plugin:catapult.plugins.accountlink | ||||||
dummy | to trigger plugin load | to trigger plugin load | ||||
| plugin:catapult.plugins.aggregate | ||||||
maxTransactionsPerAggregate | uint32_t | 1'000 | 100 | |||
| Maximum number of transactions per aggregate. | ||||||
maxCosignaturesPerAggregate | uint8_t | 15 | 25 | |||
| Maximum number of cosignatures per aggregate. | ||||||
enableStrictCosignatureCheck | bool | false | false | |||
true if cosignatures must exactly match component signers. false if cosignatures should be validated externally. | ||||||
enableBondedAggregateSupport | bool | true | true | |||
true if bonded aggregates should be allowed. false if bonded aggregates should be rejected. | ||||||
maxBondedTransactionLifetime | utils::TimeSpan | 48h | 48h | |||
| Maximum lifetime a bonded transaction can have before it expires. | ||||||
| plugin:catapult.plugins.lockhash | ||||||
lockedFundsPerAggregate | Amount | 10'000'000 | 10'000'000 | |||
| Amount that has to be locked per aggregate in partial cache. | ||||||
maxHashLockDuration | utils::BlockSpan | 2d | 2d | |||
| Maximum number of blocks for which a hash lock can exist. | ||||||
| plugin:catapult.plugins.locksecret | ||||||
maxSecretLockDuration | utils::BlockSpan | 30d | 365d | |||
| Maximum number of blocks for which a secret lock can exist. | ||||||
minProofSize | uint16_t | 1 | 0 | |||
| Minimum size of a proof in bytes. | ||||||
maxProofSize | uint16_t | 1000 | 1024 | |||
| Maximum size of a proof in bytes. | ||||||
| plugin:catapult.plugins.metadata | ||||||
maxValueSize | uint16_t | 1024 | 1024 | |||
| Maximum metadata value size. | ||||||
| plugin:catapult.plugins.mosaic | ||||||
maxMosaicsPerAccount | uint16_t | 10'000 | 1'000 | |||
| Maximum number of mosaics that an account can own. | ||||||
maxMosaicDuration | utils::BlockSpan | 3650d | 3650d | |||
| Maximum mosaic duration. | ||||||
maxMosaicDivisibility | uint8_t | 6 | 6 | |||
| Maximum mosaic divisibility. | ||||||
mosaicRentalFeeSinkAddress | Address | |||||
| Address of the mosaic rental fee sink account. | ||||||
mosaicRentalFee | Amount | 500 | 500000 | |||
| Mosaic rental fee. | ||||||
| plugin:catapult.plugins.multisig | ||||||
maxMultisigDepth | uint8_t | 3 | 3 | |||
| Maximum number of multisig levels. | ||||||
maxCosignatoriesPerAccount | uint32_t | 10 | 25 | |||
| Maximum number of cosignatories per account. | ||||||
maxCosignedAccountsPerAccount | uint32_t | 5 | 25 | |||
| Maximum number of accounts a single account can cosign. | ||||||
| plugin:catapult.plugins.namespace | ||||||
maxNameSize | uint8_t | 64 | 64 | |||
| Maximum namespace name size. | ||||||
maxChildNamespaces | uint16_t | 500 | 100 | |||
| Maximum number of children for a root namespace. | ||||||
maxNamespaceDepth | uint8_t | 3 | 3 | |||
| Maximum namespace depth. | ||||||
minNamespaceDuration | utils::BlockSpan | 1m | 30d | |||
| Minimum namespace duration. | ||||||
maxNamespaceDuration | utils::BlockSpan | 365d | 1825d | |||
| Maximum namespace duration. | ||||||
namespaceGracePeriodDuration | utils::BlockSpan | 2m | 30d | |||
| Grace period during which time only the previous owner can renew an expired namespace. | ||||||
reservedRootNamespaceNames | unordered_set | xem, nem, user, account, org, com, biz, net, edu, mil, gov, info | symbol, symbl, xym, xem, nem, user, account, org, com, biz, net, edu, mil, gov, info | |||
| Reserved root namespaces that cannot be claimed. | ||||||
namespaceRentalFeeSinkAddress | Address | |||||
| Address of the namespace rental fee sink account. | ||||||
rootNamespaceRentalFeePerBlock | Amount | 1 | 2 | |||
| Root namespace rental fee per block. | ||||||
childNamespaceRentalFee | Amount | 100 | 100000 | |||
| Child namespace rental fee. | ||||||
| plugin:catapult.plugins.restrictionaccount | ||||||
maxAccountRestrictionValues | uint16_t | 512 | 100 | |||
| Maximum number of account restriction values. | ||||||
| plugin:catapult.plugins.restrictionmosaic | ||||||
maxMosaicRestrictionValues | uint8_t | 20 | 20 | |||
| Maximum number of mosaic restriction values. | ||||||
| plugin:catapult.plugins.transfer | ||||||
maxMessageSize | uint16_t | 1024 | 1024 | |||
| Maximum transaction message size. | ||||||
resources/config-inflation.properties v1.0.2.0
| Property | Type | Default value PRIVATE | Default value MAINNET | |||
|---|---|---|---|---|---|---|
| inflation | ||||||
starting-at-height-1 | 100 | |||||
starting-at-height-10000 | 0 | |||||
