Skip to content

feat: cardano hard fork script for local-env#1326

Merged
rsporny merged 1 commit into
mainfrom
add-cardano-hard-fork-script-to-local-env
Apr 14, 2026
Merged

feat: cardano hard fork script for local-env#1326
rsporny merged 1 commit into
mainfrom
add-cardano-hard-fork-script-to-local-env

Conversation

@rsporny

@rsporny rsporny commented Apr 14, 2026

Copy link
Copy Markdown
Contributor

Overview

Add a Cardano hard fork script to advance the local-env from protocol version 10 to 11 (intra-era).

What it does:

  • Adds hardfork-pv11.sh, a two-phase script (setup + run) that orchestrates a full PV10 → PV11 hard fork on the local Cardano devnet
  • setup phase: generates governance keys (Constitutional Committee cold/hot, DRep, governance stake) and patches the Conway genesis to include a CC member and DRep with delegated stake
  • run phase: registers the DRep on-chain, authorizes the CC hot key, submits a hard fork governance action, collects votes from all three governance bodies (CC, SPO, DRep), and waits for ratification and
    enactment across epochs
  • Adds all required governance key files (CC cold/hot, DRep, gov-stake) to the local-env configuration

Supporting changes:

  • Updates config-pool1.json: disables ExperimentalHardForksEnabled (no longer needed) and bumps MaxKnownMajorProtocolVersion from 2 to 11 to allow the hard fork
  • Lowers govActionDeposit in Conway genesis from 100,000 ADA to 1,000 ADA to make governance proposals feasible
  • Reformats plutusV3CostModel array in Conway genesis (one value per line)
  • Updates entrypoint.sh with log location hints (node logs go to /data/node.log, not stdout)
  • Mounts governance keys volume in docker-compose.yml
  • Adds toolkit_cache/ to .gitignore

Closes #1314

🗹 TODO before merging

  • Ready

📌 Submission Checklist

  • Changes are backward-compatible (or flagged if breaking)
  • Pull request description explains why the change is needed
  • Self-reviewed the diff
  • I have included a change file, or skipped for this reason:
  • If the changes introduce a new feature, I have bumped the node minor version
  • Update documentation (if relevant)
  • Updated AGENTS.md if build commands, architecture, or workflows changed
  • No new todos introduced

🧪 Testing Evidence

Please describe any additional testing aside from CI:

  • Additional tests are provided (if possible)

🔱 Fork Strategy

  • Node Runtime Update
  • Node Client Update
  • Other:
  • N/A

Links

@rsporny rsporny requested a review from a team as a code owner April 14, 2026 09:01
Add a Cardano hard fork script to advance the local-env from protocol
version 10 to 11 (intra-era).

  What it does:
  - Adds hardfork-pv11.sh, a two-phase script (setup + run) that
orchestrates a full PV10 → PV11 hard fork on the local Cardano devnet
  - setup phase: generates governance keys (Constitutional Committee
cold/hot, DRep, governance stake) and patches the Conway genesis to
include a CC member and DRep with delegated stake
  - run phase: registers the DRep on-chain, authorizes the CC hot key,
submits a hard fork governance action, collects votes from all three
governance bodies (CC, SPO, DRep), and waits for ratification and
  enactment across epochs
  - Adds all required governance key files (CC cold/hot, DRep,
gov-stake) to the local-env configuration

  Supporting changes:
  - Updates config-pool1.json: disables ExperimentalHardForksEnabled (no
longer needed) and bumps MaxKnownMajorProtocolVersion from 2 to 11 to
allow the hard fork
  - Lowers govActionDeposit in Conway genesis from 100,000 ADA to 1,000
ADA to make governance proposals feasible
  - Reformats plutusV3CostModel array in Conway genesis (one value per
line)
  - Updates entrypoint.sh with log location hints (node logs go to
/data/node.log, not stdout)
  - Mounts governance keys volume in docker-compose.yml
  - Adds toolkit_cache/ to .gitignore

Closes #1314

Signed-off-by: Radosław Sporny <404@rspo.dev>
@rsporny rsporny force-pushed the add-cardano-hard-fork-script-to-local-env branch from df53eba to 8fd845e Compare April 14, 2026 09:12
@rsporny rsporny enabled auto-merge April 14, 2026 10:28
Comment thread local-environment/src/networks/local-env/hardfork-pv11.sh
@rsporny rsporny added this pull request to the merge queue Apr 14, 2026
Merged via the queue into main with commit f8436e5 Apr 14, 2026
31 of 33 checks passed
@rsporny rsporny deleted the add-cardano-hard-fork-script-to-local-env branch April 14, 2026 14:00
m2ux added a commit that referenced this pull request Apr 23, 2026
Add a Cardano hard fork script to advance the local-env from protocol
version 10 to 11 (intra-era).

  What it does:
  - Adds hardfork-pv11.sh, a two-phase script (setup + run) that
orchestrates a full PV10 → PV11 hard fork on the local Cardano devnet
  - setup phase: generates governance keys (Constitutional Committee
cold/hot, DRep, governance stake) and patches the Conway genesis to
include a CC member and DRep with delegated stake
  - run phase: registers the DRep on-chain, authorizes the CC hot key,
submits a hard fork governance action, collects votes from all three
governance bodies (CC, SPO, DRep), and waits for ratification and
  enactment across epochs
  - Adds all required governance key files (CC cold/hot, DRep,
gov-stake) to the local-env configuration

  Supporting changes:
  - Updates config-pool1.json: disables ExperimentalHardForksEnabled (no
longer needed) and bumps MaxKnownMajorProtocolVersion from 2 to 11 to
allow the hard fork
  - Lowers govActionDeposit in Conway genesis from 100,000 ADA to 1,000
ADA to make governance proposals feasible
  - Reformats plutusV3CostModel array in Conway genesis (one value per
line)
  - Updates entrypoint.sh with log location hints (node logs go to
/data/node.log, not stdout)
  - Mounts governance keys volume in docker-compose.yml
  - Adds toolkit_cache/ to .gitignore

Closes #1314

Signed-off-by: Radosław Sporny <404@rspo.dev>
Signed-off-by: Mike Clay <mike.clay@shielded.io>
m2ux added a commit that referenced this pull request Apr 23, 2026
Add a Cardano hard fork script to advance the local-env from protocol
version 10 to 11 (intra-era).

  What it does:
  - Adds hardfork-pv11.sh, a two-phase script (setup + run) that
orchestrates a full PV10 → PV11 hard fork on the local Cardano devnet
  - setup phase: generates governance keys (Constitutional Committee
cold/hot, DRep, governance stake) and patches the Conway genesis to
include a CC member and DRep with delegated stake
  - run phase: registers the DRep on-chain, authorizes the CC hot key,
submits a hard fork governance action, collects votes from all three
governance bodies (CC, SPO, DRep), and waits for ratification and
  enactment across epochs
  - Adds all required governance key files (CC cold/hot, DRep,
gov-stake) to the local-env configuration

  Supporting changes:
  - Updates config-pool1.json: disables ExperimentalHardForksEnabled (no
longer needed) and bumps MaxKnownMajorProtocolVersion from 2 to 11 to
allow the hard fork
  - Lowers govActionDeposit in Conway genesis from 100,000 ADA to 1,000
ADA to make governance proposals feasible
  - Reformats plutusV3CostModel array in Conway genesis (one value per
line)
  - Updates entrypoint.sh with log location hints (node logs go to
/data/node.log, not stdout)
  - Mounts governance keys volume in docker-compose.yml
  - Adds toolkit_cache/ to .gitignore

Closes #1314

Signed-off-by: Radosław Sporny <404@rspo.dev>
Signed-off-by: Mike Clay <mike.clay@shielded.io>
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.

[van Rossem Cardano HF] Test Cardano HF enacted on local-env

3 participants