Skip to content

SocialMesh 0.3.0: apps

Latest

Choose a tag to compare

@doctarock doctarock released this 18 Nov 02:16

Apps: polls, petitions and sign-up sheets that pass around like posts, with no server. Their code runs with no network at all, and nothing is sent without your say-so. Phones now also keep going without Bluetooth: over Wi-Fi, through a host you add, or, with neither radio, by sound.

Experimental proof of concept, not independently security-reviewed. Keys are stored unencrypted on disk, and link observers can still see who connects to whom. Don't rely on it where your safety depends on it. Read THREAT-MODEL.md.

Security fix: update from 0.2.0

In 0.2.0, a site containing an <iframe> (or another frame or embed) could make your device look up the frame's web address before the viewer blocked the frame. Whoever runs that address could then tell when someone opened the site. 0.3.0 removes frames and embeds from sites before showing them. Checked against 38 ways a page can reach out, none now touches the network.

What's new

  • Apps. A site can carry code: a poll that counts votes, a petition that gathers names.
    • The code can read the app's own files and what people have sent it. It can't reach the internet, other sites or your device, and it can't run code inside the page.
    • When an app wants to send something, you see exactly what will be sent and choose: anonymously (signed by a key used only for that app, sent by a route that hides which device it came from), as you, or not at all.
    • Try the example in examples/poll.
  • No Bluetooth needed. The Android app starts with whatever is available, and picks Bluetooth up when you turn it on.
  • Sound modem. With no Bluetooth and no Wi-Fi, the phone switches to sound by itself:
    • it listens all the time, and every minute or so plays one of its newest public posts as tones for phones nearby;
    • it waits while it hears another phone playing;
    • it warns you if the media volume is too low to be heard.
  • Hosts. Add a computer or relay by its address, or paste a mesh1: invitation.
    • The phone remembers which node answered and refuses a different one at that address later.
    • It keeps in sync over any network, mobile data included.
    • Nodes on the same Wi-Fi are listed, and you can save them for later.

Full list: CHANGELOG.md. Format: SPEC.md §11.

Try it

On a computer:

mesh site new poll
mesh site publish ./examples/poll --key poll --app poll.js --title "Bus route poll"
mesh site view <address>       # vote in your browser; the terminal asks before sending
mesh site entries <address>    # what people have sent

On Android: Sites, then open any site marked · app.

Downloads

File What it is
mesh-0.3.0-windows-x64.exe The command-line node for Windows. On macOS and Linux, build from source: cargo build --release -p mesh-cli.
socialmesh-0.3.0-android-arm64-test.apk The Android test app (Android 10+, 64-bit ARM). It installs over 0.2.0 and keeps your posts and sites. It's signed with a development key, so a later properly signed release may need an uninstall first.
SHA256SUMS.txt Checksums for the files above.