Go to file
Ivan Gavran 9f543b1c3b
refactor: Small clarifications to authz docs and one error description (#11506)
## Description

This small PR is trying to clarify the documentation that I found ambiguous when reading it.
Furthermore, it makes one error message more precise ("non-negative" --> "positive").

In particular:
 - I clarified that the field `AcceptResponse.Accept` will be set to `true` when an authorization is accepted, but **will not** be set to `false` otherwise (instead, the function `Accept` will return an error).
 - I clarified that the field `AcceptResponse.Updated` will not always be populated: it will be `nil` unless there are real changes to the authorization
 - I changed the error message in the `send_authorization.go` function, when `IsAllPositive()` returns `false` from _spend limit cannot be negitive_ to _spend limit must be positive_. I emphasized the fact that spend limit must be positive in the documentation.

This is my first contribution to the Cosmos-SDK codebase so if I made some mistake the process (wrt the checklist), guide me patiently, pls.



---

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

- [x] included the correct [type prefix](https://github.com/commitizen/conventional-commit-types/blob/v3.0.0/index.json) in the PR title
- [x] added `!` to the type prefix if API or client breaking change
- [x] targeted the correct branch (see [PR Targeting](https://github.com/cosmos/cosmos-sdk/blob/master/CONTRIBUTING.md#pr-targeting))
- [ ] provided a link to the relevant issue or specification: NOTE: does not apply, these are clarification changes
- [ ] followed the guidelines for [building modules](https://github.com/cosmos/cosmos-sdk/blob/master/docs/building-modules): NOTE: does not apply, these are clarification changes
- [ ] included the necessary unit and integration [tests](https://github.com/cosmos/cosmos-sdk/blob/master/CONTRIBUTING.md#testing): NOTE: does not apply, these are clarification changes
- [ ] added a changelog entry to `CHANGELOG.md`: NOTE: does not apply, these are clarification changes
- [ ] included comments for [documenting Go code](https://blog.golang.org/godoc) NOTE: does not apply, these are clarification changes
- [x] updated the relevant documentation or specification
- [x] reviewed "Files changed" and left comments if necessary
- [ ] 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](https://github.com/commitizen/conventional-commit-types/blob/v3.0.0/index.json) in the PR title
- [ ] confirmed `!` in the type prefix if API or client breaking change
- [ ] 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
- [ ] manually tested (if applicable)
2022-04-03 09:50:51 +00:00
.github chore: Add mergify backport to v0.46.x (#11501) 2022-03-30 14:49:57 +02:00
api feat!: add 'amount' field to withdrawal responses #11457 2022-03-28 14:31:47 -04:00
baseapp fix: RegisterLegacyAminoCodec should error if Msg name is >39 chars (#11349) 2022-03-16 13:21:00 +00:00
client fix: dockerfile for building proto (#11452) 2022-03-25 12:35:09 +00:00
codec fix: RegisterLegacyAminoCodec should error if Msg name is >39 chars (#11349) 2022-03-16 13:21:00 +00:00
container build(deps): Bump github.com/stretchr/testify in /container (#11400) 2022-03-19 11:47:11 +01:00
contrib chore: use canonical name for dockerfile (#11485) 2022-03-29 17:55:34 +00:00
cosmovisor build(deps): Bump github.com/stretchr/testify from 1.7.0 to 1.7.1 in /cosmovisor (#11398) 2022-03-19 22:37:12 +00:00
crypto feat: get keyring backend (#11484) 2022-03-29 13:14:59 +00:00
db build(deps): Bump github.com/stretchr/testify from 1.7.0 to 1.7.1 in /db (#11397) 2022-03-19 23:09:41 +00:00
docs refactor: Small clarifications to authz docs and one error description (#11506) 2022-04-03 09:50:51 +00:00
errors fix(errors): support wrapped errors with gRPC codes (#11385) 2022-03-16 13:59:49 +00:00
internal feat: ADR-040: Add RootStore implementation (#10430) 2021-12-16 13:09:57 +00:00
orm feat(orm): allow bytes keys longer than 255 bytes (#11522) 2022-04-01 18:01:11 +00:00
proto feat!: add 'amount' field to withdrawal responses #11457 2022-03-28 14:31:47 -04:00
scripts fix: Protobuf docker (#11472) 2022-03-26 23:38:32 +01:00
server feat: api server flags to start command (#11511) 2022-04-01 07:40:48 +00:00
simapp revert: Revert "feat: staking config (#10988)" (#11446) 2022-03-24 12:26:25 +01:00
snapshots feat: ADR-040: add state sync for v2 store (#10794) 2022-03-04 06:05:23 +00:00
std fix: register evidence regression (#10595) 2021-12-14 14:25:31 +00:00
store feat: state migration from IAVL to SMT (ADR-040) (#10962) 2022-03-20 03:17:23 +00:00
telemetry refactor!: Keyring migration (#9695) 2021-09-20 12:02:15 +00:00
tests feat: ADR-040: Add RootStore implementation (#10430) 2021-12-16 13:09:57 +00:00
testutil refactor(x/auth/middleware)!: tx middleware to support pluggable feemarket module (#11413) 2022-03-29 14:46:56 +00:00
third_party/proto feat: full api module building alongside gogo proto files with buf schema registry support (#10669) 2022-01-06 14:57:55 -05:00
types refactor(x/auth/middleware)!: tx middleware to support pluggable feemarket module (#11413) 2022-03-29 14:46:56 +00:00
version refactor: Implementing sigs.k8s.io YAML to remove .proto yaml annotations (#9780) 2021-09-24 14:37:34 +00:00
x refactor: Small clarifications to authz docs and one error description (#11506) 2022-04-03 09:50:51 +00:00
.build.sh fix library file path (#8301) 2021-01-12 10:08:42 +00:00
.clang-format Fix clang-format to specific version (#7350) 2020-10-27 10:04:34 +00:00
.codecov.yml CI: Fix codecov flag project config (#7994) 2020-11-20 09:13:25 -05:00
.deepsource.toml chore: refactor code quality issues (#8932) 2021-03-22 09:30:27 +00:00
.dockerignore Add basic Dockerfile to build all binaries and export gaiad 2018-04-10 12:39:47 +02:00
.gitattributes Merge PR #6426: Migrate API Server 2020-06-15 13:39:09 -04:00
.gitignore feat: standalone errors go.mod (#10779) 2021-12-17 21:53:08 +00:00
.golangci.yml chore: bump TM to v0.35.0 release candidate (#10210) 2021-11-16 11:24:38 -08:00
.goreleaser.yml ci: automate release post tag push (#6230) 2020-05-25 20:02:08 +02:00
.markdownlint.json docs: Code blocks in SDK docs are broken (#11189) 2022-02-14 23:39:35 +01:00
.markdownlintignore docs: Improve markdownlint configuration (#11104) 2022-02-10 12:07:01 +00:00
.mergify.yml chore: Add mergify backport to v0.46.x (#11501) 2022-03-30 14:49:57 +02:00
buf.work.yaml feat: full api module building alongside gogo proto files with buf schema registry support (#10669) 2022-01-06 14:57:55 -05:00
CHANGELOG.md feat: api server flags to start command (#11511) 2022-04-01 07:40:48 +00:00
CODE_OF_CONDUCT.md Update CODE_OF_CONDUCT.md (#7381) 2020-09-28 11:28:30 +02:00
CODING_GUIDELINES.md docs: Improve markdownlint configuration (#11104) 2022-02-10 12:07:01 +00:00
CONTRIBUTING.md docs: Code blocks in SDK docs are broken (#11189) 2022-02-14 23:39:35 +01:00
docker-compose.yml build: add remote debugging with delve (#10587) 2021-12-01 12:44:54 +00:00
Dockerfile build: Update Dockerfile (#9839) 2021-08-03 09:46:16 -04:00
go.mod build(deps): Bump github.com/prometheus/common from 0.32.1 to 0.33.0 (#11493) 2022-03-31 05:20:14 +00:00
go.sum build(deps): Bump github.com/prometheus/common from 0.32.1 to 0.33.0 (#11493) 2022-03-31 05:20:14 +00:00
LICENSE docs: 10180 Fix SDK (#10237) 2021-09-28 19:33:58 +02:00
Makefile fix: Protobuf docker (#11472) 2022-03-26 23:38:32 +01:00
README.md docs: Fix the broken links in the documents (#11477) 2022-03-30 07:29:35 +00:00
RELEASE_PROCESS.md docs: Improve markdownlint configuration (#11104) 2022-02-10 12:07:01 +00:00
SECURITY.md fix: Broken HackerOne program link #11481 2022-03-28 17:24:25 -04:00

Cosmos SDK

banner

The Cosmos SDK is a framework for building blockchain applications. Tendermint Core (BFT Consensus) and the Cosmos SDK are written in the Golang programming language. Cosmos SDK is used to build Gaia, the first implementation of the Cosmos Hub.

WARNING: The Cosmos SDK has mostly stabilized, but we are still making some breaking changes.

Note: Requires Go 1.17+

Quick Start

To learn how the Cosmos SDK works from a high-level perspective, see the Cosmos SDK High-Level Intro.

If you want to get started quickly and learn how to build on top of Cosmos SDK, visit Cosmos SDK Tutorials. You can also fork the tutorial's repository to get started building your own Cosmos SDK application.

For more information, see the Cosmos SDK Documentation.

Contributing

See CONTRIBUTING.md for details how to contribute and participate in our dev calls. If you want to follow the updates or learn more about the latest design then join our Discord.

Tools and Frameworks

The Cosmos ecosystem is vast. We will only make a few notable mentions here.

  • Tools: notable frameworks and modules.
  • CosmJS: the Swiss Army knife to power JavaScript based client solutions.

Cosmos Hub Mainnet

The Cosmos Hub application, gaia, has moved to its own cosmos/gaia repository. Go there to join the Cosmos Hub mainnet and more.

Inter-Blockchain Communication (IBC)

The IBC module for the Cosmos SDK has moved to its own cosmos/ibc-go repository. Go there to build and integrate with the IBC module.

Starport

Starport is the all-in-one platform to build, launch, and maintain any crypto application on a sovereign and secured blockchain. If you are building a new app or a new module, use Starport to get started and speed up development.

Disambiguation

This Cosmos SDK project is not related to the React-Cosmos project (yet). Many thanks to Evan Coury and Ovidiu (@skidding) for this Github organization name. As per our agreement, this disambiguation notice will stay here.