Skip to content

fix: correct total supply statement in node overview#794

Merged
RetricSu merged 4 commits into
nervosnetwork:developfrom
humble-little-bear:fix-total-supply-statement
May 12, 2026
Merged

fix: correct total supply statement in node overview#794
RetricSu merged 4 commits into
nervosnetwork:developfrom
humble-little-bear:fix-total-supply-statement

Conversation

@RetricSu
Copy link
Copy Markdown
Collaborator

The previous text incorrectly stated that CKB's "total supply is fixed at 33.6 billion CKB." However, per CKB's economic model (RFC 0015), while the base issuance is capped at 33.6 billion CKB, secondary issuance adds a fixed 1.344 billion CKB annually with no upper limit. This means the total supply is not fixed at 33.6 billion.

Update the statement to refer to the base issuance cap instead of the total supply.

Fixes #789

The previous text incorrectly stated that CKB's "total supply is fixed
at 33.6 billion CKB." However, per CKB's economic model (RFC 0015),
while the base issuance is capped at 33.6 billion CKB, secondary
issuance adds a fixed 1.344 billion CKB annually with no upper limit.
This means the total supply is not fixed at 33.6 billion.

Update the statement to refer to the base issuance cap instead of the
total supply.

Fixes nervosnetwork#789
@vercel
Copy link
Copy Markdown

vercel Bot commented May 12, 2026

@humble-little-bear is attempting to deploy a commit to the CKBA-2026 Team on Vercel.

A member of the Team first needs to authorize it.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Updates the node overview documentation to correct an inaccurate statement about CKB issuance and how it relates to state size limits, aligning the text with CKB’s issuance model (base issuance vs. ongoing secondary issuance).

Changes:

  • Replaces “total supply is fixed at 33.6 billion CKB” with “base issuance is capped at 33.6 billion CKB” in the “Global State Size is Capped” bullet.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread website/docs/node/overview.mdx Outdated
Comment on lines 39 to 41
- **Global State Size is Capped**: Since all on-chain storage must be backed by locked CKB—and the base issuance is capped at 33.6 billion CKB—the total size of all Live Cells is inherently capped by design.

Want to learn more? Read about [State Explosion and the Tragedy of the Blockchain Commons](https://medium.com/nervosnetwork/state-explosion-and-the-tragedy-of-the-blockchain-commons-1fbd4837e859).
Address review feedback: the previous wording still implied the global
state was strictly capped by the 33.6B base issuance limit. Since
secondary issuance continues to add CKB annually, the global state
is not strictly capped at a fixed number.

Reword the bullet to state that the total supply grows predictably
through both capped base issuance and fixed-rate secondary issuance,
so the global state size is inherently bounded rather than fixed.
Replace the bullet with a more accurate explanation that:
- Emphasizes the economic constraint rather than implying a hard cap
- Acknowledges base issuance is capped at 33.6B CKB
- Explicitly notes that secondary issuance can still increase capacity
@RetricSu RetricSu merged commit 1920b7b into nervosnetwork:develop May 12, 2026
1 of 2 checks passed
RetricSu added a commit that referenced this pull request May 12, 2026
* chore(deps): bump axios in /examples/dApp/ccc-molecule (#792)

Bumps [axios](https://github.com/axios/axios) from 1.15.0 to 1.16.0.
- [Release notes](https://github.com/axios/axios/releases)
- [Changelog](https://github.com/axios/axios/blob/v1.x/CHANGELOG.md)
- [Commits](axios/axios@v1.15.0...v1.16.0)

---
updated-dependencies:
- dependency-name: axios
  dependency-version: 1.16.0
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* chore(deps): bump @babel/plugin-transform-modules-systemjs in /website (#793)

Bumps [@babel/plugin-transform-modules-systemjs](https://github.com/babel/babel/tree/HEAD/packages/babel-plugin-transform-modules-systemjs) from 7.23.9 to 7.29.4.
- [Release notes](https://github.com/babel/babel/releases)
- [Changelog](https://github.com/babel/babel/blob/main/CHANGELOG.md)
- [Commits](https://github.com/babel/babel/commits/v7.29.4/packages/babel-plugin-transform-modules-systemjs)

---
updated-dependencies:
- dependency-name: "@babel/plugin-transform-modules-systemjs"
  dependency-version: 7.29.4
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* fix: correct total supply statement in node overview (#794)

* fix: correct total supply statement in node overview

The previous text incorrectly stated that CKB's "total supply is fixed
at 33.6 billion CKB." However, per CKB's economic model (RFC 0015),
while the base issuance is capped at 33.6 billion CKB, secondary
issuance adds a fixed 1.344 billion CKB annually with no upper limit.
This means the total supply is not fixed at 33.6 billion.

Update the statement to refer to the base issuance cap instead of the
total supply.

Fixes #789

* fix: reword global state cap explanation to include secondary issuance

Address review feedback: the previous wording still implied the global
state was strictly capped by the 33.6B base issuance limit. Since
secondary issuance continues to add CKB annually, the global state
is not strictly capped at a fixed number.

Reword the bullet to state that the total supply grows predictably
through both capped base issuance and fixed-rate secondary issuance,
so the global state size is inherently bounded rather than fixed.

* fix: reword global state explanation per review suggestion

Replace the bullet with a more accurate explanation that:
- Emphasizes the economic constraint rather than implying a hard cap
- Acknowledges base issuance is capped at 33.6B CKB
- Explicitly notes that secondary issuance can still increase capacity

* fix: use 'predictably' to describe secondary issuance growth

---------

Co-authored-by: humble-little-bear <retric@ckba.build>

* chore(deps): bump next from 15.5.15 to 15.5.18 in /examples/dApp/simple-lock (#795)

* chore(deps): bump next in /examples/dApp/simple-lock

Bumps [next](https://github.com/vercel/next.js) from 15.5.15 to 15.5.18.
- [Release notes](https://github.com/vercel/next.js/releases)
- [Changelog](https://github.com/vercel/next.js/blob/canary/release.js)
- [Commits](vercel/next.js@v15.5.15...v15.5.18)

---
updated-dependencies:
- dependency-name: next
  dependency-version: 15.5.18
  dependency-type: direct:production
...

Signed-off-by: dependabot[bot] <support@github.com>

* chore: update and format pnpm-lock.yaml in simple-lock after next bump

Agent-Logs-Url: https://github.com/nervosnetwork/docs.nervos.org/sessions/0c619746-5c8c-49af-8ba2-d1ec1ef33018

Co-authored-by: RetricSu <23436060+RetricSu@users.noreply.github.com>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: RetricSu <23436060+RetricSu@users.noreply.github.com>

* chore: bump version to 2.38.0 (#796)

Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: humble-little-bear <retric@ckba.build>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: RetricSu <23436060+RetricSu@users.noreply.github.com>
Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>
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.

Total supply correction

3 participants