Full lesson
lazor-kit
The open-source passkey wallet infrastructure for Solana.
What it does
From the project README:
Passkey-native smart wallets on Solana. Users sign with FaceID / TouchID / Windows Hello, the paymaster covers gas, and on-chain RBAC + spending limits decide what actually goes through.
- Original
- lazor-kit/lazor-kit
- SuperStack fork
- Blockchains/lazor-kit @
20fd18a - Stars
- 35
- Last push (original)
- 2026-10-26
- Languages
- TypeScript, JavaScript, CSS, HTML
- Detected stack
- web3.js
- Categories
- Wallets & IdentityInfrastructure & Tooling
- Licence
- MIT
- Homepage
- https://lazorkit.com
Architecture
244 source files. By extension: .ts ×184, .tsx ×49, .js ×11.
| Top-level directory | Source files |
|---|---|
packages | 147 |
examples | 53 |
app | 44 |
Dapp: devnet deploy pending
⏳ Devnet deploy pending — goes live when the devnet wallet is topped up. This fork's own dapp is not deployed yet, so there is no program address or transaction to show. It is queued in dapp-queue.txt; once devnet SOL is available it is deployed, exercised with real devnet transactions, and this section switches to the live dapp at /dapps/lazor-kit/. Until then, the lesson and step-by-step guide below are complete, and you can run it locally with the commands below.
Key code, explained
Excerpts chosen automatically where the code uses the most Solana concepts, pinned to the fork's commit.
app/migrate/src/App.tsx L397–420 @ 20fd18a · MIT · original // too large, nothing has been sent — sign again. const migrateInstructions = plan.migrate.finalize(response); if (txBytes(migrateInstructions) > MAX_TX_BYTES) { throw new Error( 'Your browser made that signature a little larger than usual, and the move no longer ' + 'fits in one transaction. Nothing was sent — press Move again.', ); } const signatures: string[] = []; const send = async (instructions: TransactionInstruction[]) => { const { blockhash: recent } = await connection.getLatestBlockhash(); const message = new TransactionMessage({ payerKey: payer, recentBlockhash: recent, instructions, }).compileToV0Message(); const tx = new VersionedTransaction(message); let signature: string; if (local) { tx.sign([local]); signature = await connection.sendTransaction(tx); } else { signature = await paymaster.signAndSendVersionedTransaction(tx);- Line 408
const { blockhash: recent } = await connection.getLatestBlockhash();: Fetches a recent blockhash. Transactions expire if it gets too old. - Line 418
signature = await connection.sendTransaction(tx);: Submits the signed transaction to the cluster.
How to run, build and test
These commands come from the repo's own manifests (package.json scripts, Anchor.toml, Cargo, go.mod, Makefile). Check the README for prerequisites and environment variables.
| Directory | Command | Runs |
|---|---|---|
. | npm run dev | pnpm -r dev |
. | npm run build | pnpm -r build |
app/portal | npm run dev | vite |
app/portal | npm run build | tsc -b && vite build |
app/portal | npm run lint | eslint . |
app/migrate | npm run dev | vite |
app/migrate | npm run build | tsc -b && vite build |
packages/react | npm run dev | rollup -c -w |
packages/react | npm run build | rm -rf dist && rollup -c |
packages/react | npm run test | node --test test/deferred.test.mjs test/errors.test.mjs test/session-policy.test.mjs test/callbacks.test.mjs test/landed |
packages/react-native | npm run build | rollup --bundleConfigAsCjs -c rollup.config.js |
packages/react-native | npm run test | node --test test/deferred.test.cjs test/errors.test.cjs test/session-policy.test.cjs test/callbacks.test.cjs test/keys.t |
examples/expo-react-native | npm run start | expo start |
examples/expo-react-native | npm run lint | expo lint |
examples/squads-passkey-wallet | npm run start | expo start |
examples/squads-passkey-wallet | npm run lint | expo lint |
What you could build from it
- Fork the SuperStack copy and extend it within the Wallets & Identity gaps listed on the idea page.
- Learn the pattern first: Building and sending transactions from a client
- Learn the pattern first: Program Derived Addresses (PDAs)