Starkzap - Bitcoin in your app in minutes

---

Bring Bitcoin, stablecoins, and DeFi to any web or mobile app via Starknet in minutes. One TypeScript SDK: wallets, tokens, staking, and gasless transactions — with a clean API and great UX. Starknet’s account abstraction lets you hide blockchain complexity (no seed phrases, optional gasless flows). Works on web (React, Vite, etc.), iOS & Android (React Native, Expo), and Node.js backends.

Full documentation: docs.starknet.io/build/starkzap

List of curated applications built through Starkzap : awesome-starkzap

---

Installation

npm install starkzap

Dependency and optional peers:

• starknet (v9+) — Starknet.js core (installed with starkzap)
• @cartridge/controller — optional peer, only needed for Cartridge support

For specific integrations, you may need:

• Privy (server): npm install @privy-io/node — see Privy integration
• Privy (React Native / Expo): see the Privy docs for the Expo SDK
• AVNU Paymaster: no extra package; configure a paymaster URL — see Paymasters and AVNU integration

---

Quick Start

import {
  StarkSDK,
  StarkSigner,
  Amount,
  fromAddress,
  sepoliaTokens,
} from "starkzap";

const STRK = sepoliaTokens.STRK;
const sdk = new StarkSDK({ network: "sepolia" });

const wallet = await sdk.connectWallet({
  account: { signer: new StarkSigner("0xYOUR_PRIVATE_KEY") },
});

await wallet.ensureReady({ deploy: "if_needed" });

const balance = await wallet.balanceOf(STRK);
console.log(balance.toFormatted()); // "150.25 STRK"

const tx = await wallet.transfer(STRK, [
  { to: fromAddress("0xRECIPIENT"), amount: Amount.parse("10", STRK) },
]);
await tx.wait();

For onboarding flows (Privy, Cartridge, etc.) and more examples, see the Quick Start guide.

---

Documentation

All guides and API reference live on the Starknet docs site. We recommend starting with Quick Start.

• Overview
• Installation
• Quick Start
• Configuration
• Paymasters
• Connecting Wallets
• Transactions
• ERC20 Tokens
• Staking
• Transaction Builder
• Integrations — AVNU Paymaster, Privy, Cartridge
• Examples
• API Reference
• Glossary · Troubleshooting

---

Examples

The repo includes web, mobile, and server examples in examples/. See the Examples docs for run instructions and details.

---

Contributing

npm install
npm run typecheck
npm test                    # unit tests (some flows require reachable RPC/devnet)
npm run test:integration    # requires starknet-devnet
npm run lint
npm run prettier
npm run build

Token and validator presets can be regenerated with npm run generate:tokens, npm run generate:tokens:sepolia, npm run generate:validators, and npm run generate:validators:sepolia.

---

License

MIT — 0xLucqs