Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feat(auth): support accounts from auth #21688

Merged
merged 27 commits into from
Sep 17, 2024
Merged

Conversation

testinginprod
Copy link
Contributor

@testinginprod testinginprod commented Sep 12, 2024

Description

This PR allows x/accounts to be queriable from the auth's gRPC query service, specifically AccountInfo and Account methods.


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...

  • included the correct type prefix in the PR title, you can find examples of the prefixes below:
  • confirmed ! in the type prefix if API or client breaking change
  • targeted the correct branch (see PR Targeting)
  • provided a link to the relevant issue or specification
  • reviewed "Files changed" and left comments if necessary
  • included the necessary unit and integration tests
  • added a changelog entry to CHANGELOG.md
  • updated the relevant documentation or specification, including comments for documenting Go code
  • confirmed all CI checks have passed

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.

Please see Pull Request Reviewer section in the contributing guide for more information on how to review a pull request.

I have...

  • confirmed the correct type prefix in the PR title
  • confirmed all author checklist items have been addressed
  • reviewed state machine logic, API design and naming, documentation is accurate, tests and test coverage

Summary by CodeRabbit

  • New Features

    • Introduced backward-compatible account querying with QueryLegacyAccount and QueryLegacyAccountResponse in the Cosmos SDK.
    • Enhanced gRPC endpoints for querying account information, improving accessibility and interaction with account data.
  • Bug Fixes

    • Improved error handling for account queries, including legacy accounts.
  • Documentation

    • Updated README to include guidance on supporting custom account types and their integration with existing wallets.
  • Tests

    • Added integration tests to ensure compatibility between legacy and new account systems.
    • Enhanced mock capabilities for testing account-related queries.

Copy link
Contributor

coderabbitai bot commented Sep 12, 2024

Walkthrough

Walkthrough

The changes introduce new message types for querying account information in the Cosmos SDK, specifically aimed at maintaining backward compatibility with legacy systems. The modifications include updates to various files, implementing new methods, and enhancing the functionality of existing modules. Additionally, several dependencies have been updated, and new tests have been added to ensure the integrity and compatibility of the account management functionalities.

Changes

Files Change Summary
api/cosmos/auth/v1beta1/accounts.pulsar.go Introduced QueryLegacyAccount and QueryLegacyAccountResponse message types for account queries, implementing reflection methods for serialization.
scripts/mockgen.sh Activated lines to generate mock implementations for keepers in x/auth/types and x/auth/vesting/types.
simapp/go.mod, simapp/v2/go.mod, tests/go.mod Updated cosmossdk.io/x/accounts dependency version and added cosmossdk.io/x/accounts/defaults/base as a new dependency.
tests/integration/auth/keeper/accounts_retro_compatibility_test.go Added integration tests for compatibility between legacy and new account queries, validating various scenarios.
tests/integration/auth/keeper/fixture_test.go Created a fixture for integration testing, encapsulating application context and necessary modules for account and banking interactions.
tests/integration/auth/keeper/msg_server_test.go Removed a fixture struct and its initialization logic, simplifying the test setup.
x/accounts/README.md Added guidelines for supporting custom account types within the x/auth gRPC server, including implementation requirements for compatibility.
x/accounts/accountstd/exports.go Introduced ErrInvalidType, modified ExecModule and QueryModule functions to use generics, and added assertOrErr for type assertions.
x/accounts/defaults/base/account.go Added AuthRetroCompatibility method for legacy account queries and streamlined the getNumber method.
x/accounts/defaults/base/go.mod, x/accounts/defaults/lockup/go.mod, x/accounts/defaults/multisig/go.mod Introduced new go.mod files for base, lockup, and multisig modules, establishing dependencies and local paths for development.
x/accounts/go.mod Added cosmossdk.io/x/accounts/defaults/base dependency and updated the version for github.com/decred/dcrd/dcrec/secp256k1/v4.
x/auth/CHANGELOG.md Documented new features for querying x/accounts through gRPC endpoints and other updates related to transaction validation.
x/auth/keeper/grpc_query.go Enhanced account query logic to support legacy accounts when primary account retrieval fails, introducing new error handling.
x/auth/proto/cosmos/auth/v1beta1/accounts.proto Defined protocol buffer messages QueryLegacyAccount and QueryLegacyAccountResponse for querying legacy account information.
x/auth/testutil/expected_keepers_mocks.go Added a Query method to MockAccountsModKeeper for mocking account queries.
x/auth/types/expected_keepers.go Added a Query method to the AccountsModKeeper interface for querying accounts.
x/auth/vesting/testutil/expected_keepers_mocks.go Removed MockAccountsModKeeper and related methods, indicating a change in mocking strategy.
x/auth/vesting/types/expected_keepers.go Removed the AccountsModKeeper interface from the vesting module, simplifying dependencies.
x/auth/vesting/types/vesting_account_test.go Changed the source of the mock accounts module keeper to align with the authentication module's testing utilities.

Possibly related PRs

  • fix(x/accounts/lockup): prevent double withdraw #21619: Addresses a bug in the lockup functionality of the accounts module, related to the changes for querying account information.
  • docs(x/authz): update grant docs #21677: The documentation updates clarify the deprecation of vesting accounts in favor of the x/accounts module, which aligns with the focus on enhancing account management functionalities.
  • docs(x/auth): vesting #21715: Discusses the removal of vesting account messages and the shift to using x/accounts for account management, directly connecting to the introduction of new message types for account queries.

Recent review details

Configuration used: .coderabbit.yml
Review profile: CHILL

Commits

Files that changed from the base of the PR and between 9280c12 and ee91b4f.

Files selected for processing (1)
  • x/auth/keeper/grpc_query_test.go (2 hunks)
Files skipped from review as they are similar to previous changes (1)
  • x/auth/keeper/grpc_query_test.go

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
Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    -- I pushed a fix in commit <commit_id>, please review it.
    -- 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 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 using 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.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

Documentation and Community

  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

@testinginprod testinginprod added backport/v0.52.x PR scheduled for inclusion in the v0.52's next stable release labels Sep 12, 2024
api/cosmos/auth/v1beta1/accounts.pulsar.go Dismissed Show dismissed Hide dismissed
@julienrbrt julienrbrt mentioned this pull request Sep 16, 2024
10 tasks
@testinginprod testinginprod marked this pull request as ready for review September 17, 2024 09:50
Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

Outside diff range and nitpick comments (1)
x/accounts/README.md (1)

5-61: Great work on the new section!

The content is well-structured, and the explanations are clear and concise. The example implementation is particularly helpful for understanding the concept.

Please add a comma after "x/accounts" in this sentence:

-The x/accounts module provides a mechanism for custom account types to be exposed via its `Account` and `AccountInfo` gRPC
-queries. This feature is particularly useful for ensuring compatibility with existing wallets that have not yet integrated 
-with x/accounts but still need to parse account information post-migration.
+The x/accounts module provides a mechanism for custom account types to be exposed via its `Account` and `AccountInfo` gRPC
+queries. This feature is particularly useful for ensuring compatibility with existing wallets that have not yet integrated 
+with x/accounts, but still need to parse account information post-migration.
Tools
LanguageTool

[uncategorized] ~11-~11: Possible missing comma found.
Context: ...have not yet integrated with x/accounts but still need to parse account information...

(AI_HYDRA_LEO_MISSING_COMMA)

Markdownlint

59-59: Expected: asterisk; Actual: dash
Unordered list style

(MD004, ul-style)


60-60: Expected: asterisk; Actual: dash
Unordered list style

(MD004, ul-style)

Review details

Configuration used: .coderabbit.yml
Review profile: CHILL

Commits

Files that changed from the base of the PR and between a6d4490 and 4ac3aa8.

Files selected for processing (8)
  • .github/dependabot.yml (1 hunks)
  • .github/pr_labeler.yml (1 hunks)
  • .github/workflows/test.yml (1 hunks)
  • go.work.example (1 hunks)
  • x/accounts/README.md (1 hunks)
  • x/accounts/defaults/base/CHANGELOG.md (1 hunks)
  • x/accounts/defaults/base/sonar-project.properties (1 hunks)
  • x/auth/keeper/grpc_query.go (3 hunks)
Additional context used
Path-based instructions (3)
x/accounts/defaults/base/CHANGELOG.md (1)

Pattern **/*.md: "Assess the documentation for misspellings, grammatical errors, missing documentation and correctness"

x/accounts/README.md (1)

Pattern **/*.md: "Assess the documentation for misspellings, grammatical errors, missing documentation and correctness"

x/auth/keeper/grpc_query.go (1)

Pattern **/*.go: Review the Golang code for conformity with the Uber Golang style guide, highlighting any deviations.

Markdownlint
x/accounts/defaults/base/CHANGELOG.md

26-26: null
Files should end with a single newline character

(MD047, single-trailing-newline)

x/accounts/README.md

59-59: Expected: asterisk; Actual: dash
Unordered list style

(MD004, ul-style)


60-60: Expected: asterisk; Actual: dash
Unordered list style

(MD004, ul-style)

LanguageTool
x/accounts/README.md

[uncategorized] ~11-~11: Possible missing comma found.
Context: ...have not yet integrated with x/accounts but still need to parse account information...

(AI_HYDRA_LEO_MISSING_COMMA)

Additional comments not posted (27)
go.work.example (1)

29-29: LGTM!

The addition of the ./x/accounts/defaults/base module path is a valid change that expands the project's functionality to include base defaults from the accounts module. This change is unlikely to introduce any issues.

x/accounts/defaults/base/sonar-project.properties (14)

1-1: LGTM!

The sonar.projectKey property is set correctly, following the naming convention of the project.


2-2: LGTM!

The sonar.organization property is set correctly, matching the organization name of the project.


4-4: LGTM!

The sonar.projectName property is set correctly, accurately describing the project and its location within the Cosmos SDK.


5-5: LGTM!

Enabling sonar.project.monorepo.enabled is appropriate for the Cosmos SDK project structure and allows for better management of multiple projects within a single repository.


7-7: LGTM!

Setting sonar.sources to . ensures that all relevant source files in the directory are included in the SonarQube analysis, which is appropriate for the project structure.


8-8: LGTM!

The sonar.exclusions property is set correctly, excluding test files, generated protocol buffer files, and generated Pulsar files from the main analysis. This helps focus on the quality of the core source code.


9-9: LGTM!

The sonar.coverage.exclusions property is set correctly, excluding test files, test utilities, generated code, and documentation from coverage analysis. This helps provide a more accurate representation of the project's test coverage.


10-10: LGTM!

Setting sonar.tests to . ensures that all relevant test files in the directory are included in the SonarQube analysis, which is appropriate for the project structure.


11-11: LGTM!

The sonar.test.inclusions property is set correctly, including files ending with _test.go, which ensures that all relevant Go test files are included in the SonarQube analysis.


12-12: LGTM!

The sonar.go.coverage.reportPaths property is set correctly, specifying the path to the coverage report file, which allows SonarQube to import and analyze the project's test coverage data.


14-14: LGTM!

Setting sonar.sourceEncoding to UTF-8 ensures that SonarQube correctly interprets the source files, and UTF-8 is a widely used and appropriate encoding for the project.


15-15: LGTM!

Setting sonar.scm.provider to git allows SonarQube to integrate with the project's Git repository, which is the appropriate SCM provider for the project.


16-16: LGTM!

Enabling sonar.scm.forceReloadAll ensures that SonarQube reloads all SCM data and bases the analysis on the latest repository state, which is appropriate for the project to ensure accurate analysis results.


17-17: LGTM!

Enabling sonar.pullrequest.github.summary_comment allows SonarQube to post a summary comment on GitHub pull requests, enhancing integration with GitHub workflows and providing quick feedback on code quality and potential issues directly within the pull request.

x/accounts/defaults/base/CHANGELOG.md (1)

1-26: Excellent addition of a structured changelog file!

The introduction of the CHANGELOG.md file is a great step towards improving the documentation and communication of changes within the project. The outlined guiding principles and format align with industry best practices, promoting clarity, traceability, and effective change management.

Keep up the good work in maintaining a comprehensive and well-structured changelog!

Tools
Markdownlint

26-26: null
Files should end with a single newline character

(MD047, single-trailing-newline)

.github/pr_labeler.yml (1)

31-32: LGTM!

The addition of the new path mapping for "C:x/accounts/base" is consistent with the existing structure and naming conventions. It will help improve the organization and automation of the review process for contributions related to base accounts without introducing any breaking changes or compatibility issues.

x/accounts/README.md (3)

64-64: Past review comment addressed.

The missing # Genesis header has been added. Good job on addressing the feedback from the previous review.


Line range hint 66-72: LGTM!

The explanation of creating accounts at genesis is clear and concise. No issues found.

Tools
LanguageTool

[uncategorized] ~11-~11: Possible missing comma found.
Context: ...have not yet integrated with x/accounts but still need to parse account information...

(AI_HYDRA_LEO_MISSING_COMMA)

Markdownlint

59-59: Expected: asterisk; Actual: dash
Unordered list style

(MD004, ul-style)


60-60: Expected: asterisk; Actual: dash
Unordered list style

(MD004, ul-style)


Line range hint 74-103: Looks good!

The additional details on generating init messages offline and the example genesis.json file are valuable for developers. No issues found.

Tools
LanguageTool

[uncategorized] ~11-~11: Possible missing comma found.
Context: ...have not yet integrated with x/accounts but still need to parse account information...

(AI_HYDRA_LEO_MISSING_COMMA)

Markdownlint

59-59: Expected: asterisk; Actual: dash
Unordered list style

(MD004, ul-style)


60-60: Expected: asterisk; Actual: dash
Unordered list style

(MD004, ul-style)

x/auth/keeper/grpc_query.go (5)

83-87: Improved account retrieval with legacy account fallback.

The added code block introduces a fallback mechanism to handle cases where an account is not found in the primary storage. By attempting to retrieve a legacy account representation using the new getFromXAccounts method, the system can now provide account information even for legacy accounts. This enhances compatibility and robustness of the account retrieval process.


231-237: Enhanced account info retrieval with legacy account fallback.

The added code block introduces a fallback mechanism to handle cases where an account is not found in the primary storage. By attempting to retrieve a legacy account representation using the new getFromXAccounts method, the system can now provide account info even for legacy accounts. This enhances compatibility and robustness of the account info retrieval process.

The check for xAccount.Info == nil ensures that the legacy account can be properly encapsulated into a base account representation before returning the info.


260-263: Improved error handling with specific error variables.

The introduction of the errNotXAccount and errInvalidLegacyAccountImpl error variables enhances error handling in the code. These variables provide specific error messages for different failure scenarios related to legacy accounts, making the code more readable and maintainable. The distinct error messages clearly convey the reason for the failure, aiding in debugging and error tracing.


265-281: Well-structured function for retrieving legacy accounts.

The getFromXAccounts function is a well-structured and modular implementation for retrieving legacy account representations. It encapsulates the necessary logic and performs appropriate checks to ensure the account is an x/account and the response is valid.

The use of the AccountsModKeeper and the Query method allows for a flexible and extensible approach to querying legacy accounts. The function returns specific errors (errNotXAccount and errInvalidLegacyAccountImpl) for different failure scenarios, enhancing error handling and making the code more maintainable.

The function is a valuable addition to the codebase, improving the system's ability to handle legacy accounts seamlessly.


Line range hint 1-281: Adherence to Uber Golang style guide.

The code in this file adheres to the Uber Golang style guide. The naming conventions, formatting, and code structure are consistent with the guidelines. The functions are well-documented with clear and concise comments, making the code readable and maintainable.

The error handling is consistent and follows best practices, using specific error variables and returning appropriate errors for different failure scenarios.

Overall, the code is well-written, idiomatic, and follows the recommended style and practices outlined in the Uber Golang style guide.

.github/dependabot.yml (1)

190-198: LGTM!

The new Dependabot configuration entry for the x/accounts/defaults/base directory follows the established conventions and looks good.

.github/workflows/test.yml (1)

940-961: LGTM!

The test-x-accounts-base job is well-structured and follows best practices:

  • It is triggered only when there are changes in the x/accounts/defaults/base module, which is an efficient way to run tests only when necessary.
  • It uses the latest versions of the actions to stay up-to-date with the latest features and bug fixes.
  • The go test command is run with the -mod=readonly flag to ensure reproducibility of the tests.
  • The go test command generates a coverage profile to measure the test coverage of the module.


# Changelog

## [Unreleased]
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add a newline character at the end of the file.

The static analysis tool has flagged a missing newline character at the end of the file. To address this and ensure compliance with common coding conventions, please add a newline character after the last line of the file.

 ## [Unreleased]
+
Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
## [Unreleased]
## [Unreleased]
Tools
Markdownlint

26-26: null
Files should end with a single newline character

(MD047, single-trailing-newline)

Copy link
Member

@julienrbrt julienrbrt left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ACK!

@testinginprod testinginprod added this pull request to the merge queue Sep 17, 2024
@github-merge-queue github-merge-queue bot removed this pull request from the merge queue due to failed status checks Sep 17, 2024
@testinginprod testinginprod added this pull request to the merge queue Sep 17, 2024
Merged via the queue into main with commit 81ec7ea Sep 17, 2024
74 checks passed
@testinginprod testinginprod deleted the tip/auth/get_from_accounts branch September 17, 2024 18:18
mergify bot pushed a commit that referenced this pull request Sep 17, 2024
(cherry picked from commit 81ec7ea)

# Conflicts:
#	simapp/go.mod
#	simapp/v2/go.mod
#	tests/go.mod
#	x/accounts/go.mod
#	x/group/go.mod
julienrbrt added a commit that referenced this pull request Sep 17, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants