Add Claude.md

Used /init in claude code to make initial structure than added some
notes myself.

Author: benthecarman

CLAUDE.md

@@ -0,0 +1,76 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+LDK Server is a Lightning Network node daemon built on LDK Node, exposing a REST API via Protocol Buffers with TLS and HMAC-based API key authentication.
+
+## Build Commands
+
+```bash
+cargo build                                                   # Build all crates
+cargo build --release                                         # Production build (LTO enabled)
+cargo test                                                    # Run all tests
+cargo test --all-features                                     # Run tests with all features
+cargo fmt --all                                               # Format code
+cargo fmt --all -- --check                                    # Check formatting
+cargo clippy --all-features -- -D warnings                    # Lint (CI uses this on MSRV)
+RUSTFLAGS="--cfg genproto" cargo build -p ldk-server-protos   # Regenerate protobuf files
+```
+
+## Running
+
+```bash
+cargo run --bin ldk-server ./ldk-server/ldk-server-config.toml
+```
+
+## Workspace Structure
+
+- **ldk-server** - Main daemon server (entry point: `src/main.rs`)
+- **ldk-server-cli** - CLI client using clap
+- **ldk-server-client** - Reqwest-based client library
+- **ldk-server-protos** - Protocol buffer definitions and generated Rust code
+
+## Architecture
+
+**Key Components:**
+- `ldk-server/src/service.rs` - HTTP service with HMAC authentication
+- `ldk-server/src/api/` - Individual endpoint handlers (bolt11_send, open_channel, etc.)
+- `ldk-server/src/io/persist/` - SQLite-based persistence with pagination
+- `ldk-server/src/io/events/` - Event publishing (Noop or RabbitMQ)
+- `ldk-server/src/util/` - Config parsing, TLS, logging, proto adapters
+
+**Protocol Buffers:**
+- Proto files: `ldk-server-protos/src/proto/` (api.proto, types.proto, events.proto, error.proto)
+- Generated code: `ldk-server-protos/src/` (api.rs, types.rs, events.rs, error.rs)
+- Regenerate with: `RUSTFLAGS="--cfg genproto" cargo build -p ldk-server-protos`
+
+**Adding a New API Endpoint:**
+1. Define request/response messages in `ldk-server-protos/src/proto/api.proto`
+2. Regenerate protos: `RUSTFLAGS="--cfg genproto" cargo build -p ldk-server-protos`
+3. Create handler in `ldk-server/src/api/` (follow existing patterns)
+4. Add route in `ldk-server/src/service.rs`
+5. Add CLI command in `ldk-server-cli/src/main.rs`
+
+**Configuration:**
+- Config template with all options: `ldk-server/ldk-server-config.toml`
+- When updating config options, also update the tests in `ldk-server/src/util/config.rs`
+
+## Feature Flags
+
+- `events-rabbitmq` - Enable RabbitMQ event publishing
+- `experimental-lsps2-support` - Experimental LSPS2 liquidity provider support
+- `integration-tests-events-rabbitmq` - RabbitMQ integration tests
+
+## Code Style
+
+- MSRV: Rust 1.85.0
+- Hard tabs, max width 100 chars
+- Imports grouped: std, external crates, local crates
+
+## Development Rules
+
+- Run `cargo fmt --all` after every code change
+- Never add new dependencies unless explicitly requested
+- Include Co-Authored-By Claude in commit messages for AI-generated code