Fistbump

About

Fistbump is the official browser extension for the Fistbump desktop wallet. It exposes a window.fistbump provider to any web page, so web apps can request the user's wallet address, ask the user to sign messages, and build transactions — all gated behind per-request approval modals in the desktop wallet.

Features

• Connect — Web apps request access with window.fistbump.connect(). The first time a site connects, the desktop wallet pops a confirmation modal showing the site's origin; subsequent connects from the same site are silent.

• Send transactions — window.fistbump.sendTx({ to, amount }) accepts either a raw fb1… address or a Fistbump name (resolved on the wallet side). The wallet shows a review modal with the recipient, fee, and total, and requires the wallet to be unlocked before signing.

• Sign messages — window.fistbump.signMessage("hello") signs with the active wallet's receive address. window.fistbump.signMessage("hello", { name: "eskimo" }) signs with the key that owns a specific Fistbump name, after verifying ownership on the wallet side.

• Zero data collection — the extension does not talk to any remote server. Every request is forwarded to your locally installed Fistbump desktop wallet via Chrome's native messaging API.

How it works

The extension uses Chrome's native messaging API to talk to a small bridge binary shipped inside the Fistbump desktop app. Chrome pre-verifies the extension's ID before spawning the bridge, so no other extension can impersonate it. The bridge forwards requests to the wallet over a local Unix domain socket (on macOS and Linux) or named pipe (on Windows), both of which live in your user directory with per-user permissions.

Requirements

• The Fistbump desktop wallet must be installed. Download at https://fistbump.org.

• First-time use: launch the desktop wallet at least once so it registers the extension's native messaging host with your browser.

The desktop wallet and this extension are open source.