cosmos / interchain-security

Interchain Security is an open sourced IBC application which allows cosmos blockchains to lease their proof-of-stake security to one another.
https://cosmos.github.io/interchain-security/
Other
154 stars 115 forks source link

refactor: use IterateLastValidatorPowers instead of GetLastValidators #1953

Closed p-offtermatt closed 3 months ago

p-offtermatt commented 3 months ago

Description

Closes: #1947

This replaces the call to stakingKeeper.GetLastValidators with calls to providerKeeper.GetLastBondedValidators, which in turn is a wrapper around stakingKeeper.IterateLastValidatorPowers


Author Checklist

All items are required. Please add a note to the item if the item is not applicable and please add links to any relevant follow up issues.

I have...

Reviewers Checklist

All items are required. Please add a note if the item is not applicable and please add your handle next to the items reviewed if you only reviewed selected items.

I have...

Summary by CodeRabbit

coderabbitai[bot] commented 3 months ago
Walkthrough ## Walkthrough The changes primarily involve replacing calls to the `GetLastValidators` method with the `IterateLastValidatorPowers` method across various files. This update ensures safer and more efficient retrieval of validator information, preventing potential panics during block processing. The modifications span multiple packages, including test utilities and various keeper files, to maintain consistency and enhance testing capabilities. ## Changes | Files & Paths | Change Summary | |---------------|----------------| | `testutil/ibc_testing/generic_setup.go` | Replaced `providerApp.GetTestStakingKeeper().GetLastValidators` with `providerKeeper.GetLastBondedValidators`. | | `testutil/keeper/expectations.go`, `testutil/keeper/unit_test_helpers.go`, `testutil/keeper/mocks.go` | Updated mock setups and expectations for last bonded validators, including new parameters for flexibility. Removed `GetLastValidators` from mocks. | | `x/ccv/provider/keeper/grpc_query.go`, `x/ccv/provider/keeper/keeper.go`, `x/ccv/provider/keeper/partial_set_security.go`, `x/ccv/provider/keeper/proposal.go`, `x/ccv/provider/keeper/relay.go`, `x/ccv/provider/keeper/validator_set_update.go` | Introduced `GetLastBondedValidators` function and replaced calls to `stakingKeeper.GetLastValidators` with `k.GetLastBondedValidators`. | | `x/ccv/provider/keeper/proposal_handler_test.go`, `x/ccv/provider/keeper/relay_test.go` | Updated tests to use `SetupMocksForLastBondedValidatorsExpectation` for setting up mocks for last bonded validators. | | `x/ccv/types/expected_keepers.go` | Removed `GetLastValidators` method from `StakingKeeper` interface. | | `tests/integration/unbonding.go` | Replaced `GetLastValidators` with `GetLastBondedValidators` in `CCVTestSuite`. | | `x/ccv/consumer/keeper/changeover_test.go`, `x/ccv/consumer/keeper/keeper.go`, `x/ccv/consumer/keeper/keeper_test.go` | Updated references and mocks from `stakingKeeper` to `consumerKeeper` and used `GetLastBondedValidators` instead of `GetLastValidators`. | | `x/ccv/types/utils.go` | Added `GetLastBondedValidatorsUtil` function for retrieving bonded validators. | ## Sequence Diagram(s) ```mermaid sequenceDiagram participant Client participant ProviderKeeper participant StakingKeeper Client->>ProviderKeeper: Call GetLastBondedValidators() ProviderKeeper->>StakingKeeper: IterateLastValidatorPowers() StakingKeeper-->>ProviderKeeper: Return validators ProviderKeeper-->>Client: Return bonded validators ``` ## Assessment against linked issues | Objective | Addressed | Explanation | |-----------|-----------|-------------| | Replace calls to `GetLastValidators` with `IterateLastValidatorPowers` (#1947) | ✅ | |

Recent review details **Configuration used: .coderabbit.yml** **Review profile: CHILL**
Commits Files that changed from the base of the PR and between 34d63b2b59d448469df472713131adc255aea8ab and 85a17423e58f5562940bd74f2915a9c47413c445.
Files selected for processing (6) * tests/integration/unbonding.go (3 hunks) * x/ccv/consumer/keeper/changeover_test.go (4 hunks) * x/ccv/consumer/keeper/keeper.go (2 hunks) * x/ccv/consumer/keeper/keeper_test.go (1 hunks) * x/ccv/provider/keeper/validator_set_update.go (2 hunks) * x/ccv/types/utils.go (2 hunks)
Additional context used
Path-based instructions (6)
x/ccv/types/utils.go (1) Pattern `**/*.go`: Review the Golang code for conformity with the Uber Golang style guide, highlighting any deviations.
x/ccv/consumer/keeper/changeover_test.go (2) Pattern `**/*.go`: Review the Golang code for conformity with the Uber Golang style guide, highlighting any deviations. --- Pattern `**/*_test.go`: "Assess the unit test code assessing sufficient code coverage for the changes associated in the pull request"
x/ccv/provider/keeper/validator_set_update.go (1) Pattern `**/*.go`: Review the Golang code for conformity with the Uber Golang style guide, highlighting any deviations.
x/ccv/consumer/keeper/keeper_test.go (2) Pattern `**/*.go`: Review the Golang code for conformity with the Uber Golang style guide, highlighting any deviations. --- Pattern `**/*_test.go`: "Assess the unit test code assessing sufficient code coverage for the changes associated in the pull request"
tests/integration/unbonding.go (2) Pattern `**/*.go`: Review the Golang code for conformity with the Uber Golang style guide, highlighting any deviations. --- Pattern `tests/integration/*`: "Assess the e2e test code assessing sufficient code coverage for the changes associated in the pull request"
x/ccv/consumer/keeper/keeper.go (1) Pattern `**/*.go`: Review the Golang code for conformity with the Uber Golang style guide, highlighting any deviations.
Additional comments not posted (5)
x/ccv/consumer/keeper/changeover_test.go (1)
`104-110`: The updated mock setup using `SetupMocksForLastBondedValidatorsExpectation` is correctly implemented to handle the new functionality. Ensure that the test cases adequately cover scenarios where the `IterateLastValidatorPowers` might return different numbers of validators than expected.
x/ccv/provider/keeper/validator_set_update.go (1)
`194-198`: The implementation of `GetLastBondedValidators` correctly delegates to the utility function `GetLastBondedValidatorsUtil`, ensuring consistency and reusability of the logic. This is a good use of abstraction to avoid code duplication.
x/ccv/consumer/keeper/keeper_test.go (1)
`187-192`: The updated mock setup using `SetupMocksForLastBondedValidatorsExpectation` in the test `TestGetLastSovereignValidators` is correctly implemented. Consider adding a test case to handle scenarios where no validators are returned by the `IterateLastValidatorPowers` to ensure robustness.
tests/integration/unbonding.go (1)
Line range hint `470-512`: The test `TestTooManyLastValidators` effectively checks the stability of the system when a validator is jailed and then unjailed, ensuring no panics occur due to state inconsistencies. This is crucial for maintaining the integrity of the validator set updates.
x/ccv/consumer/keeper/keeper.go (1)
`694-698`: The implementation of `GetLastBondedValidators` utilizes a utility function to fetch validators, which is a good use of abstraction. However, ensure that the utility function handles all edge cases, especially around the handling of `MaxValidators`.
Verification successful --- The utility function `GetLastBondedValidatorsUtil` handles edge cases appropriately, including the handling of `MaxValidators`. It correctly stops iteration when the maximum number of validators is reached, truncates the list of validators to the actual number found, and logs and skips invalid addresses and missing validators. -
Scripts executed The following scripts were executed for the analysis: --- Script: ```shell #!/bin/bash # Description: Verify the utility function handles all edge cases. # Test: Search for the utility function usage and ensure it's robust. rg --type go $'GetLastBondedValidatorsUtil' ``` Length of output: 430 --- --- Script: ```shell #!/bin/bash # Extract the implementation of GetLastBondedValidatorsUtil from x/ccv/types/utils.go ast-grep --lang go --pattern $'func GetLastBondedValidatorsUtil(ctx sdk.Context, stakingKeeper StakingKeeper, logger log.Logger) []stakingtypes.Validator { $$$ }' -- x/ccv/types/utils.go ``` Length of output: 2219
--- Thank you for using CodeRabbit. We offer it for free to the OSS community and would appreciate your support in helping us grow. If you find it useful, would you consider giving us a shout-out on your favorite social media?
Share - [X](https://twitter.com/intent/tweet?text=I%20just%20used%20%40coderabbitai%20for%20my%20code%20review%2C%20and%20it%27s%20fantastic%21%20It%27s%20free%20for%20OSS%20and%20offers%20a%20free%20trial%20for%20the%20proprietary%20code.%20Check%20it%20out%3A&url=https%3A//coderabbit.ai) - [Mastodon](https://mastodon.social/share?text=I%20just%20used%20%40coderabbitai%20for%20my%20code%20review%2C%20and%20it%27s%20fantastic%21%20It%27s%20free%20for%20OSS%20and%20offers%20a%20free%20trial%20for%20the%20proprietary%20code.%20Check%20it%20out%3A%20https%3A%2F%2Fcoderabbit.ai) - [Reddit](https://www.reddit.com/submit?title=Great%20tool%20for%20code%20review%20-%20CodeRabbit&text=I%20just%20used%20CodeRabbit%20for%20my%20code%20review%2C%20and%20it%27s%20fantastic%21%20It%27s%20free%20for%20OSS%20and%20offers%20a%20free%20trial%20for%20proprietary%20code.%20Check%20it%20out%3A%20https%3A//coderabbit.ai) - [LinkedIn](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fcoderabbit.ai&mini=true&title=Great%20tool%20for%20code%20review%20-%20CodeRabbit&summary=I%20just%20used%20CodeRabbit%20for%20my%20code%20review%2C%20and%20it%27s%20fantastic%21%20It%27s%20free%20for%20OSS%20and%20offers%20a%20free%20trial%20for%20proprietary%20code)
Tips ### Chat There are 3 ways to chat with [CodeRabbit](https://coderabbit.ai): - Review comments: Directly reply to a review comment made by CodeRabbit. Example: - `I pushed a fix in commit .` - `Generate unit testing code for this file.` - `Open a follow-up GitHub issue for this discussion.` - Files and specific lines of code (under the "Files changed" tab): Tag `@coderabbitai` in a new review comment at the desired location with your query. Examples: - `@coderabbitai generate unit testing code for this file.` - `@coderabbitai modularize this function.` - PR comments: Tag `@coderabbitai` in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples: - `@coderabbitai generate interesting stats about this repository and render them as a table.` - `@coderabbitai show all the console.log statements in this repository.` - `@coderabbitai read src/utils.ts and generate unit testing code.` - `@coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.` - `@coderabbitai help me debug CodeRabbit configuration file.` Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments. ### CodeRabbit Commands (invoked as PR comments) - `@coderabbitai pause` to pause the reviews on a PR. - `@coderabbitai resume` to resume the paused reviews. - `@coderabbitai review` to trigger an incremental review. This is useful when automatic reviews are disabled for the repository. - `@coderabbitai full review` to do a full review from scratch and review all the files again. - `@coderabbitai summary` to regenerate the summary of the PR. - `@coderabbitai resolve` resolve all the CodeRabbit review comments. - `@coderabbitai configuration` to show the current CodeRabbit configuration for the repository. - `@coderabbitai help` to get help. Additionally, you can add `@coderabbitai ignore` anywhere in the PR description to prevent this PR from being reviewed. ### CodeRabbit Configration File (`.coderabbit.yaml`) - You can programmatically configure CodeRabbit by adding a `.coderabbit.yaml` file to the root of your repository. - Please see the [configuration documentation](https://docs.coderabbit.ai/guides/configure-coderabbit) for more information. - If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: `# yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json` ### Documentation and Community - Visit our [Documentation](https://coderabbit.ai/docs) for detailed information on how to use CodeRabbit. - Join our [Discord Community](https://discord.com/invite/GsXnASn26c) to get help, request features, and share feedback. - Follow us on [X/Twitter](https://twitter.com/coderabbitai) for updates and announcements.
sainoe commented 3 months ago

very nit: GetLastValidators can be safely removed in the StakingKeeper interface definition in expected_keeper.go :)

LGTM. Thanks for the work!