Skip to main content

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.

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

What requires a wallet

FeatureGuestWallet required
All 63 market prices, charts, order booksYes
Risk Manager calculatorYes
Liquidation MonitorYes
Arbitrage ScannerYes
AlphaBoard (view only)Yes
Trade executionYes
AI AssistantYes
Copy trading (manual and auto)Yes
Personal portfolio and trade historyYes
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

1

Open the landing page

Go to pacificalens.xyz. You’ll see the interactive 3D globe with a Connect Wallet to Start button at the bottom of the screen.
2

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.
3

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.
4

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.
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.

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.
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.

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

1

Go to Pacifica.fi Account Settings

Log in to app.pacifica.fi with the same wallet you connected to Pacifica Lens. Navigate to Account Settings.
2

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.
3

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.
4

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.
5

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.
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.

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.