Skip to content

Commit e352885

Browse files
authored
docs: retail onboarding path for the Participate section (#24910)
## Problem With the V5 live announcement expected to bring a wave of first-time retail users, the Participate section explains Aztec well conceptually but dead-ends on the actual user journey: - No ordered "start here" path: the overview is an unordered menu of concept pages. - No apps/ecosystem discovery anywhere in the docs (the ecosystem page and awesome-aztec are only navbar/footer links). - No scam-safety content at all: no canonical official-links list, no seed-phrase/phishing/fake-bridge warnings, despite launch-window users being the highest-risk group. - No general "get help" path for users (Discord/forum links are buried in unrelated pages). - Wallet docs predated consumer wallets; bridging ended with "the exact interface depends on the specific bridge implementation". Recent PR #24831 fixed the fee/funding leg (Fee Juice, Azguard, Shield). This PR layers the rest of the retail journey on top of it. ## Changes New pages (wired into `sidebars-participate.js`): - **`get-started.md`**: ordered onboarding path: understand → get a wallet (Azguard primary, matching #24831) → fund via Shield/Fee Juice → first private transaction (send/receive/check on Aztecscan) → explore apps → stay safe → get help, plus a plain-language key-terms table (rollup, note, PXE, mana, Fee Juice, sequencer, prover, epoch). - **`apps.md`**: what you can do today (Azguard, Shield bridge, Nemi DEX, RavenHouse, Aztecscan) with the [ecosystem page](https://aztec.network/projects) and awesome-aztec as the canonical, always-current discovery surfaces so new app launches need no doc changes. - **`safety.md`**: official Aztec links table, golden rules (seed phrase, no-DMs, URL/token-contract verification), launch-window scam patterns, and a "if something goes wrong" triage (stuck tx → explorer, app issues → project support, vulnerabilities → existing disclosure process). Edits: - **`index.md`**: "New to Aztec? Start here" tip after the Alpha caution, a "Using Aztec" section linking the three new pages, and a "Ready to use Aztec?" CTA alongside the existing build/operate CTAs. - **`basics/wallets.md`**: adds an "Other wallets" pointer (ecosystem page as the current list) and an install-from-official-sources-only caution; keeps the Azguard section from #24831 as primary. - **`basics/bridging.md`**: restructures "Using Bridges" into concrete options (Shield, wallet built-in flows, direct portal interaction via /networks) with a fake-bridge-site caution; keeps #24831's Shield/Fee Juice content. - **`docs-words.txt`**: adds Nemi, RavenHouse, aztecnetwork. ## Notes for reviewers - All product links were verified against live sources (azguardwallet.io, shield.human.tech from #24831, nemi.fi, ravenhouse.xyz, aztecscan.xyz, aztec.network/projects). - Obsidion (project discontinued) and Aztec Explorer (stale) are deliberately not referenced; Aztecscan is the only explorer linked. Wallet discovery beyond Azguard routes through the ecosystem page. - Unannounced apps are intentionally not referenced; the apps page routes discovery through the ecosystem page so launches slot in without doc changes. - Safety and app pages consistently push users to open wallets/bridges from the ecosystem page rather than search results, as the anti-phishing default. ## Testing - `cspell` clean on all touched files. - `sidebars-participate.js` loads (node require check). - Internal links checked against existing routes/anchors (`/participate/alpha#security-disclosures`, `/participate/basics/bridging#timing-considerations`, `/participate/basics/fees#how-to-get-fee-juice`, `/networks`). --- *Created by [claudebox](https://claudebox.work/v2/sessions/05615d3c90df3a72/jobs/1) · group: `slackbot` · [Slack thread](https://aztecfoundation.slack.com/archives/C0B24G1GFGB/p1784724990900569?thread_ts=1784724990.900569&cid=C0B24G1GFGB)*
2 parents 6228fa1 + ad5e296 commit e352885

8 files changed

Lines changed: 259 additions & 4 deletions

File tree

docs/docs-participate/apps.md

Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
---
2+
title: Explore apps
3+
description: Discover wallets, payments, DeFi, and other apps live on the Aztec network, and where to find the up-to-date ecosystem list.
4+
displayed_sidebar: participateSidebar
5+
---
6+
7+
# Explore apps on Aztec
8+
9+
Aztec is more than infrastructure: there are apps you can use today. This page shows what kinds of apps exist and where to find the current list.
10+
11+
:::caution Third-party software
12+
Most apps listed here are built by independent ecosystem teams, not by Aztec Labs or the Aztec Foundation. They are early-stage software on an [Alpha network](/participate/alpha). Do your own research and start with small amounts.
13+
:::
14+
15+
## Where to find apps
16+
17+
The ecosystem moves fast, so the docs deliberately do not try to maintain a full list. Two sources stay current:
18+
19+
- The [**Aztec ecosystem page**](https://aztec.network/projects) - the official directory, filterable by category (wallets, bridges, DeFi, and more). When in doubt, open apps from here rather than from search results.
20+
- The [**awesome-aztec repo**](https://github.com/AztecProtocol/awesome-aztec) - a community-maintained list of projects and tools on GitHub.
21+
22+
## What you can do today
23+
24+
### Hold and send privately
25+
26+
Consumer wallets like [Azguard](https://azguardwallet.io/) (browser extension) let you hold assets and make private transfers. See [Wallets](/participate/basics/wallets) for how Aztec wallets work and the [Get started guide](/participate/get-started) for setup steps.
27+
28+
### Bridge assets from Ethereum
29+
30+
Bridge apps move assets between Ethereum and Aztec. [Shield](https://shield.human.tech/) bridges assets into Aztec, including converting $AZTEC into [Fee Juice](/participate/basics/fees) to pay transaction fees. Find the current list in the Bridges category of the [ecosystem page](https://aztec.network/projects), and read [Bridging](/participate/basics/bridging) to understand deposits, withdrawals, and timing before your first transfer.
31+
32+
### Trade and use DeFi
33+
34+
Private trading is one of Aztec's headline use cases. For example, [Nemi](https://nemi.fi) is a DEX where you can swap tokens without exposing your identity or positions.
35+
36+
### Collect and play
37+
38+
Projects like [RavenHouse](https://www.ravenhouse.xyz/) bring NFTs with private ownership to Aztec, and games are an active area of ecosystem development. Watch the [ecosystem page](https://aztec.network/projects) and [official Aztec channels](/participate/safety#official-aztec-links) for launches.
39+
40+
### Follow the network
41+
42+
Block explorers like [Aztecscan](https://aztecscan.xyz) let anyone inspect public network activity. Private transaction details (sender, recipient, amount) are not visible on explorers. You can confirm your transaction was included without revealing what it did.
43+
44+
## Before you connect
45+
46+
A few habits keep you safe when trying new apps:
47+
48+
1. Open apps from the [ecosystem page](https://aztec.network/projects), not from ads or chat links.
49+
2. Check what a transaction does before approving it in your wallet.
50+
3. Use small amounts while apps and the network are in Alpha.
51+
52+
See [Staying safe](/participate/safety) for the full guidance.
53+
54+
---
55+
56+
:::tip Building an app?
57+
If you would rather build than use, start with the [Developer Guides](/developers/overview).
58+
:::

docs/docs-participate/basics/bridging.md

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -89,9 +89,17 @@ Aztec's ZK proofs provide strong guarantees - if a proof verifies on L1, the sta
8989

9090
## Using Bridges
9191

92-
Bridging typically involves interacting with the portal contract on L1 (for deposits) or initiating a withdrawal on L2 (for withdrawals). The exact interface depends on the specific bridge implementation and any frontend tooling built around it.
92+
You usually will not interact with portal contracts directly. You have a few options for moving assets to Aztec:
9393

94-
You usually will not interact with portal contracts directly. Bridge applications handle the portal interaction for you: [Shield](https://shield.human.tech/) is a bridge for moving assets into Aztec, including converting $AZTEC into [Fee Juice](/participate/basics/fees) to pay transaction fees, with bridge-plus-swap functionality rolling out as well. To connect to a bridge app you need an Aztec [wallet](/participate/basics/wallets) such as [Azguard](https://azguardwallet.io/).
94+
- **Bridge apps** - [Shield](https://shield.human.tech/) is a bridge for moving assets into Aztec, including converting $AZTEC into [Fee Juice](/participate/basics/fees) to pay transaction fees, with bridge-plus-swap functionality rolling out as well. To connect to a bridge app you need an Aztec [wallet](/participate/basics/wallets) such as [Azguard](https://azguardwallet.io/). Find the current list of bridges in the Bridges category of the [Aztec ecosystem page](https://aztec.network/projects).
95+
- **Wallet and app flows** - Some Aztec wallets and apps include bridging or funding flows directly, so check your wallet before reaching for a separate bridge.
96+
- **Direct contract interaction** - Advanced users can interact with portal contracts directly. Official contract addresses are listed on the [networks page](/networks).
97+
98+
:::caution Verify before you bridge
99+
Fake bridge sites are a common scam. Open bridge apps from the [ecosystem page](https://aztec.network/projects) rather than from search results or links sent to you in chat, and read [Staying safe](/participate/safety) before your first deposit.
100+
:::
101+
102+
New to Aztec? The [Get started guide](/participate/get-started) walks through funding your account step by step.
95103

96104
---
97105

docs/docs-participate/basics/wallets.md

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,14 @@ With Azguard you can:
2020
- Connect to Aztec applications, such as the [Shield](https://shield.human.tech/) bridge for [getting Fee Juice](/participate/basics/fees#how-to-get-fee-juice)
2121
- Sign and send transactions, with proofs generated on your device
2222

23+
### Other wallets
24+
25+
Ecosystem teams are building more wallets for everyday users, and availability changes quickly at this stage. Check the Wallets category of the [Aztec ecosystem page](https://aztec.network/projects) for the current list.
26+
27+
:::caution Install from official sources only
28+
Fake wallet extensions and apps are a common scam. Open wallet download pages from the [ecosystem page](https://aztec.network/projects) or the wallet team's official channels, never from search ads or links sent to you in chat. See [Staying safe](/participate/safety).
29+
:::
30+
2331
### Aztec CLI Wallet
2432

2533
The Aztec CLI wallet is the reference wallet packaged and maintained by the Aztec team. It is a command-line tool that handles account creation, transaction signing, and private state management. It is aimed at developers and advanced users.
@@ -91,7 +99,7 @@ The Aztec team is working on hardware wallet integration. Ledger and Trezor supp
9199

92100
## Choosing a Wallet
93101

94-
When selecting an Aztec wallet, consider:
102+
When comparing the wallets listed on the [ecosystem page](https://aztec.network/projects), consider:
95103

96104
| Factor | What to Look For |
97105
|--------|------------------|
@@ -109,6 +117,10 @@ When selecting an Aztec wallet, consider:
109117

110118
---
111119

120+
:::tip Ready to set one up?
121+
The [Get started guide](/participate/get-started) walks through wallet setup, funding your account, and your first transaction.
122+
:::
123+
112124
:::tip For developers
113125
Learn about building wallet integrations in the [Wallets documentation](/developers/docs/foundational-topics/wallets).
114126
:::
Lines changed: 99 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,99 @@
1+
---
2+
title: Get started
3+
description: A step-by-step path for new Aztec users - get a wallet, fund your account, make your first private transaction, and explore apps.
4+
displayed_sidebar: participateSidebar
5+
---
6+
7+
# Get started on Aztec
8+
9+
New to Aztec and want to use the network, not build on it? This page is the ordered path: get a wallet, fund your account, make your first private transaction, explore apps, and stay safe along the way.
10+
11+
:::caution Alpha network
12+
Aztec is in its **Alpha** phase, a live mainnet where bugs, including critical ones, are expected. Use small amounts, and read the [Alpha Network](/participate/alpha) page before you start.
13+
:::
14+
15+
## 1. Understand what you are using
16+
17+
Aztec is a privacy-first Layer 2 network on Ethereum. In practice that means:
18+
19+
- Your transactions are proven correct **on your own device**, so your private data never leaves it. The network only sees a proof.
20+
- Apps and users choose what stays private (like balances, identities, and amounts) and what is public.
21+
- Aztec settles to Ethereum, so it inherits Ethereum's security while transactions stay cheap and private.
22+
23+
For a 90-second explainer, watch the video on the [Participate overview](/participate). For more depth, the [Basics of Aztec](/participate/basics/transactions) pages explain how it all works.
24+
25+
## 2. Get a wallet
26+
27+
You need an Aztec wallet. Aztec wallets are different from Ethereum wallets: they manage your private state and generate proofs on your device, so an Ethereum-only wallet is not enough on its own.
28+
29+
- [**Azguard**](https://azguardwallet.io/) is a browser extension wallet, and currently the wallet to use for interacting with Aztec apps from your browser. It connects to Aztec apps the same way MetaMask connects to Ethereum apps: a website requests a connection, and you approve it in the extension.
30+
- More wallets are appearing as the ecosystem grows. Find the current list in the Wallets category of the [Aztec ecosystem page](https://aztec.network/projects).
31+
32+
These are early-stage products on an early-stage network, so expect rough edges.
33+
34+
:::caution Install from official sources only
35+
Fake wallet extensions are a common scam. Open wallet download pages from the [ecosystem page](https://aztec.network/projects) or the wallet team's official channels, never from search ads or links sent to you in chat. See [Staying safe](/participate/safety).
36+
:::
37+
38+
The [Wallets](/participate/basics/wallets) page explains what makes Aztec wallets different and how to choose one.
39+
40+
## 3. Fund your account
41+
42+
Aztec is a Layer 2, so assets come in from Ethereum through bridges:
43+
44+
- **Bridge apps** walk you through depositing from Ethereum. [Shield](https://shield.human.tech/) bridges assets into Aztec, including converting $AZTEC into **Fee Juice**, the network's fee asset. Find the current list of bridges on the [ecosystem page](https://aztec.network/projects).
45+
- **Some wallets and apps** include funding flows directly, so check your wallet first.
46+
47+
Transaction fees are paid in Fee Juice, which you get by bridging $AZTEC from Ethereum (bridge apps handle this for you). Many apps also sponsor fees for their users through fee-paying contracts, so you can often start transacting without any Fee Juice of your own. See [Fees](/participate/basics/fees) for how to get Fee Juice and [Bridging](/participate/basics/bridging) for what happens under the hood.
48+
49+
## 4. Make your first transaction
50+
51+
Once your wallet holds funds, try a private transfer:
52+
53+
1. **Receive**: share your Aztec address (or your wallet's payment link or QR code) with the sender. Incoming private transfers are visible only to you.
54+
2. **Send**: enter the recipient's address and amount in your wallet and confirm. Your wallet generates a proof on your device before submitting, so the first transaction can take a little longer than you may be used to.
55+
3. **Check the result**: your wallet shows the transaction status. You can also look it up on a block explorer like [Aztecscan](https://aztecscan.xyz), keeping in mind that private details (sender, recipient, amount) are not visible there, which is the point.
56+
57+
The [Transactions](/participate/basics/transactions) page explains what happens behind the scenes.
58+
59+
## 5. Explore apps
60+
61+
Payments, trading, collectibles, and more are live on Aztec, with new apps launching regularly. See [Explore apps](/participate/apps) for what you can try today and where to find the up-to-date list.
62+
63+
## Stay safe
64+
65+
Three rules cover most risks:
66+
67+
1. Never share your seed phrase or private keys with anyone, ever.
68+
2. Only open wallets, bridges, and apps from links on the [official ecosystem page](https://aztec.network/projects) or other [official Aztec channels](/participate/safety#official-aztec-links).
69+
3. Treat Alpha as early software: start with small amounts.
70+
71+
Read [Staying safe](/participate/safety) for the full list of official links and common scams to avoid.
72+
73+
## Get help
74+
75+
- The [Aztec Discord](https://discord.gg/aztec) is the fastest place to ask questions.
76+
- The [Aztec forum](https://forum.aztec.network/) is best for longer discussions.
77+
- For wallet or app issues, check that project's own support channels, linked from the [ecosystem page](https://aztec.network/projects).
78+
- Found a security vulnerability? Report it privately following the [security disclosure process](/participate/alpha#security-disclosures), not in public channels.
79+
80+
## Key terms in plain language
81+
82+
| Term | Meaning |
83+
|------|---------|
84+
| **Layer 2 (L2) / rollup** | A network that runs on top of Ethereum (Layer 1), batching many transactions and posting proofs to Ethereum for security |
85+
| **Mainnet vs testnet** | Mainnet uses real assets; testnet is a free practice network. Aztec's live mainnet phase is called Alpha |
86+
| **Note** | A piece of private state, like a private "coin" only you can see and spend |
87+
| **PXE** | Private eXecution Environment: the part of your wallet that runs private transactions and generates proofs on your device |
88+
| **Mana** | Aztec's unit of computational work, like Ethereum's gas |
89+
| **$AZTEC / Fee Juice** | $AZTEC is the network's token on Ethereum, used for fees, staking, and governance. Fee Juice is the non-transferable fee asset created on Aztec by bridging $AZTEC |
90+
| **Sequencer** | A network operator that orders transactions into blocks |
91+
| **Prover** | A network operator that generates the proofs posted to Ethereum |
92+
| **Bridge / portal** | The mechanism that moves assets between Ethereum and Aztec |
93+
| **Epoch** | A batch of blocks proven together before settling on Ethereum |
94+
95+
---
96+
97+
:::tip Want to go deeper?
98+
Learn how the network operates in [Basics of Aztec](/participate/basics/addresses), or read about the [$AZTEC token](/participate/token) and [governance](/participate/governance).
99+
:::

docs/docs-participate/index.md

Lines changed: 17 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,10 @@ Welcome to the Participate section. Here you'll find educational content about h
1212
Aztec is currently in its **Alpha** phase, a live mainnet where bugs, including critical ones, are expected. Before using the network, read the [Alpha Network](/participate/alpha) page to understand current limitations, security expectations, and what to expect from rollup upgrades.
1313
:::
1414

15+
:::tip New to Aztec? Start here
16+
The [Get started guide](/participate/get-started) gives you an ordered path: get a wallet, fund your account, make your first private transaction, [explore apps](/participate/apps), and [stay safe](/participate/safety) along the way.
17+
:::
18+
1519
import YouTubeEmbed from '@site/src/components/YouTubeEmbed';
1620

1721
## What is Aztec?
@@ -20,9 +24,17 @@ This explainer covers what Aztec is in under 90 seconds (find more on the [video
2024

2125
<YouTubeEmbed videoId="urcBvo2QJp0" title="What is Aztec: Explained in Under 90 Seconds" />
2226

27+
## Using Aztec
28+
29+
Want to use the network as a user?
30+
31+
- [**Get started**](/participate/get-started) - Step-by-step onboarding: wallet, funds, first transaction
32+
- [**Explore apps**](/participate/apps) - Wallets, payments, DeFi, and more built on Aztec
33+
- [**Staying safe**](/participate/safety) - Official links and how to avoid scams
34+
2335
## Basics of Aztec
2436

25-
New to Aztec? Start here to understand the fundamentals:
37+
Want to understand the fundamentals? Start here:
2638

2739
- [**Addresses**](/participate/basics/addresses) - How addresses work on Aztec
2840
- [**Wallets**](/participate/basics/wallets) - Available wallets and hardware wallet support
@@ -54,6 +66,10 @@ Understand how the protocol evolves through decentralized governance:
5466

5567
---
5668

69+
:::tip Ready to use Aztec?
70+
If you want to try the network today, follow the [Get started guide](/participate/get-started).
71+
:::
72+
5773
:::tip Ready to build?
5874
If you're a developer looking to build on Aztec, head over to the [Developer Guides](/developers/overview).
5975
:::

0 commit comments

Comments
 (0)