Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

chore(docs): starting a migration notes section #3853

Merged
merged 5 commits into from
Jan 8, 2024
Merged
Changes from 1 commit
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
Next Next commit
chore(docs): starting a migration notes section
signorecello committed Jan 5, 2024

Unverified

This commit is not signed, but one or more authors requires that any commit attributed to them is signed.
commit cadb3f3bb843a8bedbef783a9645b3a239a66806
41 changes: 41 additions & 0 deletions docs/docs/misc/migration_notes.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
---
title: Migration notes
description: Read about migration notes from previous versions, which could solve problems while updating
keywords: [sandbox, cli, aztec, notes, migration, updating, upgrading]
---

Aztec is in full-speed development. Literally every version breaks compatibility with the previous ones. This page attempts to target errors and difficulties you might encounter when upgrading, and how to resolve them.

## ≥0.17

### Importing contracts in JS

Contracts are now imported from a file with the type's name.

For example:

```js
import { TokenContract } from '@aztec/noir-contracts/Token'
```

instead of

```js
import { TokenContract } from '@aztec/noir-contracts/types'
```

### Importing contracts in Nargo.toml

Aztec contracts are now moved outside of the `src` folder, so you need to update your imports.

For example, for `easy_private_token_contract`, you'd import them like this:

```rust
easy_private_token_contract = {tag ="v0.1.0-alpha62", git = "<https://github.com/AztecProtocol/aztec-packages>", directory = "yarn-project/noir-contracts/src/contracts/easy_private_token_contract"}
```

Now, just remove the `src` folder, as such:

```rust
easy_private_token_contract = {tag ="v0.1.0-alpha62", git = "<https://github.com/AztecProtocol/aztec-packages>", directory = "yarn-project/noir-contracts/src/contracts/easy_private_token_contract"}
```