wavelength-api

Integrate backends with the waved wallet daemon over gRPC or REST APIs.

4|4|Updated Jun 24, 2026
One-click install
npx skills add https://github.com/lightninglabs/wavelength-sdk --skill wavelength-api-lightninglabs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wavelength-api
Source: https://github.com/lightninglabs/wavelength-sdk/tree/main/skills/wavelength-api
Command: npx skills add https://github.com/lightninglabs/wavelength-sdk --skill wavelength-api-lightninglabs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Backend and non-browser developers need to call the Wavelength wallet daemon (waved) WalletService correctly, but risk guessing field names from other Lightning implementations like lnd, misusing REST error semantics, or confusing satoshi and millisatoshi amounts. ## Core Features & Use Cases - RPC Reference Navigation: Points to one documentation page per WalletService RPC with request and response field tables, each with a markdown twin for direct fetching. - Transport Selection Guidance: Helps choose gRPC for streaming and typed clients versus REST for simple request-response calls under /v1/wallet/. - Correctness Rules: Enforces documented error shapes, satoshi-denominated integer amounts, and field names from the official docs rather than lnd assumptions. - Use Case: A backend engineer building a payment service connects to waved over gRPC, looks up the exact RPC page for sending a payment, and constructs the request using the documented field table. ## Quick Start Ask the assistant to show how to call a specific WalletService RPC on waved, for example how to connect and send a payment over the REST API.

Frequently Asked Questions about wavelength-api

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I call the Wavelength wallet daemon API from a backend?

Connect to the waved daemon and call WalletService over gRPC or its REST gateway under /v1/wallet/. Fetch the documentation page for the specific RPC you need to get exact request and response fields before writing code.

Should I use gRPC or REST for the waved WalletService?

Use gRPC for streaming calls and typed clients, and REST for simple request-response operations. Every RPC documentation page shows both surfaces so you can pick per call.

Is the waved API the same as the lnd gRPC API?

No, waved is not lnd and shares no proto surface with it. Always read field names from the Wavelength RPC documentation instead of assuming lnd-compatible messages.

Are amounts in the Wavelength API in satoshis or millisatoshis?

Amounts are satoshi-denominated integers unless a field's documentation table states otherwise. Never infer millisatoshis from other Lightning APIs.

When should I use the Wavelength SDK instead of the daemon API?

Use the SDK when embedding a wallet directly in a web page or React Native app, where the wallet runs in-process. Use the waved gRPC or REST API for backends and non-browser integrations connecting to a running daemon.