VaultProvider

Manages an encrypted in-memory seed vault. The decrypted key lives in a useRef — it never appears in React state, Redux, or DevTools. Add this provider when your app manages keys directly, as opposed to delegating signing to an external wallet.

Requires QubicProvider as an ancestor.

Usage

import { QubicProvider, VaultProvider } from "@qubic.org/react"
import { importVault } from "@qubic.org/wallet"

const vaultData = importVault(localStorage.getItem("vault")!)

export function App() {
  return (
    <QubicProvider liveClient={live}>
      <VaultProvider vaultData={vaultData} persistSession autoLockMs={15 * 60_000}>
        {children}
      </VaultProvider>
    </QubicProvider>
  )
}

Props

Notes

• When persistSession is enabled, the Web Crypto API stores the key with extractable: false. The key is available for signing operations but its raw bytes can never be read back out.
• VaultProvider is independent of WalletProvider — either or both can be omitted depending on your app's signing strategy.