Skip to content

Commit 1f440df

Browse files
committed
docs: add missing RPO hash procedure renames to v0.13 migration guide
1 parent 027d92e commit 1f440df

File tree

1 file changed

+29
-5
lines changed

1 file changed

+29
-5
lines changed

versioned_docs/version-0.13/builder/migration/06-masm-changes.md

Lines changed: 29 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -134,13 +134,31 @@ ECDSA procedures moved to new namespace:
134134
+ exec.ecdsa_k256_keccak::verify
135135
```
136136

137-
### RPO Hash Helpers
137+
### RPO Hash Renames
138138

139-
Hash helper procedures renamed:
139+
The RPO module was renamed from `rpo` to `rpo256`, and several procedures were renamed to standardize naming across all hash modules:
140140

141141
```diff title="src/hash.masm"
142+
- use.std::crypto::hashes::rpo
143+
+ use miden::core::crypto::hashes::rpo256
144+
145+
- exec.rpo::hash_memory
146+
+ exec.rpo256::hash_elements
147+
142148
- exec.rpo::hash_memory_words
143-
+ exec.rpo::hash_words
149+
+ exec.rpo256::hash_words
150+
151+
- exec.rpo::hash_memory_double_words
152+
+ exec.rpo256::hash_double_words
153+
154+
- exec.rpo::hash_memory_with_state
155+
+ exec.rpo256::hash_elements_with_state
156+
157+
- exec.rpo::hash_1to1
158+
+ exec.rpo256::hash
159+
160+
- exec.rpo::hash_2to1
161+
+ exec.rpo256::merge
144162
```
145163

146164
---
@@ -197,7 +215,9 @@ end
197215
8. Update `get_item`/`set_item` calls to use `[0..2]` slice for slot IDs
198216
9. Rename `RpoFalcon512` to `Falcon512Rpo`
199217
10. Update ECDSA procedure paths
200-
11. Rename `hash_memory_words` to `hash_words`
218+
11. Rename RPO module `rpo` to `rpo256`
219+
12. Rename `hash_memory` to `hash_elements`, `hash_memory_words` to `hash_words`, `hash_memory_double_words` to `hash_double_words`, `hash_memory_with_state` to `hash_elements_with_state`
220+
13. Rename `hash_1to1` to `hash`, `hash_2to1` to `merge`
201221

202222
---
203223

@@ -208,5 +228,9 @@ end
208228
| `unexpected token '.'` | Old syntax | Use space: `const X` not `const.X` |
209229
| `module 'std' not found` | Namespace changed | Use `miden::core::` |
210230
| `procedure 'auth_tx_rpo_falcon512' not found` | Renamed | Use `auth_tx_falcon512_rpo` |
211-
| `procedure 'hash_memory_words' not found` | Renamed | Use `hash_words` |
231+
| `procedure 'hash_memory' not found` | Renamed | Use `hash_elements` (module `rpo256`) |
232+
| `procedure 'hash_memory_words' not found` | Renamed | Use `hash_words` (module `rpo256`) |
233+
| `procedure 'hash_1to1' not found` | Renamed | Use `hash` (module `rpo256`) |
234+
| `procedure 'hash_2to1' not found` | Renamed | Use `merge` (module `rpo256`) |
235+
| `module 'rpo' not found` | Renamed | Use `rpo256` |
212236
| `get_item` returns unexpected values | Using integer index instead of slot ID | Use `word("...")` and `[0..2]` slice |

0 commit comments

Comments
 (0)