This document outlines what is involved in the development of a Fedi Mod including specifications and integration points that will evolve as the ecosystem of Fedimints matures.
For now there will be three phases for the development of this spec:
Fedi Mods (FMs) are WebLN-compatible apps that can run in Fedi's mobile web browser.
They are served like any normal web app from within the Fedi native app which uses react-native-webview as its web browser.
react-native-webln is used to inject the webln object into the loaded web app's window object, serving as a WebLN provider to request and pay Lightning invoices via the user's Fedi wallet.
To access or test a Fedi Mod, download the latest version of Fedi Alpha from here.
After joining the Signet federation, go to the Settings screen and locate the bottom section labeled "General".
Tap the word "General" 10 times to access the Developer Settings.
From here you can add your own custom Fedi Mods for testing within the Fedi web browser and they will immediately appear on the Home screen.
The Fedi Mod browser provides function handlers for each of the following WebLN messages.
enable(): Promise<void>
getInfo(): Promise<GetInfoResponse>
makeInvoice(data: string | number | RequestInvoiceArgs): Promise<RequestInvoiceResponse>
sendPayment(data: string): Promise<SendPaymentResponse>Check the webln interface for more detailed type definitions.
There is also (non-WebLN) LNURL-Auth functionality that scans the page for a-tags containing a lightning: uri and immediately attempts to authenticate the user according to the LUD-04 auth base spec
These WebLN functions are not yet supported:
signMessage(data: string): Promise<SignMessageResponse>
verifyMessage(signature: string, message: string): Promise<void>...
...