Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.vaulkyrie.xyz/llms.txt

Use this file to discover all available pages before exploring further.

The browser extension is the main Vaulkyrie user experience. It is a Vite React app with extension background, content, and injected-provider runtimes.

​
Runtime files

RuntimeSource
React entrysrc/main.tsx
App shellsrc/App.tsx
Background runtimesrc/background/index.ts
Content scriptsrc/content/index.ts
Injected providersrc/injected/index.ts
Extension messagessrc/extension/messages.ts
Approval preview/storagesrc/extension/approvalPreview.ts, src/extension/approvalStorage.ts

​
Account kinds

The wallet supports multiple account modes through shared wallet state and account helpers:
  • Threshold Vault
  • Privacy Vault
  • PQC Wallet
Signing selection happens through account-kind checks in src/services/frost/signTransaction.ts.

​
Signing entry points

FunctionSourceUse
signMessageBytessrc/services/frost/signTransaction.tsSigns arbitrary message bytes with Threshold Vault or Privacy Vault path.
signSerializedTransactionsrc/services/frost/signTransaction.tsSigns serialized legacy or versioned Solana transactions.
signAndSendTransactionsrc/services/frost/signTransaction.tsSigns and submits a legacy transaction.
signAndSendVersionedTransactionsrc/services/frost/signTransaction.tsSigns and submits a versioned transaction.
prepareQuantumVaultAdvanceInBackgroundsrc/background/quantumVaultSession.tsPrepares a PQC wallet advance signature and next key record.

​
Approval flow

​
Wallet state

Wallet state is managed in src/store/walletStore.ts and persisted through src/lib/walletPersistStorage.ts. Backup and restore helpers live in src/lib/walletBackup.ts. Secret access is mediated by background session helpers:
  • src/background/sessionState.ts
  • src/background/vaultSession.ts
  • src/background/quantumVaultSession.ts

​
Build scripts

npm install
npm run build
npm run lint