Skip to content

docs(digidollar): update exchange integration guide for mainnet activation#431

Open
JohnnyLawDGB wants to merge 1 commit into
DigiByte-Core:developfrom
JohnnyLawDGB:docs/digidollar-exchange-guide-mainnet-live
Open

docs(digidollar): update exchange integration guide for mainnet activation#431
JohnnyLawDGB wants to merge 1 commit into
DigiByte-Core:developfrom
JohnnyLawDGB:docs/digidollar-exchange-guide-mainnet-live

Conversation

@JohnnyLawDGB

Copy link
Copy Markdown

DIGIDOLLAR_EXCHANGE_INTEGRATION.md still reads as pre-activation, which is the single most confusing thing about it for its intended audience.

An exchange evaluating a DigiDollar listing currently sees:

  • Key Facts: "features remain BIP9-gated until activation"
  • §13: "Test on Testnet Now!"
  • §14: "DigiDollar is gated by BIP9 bit 23 with a start time of 2026-06-01…"

The reasonable reading of all three is DigiDollar is not live yet. It has been live on mainnet since block 23,869,440, 17 July 2026. This came up while walking a prospective exchange integrator through the guide — they asked whether they were reading a pre-release document.

Changes

  • Status banner near the top: mainnet is live, with activation height and date.
  • §14 rewritten in past tense with the actual outcome. The original signaling parameters are retained as background, and the BIP90 burial in v9.26.5 is recorded (consensus.DigiDollarHeight = 23869440, src/kernel/chainparams.cpp).
  • §14 gains a note on the BIP9 off-by-one (see below).
  • Key Facts row updated to live mainnet status; notes v9.26.5 as current.
  • §1 recommends v9.26.5 for exchange nodes, since the oracle startup scan fix directly affects operators running a node under monitoring.
  • §2 note scoped to networks where DigiDollar has not yet activated, rather than reading as a blanket statement.
  • §13 reframed from waiting for activation to rehearsing the full deposit → credit → withdraw → reconcile loop before touching real funds. Testnet content itself is unchanged.

On the activation height

Worth flagging explicitly, because the two available sources disagree by one block:

Source Value
getdigidollardeploymentinfo on v9.26.4 activation_height: 23869439
consensus.DigiDollarHeight (chainparams.cpp) + v9.26.5 release notes 23869440

23869439 is the final block of the BIP9 LOCKED_IN period; rules take effect at the following block. The guide now uses 23,869,440 throughout and adds a short note so integrators reading the height off a pre-v9.26.5 node don't record the lock-in boundary by mistake.

Verification

Every fact asserted here was checked against a synced mainnet node and against develop:

  • Activation height and burial: src/kernel/chainparams.cpp (DigiDollarHeight / AlgoLockHeight = 23869440)
  • Activation date: block timestamp, 2026-07-17 14:11:32 UTC
  • Pre-burial RPC value: getdigidollardeploymentinfo on a v9.26.4 mainnet node
  • v9.26.5 startup fix and BIP90 burial: v9.26.5 release notes

Documentation only — no behavioural or consensus changes.

🤖 Generated with Claude Code

…ation

DigiDollar activated on mainnet at block 23,869,440 on 17 July 2026, but the
exchange integration guide still reads as pre-activation: the Key Facts table
says features "remain BIP9-gated until activation", section 14 describes the
deployment in the present tense as "gated by BIP9 bit 23", and section 13 is
titled "Test on Testnet Now!". An exchange evaluating a listing reasonably
reads all of that as "DigiDollar is not live yet".

Changes:

- Add a status banner near the top stating mainnet is live, with activation
  height and date.
- Section 14: rewrite in past tense with the actual outcome; retain the
  original signaling parameters as background; record the BIP90 burial in
  v9.26.5 (consensus.DigiDollarHeight = 23869440).
- Section 14: note the BIP9 off-by-one. Pre-v9.26.5 nodes report
  activation_height 23869439 -- the final LOCKED_IN block -- while consensus
  buries 23869440. Easy to trip over when recording the activation height.
- Key Facts: replace the pre-activation wording with live mainnet status and
  note v9.26.5 as current.
- Section 1: recommend v9.26.5 for exchange nodes (oracle startup scan fix).
- Section 2 note: scope the "RPCs are gated" caveat to networks where
  DigiDollar has not yet activated.
- Section 13: reframe from waiting for activation to rehearsing the full
  deposit/withdraw loop on testnet before touching real funds.

Documentation only; no behavioural or consensus changes.

Co-Authored-By: Claude Opus 5 (1M context) <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.

1 participant