> For the complete documentation index, see [llms.txt](https://docs-v4.venus.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-v4.venus.io/technical-reference/reference-core-pool/prime/prime-storage.md). # Prime storage ## PrimeV2StorageV1 Storage layout for the PrimeV2 contract with leaderboard-based Prime token distribution ## Solidity API ```solidity struct Market { uint256 supplyMultiplier; uint256 borrowMultiplier; uint256 rewardIndex; uint256 sumOfMembersScore; bool exists; } ``` ```solidity struct Interest { uint256 accrued; // Accrued rewards pending claim (reset to 0 on claim) uint256 score; // User's score in this market uint256 rewardIndex; // Last recorded reward index uint256 lifetimeAccrued; // Monotonic running total of all rewards ever accrued to this // user in this market; never decremented on claim. Lets the // off-chain cycle pipeline compute per-cycle earnings as the // diff between two snapshots. } ``` ```solidity struct PendingReward { address vToken; address rewardToken; uint256 amount; } ``` #### isPrimeHolder Whether a user holds a Prime token ```solidity mapping(address => bool) isPrimeHolder ``` *** #### totalTokens Total count of Prime tokens ```solidity uint256 totalTokens ``` *** #### tokenLimit Maximum number of Prime tokens allowed ```solidity uint256 tokenLimit ``` *** #### markets Mapping of vToken to its market configuration ```solidity mapping(address => struct PrimeV2StorageV1.Market) markets ``` *** #### interests Mapping of vToken -> user -> interest info ```solidity mapping(address => mapping(address => struct PrimeV2StorageV1.Interest)) interests ``` *** #### vTokenForAsset Mapping of underlying token to vToken address (used to check if an asset is part of Prime markets) ```solidity mapping(address => address) vTokenForAsset ``` *** #### alphaNumerator numerator of alpha. Ex: if alpha is 0.5 then this will be 1 ```solidity uint128 alphaNumerator ``` *** #### alphaDenominator denominator of alpha. Ex: if alpha is 0.5 then this will be 2 ```solidity uint128 alphaDenominator ``` *** #### primeLiquidityProvider The address of the PrimeLiquidityProvider contract ```solidity address primeLiquidityProvider ``` *** #### oracle The address of the ResilientOracle contract ```solidity contract ResilientOracleInterface oracle ``` *** #### corePoolComptroller Address of the core pool comptroller contract ```solidity address corePoolComptroller ``` *** #### unreleasedPLPIncome Unreleased income from the PLP per token that has already been accounted for — either indexed into `rewardIndex` for Prime holders, or recorded in `undistributedReward` while the market had no scored members ```solidity mapping(address => uint256) unreleasedPLPIncome ``` *** #### undistributedReward Income accrued while no scored members existed in the market. Tracked per underlying so governance can reclaim the slice via `sweepUndistributed` without touching user-owed funds. ```solidity mapping(address => uint256) undistributedReward ``` *** #### isScoreUpdated Mapping to check if an account's score was updated in a round ```solidity mapping(uint256 => mapping(address => bool)) isScoreUpdated ``` *** #### nextScoreUpdateRoundId Current score update round ID ```solidity uint256 nextScoreUpdateRoundId ``` *** #### pendingScoreUpdates Number of pending score updates in the current round ```solidity uint256 pendingScoreUpdates ``` *** #### primeLeaderboard Address of the PrimeLeaderboard contract for permissionless eligibility checks ```solidity address primeLeaderboard ``` *** #### mintThreshold Minimum Prime Score required for permissionless Prime minting ```solidity uint256 mintThreshold ``` *** #### mintDeadline Unix timestamp after which permissionless minting is closed (0 = no deadline) ```solidity uint256 mintDeadline ``` *** --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs-v4.venus.io/technical-reference/reference-core-pool/prime/prime-storage.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.