Skip to main content
Version: Devnet (v3.0.0-devnet.20251212)

Connect to Local Network

This guide shows you how to connect your application to the Aztec local network and interact with the network.

Prerequisites​

  • Running Aztec local network (see Quickstart) on port 8080
  • Node.js installed
  • TypeScript project set up

Install dependencies​

yarn add @aztec/aztec.js@3.0.0-devnet.20251212 @aztec/test-wallet@3.0.0-devnet.20251212

Connect to the network​

Create a node client and TestWallet to interact with the local network:

import { createAztecNodeClient, waitForNode } from "@aztec/aztec.js/node";
import {
  TestWallet,
  registerInitialLocalNetworkAccountsInWallet,
} from "@aztec/test-wallet/server";

const nodeUrl = "http://localhost:8080";
const node = createAztecNodeClient(nodeUrl);

// Wait for the network to be ready
await waitForNode(node);

// Create a TestWallet connected to the node
const wallet = await TestWallet.create(node);

TestWallet is a development wallet that handles account management and transaction signing locally, suitable for testing and development.

Verify the connection​

Get node information to confirm your connection:

const nodeInfo = await node.getNodeInfo();
console.log("Connected to local network version:", nodeInfo.nodeVersion);
console.log("Chain ID:", nodeInfo.l1ChainId);

Load pre-funded accounts​

The local network has accounts pre-funded with fee juice to pay for gas. Register them in your wallet:

const [alice, bob] = await registerInitialLocalNetworkAccountsInWallet(wallet);

console.log(`Alice's address: ${alice.toString()}`);
console.log(`Bob's address: ${bob.toString()}`);

These accounts are pre-funded with fee juice (the native gas token) at genesis, so you can immediately send transactions without needing to bridge funds from L1.

Check fee juice balance​

Verify that an account has fee juice for transactions:

import { getFeeJuiceBalance } from "@aztec/aztec.js/utils";

const aliceBalance = await getFeeJuiceBalance(alice, node);
console.log(`Alice's fee juice balance: ${aliceBalance}`);

Next steps​