Skip to content

chore: migrate tutorials repo to v0.14#186

Draft
Keinberger wants to merge 27 commits intomainfrom
kbg/chore/v14-migration
Draft

chore: migrate tutorials repo to v0.14#186
Keinberger wants to merge 27 commits intomainfrom
kbg/chore/v14-migration

Conversation

@Keinberger
Copy link
Copy Markdown
Collaborator

Summary

Migrates all tutorial companion code, documentation, and MASM sources from v0.13 to the v0.14 Miden stack. Targets devnet for validation.

Changes

  • Cargo manifests: miden-client 0.13→0.14, miden-client-sqlite-store 0.13→0.14, miden-protocol 0.13→0.14, miden contracts 0.10→0.11, miden-testing 0.13→0.14, miden-mast-package 0.20→0.22, cargo-miden 0.7→0.8
  • Rust client (11 binaries): All v0.14 API changes (AuthSingleSig, AccountComponent 3-arg, NoteStorage, NoteMetadata builder, etc.)
  • Miden Bank: Contract + integration code migrated, MockChain tests pass
  • MASM: Note scripts converted to library+@note_script, FPI stack shape fixes (padw/dropw), hash preimage updated
  • Web client: Endpoints→devnet, AccountType enums, SDK return type fixes, FPI stack shape, localStorage SSR polyfill
  • All docs: Rust-client, web-client, miden-bank tutorials updated to match companion code
  • Network: testnet→devnet throughout (except oracle/wallet-adapter documented exceptions)

Key v0.14 Fixes

Verification

  • All 8 default Rust tutorials pass on devnet
  • counter_contract_fpi + counter_contract_increment pass on devnet
  • oracle_data_query build-only (oracle not on devnet)
  • Miden Bank contract builds, integration tests, initialize+deposit all pass
  • All 5 web tutorials pass via Playwright MCP browser interaction
  • web-client tsc --noEmit + build pass
  • All stale sweeps clean

Known Workarounds (tracked)

Closes #175

…e tutorial

The @miden-sdk/miden-sdk v0.14.0 send({ returnNote: true }) path passes
OutputNoteArray to withOwnOutputNotes() which now expects NoteArray.
Use TransactionRequestBuilder directly until the SDK fix is released.

Tracking: 0xMiden/miden-client#2011
@Keinberger Keinberger force-pushed the kbg/chore/v14-migration branch from 7630916 to 6876cc9 Compare April 14, 2026 13:10
Keinberger

This comment was marked as resolved.

…th webpack

SDK v0.14.1 changed the worker from ES module to classic script for Safari.
The classic worker resolves WASM via self.location.href which webpack can't
trace, causing a 404. Disabling Worker forces the main-thread fallback which
uses import.meta.url (webpack-compatible). Proving is slower but correct.

Tracking: 0xMiden/miden-client#2046
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.

chore: deploy tutorial addresses on both testnet and devnet

1 participant