diff --git a/i18n/en/docusaurus-plugin-content-docs/version-0.5.1-alpha/Development/ProjectStructure.md b/i18n/en/docusaurus-plugin-content-docs/version-0.5.1-alpha/Development/ProjectStructure.md
new file mode 100644
index 0000000..0caae44
--- /dev/null
+++ b/i18n/en/docusaurus-plugin-content-docs/version-0.5.1-alpha/Development/ProjectStructure.md
@@ -0,0 +1,38 @@
+# Project Structure
+
+This section describes the directory structure of the main **Ambrosia POS** repository, a comprehensive system for restaurants and retail with Bitcoin integration.
+
+```text
+ambrosia/
+├── .github/                # CI/CD Workflows (Linter, Tests, E2E)
+├── client/                 # Next.js Frontend (React 19, Tailwind CSS)
+│   ├── __tests__/          # Client unit tests
+│   ├── public/             # Static assets (SVG, images)
+│   └── src/                # Frontend source code
+│       ├── app/            # Next.js App Router (pages and layouts)
+│       ├── components/     # Reusable React components
+│       ├── hooks/          # Custom React Hooks
+│       ├── i18n/           # Internationalization configuration
+│       ├── lib/            # Shared libraries and configurations
+│       ├── modules/        # App-specific modules
+│       └── services/       # Services for API calls
+├── doc/                    # Additional documentation (installation, proposal)
+├── electron/               # Desktop wrapper for the application
+│   ├── scripts/            # Build scripts for different platforms
+│   ├── services/           # System-side logic (Backend, Phoenixd)
+│   └── utils/              # Health utilities and port management
+├── imgs/                   # Visual assets and project icons
+├── scripts/                # Utility scripts (install, uninstall, run)
+├── server/                 # Kotlin Backend (Ktor Framework)
+│   ├── app/                # Main server application
+│   │   └── src/            # Source code (Kotlin/Java)
+│   ├── e2e_tests_py/       # End-to-End tests in Python (Pytest)
+│   └── gradle/             # Gradle Wrapper configuration
+├── docker-compose.yml      # Service orchestration (Server, Client, Phoenixd)
+├── Makefile                # Task automation for build and execution
+└── README.md               # Main project documentation
+```
+
+:::info Main Repository
+You can find the full source code in our [official GitHub repository](https://github.com/olympus-btc/ambrosia).
+:::
diff --git a/i18n/en/docusaurus-plugin-content-docs/version-0.5.1-alpha/Development/Setup.md b/i18n/en/docusaurus-plugin-content-docs/version-0.5.1-alpha/Development/Setup.md
new file mode 100644
index 0000000..7235a55
--- /dev/null
+++ b/i18n/en/docusaurus-plugin-content-docs/version-0.5.1-alpha/Development/Setup.md
@@ -0,0 +1,231 @@
+# Contributing to Ambrosia POS
+
+Thank you for your interest in contributing to Ambrosia POS! We love community collaboration. Whether you're fixing a bug, adding a feature, improving documentation, or helping with community support, your help is welcome to build the future of Bitcoin payments.
+
+## Table of Contents
+
+- [Code of Conduct](#code-of-conduct)
+- [Getting Started](#getting-started)
+- [How to Contribute](#how-to-contribute)
+- [Development Setup](#development-setup)
+- [Coding Standards](#coding-standards)
+- [Testing](#testing)
+- [Pull Request Process](#pull-request-process)
+- [Issue Reporting](#issue-reporting)
+- [Development Resources](#development-resources)
+- [Community](#community)
+
+## Code of Conduct
+
+This project adheres to our **[Code of Conduct](https://github.com/olympus-btc/ambrosia/blob/main/CODE_OF_CONDUCT.md)**. By participating, you are expected to uphold this code. Please report unacceptable behavior to **contact@ambrosiapay.com**.
+
+## Getting Started
+
+### Prerequisites
+
+Before you start, ensure you have the necessary dependencies installed. Please refer to our **[Project Dependencies Guide](https://github.com/olympus-btc/ambrosia/blob/main/doc/dependencies.md)** for detailed instructions on installing:
+
+- **Java 21 (JDK)**
+- **Node.js**
+- **Docker**
+- **Gradle**
+
+### First-time Contributors
+
+If you're new to open source, check out:
+- [First Contributions](https://github.com/firstcontributions/first-contributions)
+- [How to Contribute to Open Source](https://opensource.guide/how-to-contribute/)
+
+## How to Contribute
+
+### Types of Contributions
+
+We welcome several types of contributions:
+
+- 🔍 **Review our code** on [GitHub](https://github.com/olympus-btc/ambrosia)
+- 🐛 **Report bugs** or suggest improvements
+- 💡 **Contribute ideas** for new features
+- 🧪 **Test the beta** and report issues
+- 📝 **Documentation**: 
+    Improve our Docs, README, or code comments
+    
+    - [Development](https://github.com/olympus-btc/ambrosia-dev)
+    - [Tutorial](https://github.com/olympus-btc/ambrosia-tutorial)
+- 🍴 **Fork the repository** and send your Pull Requests (PRs)
+
+### Before You Start
+
+1. **Search existing issues** to avoid duplicates.
+2. **Discuss major changes** by opening an issue first.
+
+## Development Setup
+
+A clean, structured guide to run Ambrosia‑POS locally with native tools.
+
+### Requirements:
+- SDKMAN (official: https://sdkman.io/)
+  ```bash
+  curl -s "https://get.sdkman.io" | bash
+  source "$HOME/.sdkman/bin/sdkman-init.sh"
+  ```
+- Java 21 (Temurin):
+  ```bash
+  sdk list java
+  sdk install java 21-tem
+  java -version
+  ```
+- Gradle:
+  ```bash
+  sdk install gradle
+  gradle -v
+  ```
+- Node.js >= 18 and npm.
+- phoenixd (Lightning):
+  ```bash
+  curl -fsSL https://raw.githubusercontent.com/olympus-btc/ambrosia-dev/master/scripts/install.sh | bash -s -- --yes
+  ```
+
+### Quick check
+```bash
+java -version && gradle -v | head -n1 && node -v && npm -v
+```
+
+### Setup Steps
+
+1. **Fork the repository** on GitHub.
+2. **Clone your fork** locally:
+   ```bash
+   git clone https://github.com/YOUR-USERNAME/ambrosia.git
+   cd ambrosia
+   ```
+
+3. **Step 1 · Start phoenixd**
+   After installation, ensure the service is running and `~/.phoenix` is initialized as per the Mastering phoenixd guide.
+
+4. **Step 2 · Server / Backend (Kotlin/Ktor)**:
+   ```bash
+   cd server
+   ./gradlew run    # API on :9154
+   ```
+   - Tests: `./gradlew test`
+
+5. **Step 3 · Client / Frontend (Next.js)**:
+   ```bash
+   cd client
+   npm install
+   npm run dev      # web on :3000
+   ```
+   - Lint: `npm run lint`
+   - Tests: `npm test`
+
+6. **Step 4 · Electron Setup (Desktop)**:
+   ```bash
+   cd electron
+   npm install
+   npm run dev
+   ```
+   *(See the [Electron README](https://github.com/olympus-btc/ambrosia/blob/main/electron/README.md) for more details)*
+
+### Local endpoints
+- API: http://127.0.0.1:9154
+- Web: http://127.0.0.1:3000
+
+### Troubleshooting
+:::tip Tips
+- Use the `./gradlew` wrapper to avoid PATH issues.
+- If a port is busy, change `3000`/`9154` or stop the conflicting process.
+- phoenixd: ensure it’s running and `~/.phoenix` contains expected config.
+:::
+
+## Coding Standards
+
+### Style Guide
+
+- **Client**: Follows standard React/Next.js practices. Use `npm run lint` to check for style issues.
+- **Server**: Follows standard Kotlin conventions.
+- **Commits**: Write meaningful commit messages.
+
+### Commit Message Format
+
+We encourage using [Conventional Commits](https://www.conventionalcommits.org/):
+
+```
+type(scope): description
+```
+
+Examples:
+- `feat(auth): add login support`
+- `fix(server): resolve null pointer exception`
+- `docs(readme): update installation steps`
+
+## Testing
+
+### Client (Frontend)
+
+Inside `client/`:
+```bash
+npm test
+```
+
+### Server (Backend)
+
+Inside `server/`:
+```bash
+./gradlew test
+```
+
+### E2E Tests
+
+The project includes end-to-end (E2E) tests for the server API written in Python.
+For detailed instructions, see the **[E2E Tests README](https://github.com/olympus-btc/ambrosia/blob/main/server/e2e_tests_py/README.md)**.
+
+## Pull Request Process
+
+### How to submit a Pull Request?
+
+1. **Create a branch** for your change (`git checkout -b feature/amazing-feature`).
+2. **Make your modifications** and commit them.
+3. **Run tests** to ensure no regressions.
+4. **Push to your fork** and submit a Pull Request to the main repository.
+
+### Checklist
+
+- [ ] Code follows style guidelines
+- [ ] Tests pass locally
+- [ ] Documentation is updated if needed
+
+## Issue Reporting
+
+- **Bug Reports**: Include clear steps to reproduce, expected vs actual behavior, and environment details.
+- **Feature Requests**: Describe the proposed feature, use case, and motivation.
+
+## Development Resources
+
+### Project Structure
+
+*   `client/` - Frontend application (Next.js/React).
+*   `server/` - Backend application (Kotlin/Ktor).
+*   `electron/` - Desktop wrapper (Electron).
+*   `doc/` - Project documentation.
+*   `scripts/` - Utility and installation scripts.
+
+### Useful Commands
+
+**Server:**
+```bash
+./gradlew run   # Run server
+./gradlew jar   # Build JAR
+```
+
+**Client:**
+```bash
+npm run dev     # Start development server
+npm run build   # Build for production
+npm start       # Start production server
+```
+
+## Community
+
+**Stay connected!**
+
+Follow us on our social media and join the community of developers and entrepreneurs who are building the future of Bitcoin payments.
diff --git a/i18n/en/docusaurus-plugin-content-docs/version-0.5.1-alpha/Phoenixd/1-SingleScript.md b/i18n/en/docusaurus-plugin-content-docs/version-0.5.1-alpha/Phoenixd/1-SingleScript.md
new file mode 100644
index 0000000..26d449d
--- /dev/null
+++ b/i18n/en/docusaurus-plugin-content-docs/version-0.5.1-alpha/Phoenixd/1-SingleScript.md
@@ -0,0 +1,175 @@
+---
+slug: /Script
+---
+# Single Script Installation
+
+The easiest way to install phoenixd is using our automated installation script. This script handles downloading, verification, and setup of phoenixd on your Linux system.
+
+:::info
+**Read Before Installing**
+
+Please read through this entire page to understand what the installation script does, its requirements, and security implications before running any commands. The script will make system changes and may require sudo permissions.
+:::
+
+
+## Quick Install
+
+Run the following command in your terminal:
+
+**Single command (recommended):**
+```bash
+curl -fsSL https://raw.githubusercontent.com/olympus-btc/ambrosia-dev/master/scripts/install.sh | bash -s -- --yes
+```
+
+**Alternative methods:**
+
+If you prefer to review the script before running it, you can manually download and inspect it first:
+
+*Download the script and make it executable:*
+   ```bash
+   wget https://raw.githubusercontent.com/olympus-btc/ambrosia-dev/master/scripts/install.sh
+   chmod +x install.sh
+   ```
+
+*Run the script:*
+   ```bash
+   ./install.sh
+   ```
+
+## What the Script Does
+
+The installation script performs the following operations:
+
+1. **Downloads phoenixd v0.7.2** from the official ACINQ GitHub releases
+2. **Verifies the package integrity** using GPG signatures and checksums
+3. **Installs to a directory in your PATH** (default: `/usr/local/bin`)
+4. **Configures your shell environment** to recognize the phoenixd command
+5. **Optionally sets up a systemd service** for automatic startup
+
+## Installation Process
+
+When you run the script, you'll see:
+
+```
+⚡️ Welcome to Mastering phoenixd installer
+-----------------------------------------
+Installing phoenixd 0.7.2 from github.com/ACINQ/phoenixd/releases/download/v0.7.2
+```
+
+### Package Verification
+
+The script includes automatic verification:
+
+```
+🔐 Starting package verification...
+✅ Package verification successful.
+✅ Verification successful. The package is authentic and intact.
+```
+
+This ensures you're installing an authentic, unmodified version of phoenixd.
+
+### Systemd Service Setup
+
+After installation, you'll be asked:
+
+```
+Do you want to setup a systemd service (requires sudo permission)? (y/n):
+```
+
+If you choose **yes**:
+- Creates a systemd service file at `/etc/systemd/system/phoenixd.service`
+- Enables and starts the service
+- Configures phoenixd to run on mainnet by default
+- Sets up automatic restart on failure
+
+You can then manage phoenixd using systemd commands:
+```bash
+sudo systemctl start phoenixd
+sudo systemctl stop phoenixd
+sudo systemctl restart phoenixd
+sudo systemctl status phoenixd
+journalctl -u phoenixd -f  # View logs
+```
+
+If you choose **no**:
+- You can run phoenixd manually with the `phoenixd` command
+- Use `phoenix-cli` to interact with the daemon
+
+## Post-Installation
+
+After successful installation:
+
+### Manual Operation
+```bash
+# Start phoenixd manually
+phoenixd --agree-to-terms-of-service
+
+# In another terminal, interact with phoenixd
+phoenix-cli getinfo
+```
+
+### Systemd Service (if enabled)
+```bash
+# Control the service
+sudo systemctl start phoenixd
+sudo systemctl stop phoenixd
+sudo systemctl restart phoenixd
+
+# Check service status
+sudo systemctl status phoenixd
+
+# View logs
+journalctl -u phoenixd -f
+```
+
+## Requirements
+
+- **Operating System**: Linux (x64)
+- **Dependencies**: `curl`, `unzip`, `sha256sum`
+- **Network**: Internet connection for downloads
+- **Permissions**: Write access to installation directory, sudo for systemd service
+
+## Troubleshooting
+
+### Command not found after installation
+
+If `phoenixd` command is not recognized after installation:
+
+```bash
+# Reload your shell configuration
+source ~/.bashrc  # or ~/.zshrc
+
+# Or restart your terminal
+```
+
+### Verification failures
+
+If package verification fails:
+- Check your internet connection
+- Ensure GPG is properly installed
+- Visit the [official releases page](https://github.com/ACINQ/phoenixd/releases) for manual verification
+
+### Permission issues
+
+If you encounter permission errors:
+- Ensure you have write access to the installation directory
+- Use `sudo` for system-wide installations
+- Consider using the `~/.local/bin` directory
+
+## Security Notes
+
+The installation script:
+- ✅ Downloads from official ACINQ sources only
+- ✅ Verifies packages using GPG signatures
+- ✅ Validates checksums before installation
+- ✅ Uses secure HTTPS connections
+- ✅ Provides full transparency of operations
+
+Always review scripts before running them with elevated privileges.
+
+## Next Steps
+
+After installation, see:
+- [Installation Guide](./2-Install.md) for detailed configuration
+- [Configuration](./3-Config.md) for startup options
+- [API Documentation](./5-API.md) for integration details
diff --git a/i18n/en/docusaurus-plugin-content-docs/version-0.5.1-alpha/Phoenixd/2-Install.md b/i18n/en/docusaurus-plugin-content-docs/version-0.5.1-alpha/Phoenixd/2-Install.md
new file mode 100644
index 0000000..cc76255
--- /dev/null
+++ b/i18n/en/docusaurus-plugin-content-docs/version-0.5.1-alpha/Phoenixd/2-Install.md
@@ -0,0 +1,74 @@
+---
+slug: /Install
+---
+
+# Install `phoenixd`
+
+(Refer to the [Phoenix documentation](https://phoenix.acinq.co/server) for more details.)  
+
+## 1. Download and Set Up `phoenixd`  
+
+Download and extract the latest version:  
+
+```sh
+wget https://github.com/ACINQ/phoenixd/releases/download/v0.7.2/phoenixd-0.7.2-linux-x64.zip
+unzip -j phoenixd-0.7.2-linux-x64.zip
+```  
+
+Move the binaries to a global path:  
+
+```sh
+sudo mv phoenixd /usr/local/bin/
+sudo mv phoenix-cli /usr/local/bin/
+```  
+
+Remove the zip file
+```sh
+rm phoenixd-0.7.2-linux-x64.zip
+```
+
+## 2. Create a Systemd Service File  
+
+Create a new systemd service file:  
+
+```sh
+sudo nano /etc/systemd/system/phoenixd.service
+```  
+
+Add the following content (replace `your_username` with your actual username):  
+
+```ini
+[Unit]
+Description=Phoenix Daemon
+After=network.target
+
+[Service]
+ExecStart=phoenixd
+User=your_username
+Restart=always
+RestartSec=5
+LimitNOFILE=4096
+WorkingDirectory=/home/your_username/
+
+[Install]
+WantedBy=multi-user.target
+```  
+
+## 3. Reload Systemd and Enable the Service  
+
+```sh
+sudo systemctl daemon-reload
+sudo systemctl enable phoenixd
+```  
+
+## 4. Start the Service  
+
+```sh
+sudo systemctl start phoenixd
+```  
+
+## 5. Check Service Status  
+
+```sh
+sudo systemctl status phoenixd
+```
diff --git a/i18n/en/docusaurus-plugin-content-docs/version-0.5.1-alpha/Phoenixd/3-Config.md b/i18n/en/docusaurus-plugin-content-docs/version-0.5.1-alpha/Phoenixd/3-Config.md
new file mode 100644
index 0000000..84bbcec
--- /dev/null
+++ b/i18n/en/docusaurus-plugin-content-docs/version-0.5.1-alpha/Phoenixd/3-Config.md
@@ -0,0 +1,110 @@
+---
+slug: /Config
+---
+
+# Useful phoenixd Flags
+
+**Terms of service** (Hidden flag) Agrees to the terms of service, preventing the interactive prompt on first run.
+
+- Flag: `--agree-to-terms-of-service`
+
+**Chain** Specifies the Bitcoin chain to use. Defaults to mainnet.
+
+- Flag: `--chain <mainnet|testnet>`
+- Config: `chain=mainnet`
+
+**Mempool Space URL** Sets a custom mempool.space instance URL.
+
+- Flag: `--mempool-space-url <URL>`
+- Config: `mempool-space-url="https://mempool.space"`
+
+**Mempool Space Polling Interval** (Hidden flag) Defines how often to poll the mempool.space API (in minutes). Defaults to 10 minutes.
+
+- Flag: `--mempool-space-polling-interval-minutes <minutes>`
+- Config: `mempool-space-polling-interval-minutes=10`
+
+### Liquidity Options:
+
+**Auto Liquidity** Sets the amount automatically requested when inbound liquidity is needed. Defaults to 2m (2,000,000 satoshis).
+
+- Flag: `--auto-liquidity <off|2m|5m|10m>`
+- Config: `auto-liquidity=2m`
+
+**Max Mining Fee** Sets the maximum mining fee for on-chain operations in satoshis. Restricted to 5,000 to 200,000 satoshis. Defaults to 1% of the --auto-liquidity amount.
+
+- Flag: `--max-mining-fee <satoshis>`
+- Config: `max-mining-fee=5000`
+
+**Max Fee Credit** Sets the maximum fee credit. If reached, payments will be rejected. Defaults to 100k (100,000 satoshis).
+
+- Flag: `--max-fee-credit <off|50k|100k>`
+- Config: `max-fee-credit=100k`
+
+**Max Relative Fee Percent** (Hidden flag) Sets the maximum relative fee for on-chain operations in percent. Restricted to 1 to 50. Defaults to 30.
+
+- Flag: `--max-relative-fee-percent <percent>`
+- Config: `max-relative-fee-percent=30`
+
+### HTTP Options:
+
+**HTTP Bind IP** Specifies the IP address for the HTTP API to bind to. Defaults to 127.0.0.1.
+
+- Flag: `--http-bind-ip <IP_address>`
+- Config: `http-bind-ip=127.0.0.1`
+
+**HTTP Bind Port** Sets the port for the HTTP API. Defaults to 9740.
+
+- Flag: `--http-bind-port <port_number>`
+- Config: `http-bind-port=9740`
+
+**HTTP Password** Sets the password for full access to the HTTP API. If not provided, a default password will be generated.
+
+- Flag: `--http-password <password>`
+- Config: `http-password="your_password"`
+
+**HTTP Password Limited Access** Sets the password for limited access to the HTTP API. If not provided, a default password will be generated.
+
+- Flag: `--http-password-limited-access <password>`
+- Config: `http-password-limited-access="your_password"`
+
+**Webhook URL** Specifies a webhook HTTP endpoint for push notifications. Can be used multiple times for multiple webhooks.
+
+- Flag: `--webhook <URL>`
+- Config: `webhook="https://example.com/webhook"`
+
+**Webhook Secret** Sets the secret used to authenticate webhook calls. If not provided, a default secret will be generated.
+
+- Flag: `--webhook-secret <secret>`
+- Config: `webhook-secret="your_secret"`
+
+### Seed Options:
+
+**Seed** Explicitly provides a 12-word mnemonic seed. Use with extreme caution as this will expose your seed in plain text.
+
+- Flag: `--seed <12-word_mnemonic>`
+
+**Seed Path** Overrides the default path to the seed file (defaults to datadir/seed.dat).
+
+- Flag: `--seed-path <path_to_seed_file>`
+
+### Logging Options:
+
+**Log Rotate Size** Sets the log file rotation size in megabytes. Defaults to 10 MB.
+
+- Flag: `--log-rotate-size <MB>`
+- Config: `log-rotate-size=10`
+
+**Log Rotate Max Files** Sets the maximum number of log files to keep. Defaults to 5.
+
+- Flag: `--log-rotate-max-files <number>`
+- Config: `log-rotate-max-files=5`
+
+**Silent** Sets the verbosity level to silent (no console output).
+
+- Flag: `--silent`
+- Config: `silent=true`
+
+**Verbose** Sets the verbosity level to verbose (detailed console output).
+
+- Flag: `--verbose`
+- Config: `verbose=true`
diff --git a/i18n/en/docusaurus-plugin-content-docs/version-0.5.1-alpha/Phoenixd/4-Uninstall.md b/i18n/en/docusaurus-plugin-content-docs/version-0.5.1-alpha/Phoenixd/4-Uninstall.md
new file mode 100644
index 0000000..d2dcab4
--- /dev/null
+++ b/i18n/en/docusaurus-plugin-content-docs/version-0.5.1-alpha/Phoenixd/4-Uninstall.md
@@ -0,0 +1,44 @@
+# Uninstall `phoenixd`  
+
+:::danger
+This tutorial does **not** remove the `.phoenix/` directory.  
+This directory contains your `seed.dat` file.  
+**If deleted, all your funds will be permanently lost.** Proceed with caution.  
+:::
+
+
+To completely remove `phoenixd` from your system, follow these steps:  
+
+## 1. Stop and Disable the Service  
+
+```sh
+sudo systemctl stop phoenixd
+sudo systemctl disable phoenixd
+```
+
+## 2. Remove the Systemd Service File
+
+```sh
+sudo rm -v /etc/systemd/system/phoenixd.service
+```
+
+## 3. Reload Systemd
+
+```sh
+sudo systemctl daemon-reload
+sudo systemctl reset-failed
+```
+
+## 4. Remove `phoenixd` Binaries
+
+```sh
+sudo rm -v /usr/local/bin/phoenix*
+```
+
+## 5. Verify the Service is Removed (Optional)
+
+```sh
+systemctl list-units --type=service | grep phoenixd
+```
+
+After these steps, `phoenixd` will be completely removed from your system.
diff --git a/i18n/en/docusaurus-plugin-content-docs/version-0.5.1-alpha/Phoenixd/5-API.md b/i18n/en/docusaurus-plugin-content-docs/version-0.5.1-alpha/Phoenixd/5-API.md
new file mode 100644
index 0000000..cfd1fe3
--- /dev/null
+++ b/i18n/en/docusaurus-plugin-content-docs/version-0.5.1-alpha/Phoenixd/5-API.md
@@ -0,0 +1,1056 @@
+# API reference
+
+Below is a reference for the `phoenixd` API, up-to-date for version `0.7.2`.
+
+## Security
+
+:::danger Fund Access
+This API provides full access to your Bitcoin funds. You are responsible for its security. **Do not allow this API to be accessible from the Internet.** It must remain strictly within your local network or protected by a secure tunnel.
+:::
+
+The API uses a Basic authentication scheme. Passwords are generated on first start (see `~/.phoenix/phoenix.conf`).
+
+:::info Password Management
+**Primary password (`http-password`):** Provides full access to all API endpoints.
+
+**Secondary password (`http-password-limited-access`):** Is less sensitive than the primary password, but it must still not be shared, as attacks like resource exhaustion (by creating millions of invoices) are possible.
+:::
+
+The following endpoints are not available with this secondary password: `payinvoice`, `payoffer`, `paylnaddress`, `lnurlpay`, `lnurlauth`, `sendtoaddress`, `closechannel`, `export`.
+
+## Create Bolt11 invoice
+
+**Endpoint**
+
+`POST /createinvoice`
+
+**Description**
+
+Creates a Bolt11 invoice with a description.
+
+A Bolt11 invoice is a non-reusable, expirable payment request for Lightning, well suited for a retail payment flow. It can only be paid once.
+
+**Parameters**
+
+- `description` the description of the invoice (max. 128 characters).
+  - or instead `descriptionHash` sha256 hash of a description.
+- `amountSat` (optional) the amount requested by the invoice, in satoshi. If not set, the invoice can be paid by any amount.
+- `expirySeconds` (optional) the invoice expiry in seconds, by default 3600 (1 hour).
+- `externalId` (optional) a custom identifier. Use that to link the invoice to an external system.
+- `webhookUrl` (optional) a webhook url that will be notified when this specific payment has been received. This notification is done in addition to the [#webhook](normal webhooks) defined in the configuration. This webhook is authenticated.
+
+**Code example**
+
+```sh
+$ curl -X POST http://localhost:9740/createinvoice \
+    -u :YOUR_PHOENIXD_PASSWORD \
+    -d description='my first invoice' \
+    -d amountSat=100 \
+    -d externalId=foobar \
+    -d webhookUrl='https://my.webhook.net'
+```
+
+**Response**
+
+```json
+{
+  "amountSat": 100,
+  "paymentHash": "f419207c9edde9021ebfb6bd0df6bd0a6606ecaf935357cc2f362e30835c3765",
+  "serialized": "lntb1u1pjlsjnqpp57svjqly7mh5sy84lk67sma4apfnqdm90jdf40np0xchrpq6uxajscqpjsp592kp0fs2ssgpq9h54tsfaj5w34287v8fezgaw6cr56f076c05glq9q7sqqqqqqqqqqqqqqqqqqqsqqqqqysgqdq6d4ujqenfwfehggrfdemx76trv5mqz9grzjqwfn3p9278ttzzpe0e00uhyxhned3j5d9acqak5emwfpflp8z2cnflcyamh4dcuhwqqqqqlgqqqqqeqqjqnjpjvnv0p3wvwc6vhzkkgm8kl9r837x4p9qupk5ln5tqlm7prrlsy5xd8cf5agae64f53dvm9el0z5hvgcnta4stgmrg7zwfah0nqrqph4ts8l"
+}
+```
+
+## Create Bolt12 offer
+
+**Endpoint**
+
+`POST /createoffer`
+
+**Description**
+
+Creates a Bolt12 offer with an optional description and amount.
+
+An offer is a static and reusable payment request that does not expire. It can be paid many times. It's well suited for donations or tips.
+
+Note: a `getoffer` call is also available but it is deprecated. This `getoffer` endpoint returns an offer, but always the same one. `createoffer` should be used instead.
+
+**Parameters**
+
+- description (optional) the description of the offer (max. 128 characters).
+- amountSat (optional) the amount requested by the offer, in satoshi. If not set, the offer can be paid by any amount.
+
+**Code example**
+
+```sh
+$ curl -X POST http://localhost:9740/createoffer \
+    -u :YOUR_PHOENIXD_PASSWORD \
+    -d description='an offer for Pierre' \
+    -d amountSat=100
+```
+
+**Response**
+
+```
+lno1qgsyxjtl6luzd9t3pr62xr7eemp6awnejusgf6gw45q75vcfqqqqqqqgqvqcdgq2zdskugr0venx2u3qvehhygzsd9jhyun9zrhq8yecsj40r443pquhuhh7tjrteukce2xj7uqwm2vahys5lsn39vf5q2fyfxsw6xn824393en87nre87xcectkgcj85trcu5hn9r9703645qsrxtcq785whraquh5atw89w5scg707fz23405ygk7jn9uek3tkmvdqqvc8yz8xm2yme6hjx3x02csmq6pfzaejqr3kzg7u8am96txu95z8am8zgvfvfcnzk27ylwk43ut48xv2vrkhqtj3wes32glw5ft5h7f4p8ytwey4cqjsks55zcmr3hka0p8e50thjqpjytmt5wsa4ylhavdmewv7jmj2ppy9daujfmfvpmnw9cf75cymjffzh2nafn883vsqr3a8u2l797mayh3p
+```
+
+## Get Lightning address
+
+**Endpoint**
+
+`GET /getlnaddress`
+
+**Description**
+
+Gets a BIP-353 Lightning address from the LSP. Only works if you have a channel.
+
+Note you can also use third-party services or self-host the address.
+
+**Code example**
+
+```sh
+$ curl http://localhost:9740/getlnaddress \
+    -u :YOUR_PHOENIXD_PASSWORD
+```
+
+**Response**
+
+```
+₿purplecrocus03@phoenixwallet.me
+```
+
+## Pay Bolt11 invoice
+
+**Endpoint**
+
+`POST /payinvoice`
+
+**Description**
+
+Pays a BOLT11 Lightning invoice. A 0.4% fee applies. Response includes the internal paymentId for that payment.
+
+**Parameters**
+
+- `amountSat` optional amount in satoshi. If unset, will pay the amount requested in the invoice
+- `invoice` BOLT11 invoice
+
+**Code example**
+
+```sh
+$ curl -X POST http://localhost:9740/payinvoice \
+    -u :YOUR_PHOENIXD_PASSWORD \
+    -d amountSat=1 \
+    -d invoice=lntb10n1pjl3pmlpp5jkrt9qvl83knc0sg0xztjlw0fd6t40725hdyh3pq0arudswvw8sqcqpjsp5zsc4phrg5v6nl84wkd9vuqzlva22j2qwll28v37y9jgjs7ap2dxs9q7sqqqqqqqqqqqqqqqqqqqsqqqqqysgqdq4xysyymr0vd4kzcmrd9hx7mqz9grzjqwfn3p9278ttzzpe0e00uhyxhned3j5d9acqak5emwfpflp8z2cnfl6h8msfh3505gqqqqlgqqqqqeqqjq6f8fhkj0uma7m68arjj3m5gn339xh3m5fn4qj9r9xu550686m0y8kadeahnn02ucmyq9nfsj0vl5vhpl6g7h6fs8xa8wu2qr3yc6a2gp4h32vu
+```
+
+**Response**
+
+```json
+{
+    "recipientAmountSat": 1,
+    "routingFeeSat": 4,
+    "paymentId": "961d413c-91ca-4f3d-9d91-760a08405901",
+    "paymentHash": "9586b2819f3c6d3c3e087984b97dcf4b74babfcaa5da4bc4207f47c6c1cc71e0",
+    "paymentPreimage": "6a3e65d9a05113864c9c27e430cc99751359ccbfa8fd5869aea46405df657986"
+}
+```
+
+## Pay Bolt12 offer
+
+**Endpoint**
+
+`POST /payoffer`
+
+**Description**
+
+Pays a BOLT12 Lightning offer. A 0.4% fee applies. Response includes the internal paymentId for that payment.
+
+**Parameters**
+
+- `amountSat` optional amount in satoshi. If unset, will pay the amount requested in the invoice
+- `offer` BOLT12 offer
+- `message` an optional message for the recipient
+
+**Code example**
+
+```sh
+$ curl -X POST http://localhost:9740/payoffer \
+    -u :YOUR_PHOENIXD_PASSWORD \
+    -d amountSat=123 \
+    -d offer=lno1qgsyxjtl6luzd9t3pr62xr...9ry9zqagt0ktn4wwvqg52v9ss9ls22sqyqqestzp2l6decpn87pq96udsvx \
+    -d message='👋 Hello!'
+```
+
+**Response**
+
+```json
+{
+  "recipientAmountSat": 123,
+  "routingFeeSat": 4,
+  "paymentId": "889c26f1-3028-4fae-9bd9-130c6e93542f",
+  "paymentHash": "54ed3cadcd102a475f7e7bd25a89223b46514df72c01c4fa9880aed7a795eb16",
+  "paymentPreimage": "09820bd4915f91ab21377879d5182c1bcf35feabdda5933266a99b4126f32b9b"
+}
+```
+
+## Pay Lightning address
+
+**Endpoint**
+
+`POST /paylnaddress`
+
+**Description**
+
+Pays an email-like Lightning address, either based on BIP-353 or LNURL. A 0.4% fee applies. Response includes the internal paymentId for that payment.
+Parameters
+
+- `amountSat` optional amount in satoshi. If unset, will pay the amount requested in the invoice
+- `address` BOLT11 invoice
+- `message` an optional message for the recipient
+
+**Code example**
+
+```sh
+$ curl -X POST http://localhost:9740/paylnaddress \
+    -u :YOUR_PHOENIXD_PASSWORD \
+    -d amountSat=123 \
+    -d address=flashybugle70@testnet.phoenixwallet.me \
+    -d message='👋 Hello!'
+```
+
+**Response**
+
+```json
+{
+  "recipientAmountSat": 123,
+  "routingFeeSat": 4,
+  "paymentId": "a9b1b8f8-bfdb-4299-9979-18e616bc9259",
+  "paymentHash": "bfa554308df2f397cd23ba724316660aaa398b2044b3e4e15ed79b8f2b278679",
+  "paymentPreimage": "dc4a8e059599d464d9ea10dfc0ffe6ad23a898c897c42dad973716e85c26a920"
+}
+```
+
+## Pay on-chain
+
+**Endpoint**
+
+`POST /sendtoaddress`
+
+**Description**
+
+Sends part of your current balance to a Bitcoin address. The spliced channel is not closed and remains active. Returns the transaction id if the splice was successful.
+
+**Parameters**
+
+- `amountSat` amount in satoshi
+- `address` Bitcoin address where funds will be sent
+- `feerateSatByte` fee rate in satoshi per vbyte
+
+**Code example**
+
+```sh
+$ curl -X POST http://localhost:9740/sendtoaddress \
+  -u :YOUR_PHOENIXD_PASSWORD \
+  -d amountSat=100000 \
+  -d address=tb1qwnp38xc5qh35ch9l5p6a3r7kwupj9rw5a4jn3y \
+  -d feerateSatByte=12
+```
+
+**Response**
+
+```
+05a28b4972560655eeedaaf72c4d8e9f1a285e47e2d347734853b5e49ae9ead0
+```
+
+## Bump fee
+
+**Endpoint**
+
+`POST /bumpfee`
+
+**Description**
+
+Makes all your unconfirmed transactions use a higher fee rate, using CPFP. Returns the ID of the child transaction.
+
+**Parameters**
+
+- `feerateSatByte` fee rate, in satoshi per vbyte.
+
+**Code example**
+
+```sh
+$ curl -X POST http://localhost:9740/bumpfee \
+  -u :YOUR_PHOENIXD_PASSWORD \
+  -d feerateSatByte=11
+```
+
+**Response**
+
+```
+758b3df67c62c9cd9ebbde1ff6eaadc1c51f94d5b1a3efb2548236b9a6f1c659
+```
+
+## List incoming payments
+
+**Endpoint**
+
+`GET /payments/incoming`
+
+**Description**
+
+Lists incoming payments.
+
+
+**Parameters**
+
+- `from`: start timestamp in millis from epoch, default 0
+- `to`: end timestamp in millis from epoch, default now
+- `limit`: number of payments in the page, default 20
+- `offset`: page offset, default 0
+- `all`: also return unpaid invoices
+- `externalId`: only include payments that use this external id.
+
+**Code example**
+
+```sh
+$ curl 'http://localhost:9740/payments/incoming?all=true&limit=3&offset=2' \
+	-u :YOUR_PHOENIXD_PASSWORD
+```
+
+**Response**
+
+```json
+[
+  {
+    "type": "incoming_payment",
+    "subType": "lightning",
+    "paymentHash": "5307f75da2a466d75c43593f45d4452853ba745860c008c61d3d0d0f24789b6d",
+    "preimage": "bfad93c6eff005d7d130a3a88fa7be269da26861063c20ad41e935fd5d174c3f",
+    "description": "1000 sat expiry 100s",
+    "invoice": "lntb10u1p5960u8pp52vrlwhdz53ndwhzrtyl5t4z99pfm5azcvrqq33sa85xs7frcndkscqzyssp58hpyavx3r39l6z9gnvtxv9pwfc52j2yk2dakxf4rtstfus369f7s9q7sqqqqqqqqqqqqqqqqqqqsqqqqqysgqdpqxycrqvpqwdshggr90pcxjuneyqcnqvrnmqz9gxqzryrzjqwfn3p9278ttzzpe0e00uhyxhned3j5d9acqak5emwfpflp8z2cnfll283f990e4ksqqqqlgqqqqqeqqjqdan93rk672ttjqdpgfznf48zwmw9ustqxt8wsgdxrvqddzwt0pcpwpxfdw6fk3h7yjc4xyhsq4yvslgrce368szx0vp2ev85ph2agvgpr4vfcq",
+    "isPaid": false,
+    "isExpired": true, // <--- the invoice has expired and cannot be paid anymore
+    "requestedSat": 1000,
+    "receivedSat": 0,
+    "fees": 0,
+    "expiresAt": 1750941675827,
+    "createdAt": 1750941575827
+  },
+  {
+    "type": "incoming_payment",
+    "subType": "lightning",
+    "paymentHash": "595a3f4824254c6fdbf0b07ba5bcc3953abbdce94e583085683d102e5e85338a",
+    "preimage": "ccfbc77a825d37a4f82b3a4ff3f278e92a46e232e7310efd5836a6bccf845528",
+    "description": "1000 sat expiry 250s",
+    "invoice": "lntb10u1p596skepp5t9dr7jpyy4xxlklskpa6t0xrj5athh8ffevrpptg85gzuh59xw9qcqzyssp59pl95q6y5gxtq75tf5nha039g2n0tx4w47qmxt4mkjhsxa29tlss9q7sqqqqqqqqqqqqqqqqqqqsqqqqqysgqdpqxycrqvpqwdshggr90pcxjuneyqer2vrnmqz9gxqz86rzjqwfn3p9278ttzzpe0e00uhyxhned3j5d9acqak5emwfpflp8z2cnfll283f990e4ksqqqqlgqqqqqeqqjq5u3svgk4j6hp2s6vyr4c7uawht0wnpplhnnmljmyzjr9r7a4qxd89anlgztszfvvczuvvqscmuaexajzjfc7wzsf46gzlqr2c24duyspfhymvf",
+    "isPaid": true,
+    "isExpired": false,
+    "requestedSat": 1000,
+    "receivedSat": 1050, // <--- Invoice was overpaid. The overpayment is receivedSat - requestedSat = 50 sat
+    "fees": 0,
+    "expiresAt": 1750942676001,
+    "completedAt": 1750942477605,
+    "createdAt": 1750942426001
+  },
+  {
+    "type": "incoming_payment",
+    "subType": "lightning",
+    "paymentHash": "1399476fe927fd02523ae203d05e3badeb27ee951c4d5dfdd06ba7f2d713864f",
+    "preimage": "a17e7be515418882adf36fbafae20d5bcf6e17bf17b6e08a1b4b5912e537574a",
+    "description": "amountless invoice",
+    "invoice": "lntb1p5963w3pp5zwv5wmlfyl7sy536ugpaqh3m4h4j0m54r3x4mlwsdwnl94cnse8scqzyssp5tc5jtzk7q7u4yfpa745p7rkuujw5cz5ytntj48z4fhetaguwr7js9q7sqqqqqqqqqqqqqqqqqqqsqqqqqysgqdqav9kk7atww3kx2umnyp5kuan0d93k2mqz9gxqyz5vqrzjqwfn3p9278ttzzpe0e00uhyxhned3j5d9acqak5emwfpflp8z2cnfll283f990e4ksqqqqlgqqqqqeqqjqgh7ctek00wl7d3e2syhjdgmlms3e7pkvjskxnu0p8rsdn52dlmgjtzw7s8y6uvdeft66053s593m92a5auj99gfdm8tng7a4v5wjyvqpx629fv",
+    "isPaid": true,
+    "isExpired": false,
+    "receivedSat": 1500,
+    "fees": 0,
+    "expiresAt": 1751029585548,
+    "completedAt": 1750943212490,
+    "createdAt": 1750943185548
+  },
+  {
+    "type": "incoming_payment",
+    "subType": "lightning",
+    "paymentHash": "b215bf7745a7d5250be2535b723dd881368c4c4dbd44819cbb0ca7d2d02ee140",
+    "preimage": "2ddcc7fd888f5c524e69c2a6e5ddd89a701b60c73746697568d438aa1cdbdafa",
+    "isPaid": true,
+    "receivedSat": 352,
+    "fees": 0,
+    "payerKey": "02da45cf516282e6959e48c26d6ed5f98bf7c32248193439bd1d22de81ae897426",
+    "completedAt": 1738677427800,
+    "createdAt": 1738677427800
+  },
+  {
+    "type": "incoming_payment",
+    "subType": "lightning",
+    "paymentHash": "9d1f404813f02b86ef177cffd2405f76010fafa98728d0c6ba57ba66f3736f7f",
+    "preimage": "1bd574c090c1214299449a6a0a23a7dc906b310b6e2d2afcabeb2d707205abb9",
+    "isPaid": true,
+    "receivedSat": 100000,
+    "fees": 0,
+    "payerKey": "02da45cf516282e6959e48c26d6ed5f98bf7c32248193439bd1d22de81ae897426",
+    "completedAt": 1738676523881,
+    "createdAt": 1738676523881
+  }
+]
+```
+
+## Get incoming payment
+
+**Endpoint**
+
+`GET /payments/incoming/{paymentHash}`
+
+**Code Example**
+
+```sh
+$ curl http://localhost:9740/payments/incoming/1399476fe927fd02523ae203d05e3badeb27ee951c4d5dfdd06ba7f2d713864f \
+	-u :YOUR_PHOENIXD_PASSWORD
+```
+
+**Response**
+
+```json
+{
+    "type": "incoming_payment",
+    "subType": "lightning",
+    "paymentHash": "1399476fe927fd02523ae203d05e3badeb27ee951c4d5dfdd06ba7f2d713864f",
+    "preimage": "a17e7be515418882adf36fbafae20d5bcf6e17bf17b6e08a1b4b5912e537574a",
+    "description": "amountless invoice",
+    "invoice": "lntb1p5963w3pp5zwv5wmlfyl7sy536ugpaqh3m4h4j0m54r3x4mlwsdwnl94cnse8scqzyssp5tc5jtzk7q7u4yfpa745p7rkuujw5cz5ytntj48z4fhetaguwr7js9q7sqqqqqqqqqqqqqqqqqqqsqqqqqysgqdqav9kk7atww3kx2umnyp5kuan0d93k2mqz9gxqyz5vqrzjqwfn3p9278ttzzpe0e00uhyxhned3j5d9acqak5emwfpflp8z2cnfll283f990e4ksqqqqlgqqqqqeqqjqgh7ctek00wl7d3e2syhjdgmlms3e7pkvjskxnu0p8rsdn52dlmgjtzw7s8y6uvdeft66053s593m92a5auj99gfdm8tng7a4v5wjyvqpx629fv",
+    "isPaid": true,
+    "isExpired": false,
+    "receivedSat": 1500,
+    "fees": 0,
+    "expiresAt": 1751029585548,
+    "completedAt": 1750943212490,
+    "createdAt": 1750943185548
+}
+```
+
+## List outgoing payments
+
+**Endpoint**
+
+`GET /payments/outgoing`
+
+**Description**
+
+Lists outgoing payments.
+
+**Parameters**
+
+- `from`: start timestamp in millis from epoch, default 0
+- `to`: end timestamp in millis from epoch, default now
+- `limit`: number of payments in the page, default 20
+- `offset`: page offset, default 0
+- `all`: also return payments that have failed
+
+**Code example**
+
+```sh
+$ curl 'http://localhost:9740/payments/outgoing?all=true&limit=3&offset=2' \
+	-u :YOUR_PHOENIXD_PASSWORD
+```
+
+**Response**
+
+```json
+[
+  {
+    "type": "outgoing_payment",
+    "subType": "auto_liquidity",
+    "paymentId": "7ad2ac96-1ff9-47ae-9013-b02203c55b93",
+    "txId": "53d85c7e1c5c667f5358666bafd0bce78295d6a87946f984133c9d8efe0b357d",
+    "isPaid": true,
+    "sent": 26850,
+    "fees": 26850000,
+    "completedAt": 1728565522629,
+    "createdAt": 1728565522382
+  },
+  {
+    "type": "outgoing_payment",
+    "subType": "lightning",
+    "paymentId": "9c020753-795c-40a9-b30e-b898b2ba80f5",
+    "paymentHash": "8125523666c317232342a6c01cc1f22a00affa958428eb9b8d7dc174fd4c2ddf",
+    "preimage": "0d9074340788444faca4a64d587febaac8bfb4cb811aabdf7ad2a2671647e425",
+    "isPaid": true,
+    "sent": 5,
+    "fees": 4004,
+    "completedAt": 1738348590680,
+    "createdAt": 1738348589678
+  },
+  {
+    "type": "outgoing_payment",
+    "subType": "lightning",
+    "paymentId": "dddfb160-f5dc-4930-b0d9-bc7a2ebf7b21",
+    "paymentHash": "9727389e1c776f4efb315c4effae02affcb723883d13433ea74cc9e3f2034a93",
+    "preimage": "e21f2f734d298a28fb77474ba11510c425566203daa0f9820706d6bfa75e4faa",
+    "isPaid": true,
+    "sent": 8,
+    "fees": 4016,
+    "invoice": "lntb1pne6xpnpp5junn38suwah5a7e3t380ltsz4l7twgug85f5x048fny78usrf2fscqzyssp5d4wueagg7fjetanym9gl0hpu244nclvxv72nmzlj0z2q4lpewsws9q7sqqqqqqqqqqqqqqqqqqqsqqqqqysgqdqqmqz9gxqyjw5qrzjqwfn3p9278ttzzpe0e00uhyxhned3j5d9acqak5emwfpflp8z2cnflcrt90lceflpuqqqqlgqqqqqeqqjq3nk0es2ahydaf9uz32kryn0wsgek0dmzfddy7nr7f007pn5nzdv83jnf3s7u7cvfxq6j4zd3khz86vzam7gfdq38f8earlc6u7fz5wcppg66jj",
+    "completedAt": 1738348627503,
+    "createdAt": 1738348626053
+  }
+]
+```
+
+## Get outgoing payment
+
+**Endpoint**
+
+`GET /payments/outgoing/{paymentId}`
+
+`GET /payments/outgoingbyhash/{paymentHash}`
+
+**Code example**
+
+```sh
+# by uuid
+$ curl http://localhost:9740/payments/outgoing/dddfb160-f5dc-4930-b0d9-bc7a2ebf7b21 \
+	-u :YOUR_PHOENIXD_PASSWORD
+```
+
+```sh
+# by payment hash
+$ curl http://localhost:9740/payments/outgoingbyhash/9727389e1c776f4efb315c4effae02affcb723883d13433ea74cc9e3f2034a93 \
+	-u :YOUR_PHOENIXD_PASSWORD
+```
+
+**Response**
+
+```json
+{
+  "type": "outgoing_payment",
+  "subType": "lightning",
+  "paymentId": "dddfb160-f5dc-4930-b0d9-bc7a2ebf7b21",
+  "paymentHash": "9727389e1c776f4efb315c4effae02affcb723883d13433ea74cc9e3f2034a93",
+  "preimage": "e21f2f734d298a28fb77474ba11510c425566203daa0f9820706d6bfa75e4faa",
+  "isPaid": true,
+  "sent": 8,
+  "fees": 4016,
+  "invoice": "lntb1pne6xpnpp5junn38suwah5a7e3t380ltsz4l7twgug85f5x048fny78usrf2fscqzyssp5d4wueagg7fjetanym9gl0hpu244nclvxv72nmzlj0z2q4lpewsws9q7sqqqqqqqqqqqqqqqqqqqsqqqqqysgqdqqmqz9gxqyjw5qrzjqwfn3p9278ttzzpe0e00uhyxhned3j5d9acqak5emwfpflp8z2cnflcrt90lceflpuqqqqlgqqqqqeqqjq3nk0es2ahydaf9uz32kryn0wsgek0dmzfddy7nr7f007pn5nzdv83jnf3s7u7cvfxq6j4zd3khz86vzam7gfdq38f8earlc6u7fz5wcppg66jj",
+  "completedAt": 1738348627503,
+  "createdAt": 1738348626053
+}
+```
+
+## CSV export
+
+**Endpoint**
+
+`POST /export`
+
+**Description**
+
+Exports your successful payments history in a CSV file. Returns the path of the generated file on your file system.
+
+The resulting CSV allows precise tracking of the balance and fee credit, and shows the split between mining and service fees:
+
+- `balance`: sum of all amount_msat
+- `fee credit`: sum of all fee_credit_msat
+
+**Parameters**
+
+- `from`: start timestamp in millis from epoch, default 0
+- `to`: end timestamp in millis from epoch, default now
+
+**Code example**
+
+```sh
+$ curl http://localhost:9740/export \
+	-u :YOUR_PHOENIXD_PASSWORD
+```
+
+**Response**
+
+```
+payment history has been exported to /Users/foobar/.phoenix/exports/export-1729249806.csv
+```
+
+## Payments websocket
+
+**Endpoint**
+
+`WS /websocket`
+
+**Description**
+
+Streams JSON of received payments.
+
+The JSON payload will contain a type field (for now, only "payment_received") and other technical data. It can contain an externalId if one was provided when the invoice was created, or the payerKey/payerNote for offers.
+
+**Authentication**
+
+Authentication can be done either with basic auth or with the Sec-WebSocket-Protocol header.
+
+**Websocket example**
+
+Using websocat, a command line utility for websocket:
+
+```sh
+$ websocat --basic-auth :YOUR_PHOENIXD_PASSWORD ws://127.0.0.1:9740/websocket
+{ "type": "payment_received", "amountSat": 15, "payerNote": "hello 👋", "payerKey": "02ad95a81c1865ddb41a49f07b11a70b3f8fcd68ae161e0eb561a074f6a223ff84", "paymentHash": "5ad2185b67c6ba2e65987ab22abf5b4f8c25049d1a3b5dda76f050bc7726aab3" }
+{ "type": "payment_received", "amountSat": 30, "payerKey": "02ad95a81c1865ddb41a49f07b11a70b3f8fcd68ae161e0eb561a074f6a223ff84", "paymentHash": "604def4dd6846ea6373ba27353b229ddb31ca1cb206d4becf95f82a0df4b8cfc" }
+```
+
+## Webhook
+
+When a payment is received, phoenixd will execute an HTTP POST request to endpoints of your choice, if any are configured in the phoenix.conf settings. Use this webhook mechanism to notify an external system that a payment was successfully received.
+
+Notes:
+
+- The webhook endpoint should be https, but this is not enforced by Phoenixd.
+
+- To notify a specific webhook for a specific payment, use the webhookUrl parameter instead when creating the invoice.
+
+- The JSON payload is similar to the websocket events.
+
+- The call is authenticated with a custom header.
+
+**Configuration example**
+
+```sh
+# in ~/.phoenix/phoenix.conf
+webhook=https://webhook.site/aaaaaaaa-bbbb-xxxx-yyyy-zzzz
+# you may have multiple webhooks, they will all be notified
+webhook=https://anotherwebhook.com
+```
+
+**Webhook example**
+
+```sh
+$ curl -X POST https://webhook.site/aaaaaaaa-bbbb-xxxx-yyyy-zzzz \
+    --header 'accept: application/json' \
+    --header 'accept-charset: UTF-8' \
+    --header 'content-type: application/json' \
+    --header 'host: webhook.site' \
+    --header 'X-Phoenix-Signature: 91a8735c0cc3cfc4bb0f22044dcac78f2b67ed3935261f1564b78f971a015f2d' \
+    --data $'{
+        "type": "payment_received",
+        "timestamp": 1748269006918,
+        "amountSat": 1,
+        "paymentHash": "7db610f2b418394f12ba84927868a4b98e6bca6a82dd644c905f4f0c257d336a",
+        "externalId": null,
+        "payerNote": null,
+        "payerKey": null
+    }'
+```
+
+## Webhook authentication
+
+Webhook calls are authenticated with a `X-Phoenix-Signature` header, containing the HMAC-SHA256 signature of the whole JSON body of the webhook call, encoded in utf-8, using the `webhook-secret` configuration parameter, also encoded in utf-8:
+
+```
+X-Phoenix-Signature = hmacSha256(
+  msg = <full http post body encoded as utf8>
+  secret = <webhook-secret from phoenix.conf>
+)
+```
+
+This allows you to verify that the webhook call is genuine.
+
+**Example**
+
+Given this json body:
+
+```json
+{
+    "type": "payment_received",
+    "timestamp": 1712785550079,
+    "amountSat": 8,
+    "paymentHash": "e628f8a516e9d3ee5e212a675f8d0c9dc5e7a5d500c5f4f91c62e9e921492653",
+    "externalId": null
+}
+```
+
+and this secret:
+
+```
+# in phoenix.conf
+webhook-secret: ef72d3b96324106dfbf83f2a4efeff7dddb4ce923e9664cb56baf34cc52936b6
+```
+
+The resulting signature will be:
+
+```
+X-Phoenix-Signature: 77ffc40401024fb417e45fdd002de06bdbf3b48b90d09d05cccd06462920aed7
+```
+
+## Get node info
+
+**Endpoint**
+
+`GET /getinfo`
+
+**Code example**
+
+```sh
+$ curl http://localhost:9740/getinfo \
+    -u :YOUR_PHOENIXD_PASSWORD
+```
+
+**Response**
+
+```json
+{
+  "nodeId": "023a882b070d0b9b1c8db2975f2dcc65d1ffa22e00085506ab24799d6d95d658a2",
+  "channels": [
+    // a compact list of your channels
+    {
+      "state": "Normal",
+      "channelId": "853c38dae30b4252cddcf3c87fc69f63313813cc5a0d06921d8a8d1f4c5f0692",
+      "balanceSat": 10,
+      "inboundLiquiditySat": 1013562,
+      "capacitySat": 1015160,
+      "fundingTxId": "3ed12fe931d1bc32ba94de8311f21016443ff6af338ac4e58b1b9ce2bd07dbf6"
+    }
+  ]
+}
+```
+
+## Get balance
+
+**Endpoint**
+
+`GET /getbalance`
+
+**Code example**
+
+```sh
+$ curl http://localhost:9740/getbalance \
+    -u :YOUR_PHOENIXD_PASSWORD
+```
+
+**Response**
+
+```json
+{
+  "balanceSat": 104228,
+  "feeCreditSat": 391
+}
+```
+
+## List channels
+
+**Endpoint**
+
+`GET /listchannels`
+
+**Code example**
+
+```sh
+$ curl http://localhost:9740/listchannels \
+    -u :YOUR_PHOENIXD_PASSWORD
+```
+
+**Response**
+
+```json
+[
+    {
+        "type": "fr.acinq.lightning.channel.states.Normal",
+        "commitments": {
+            "params": {
+                "channelId": "caeda5a5ad278221c0ec995d667a607b7f7e006f7c092872783acf2015fa6455",
+                "channelConfig": [
+                    "funding_pubkey_based_channel_keypath"
+                ],
+                "channelFeatures": [
+                    "option_static_remotekey",
+                    "option_anchor_outputs",
+                    "zero_reserve_channels",
+                    "option_dual_fund"
+                ],
+                "localParams": {
+                    "nodeId": "022c03770b43158d67321a34de5e3e5a4a662adeafbe0270674704eeef56e39770",
+                    "fundingKeyPath": "m/2147483553'/2147483543'/2143050548'/2147483562'/2147462237'/2147483597'/2147478557'/2147483611'/0'",
+                    "dustLimit": 546,
+                    "maxHtlcValueInFlightMsat": 20000000000,
+                    "htlcMinimum": 1000,
+                    "toSelfDelay": 2016,
+                    "maxAcceptedHtlcs": 6,
+                    "isInitiator": false,
+                    ...
+                },
+                "remoteParams": {
+                    "nodeId": "03933884aaf1d6b108397e5efe5c86bcf2d8ca8d2f700eda99db9214fc2712b134",
+                    "dustLimit": 546,
+                    "maxHtlcValueInFlightMsat": 2100000000000000000,
+                    "htlcMinimum": 1,
+                    ...
+                },
+                "channelFlags": 0
+            },
+
+        },
+        "shortChannelId": "0x7410060x0",
+        "channelUpdate": {
+            "signature": "76164e3c3325521936461a40d12a2b7d998b97acb41fb80a59d4751bac4a0cd671f3b704559fef4a182729b98db0b57402e56f8f439cc7bc20096d05392af947",
+            "chainHash": "43497fd7f826957108f4a30fd9cec3aeba79972084e90ead01ea330900000000",
+            "shortChannelId": "0x7410060x0",
+            "timestampSeconds": 1709829101,
+            "messageFlags": 1,
+            "channelFlags": 0,
+            "cltvExpiryDelta": 144,
+            "htlcMinimumMsat": 1,
+            "feeBaseMsat": 1000,
+            "feeProportionalMillionths": 100,
+            "htlcMaximumMsat": 1252708000
+        },
+        ...
+    }
+]
+```
+
+## Close channel
+
+**Endpoint**
+
+`POST /closechannel`
+
+**Description**
+
+Closes a given channel, and send all funds to an on-chain address. Returns the ID of the closing transaction.
+
+Attention: closing a channel is final, it cannot be cancelled.
+
+**Parameters**
+
+- `channelId` identifier of the channel to close
+- `address` bitcoin address where your balance will be sent to
+- `feerateSatByte` fee rate in satoshi per vbyte
+
+**Code example**
+
+```sh
+$ curl -X POST http://localhost:9740/closechannel \
+ -u :YOUR_PHOENIXD_PASSWORD \
+ -d channelId=1943e03b85c06c60678ecc0fefcae8317f0a1429838aaeed1c9df4e548d7c29c \
+ -d feerateSatByte=10 \
+ -d address=tb1qrhv88h2rf7wscut7st3ha5uspx2njjr7xdzn5t
+```
+
+**Response**
+
+```
+758b3df67c62c9cd9ebbde1ff6eaadc1c51f94d5b1a3efb2548236b9a6f1c659
+```
+## Decode invoice
+
+**Endpoint**
+
+`POST /decodeinvoice`
+
+**Parameters**
+
+invoice a Bolt11 invoice
+
+**Code example**
+
+```sh
+$ curl -X POST http://localhost:9740/decodeinvoice \
+ -u :YOUR_PHOENIXD_PASSWORD \
+ -d invoice=lntb10n1pngtqfhpp5qezkef9tussdxurernxpmur9fzm2g0gqjuffaypvd2r7ma8urh4scqpjsp5u3dgmgrry4advuse35al6d2j2ns9uewequpuwcf8eun0pk7m5lms9q7sqqqqqqqqqqqqqqqqqqqsqqqqqysgqdq4xysyymr0vd4kzcmrd9hx7mqz9grzjqwfn3p9278ttzzpe0e00uhyxhned3j5d9acqak5emwfpflp8z2cnfl6h8msfh3505gqqqqlgqqqqqeqqjq3krntmn2r4d8j0ncgztxkssymfpwy3lv48jt5zgq5te8c5h56r6r03a2nz09nye89pmyhncm64ppwcufntar2zs5m4jw2cfm8u9m3usqxju37k
+```
+
+**Response**
+
+```json
+{
+    "chain": "testnet",
+    "amount": 1000,
+    "paymentHash": "06456ca4abe420d370791ccc1df06548b6a43d0097129e902c6a87edf4fc1deb",
+    "description": "1 Blockaccino",
+    "minFinalCltvExpiryDelta": 18,
+    "paymentSecret": "e45a8da063257ad672198d3bfd355254e05e65d90703c76127cf26f0dbdba7f7",
+    "paymentMetadata": "2a",
+    "extraHops": [
+        [
+            {
+                "nodeId": "03933884aaf1d6b108397e5efe5c86bcf2d8ca8d2f700eda99db9214fc2712b134",
+                "shortChannelId": "16734014x14719942x36770",
+                "feeBase": 1000,
+                "feeProportionalMillionths": 100,
+                "cltvExpiryDelta": 144
+            }
+        ]
+    ],
+    "features": {
+        "activated": {
+            "var_onion_optin": "Mandatory",
+            "payment_secret": "Mandatory",
+            "basic_mpp": "Optional",
+            "option_payment_metadata": "Optional",
+            "trampoline_payment_experimental": "Optional"
+        },
+        "unknown": []
+    },
+    "timestampSeconds": 1720025399
+}
+```
+## Decode offer
+
+`Endpoint`
+
+`POST /decodeoffer`
+
+**Parameters**
+
+- `offer` a Bolt12 offer
+
+**Response**
+
+```json
+{
+    "chain": "mainnet",
+    "chainHashes": [
+        "43497fd7f826957108f4a30fd9cec3aeba79972084e90ead01ea330900000000"
+    ],
+    "path": [
+        {
+            "introductionNodeId": {
+                "publicKey": "03933884aaf1d6b108397e5efe5c86bcf2d8ca8d2f700eda99db9214fc2712b134"
+            },
+            "blindingKey": "021aeddbf39bf6e9a69bf331c7a5a524a55efaffd6643c127f66378d0ace9529f4",
+            "blindedNodes": [
+                {
+                    "blindedPublicKey": "0339e5efc9f4935ae8f84f6db02abf2450422e1fe8ac2e2080f479b1eccf37e1a7",
+                    "encryptedPayload": "9361a42a22f03b70d5039b8f53db5a2e81b83079fe4301d0284b7c18b2ceba42d4b43c168672593ba126d32b88cafdf49c49e7"
+                },
+                {
+                    "blindedPublicKey": "031448f2aa7355336a93fe304a4e14642881d42df65ceae73008a2985840bf8295",
+                    "encryptedPayload": "00cc1620abfa6e70199fc10175c6c186"
+                }
+            ]
+        }
+    ]
+}
+
+## Estimate liquidity fees
+
+**Endpoint**
+
+`POST /estimateliquidityfees`
+
+**Description**
+
+Estimates a liquidity fee for a given amount. Note that it depends on the current mining feerate, which is volatile. The estimate returned is the full cost and does not take into account any fee credit you may have.
+
+**Parameters**
+
+- `amountSat` the liquidiy amount, in satoshi.
+
+**Code example**
+
+```
+$ curl -X POST http://localhost:9740/estimateliquidityfees \
+ -u :YOUR_PHOENIXD_PASSWORD \
+ -d amountSat=2000000
+```
+
+**Response**
+
+```json
+{
+"miningFeeSat": 1219,
+"serviceFeeSat": 20000
+}
+```
+## LNURL Pay
+
+**Description**
+
+Pays a LNURL-pay resource. Note that the service may apply restrictions on the amount to pay or the message -- the lnurl-pay flow is usually interactive.
+Endpoint
+
+`POST /lnurlpay`
+
+**Parameters**
+
+- `amountSat` the amount to pay
+- `lnurl` the lnurl-pay resource
+- `message` a comment for the recipient
+
+**Code example**
+
+```sh
+$ curl -X POST http://localhost:9740/lnurlpay \
+ -u :YOUR_PHOENIXD_PASSWORD \
+ -d lnurl=LNURL1DP68GURN8GHJ7MRWW4EXCTNXD9SHG6NPVCHXXMMD9AKXUATJDSKHQCTE8AEK2UMND9HKU0TZV9JR2VM9XV6RVV3JVSUNWDRYXUCNVDFHV43KVE3KXQCRJDFHX33XGDENX9NRSVTRXCENVC3KV33NGWR9XQURWC3N8YEN2WP4V4JNZV8XSUH \
+ -d amountSat=100
+```
+
+**Response**
+
+```json
+    {
+    "recipientAmountSat": 100,
+    "routingFeeSat": 4,
+    "paymentId": "2ff3c4f2-1d97-4dc0-a522-371591c058dc",
+    "paymentHash": "6a0084471b2020373a89a81b5f7e34135154f24208e491d0122d99a686b1d58d",
+    "paymentPreimage": "5746edcdbf872fc508939f31f18998f294d579668f334a023804b992b0fe4842"
+    }
+```
+
+## LNURL Withdraw
+
+**Description**
+
+Withdraws funds from a LNURL service. Phoenixd will withdraw the maximum amount authorized by the service.
+Endpoint
+
+`POST /lnurlwithdraw`
+
+**Parameters**
+
+- `lnurl` the lnurl-withdraw resource
+
+**Code example**
+
+```sh
+$ curl -X POST http://localhost:9740/lnurlpay \
+ -u :YOUR_PHOENIXD_PASSWORD \
+ -d lnurl=lightning:LNURL1DP68GURN8GHJ7MRWW4EXCTNXD9SHG6NPVCHXXMMD9AKXUATJDSKHW6T5DPJ8YCTH8AEK2UMND9HKU0T9893XYVF5XQMX2EP4VYCNJWR9X56RSCEE893NYVP3VC6KGEPNX5UNGDFCV9NRJDNXXCMNXENZXPJXVCFS89NRWVFJXYCNXD3K89JNGAXMZVT
+```
+
+**Response**
+
+```json
+{
+    "url": "https://lnurl.fiatjaf.com/lnurl-withdraw?session=e9bb1406ed5a198e548c99c201f5dd359458af96f673fb0dfa09f712113669e4",
+    "minWithdrawable": 1000,
+    "maxWithdrawable": 4000,
+    "description": "sample withdraw",
+    "k1": "1649e2443dd004421e05e08a17e52ee1454e9f74aacedacc822777b9ff4ffbfb",
+    "invoice": "lnbc40n1pnfqpstpp5npnnapuxylxelsat27q4dncgj...2f0tvfw33kspxfenxx"
+}
+```
+
+## LNURL Auth
+
+**Description**
+
+Authenticates a LNURL-auth resource to allow an action on a remote service. See LUD-04 for details.
+
+Note: The key used to sign is derived from the wallet's key (derivation depends on the lnurl service's domain). If you have different users using the same phoenixd instance, do not let them use this or they will share the same signature and pubkey!
+
+**Endpoint**
+
+`POST /lnurlauth`
+
+**Parameters**
+
+- `lnurl` the lnurl-auth resource
+
+**Code example**
+
+```sh
+$ curl -X POST http://localhost:9740/lnurlauth \
+ -u :YOUR_PHOENIXD_PASSWORD \
+ -d lnurl=lnurl1dp68gurn8ghj7um5v93kketj9ehx2amn9ashq6f0d3hxzat5dqlhgct884kx7emfdcnxkvfav3nxxcehxyckvdrpxsexyden8qexywrpv33nvdmpxsukzdpnvgungct9xesnvcf3x9jnsenxvvurvcmzvd3rwdfevgmnwdpjxp3nqvg50j329
+```
+
+**Response**
+
+authentication success