Live on Android · debug builds

Wallets,
as plugins.

Bring any Lightning provider into LaWallet with one sandboxed JavaScript file. NIP‑47 in, your provider's API out.

2
plugins listed
1
file per plugin
0
keys shared
QuickJS sandboxNIP-47 ABIPinned to a commitSHA-256 checkedHost allowlistEncrypted secretsWeb login on the provider's own pageScan to installNo keys sharedOne index.jsQuickJS sandboxNIP-47 ABIPinned to a commitSHA-256 checkedHost allowlistEncrypted secretsWeb login on the provider's own pageScan to installNo keys sharedOne index.js
Directory

Pick a wallet. Scan it in.

Every plugin here is read straight from plugins/*/manifest.json at build time. Scan a code with LaWallet's scanner, or paste its link. You'll see exactly what it can touch before anything installs.

Fiwind

v0.1.1io.fiwind

Your Fiwind BTC balance as a Lightning wallet

Wallet methods
  • get_balance
  • make_invoice
  • pay_invoice
  • lookup_invoice
  • list_transactions
Permissions
  • Connects to api.fiwind.io
  • Sign-in at panel.fiwind.io, the password never reaches LaWallet
  • Keeps its login on the device, encrypted
  • Checks for payments every 60 s
Source
L

Lemon

v0.1.0me.lemon

Your Lemon BTC balance as a Lightning wallet

Wallet methods
  • get_balance
  • make_invoice
  • pay_invoice
  • lookup_invoice
  • list_transactions
Permissions
  • Connects to api.lemoncash.io
  • Sign-in at www.lemon.me, the password never reaches LaWallet
  • Keeps its login on the device, encrypted
  • Checks for payments every 60 s
Source
Add your wallet Start from the template, test it without a network, and open a pull request. Create a plugin
How it works

From QR to wallet, on your terms.

  1. 01

    Scan or paste

    The QR holds an install link: lawallet:plugin?url=… pointing at a plugin folder on GitHub. Only HTTPS GitHub links are accepted, and a scan never installs anything on its own.

  2. 02

    Pinned to a commit

    The app resolves the branch to the exact commit it read right now. Manifest and bundle come from that commit, so what you review is what runs.

  3. 03

    Review every permission

    The sheet lists each host it connects to, where you sign in, whether it keeps a login, and how often it checks for payments. Nothing is downloaded until you tap Install.

  4. 04

    A wallet in your deck

    Sign in on the provider's own page (LaWallet never sees the password) and the wallet joins your Lightning deck: balance, transfers, and Pay from when the plugin supports it.

Isolation

A sandbox that says no by default.

Own QuickJS context

Its own thread and a 32 MB heap. No file system, no imports, no app objects. A stuck plugin gets stopped, and the app keeps running.

Host allowlist

HTTPS only, and only to the exact hostnames in the manifest. No redirects, no cookies, no LaWallet credentials.

SHA-256 checked

The bundle's hash is recorded at install and checked on every load. If the file changes, it doesn't run.

Encrypted secrets

Tokens are encrypted with an Android Keystore key and kept per plugin id. Removing the plugin wipes them.

No payment without you

pay_invoice is only called after you confirm on LaWallet's own Send screen. A plugin can't start a payment.

Your keys stay yours

No plugin ever sees your nsec, NWC connections, Lightning address or LaWallet session.

Build

One file. Ship a wallet.

A manifest that declares what it touches, and an ES module that answers NIP-47 calls with host.fetch, host.secrets and host.webLogin. Use TypeScript or npm, bundled into a single index.js.

mobile-plugins
# copy the template and run its test
$ cp -r template plugins/mywallet
$ node plugins/mywallet/test.mjs
Example: ok
# from android-wallet: serve to a debug build
$ scripts/plugins-dev.py
// Template wallet plugin for LaWallet. Copy this folder to plugins/<name>/ and replace the Example API calls.
// One ES module, no imports. The only way out of the sandbox is `host` (docs/plugin-api.md#host-api).

const API = "https://api.example.com"; // must be listed in manifest.permissions.hosts
const LOGIN = "https://login.example.com"; // must match manifest.permissions.webLogin.url

const fail = (code, message) => {
  throw { code, message };
};

/** GET/POST against the provider with the stored session. Every status resolves; only a dead network rejects. */
async function api(host, method, path, body) {
  const token = host.secrets.get("token");
  if (!token) fail("UNAUTHORIZED", "Sign in to Example first");
  const r = await host.fetch(API + path, {
    method,
    headers: { authorization: "Bearer " + token, "content-type": "application/json" },
    body: body === undefined ? undefined : JSON.stringify(body),
  });
  if (r.status === 401) fail("UNAUTHORIZED", "Your Example session expired");
  if (r.status === 429) fail("RATE_LIMITED", "Example is busy, try again in a minute");
  if (r.status === 404) fail("NOT_FOUND", "Not found");
  if (r.status >= 400) fail("OTHER", `Example answered ${r.status}`);
  return JSON.parse(r.body);
}

/** Provider invoice → NIP-47 transaction. Amounts in msat, times in unix seconds. */
const tx = (i) => ({
  type: "incoming",
  state: i.paid ? "settled" : "pending",
  invoice: i.bolt11,
  description: i.memo || "",
  payment_hash: i.hash,
  amount: i.sats * 1000,
  created_at: i.created,
  expires_at: i.expires,
});

const methods = {
  async get_balance(host) {
    return { balance: (await api(host, "GET", "/balance")).sats * 1000 };
  },
  async make_invoice(host, { amount, description }) {
    return tx(await api(host, "POST", "/invoices", { sats: Math.floor(amount / 1000), memo: description }));
  },
  async lookup_invoice(host, { payment_hash }) {
    return tx(await api(host, "GET", "/invoices/" + payment_hash));
  },
};

export default {
  async request(method, params, host) {
    const fn = methods[method];
    if (!fn) fail("NOT_IMPLEMENTED", method);
    return fn(host, params || {});
  },

  // Local state only (no network): the app calls this often and caches the answer.
  async account(host) {
    const email = host.store.get("email");
    return host.secrets.get("token") ? { signedIn: true, label: email || undefined } : { signedIn: false };
  },

  // The user signs in on the provider's own page; the expression runs in that page until it returns a string.
  async login(host) {
    const session = JSON.parse(
      await host.webLogin(LOGIN, "localStorage.SESSION ? localStorage.SESSION : null"),
    );
    host.secrets.set("token", session.token);
    host.store.set("email", session.email || null);
  },

  async logout(host) {
    host.secrets.set("token", null);
    host.store.set("email", null);
  },
};
Build with an agent

Describe a wallet. Get a plugin on your emulator.

The lawallet-plugin skill teaches an agent the whole loop. It clones android-wallet, puts a debug build on the Android emulator, scaffolds a plugin and tests it offline, then installs and reloads it in the running app.

  1. 01

    Install the skill

    Claude Code loads skills from ~/.claude/skills.

    terminal
    $ git clone --depth 1 https://github.com/lawalletio/mobile-plugins /tmp/lwp
    $ mkdir -p ~/.claude/skills
    $ cp -R /tmp/lwp/skills/lawallet-plugin ~/.claude/skills/
  2. 02

    Start the agent

    In an empty folder, with Opus 5.5.

    terminal
    $ mkdir -p ~/lawallet-dev && cd ~/lawallet-dev
    $ claude --model claude-opus-5-5
  3. 03

    Ask for a plugin

    Name the provider and link its API docs.

    /lawallet-plugin Set up LaWallet for Android on the emulator, then build a plugin for <Provider>. Their API docs: <link>. Install it on the emulator when its tests pass.

lwdev setuplwdev applwdev servelwdev newlwdev testlwdev install

You sign in to the app once, and to the provider on its own page. The agent never sees a password. It works on a side-by-side .preview copy, so a real wallet is never touched. Full guide

Platforms

Same file, every LaWallet.

Live

Android

QuickJS host in LaWallet for Android. Available in debug builds today, and in release builds made with -Pplugins.

  • Add Plugin by GitHub URL
  • Scan-to-install QR
  • Local development with Reload
Planned

iOS

The plan: the same index.js on JavaScriptCore, behind a Swift protocol. Not available yet.

  • Same manifest and NIP-47 calls
  • Same host API contract
  • Details once the host exists