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

fix(docs): fix broken links #20169

Merged
merged 3 commits into from
Apr 24, 2024
Merged

fix(docs): fix broken links #20169

merged 3 commits into from
Apr 24, 2024

Conversation

goofylfg
Copy link
Contributor

@goofylfg goofylfg commented Apr 24, 2024

Description

relative path changed: build/architecture -> architecture so markdown reference path borken.


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

Summary by CodeRabbit

  • Documentation
    • Updated links and references in the Cosmos SDK documentation, ensuring correct paths to architecture documents and details about Protobuf encoding and Keyring methods.

@goofylfg goofylfg requested a review from a team as a code owner April 24, 2024 07:38
Copy link
Contributor

coderabbitai bot commented Apr 24, 2024

Walkthrough

Walkthrough

The updates focus on correcting and updating links within the Cosmos SDK documentation. This involves adjusting paths to architecture documents, Protobuf encoding references, and ADR links across various sections of the documentation.

Changes

File Path Change Summary
docs/learn/advanced/... Updated links to architecture documents in the Cosmos SDK.
docs/learn/beginner/00-... Updated links and details related to Any type and Protobuf encoding, including ADR-019 references.
docs/learn/beginner/03-... Updated links to architecture-related ADRs in the Keyring methods documentation.

Possibly related issues


Recent Review Details

Configuration used: .coderabbit.yml
Review profile: CHILL

Commits Files that changed from the base of the PR and between 11d4e74 and 2b40a1e.
Files selected for processing (3)
  • docs/learn/advanced/01-transactions.md (2 hunks)
  • docs/learn/beginner/00-app-anatomy.md (1 hunks)
  • docs/learn/beginner/03-accounts.md (1 hunks)
Additional Context Used
LanguageTool (446)
docs/learn/advanced/01-transactions.md (106)

Near line 19: An accent character was used instead of an apostrophe.
Context: ...held in contexts and [sdk.Msgs](../../build/building-modules/02-messag...


Near line 19: Possible spelling mistake found.
Context: ...es within a module through the module's Protobuf [Msg service](../../build/building-mo...


Near line 21: Add a space between sentences.
Context: ...e transactions. Each of a transaction's sdk.Msg must be signed using the private key a...


Near line 25: Possible spelling mistake found.
Context: ...are Cosmos SDK types that implement the Tx interface ```go reference https://git...


Near line 33: Possible spelling mistake found.
Context: ...It contains the following methods: * GetMsgs: unwraps the transaction and returns ...


Near line 33: An accent character was used instead of an apostrophe.
Context: ...saction and returns a list of contained sdk.Msgs - one transaction may have one or multi...


Near line 34: Possible spelling mistake found.
Context: ...h are defined by module developers. * ValidateBasic: lightweight, [stateless](../beginn...


Near line 34: Possible spelling mistake found.
Context: ...ycle.md#types-of-checks) checks used by ABCI messages [CheckTx](./00-baseapp.md#ch...


Near line 34: Possible spelling mistake found.
Context: ...of-checks) checks used by ABCI messages CheckTx and [`Delive...


Near line 34: Possible spelling mistake found.
Context: ...CheckTx](./00-baseapp.md#checktx) and DeliverTx to make su...


Near line 34: Possible spelling mistake found.
Context: ...s/cosmos-sdk/tree/main/x/auth) module's ValidateBasic function checks that its transactions ...


Near line 34: Possible spelling mistake found.
Context: ...ot exceed what the user's maximum. When runTx is checking a ...


Near line 34: Possible spelling mistake found.
Context: ...ree/main/x/auth/) module, it first runs ValidateBasic on each message, then runs the auth ...


Near line 34: Possible spelling mistake found.
Context: ...ch message, then runs the auth module AnteHandler which calls ValidateBasic for the tra...


Near line 34: Possible spelling mistake found.
Context: ...e auth module AnteHandler which calls ValidateBasic for the transaction itself. :::no...


Near line 37: Add a space between sentences.
Context: ...nction is different from the deprecated sdk.Msg [ValidateBasic](../beginner/01-tx-li...


Near line 37: Possible spelling mistake found.
Context: ...different from the deprecated sdk.Msg [ValidateBasic](../beginner/01-tx-lifecycle.md#Valida...


Near line 37: Possible typo: you repeated a whitespace
Context: ...basic validity checks on messages only. ::: As a developer, you should rarely m...


Near line 40: Possible spelling mistake found.
Context: ...developer, you should rarely manipulate Tx directly, as Tx is really an interme...


Near line 40: Possible spelling mistake found.
Context: ...uld rarely manipulate Tx directly, as Tx is really an intermediate type used fo...


Near line 40: Possible spelling mistake found.
Context: .... Instead, developers should prefer the TxBuilder interface, which you can learn more ab...


Near line 44: Possible spelling mistake found.
Context: ...igned by the addresses specified by its GetSigners. The Cosmos SDK currently allows signi...


Near line 48: Possible spelling mistake found.
Context: ...d) The most used implementation of the Tx interface is the Protobuf Tx message...


Near line 48: Possible spelling mistake found.
Context: ...ementation of the Tx interface is the Protobuf Tx message, which is used in `SIGN_MO...


Near line 48: Possible spelling mistake found.
Context: ...n of the Tx interface is the Protobuf Tx message, which is used in `SIGN_MODE_D...


Near line 54: Possible spelling mistake found.
Context: ...x/v1beta1/tx.proto#L13-L26 ``` Because Protobuf serialization is not deterministic, the...


Near line 54: Possible spelling mistake found.
Context: ...stic, the Cosmos SDK uses an additional TxRaw type to denote the pinned bytes over w...


Near line 54: Possible spelling mistake found.
Context: ... and serialize these two messages using Protobuf. TxRaw then pins the user's exact bin...


Near line 54: Possible spelling mistake found.
Context: ...lize these two messages using Protobuf. TxRaw then pins the user's exact binary repr...


Near line 54: Possible spelling mistake found.
Context: ...ed by all signers of the transaction is SignDoc (deterministically serialized using [A...


Near line 60: Possible spelling mistake found.
Context: ...tesandsignaturesare gathered intoTxRaw`, whose serialized bytes are broadcaste...


Near line 64: Possible spelling mistake found.
Context: ...JSON The legacy implementation of theTxinterface is theStdTxstruct from...


Near line 64: Possible spelling mistake found.
Context: ...ementation of the Tx interface is the StdTx struct from x/auth: ```go reference...


Near line 70: Possible spelling mistake found.
Context: ... The document signed by all signers is StdSignDoc: ```go reference https://github.com/c...


Near line 75: This sentence does not start with an uppercase letter.
Context: ...ations/legacytx/stdsign.go#L31-L45 ``` which is encoded into bytes using Amino JSON....


Near line 76: Possible spelling mistake found.
Context: .... Once all signatures are gathered into StdTx, StdTx is serialized using Amino JSO...


Near line 76: Possible spelling mistake found.
Context: ...l signatures are gathered into StdTx, StdTx is serialized using Amino JSON, and th...


Near line 84: This sentence does not start with an uppercase letter.
Context: ...ODE_DIRECT_AUX SIGN_MODE_DIRECT_AUX` is a sign mode released in the Cosmos SDK ...


Near line 84: Possible spelling mistake found.
Context: ...expects each signer to sign over bothTxBodyandAuthInfo` (which includes all oth...


Near line 84: Possible spelling mistake found.
Context: ...h signer to sign over both TxBody and AuthInfo (which includes all other signers' sig...


Near line 84: Possible spelling mistake found.
Context: ...hich includes all other signers' signer infos, i.e. their account sequence, public ke...


Near line 84: Possible spelling mistake found.
Context: ...Xallows N-1 signers to only sign overTxBody` and their own signer info. Moreover,...


Near line 91: Possible spelling mistake found.
Context: ...SIGN_MODE_DIRECT_AUX to sign over the TxBody and their own signer info (no need an ...


Near line 91: Possible missing preposition found.
Context: ...ody` and their own signer info (no need an additional step to gather other signers...


Near line 91: Possible spelling mistake found.
Context: ...CT`), without specifying a fee in their SignDoc. Charlie can then gather both signature...


Near line 97: This sentence does not start with an uppercase letter.
Context: ...SIGN_MODE_TEXTUAL SIGN_MODE_TEXTUAL` is a new sign mode for delivering a better...


Near line 97: Use a comma before ‘and’ if it connects two independent clauses (unless they are closely connected and short).
Context: ...r signing experience on hardware wallets and it is included in the v0.50 release. In...


Near line 97: Possible spelling mistake found.
Context: ...ring representation of the transaction (CBOR) and makes all data being displayed eas...


Near line 97: Possible missing comma found.
Context: ... screen is meant to be displayed in its entirety even on small devices like the Ledger N...


Near line 97: Possible spelling mistake found.
Context: ...y even on small devices like the Ledger Nano. There are also expert screens, whic...


Near line 101: Possible spelling mistake found.
Context: ...hash. Data is formatted using a set of ValueRenderer which the SDK provides defaults for al...


Near line 101: Possible spelling mistake found.
Context: ...ers can also opt to implement their own ValueRenderer for a type/message if they'd like to d...


Near line 107: Unless you want to emphasize “not”, use “cannot” which is more common.
Context: ... sign mode to the Cosmos-SDK. While we can not accept the implementation of the sign m...


Near line 107: Possible spelling mistake found.
Context: ...accept a pull request to add the custom signmode to the SignMode enum located [here](htt...


Near line 107: Possible spelling mistake found.
Context: ...quest to add the custom signmode to the SignMode enum located [here](https://github.com/...


Near line 107: Possible spelling mistake found.
Context: ...add the custom signmode to the SignMode enum located [here](https://github.com/cosmo...


Near line 113: This sentence does not start with an uppercase letter.
Context: ...n end-user sending a transaction is: * decide on the messages to put into the transac...


Near line 114: Possible spelling mistake found.
Context: ... the transaction using the Cosmos SDK's TxBuilder, * broadcast the transaction using one...


Near line 122: An accent character was used instead of an apostrophe.
Context: ...his order. ### Messages :::tip Module sdk.Msgs are not to be confused with [ABCI Messa...


Near line 122: Possible spelling mistake found.
Context: ...sdk.Msgs are not to be confused with [ABCI Messages](https://docs.cometbft.com/v1....


Near line 122: Possible spelling mistake found.
Context: ...) which define interactions between the CometBFT and application layers. ::: **Messages...


Near line 125: An accent character was used instead of an apostrophe.
Context: ...plication layers. ::: Messages (or sdk.Msgs) are module-specific objects that trigg...


Near line 125: Possible spelling mistake found.
Context: ...r their module by adding methods to the Protobuf [Msg service](../../build/building-mo...


Near line 125: Possible spelling mistake found.
Context: ...), and also implement the corresponding MsgServer. Each sdk.Msgs is related to exactl...


Near line 127: An accent character was used instead of an apostrophe.
Context: ...nt the corresponding MsgServer. Each sdk.Msgs is related to exactly one Protobuf [`Ms...


Near line 127: The verb “is” doesn’t seem to fit in this context, “are” is probably more formally correct.
Context: ...esponding MsgServer. Each sdk.Msgs is related to exactly one Protobuf [Msg ...


Near line 127: Possible spelling mistake found.
Context: ...ch sdk.Msgs is related to exactly one Protobuf [Msg service](../../build/building-mo...


Near line 127: Possible spelling mistake found.
Context: ...s.md) RPC, defined inside each module's tx.proto file. A SDK app router automatic...


Near line 127: Use “An” instead of ‘A’ if the following word starts with a vowel sound, e.g. ‘an article’, ‘an hour’.
Context: ...d inside each module's tx.proto file. A SDK app router automatically maps every...


Near line 127: Add a space between sentences.
Context: ...SDK app router automatically maps every sdk.Msg to a corresponding RPC. Protobuf gener...


Near line 127: Possible spelling mistake found.
Context: ...every sdk.Msg to a corresponding RPC. Protobuf generates a MsgServer interface for e...


Near line 127: Possible spelling mistake found.
Context: ...corresponding RPC. Protobuf generates a MsgServer interface for each module Msg servic...


Near line 130: Possible spelling mistake found.
Context: ...ogic repetitively. To learn more about Protobuf Msg services and how to implement `Ms...


Near line 130: Possible spelling mistake found.
Context: ...buf Msg services and how to implement MsgServer, click [here](../../build/building-mod...


Near line 132: Possible spelling mistake found.
Context: ... relevant information are stored in the TxBuilder and Context. ### Transaction Genera...


Near line 136: Possible spelling mistake found.
Context: ...text. ### Transaction Generation The TxBuilder` interface contains data closely relate...


Near line 142: This sentence does not start with an uppercase letter.
Context: ...client/tx_config.go#L40-L53 ``` * Msgs, the array of messages inc...


Near line 143: Loose punctuation mark.
Context: ...ncluded in the transaction. * GasLimit, option chosen by the users for how to c...


Near line 144: Loose punctuation mark.
Context: ...much gas they will need to pay. * Memo, a note or comment to send with the tran...


Near line 145: Loose punctuation mark.
Context: ...send with the transaction. * FeeAmount, the maximum amount the user is willing ...


Near line 146: Loose punctuation mark.
Context: ...illing to pay in fees. * TimeoutHeight, block height until which the transactio...


Near line 147: Loose punctuation mark.
Context: ...the transaction is valid. * Signatures, the array of signatures from all signer...


Near line 149: Possible spelling mistake found.
Context: ..., there are also two implementations of TxBuilder: * [wrapper](https://github.com/cosmo...


Near line 151: This sentence does not start with an uppercase letter.
Context: ...two implementations of TxBuilder: * [wrapper](https://github.com/cosmos/cosmos-sdk/b...


Near line 152: Possible spelling mistake found.
Context: ...transactions for SIGN_MODE_DIRECT, * [StdTxBuilder](https://github.com/cosmos/cosmos-sdk/b...


Near line 154: Possible spelling mistake found.
Context: .... However, the two implementations of TxBuilder` should be hidden away from end-users, ...


Near line 154: Possible spelling mistake found.
Context: ...hey should prefer using the overarching TxConfig interface: ```go reference https://gi...


Near line 160: This sentence does not start with an uppercase letter.
Context: ...nt/tx_config.go#L24-L34 ``` TxConfig is an app-wide configuration for managing ...


Near line 160: Add a space between sentences.
Context: ...IGN_MODE_LEGACY_AMINO_JSON. By calling txBuilder := txConfig.NewTxBuilder(), a new TxBuilder` will be created w...


Near line 160: Possible spelling mistake found.
Context: ...lder := txConfig.NewTxBuilder(), a new TxBuilder` will be created with the appropriate s...


Near line 162: Possible spelling mistake found.
Context: ...d with the appropriate sign mode. Once TxBuilder is correctly populated with the setter...


Near line 162: Possible spelling mistake found.
Context: ...pulated with the setters exposed above, TxConfig will also take care of correctly encod...


Near line 162: This word is normally spelled as one.
Context: ...SIGN_MODE_LEGACY_AMINO_JSON`). Here's a pseudo-code snippet of how to generate and encode a...


Near line 180: Possible spelling mistake found.
Context: ...d-line. For the command-line interface, module developers create subcommands ...


Near line 180: Possible spelling mistake found.
Context: ...faces.md#cli), module developers create subcommands to add as children to the application t...


Near line 180: Possible spelling mistake found.
Context: ...plication top-level transaction command TxCmd. CLI commands actually bundle all the ...


Near line 180: Only proper nouns start with an uppercase character (there are exceptions for headlines).
Context: ...asting. For concrete examples, see the [Interacting with a Node](https://docs.cosmos.networ...


Near line 188: Unpaired symbol: ‘[’ seems to be missing
Context: ...ECIPIENT 1000stake ``` #### gRPC gRPC is the main component ...


Near line 188: Possible spelling mistake found.
Context: ...ic gRPC services, one of them being the Tx service: ```go reference https://gith...


Near line 194: Possible spelling mistake found.
Context: ...osmos/tx/v1beta1/service.proto ``` The Tx service exposes a handful of utility f...


Near line 200: Possible spelling mistake found.
Context: ... broadcast the same transaction, on the POST /cosmos/tx/v1beta1/txs endpoint. An example can ...


Near line 204: Possible spelling mistake found.
Context: ...ain/user/run-node/txs#using-rest) #### CometBFT RPC The three methods presented above ...


Near line 206: Possible spelling mistake found.
Context: ...e actually higher abstractions over the CometBFT RPC /broadcast_tx_{async,sync,commit}...


Near line 206: Put a space after the comma.
Context: ...gher abstractions over the CometBFT RPC /broadcast_tx_{async,sync,commit} endpoints, documented [here](h...


Near line 206: Possible spelling mistake found.
Context: ...e/rpc). This means that you can use the CometBFT RPC endpoints directly to broadcast the...


Near line 206: Usually, there’s no comma before “if”.
Context: ...ts directly to broadcast the transaction, if you wish so.

docs/learn/beginner/00-app-anatomy.md (233)

Near line 33: Possible spelling mistake found.
Context: ...lly suffixed by -d for "daemon" (e.g. appd for app or gaiad for gaia). This...


Near line 33: Possible spelling mistake found.
Context: ... for "daemon" (e.g. appd for app or gaiad for gaia). This binary is built by r...


Near line 33: Possible spelling mistake found.
Context: ..." (e.g. appd for app or gaiad for gaia). This binary is built by running a si...


Near line 33: Possible spelling mistake found.
Context: ...de.md#main-function) function placed in ./cmd/appd/. This operation usually happens throu...


Near line 38: Possible spelling mistake found.
Context: ...s point, the state-machine is at height appBlockHeight. 3. Create and start a new CometBFT in...


Near line 39: Possible spelling mistake found.
Context: ...BlockHeight`. 3. Create and start a new CometBFT instance. Among other things, the node ...


Near line 39: Possible spelling mistake found.
Context: ...hake with its peers. It gets the latest blockHeight from them and replays blocks to sync t...


Near line 39: Possible spelling mistake found.
Context: ... height if it is greater than the local appBlockHeight. The node starts from genesis and Come...


Near line 39: Possible spelling mistake found.
Context: ...ight. The node starts from genesis and CometBFT sends an InitChain` message via the AB...


Near line 39: Possible spelling mistake found.
Context: ...arts from genesis and CometBFT sends an InitChain message via the ABCI to the app, whi...


Near line 39: Possible spelling mistake found.
Context: ...FT sends an InitChain message via the ABCI to the app, which triggers the [`Init...


Near line 39: Possible spelling mistake found.
Context: ...e ABCI to the app, which triggers the InitChainer. :::note When starting...


Near line 42: Possible spelling mistake found.
Context: ...#initchainer). :::note When starting a CometBFT instance, the genesis file is the 0 h...


Near line 53: Possible spelling mistake found.
Context: ...he following parts: * A reference to baseapp. The cus...


Near line 53: Possible spelling mistake found.
Context: ... defined in app.go is an extension of baseapp. When a transaction is relayed by Come...


Near line 53: Possible spelling mistake found.
Context: ...eapp. When a transaction is relayed by CometBFT to the application, appusesbaseapp...


Near line 53: Possible spelling mistake found.
Context: ...CometBFT to the application, app uses baseapp's methods to route them to the appropr...


Near line 53: Possible spelling mistake found.
Context: ...o route them to the appropriate module. baseapp implements most of the core logic for ...


Near line 53: Possible spelling mistake found.
Context: ...for the application, including all the [ABCI methods](https://docs.cometbft.com/v1.0...


Near line 54: Possible spelling mistake found.
Context: ...s the entire state, is implemented as a multistore (...


Near line 54: Possible spelling mistake found.
Context: ...dule uses one or multiple stores in the multistore to persist their part of the state. The...


Near line 55: An accent character was used instead of an apostrophe.
Context: ... the Cosmos SDK. * A list of module's keepers. Each module defines an abstraction c...


Near line 56: Possible spelling mistake found.
Context: ...orized functions. * A reference to an appCodec. The ap...


Near line 56: Possible spelling mistake found.
Context: ...ed/05-encoding.md).** The application's appCodec is used to serialize and deserialize d...


Near line 56: Consider a shorter alternative to avoid wordiness.
Context: ...rialize and deserialize data structures in order to store them, as stores can only persist ...


Near line 57: Possible spelling mistake found.
Context: ...d/05-encoding.md). * A reference to a legacyAmino codec. ...


Near line 57: Possible spelling mistake found.
Context: ...s SDK have not been migrated to use the appCodec above, and are still hardcoded to use ...


Near line 57: Possible spelling mistake found.
Context: ...use the appCodec above, and are still hardcoded to use Amino. Other parts explicitly us...


Near line 58: Possible spelling mistake found.
Context: ...#msg-services) and gRPC Query service, or setting the order of execution bet...


Near line 58: Possible spelling mistake found.
Context: ...ween modules for various functions like InitChainer, [PreBlocker](#preblo...


Near line 58: Possible spelling mistake found.
Context: ...ons like InitChainer, PreBlocker and [BeginBlocker and ...


Near line 58: Possible spelling mistake found.
Context: ...ainer), PreBlocker and [BeginBlocker and EndBlocker](#beginblocker-and-en...


Near line 58: Possible spelling mistake found.
Context: ...](#preblocker) and [BeginBlockerandEndBlocker`](#beginblocker-and-endblocker). See a...


Near line 60: Possible spelling mistake found.
Context: ...ple of application type definition from simapp, the Cosmos SDK's own app used for dem...


Near line 68: Possible spelling mistake found.
Context: ... section. The function must fulfill the AppCreator signature in order to be used in the [...


Near line 68: Consider a shorter alternative to avoid wordiness.
Context: ...must fulfill the AppCreator signature in order to be used in the [start command](../adv...


Near line 77: Possible spelling mistake found.
Context: ...a new application with a reference to a baseapp instance, a codec, and all the appropr...


Near line 78: Three successive sentences begin with the same word. Consider rewording the sentence or use a thesaurus to find a synonym.
Context: ..., and all the appropriate store keys. * Instantiate all the keeper objects def...


Near line 78: Possible spelling mistake found.
Context: ...d in the application's type using the NewKeeper function of each of the application's ...


Near line 78: Possible spelling mistake found.
Context: ...stantiated in the correct order, as the NewKeeper of one module might require a referenc...


Near line 79: Possible spelling mistake found.
Context: .../01-module-manager.md#manager) with the AppModule object...


Near line 80: Possible spelling mistake found.
Context: ...md#msg-services), gRPC Query services, [legacy Msg routes](../advanced/00-...


Near line 80: Possible spelling mistake found.
Context: ...action is relayed to the application by CometBFT via the ABCI, it is routed to the appro...


Near line 80: Possible spelling mistake found.
Context: ... to the application by CometBFT via the ABCI, it is routed to the appropriate module...


Near line 80: An accent character was used instead of an apostrophe.
Context: ...e. The Cosmos SDK still supports legacy Msgs and legacy CometBFT queries, which are ...


Near line 80: Possible spelling mistake found.
Context: ...still supports legacy Msgs and legacy CometBFT queries, which are routed using the leg...


Near line 81: Possible spelling mistake found.
Context: ...is done via a special module called the [InvariantsRegistry](../../build/building-modules/07-invar...


Near line 81: Did you mean ‘different from’? ‘Different than’ is often considered colloquial style.
Context: ...e module. Should the value be different than the predicted one, special logic define...


Near line 81: To elevate your writing, try using a synonym here.
Context: ...producing long-lasting effects that are hard to fix. * With the module manager, set ...


Near line 82: Possible spelling mistake found.
Context: ... set the order of execution between the InitGenesis, PreBlocker, BeginBlocker, and `En...


Near line 82: Possible spelling mistake found.
Context: ...of execution between the InitGenesis, PreBlocker, BeginBlocker, and EndBlocker func...


Near line 82: Possible spelling mistake found.
Context: ...etween the InitGenesis, PreBlocker, BeginBlocker, and EndBlocker functions of each of...


Near line 82: Possible spelling mistake found.
Context: ...sis, PreBlocker, BeginBlocker, and EndBlocker` functions of each of the [application'...


Near line 84: This phrase is redundant. Consider writing “started”.
Context: ...o initialize the application when it is first started. * PreBlocker: cal...


Near line 85: Loose punctuation mark.
Context: ...arted. * PreBlocker: called before BeginBlock. * [`Begin...


Near line 85: Possible spelling mistake found.
Context: ...reBlocker](#preblocker): called before BeginBlock. * [BeginBlocker, EndBlocker`](#...


Near line 86: Loose punctuation mark.
Context: ...before BeginBlock. * [BeginBlocker, EndBlocker](#beginblocker-and-endbloc...


Near line 86: Unpaired symbol: ‘[’ seems to be missing
Context: ...fore BeginBlock. * BeginBlocker, EndBlocker: called a...


Near line 87: Loose punctuation mark.
Context: ...](../advanced/00-baseapp.md#antehandler): used to handle fees and signature verif...


Near line 93: You might be missing the article “an” here.
Context: ... for the first time. See an example of application constructor from simapp: ```go refer...


Near line 93: Possible spelling mistake found.
Context: ...example of application constructor from simapp: ```go reference https://github.com/c...


Near line 99: Possible spelling mistake found.
Context: ...lpha.0/simapp/app.go#L223-L575 ``` ### InitChainer The InitChainer is a function that i...


Near line 101: Possible spelling mistake found.
Context: ....go#L223-L575 ``` ### InitChainer The InitChainer is a function that initializes the sta...


Near line 101: Possible spelling mistake found.
Context: ...alled when the application receives the InitChain message from the CometBFT engine, whic...


Near line 101: Possible spelling mistake found.
Context: ...ceives the InitChain message from the CometBFT engine, which happens when the node is ...


Near line 101: Possible spelling mistake found.
Context: ...ich happens when the node is started at appBlockHeight == 0 (i.e. on genesis). The applicatio...


Near line 101: Possible spelling mistake found.
Context: ... genesis). The application must set the InitChainer in its [constructor](#constructor-func...


Near line 101: Add a space between sentences.
Context: ...tructor](#constructor-function) via the SetInitChainer method. In general, the InitChainer...


Near line 103: Possible spelling mistake found.
Context: ...etInitChainer) method. In general, the InitChainer is mostly composed of the [`InitGenesi...


Near line 103: Possible spelling mistake found.
Context: ...InitChainer is mostly composed of the [InitGenesis](../../build/building-modules/08-genes...


Near line 103: Possible spelling mistake found.
Context: ...'s modules. This is done by calling the InitGenesis function of the module manager, which ...


Near line 103: Possible spelling mistake found.
Context: ...module manager, which in turn calls the InitGenesis function of each of the modules it con...


Near line 103: Possible spelling mistake found.
Context: ...te that the order in which the modules' InitGenesis functions must be called has to be set...


Near line 103: Possible spelling mistake found.
Context: .../building-modules/01-module-manager.md) SetOrderInitGenesis method. This is done in the [applicati...


Near line 103: Possible spelling mistake found.
Context: ...ructor](#constructor-function), and the SetOrderInitGenesis has to be called before the `SetInitCh...


Near line 103: Possible spelling mistake found.
Context: ...nitGenesishas to be called before theSetInitChainer. See an example of an InitChainer` f...


Near line 105: Possible spelling mistake found.
Context: ...SetInitChainer. See an example of an InitChainer from simapp: ```go reference https:...


Near line 105: Possible spelling mistake found.
Context: ...See an example of an InitChainer from simapp: ```go reference https://github.com/c...


Near line 111: Possible spelling mistake found.
Context: ...lpha.0/simapp/app.go#L626-L634 ``` ### PreBlocker There are two semantics around the new...


Near line 115: Possible spelling mistake found.
Context: ...lifecycle method: - It runs before the BeginBlocker of all modules - It can modify consens...


Near line 118: Possible spelling mistake found.
Context: ...ough the return value. When it returns ConsensusParamsChanged=true, the caller must refresh the cons...


Near line 122: Possible spelling mistake found.
Context: ...s(app.GetConsensusParams()) ``` The new ctx must be passed to all the other lifecyc...


Near line 124: Possible spelling mistake found.
Context: ...o all the other lifecycle methods. ### BeginBlocker and EndBlocker The Cosmos SDK offers d...


Near line 124: Possible spelling mistake found.
Context: ...ifecycle methods. ### BeginBlocker and EndBlocker The Cosmos SDK offers developers the p...


Near line 126: Possible spelling mistake found.
Context: ...mplemented through two functions called BeginBlocker and EndBlocker. They are called when...


Near line 126: Possible spelling mistake found.
Context: ...two functions called BeginBlocker and EndBlocker. They are called when the application ...


Near line 126: Possible spelling mistake found.
Context: ...alled when the application receives the FinalizeBlock messages from the CometBFT consensus e...


Near line 126: Possible spelling mistake found.
Context: ...s the FinalizeBlock messages from the CometBFT consensus engine, which happens respect...


Near line 126: Possible spelling mistake found.
Context: ...ach block. The application must set the BeginBlocker and EndBlocker in its [constructor](...


Near line 126: Possible spelling mistake found.
Context: ...ication must set the BeginBlocker and EndBlocker in its [constructor](#constructor-func...


Near line 126: Add a space between sentences.
Context: ...tructor](#constructor-function) via the SetBeginBlocker and [SetEndBlocker](https://pkg.go.d...


Near line 126: Add a space between sentences.
Context: ...dk/baseapp#BaseApp.SetBeginBlocker) and SetEndBlocker methods. In general, the `BeginBlocke...


Near line 128: Possible spelling mistake found.
Context: ...etEndBlocker) methods. In general, the BeginBlocker and EndBlocker functions are mostly ...


Near line 128: Possible spelling mistake found.
Context: ...ds. In general, the BeginBlocker and EndBlocker functions are mostly composed of the [...


Near line 128: Possible spelling mistake found.
Context: ...r functions are mostly composed of the [BeginBlockandEndBlock`](../../build/building-m...


Near line 128: Possible spelling mistake found.
Context: ...ostly composed of the [BeginBlock and EndBlock](../../build/building-modules/06-begin...


Near line 128: Possible spelling mistake found.
Context: ...'s modules. This is done by calling the BeginBlock and EndBlock functions of the module...


Near line 128: Possible spelling mistake found.
Context: ...is done by calling the BeginBlock and EndBlock functions of the module manager, which...


Near line 128: Possible spelling mistake found.
Context: ...module manager, which in turn calls the BeginBlock and EndBlock functions of each of th...


Near line 128: Possible spelling mistake found.
Context: ...hich in turn calls the BeginBlock and EndBlock functions of each of the modules it co...


Near line 128: Possible spelling mistake found.
Context: ...te that the order in which the modules' BeginBlock and EndBlock functions must be calle...


Near line 128: Possible spelling mistake found.
Context: ... in which the modules' BeginBlock and EndBlock functions must be called has to be set...


Near line 128: Possible spelling mistake found.
Context: ... be set in the module manager using the SetOrderBeginBlockers and SetOrderEndBlockers methods, res...


Near line 128: Possible spelling mistake found.
Context: ...r using the SetOrderBeginBlockers and SetOrderEndBlockers methods, respectively. This is done vi...


Near line 128: Possible spelling mistake found.
Context: ...ructor](#constructor-function), and the SetOrderBeginBlockers and SetOrderEndBlockers methods have...


Near line 128: Possible spelling mistake found.
Context: ...n), and the SetOrderBeginBlockers and SetOrderEndBlockers methods have to be called before the `...


Near line 128: Possible spelling mistake found.
Context: ...smethods have to be called before theSetBeginBlockerandSetEndBlocker` functions. As a s...


Near line 128: Possible spelling mistake found.
Context: ...called before the SetBeginBlocker and SetEndBlocker functions. As a sidenote, it is impor...


Near line 130: Possible spelling mistake found.
Context: ...ful not to introduce non-determinism in BeginBlocker or EndBlocker, and must also be care...


Near line 130: Possible spelling mistake found.
Context: ...ce non-determinism in BeginBlocker or EndBlocker, and must also be careful not to make ...


Near line 130: Possible spelling mistake found.
Context: ...fees.md) does not constrain the cost of BeginBlocker and EndBlocker execution. See an ex...


Near line 130: Possible spelling mistake found.
Context: ...onstrain the cost of BeginBlocker and EndBlocker execution. See an example of `BeginBl...


Near line 132: Possible spelling mistake found.
Context: ...dBlockerexecution. See an example ofBeginBlockerandEndBlockerfunctions fromsimap...


Near line 132: Possible spelling mistake found.
Context: .... See an example of BeginBlocker and EndBlocker functions from simapp ```go referen...


Near line 140: Possible spelling mistake found.
Context: ...#L613-L620 ``` ### Register Codec The EncodingConfig structure is the last important part o...


Near line 148: Loose punctuation mark.
Context: ...our fields means: * InterfaceRegistry: The InterfaceRegistry is used by the ...


Near line 148: Possible spelling mistake found.
Context: ...elds means: * InterfaceRegistry: The InterfaceRegistry is used by the Protobuf codec to handl...


Near line 148: Possible spelling mistake found.
Context: ... The InterfaceRegistry is used by the Protobuf codec to handle interfaces that are enc...


Near line 148: Add a space between sentences.
Context: ... decoded (we also say "unpacked") using [google.protobuf.Any](https://github.com/protocolbuffers/pr...


Near line 148: Possible spelling mistake found.
Context: ... be thought as a struct that contains a type_url (name of a concrete type implementing ...


Near line 148: Possible spelling mistake found.
Context: ...ace) and a value (its encoded bytes). InterfaceRegistry provides a mechanism for registering i...


Near line 148: Possible spelling mistake found.
Context: ... Each application module implements the RegisterInterfaces method that can be used to register th...


Near line 150: Possible spelling mistake found.
Context: ...osmos SDK uses an implementation of the Protobuf specification called [gogoprotobuf](h...


Near line 150: Possible spelling mistake found.
Context: ...on of the Protobuf specification called gogoprotobuf....


Near line 150: Possible spelling mistake found.
Context: ...com/cosmos/gogoproto). By default, the [gogo protobuf implementation of Any](https...


Near line 150: Possible spelling mistake found.
Context: ...osmos/gogoproto). By default, the [gogo protobuf implementation of Any](https://pkg.go...


Near line 150: Possible spelling mistake found.
Context: ...e could register a type with the global protobuf registry and cause it to be loaded and ...


Near line 150: Possible spelling mistake found.
Context: ... registry and cause it to be loaded and unmarshaled by a transaction that referenced it in ...


Near line 150: Possible spelling mistake found.
Context: ...a transaction that referenced it in the type_url field. For more information, please re...


Near line 151: Loose punctuation mark.
Context: ...9-protobuf-state-encoding.md). * Codec: The default codec used throughout the C...


Near line 151: Possible spelling mistake found.
Context: ...out the Cosmos SDK. It is composed of a BinaryCodec used to encode and decode state, and a...


Near line 151: Possible spelling mistake found.
Context: ... used to encode and decode state, and a JSONCodec used to output data to the users (for ...


Near line 151: Possible spelling mistake found.
Context: ... CLI). By default, the SDK uses Protobuf as Codec. * TxConfig: TxConfig de...


Near line 152: Loose punctuation mark.
Context: ...K uses Protobuf as Codec. * TxConfig: TxConfig defines an interface a clien...


Near line 152: Possible spelling mistake found.
Context: ...uses Protobuf as Codec. * TxConfig: TxConfig defines an interface a client can util...


Near line 152: Possible spelling mistake found.
Context: ...n types: SIGN_MODE_DIRECT (which uses Protobuf binary as over-the-wire encoding) and `...


Near line 153: Loose punctuation mark.
Context: .../advanced/01-transactions.md). * Amino: Some legacy parts of the Cosmos SDK sti...


Near line 153: Possible spelling mistake found.
Context: ...ds-compatibility. Each module exposes a RegisterLegacyAmino method to register the module's specif...


Near line 156: Add a space between sentences.
Context: ...wn encoding config. See an example of a simappparams.EncodingConfig from simapp: ```go reference https:...


Near line 156: Possible spelling mistake found.
Context: ...of a simappparams.EncodingConfig from simapp: ```go reference https://github.com/c...


Near line 164: Unpaired symbol: ‘[’ seems to be missing
Context: ...ing.go#L11-L16 ``` ## Modules [Modules](../../build/building-modules/00-intro.m...


Near line 164: Possible spelling mistake found.
Context: ...nsaction is relayed from the underlying CometBFT engine via the ABCI to the application,...


Near line 164: Possible spelling mistake found.
Context: ... the underlying CometBFT engine via the ABCI to the application, it is routed by [`b...


Near line 164: Possible spelling mistake found.
Context: ...BCI to the application, it is routed by baseapp to the app...


Near line 164: Consider a shorter alternative to avoid wordiness.
Context: ...0-baseapp.md) to the appropriate module in order to be processed. This paradigm enables dev...


Near line 168: Possible spelling mistake found.
Context: ...terfaces) defined in the Cosmos SDK and [AppModule](../../build/building-modules/01-modul...


Near line 168: Possible spelling mistake found.
Context: ...odules/01-module-manager.md#appmodule). AppModule handles the bulk of the module methods...


Near line 168: An accent character was used instead of an apostrophe.
Context: ...at require references to other modules' keepers). AppModule is, by convention, defin...


Near line 168: Possible spelling mistake found.
Context: ...ferences to other modules' keepers). AppModule is, by convention, defined in a file c...


Near line 170: This sentence does not start with an uppercase letter.
Context: ...a file called module.go. AppModule exposes a collection of useful methods on the m...


Near line 174: Possible spelling mistake found.
Context: ...s Each application module defines two [Protobuf services](https://developers.google.com...


Near line 175: Possible spelling mistake found.
Context: ...t of state transition RPC methods. Each Protobuf Msg service method is 1:1 related to ...


Near line 175: Possible spelling mistake found.
Context: ...Msgservice method is 1:1 related to a Protobuf request type, which must implementsdk...


Near line 175: Add a space between sentences.
Context: ...obuf request type, which must implement sdk.Msg interface. Note that sdk.Msgs are bu...


Near line 176: An accent character was used instead of an apostrophe.
Context: ...mplement sdk.Msg interface. Note that sdk.Msgs are bundled in [transactions](../advanc...


Near line 178: Possible spelling mistake found.
Context: ...nsactions is received by the full-node, CometBFT relays each one to the application via ...


Near line 178: Possible spelling mistake found.
Context: ... relays each one to the application via [DeliverTx](https://docs.cometbft.com/v0.37/spec/...


Near line 180: Possible spelling mistake found.
Context: ... the transaction, the application first unmarshalls it from []byte. 2. Then, it verifies ...


Near line 181: Possible spelling mistake found.
Context: ...saction like fee payment and signatures before extracting the Msg(s) contain...


Near line 182: This sentence does not start with an uppercase letter.
Context: ...ntained in the transaction. 3. sdk.Msgs are encoded using Protobuf [Anys](#re...


Near line 182: Possible spelling mistake found.
Context: ...action. 3. sdk.Msgs are encoded using Protobuf Anys. By analyzing...


Near line 182: An accent character was used instead of an apostrophe.
Context: .... sdk.Msgs are encoded using Protobuf Anys. By analyzing each `A...


Near line 182: Possible spelling mistake found.
Context: ...ister-codec). By analyzing each Any's type_url, baseapp's msgServiceRouter routes t...


Near line 182: Possible spelling mistake found.
Context: .... By analyzing each Any's type_url, baseapp's msgServiceRouter routes the `sdk.Ms...


Near line 182: Possible spelling mistake found.
Context: ...zing each Any's type_url, baseapp's msgServiceRouter routes the sdk.Msg to the correspond...


Near line 182: Add a space between sentences.
Context: ...baseapp's msgServiceRouter routes the sdk.Msg to the corresponding module's Msg se...


Near line 187: Possible spelling mistake found.
Context: ...general practice is to define the Msg Protobuf service in a tx.proto file. For examp...


Near line 187: Possible spelling mistake found.
Context: ... define the Msg Protobuf service in a tx.proto file. For example, the x/bank ...


Near line 193: Consider a shorter alternative to avoid wordiness.
Context: ...3-L36 ``` Service methods use keeper in order to update the module state. Each module s...


Near line 195: Possible spelling mistake found.
Context: ... Each module should also implement the RegisterServices method as part of the [AppModule int...


Near line 195: Possible spelling mistake found.
Context: ...RegisterServices method as part of the [AppModule` interface](#application-module-interfa...


Near line 195: Possible spelling mistake found.
Context: ...interface). This method should call the RegisterMsgServer function provided by the generated Pro...


Near line 195: Possible spelling mistake found.
Context: ...verfunction provided by the generated Protobuf code. ### gRPCQuery` Services gRPC ...


Near line 199: Possible spelling mistake found.
Context: ...efault, and can be configured under the grpc.enable and grpc.address fields insid...


Near line 199: Possible spelling mistake found.
Context: ... configured under the grpc.enable and grpc.address fields inside <!-- markdown-li...


Near line 199: Possible spelling mistake found.
Context: ...nableandgrpc.address fields inside <!-- markdown-link-check-disable-line -->[app.toml`](../../user/run-node/01-run-node.md#co...


Near line 201: Possible spelling mistake found.
Context: ...yservices are defined in the module's Protobuf definition files, specifically inside...


Near line 201: Possible spelling mistake found.
Context: ...finition file exposes a single Query [Protobuf service](https://developers.google.com/...


Near line 201: Possible spelling mistake found.
Context: ... to a service method, starting with the rpc keyword, inside the Query service. ...


Near line 202: Possible spelling mistake found.
Context: ...keyword, inside theQueryservice. Protobuf generates aQueryServer` interface for...


Near line 203: Possible spelling mistake found.
Context: ... Query service. Protobuf generates a QueryServer interface for each module, containing ...


Near line 203: Possible spelling mistake found.
Context: ...](#keeper) then needs to implement this QueryServer interface, by providing the concrete i...


Near line 205: Possible spelling mistake found.
Context: ..., each module should also implement the RegisterServices method as part of the [AppModule int...


Near line 205: Possible spelling mistake found.
Context: ...RegisterServices method as part of the [AppModule` interface](#application-module-interfa...


Near line 205: Possible spelling mistake found.
Context: ...interface). This method should call the RegisterQueryServer function provided by the generated Pro...


Near line 205: Possible spelling mistake found.
Context: ...ver function provided by the generated Protobuf code. ### Keeper [Keepers`](../../bu...


Near line 209: This sentence does not start with an uppercase letter.
Context: ...../build/building-modules/06-keeper.md) are the gatekeepers of their module's store...


Near line 211: This sentence does not start with an uppercase letter.
Context: ...s) to the module's store(s). Keepers are generally defined in a file called `kee...


Near line 215: Possible spelling mistake found.
Context: ...ey(s)** to the module's store(s) in the multistore. * Reference to **other module's `keepe...


Near line 216: The possessive apostrophe seems to be incorrect. Please remove the apostrophe if you want to use the plural form of ‘module’.
Context: ... the multistore. * Reference to other module's keepers. Only needed if the `keeper...


Near line 217: Possible spelling mistake found.
Context: ...shal structs before storing them, or to unmarshal them when it retrieves them, because st...


Near line 217: If the ‘because’ clause is essential to the meaning, do not use a comma before the clause.
Context: ...to unmarshal them when it retrieves them, because stores only accept []bytes as value. ...


Near line 219: Possible spelling mistake found.
Context: ...is the keeper's constructor function, NewKeeper. This function instantiates a new `kee...


Near line 219: An accent character was used instead of an apostrophe.
Context: ...d potentially references other modules' keepers as parameters. The NewKeeper function...


Near line 219: Possible spelling mistake found.
Context: ...r modules' keepers as parameters. The NewKeeper function is called from the [applicati...


Near line 227: Possible spelling mistake found.
Context: ...rally, the commands related to a module are defined in a folder called `client...


Near line 227: Possible spelling mistake found.
Context: ....md#cli) are defined in a folder called client/cli in the module's folder. The CLI divide...


Near line 227: Possible spelling mistake found.
Context: ...s, transactions and queries, defined in client/cli/tx.go and client/cli/query.go, respe...


Near line 227: Possible spelling mistake found.
Context: ...ries, defined in client/cli/tx.go and client/cli/query.go, respectively. Both commands ...


Near line 230: Possible spelling mistake found.
Context: ..., which routes them to the appropriate querier the queryRoute...


Near line 230: Possible spelling mistake found.
Context: ...ate querier the queryRoute parameter supplied. #### gRPC [gRPC]...


Near line 234: Unpaired symbol: ‘[’ seems to be missing
Context: ...e` parameter supplied. #### gRPC gRPC is a modern open-sourc...


Near line 236: Possible spelling mistake found.
Context: ...on), which are defined in the [module's Protobuf query.proto file](#grpc-query-service...


Near line 238: Possible spelling mistake found.
Context: ...llowing actions: * (Optional) Define a RegisterGRPCGatewayRoutes method on AppModule to wire the clie...


Near line 238: Possible spelling mistake found.
Context: ...a RegisterGRPCGatewayRoutes method on AppModule to wire the client gRPC requests to th...


Near line 239: Possible spelling mistake found.
Context: ...the gRPC request, and is located in the keeper/grpc_query.go file. #### gRPC-gateway REST...


Near line 241: This sentence does not start with an uppercase letter.
Context: ... the keeper/grpc_query.go file. #### gRPC-gateway REST Endpoints Some external clients m...


Near line 243: Possible spelling mistake found.
Context: ...ing REST endpoint. Please refer to the [grpc-gateway](https://grpc-ecosystem.github.io/grpc-...


Near line 245: Possible spelling mistake found.
Context: ... The REST endpoints are defined in the Protobuf files, along with the gRPC services, us...


Near line 245: Possible spelling mistake found.
Context: ...es, along with the gRPC services, using Protobuf annotations. Modules that want to expos...


Near line 245: Possible spelling mistake found.
Context: ... want to expose REST queries should add google.api.http annotations to their rpc method...


Near line 245: Possible spelling mistake found.
Context: ... google.api.http annotations to their rpc methods. By default, all REST endpoint...


Near line 247: Possible spelling mistake found.
Context: ...un-node/keyring) config file, under the api.swagger key. ## Application Interface...


Near line 251: Unpaired symbol: ‘[’ seems to be missing
Context: .... ## Application Interface [Interfaces](#command-line-grpc-services-and-rest-in...


Near line 253: Possible spelling mistake found.
Context: ...ication is the same as the daemon (e.g. appd), and is defined in a file called `app...


Near line 253: Possible spelling mistake found.
Context: ...appd), and is defined in a file called appd/main.go`. The file contains the followi...


Near line 255: Possible spelling mistake found.
Context: ...ction**, which is executed to build the appd interface client. This function prepar...


Near line 255: Possible spelling mistake found.
Context: ...pares each command and adds them to the rootCmd before building them. At the root of `...


Near line 255: Possible spelling mistake found.
Context: ...dbefore building them. At the root ofappd`, the function adds generic commands li...


Near line 255: Possible spelling mistake found.
Context: ..., keys, and config, query commands, tx commands, and rest-server. * **Query ...


Near line 256: Possible spelling mistake found.
Context: ...mands**, which are added by calling the queryCmd function. This function returns a Cobr...


Near line 256: Add a space between sentences.
Context: ...cation's modules (passed as an array of sdk.ModuleClients from the main() function), as well a...


Near line 256: Possible spelling mistake found.
Context: ...command are called by using the command appd query [query] of the CLI. * **Transact...


Near line 257: Possible spelling mistake found.
Context: ...mands**, which are added by calling the txCmd function. Similar to queryCmd, the f...


Near line 257: Possible spelling mistake found.
Context: ...alling the txCmd function. Similar to queryCmd, the function returns a Cobra command ...


Near line 257: Possible spelling mistake found.
Context: ...turns a Cobra command that contains the tx commands defined in each of the applica...


Near line 257: Possible spelling mistake found.
Context: ...ation's modules, as well as lower level tx commands like transaction signing or br...


Near line 257: Possible spelling mistake found.
Context: ...ke transaction signing or broadcasting. Tx commands are called by using the comman...


Near line 257: Possible spelling mistake found.
Context: ...ommands are called by using the command appd tx [tx] of the CLI. See an example of...


Near line 267: A punctuation mark might be missing here.
Context: ...sed framework for versioning control is [go.mod](https://github.com/golang/go/w...


Near line 275: Possible spelling mistake found.
Context: ...go.mod is run before building the two entrypoints to the application, [appd](#node-clie...


Near line 275: Possible spelling mistake found.
Context: ...the two entrypoints to the application, appd and [appd](#applicati...


Near line 275: Possible spelling mistake found.
Context: ...application, appd and appd. Here is an ...

docs/learn/beginner/03-accounts.md (107)

Near line 20: Possible spelling mistake found.
Context: ...ount_ designates a pair of public key PubKey and private key PrivKey. The `PubK...


Near line 20: Possible spelling mistake found.
Context: ...public key PubKey and private key PrivKey. The PubKey can be derived to genera...


Near line 20: Possible spelling mistake found.
Context: ...ubKeyand _private key_PrivKey. The PubKeycan be derived to generate variousAd...


Near line 20: An accent character was used instead of an apostrophe.
Context: ...n. Addresses are also associated with [messages](../../build/building-modules/02-messag...


Near line 20: Possible spelling mistake found.
Context: ...entify the sender of the message. The PrivKey is used to generate [digital signature...


Near line 20: Possible spelling mistake found.
Context: ...e that an Address associated with the PrivKey approved of a given message. For HD...


Near line 22: Possible missing comma found.
Context: ...roved of a given message. For HD key derivation the Cosmos SDK uses a standard called [...


Near line 22: Possible spelling mistake found.
Context: ... A single seed can derive any number of PrivKeys using a one-way cryptographic functio...


Near line 22: Possible spelling mistake found.
Context: ...one-way cryptographic function. Then, a PubKey can be derived from the PrivKey. Nat...


Near line 22: Possible spelling mistake found.
Context: ...hen, a PubKey can be derived from the PrivKey. Naturally, the mnemonic is the most s...


Near line 64: Possible spelling mistake found.
Context: ...and managed by using an object called a Keyring. ## Keys, accounts, addres...


Near line 74: Loose punctuation mark.
Context: ...ating digital signatures: * secp256k1, as implemented in the [Cosmos SDK's `cr...


Near line 75: Loose punctuation mark.
Context: ...s/secp256k1/secp256k1.go). * secp256r1, as implemented in the [Cosmos SDK's `cr...


Near line 75: Two consecutive commas
Context: ...lpha.0/crypto/keys/secp256r1/pubkey.go), * tm-ed25519, as implemented in the [Cosmos SDK `cryp...


Near line 78: Possible typo: you repeated a whitespace
Context: ...ed only for the consensus validation. | | Address length in bytes | Public key l...


Near line 78: Possible spelling mistake found.
Context: ...on authentication | Used for consensus (cometbft) | | :----------: | :------------------...


Near line 79: A punctuation mark might be missing here.
Context: ...------: | :-----------------------------: | | secp256k1 | 20 ...


Near line 80: Possible typo: you repeated a whitespace
Context: ...-----------------------: | | secp256k1 | 20 | ...


Near line 80: Possible typo: you repeated a whitespace
Context: ...--------------------: | | secp256k1 | 20 | 33 ...


Near line 80: Possible typo: you repeated a whitespace
Context: ...-------: | | secp256k1 | 20 | 33 | ...


Near line 80: Possible typo: you repeated a whitespace
Context: ...secp256k1 | 20 | 33 | yes ...


Near line 80: Possible typo: you repeated a whitespace
Context: ... 20 | 33 | yes | ...


Near line 80: Possible typo: you repeated a whitespace
Context: ... | 33 | yes | no ...


Near line 80: Possible typo: you repeated a whitespace
Context: ... 33 | yes | no | | `s...


Near line 80: Possible typo: you repeated a whitespace
Context: ... | yes | no | | secp256r1 | ...


Near line 80: Possible typo: you repeated a whitespace
Context: ... yes | no | | secp256r1 | 32 ...


Near line 81: Possible typo: you repeated a whitespace
Context: ... no | | secp256r1 | 32 | ...


Near line 81: Possible typo: you repeated a whitespace
Context: ... no | | secp256r1 | 32 | 33 ...


Near line 81: Possible typo: you repeated a whitespace
Context: ... | | secp256r1 | 32 | 33 | ...


Near line 81: Possible typo: you repeated a whitespace
Context: ...secp256r1 | 32 | 33 | yes ...


Near line 81: Possible typo: you repeated a whitespace
Context: ... 32 | 33 | yes | ...


Near line 81: Possible typo: you repeated a whitespace
Context: ... | 33 | yes | no ...


Near line 81: Possible typo: you repeated a whitespace
Context: ... 33 | yes | no | | `t...


Near line 81: Possible typo: you repeated a whitespace
Context: ... | yes | no | | tm-ed25519 | ...


Near line 81: Possible typo: you repeated a whitespace
Context: ... yes | no | | tm-ed25519 | -- not used -- ...


Near line 82: Possible typo: you repeated a whitespace
Context: ... no | | tm-ed25519 | -- not used -- | 32 ...


Near line 82: Possible typo: you repeated a whitespace
Context: ... | | tm-ed25519 | -- not used -- | 32 | ...


Near line 82: Possible typo: you repeated a whitespace
Context: ...tm-ed25519 | -- not used -- | 32 | no ...


Near line 82: Possible typo: you repeated a whitespace
Context: ... -- not used -- | 32 | no | ...


Near line 82: Possible typo: you repeated a whitespace
Context: ...d -- | 32 | no | yes ...


Near line 82: Possible typo: you repeated a whitespace
Context: ... 32 | no | yes | ## ...


Near line 82: Possible typo: you repeated a whitespace
Context: ... | no | yes | ## Addresses `Addr...


Near line 82: Possible typo: you repeated a whitespace
Context: ... no | yes | ## Addresses Addresses and `PubKey...


Near line 86: This sentence does not start with an uppercase letter.
Context: ... | ## Addresses Addresses and PubKeys are both public information t...


Near line 86: Possible spelling mistake found.
Context: ... | ## Addresses Addresses and PubKeys are both public information that iden...


Near line 86: Possible spelling mistake found.
Context: ...account implementation is provided by a BaseAccount object. Each account is identified us...


Near line 88: You might be missing the article “an” here.
Context: ...ject. Each account is identified using Address which is a sequence of bytes de...


Near line 90: This sentence does not start with an uppercase letter.
Context: ...ere an account is used: * AccAddress identifies users (the sender of a message). * `V...


Near line 91: This sentence does not start with an uppercase letter.
Context: ... sender of a message). * ValAddress identifies validator operators. * ConsAddress id...


Near line 92: This sentence does not start with an uppercase letter.
Context: ...es validator operators. * ConsAddress identifies validator nodes that are participating ...


Near line 107: Possible spelling mistake found.
Context: ...he address. Marshal() is required for Protobuf compatibility. For user interaction, a...


Near line 115: Possible typo: you repeated a whitespace
Context: ...lpha.0/types/address.go#L299-L316 ``` | | Address Bech32 Prefix | | ------------...


Near line 116: A punctuation mark might be missing here.
Context: ...--------------- | --------------------- | | Accounts | cosmos ...


Near line 117: Possible typo: you repeated a whitespace
Context: ...--- | --------------------- | | Accounts | cosmos | | Validator Op...


Near line 117: Possible typo: you repeated a whitespace
Context: ...-------- | | Accounts | cosmos | | Validator Operator | cosmosvaloper ...


Near line 118: Possible spelling mistake found.
Context: ... | | Validator Operator | cosmosvaloper | | Consensus Nodes | cosmos...


Near line 118: Possible typo: you repeated a whitespace
Context: ... | | Validator Operator | cosmosvaloper | | Consensus Nodes | cosmosvalcons ...


Near line 119: Possible typo: you repeated a whitespace
Context: ...osmosvaloper | | Consensus Nodes | cosmosvalcons | ### Public Ke...


Near line 119: Possible spelling mistake found.
Context: ...aloper | | Consensus Nodes | cosmosvalcons | ### Public Keys Public keys...


Near line 119: Possible typo: you repeated a whitespace
Context: ... | | Consensus Nodes | cosmosvalcons | ### Public Keys Public keys in Cosmo...


Near line 123: Add a space between sentences.
Context: ...ublic keys in Cosmos SDK are defined by cryptotypes.PubKey interface. Since public keys are saved...


Near line 123: Add a space between sentences.
Context: ...Since public keys are saved in a store, cryptotypes.PubKey extends the proto.Message interface:...


Near line 123: Add a space between sentences.
Context: ...store, cryptotypes.PubKey extends the proto.Message interface: ```go reference https://gi...


Near line 132: A comma may be missing after the conjunctive/linking adverb ‘Otherwise’.
Context: ...o associated with the x-coordinate. * Otherwise the first byte is a 0x03. This prefi...


Near line 136: Possible spelling mistake found.
Context: ...nsaction messages (with few exceptions: MsgCreateValidator, Validator and Multisig messages)....


Near line 136: Possible spelling mistake found.
Context: ...: MsgCreateValidator, Validator and Multisig messages). For user interactions, `Pub...


Near line 137: Possible spelling mistake found.
Context: ...isigmessages). For user interactions,PubKey` is formatted using Protobufs JSON ([Pr...


Near line 137: Possible spelling mistake found.
Context: ...teractions, PubKey is formatted using Protobufs JSON ([ProtoMarshalJSON](https://github...


Near line 137: Possible spelling mistake found.
Context: ...ey` is formatted using Protobufs JSON ([ProtoMarshalJSON](https://github.com/cosmos/cosmos-sdk/b...


Near line 143: Possible spelling mistake found.
Context: ...0/client/keys/output.go#L23-L39 ``` ## Keyring A Keyring is an object that stores a...


Near line 145: Possible spelling mistake found.
Context: ...ys/output.go#L23-L39 ``` ## Keyring A Keyring is an object that stores and manages a...


Near line 145: Possible spelling mistake found.
Context: ... manages accounts. In the Cosmos SDK, a Keyring implementation follows the Keyring i...


Near line 145: Possible spelling mistake found.
Context: ... a Keyring implementation follows the Keyring interface: ```go reference https://gi...


Near line 151: Possible spelling mistake found.
Context: ...L105 ``` The default implementation of Keyring comes from the third-party [`99designs...


Near line 151: It appears that a space is missing between the number and word (or unit).
Context: ...of Keyring comes from the third-party [99designs/keyring](https://github.com/99designs/...


Near line 153: Possible spelling mistake found.
Context: ...s/keyring) library. A few notes on the Keyring methods: * `Sign(uid string, msg []by...


Near line 155: This sentence does not start with an uppercase letter.
Context: ... []byte) ([]byte, types.PubKey, error)strictly deals with the signature of themsg` b...


Near line 155: Possible spelling mistake found.
Context: ...into a canonical []byte form. Because protobuf is not deterministic, it has been decid...


Near line 155: Possible spelling mistake found.
Context: ... the canonical payload to sign is the SignDoc struct, deterministically encoded usin...


Near line 155: Possible spelling mistake found.
Context: ...s SDK by default, it is deferred to the [anteHandler](../advanced/00-baseapp.md#antehandler...


Near line 161: This sentence does not start with an uppercase letter.
Context: ..., algo SignatureAlgo) (*Record, error) creates a new account based on the [bip44 path...


Near line 161: Possible spelling mistake found.
Context: ...mediawiki) and persists it on disk. The PrivKey is never stored unencrypted, inste...


Near line 161: Possible spelling mistake found.
Context: ... mnemonic and derivation path, the same PrivKey, PubKey and Address is generated. ...


Near line 161: Possible spelling mistake found.
Context: ...nd derivation path, the same PrivKey, PubKey and Address is generated. The follow...


Near line 161: Possible spelling mistake found.
Context: ...The following keys are supported by the keyring: * secp256k1 * ed25519 * `ExportP...


Near line 166: This sentence does not start with an uppercase letter.
Context: ...rase string) (armor string, err error)` exports a private key in ASCII-armored encrypte...


Near line 166: Possible spelling mistake found.
Context: ...r import the private key again into the keyring using the `ImportPrivKey(uid, armor, pa...


Near line 170: Possible spelling mistake found.
Context: ... To create a new key type for using in keyring, keyring.SignatureAlgo interface must...


Near line 170: Add a space between sentences.
Context: ...te a new key type for using in keyring, keyring.SignatureAlgo interface must be fulfilled. ```go re...


Near line 176: The preposition ‘of’ seems more likely in this position.
Context: ....go#L10-L15 ``` The interface consists in three methods where Name() returns th...


Near line 176: Possible missing comma found.
Context: ...15 ``` The interface consists in three methods where Name() returns the name of the ...


Near line 176: Only proper nouns start with an uppercase character (there are exceptions for headlines).
Context: ...terface consists in three methods where Name() returns the name of the algorithm as...


Near line 176: Add a space between sentences.
Context: ... returns the name of the algorithm as a hd.PubKeyType and Derive() and Generate() must r...


Near line 182: Add a space between sentences.
Context: ...crypto/hd/algo.go#L28-L31 ``` Once the keyring.SignatureAlgo has been implemented it must be added ...


Near line 182: Possible spelling mistake found.
Context: ...must be added to the [list of supported algos](https://github.com/cosmos/cosmos-sdk/b...


Near line 182: Possible spelling mistake found.
Context: .../crypto/keyring/keyring.go#L217) of the keyring. For simplicity the implementation of ...


Near line 184: A comma might be missing here.
Context: ...g/keyring.go#L217) of the keyring. For simplicity the implementation of a new key type sh...


Near line 184: Possible spelling mistake found.
Context: ... new key type should be done inside the crypto/hd package. There is an example of a work...


Near line 188: Possible spelling mistake found.
Context: ....go#L38). #### Implementing secp256r1 algo Here is an example of how secp256r1 co...


Near line 191: A comma might be missing here.
Context: ...of how secp256r1 could be implemented. First a new function to create a private key ...


Near line 209: Possible missing comma found.
Context: ...rivKey{&ecdsaSK{*sk}}, nil } ``` After that secp256r1Algo can be implemented. ``...


Near line 264: Possible spelling mistake found.
Context: ... } return key } } ``` Finally, the algo must be added to the list of [supported...


Near line 264: Possible spelling mistake found.
Context: ...must be added to the list of [supported algos](https://github.com/cosmos/cosmos-sdk/b...


Near line 264: Possible spelling mistake found.
Context: .../crypto/keyring/keyring.go#L217) by the keyring. ```go // cosmos-sdk/crypto/keyring/ke...


Near line 278: Possible missing comma found.
Context: ...ningAlgoList{hd.Secp256k1}, } ... ``` Hereafter to create new keys using your algo, you...


Near line 279: Possible spelling mistake found.
Context: ...Hereafter to create new keys using your algo, you must specify it with the flag `--a...


Near line 279: Possible spelling mistake found.
Context: ...algo, you must specify it with the flag --algo : `simd keys add myKey --algo secp256...

Path-based Instructions (3)
docs/learn/advanced/01-transactions.md (1)

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

docs/learn/beginner/03-accounts.md (1)

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

docs/learn/beginner/00-app-anatomy.md (1)

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

Additional comments not posted (3)
docs/learn/beginner/03-accounts.md (2)

155-155: Ensure the updated link to the ADR-020 and ADR-027 documents is correct and accessible.


Line range hint 145-145: Ensure the description of the Keyring interface is clear and accurate.

docs/learn/beginner/00-app-anatomy.md (1)

149-150: Update the links to ADR-019 and gogoprotobuf implementation details.

Ensure the updated links are correctly pointing to the intended resources. This is crucial for maintaining the accuracy and usability of the documentation.


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

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 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.
  • Please see the configuration documentation 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 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.

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: 2

Out of diff range and nitpick comments (6)
docs/learn/beginner/03-accounts.md (3)

Line range hint 20-22: Consider adding a comma after "For HD key derivation" for better readability.

- For HD key derivation the Cosmos SDK uses a standard called [BIP32](https://github.com/bitcoin/bips/blob/master/bip-0032.mediawiki).
+ For HD key derivation, the Cosmos SDK uses a standard called [BIP32](https://github.com/bitcoin/bips/blob/master/bip-0032.mediawiki).

Line range hint 74-75: Remove the extra comma before "as implemented in the Cosmos SDK's crypto/keys/secp256r1 package".

- * `secp256r1`, as implemented in the [Cosmos SDK's `crypto/keys/secp256r1` package](https://github.com/cosmos/cosmos-sdk/blob/v0.50.0-alpha.0/crypto/keys/secp256r1/pubkey.go),
+ * `secp256r1` as implemented in the [Cosmos SDK's `crypto/keys/secp256r1` package](https://github.com/cosmos/cosmos-sdk/blob/v0.50.0-alpha.0/crypto/keys/secp256r1/pubkey.go)

Line range hint 86-86: Start the sentence with an uppercase letter for consistency.

- `Addresses` and `PubKey`s are both public information that identifies actors in the application.
+ `Addresses` and `PubKey`s are both public information that identify actors in the application.
docs/learn/beginner/00-app-anatomy.md (3)

Line range hint 55-55: Use the correct form of possessive plural.

- **A list of module's `keeper`s.**
+ **A list of modules' `keeper`s.**

Line range hint 84-87: Correct the indentation of unordered list items.

-    * [`PreBlocker`](#preblocker): called before BeginBlock.
-    * [`BeginBlocker`, `EndBlocker`](#beginblocker-and-endblocker): called at the beginning and at the end of every block.
-    * [`anteHandler`](../advanced/00-baseapp.md#antehandler): used to handle fees and signature verification.
+  * [`PreBlocker`](#preblocker): called before BeginBlock.
+  * [`BeginBlocker`, `EndBlocker`](#beginblocker-and-endblocker): called at the beginning and at the end of every block.
+  * [`anteHandler`](../advanced/00-baseapp.md#antehandler): used to handle fees and signature verification.

Line range hint 115-116: Use consistent list markers in Markdown.

- - It runs before the `BeginBlocker` of all modules
- - It can modify consensus parameters in storage, and signal the caller through the return value.
+ * It runs before the `BeginBlocker` of all modules
+ * It can modify consensus parameters in storage, and signal the caller through the return value.

@@ -51,7 +51,7 @@ The most used implementation of the `Tx` interface is the Protobuf `Tx` message,
https://github.com/cosmos/cosmos-sdk/blob/v0.50.0-alpha.0/proto/cosmos/tx/v1beta1/tx.proto#L13-L26
```

Because Protobuf serialization is not deterministic, the Cosmos SDK uses an additional `TxRaw` type to denote the pinned bytes over which a transaction is signed. Any user can generate a valid `body` and `auth_info` for a transaction, and serialize these two messages using Protobuf. `TxRaw` then pins the user's exact binary representation of `body` and `auth_info`, called respectively `body_bytes` and `auth_info_bytes`. The document that is signed by all signers of the transaction is `SignDoc` (deterministically serialized using [ADR-027](../../build/architecture/adr-027-deterministic-protobuf-serialization.md)):
Because Protobuf serialization is not deterministic, the Cosmos SDK uses an additional `TxRaw` type to denote the pinned bytes over which a transaction is signed. Any user can generate a valid `body` and `auth_info` for a transaction, and serialize these two messages using Protobuf. `TxRaw` then pins the user's exact binary representation of `body` and `auth_info`, called respectively `body_bytes` and `auth_info_bytes`. The document that is signed by all signers of the transaction is `SignDoc` (deterministically serialized using [ADR-027](../../architecture/adr-027-deterministic-protobuf-serialization.md)):
Copy link
Contributor

Choose a reason for hiding this comment

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

Update the link to ADR-027 to reflect the new directory structure.

@@ -100,7 +100,7 @@

Data is formatted using a set of `ValueRenderer` which the SDK provides defaults for all the known messages and value types. Chain developers can also opt to implement their own `ValueRenderer` for a type/message if they'd like to display information differently.

If you wish to learn more, please refer to [ADR-050](../../build/architecture/adr-050-sign-mode-textual.md).
If you wish to learn more, please refer to [ADR-050](../../architecture/adr-050-sign-mode-textual.md).
Copy link
Contributor

Choose a reason for hiding this comment

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

Ensure the link to ADR-050 is updated to reflect the new directory structure.

@tac0turtle tac0turtle added this pull request to the merge queue Apr 24, 2024
Merged via the queue into cosmos:main with commit d94b15b Apr 24, 2024
58 checks passed
@goofylfg goofylfg mentioned this pull request Apr 26, 2024
12 tasks
meetrick pushed a commit to meetrick/cosmos-sdk that referenced this pull request Apr 29, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants