Skip to content

docs: rewrite wallet section around WalletAdapter #522

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
collinsezedike merged 2 commits into from
Aug 19, 2026
Merged

docs: rewrite wallet section around WalletAdapter #522

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
4742e90
docs(architecture): document WalletAdapter, drop connectFreighter ref
GazzyLee Aug 16, 2026
ba7446a
docs: remove em dash from frontend.md
collinsezedike Aug 19, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 16 additions & 1 deletion apps/docs/architecture/frontend.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,22 @@ useVaultActions.deposit(amount, vaultId)
}
```

Connection is triggered by `useWalletConnect`, which calls `connectFreighter()` and persists the public key. The store is not persisted to `localStorage`; users re-connect on page load.
### WalletAdapter abstraction

Frontend code never talks to a wallet SDK directly. It depends on the `WalletAdapter` interface in `apps/web/src/lib/wallet.ts`, which every supported wallet implements:

```typescript
interface WalletAdapter {
isInstalled(): Promise<boolean>;
isAuthorized(): Promise<boolean>;
connect(): Promise<string>;
sign(xdr: string, networkPassphrase: string): Promise<string>;
}
```

`useWalletConnect` drives the connection flow through this interface: it calls `wallet.isInstalled()` to detect the extension and `wallet.connect()` to request access, then persists the returned public key in the store. On page load the store revalidates a restored key via `wallet.isAuthorized()`.

The only implementation today is `FreighterWallet`, exported as `wallet`. Adding a wallet (e.g. xBull, LOBSTR) means adding a new `WalletAdapter` implementation and selecting it in `wallet.ts`. No callers change.

## API client

Expand Down
Loading