Native companion app for the lightning browser extension to connect to an LND node.
Under development!
I am currently not sure what's the best development setup for this.
The native messaging host application requires
a path to an executable to be specified. The browser communicates via stdin/stdout with the native companion.
Currenty I am using prebuilt electron binaries to run it in development
Download the prebuild binaries and clone this repository in a folder named app in the Electron's resources folder.
OSX:
electron/Electron.app/Contents/Resources/app/
├── package.json
├── index.js
└── ...
Windows and Linux:
electron/resources/app
├── package.json
├── index.js
└── ...
Then use the absolute path to Electron.app on macOS, electron on Linux, or electron.exe on Windows in your host JSON file (joule.json).
On OSX you have to use the full path to the Electron executable in your Electron.app. For example:
/Users/bumi/src/lightning/lnd-native-companion/Electron.app/Contents/MacOS/Electron
Currently I've only used Chrome for development.
Copy or link the joule.json to /etc/opt/chrome/native-messaging-hosts/joule.json and configure the path as described above and check if the ID in the allowed_origins list matches with the ID of the browser extension.
$ npm start
This should serve the frontend app on port 3000.
Do not open the app in the browser. (it opens by default, just close it... it does not work in the browser)
Now install the lightning-browser-extension
We use electron-log for logging. (you can not log to STDOUT because that's how the browser communicates with the companion)
By default, it writes logs to the following locations:
on Linux: ~/.config/{app name}/logs/{process type}.log
on macOS: ~/Library/Logs/{app name}/{process type}.log
on Windows: %USERPROFILE%\AppData\Roaming\{app name}\logs\{process type}.log
e.g.
$ tail -f ~/.config/lnd-native-companion/logs/main.log ~/.config/lnd-native-companion/logs/renderer.log
The setup and everything is still very rough. Please reach out or create an issue, I am happy to help.