cerc-io/lotus
10
0
Fork 0
Code Issues Pull Requests Packages Projects Releases 27 Wiki Activity

Merge pull request #3102 from filecoin-project/fix/mpool-docs

Browse Source 
Some small improvements in mpool docs
This commit is contained in:
Łukasz Magiera 2020-08-17 09:44:00 +02:00 committed by GitHub
commit 5c23ec73cb
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 7 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
documentation/en/mpool.md
View File

@ -121,13 +121,19 @@ The meaning of these fields is as follows:
be included in a block during message selection, regardless of profitability. be included in a block during message selection, regardless of profitability.
Miners should configure their own worker addresses so that they include their own messages Miners should configure their own worker addresses so that they include their own messages
when they produce a new block. when they produce a new block.
Default is empty.
- `SizeLimitHigh` -- this is the maximum number of pending messages before triggering a - `SizeLimitHigh` -- this is the maximum number of pending messages before triggering a
prune in the message pool. Note that messages from priority addresses are never pruned. prune in the message pool. Note that messages from priority addresses are never pruned.
Defafult is 30000.
- `SizeLimitLow` -- this is the number of pending messages that should be kept after a prune. - `SizeLimitLow` -- this is the number of pending messages that should be kept after a prune.
Default is 20000.
- `ReplaceByFeeRatio` -- this is the gas fee ratio for replacing messages in the mpool. - `ReplaceByFeeRatio` -- this is the gas fee ratio for replacing messages in the mpool.
Whenever a message is replaced, the `GasPremium` must be increased by this ratio. Whenever a message is replaced, the `GasPremium` must be increased by this ratio.
Default is 1.25.
- `PruneCooldown` -- this is the period of time to wait before triggering a new prune. - `PruneCooldown` -- this is the period of time to wait before triggering a new prune.
Default is 1min.
- `GasLimitOverestimation` -- this is a parameter that controls the gas limit overestimation for new messages. - `GasLimitOverestimation` -- this is a parameter that controls the gas limit overestimation for new messages.
Default is 1.25.
## Message Selection ## Message Selection
@ -142,7 +148,7 @@ selection in a reasonable amount of time.
The mpool employs a sophisticated algorithm for selecting messages for The mpool employs a sophisticated algorithm for selecting messages for
inclusion, given the ticket quality of a miner. The ticket quality inclusion, given the ticket quality of a miner. The ticket quality
reflects the probability that a block will execute in the reflects the probability of execution order for a block in the
tipset. Given the ticket quality the algorithm computes the tipset. Given the ticket quality the algorithm computes the
probability of each block, and picks dependent chains of messages such probability of each block, and picks dependent chains of messages such
that the reward is maximized, while also optimizing the capacity of that the reward is maximized, while also optimizing the capacity of