> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pacificalens.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect a wallet and configure trading on Pacifica Lens

> Connect Phantom, Solflare, Backpack, or a Privy embedded wallet — covers first-order Builder Code approval and Agent Key setup for auto copy trading.

Connecting a Solana wallet unlocks trading, copy trading, the AI Assistant, and your personal portfolio view. The connection flow uses [Privy](https://privy.io) and supports browser extension wallets as well as an in-app embedded wallet that requires no extension at all.

## What requires a wallet

| Feature                                   | Guest | Wallet required |
| ----------------------------------------- | ----- | --------------- |
| All 63 market prices, charts, order books | Yes   | —               |
| Risk Manager calculator                   | Yes   | —               |
| Liquidation Monitor                       | Yes   | —               |
| Arbitrage Scanner                         | Yes   | —               |
| AlphaBoard (view only)                    | Yes   | —               |
| Trade execution                           | —     | Yes             |
| AI Assistant                              | —     | Yes             |
| Copy trading (manual and auto)            | —     | Yes             |
| Personal portfolio and trade history      | —     | Yes             |
| Portfolio risk tab (live positions)       | —     | Yes             |

## Supported wallets

* **Phantom** — browser extension
* **Solflare** — browser extension
* **Backpack** — browser extension
* **Privy embedded** — in-app wallet, no extension needed

## Connect your wallet

<Steps>
  <Step title="Open the landing page">
    Go to [pacificalens.xyz](https://www.pacificalens.xyz). You'll see the interactive 3D globe with a **Connect Wallet to Start** button at the bottom of the screen.
  </Step>

  <Step title="Click Connect Wallet to Start">
    Click the **Connect Wallet to Start** button. Privy opens a modal that lists your available wallet options. If you don't have a browser extension installed, select the embedded wallet option — Privy will create an in-app wallet for you.
  </Step>

  <Step title="Approve the connection in your wallet">
    Your wallet extension (or the embedded wallet UI) will ask you to approve the connection. Confirm the request. You won't be asked to sign a transaction at this stage — this is a read-only connection approval.
  </Step>

  <Step title="Enter the dashboard">
    Once connected, the button changes to **Enter Dashboard →**. Click it to go to the Market Overview. A 5-slide onboarding modal appears on your first visit to introduce each feature — you can skip it at any time.
  </Step>
</Steps>

<Tip>
  If you want to explore market data before committing to a connection, click **Continue as Guest →** below the connect button. You can connect a wallet later from the header at any time.
</Tip>

## Builder Code approval

The first time you place an order on Pacifica Lens, you'll be prompted to sign a one-time Builder Code approval transaction. This approves the `PACIFICALENS` builder code on your account.

You only sign this transaction once. After approval, every subsequent order is tagged to `PACIFICALENS` automatically — no additional prompts. The approval supports all wallet types (Phantom, Solflare, Backpack, and Privy embedded) with automatic provider fallback.

<Info>
  The Builder Code tags your orders to Pacifica Lens for attribution and fee-rebate eligibility. It does not grant Pacifica Lens any authority over your funds or account. You remain in full control of every trade you place.
</Info>

## Agent Keys

Agent Keys are delegated signing keys that let Pacifica Lens place orders on your account automatically — without requiring you to approve each trade individually. They are required for **Auto Copy Trading**.

### How Agent Keys work

When you configure an Agent Key, Pacifica Lens uses it to sign copy-trading orders on your behalf entirely within your browser. The key never leaves your browser — it is stored only in your browser's local storage and is never transmitted to any server.

### Set up an Agent Key

<Steps>
  <Step title="Go to Pacifica.fi Account Settings">
    Log in to [app.pacifica.fi](https://app.pacifica.fi) with the same wallet you connected to Pacifica Lens. Navigate to **Account Settings**.
  </Step>

  <Step title="Generate an Agent Key pair">
    In Account Settings, find the **Agent Keys** section and generate a new key pair. Pacifica will show you the public key and private key. Copy the private key immediately — you will not be able to view it again.
  </Step>

  <Step title="Approve the Agent Key on-chain">
    Pacifica will prompt you to sign a transaction that registers the Agent Key's public key on your account. This is a one-time on-chain approval.
  </Step>

  <Step title="Paste the private key into Pacifica Lens">
    In Pacifica Lens, open the **Copy Trading** section and click the Agent Key configuration panel. Paste your private key into the field provided. The key is saved to your browser's local storage only.
  </Step>

  <Step title="Enable Auto Copy Trading">
    Star a trader on the AlphaBoard to add them to your **Watching** tab, then toggle **Auto Copy** on. Pacifica Lens will scan the trader's positions every 10 seconds and mirror new trades automatically.
  </Step>
</Steps>

<Warning>
  Never share your Agent Key private key with anyone. Anyone who has your private key can place trades on your Pacifica account. Pacifica Lens will never ask for your key outside the copy trading configuration panel — if you are asked for it anywhere else, do not provide it.
</Warning>

## Disconnect your wallet

To disconnect, click your wallet address in the header and select **Disconnect**. Your Agent Key (if configured) remains in your browser's local storage until you clear it manually from the copy trading settings panel or clear your browser data.