Skip to content

docs: document maximum issuance of staking tokens #3728

Open
@erwanor

Description

@erwanor

Is your feature request related to a problem? Please describe.
In #3661, we simplified validator voting power calculation by measuring it in units of staking tokens. However, CometBFT imposes a hard limit of $2^{60} - 1$.

This is not hugely problematic. Assuming a staking token denomination unit of $10^6$, integral staking token quantities take at least 20 bits to represent. This leaves 40 bits (or $10^{12}$) to represent the quantity of tokens (a trillion).

However, we should document this in the specification. If this ever becomes a problem, for example for some re-using the penumbra blockchain stack with parameters that work for them, there is always the option of using a constant factor to rescale the voting power so that it fits the CometBFT limit.

Metadata

Metadata

Assignees

No one assigned

    Labels

    A-docsArea: Documentation needs for the project_P-V2Priority: after mainnet

    Type

    No type

    Projects

    Status

    Backlog

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions