Skip to content

chore: migrate to Miden protocol 0.16.0-rc.3 and VM 0.29 - #1311

Draft
greenhat wants to merge 1 commit into
nextfrom
i1310-vm029-protocol016-migration
Draft

chore: migrate to Miden protocol 0.16.0-rc.3 and VM 0.29#1311
greenhat wants to merge 1 commit into
nextfrom
i1310-vm029-protocol016-migration

Conversation

@greenhat

@greenhat greenhat commented Aug 7, 2026

Copy link
Copy Markdown
Contributor

Closes #1310.

Migrates the compiler and SDK to the protocol 0.16 release-candidate line: miden-protocol/miden-standards =0.16.0-rc.3, the VM 0.29 crate family, miden-debug 0.10, miden-field 0.29, and midenc-hir-type 0.10.

The main adaptations: every registry/executor/host/assembler setup now seeds both core-library packages (miden-core plus the new miden-precompiles dependency); the log_precompile instruction rename to log_deferred is followed through the HIR op, frontend, and codegen; the MASM frontend learns the operand footprints of the new deferred system events; the execution harnesses adopt the typed AdviceStack API; and the rpo-falcon512 auth example builds the new 24-felt transaction summary that binds the reference block commitment, expiration delta, and user parameters.

No miden-client release supports protocol 0.16-rc yet, so tests/integration-network temporarily takes miden-client from the client's own migration branch (0xMiden/rust-sdk#2356, which pins the node migration 0xMiden/node#2421 by rev), and its mockchain tests are ported to the miden-testing rc.3 transaction-builder API.

Fixture and example lockfiles are refreshed so the p3 crates resolve to 0.6.3, matching miden-field 0.29's move to num-bigint 0.5. miden-field's published p3 requirements are still ^0.6, so resolutions from stale registry caches can still break generated projects; this is filed upstream as 0xMiden/miden-vm#3536 and documented next to (currently disabled) floor pins in miden-base-macros.

The SDK changelog gains a breaking-change entry: compiled packages link against the updated transaction kernel and core library, so their commitments change, and hosts must use matching protocol 0.16.0-rc.3 crates. Guest code compiles unchanged.

TODO:

Move the compiler and SDK onto the protocol 0.16 release-candidate line, which brings the VM 0.29 crate family, miden-debug 0.10, and miden-field 0.29.

- Bump miden-protocol and miden-standards to =0.16.0-rc.3, the VM crates to 0.29, miden-debug to 0.10, miden-field to 0.29, and midenc-hir-type to 0.10.
- Seed both core-library packages wherever a registry, executor, host, or assembler is set up: miden-core now ships with a separate miden-precompiles package that dependency resolution requires.
- Follow the VM rename of log_precompile to log_deferred through the HIR op, dialect builder, MASM frontend, and codegen, and teach the frontend the operand footprints of the new deferred system events.
- Adopt the typed AdviceStack advice API in the execution harnesses; consumption order is unchanged.
- Rebuild the rpo-falcon512 auth example around the 24-felt transaction summary, which now binds the reference block commitment, the expiration delta, and seven user parameters.
- Keep integration-network in the workspace by taking miden-client from its migration branch (0xMiden/rust-sdk#2356) until a protocol-0.16 client release exists, and port the mockchain tests to the miden-testing rc.3 transaction-builder API.
- Refresh fixture and example lockfiles so the p3 crates resolve to 0.6.3, matching miden-field 0.29's num-bigint 0.5 requirement; miden-field's own p3 requirements are still too loose (0xMiden/miden-vm#3536), documented next to disabled floor pins in miden-base-macros.
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.

VM v0.29 upgrade + v0.16.0-rc.3 protocol upgrade

1 participant