Skip to content

Commit 0437dc7

Browse files
MSalopekdependabot[bot]faddat
authored
Merge main into feat/upgrade-ics-sdk47-ibc7 (#955)
* build(deps): bump gaurav-nelson/github-action-markdown-link-check from 1.0.13 to 1.0.15 (#928) build(deps): bump gaurav-nelson/github-action-markdown-link-check Bumps [gaurav-nelson/github-action-markdown-link-check](https://github.com/gaurav-nelson/github-action-markdown-link-check) from 1.0.13 to 1.0.15. - [Release notes](https://github.com/gaurav-nelson/github-action-markdown-link-check/releases) - [Commits](gaurav-nelson/github-action-markdown-link-check@1.0.13...1.0.15) --- updated-dependencies: - dependency-name: gaurav-nelson/github-action-markdown-link-check dependency-type: direct:production update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] <[email protected]> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> * chore: bump hermes (#921) * bump the version of hermes used in docs and images * use the multiplatform ghcr.io build of hermes --------- Signed-off-by: dependabot[bot] <[email protected]> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Jacob Gadikian <[email protected]>
1 parent a8b93f3 commit 0437dc7

File tree

5 files changed

+22
-7
lines changed

5 files changed

+22
-7
lines changed

.github/workflows/linkchecker.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ jobs:
88
- uses: actions/[email protected]
99

1010
# Checks the status of hyperlinks in *.md files in docs/
11-
- uses: gaurav-nelson/[email protected].13
11+
- uses: gaurav-nelson/[email protected].15
1212
with:
1313
folder-path: "docs"
1414
file-path: './README.md'

Dockerfile

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ RUN go mod tidy
2828
RUN make install
2929

3030
# Get Hermes build
31-
FROM informalsystems/hermes:1.2.0 AS hermes-builder
31+
FROM ghcr.io/informalsystems/hermes:1.4.1 AS hermes-builder
3232

3333
FROM --platform=linux/amd64 fedora:36
3434
RUN dnf update -y

Dockerfile.gaia

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -61,7 +61,7 @@ WORKDIR /interchain-security
6161
RUN make install
6262

6363
# Get Hermes build
64-
FROM informalsystems/hermes:1.2.0 AS hermes-builder
64+
FROM ghcr.io/informalsystems/hermes:1.4.1 AS hermes-builder
6565

6666
FROM --platform=linux/amd64 fedora:36
6767
RUN dnf update -y

docs/docs/consumer-development/onboarding.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ Additionally, you can check the [testnet repo](https://github.com/cosmos/testnet
1111
## 1. Complete testing & integration
1212

1313
- [ ] test integration with gaia
14-
- [ ] test your protocol with supported relayer versions (minimum hermes 1.3)
14+
- [ ] test your protocol with supported relayer versions (minimum hermes 1.4.1)
1515
- [ ] reach out to the ICS team if you are facing issues
1616

1717
## 2. Create an Onboarding Repository

docs/docs/frequently-asked-questions.md

Lines changed: 18 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,7 @@ slug: /faq
55
---
66

77
## What is the meaning of Validator Set Replication?
8+
89
VSR simply means that the same validator set is used to secure both the provider and consumer chains. VSR is ensured through ICS protocol which keeps consumers up to date with the validator set of the provider.
910

1011
## What even is a consumer chain?
@@ -14,6 +15,7 @@ Consumer chain is blockchain operated by the same validator operators as the pro
1415
Consumer chains are run on infrastructure (virtual or physical machines) distinct from the provider, have their own configurations and operating requirements.
1516

1617
## What happens to consumer if provider is down?
18+
1719
In case the provider chain halts or experiences difficulties the consumer chain will keep operating - the provider chain and consumer chains represent different networks, which only share the validator set.
1820

1921
The consumer chain will not halt if the provider halts because they represent distinct networks and distinct infrastructures. Provider chain liveness does not impact consumer chain liveness.
@@ -25,31 +27,37 @@ Steps to recover from this scenario and steps to "release" the validators from t
2527
At the very least, the consumer chain could replace the validator set, remove the ICS module and perform a genesis restart. The impact of this on the IBC clients and connections is currently under careful consideration.
2628

2729
## What happens to provider if consumer is down?
30+
2831
Consumer chains do not impact the provider chain.
2932
The ICS protocol is concerned only with validator set replication and the only communication that the provider requires from the consumer is information about validator activity (essentially keeping the provider informed about slash events).
3033

3134
## Can I run the provider and consumer chains on the same machine?
35+
3236
Yes, but you should favor running them in separate environments so failure of one machine does not impact your whole operation.
3337

3438
## Can the consumer chain have its own token?
39+
3540
As any other cosmos-sdk chain the consumer chain can issue its own token, manage inflation parameters and use them to pay gas fees.
3641

3742
## How are Tx fees paid on consumer?
43+
3844
The consumer chain operates as any other cosmos-sdk chain. The ICS protocol does not impact the normal chain operations.
3945

4046
## Are there any restrictions the consumer chains need to abide by?
47+
4148
No. Consumer chains are free to choose how they wish to operate, which modules to include, use CosmWASM in a permissioned or a permissionless way.
4249
The only thing that separates consumer chains from standalone chains is that they share their validator set with the provider chain.
4350

4451
## What's in it for the validators and stakers?
52+
4553
The consumer chains sends a portion of its fees and inflation as reward to the provider chain as defined by `consumer_redistribution_fraction`. The rewards are distributed (sent to the provider) every `blocks_per_distribution_transmission`.
4654

4755
:::note
4856
`consumer_redistribution_fraction` and `blocks_per_distribution_transmission` are parameters defined in the `ConsumerAdditionProposal` used to create the consumer chain. These parameters can be changed via consumer chain governance.
4957
:::
5058

51-
5259
## Can the consumer chain have its own governance?
60+
5361
**Yes.**
5462

5563
In that case the validators are not necessarily part of the governance structure. Instead, their place in governance is replaced by "representatives" (governors). The representatives do not need to run validators, they simply represent the interests of a particular interest group on the consumer chain.
@@ -58,13 +66,14 @@ Validators can also be representatives but representatives are not required to r
5866

5967
This feature discerns between validator operators (infrastructure) and governance representatives which further democratizes the ecosystem. This also reduces the pressure on validators to be involved in on-chain governance.
6068

61-
6269
## Can validators opt-out of replicated security?
70+
6371
At present, the validators cannot opt-out of validating consumer chains.
6472

6573
There are multiple opt-out mechanisms under active research.
6674

6775
## How does Equivocation Governance Slashing work?
76+
6877
To avoid potential attacks directed at provider chain validators, a new mechanism was introduced:
6978

7079
When a validator double-signs on the consumer chain, a special type of slash packet is relayed to the provider chain. The provider will store information about the double signing validator and allow a governance proposal to be submitted.
@@ -75,19 +84,25 @@ An equivocation proposal cannot be submitted for a validator that did not double
7584
:::
7685

7786
## Can Consumer Chains perform Software Upgrades?
87+
7888
Consumer chains are standalone chains, in the sense that they can run arbitrary logic and use any modules they want (ie CosmWASM).
7989

8090
Consumer chain upgrades are unlikely to impact the provider chain, as long as there are no changes to the ICS module.
8191

8292
## How can I connect to the testnets?
93+
8394
Check out the [Joining Replicated Security testnet](./validators/joining-testnet.md) section.
8495

8596
## How do I start using ICS?
97+
8698
To become a consumer chain use this [checklist](./consumer-development/onboarding.md) and check the [App integration section](./consumer-development/app-integration.md)
8799

88100
## Which relayers are supported?
101+
89102
Currently supported versions:
90-
- Hermes 1.3
103+
104+
- Hermes 1.4.1
91105

92106
## How does key delegation work in ICS?
107+
93108
You can check the [Key Assignment Guide](./features/key-assignment.md) for specific instructions.

0 commit comments

Comments
 (0)