Test BRC-100 conformance
Prove that your wallet answers each BRC-100BSV Request for Comments 100, the standard interface between apps and wallets method the way the TypeScript reference does. You run the ts-stack test vectors against your wallet and end with a result that names every vector it passes and every vector left open. Build a wallet shows where this step sits in the path of a wallet.
How it works
A run has three parts, and the runner is the only one you write or adapt:
- 1The vectors
One JSON file per BRC-100 method under wallet/brc100/, from a pinned ts-stack commit
- 2Your runner
Builds the wallet from each vector’s root key, calls the method and compares the result with the expected one
- 3Your claim
Every required vector passes, and every intended one is listed with its reason
Pin the ts-stack commit you test against, as a git submodule or a fixed checkout, so the expected results do not change under your wallet. This page was written against ts-stack commit 389d5d8 of October 27, 2026.
Know what a claim covers
Each vector carries a parity class, and the BRC-100 vectors use two of them:
required: every conformant wallet passes the vector.intended: the vector needs wallet state that the reference harness does not build yet, such as a funded wallet, so the runners skip it and record the reason.
A first claim passes every required vector and lists the intended ones as open, with their reasons. To pass an intended vector, your test harness has to build the state it needs, such as funds or a stored certificate, and then run it.
Choose a runner
The runner depends on the language of your wallet:
- A TypeScript wallet runs the vectors with the Jest runner in ts-stack, described in Run the vectors in TypeScript.
- A wallet in another language reads the JSON files from the pinned checkout with its own runner. Keep the file and vector IDs in its output, report the methods it does not test instead of leaving them out, and follow the flags and exit codes in the runner contract.
Next steps
With the path clear, see what each vector file covers: