Aztec Wallet Integration

This document explains how we integrated Aztec wallet creation into Nebula, allowing for automated account creation during user registration.

Overview

The integration allows your application to:

• Create Aztec accounts programmatically during user registration
• Store wallet information securely
• Handle the complexities of the Aztec CLI
• Prevent duplicate wallet creation for existing users

Prerequisites

• Node.js 14.x or later
• Next.js application
• Docker installed and running
• Aztec Sandbox installed

Installation

1. Install the Aztec toolchain:

   bash -i <(curl -s https://install.aztec.network)

2. Install required dependencies:

   npm install child_process fs path util

3. For MacOS users, install socat:

   brew install socat

4. Start the Aztec sandbox:

   aztec start --sandbox

How to setup this project

1. fork and clone the repository

2. run the npm installation command

npm install

3. copy the env.template into an env.local and provide the credentials needed inside it

   cp env.template env.local

4. make sure to start your docker engine and the aztec sandbox. Install the sandbox if you haven't

aztec start --sandbox

5. run the app on development

npm run dev

6. visit the local development url and register or login with Google to get access to all the features.

Happy Hacking

Maintenance

Updating Aztec

To update the Aztec toolchain:

aztec-up

Checking Wallet Information

To verify wallet information for a user directly from the CLI:

aztec-wallet get-alias accounts:<alias>

Troubleshooting

If you encounter issues:

1. Ensure the Aztec sandbox is running: aztec status
2. Restart the sandbox: aztec stop && aztec start --sandbox
3. Check for errors in the logs: aztec logs
4. Try creating a wallet manually to verify the CLI works: aztec-wallet create-account -a test-account -payment method=fee_juice,feePayer=test0