-
Notifications
You must be signed in to change notification settings - Fork 597
docs: add support page, surface Discord, remove Airtable signup gate #23435
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
base: next
Are you sure you want to change the base?
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,128 @@ | ||
| --- | ||
| title: Get help and report issues | ||
| sidebar_position: 5 | ||
| description: Where to ask questions, report bugs, request features, and disclose security issues for the Aztec stack. | ||
| --- | ||
|
|
||
| This page tells you where to go when something does not work, when you want to file a bug, when you have a feature idea, or when you have found a possible security issue. Pick the section that matches your situation. | ||
|
|
||
| :::warning Security issues are different | ||
| If your issue involves loss of funds, key or seed disclosure, leakage of private notes, a way to forge or replay transactions, or anything you suspect could harm users, **do not open a public GitHub issue or post in Discord**. Use the [security disclosure process](#security-issues) instead. | ||
| ::: | ||
|
|
||
| ## Quick decision tree | ||
|
|
||
| | Your situation | Where to go | | ||
| | --- | --- | | ||
| | Possible security issue (funds, keys, privacy, exploit) | [Security disclosure](#security-issues) | | ||
| | You are not sure if the bug is real, or you cannot reproduce it yet | [Ask first: Forum or Discord](#ask-first-forum-and-discord) | | ||
| | You have a reproducible bug in `aztec-packages` (PXE, aztec.js, aztec-nr, sandbox, CLI, AVM, barretenberg, L1 contracts) | [File a bug on GitHub](#file-a-bug) | | ||
| | You have a Noir compiler or language bug | [Noir issues on `noir-lang/noir`](https://github.com/noir-lang/noir/issues) | | ||
| | You have a feature request or enhancement idea | [File a feature request](#feature-requests) | | ||
| | You are running a node, sequencer, or prover and hit an operator problem | [Operator support](#operator-and-node-issues) | | ||
| | You want to suggest a documentation change | [File a docs issue](#documentation-issues) | | ||
|
|
||
| ## Ask first: Forum and Discord | ||
|
|
||
| If you are not yet sure whether your problem is a real bug or a configuration issue, start in the community channels. You can often get a faster answer there, and the team can help you build a minimal reproduction before you open a GitHub issue. | ||
|
|
||
| - [Aztec Discord](https://discord.gg/aztec): real-time chat, best for quick questions, syntax issues, and configuration help. | ||
| - [Aztec Forum](https://forum.aztec.network): long-form Q&A, best for design discussions, complex bug reports, and conversations you want indexed and searchable. | ||
| - [Noir Discord](https://discord.com/invite/JtqzkdeQ6G): the dedicated Noir community. | ||
|
|
||
| Once you have a clear reproduction, the right next step is to file a GitHub issue using the form below. | ||
|
|
||
| ## File a bug | ||
|
|
||
| Reproducible bugs in the Aztec stack belong on GitHub. Use the bug template, which automatically labels your issue and helps a maintainer triage it. | ||
|
|
||
| [Open a new bug report](https://github.com/AztecProtocol/aztec-packages/issues/new?template=bug_report.yml) | ||
|
|
||
| ### What a high-quality bug report includes | ||
|
|
||
| The template asks for these, and your issue will be triaged faster if you provide all of them. | ||
|
|
||
| 1. **Aztec version**, for example `0.85.0-alpha-testnet.2`. Use `aztec-up list` if you are not sure. | ||
| 2. **What you were trying to do**, in one or two sentences. | ||
| 3. **A minimal, runnable reproduction**. A code snippet that compiles, or a link to a public repo branch, is much more useful than prose. If your reproduction is large, please trim it before filing. | ||
| 4. **Expected vs. actual behavior**. | ||
| 5. **Environment**: operating system, Node.js version, and browser if relevant. | ||
| 6. **Logs and errors**: the failing block, ideally with `LOG_LEVEL=debug` for the module that failed. | ||
| 7. **What you already tried**: workarounds, version downgrades, related issues you read. | ||
|
|
||
| ### Where bugs in specific components go | ||
|
|
||
| All of the components below live in [`AztecProtocol/aztec-packages`](https://github.com/AztecProtocol/aztec-packages), so use the bug template above and let triage attach the component label. | ||
|
|
||
| - **PXE, wallet, CLI**: `aztec`, `aztec-wallet`, `aztec.js`, `bb.js`, sandbox. | ||
| - **Aztec.nr framework**: the `aztec-nr` smart contract framework. | ||
| - **Protocol circuits or protocol specs**: the rollup, kernels, and other circuits. | ||
| - **Barretenberg, AVM, L1 contracts**: the prover backend, the Aztec Virtual Machine, and the Ethereum-side rollup contracts. | ||
|
|
||
| For the **Noir compiler** or the Noir language itself, file on [`noir-lang/noir`](https://github.com/noir-lang/noir/issues) instead. | ||
|
|
||
| ## Feature requests | ||
|
|
||
| Use the feature request template for new functionality, enhancements to existing components, or proposed changes to the developer experience. | ||
|
|
||
| [Open a feature request](https://github.com/AztecProtocol/aztec-packages/issues/new?template=feature_request.yml) | ||
|
|
||
| Include: | ||
|
|
||
| - The problem you are trying to solve. | ||
| - A concrete example or use case, if you have one. | ||
| - Why this is impactful: what is unblocked or made easier if it ships. | ||
|
|
||
| ## Documentation issues | ||
|
|
||
| If something in the docs is wrong, outdated, or missing, you have two good options. | ||
|
|
||
| - **Open an issue** with the bug template and quote the URL and paragraph that needs fixing. | ||
| - **Open a pull request** directly. Every docs page in this site has an "Edit this page" link at the bottom that takes you to the right file in [`docs-developers/`](https://github.com/AztecProtocol/aztec-packages/tree/next/docs/docs-developers). | ||
|
|
||
| Small typo fixes are welcome as direct PRs without an issue first. For larger restructures, open an issue so a maintainer can confirm the direction before you write the change. | ||
|
|
||
| ## Operator and node issues | ||
|
|
||
| If you are running a node, sequencer, or prover and you hit an operational problem (sync failures, missed proposals, prover crashes, deployment errors), please include the following alongside the standard bug-report fields: | ||
|
|
||
| - **Network** (mainnet, testnet, devnet, or local). | ||
| - **Role** (validator, prover, RPC node). | ||
| - **Block height at failure** and approximate UTC timestamp. | ||
| - **Hardware**: CPU model, RAM, disk type and size. | ||
| - **Container runtime and image version**. | ||
| - **Configuration** (your `config.json` or environment block, with secrets redacted). | ||
| - **Logs**: the last few hundred lines around the failure, with sensitive keys redacted. | ||
|
|
||
| Operator-specific guides live in the [Operate section](/operate/operators). | ||
|
|
||
| ## Security issues | ||
|
|
||
| **Do not open a public GitHub issue for a suspected vulnerability.** Public disclosure can put users at risk before a fix is available. | ||
|
|
||
| Use one of the following, in order of preference: | ||
|
|
||
| 1. **[Aztec Network Bug Bounty on Cantina](https://cantina.xyz/bounties/80e74370-10d8-4e52-8e4b-7294deb7c9ee)** if the issue is in scope of the bounty program. | ||
| 2. **[GitHub Private Vulnerability Reporting (PVR)](https://github.com/AztecProtocol/aztec-packages/security/advisories/new)** for any other suspected vulnerability. Go to the "Security" tab of the repository and click "Report a vulnerability". | ||
| 3. **Email `security@aztec.foundation`** if PVR is not available to you. Please do not include the exploit details or steps to reproduce in the email body, send those through PVR. | ||
|
|
||
| If you believe a vulnerability is being actively exploited or has severe impact (loss of funds, key compromise, or broad user impact), mark the report as **CRITICAL** in the PVR or email subject. | ||
|
|
||
| See the full [security policy](https://github.com/AztecProtocol/aztec-packages/blob/next/SECURITY.md) for more. | ||
|
|
||
| ## What happens after you file | ||
|
|
||
| When you file a GitHub issue using one of the templates above, it is automatically tagged so the team can triage it. A maintainer will: | ||
|
|
||
| 1. Confirm the component the issue belongs to. | ||
| 2. Set a priority based on impact. | ||
| 3. Ask follow-up questions if the report is missing a reproduction or context. | ||
| 4. Route the issue to the owning team. | ||
|
|
||
| The fastest way to a fix is a small, runnable reproduction. If you can attach one, please do. | ||
|
|
||
| ## See also | ||
|
|
||
| - [`CONTRIBUTING.md`](https://github.com/AztecProtocol/aztec-packages/blob/next/CONTRIBUTING.md) for contribution guidelines. | ||
| - [`SECURITY.md`](https://github.com/AztecProtocol/aztec-packages/blob/next/SECURITY.md) for the full security disclosure policy. | ||
| - The [Aztec project board](https://github.com/orgs/AztecProtocol/projects/22) for in-flight work. |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,128 @@ | ||
| --- | ||
| title: Get help and report issues | ||
| sidebar_position: 5 | ||
| description: Where to ask questions, report bugs, request features, and disclose security issues for the Aztec stack. | ||
| --- | ||
|
|
||
| This page tells you where to go when something does not work, when you want to file a bug, when you have a feature idea, or when you have found a possible security issue. Pick the section that matches your situation. | ||
|
|
||
| :::warning Security issues are different | ||
| If your issue involves loss of funds, key or seed disclosure, leakage of private notes, a way to forge or replay transactions, or anything you suspect could harm users, **do not open a public GitHub issue or post in Discord**. Use the [security disclosure process](#security-issues) instead. | ||
| ::: | ||
|
|
||
| ## Quick decision tree | ||
|
|
||
| | Your situation | Where to go | | ||
| | --- | --- | | ||
| | Possible security issue (funds, keys, privacy, exploit) | [Security disclosure](#security-issues) | | ||
| | You are not sure if the bug is real, or you cannot reproduce it yet | [Ask first: Forum or Discord](#ask-first-forum-and-discord) | | ||
| | You have a reproducible bug in `aztec-packages` (PXE, aztec.js, aztec-nr, sandbox, CLI, AVM, barretenberg, L1 contracts) | [File a bug on GitHub](#file-a-bug) | | ||
| | You have a Noir compiler or language bug | [Noir issues on `noir-lang/noir`](https://github.com/noir-lang/noir/issues) | | ||
| | You have a feature request or enhancement idea | [File a feature request](#feature-requests) | | ||
| | You are running a node, sequencer, or prover and hit an operator problem | [Operator support](#operator-and-node-issues) | | ||
| | You want to suggest a documentation change | [File a docs issue](#documentation-issues) | | ||
|
|
||
| ## Ask first: Forum and Discord | ||
|
|
||
| If you are not yet sure whether your problem is a real bug or a configuration issue, start in the community channels. You can often get a faster answer there, and the team can help you build a minimal reproduction before you open a GitHub issue. | ||
|
|
||
| - [Aztec Discord](https://discord.gg/aztec): real-time chat, best for quick questions, syntax issues, and configuration help. | ||
| - [Aztec Forum](https://forum.aztec.network): long-form Q&A, best for design discussions, complex bug reports, and conversations you want indexed and searchable. | ||
| - [Noir Discord](https://discord.com/invite/JtqzkdeQ6G): the dedicated Noir community. | ||
|
|
||
| Once you have a clear reproduction, the right next step is to file a GitHub issue using the form below. | ||
|
|
||
| ## File a bug | ||
|
|
||
| Reproducible bugs in the Aztec stack belong on GitHub. Use the bug template, which automatically labels your issue and helps a maintainer triage it. | ||
|
|
||
| [Open a new bug report](https://github.com/AztecProtocol/aztec-packages/issues/new?template=bug_report.yml) | ||
|
|
||
| ### What a high-quality bug report includes | ||
|
|
||
| The template asks for these, and your issue will be triaged faster if you provide all of them. | ||
|
|
||
| 1. **Aztec version**, for example `0.85.0-alpha-testnet.2`. Use `aztec-up list` if you are not sure. | ||
| 2. **What you were trying to do**, in one or two sentences. | ||
| 3. **A minimal, runnable reproduction**. A code snippet that compiles, or a link to a public repo branch, is much more useful than prose. If your reproduction is large, please trim it before filing. | ||
| 4. **Expected vs. actual behavior**. | ||
| 5. **Environment**: operating system, Node.js version, and browser if relevant. | ||
| 6. **Logs and errors**: the failing block, ideally with `LOG_LEVEL=debug` for the module that failed. | ||
| 7. **What you already tried**: workarounds, version downgrades, related issues you read. | ||
|
|
||
| ### Where bugs in specific components go | ||
|
|
||
| All of the components below live in [`AztecProtocol/aztec-packages`](https://github.com/AztecProtocol/aztec-packages), so use the bug template above and let triage attach the component label. | ||
|
|
||
| - **PXE, wallet, CLI**: `aztec`, `aztec-wallet`, `aztec.js`, `bb.js`, sandbox. | ||
| - **Aztec.nr framework**: the `aztec-nr` smart contract framework. | ||
| - **Protocol circuits or protocol specs**: the rollup, kernels, and other circuits. | ||
| - **Barretenberg, AVM, L1 contracts**: the prover backend, the Aztec Virtual Machine, and the Ethereum-side rollup contracts. | ||
|
|
||
| For the **Noir compiler** or the Noir language itself, file on [`noir-lang/noir`](https://github.com/noir-lang/noir/issues) instead. | ||
|
|
||
| ## Feature requests | ||
|
|
||
| Use the feature request template for new functionality, enhancements to existing components, or proposed changes to the developer experience. | ||
|
|
||
| [Open a feature request](https://github.com/AztecProtocol/aztec-packages/issues/new?template=feature_request.yml) | ||
|
|
||
| Include: | ||
|
|
||
| - The problem you are trying to solve. | ||
| - A concrete example or use case, if you have one. | ||
| - Why this is impactful: what is unblocked or made easier if it ships. | ||
|
|
||
| ## Documentation issues | ||
|
|
||
| If something in the docs is wrong, outdated, or missing, you have two good options. | ||
|
|
||
| - **Open an issue** with the bug template and quote the URL and paragraph that needs fixing. | ||
| - **Open a pull request** directly. Every docs page in this site has an "Edit this page" link at the bottom that takes you to the right file in [`docs-developers/`](https://github.com/AztecProtocol/aztec-packages/tree/next/docs/docs-developers). | ||
|
|
||
| Small typo fixes are welcome as direct PRs without an issue first. For larger restructures, open an issue so a maintainer can confirm the direction before you write the change. | ||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Historically we have discouraged typo fixes because it encourages low effort AI generated PRs that are more trouble to review than to just fix. Maybe we encourage typo issues instead, and automatically tag @AztecProtocol/devrel |
||
|
|
||
| ## Operator and node issues | ||
|
|
||
| If you are running a node, sequencer, or prover and you hit an operational problem (sync failures, missed proposals, prover crashes, deployment errors), please include the following alongside the standard bug-report fields: | ||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. May be worth adding a link to discord at the top of this sub-heading? I know you link to them above, but if I click on the Operator support link in the table above, i jump straight here without seeing the discord link section. Another alternative could be to put the discord link section above the decision tree table |
||
|
|
||
| - **Network** (mainnet, testnet, devnet, or local). | ||
| - **Role** (validator, prover, RPC node). | ||
| - **Block height at failure** and approximate UTC timestamp. | ||
| - **Hardware**: CPU model, RAM, disk type and size. | ||
| - **Container runtime and image version**. | ||
| - **Configuration** (your `config.json` or environment block, with secrets redacted). | ||
| - **Logs**: the last few hundred lines around the failure, with sensitive keys redacted. | ||
|
|
||
| Operator-specific guides live in the [Operate section](/operate/operators). | ||
|
|
||
| ## Security issues | ||
|
|
||
| **Do not open a public GitHub issue for a suspected vulnerability.** Public disclosure can put users at risk before a fix is available. | ||
|
|
||
| Use one of the following, in order of preference: | ||
|
|
||
| 1. **[Aztec Network Bug Bounty on Cantina](https://cantina.xyz/bounties/80e74370-10d8-4e52-8e4b-7294deb7c9ee)** if the issue is in scope of the bounty program. | ||
| 2. **[GitHub Private Vulnerability Reporting (PVR)](https://github.com/AztecProtocol/aztec-packages/security/advisories/new)** for any other suspected vulnerability. Go to the "Security" tab of the repository and click "Report a vulnerability". | ||
| 3. **Email `security@aztec.foundation`** if PVR is not available to you. Please do not include the exploit details or steps to reproduce in the email body, send those through PVR. | ||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. It says to use email if PVR is not available in the first sentence, then says to use PVR in the second. |
||
|
|
||
| If you believe a vulnerability is being actively exploited or has severe impact (loss of funds, key compromise, or broad user impact), mark the report as **CRITICAL** in the PVR or email subject. | ||
|
|
||
| See the full [security policy](https://github.com/AztecProtocol/aztec-packages/blob/next/SECURITY.md) for more. | ||
|
|
||
| ## What happens after you file | ||
|
|
||
| When you file a GitHub issue using one of the templates above, it is automatically tagged so the team can triage it. A maintainer will: | ||
|
|
||
| 1. Confirm the component the issue belongs to. | ||
| 2. Set a priority based on impact. | ||
| 3. Ask follow-up questions if the report is missing a reproduction or context. | ||
| 4. Route the issue to the owning team. | ||
|
|
||
| The fastest way to a fix is a small, runnable reproduction. If you can attach one, please do. | ||
|
|
||
| ## See also | ||
|
|
||
| - [`CONTRIBUTING.md`](https://github.com/AztecProtocol/aztec-packages/blob/next/CONTRIBUTING.md) for contribution guidelines. | ||
| - [`SECURITY.md`](https://github.com/AztecProtocol/aztec-packages/blob/next/SECURITY.md) for the full security disclosure policy. | ||
| - The [Aztec project board](https://github.com/orgs/AztecProtocol/projects/22) for in-flight work. | ||
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.