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

refactor(auth): group sig verification ante handlers (SigGasConsume, SigVerify, IncreaseSequence) #18817

Merged
merged 9 commits into from
Dec 20, 2023

Conversation

testinginprod
Copy link
Contributor

@testinginprod testinginprod commented Dec 19, 2023

Description

In this PR we are grouping the certain auth ante decorators, specifically:

  • SigGasConsumptionDecorator
  • IncreaseSequenceDecorator

Have been merged with SigVerification decorator.

This brings:

  • Less gas consumption
  • Better performance
  • Groups together components which are one dependent on the other.

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

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

@testinginprod testinginprod marked this pull request as ready for review December 20, 2023 11:08
@testinginprod testinginprod requested a review from a team as a code owner December 20, 2023 11:08
Copy link
Contributor

coderabbitai bot commented Dec 20, 2023

Walkthrough

The recent update streamlines the authentication process in the x/auth module by combining multiple decorators into a single SigVerification decorator. This reorganization not only simplifies the codebase but also achieves a reduction in gas consumption during transaction validation. The update includes changes to tests and function calls to align with the new consolidated decorator approach, removing redundant components and improving efficiency.

Changes

File(s) Change Summary
CHANGELOG.md, x/auth/CHANGELOG.md Consolidated SigVerification decorator and reduced gas consumption in transaction validation.
baseapp/block_gas_test.go Modified baseGas value from 57504 to 54436, impacting gas consumption testing logic.
simapp/ante.go, x/auth/ante/... Replaced multiple decorators with a single NewSigVerificationDecorator, streamlining signature verification and gas consumption logic.
UPGRADING.md Merged GasConsumptionDecorator and IncreaseSequenceDecorator with SigVerificationDecorator in the AnteHandlers. Refactored the client package to utilize address codecs.
x/auth/ante/sigverify_test.go Updated tests to reflect the new decorator logic, including variable adjustments and removal of the TestIncrementSequenceDecorator function.

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 X ?


Tips

Chat with CodeRabbit Bot (@coderabbitai)

  • You can reply to a review comment made by CodeRabbit.
  • You can tag CodeRabbit on specific lines of code or files in the PR by tagging @coderabbitai in a comment.
  • You can tag @coderabbitai in a PR comment and ask one-off questions about the PR and the codebase. Use quoted replies to pass the context for follow-up questions.

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 a review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @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.
  • The JSON schema for the configuration file is available here.
  • 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/coderabbit-overrides.v2.json

Copy link
Contributor

coderabbitai bot commented Dec 20, 2023

Walkthrough

The recent changes revolve around optimizing gas consumption and signature verification in a blockchain application. The baseGas value was adjusted, which affects gas calculations. The ante handlers have been refactored to streamline the fee deduction and signature verification process, with a new parameter for signature gas consumption being added across several decorators. A significant restructuring combines signature gas consumption and verification into a single decorator, removing redundancies and simplifying the ante handler's construction.

Changes

File Path Change Summary
baseapp/block_gas_test.go Modified baseGas value from 57504 to 54436.
simapp/ante.go
x/auth/ante/ante.go
Added options.SigGasConsumer parameter to decorators.
x/auth/ante/sigverify.go Removed SigGasConsumeDecorator, integrated its functionality into SigVerificationDecorator, which now also takes sigGasConsumer parameter.
x/auth/ante/sigverify_test.go Introduced noOpGasConsume function, updated svd initialization, removed TestIncrementSequenceDecorator, other test modifications.

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 X ?


Tips

Chat with CodeRabbit Bot (@coderabbitai)

  • You can reply to a review comment made by CodeRabbit.
  • You can tag CodeRabbit on specific lines of code or files in the PR by tagging @coderabbitai in a comment.
  • You can tag @coderabbitai in a PR comment and ask one-off questions about the PR and the codebase. Use quoted replies to pass the context for follow-up questions.

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 a review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @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.
  • The JSON schema for the configuration file is available here.
  • 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/coderabbit-overrides.v2.json

@testinginprod testinginprod mentioned this pull request Dec 20, 2023
44 tasks
@testinginprod testinginprod changed the title refactor(auth): group sig verification ante handlers refactor(auth): group sig verification ante handlers (SigGasConsume, SigVerify, IncreaseSequence) Dec 20, 2023
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.

lgtm, pending doc update.

CHANGELOG.md Outdated
@@ -193,6 +193,7 @@ Ref: https://keepachangelog.com/en/1.0.0/

* (x/upgrade) [#16244](https://github.com/cosmos/cosmos-sdk/pull/16244) Upgrade module no longer stores the app version but gets and sets the app version stored in the `ParamStore` of baseapp.
* (x/staking) [#17655](https://github.com/cosmos/cosmos-sdk/pull/17655) `HistoricalInfo` was replaced with `HistoricalRecord`, it removes the validator set and comet header and only keep what is needed for IBC.
* (x/auth) [#18817](https://github.com/cosmos/cosmos-sdk/pull/18817) SigVerification, GasConsumption, IncreaseSequence ante decorators have all been joined into one SigVerification decorator. Gas consumption during TX validation flow has reduced.
Copy link
Member

Choose a reason for hiding this comment

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

nit, changelog placement (x/auth/changelog).
can we have an upgrading.md section as well (## Unreleased > ### Simapp > ##### xxx)

Copy link
Contributor Author

Choose a reason for hiding this comment

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

fixed, ty!

@tac0turtle
Copy link
Member

Could you update the description of the pr before merging. Helps when we look back for any reason.

ante.NewSigGasConsumeDecorator(options.AccountKeeper, options.SigGasConsumer),
ante.NewSigVerificationDecorator(options.AccountKeeper, options.SignModeHandler),
ante.NewIncrementSequenceDecorator(options.AccountKeeper),
ante.NewSigVerificationDecorator(options.AccountKeeper, options.SignModeHandler, options.SigGasConsumer),
Copy link
Contributor

Choose a reason for hiding this comment

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

💡 NOTE
Codebase verification is a beta feature.

The verification process has confirmed that:

  • The SigGasConsumer field is present in the ante.HandlerOptions and is initialized at least in simapp/app.go with ante.DefaultSigVerificationGasConsumer.
  • References to SigGasConsumer are found in various files, including test files such as ante_test.go and testutil_test.go, which suggests that its behavior is covered by unit tests.

Based on the information gathered, it appears that the SigGasConsumer is properly initialized and tested. However, without explicit confirmation that all instances of HandlerOptions are correctly initializing SigGasConsumer, there remains a possibility that some initializations could be missing.

  • Verify that all instances of ante.HandlerOptions across the codebase properly initialize the SigGasConsumer field.
  • Confirm that the unit tests cover all scenarios involving SigGasConsumer, especially in the context of the new NewSigVerificationDecorator functionality.
Analysis chain

The addition of options.SigGasConsumer to NewSigVerificationDecorator is consistent with the refactor to consolidate signature verification and gas consumption. Ensure that the SigGasConsumer is properly initialized before being passed to this function and that its behavior is covered by unit tests.

Scripts Executed

The following scripts were executed for the analysis:


Script:

#!/bin/bash
# Verify that SigGasConsumer is initialized wherever HandlerOptions is constructed
rg --type go 'HandlerOptions{'
# Check for the presence of unit tests involving SigGasConsumer
rg --type go 'Test.*SigGasConsumer' ./x/auth/ante

Length of output: 178



Script:

#!/bin/bash
# Correct the regex pattern to escape the curly brace and verify that SigGasConsumer is initialized wherever HandlerOptions is constructed
rg --type go 'HandlerOptions\{'

# Use a more general pattern to check for the presence of unit tests involving SigGasConsumer
rg --type go 'SigGasConsumer'

Length of output: 2625

Comment on lines 42 to 46
ante.NewDeductFeeDecorator(options.AccountKeeper, options.BankKeeper, options.FeegrantKeeper, options.TxFeeChecker),
ante.NewSetPubKeyDecorator(options.AccountKeeper), // SetPubKeyDecorator must be called before all signature verification decorators
ante.NewValidateSigCountDecorator(options.AccountKeeper),
ante.NewSigGasConsumeDecorator(options.AccountKeeper, options.SigGasConsumer),
ante.NewSigVerificationDecorator(options.AccountKeeper, options.SignModeHandler),
ante.NewIncrementSequenceDecorator(options.AccountKeeper),
ante.NewSigVerificationDecorator(options.AccountKeeper, options.SignModeHandler, options.SigGasConsumer),
}
Copy link
Contributor

Choose a reason for hiding this comment

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

The error handling for required components (AccountKeeper, BankKeeper, SignModeHandler) is in place. Confirm that similar checks are performed for SigGasConsumer to ensure it is not nil, as it is now a critical part of the NewSigVerificationDecorator.

@testinginprod testinginprod added this pull request to the merge queue Dec 20, 2023
@testinginprod testinginprod removed this pull request from the merge queue due to a manual request Dec 20, 2023
@testinginprod testinginprod added this pull request to the merge queue Dec 20, 2023
Merged via the queue into main with commit 4753d16 Dec 20, 2023
58 of 59 checks passed
@testinginprod testinginprod deleted the tip/auth/ante_refactor_2 branch December 20, 2023 18:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants