> For the complete documentation index, see [llms.txt](https://docs.heaa.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.heaa.xyz/heaa-dark-pool/architecture.md).

# Architecture

Architecture Overview

HEAA Dark Pool is a web dApp. Everything that matters for your privacy and your keys happens in your browser, on your device.

### The pieces

**The app (your browser).** This is where you connect your wallet, where your private keys are derived, and where transactions are built and signed. Nothing sensitive leaves your device.

**Your wallet.** You connect a standard Solana wallet (such as Phantom). It signs the transactions our dApp builds. Because signing happens in your wallet, you approve every action explicitly.

**The dark pool.** This is the private layer our dApp operates on. When you shield funds, they enter an encrypted account inside the pool. Transfers inside the pool move value between encrypted accounts without publishing a public link between them. This is what makes your balance and your sends private.

**MPC settlement (Arcium).** The private computations that make the pool work — proving you own funds without revealing which funds, and settling transfers without exposing the parties — are handled through secure multi-party computation (MPC) powered by Arcium. In plain terms: the network can verify everything is valid without any single party ever seeing your private details.

### How a private action flows

1. You take an action in the app (shield, send, swap, unshield).
2. Our dApp builds the necessary transactions in your browser.
3. Your wallet signs them — you approve in the wallet popup.
4. The transactions settle on Solana, with the private parts handled through MPC so nothing sensitive is exposed.
5. Your balances update in the app.

At no point does the app hold your keys or your funds.

***

*HEAA Dark Pool's privacy layer is built on the Umbra program, an encrypted-account protocol on Solana. HEAA Dark Pool orchestrates Umbra together with private swaps, natural-language commands, and a unified interface to make private operations simple end to end.*