<>ts-stack
Get StartedArchitecturePackagesSpecsGuides
⌘K
Reference
Home
Get StartedOverviewInstallChoose your stackKey concepts
ArchitectureOverviewStack layersBEEF (BRC-62)BRC-100 Wallet InterfaceIdentity & AuthConformance pipeline
PackagesOverviewSDKWalletNetworkOverlaysMessagingMiddlewareHelpers
InfrastructureOverviewmessage-box-serveroverlay-serveruhrp-server-basicuhrp-server-cloud-bucketwabwallet-infrachaintracks-server
SpecsOverviewBRC-100 Wallet InterfaceOverlay HTTPMessage-box HTTPAuthsocket (WebSocket)BRC-31 Auth HandshakeBRC-29 Peer PaymentBRC-121 / HTTP 402ARC BroadcastMerkle ServiceStorage AdapterGASP SyncUHRPAir-Gap Optical (BRC-141)
ConformanceOverviewVector catalogTS runnerContributing vectors
GuidesOverviewBuild a wallet-aware appRun an overlay nodePeer-to-peer messagingHTTP 402 payments
ReferenceOverviewBRC indexRepository health
AboutVersioningContributingDoc agentDocumentation sources
Loading…
Edit this page on GitHub
© 2026 BSV Blockchain. ts-stack is open-source.
GitHubContributingVersioning

Architecture

The BSV TypeScript stack is organized as a foundation-to-application hierarchy. Each layer is a clean boundary that can be consumed independently.

Layers

LayerPackage(s)Who uses it
Foundation@bsv/sdkProtocol engineers — direct access to cryptographic primitives and script engine
Wallet InterfaceBRC-100 boundaryAll layers above communicate with wallets through this standard interface
Application wrapper@bsv/simpleApp developers — high-level payments, tokens, inscriptions, credentials
Wallet builder toolkit@bsv/wallet-toolboxWallet developers — assemble BRC-100-compliant wallets from modular pieces
Overlay network@bsv/overlay, @bsv/overlay-expressService operators — index and serve on-chain data
Messaging@bsv/authsocket, @bsv/message-box-clientApps needing encrypted P2P communication
Monetization@bsv/402-pay, @bsv/payment-express-middlewareAPIs requiring micropayment access control
Identity@bsv/auth-express-middleware, @bsv/authsocketApps requiring mutual authentication

Key Design Documents

  • Stack Layers — Detailed layer diagram and component map
  • BEEF (BRC-62) — Binary transaction exchange format, wire format, SPV validation
  • BRC-100 Wallet Interface — Vendor-neutral wallet boundary, method surface, advanced workflows
  • Identity & Auth — BRC-103/104, BRC-31, identity keys
  • Conformance Pipeline — How TS generates vectors; Go/Python/Rust runners

Cross-Cutting Concerns

Zero-dependency SDK — @bsv/sdk has no npm dependencies. This eliminates supply-chain risk in the cryptographic foundation and makes it suitable for embedding in constrained environments.

Audited cryptography — The @bsv/sdk primitives and transaction validation logic have undergone third-party security auditing by Trail of Bits.

BRC-100 as the seam — The wallet interface is the most important architectural boundary. Applications above it are wallet-agnostic; implementations below it are application-agnostic. This is what makes the ecosystem composable.