Skip to content

docs(glossary): migrate remaining 'staking' terms to 'bonding' #146

@yigitdot

Description

@yigitdot

Problem

The glossary table in docs/overview/glossary.mdx still uses the old staking terminology. The rest of the docs and site copy were migrated from "staking" to "bonding" in #145, but this glossary table was missed.

Fix

In the glossary table, update the technical protocol references:

  • stake → bond
  • staked → bonded
  • staking → bonding

Concretely, five cells change:

Term Current Updated
Client "No stake, no gossip publish." "No bond, no gossip publish."
Node "A staked QUIC endpoint…" "A bonded QUIC endpoint…"
Peer mesh "The flat set of all staked nodes." "The flat set of all bonded nodes."
Stake (term name) Stake Bond
TOKEN "The deCDN staking token…" "The deCDN bonding token…"

Preserve "stake" only where it is idiomatic (e.g. "having a stake", "skin in the game") rather than a technical protocol verb/noun. The glossary contains no idiomatic uses, so every occurrence in this table should change.

Corrected table

| Term                   | Definition                                                                                                                                                                        |
| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Blob**               | A content-addressed byte sequence. Every blob is identified by its hash; clients verify received bytes against the known hash.                                                    |
| **Channel (payment)**  | On-chain escrow between client and node that backs off-chain vouchers. Opens with a deposit; settles with the latest voucher.                                                     |
| **Client**             | A lightweight QUIC endpoint that streams content and pays per MB. No bond, no gossip publish.                                                                                     |
| **DHT**                | Kademlia-subset content discovery. Nodes self-publish records when caching a blob.                                                                                                |
| **Gossip**             | Epidemic broadcast over topic channels for node metadata and rate updates.                                                                                                        |
| **Hash sequence**      | An ordered collection of blob hashes (a directory or manifest equivalent).                                                                                                        |
| **Node**               | A bonded QUIC endpoint that caches and delivers blobs. Some are origin-backed; others are pure caches.                                                                            |
| **Origin-backed node** | A node configured with an S3-compatible store, NFS mount, or local disk — the canonical source for specific blobs. Never experiences a true cache miss.                           |
| **Origin backend**     | The opaque storage behind an origin-backed node (S3, R2, B2, MinIO, NFS, local disk). Never exposed to the network.                                                               |
| **Peer mesh**          | The flat set of all bonded nodes. Discovery via gossip; content location via DHT.                                                                                                 |
| **Probe**              | Parallel latency + availability check that runs before any delivery commitment.                                                                                                   |
| **Selection score**    | A combined ranking over advertised price, observed latency, and reputation. Lower is better.                                                                                      |
| **Bond**               | TOKEN locked on-chain by a node to join the mesh — a capacity bond that scales with declared bandwidth. Returned on deregistration after an unbonding period.                     |
| **TOKEN**              | The deCDN bonding token: locked as a node's capacity bond and burned by the buyback sink. Not used for payments; governance weight comes from delivered bytes, not TOKEN balance. |
| **USDC**               | The payment currency for all delivery. Fixed at deployment; channels deposit, voucher, and settle in USDC.                                                                        |
| **Voucher**            | A signed off-chain payment message. The primary payment instrument between client and node.                                                                                       |

Originally flagged by @gemini-code-assist[bot] in #145 (comment)

Metadata

Metadata

Assignees

No one assigned

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions