cosmos-sdk/docs/core
atheeshp d97e7907f1
Add fee grant module (#8061)
* Add docs

* Add BasicFeeAllowance implementation

* Add expiration structs and complete basic fee

* Add delegation messages, add validation logic

* Add keeper and helper structs

* Add alias and handler to top level

* Add delegation module

* Add basic querier

* Add types tests

* Add types tests

* More internal test coverage

* Solid internal test coverage

* Expose Querier to top level module

* Add FeeAccount to auth/types, like StdTx, SignDoc

* Fix all tests in x/auth

* All tests pass

* Appease the Golang Linter

* Add fee-account command line flag

* Start on DelegatedDeductFeeDecorator

* Cleanup the Decorator

* Wire up delegation module in simapp

* add basic test for decorator (no delegation)

* Table tests for deduct fees

* Table tests over all conditions of delegated fee decorator

* Build full ante handler stack and test it

* Start genesis

* Implement Genesis

* Rename package delegation to subkeys

* Clarify antes test cases, handle empty account w/o fees

* Allow paying delegated fees with no account

* Pull mempool into delegated ante, for control on StdFee

* Use custom DelegatedTx, DelegatedFee for subkeys

* Revert all changes to x/auth.StdTx

* Appease scopelint

* Register DelegatedTx with codec

* Address PR comments

* Remove unnecessary DelegatedMempoolFeeDecorator

* Cleaned up errors in querier

* Clean up message sign bytes

* Minor PR comments

* Replace GetAllFees... with Iterator variants

* PrepareForExport adjusts grant expiration height

* Panic on de/serialization error in keeper

* Move custom ante handler chain to tests, update docs

* More cleanup

* More doc cleanup

* Renamed subkeys module to fee_grant

* Rename subkeys/delegation to fee grant in all strings

* Modify Msg and Keeper methods to use Grant not Delegate

* Add PeriodicFeeAllowance

* Update aliases

* Cover all accept cases for PeriodicFeeAllowance

* Et tu scopelint?

* Update docs as requested

* Remove error return from GetFeeGrant

* Code cleanup as requested by PR

* Updated all errors to use new sdk/errors package

* Use test suite for keeper tests

* Clean up alias.go file

* Define expected interfaces in exported, rather than importing from account

* Remove dependency on auth/ante

* Improve godoc, Logger

* Cleaned up ExpiresAt

* Improve error reporting with UseGrantedFee

* Enforce period limit subset of basic limit

* Add events

* Rename fee_grant to feegrant

* Ensure KeeperTestSuite actually runs

* Move types/tx to types

* Update alias file, include ante

* I do need nolint in alias.go

* Properly emit events in the handler. Use cosmos-sdk in amino types

* Update godoc

* Linting...

* Update errors

* Update pkg doc and fix ante-handler order

* Merge PR #5782: Migrate x/feegrant to proto

* fix errors

* proto changes

* proto changes

* fix errors

* fix errors

* genesis state changed to proto

* fix keeper tests

* fix test

* fixed tests

* fix tests

* updated expected keepers

* updated ante tests

* lint

* deleted alias.go

* tx updated to proto tx

* remove explicit signmode

* tests

* Added `cli/query.go`

* Added tx.go in cli

* updated `module.go`

* resolve errors in tx.go

* Add fee payer gentx func

* updated tx

* fixed error

* WIP: cli tests

* fix query error

* fix tests

* Unused types and funcs

* fix tests

* rename helper func to create tx

* remove unused

* update tx cfg

* fix cli tests

* added simulations

* Add `decoder.go`

* fix build fail

* added init genesis code

* update tx.go

* fixed LGTM alert

* modified cli

* remove gogoproto extensions

* change acc address type to string

* lint

* fix simulations

* Add gen simulations

* remove legacy querier

* remove legacy code

* add grpc queries tests

* fix simulations

* update module.go

* lint

* register feegrant NewSimulationManager

* fix sims

* fix sims

* add genesis test

* add periodic grant

* updated cmd

* changed times

* updated flags

* removed days as period clock

* added condition for period and exp

* add periodic fee cli tests

* udpated tests

* fix lint

* fix tests

* fix sims

* renaming to `fee_grant`

* review changes

* fix test

* add condition for duplicate grants

* fix tests

* add `genTxWithFeeGranter` in tests

* fix simulation

* one of changes & test fixes

* fix test

* fix lint

* changed package name `feegrant` to `fee_grant`

* review comments

* review changes

* review change

* review changes

* added fee-account in flags

* address review changes

* read fee granter from cli

* updated create account with mnemonic

* Address review comments

* move `simapp/ante` file to `feegrant/ante`

* update keeper logic to create account

* update docs

* fix tests

* update `serviceMsgClientConn` from `msgservice`

* review changes

* add test case for using more fees than allowed

* eliminate panic checks from keeper

* fix lint

* change store keys string to bytes

* fix tests

* review changes

* review changes

* udpate docs

* make spend limit optional

* fix tests

* fix tests

* review changes

* add norace tag

* proto-docs

* add docs

Co-authored-by: Ethan Frey <ethanfrey@users.noreply.github.com>
Co-authored-by: Alexander Bezobchuk <alexanderbez@users.noreply.github.com>
Co-authored-by: Aleksandr Bezobchuk <aleks.bezobchuk@gmail.com>
Co-authored-by: SaReN <sahithnarahari@gmail.com>
Co-authored-by: aleem1413 <aleem@vitwit.com>
Co-authored-by: MD Aleem <72057206+aleem1314@users.noreply.github.com>
Co-authored-by: Anil Kumar Kammari <anil@vitwit.com>
Co-authored-by: mergify[bot] <37929162+mergify[bot]@users.noreply.github.com>
2021-01-29 19:54:51 +00:00
..
baseapp_state_types.png Merge PR #4748: Write-Through Inter-Block Cache 2019-09-04 13:33:32 -04:00
baseapp_state-begin_block.png Merge PR #4748: Write-Through Inter-Block Cache 2019-09-04 13:33:32 -04:00
baseapp_state-checktx.png Merge PR #4748: Write-Through Inter-Block Cache 2019-09-04 13:33:32 -04:00
baseapp_state-commit.png Merge PR #4748: Write-Through Inter-Block Cache 2019-09-04 13:33:32 -04:00
baseapp_state-deliver_tx.png Merge PR #4748: Write-Through Inter-Block Cache 2019-09-04 13:33:32 -04:00
baseapp_state-initchain.png Merge PR #4748: Write-Through Inter-Block Cache 2019-09-04 13:33:32 -04:00
baseapp.md docs: cache-wrapping and virtual store (#8102) 2021-01-05 15:57:33 +00:00
cli.md fix: bind values from env variables to flags (#8337) 2021-01-29 01:58:44 +00:00
context.md docs: cache-wrapping and virtual store (#8102) 2021-01-05 15:57:33 +00:00
encoding.md docs: Add grpc & rest endpoints overview (#8064) 2020-12-14 10:51:32 +00:00
events.md docs: Remove deprecated "Interfaces" section (#8294) 2021-01-18 00:11:26 +00:00
grpc_rest.md docs: Remove deprecated "Interfaces" section (#8294) 2021-01-18 00:11:26 +00:00
node.md docs: Add grpc & rest endpoints overview (#8064) 2020-12-14 10:51:32 +00:00
ocap.md docs: Remove deprecated "Interfaces" section (#8294) 2021-01-18 00:11:26 +00:00
proto-docs.md Add fee grant module (#8061) 2021-01-29 19:54:51 +00:00
README.md docs: Remove deprecated "Interfaces" section (#8294) 2021-01-18 00:11:26 +00:00
runtx_middleware.md docs: Remove deprecated "Interfaces" section (#8294) 2021-01-18 00:11:26 +00:00
simulation.md docs: Remove deprecated "Interfaces" section (#8294) 2021-01-18 00:11:26 +00:00
store.md [docs]: Stargate migration guides (#7771) 2021-01-06 11:43:52 +00:00
telemetry.md docs: Remove deprecated "Interfaces" section (#8294) 2021-01-18 00:11:26 +00:00
transactions.md Create docs for signing & broadcasting txs (#8257) 2021-01-07 16:21:50 +00:00

Core Concepts

This repository contains reference documentation on the core concepts of the Cosmos SDK.

  1. BaseApp
  2. Transaction
  3. Context
  4. Node Client
  5. Store
  6. Encoding
  7. gRPC, REST and Tendermint Endpoints
  8. Command-Line Interface
  9. Events
  10. Telemetry
  11. Object-Capabilities
  12. RunTx recovery middleware
  13. Simulation
  14. Protobuf documentation

After reading about the core concepts, check the IBC documentation to learn more about the IBC core concepts and how to integrate it to you application.