No description
  • TypeScript 91.3%
  • CSS 7.7%
  • Shell 0.8%
  • HTML 0.2%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-10-18 17:24:20 +02:00
dapp Batman 2026-10-18 17:24:20 +02:00
docs Add docs 2026-10-18 17:24:20 +02:00
scripts Batman 2026-10-18 17:24:20 +02:00
src Batman 2026-10-18 17:24:20 +02:00
.gitignore Batman 2026-10-18 17:24:20 +02:00
index.html Batman 2026-10-18 17:24:20 +02:00
LICENSE Batman 2026-10-18 17:24:20 +02:00
package-lock.json Batman 2026-10-18 17:24:20 +02:00
package.json Batman 2026-10-18 17:24:20 +02:00
README.md Add docs 2026-10-18 17:24:20 +02:00
tsconfig.json Batman 2026-10-18 17:24:20 +02:00
vite.config.ts Batman 2026-10-18 17:24:20 +02:00

BM

Direct and group chat dapp for the Beam wallet. No smart contract, no handle, no fee.

  • Messages travel over SBBS through the wallet API (send_message / read_messages, API 7.4). SBBS encrypts each message to its receiver.
  • Every message is a JSON envelope signed with an ECDSA P-256 key that BM creates per wallet. Contacts pin that key on first contact; a changed key shows a warning.
  • Groups have an owner, admins and members. The owner signs each admin's rights (add, remove and ban, delete messages, pin, edit name), and members accept a group change only when the signer's rights cover it. Group messages are sent to each member separately.
  • A new member asks the owner, the admins and a few members for history. The replies are the original signed messages, checked against each author's key.
  • Files are encrypted with AES-GCM in the browser, uploaded to IPFS (ipfs_add), and the key travels inside the message. Limit: 5 MB.

Limits

  • The network keeps undelivered messages for 12 hours. A peer who stays offline longer misses them.
  • History lives in the dapp's local storage. A second device or a reinstall starts empty.

Docs

Develop

npm install
npm run dev     # http://127.0.0.1:13666, add ?mock for an in-memory wallet with an echo peer
npm test
npm run dapp    # builds BM-v0.1.<commit count>.dapp

To run inside the desktop wallet during development, point the wallet's dev app at http://127.0.0.1:13666.

License

Apache 2.0, see LICENSE.