Deployment Reference

🏠 Home > Technical Reference > Deployment

All current contract addresses, deployment metadata, and infrastructure configuration for Aurellion on Base Sepolia (testnet).

Source of truth: chain-constants.ts and deployments/baseSepolia-*.json in the monorepo. Always cross-reference these files if you suspect an address has changed.

---

Network

---

Primary Diamond

Single entry point for all Aurellion contract interactions.

⚠️ V2 Note: This Diamond replaced an earlier deployment (0x2516CAdb7b3d4E94094bC4580C271B8559902e3f) that had storage conflicts between V1 and V2 order book structures. Always use this address.

---

Diamond Facet Implementations

All addresses sourced directly from deployment JSON files. Block numbers = when the facet implementation was deployed (not when it was cut into the Diamond).

⭐ = Key integration points.

---

Legacy / Standalone Contracts

Pre-Diamond architecture. No longer the primary system. Kept for historical data and legacy integrations.

---

Tokens

---

Deployment Block Reference

---

Frontend Environment Variables

# Contract addresses (from chain-constants.ts — do not hardcode manually)
NEXT_PUBLIC_DIAMOND_ADDRESS=0x8ed92Ff64dC6e833182a4743124FE3e48E2966A7
NEXT_PUBLIC_AURA_ASSET_ADDRESS=0xb3090aBF81918FF50e921b166126aD6AB9a03944
NEXT_PUBLIC_QUOTE_TOKEN_ADDRESS=0xe727f09fd8Eb3CaFa730493614df1528Ba69B1e6
NEXT_PUBLIC_QUOTE_TOKEN_SYMBOL=AURA
NEXT_PUBLIC_QUOTE_TOKEN_DECIMALS=18

# Indexer (also in chain-constants.ts)
NEXT_PUBLIC_INDEXER_URL=https://indexer.aurellionlabs.com/graphql

# RPC (never commit API keys)
NEXT_PUBLIC_RPC_URL_84532=https://base-sepolia.rpc.provider/<api-key>

# Auth
NEXT_PUBLIC_PRIVY_APP_ID=<your-privy-app-id>

# Chain
NEXT_PUBLIC_DEFAULT_CHAIN_ID=84532

Note: Most of these are auto-exported from chain-constants.ts. Import directly: import { NEXT_PUBLIC_DIAMOND_ADDRESS } from '@/chain-constants'

---

Indexer Environment Variables

NEXT_PUBLIC_RPC_URL_84532=https://base-sepolia.rpc.provider/<api-key>
NEXT_PUBLIC_DIAMOND_ADDRESS=0x8ed92Ff64dC6e833182a4743124FE3e48E2966A7
POSTGRES_PASSWORD=<your-postgres-password>
DATABASE_URL=postgresql://postgres:<password>@postgres:5432/ponder_indexer
DATABASE_SCHEMA=public

---

Deploying New Facets

# 1. Write and test the new facet
bunx --bun hardhat test test/<facet>/

# 2. Compile
bunx --bun hardhat compile

# 3. Deploy facet implementation
bunx --bun hardhat run scripts/unified-deploy.ts --network baseSepolia
# Output: baseSepolia-<timestamp>.json with new facet address

# 4. Get function selectors for the facet
bun scripts/get-selectors.ts --contract NewFacet

# 5. Execute diamondCut (Add / Replace / Remove)
bunx --bun hardhat run scripts/diamond-cut.ts --network baseSepolia \
  --facetAddress <NEW_ADDRESS> --action Add --selectors <sel1,sel2,...>

# 6. Verify on Basescan
bunx --bun hardhat verify --network baseSepolia <NEW_ADDRESS>

# 7. If new events: regenerate indexer schema
bun run generate:indexer
# Review generated-schema.ts — new tables should appear

# 8. Commit + push → GitHub Actions builds new Docker image → deploys indexer
# (Deployment is automatic via .github/workflows/deploy-indexer.yml)

# 9. chain-constants.ts is auto-updated by deployment scripts
# Commit and push the updated chain-constants.ts

---

Running the Indexer

The indexer runs as a Docker container — never directly with Node, Bun, or any process manager on the host.

# Production (SSH to server at /srv/Web/indexer)
docker compose -f docker-compose.prod.yml up -d          # Start
docker compose -f docker-compose.prod.yml logs -f indexer # Tail logs
docker compose -f docker-compose.prod.yml ps              # Status
docker compose -f docker-compose.prod.yml restart indexer # Restart
docker compose -f docker-compose.prod.yml stop indexer    # Stop

# Local dev
cd indexer && docker compose up -d   # Postgres + pgAdmin
ponder dev                           # Ponder with hot reload

Image: ghcr.io/aurellionlabs/web/indexer:<branch> (from GHCR)

See Indexer/Ponder Setup for full Docker documentation.

---

Mainnet Readiness Checklist

• Replace AURA quote token with USDC (change QUOTE_TOKEN_DECIMALS to 6)
• Independent security audit (BridgeFacet, CLOBMatchingFacet, AuSysFacet, RWYStakingFacet)
• Set Diamond owner to multisig
• Set feeRecipient to multisig
• Set emergencyTimelock to production value
• Configure commitmentThreshold for USDC 6-decimal precision
• KYC/KYB process for node operators
• Node validation off-chain pipeline
• Price oracle integration for circuit breaker thresholds
• Gas benchmarking on Base mainnet

---

Related Pages

• Architecture/Diamond Proxy Pattern
• Smart Contracts/Overview
• Indexer/Ponder Setup
• Technical Reference/Upgrading Facets