-
Notifications
You must be signed in to change notification settings - Fork 96
Updated README: Added Aztec logo, GitHub badges, social media links, … #37
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
Merged
Merged
Changes from 2 commits
Commits
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,95 +1,131 @@ | ||
| <div align="center"> | ||
| <a href="https://aztec.network"> | ||
| <img src="https://github.com/AztecProtocol/aztec-packages/blob/master/docs/static/img/aztec-logo.9cde8ae1.svg" alt="Aztec Protocol Logo" width="300"> | ||
| </a> | ||
| </div> | ||
|
|
||
| # Aztec Starter | ||
|
|
||
| This repo is meant to be a starting point for writing Aztec contracts and tests. | ||
|
|
||
| You can find the Easy Private Voting contract in `./src/main.nr`. A simple integration test is in `./src/test/index.test.ts`. | ||
| You can find the **Easy Private Voting contract** in `./src/main.nr`. A simple integration test is in `./src/test/index.test.ts`. | ||
|
|
||
| The corresponding tutorial can be found in the [Aztec docs here](https://docs.aztec.network/tutorials/codealong/contract_tutorials/private_voting_contract). | ||
|
|
||
| ## Getting Started | ||
| <div align="center"> | ||
|
|
||
| [](https://github.com/AztecProtocol/aztec-packages/stargazers) | ||
| [](https://github.com/AztecProtocol/aztec-packages/network/members) | ||
| [](https://github.com/AztecProtocol/aztec-packages/commits/main) | ||
| [](https://github.com/AztecProtocol/aztec-packages/blob/main/LICENSE) | ||
| [](https://discord.gg/aztec) | ||
| [](https://x.com/aztecnetwork) | ||
|
|
||
| </div> | ||
|
|
||
| --- | ||
|
|
||
| Use node version 18. | ||
| ## 🚀 **Getting Started** | ||
|
|
||
| Use **Node.js version 18**. | ||
|
|
||
| [Start your codespace from the codespace dropdown](https://docs.github.com/en/codespaces/getting-started/quickstart). | ||
|
|
||
| Get the sandbox, aztec-cli and other tooling with this command: | ||
| Get the **sandbox, aztec-cli, and other tooling** with this command: | ||
|
|
||
| ```bash | ||
| ```bash | ||
| bash -i <(curl -s https://install.aztec.network) | ||
| ``` | ||
|
|
||
| Install the correct version of the toolkit with: | ||
|
|
||
| ```bash | ||
| ```bash | ||
| aztec-up 0.70.0 | ||
| ``` | ||
|
|
||
| Start the sandbox with: | ||
|
|
||
| ```bash | ||
| ```bash | ||
| aztec start --sandbox | ||
| ``` | ||
| --- | ||
|
|
||
| ## Install packages | ||
| ## 📦 **Install Packages** | ||
|
|
||
| ```bash | ||
| ```bash | ||
| yarn install | ||
| ``` | ||
| --- | ||
|
|
||
| ## Compile | ||
| ## 🏗 **Compile** | ||
|
|
||
| ```bash | ||
| aztec-nargo compile | ||
| ```bash | ||
| aztec-nargo compile | ||
| ``` | ||
| or | ||
|
|
||
| or | ||
|
|
||
| ```bash | ||
| ```bash | ||
| yarn compile | ||
| ``` | ||
|
|
||
| ## Codegen | ||
| --- | ||
|
|
||
| ## 🔧 **Codegen** | ||
|
|
||
| Generate the contract artifact json and typescript interface | ||
| Generate the **contract artifact JSON** and TypeScript interface: | ||
|
|
||
| ```bash | ||
| ```bash | ||
| yarn codegen | ||
| ``` | ||
| --- | ||
|
|
||
| ## Test | ||
| ## 🧪 **Test** | ||
|
|
||
| Make sure the sandbox is running before running tests. | ||
| **Make sure the sandbox is running before running tests.** | ||
|
|
||
| ```bash | ||
| ```bash | ||
| aztec start --sandbox | ||
| ``` | ||
|
|
||
| Then test with: | ||
|
|
||
| ```bash | ||
| ```bash | ||
| yarn test | ||
| ``` | ||
|
|
||
| Testing will run the Typescript tests defined in `index.test.ts` file in the `./src/test` directory, as well as the [Aztec Testing eXecution Environment (TXE)](https://docs.aztec.network/guides/developer_guides/smart_contracts/testing) tests defined in [`first.nr`](./src/test/first.nr) (and imported at the top of the contract file with `mod test;`). | ||
| Testing will run the **TypeScript tests** defined in `index.test.ts` inside `./src/test`, as well as the [Aztec Testing eXecution Environment (TXE)](https://docs.aztec.network/guides/developer_guides/smart_contracts/testing) tests defined in [`first.nr`](./src/test/first.nr) (imported in the contract file with `mod test;`). | ||
|
|
||
| ## Error resolution | ||
| --- | ||
|
|
||
| ### Update Nodejs and Noir dependencies | ||
| ## ❗ **Error Resolution** | ||
|
|
||
| ```bash | ||
| ### 🔄 **Update Node.js and Noir Dependencies** | ||
|
|
||
| ```bash | ||
| yarn update | ||
| ``` | ||
|
|
||
| ### Update Contract | ||
| ### 🔄 **Update Contract** | ||
|
|
||
| Get the contract code from the monorepo. The script will look at the versions defined in `./Nargo.toml` and fetch that version of the code from the monorepo. | ||
| Get the **contract code from the monorepo**. The script will look at the versions defined in `./Nargo.toml` and fetch that version of the code from the monorepo. | ||
|
|
||
| ```bash | ||
| ```bash | ||
| yarn update | ||
| ``` | ||
|
|
||
| You may need to update permissions with: | ||
|
|
||
| ```bash | ||
| ```bash | ||
| chmod +x update_contract.sh | ||
| ``` | ||
|
|
||
|
|
||
| ### 💬 Join the Community: | ||
| <p align="left"> | ||
| <a href="https://t.me/aztec_network](https://t.me/AztecAnnouncements_Official"> | ||
| <img src="https://img.shields.io/badge/Telegram-26A5E4?logo=telegram&logoColor=white&style=for-the-badge" alt="Telegram"> | ||
| </a> | ||
| <a href="https://discord.gg/aztec"> | ||
| <img src="https://img.shields.io/badge/Discord-5865F2?logo=discord&logoColor=white&style=for-the-badge" alt="Discord"> | ||
| </a> | ||
| <a href="https://x.com/aztecnetwork"> | ||
| <img src="https://img.shields.io/badge/Twitter-000000?logo=x&logoColor=white&style=for-the-badge" alt="Twitter (X)"> | ||
| </a> | ||
| </p> | ||
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Can you make it more clear that this info is for the aztec-packages repo and not this starter?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Apologies for the confusion! I had submitted two PRs and must have mixed up some details. I've now corrected it to clearly reference the appropriate repository. Thanks for catching that, and I appreciate the review!