bitcoin-libraries-ldk

Other Community

Repo stars 0
Author repo skills-registry

Interpretation is structured for decision-making; original keeps the upstream SKILL.md unchanged.

Decide Fit First

Core job: | Use when this capability is needed. Modular Rust library for Lightning. Used by Mutiny Wallet, Cash App, Casa, ldk-node, more.…
Best fit: Use it when the task has reusable inputs, steps, and validation criteria rather than a one-off answer.
Avoid forcing it: If the source lacks commands, platform support, or external-service evidence, keep those fields unknown instead of guessing.

Design Intent

Structure: The skill is organized around “Crates”, “ldk-node quickstart”, “Bindings”, “Use cases”, showing how the author expects the agent to judge fit, collect context, and produce verifiable output.
Trigger evidence: Prioritize the author’s wording around when to use it, what context to collect, and what output shape to produce.
Evidence boundary: Author text states facts, repository files prove commands and paths, and Fluxly only adds fit, limits, and usage judgment.

How To Use It

Inputs: Provide target material, scope, expected result, forbidden changes, and validation method.
Invocation: Name bitcoin-libraries-ldk directly; if the source includes slash commands, start with the command and then add task context.
Validation: Start small and check whether the result follows “Crates / ldk-node quickstart / Bindings” before expanding.

Boundaries And Review

Dependencies: It usually needs no extra API key, so start with a small validation task.
Permissions: Declared permissions include read; ask the agent to state file, command, and rollback boundaries before acting.
Quality bar: A useful result names the deliverable, evidence, and next action. Generic prose means the task needs tighter context.

LDK (Lightning Dev Kit)

Modular Rust library for Lightning. Used by Mutiny Wallet, Cash App, Casa, ldk-node, more.

See full overview at ../../lightning/ldk/SKILL.md.

Crates

lightning — core protocol logic.
lightning-net-tokio — async TCP transport.
lightning-persister — file persistence.
lightning-background-processor — task driver.
lightning-block-sync — chain sync via bitcoind RPC.
lightning-transaction-sync — chain sync via Esplora / Electrum.
lightning-rapid-gossip-sync — fast initial gossip.
lightning-invoice — BOLT11 invoice handling.
ldk-node — opinionated bundled crate.
lightning-liquidity — LSP client/server.

ldk-node quickstart

[dependencies]
ldk-node = "0.4"

use ldk_node::{Builder, Network};

let builder = Builder::new()
    .set_network(Network::Bitcoin)
    .set_chain_source_esplora("https://mempool.space/api".into())
    .set_storage_dir_path("/path/to/data".into());
let node = builder.build()?;
node.start()?;

let invoice = node.bolt11_payment().receive(
    100_000_000,    // 100k msat
    "Test", 3600,
)?;

Bindings

LDKSwift — iOS/macOS.
LDKKotlin / LDKAndroid — Android.
ldk-node-jvm — JVM.
ldk-node-js — JS/WASM.

Use cases

Mobile Lightning wallets.
Browser-based LN (Mutiny via WASM).
Custom backend services with Lightning embedded.

Compared

See ../../lightning/ldk/SKILL.md for LND/CLN comparison and full feature matrix.

Common pitfalls

Persist trait misimplementation → state corruption.
Async signer race conditions.
Version migrations require careful state migration.

Fluxly category: Other
Author-declared agents: No explicit declaration found; this is not inferred or tested compatibility
Static check: 88 / 100 · heuristic scan, not runtime safety proof
Author / version / license: @tomevault-io · no license declared
Fluxly token estimate: Lean
Fluxly setup estimate: Plug-and-play
External API key: No requirement detected
Detected OS requirements: macOS
Runtime requirements: Node.js
Detected file/system behavior: Read-only
Detected network behavior: Local-only
Install commands: None (reference only)

Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.

Heads up: 未限定 allowed-tools，默认拥有全部工具权限。

Output preview bitcoin-libraries-ldk.preview

The current SKILL.md does not define a fixed output example.

SKILL.md SKILL.md

# LDK (Lightning Dev Kit)

Modular Rust library for Lightning. Used by Mutiny Wallet, Cash App,
Casa, ldk-node, more.

See full overview at [../../lightning/ldk/SKILL.md](../../lightning/ldk/SKILL.md).

## Crates

- `lightning` — core protocol logic.
- `lightning-net-tokio` — async TCP transport.
- `lightning-persister` — file persistence.
- `lightning-background-processor` — task driver.
- `lightning-block-sync` — chain sync via bitcoind RPC.
- `lightning-transaction-sync` — chain sync via Esplora / Electrum.
- `lightning-rapid-gossip-sync` — fast initial gossip.
- `lightning-invoice` — BOLT11 invoice handling.
- `ldk-node` — opinionated bundled crate.
- `lightning-liquidity` — LSP client/server.

## ldk-node quickstart

```toml
[dependencies]
ldk-node = "0.4"
```

```rust
use ldk_node::{Builder, Network};

let builder = Builder::new()
    .set_network(Network::Bitcoin)
    .set_chain_source_esplora("https://mempool.space/api".into())
    .set_storage_dir_path("/path/to/data".into());
let node = builder.build()?;
node.start()?;

let invoice = node.bolt11_payment().receive(
    100_000_000,    // 100k msat
    "Test", 3600,
)?;
```

## Bindings

- **LDKSwift** — iOS/macOS.
- **LDKKotlin / LDKAndroid** — Android.
- **ldk-node-jvm** — JVM.
- **ldk-node-js** — JS/WASM.

## Use cases

- Mobile Lightning wallets.
- Browser-based LN (Mutiny via WASM).
- Custom backend services with Lightning embedded.

## Compared

See [../../lightning/ldk/SKILL.md](../../lightning/ldk/SKILL.md) for
LND/CLN comparison and full feature matrix.

## Common pitfalls

- `Persist` trait misimplementation → state corruption.
- Async signer race conditions.
- Version migrations require careful state migration.

## See also

- [../../lightning/ldk/SKILL.md](../../lightning/ldk/SKILL.md)

…

Evidence boundary and execution chain

Author text anchors workflow facts; Fluxly only indexes current sections, terms, files, and commands.

sections -> Crates → ldk-node quickstart → Bindings → Use cases → Compared → Common pitfalls
terms    -> LDKSwift · LDKKotlin / LDKAndroid · ldk-node-jvm · ldk-node-js
files/cmd -> lightning · lightning-net-tokio · lightning-persister · lightning-background-processor · lightning-block-sync · lightning-transaction-sync · lightning-rapid-gossip-sync · lightning-invoice
body sha256 -> de022039f6c9