Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion docs/src/SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
* [First Steps with Starknet Foundry](getting-started/first-steps.md)
* [Scarb](getting-started/scarb.md)
* [Project Configuration](projects/configuration.md)
* [`snforge` 0.48.0 Migration Guide](getting-started/0-48-0-migration-guide.md)
* [Blake Hash Support](getting-started/blake-hash-support.md)

---

Expand Down Expand Up @@ -168,3 +168,4 @@
* [`snfoundry.toml` Reference](appendix/snfoundry-toml.md)
* [`Scarb.toml` Reference](appendix/scarb-toml.md)
* [Starknet Foundry Github Action](appendix/starknet-foundry-github-action.md)
* [`snforge` 0.48.0 Migration Guide](appendix/0-48-0-migration-guide.md)
25 changes: 25 additions & 0 deletions docs/src/getting-started/blake-hash-support.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
# Blake Hash Support

Starting from Starknet version 0.14.1, the network switched from Poseidon hash to Blake hash for compiled class hashes.

Starknet Foundry version 0.53.0 and later includes support for Blake hash, ensuring compatibility with the new Starknet version.

## Common Issue: Mismatch Compiled Class Hash

If you encounter a `Mismatch compiled class hash` error, it likely means you're using an older version of Starknet Foundry that doesn't support Blake hash.

**Solution**: Upgrade to Starknet Foundry version 0.53.0 or later:

```shell
asdf install starknet-foundry latest
```

```shell
asdf set --home starknet-foundry latest
```

This will update your installation to the latest version with Blake hash support.

> 📝 **Note**
>
> For more detailed installation instructions, see the [Installation](../getting-started/installation.md) guide.
37 changes: 14 additions & 23 deletions docs/theme/header.hbs
Original file line number Diff line number Diff line change
@@ -1,27 +1,18 @@
<div class="migration-banner">
<p>
<strong>Important:</strong> If you're upgrading snforge to version 0.48.0 or later, please read the
<a href="{{ path_to_root }}getting-started/0-48-0-migration-guide.html">0.48.0 Migration Guide</a>.
</p>
<div class="blake-banner">
<p>
<strong>Important:</strong>
If you're encountering any problem declaring contracts, please read the
<a href="{{path_to_root}}getting-started/blake-hash-support.html">
Blake Hash Support</a>
information.
</p>
</div>

<style>
.migration-banner {
position: relative;
z-index: 100;
background-color: #f8d7da;
color: #721c24;
border: 0.0625rem solid #f5c6cb;
border-radius: 0;
text-align: center;
padding: 5rem 1rem 0 1rem;
width: calc(100% + 8px + var(--page-padding));
margin-left: calc((8px + var(--page-padding)) * -1);
}

.migration-banner a {
color: #721c24;
font-weight: bold;
text-decoration: underline;
}
.blake-banner { position: relative; z-index: 100; background-color: #f8d7da;
color: #721c24; border: 0.0625rem solid #f5c6cb; border-radius: 0; text-align:
center; padding: 5rem 1rem 0 1rem; width: calc(100% + 8px +
var(--page-padding)); margin-left: calc((8px + var(--page-padding)) * -1); }
.blake-banner a { color: #721c24; font-weight: bold; text-decoration:
underline; }
</style>
Loading