<>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

Generated Stack Facts

This page is generated from committed manifests and governance records. Edit the source manifests, governance/repository-health/projects.json, governance/documentation-policy.json, or conformance metadata, then run pnpm docs:facts. CI runs pnpm docs:facts:check and rejects drift.

Support and toolchain

ProfileCurrent contractAuthority
Repository contributors, CI, releasesNode.js >=24.11; pnpm >=10 (pnpm@10.33.2)root package.json
Published npm packages>=22 for Node consumers; browser/mobile targets remain package-specificpublic package manifests
Standalone infrastructure>=24 <25service manifests and digest-pinned Dockerfiles
TypeScript compilernpm:typescript@7.0.2 compiler; npm:@typescript/typescript6@6.0.2 tooling API@bsv/sdk package.json and TypeScript toolchain policy

Node engine declarations on browser and React Native packages govern package tooling and Node consumers; they do not require a browser or mobile device to provide Node APIs.

Public package manifest

The release graph currently contains 31 public packages. Versions below are source-manifest versions; registry publication is a separate, explicitly authorized release action.

AreaPackageSource versionProject profileConsumer profilesRuntime targetsNode engineSource
helpers@bsv/air-gap0.1.1browser-librarybrowser-bundler, browser-esm, node-cjs, node-esmbrowser, node>=22packages/helpers/air-gap
helpers@bsv/amountinator2.1.4node-librarynode-cjs, node-esmnode>=22packages/helpers/amountinator
helpers@bsv/did0.2.4browser-librarybrowser-bundler, browser-esm, node-cjs, node-esmbrowser, node>=22packages/helpers/did
helpers@bsv/did-client1.3.0browser-librarybrowser-bundler, browser-esm, node-cjs, node-esm, umd-globalbrowser, node, umd>=22packages/helpers/did-client
helpers@bsv/fund-wallet1.4.3cliclinode>=22packages/helpers/fund-wallet
helpers@bsv/simple0.5.1browser-librarybrowser-bundler, browser-esm, node-cjs, node-esmbrowser, node>=22packages/helpers/simple
helpers@bsv/templates1.10.0browser-librarybrowser-bundler, browser-esm, node-cjs, node-esmbrowser, node>=22packages/helpers/ts-templates
helpers@bsv/wallet-helper0.1.6node-librarynode-cjs, node-esmnode>=22packages/helpers/bsv-wallet-helper
helperscreate-bsv-app1.1.0cliclinode>=22packages/helpers/create-bsv-app
messaging@bsv/authsocket2.1.6node-librarynode-cjs, node-esmnode>=22packages/messaging/authsocket
messaging@bsv/authsocket-client2.1.5browser-librarybrowser-bundler, browser-esm, node-cjs, node-esm, umd-globalbrowser, node, umd>=22packages/messaging/authsocket-client
messaging@bsv/message-box-client2.4.1browser-librarybrowser-bundler, browser-esm, node-cjs, node-esm, umd-globalbrowser, node, umd>=22packages/messaging/message-box-client
messaging@bsv/paymail2.4.6browser-librarybrowser-bundler, browser-esm, node-cjs, node-esmbrowser, node>=22packages/messaging/ts-paymail
middleware@bsv/402-pay0.2.4browser-librarybrowser-bundler, browser-esm, node-cjs, node-esmbrowser, node>=22packages/middleware/402-pay
middleware@bsv/auth0.1.3node-librarynode-cjs, node-esmnode>=22packages/middleware/auth
middleware@bsv/auth-express-middleware2.2.2node-librarynode-cjs, node-esmnode>=22packages/middleware/auth-express-middleware
middleware@bsv/payment-express-middleware2.1.5node-librarynode-cjs, node-esmnode>=22packages/middleware/payment-express-middleware
network@bsv/teranode-listener1.1.4node-librarynode-esmnode>=22packages/network/ts-p2p
overlays@bsv/gasp1.3.5browser-librarybrowser-bundler, browser-esm, node-cjs, node-esmbrowser, node>=22packages/overlays/gasp-core
overlays@bsv/overlay2.3.0node-librarynode-cjs, node-esmnode>=22packages/overlays/overlay
overlays@bsv/overlay-discovery-services2.2.0node-librarynode-cjs, node-esmnode>=22packages/overlays/overlay-discovery-services
overlays@bsv/overlay-express2.6.0node-librarynode-cjs, node-esmnode>=22packages/overlays/overlay-express
overlays@bsv/overlay-topics1.7.0node-librarynode-esmnode>=22packages/overlays/topics
sdk@bsv/sdk2.4.1browser-librarybrowser-bundler, browser-esm, node-cjs, node-esm, umd-globalbrowser, node, umd>=22packages/sdk
sdk@bsv/verifast0.3.4wasm-librarybrowser-bundler, browser-esm, node-cjs, node-esm, umd-global, wasm-workerbrowser, node, umd, wasm, worker>=22packages/verifast
wallet@bsv/btms1.2.1node-librarynode-cjs, node-esmnode>=22packages/wallet/btms
wallet@bsv/btms-permission-module1.1.3node-librarynode-esmnode>=22packages/wallet/btms-permission-module
wallet@bsv/wallet-relay0.3.5cli-librarybrowser-bundler, browser-esm, cli, node-cjs, node-esmbrowser, node>=22packages/wallet/ts-wallet-relay
wallet@bsv/wallet-toolbox2.10.3node-librarynode-cjsnode>=22packages/wallet/wallet-toolbox
wallet@bsv/wallet-toolbox-client2.10.3browser-librarybrowser-bundler, browser-esm, node-cjs, node-esmbrowser, node>=22packages/wallet/wallet-toolbox/client
wallet@bsv/wallet-toolbox-mobile2.10.3react-native-libraryreact-native-metroreact-native>=22packages/wallet/wallet-toolbox/mobile

Standalone infrastructure manifests

These versions identify the checked-in service manifests; production identity is the separately released and verified image digest.

ServicePackageManifest versionNode engineRuntime targetsReleaseSource
BSV Chaintracks Serverchaintracks-server1.1.15>=24 <25node, linux/amd64ghcr-keylessinfra/chaintracks-server
BSV Message Box Server@bsv/messagebox-server1.1.39>=24 <25node, linux/amd64ghcr-keylessinfra/message-box-server
BSV Overlay Server@bsv/overlay-express-examples2.1.34>=24 <25node, linux/amd64ghcr-keylessinfra/overlay-server
BSV UHRP Basic Server@bsv/uhrp-lite0.1.32>=24 <25node, linux/amd64ghcr-keylessinfra/uhrp-server-basic
BSV UHRP Cloud Bucket Server@bsv/uhrp-storage-server0.2.34>=24 <25node, linux/amd64ghcr-keylessinfra/uhrp-server-cloud-bucket
Wallet Authentication Backend@bsv/wab-server1.5.3>=24 <25node, linux/amd64ghcr-and-aws-marketplace-keylessinfra/wab
BSV Wallet Infrastructure@bsv/wallet-infra2.0.37>=24 <25node, linux/amd64ghcr-keylessinfra/wallet-infra

Governed project and release inventory

MetricCount
Governed projects38
Package-area projects34
Public npm packages31
Private package-area projects3
Standalone infrastructure projects7

Public packages use the npm-oidc release route. Other workspace projects are private packages or documentation/conformance tooling. Standalone infrastructure components are governed separately by governance/container-images.json and use their recorded container release route; they are not published by the public-package job.

Conformance corpus

MetricCurrent value
Vector files75
Vectors6681
Structurally passed6470
Governed skips211
Required parity vectors6477
Intended parity vectors204
Explicitly skipped vector entries7
Corpus metadata revision2026-07-30

Structural runner pass/skip results and parity classifications answer different questions: the former is the current runner outcome, while the latter records cross-language implementation intent. Neither count may be silently presented as the other.

Coverage reporting

Coverage numbers below come from the latest committed CI-artifact snapshot, while package participation comes directly from current manifests. Codecov is the aggregate and changed-line authority. These are reporting facts, not a claim that the final QA coverage targets have been completed.

MetricCurrent valueAuthority
Projects with a test:coverage script33current package manifests
Aggregate line coverage66.97%https://app.codecov.io/gh/BSV-blockchain/ts-stack
Reported source files543https://app.codecov.io/gh/BSV-blockchain/ts-stack
Reported lines (hit / missed / partial)30981 / 11619 / 3659https://app.codecov.io/gh/BSV-blockchain/ts-stack
Project threshold80% for packages/sdk/srccodecov.yml and .github/workflows/ci.yml
Changed-line threshold90%codecov.yml and .github/workflows/ci.yml

The CI workflow generates package-specific LCOV artifacts in parallel, normalizes their repository paths, combines them in the coverage-upload job, and requires the aggregate Codecov status before the merge gate succeeds. Updating the committed aggregate snapshot requires a linked exact-main CI artifact; it must never be estimated from local partial runs.

Change procedure

  1. Change source manifests or vector files.
  2. Update the governed inventory or conformance/META.json when its declared facts change.
  3. Run pnpm docs:facts.
  4. Run pnpm docs:facts:check, pnpm health:check, and the relevant package, conformance, documentation, and release checks.
  5. Review generated diffs together with the source change. Do not hand-edit this page or conformance/PARITY_MATRIX.json.

See Versioning Policy, Dependency and Release Policy, and Conformance Testing for the operational meaning of these facts.