Safrochain modules overview
This reference lists every application module registered in app/modules.go. Use it to find the right doc page and the matching safrochaind query / safrochaind tx command tree.
CLI conventions
- Discover commands: run
safrochaind query <module> --helporsafrochaind tx <module> --help. Subcommands, positional arguments, and flags are shown there (they match the chain binary you built or installed). - Node RPC:
--node tcp://HOST:26657(override defaultlocalhost). - Chain ID:
--chain-id <id>on transactions. - Output:
-o jsonfor machine-readable output on queries. - Signing (transactions):
--from <key_or_address>: signer.--fees <coins>or--gas auto --gas-adjustment 1.3(and often--gas-prices): fee payment.-y: skip confirmation prompt.--dry-run: simulate without broadcasting.--generate-only: build an unsigned tx (for multisig, hardware wallets, or offline signing).
See also the CLI overview for cross-cutting patterns.
Module index
Safrochain extensions
| Module | CLI (query / tx) | Documentation |
|---|---|---|
| Token factory (factory denoms) | tokenfactory | Token factory |
| Global fee (minimum gas prices) | globalfee | Global fee |
| FeePay (sponsored contract fees) | feepay | FeePay |
| FeeShare (contract fee routing) | feeshare | FeeShare |
| Drip (staker distribution) | drip | Drip |
| Clock (scheduled CosmWasm ticks) | clock | Clock |
| CW Hooks (staking/gov contract hooks) | cw-hooks | CW Hooks |
Cosmos SDK (standard modules)
| Module | CLI | Documentation |
|---|---|---|
| Auth (accounts, sequence) | auth | Auth |
| Bank (balances, supply) | bank | Bank |
| Staking | staking | Staking |
| Slashing | slashing | Slashing |
| Distribution (rewards, commission) | distribution | Distribution |
| Governance | gov | Governance |
| Mint | mint | Mint |
| Evidence | evidence | Evidence |
| Fee grant | feegrant | Fee grant |
| Authz (generic authorizations) | authz | Authz |
| NFT | nft | NFT |
| Consensus params | consensus | Consensus |
| Legacy params | params | Params |
| Upgrade | upgrade | Upgrade |
| Crisis (invariant checks) | crisis (tx only) | Crisis |
| Vesting | vesting (tx only) | Vesting |
genutil is used at chain initialization (init, gentx, collect-gentxs), not as a runtime query module. See Run a node.
IBC and related apps
| Module | CLI | Documentation |
|---|---|---|
| IBC core (clients, connections, channels) | ibc | IBC core |
| ICS-20 transfer | ibc-transfer | ICS-20 transfer |
| IBC relayer incentives | ibc-fee | IBC fee |
| Interchain Accounts | interchain-accounts (alias ica) | Interchain Accounts |
| Interchain Queries | interchainquery | Interchain Queries |
| IBC Hooks (Wasm hooks) | ibchooks | IBC Hooks |
Middleware such as packet forward is enabled in the app; routing is typically exercised through IBC transfers and relayers rather than a dedicated top-level CLI.
CosmWasm
| Module | CLI | Documentation |
|---|---|---|
| Wasm | wasm | Wasm |
For protocol economics and SAF supply, see Tokenomics.