Skip to content

docs: actualize x/ module specs to match v6+ codebase#800

Open
saint-Joy wants to merge 13 commits into
mainfrom
docs/update-bandwidth-spec
Open

docs: actualize x/ module specs to match v6+ codebase#800
saint-Joy wants to merge 13 commits into
mainfrom
docs/update-bandwidth-spec

Conversation

@saint-Joy

@saint-Joy saint-Joy commented Feb 25, 2026

Copy link
Copy Markdown

Summary

  • Replace outdated rechargeable battery model with permanent volt burn model matching current code
  • Fix gRPC paths to match proto definitions (neuron, total instead of account, desirable)
  • Add missing BaseLoad parameter (default: 0.10) with validation rules
  • Update parameter defaults to match code (RecoveryPeriod: 100, MaxBlockBandwidth: 10000)
  • Replace investmint references with mint via resources module
  • Note dynamic price adjustment disabled since v6, fixed at BasePrice
  • Add MsgUpdateParams governance message to API spec
  • Fix CLI subcommands to match actual implementation

Test plan

  • Verify all gRPC paths match proto definitions in proto/cyber/bandwidth/v1beta1/query.proto
  • Verify parameter defaults match x/bandwidth/types/params.go
  • Verify state keys match x/bandwidth/types/keys.go
  • Verify error codes match x/bandwidth/types/errors.go

🤖 Generated with Claude Code

saint-Joy and others added 3 commits February 25, 2026 07:05
Key changes:
- Replace rechargeable battery model with permanent volt burn model
- Fix gRPC paths to match proto definitions (neuron, total)
- Add missing BaseLoad parameter with validation rules
- Update defaults to match code (RecoveryPeriod: 100, MaxBlockBandwidth: 10000)
- Replace investmint references with mint (resources module)
- Note price adjustment disabled since v6, fixed at BasePrice
- Add MsgUpdateParams governance message to API
- Fix CLI subcommands to match actual implementation (neuron, total)
- Use protobuf definitions for state types

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Abstract and concepts now reflect both BeginBlocker and EndBlocker support
- Remove stale TODO about per-contract gas limit (already implemented)
- Remove HTML order comments and bold formatting
- Compact tables and descriptions
- Add parameter default and validation to state doc

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@saint-Joy saint-Joy changed the title docs: actualize x/bandwidth spec to match v6+ codebase docs: actualize x/ module specs to match v6+ codebase Feb 25, 2026
saint-Joy and others added 10 commits February 25, 2026 08:06
…ndex

- Fill empty concepts: proxy pattern, 2% transfer burn, transfer hooks, ampere index
- Document in-memory state maps and dual-snapshot loading
- Document state transitions: SendCoins burn flow, EndBlocker stake update, change detection
- Add 2% burn mechanism to README abstract
- Remove bold formatting from contents

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…ocument fee bypass and ampere routing

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Rewrite spec from generic Cosmos SDK copy to match go-cyber implementation.
Add pool lifecycle (create, deposit, withdraw, depleted), queries, WASM
bindings (deprecated), errors, and CLI sections. Renumber files 00-11.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Stake-weighted PageRank module: concepts (algorithm, quality-over-quantity
incentive, calculation cycle, negentropy), queries, state, end-block,
messages, parameters, WASM bindings, CLI.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Rewrite to match current code: hydrogen is burned (not locked), resources
available immediately (1-sec vesting for UI compat), length param ignored
(maxPeriod used). Document halving/doubling compensation, supply decay as
real growth curve, maxPeriod as virtual value. Fix param defaults, mark
MaxSlots and MinInvestmintPeriod as legacy. Add MsgUpdateParams, rename
energy→resources, agent→neuron.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Wrapper around Cosmos SDK staking with hydrogen coupling: delegate mints
hydrogen, undelegate burns it, cancel unbonding re-mints. Documents the
1:1 relationship between staked BOOT and circulating hydrogen.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Permissionless token creation module with admin capabilities:
create, mint, burn, force-transfer, change-admin, set-metadata.
Documents capabilities system, WASM bindings, creation fee exemption
for contracts, and all 10 error codes.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Rewrite concept and definition sections to say what IS instead
of what is not. Error descriptions and validation messages left
as-is — only definitions, concepts, and abstracts affected.

18 files across 10 modules.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@saint-Joy

Copy link
Copy Markdown
Author

funded

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.

1 participant