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!: enable standalone consumers to reuse existing clients for ICS #2400

Merged
merged 33 commits into from
Jan 7, 2025

Conversation

mpoke
Copy link
Contributor

@mpoke mpoke commented Nov 13, 2024

Description

Closes: #894

  • Remove code from app/consumer-democracy/app.go

  • Add genesis transformation for compatibility with older consumer versions

  • Update docs -- changeover guidelines

  • Add e2e tests for standalone to consumer changeover

    • Start standalone chain and provider chain
    • Create transfer channel to provider
    • Create consumer chain on provider with valid connection ID
    • Upgrade standalone chain to use consumer module with the genesis from the provider
    • Verify that the genesis from the provider doesn't contain a client state or a consensus state
    • Create CCV channel and check that the underlying client matches the one for transfer

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
  • Added ! to the type prefix if the change is state-machine breaking
  • Confirmed this PR does not introduce changes requiring state migrations, OR migration code has been added to consumer and/or provider modules
  • Targeted the correct branch (see PR Targeting)
  • Provided a link to the relevant issue or specification
  • Followed the guidelines for building SDK modules
  • Included the necessary unit and integration tests
  • Added a changelog entry to CHANGELOG.md
  • Included comments for documenting Go code
  • Updated the relevant documentation or specification
  • Reviewed "Files changed" and left comments if necessary
  • Confirmed all CI checks have passed
  • If this PR is library API breaking, bump the go.mod version string of the repo, and follow through on a new major release

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 ! the type prefix if the change is state-machine breaking
  • confirmed this PR does not introduce changes requiring state migrations, OR confirmed migration code has been added to consumer and/or provider modules
  • confirmed all author checklist items have been addressed
  • reviewed state machine logic
  • reviewed API design and naming
  • reviewed documentation is accurate
  • reviewed tests and test coverage

@github-actions github-actions bot added C:x/consumer Assigned automatically by the PR labeler C:x/provider Assigned automatically by the PR labeler C:x/types Assigned automatically by the PR labeler labels Nov 13, 2024
@github-actions github-actions bot added the C:Docs Assigned automatically by the PR labeler label Nov 13, 2024
@github-actions github-actions bot added the C:Testing Assigned automatically by the PR labeler label Nov 13, 2024
app/consumer-democracy/app.go Outdated Show resolved Hide resolved
@mpoke mpoke changed the title feat: enable standalone consumers to reuse existing clients for ICS feat!: enable standalone consumers to reuse existing clients for ICS Nov 13, 2024
@github-actions github-actions bot added the C:Build Assigned automatically by the PR labeler label Dec 23, 2024
tests/interchain/chainsuite/chain_spec_sovereign.go Dismissed Show dismissed Hide dismissed
tests/interchain/chainsuite/config.go Dismissed Show dismissed Hide dismissed
app/consumer/genesis.go Outdated Show resolved Hide resolved
@mpoke mpoke marked this pull request as ready for review January 6, 2025 15:19
@mpoke mpoke requested review from a team as code owners January 6, 2025 15:19
Copy link
Contributor

@MSalopek MSalopek left a comment

Choose a reason for hiding this comment

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

Added docs comments.

* `chain_id` **MUST** be equal to the standalone chain id.
* The consumer initialization parameters (i.e., `initialization_parameters`) must be adapted for the changeover procedure:

* `initial_height` is not used as the provider uses an existing client of the standalone chain..
Copy link
Contributor

Choose a reason for hiding this comment

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

What is the specific configuration that needs to be used? Can it be nil?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I guess. In this case, this field is never used.

docs/docs/consumer-development/changeover-procedure.md Outdated Show resolved Hide resolved
docs/docs/consumer-development/changeover-procedure.md Outdated Show resolved Hide resolved
docs/docs/consumer-development/changeover-procedure.md Outdated Show resolved Hide resolved
docs/docs/consumer-development/changeover-procedure.md Outdated Show resolved Hide resolved
docs/docs/consumer-development/changeover-procedure.md Outdated Show resolved Hide resolved
- [ ] provide a repo with onboarding instructions for validators (it should already be listed in the proposal)
- [ ] genesis.json after `spawn_time` obtained from `provider` (MUST contain the initial validator set)
- [ ] maintenance & emergency contact info (relevant discord, telegram, slack or other communication channels)
Second, the `connection_id` field of `ConsumerGenesisState` must be removed to enable older versions of the consumer module to unmarshal the consumer module genesis state obtained from the provider. This can be done using the `interchain-security-cd genesis transform` CLI command.
Copy link
Contributor

Choose a reason for hiding this comment

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

I don't get it. Should the connection_id be removed or set to ""? This paragraph and the one before it are confusing.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I added some clarification.

@mpoke mpoke merged commit d56af59 into main Jan 7, 2025
17 of 20 checks passed
@mpoke mpoke deleted the marius/894-preccv branch January 7, 2025 16:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
C:Build Assigned automatically by the PR labeler C:Docs Assigned automatically by the PR labeler C:Testing Assigned automatically by the PR labeler C:x/consumer Assigned automatically by the PR labeler C:x/provider Assigned automatically by the PR labeler C:x/types Assigned automatically by the PR labeler
Projects
None yet
Development

Successfully merging this pull request may close these issues.

consumer GenesisState.preCCV is hardcoded
3 participants