# Lumen

## Lumen – RGB Lightning Node Connector

**Lumen** is a browser extension that connects your browser to an [RGB Lightning Node (RLN)](https://github.com/RGB-Tools/rgb-lightning-node).\
It works as a **bridge** between your node and any dApp that supports the [RGB WebLN interface](https://thunderstack.gitbook.io/rgbln).

Lumen is not a wallet itself — it does not hold your keys or sensitive data.\
Instead, it lets you use your own RGB LN as a wallet backend, either self-hosted or running on **ThunderStack Cloud**.

***

### Features

* Connect to self-hosted or ThunderStack Cloud RGB Lightning Node via HTTP API.
* Exposes node functionality via RGB WebLN.
* Manage RGB assets through your browser.
* Pay and receive invoices.
* Sign messages.
* Use WebLN calls in dApps (e.g. `rgbInvoice`, `sendAsset`).
* Non-custodial: your node manages all private state and signing.

***

### Getting Started

### Installation

The extension will be available on the Chrome Web Store (link to be added).

For development builds, clone the repository and load the extension manually in your browser.

#### 2. Set Up an RGB LN

You have two options:

* **Run your own node**: Install RLN locally, initialize it, and unlock it.
* **Use ThunderStack Cloud**: Simplest option — create a node online, which comes with Biscuit authentication enabled by default.

Guide: [Create a node on ThunderStack Cloud](/bitcoin-native-infrastructure/readme/getting-started-with-thunderstack-rgb-cloud/general/create-rln-node.md)

#### 3. Get Connection Parameters

Once your node is ready and unlocked, go to the **Connect** tab in your node dashboard.

<figure><img src="/files/AlHSX9bwiQIYxoDmp7ax" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/7NWHt910sKajnOVlGlsy" alt=""><figcaption></figcaption></figure>

\
You’ll need:

* **Node API endpoint** (API URL)
* **Node token** (authentication token or Biscuit)

#### 4. Connect in Lumen

1. Open the Lumen extension.<br>

   <figure><img src="/files/zeX6OXohuktigOHcn6xs" alt=""><figcaption></figcaption></figure>
2. Enter the API endpoint and token.
3. Connect.

If successful, your node will show as connected and ready.\
![](/files/iDOGcLgkd6OqnCy08hrl)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.thunderstack.org/bitcoin-native-infrastructure/readme/lumen.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.