Skip to main content
Beta — BRC wallet only. These steps apply to apps that integrate with HandCash Desktop or Mobile over BRC-100. They do not apply to Connect (authToken + @handcash/sdk) or Wallet API (/v1/waas/*).

​
Prerequisites

  1. HandCash Desktop (or Mobile) installed and unlocked with a funded wallet.
  2. A web or native app that can reach the local BRC-100 bridge (Desktop) or a conforming wallet client.
  3. Familiarity with BRC-100 method names (createAction, listOutputs, internalizeAction, …) from brc.dev/100.

​
Choose the right HandCash surface

​
First connection (Desktop)

On Desktop, HandCash runs a local bridge on loopback so apps can call BRC-100 methods with user permission:
  • Primary: https://127.0.0.1:2121
  • Fallback: http://127.0.0.1:3321
See Local bridge for discovery, origins, permissions, structured errors, and TLS fallback. Typical first call after the user has unlocked the wallet and approved your origin:
  1. Discover the bridge with POST /getVersion.
  2. Check isAuthenticated; call waitForAuthentication when needed.
  3. Call wallet methods (e.g. balance via getBalance, payments via createAction).
Exact JSON shapes follow BRC-100; HandCash’s permission UI gates origins and method scopes. You can also open App Lab with Desktop unlocked and run each method from the browser.

​
Choose an interaction

Mobile uses the same wallet core, but the loopback HTTP URLs on this page are a Desktop transport. Mobile app/deep-link transport is not yet a public contract.

​
Next