# lightninglabs/wavelength — health index 83/100 (Excellent)

> Inspection of the public repository lightninglabs/wavelength by inspect.software. It holds a health index of 83 out of 100, placing it in the Excellent band. The index is a signal derived from publicly visible practice, not a warranty, a security audit, or an endorsement, and it is independent of payment.

- Repository: https://github.com/lightninglabs/wavelength
- Report page: https://inspect.software/software/lightninglabs/wavelength
- Full JSON report: https://inspect.software/api/repositories/lightninglabs/wavelength/report
- Badge: https://raw.githubusercontent.com/inspect-software/badges/main/v1/l/lightninglabs/wavelength.svg
- Inspected: 2026-09-19
- Methodology: metrics 2.10.0, report schema 0.34.0 (https://inspect.software/methodology.md)

## Category summary

| Category | Weight | Index | Band |
|---|---|---|---|
| Vitality | 21% | 96/100 | Exceptional |
| Community & Adoption | 17% | 43/100 | Weak |
| Sustainability & Governance | 23% | 70/100 | Good |
| Engineering Quality | 19% | 86/100 | Excellent |
| Security | 16% | 38/100 | Weak |
| AI Readiness | 4% | 89/100 | Excellent |

The weighted overall 70 is calibrated to 83 on the published index scale (record calibration 2026-08-02).

## Repository facts

| Field | Value |
|---|---|
| Description | a toolkit for adding self-custodial bitcoin payments to applications and agents |
| Classification | cli, library |
| Homepage | https://wavelength.lightning.engineering/ |
| Primary language | Go |
| License | MIT |
| Stars | 47 |
| Forks | 14 |
| Created | 2025-11-12 |
| Last push | 2026-09-18 |
| Latest release | v0.1.2 |
| Commits (last year) | 3,013 |
| Bus factor | 2 |

## Published packages

| Registry | Package | Latest | Monthly downloads |
|---|---|---|---|
| go | github.com/lightninglabs/wavelength | v0.1.2 | — |

## Vitality — 96/100 (Exceptional)

Is the project alive — is code being written and are releases shipping? Weight: 21% of the overall index.

### Development activity — 94/100 (Exceptional)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Push recency | met | 36 / 36 | last push 0 days ago |
| Commit cadence | partial | 30.5 / 36 | 44/52 weeks with commits |
| Commit volume | met | 18 / 18 | 3013 commits in the last year |
| OpenSSF Scorecard: Maintained | met | 10 / 10 | 30 commit(s) and 25 issue activity found in the last 90 days -- score normalized to 10 |

### Release discipline — 98/100 (Exceptional)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Ships releases | met | 27 / 27 | 11 releases published |
| Release recency | met | 36 / 36 | latest release 7 days ago |
| Release cadence | met | 27 / 27 | a release every ~4.8 days |
| OpenSSF Scorecard: Signed-Releases | partial | 8 / 10 | 5 out of the last 5 releases have a total of 5 signed artifacts. |

### Abandonment — 100/100 (Exceptional)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Project is still maintained | met | 100 / 100 | last human commit 2 days ago |

## Community & Adoption — 43/100 (Weak)

Does the project have users, downloads, attention, and a welcoming setup for contributors? Weight: 17% of the overall index.

### Popularity & adoption — 36/100 (Weak)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Stars | partial | 27 / 60 | 47 stars |
| Forks | partial | 9.3 / 25 | 14 forks |
| Watchers | not met | 0 / 15 | 0 watchers |

### Community health — 50/100 (Moderate)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| README | met | 22.5 / 22.5 | — |
| License | met | 22.5 / 22.5 | recognized license (MIT) |
| CONTRIBUTING guide | not met | 0 / 18 | — |
| Code of conduct | not met | 0 / 13.5 | — |
| Issue template | not met | 0 / 7.2 | — |
| PR template | not met | 0 / 6.3 | — |

## Sustainability & Governance — 70/100 (Good)

Will the project survive its people — bus factor, responsiveness, who backs it, and package upkeep? Weight: 23% of the overall index.

### Maintainer resilience (bus factor) — 60/100 (Moderate)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Bus factor | partial | 25.2 / 54 | 2 contributor(s) cover half of all commits |
| Commit distribution | partial | 11.2 / 22.5 | top contributor authored 50% of commits |
| Contributor breadth | met | 13.5 / 13.5 | 15 contributors |
| OpenSSF Scorecard: Contributors | met | 10 / 10 | project has 6 contributing companies or organizations |

### Issue & PR responsiveness — 53/100 (Moderate)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Issue resolution | partial | 29.8 / 42 | 71% of issues closed |
| PR acceptance | partial | 23.1 / 30 | 703/914 decided PRs merged |
| Newcomer PR acceptance | not met | 0 / 13 | 0/1 first-time contributors' PRs merged in 30d |
| OpenSSF Scorecard: Code-Review | not met | 0 / 15 | Found 0/6 approved changesets -- score normalized to 0 |

### Ownership & stewardship — 75/100 (Good)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Ownership backing | met | 30 / 30 | organization-owned |
| Verified domain | not met | 0 / 20 | — |
| Owner reach | partial | 20.5 / 25 | 708 followers of lightninglabs |
| Track record | partial | 24.7 / 25 | 55 public repos, account ~9 yr old |

### Package maintenance — 100/100 (Exceptional)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Published & resolvable | met | 25 / 25 | 1 package(s) on go |
| Publish recency | met | 35 / 35 | latest publish 8 days ago |
| Version history | met | 20 / 20 | 16 published versions |
| Not deprecated | met | 20 / 20 | active, not deprecated or yanked |

## Engineering Quality — 86/100 (Excellent)

Are baseline engineering and documentation practices in place? Weight: 19% of the overall index.

### Engineering practices — 84/100 (Excellent)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| CI workflows | met | 24 / 24 | 11 workflow(s) |
| Tests present | met | 24 / 24 | — |
| Linter config | met | 16 / 16 | .golangci.yml |
| Pre-commit hooks | not met | 0 / 9.6 | — |
| .editorconfig | not met | 0 / 6.4 | — |
| OpenSSF Scorecard: CI-Tests | met | 20 / 20 | 6 out of 6 merged PRs checked by a CI test -- score normalized to 10 |

### Documentation — 90/100 (Excellent)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| README | met | 30 / 30 | — |
| Documentation directory | met | 25 / 25 | — |
| Documentation / homepage site | met | 15 / 15 | https://wavelength.lightning.engineering/ |
| Repository description | met | 10 / 10 | — |
| Topics | not met | 0 / 10 | — |
| Wiki | met | 10 / 10 | — |

## Security — 38/100 (Weak)

Are visible security and supply-chain practices strong, with no malicious dependency and no unresolved high-risk jurisdiction exposure? Weight: 16% of the overall index.

### Security posture — 38/100 (Weak)

Excluded from scoring (no data or not applicable): Packaging. Remaining weights renormalized.

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Binary-Artifacts | met | 7.5 / 7.5 | no binaries found in the repo |
| Branch-Protection | partial | 3 / 7.5 | branch protection is not maximal on development and all release branches |
| CI-Tests | met | 2.5 / 2.5 | 6 out of 6 merged PRs checked by a CI test -- score normalized to 10 |
| CII-Best-Practices | not met | 0 / 2.5 | no effort to earn an OpenSSF best practices badge detected |
| Code-Review | not met | 0 / 7.5 | Found 0/6 approved changesets -- score normalized to 0 |
| Contributors | met | 2.5 / 2.5 | project has 6 contributing companies or organizations |
| Dangerous-Workflow | not met | 0 / 10 | dangerous workflow patterns detected |
| Dependency-Update-Tool | not met | 0 / 7.5 | no update tool detected |
| Fuzzing | met | 5 / 5 | project is fuzzed |
| License | met | 2.5 / 2.5 | license file detected |
| Maintained | met | 7.5 / 7.5 | 30 commit(s) and 25 issue activity found in the last 90 days -- score normalized to 10 |
| Packaging | excluded | 0 / 5 | packaging workflow not detected |
| Pinned-Dependencies | partial | 1 / 5 | dependency not pinned by hash detected -- score normalized to 2 |
| SAST | not met | 0 / 5 | SAST tool is not run on all commits -- score normalized to 0 |
| Security-Policy | not met | 0 / 5 | security policy file not detected |
| Signed-Releases | partial | 6 / 7.5 | 5 out of the last 5 releases have a total of 5 signed artifacts. |
| Token-Permissions | not met | 0 / 7.5 | detected GitHub workflow tokens with excessive permissions |
| Vulnerabilities | not met | 0 / 7.5 | 33 existing vulnerabilities detected |

### High-Risk Jurisdiction Exposure — 100/100 (Exceptional)

Only high-confidence self-published location evidence affects this multiplier. Ambiguous matches are review-only; country evidence is not proof of nationality, citizenship, legal registration, malicious intent, or sanctions status.

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Policy exposure multiplier | met | 100 / 100 | no confirmed policy-scope location match |

## AI Readiness — 89/100 (Excellent)

How well is the repo equipped to be developed and maintained with AI coding agents? Carries a deliberately small weight: agent tooling is a real maintenance signal, but its absence must never gate the top of the scale (calibration saturates at raw 91, so 100/100 remains reachable with AI Readiness at zero).

### Agent context & guidance — 100/100 (Exceptional)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Agent instructions | met | 45 / 45 | AGENTS.md, CLAUDE.md, arkrpc/AGENTS.md, arkrpc/CLAUDE.md, arkrpc/treeconv/AGENTS.md, arkrpc/treeconv/CLAUDE.md, baselib/AGENTS.md, baselib/CLAUDE.md, baselib/actor/AGENTS.md, baselib/actor/CLAUDE.md, baselib/example/AGENTS.md, baselib/example/CLAUDE.md, baselib/protofsm/AGENTS.md, baselib/protofsm/CLAUDE.md, btcwbackend/AGENTS.md, btcwbackend/CLAUDE.md, build/AGENTS.md, build/CLAUDE.md, chain/AGENTS.md, chain/CLAUDE.md, chainbackends/AGENTS.md, chainbackends/CLAUDE.md, chainbackends/bitcoindrpc/AGENTS.md, chainbackends/bitcoindrpc/CLAUDE.md, chainbackends/lndsubmitter/AGENTS.md, chainbackends/lndsubmitter/CLAUDE.md, chainfees/AGENTS.md, chainfees/CLAUDE.md, chainsource/AGENTS.md, chainsource/CLAUDE.md, cmd/AGENTS.md, cmd/CLAUDE.md, cmd/merge-sql-schemas/AGENTS.md, cmd/merge-sql-schemas/CLAUDE.md, cmd/protoc-gen-mailboxrpc/AGENTS.md, cmd/protoc-gen-mailboxrpc/CLAUDE.md, cmd/protoc-gen-mailboxrpc/internal/gen/AGENTS.md, cmd/protoc-gen-mailboxrpc/internal/gen/CLAUDE.md, cmd/wavecli/AGENTS.md, cmd/wavecli/CLAUDE.md, cmd/wavecli/internal/gen-devrpc/AGENTS.md, cmd/wavecli/internal/gen-devrpc/CLAUDE.md, cmd/wavecli/waveclicommands/AGENTS.md, cmd/wavecli/waveclicommands/CLAUDE.md, cmd/wavecli/waveclicommands/devrpc/AGENTS.md, cmd/wavecli/waveclicommands/devrpc/CLAUDE.md, cmd/waved/AGENTS.md, cmd/waved/CLAUDE.md, cmd/wavewalletdk-wasm/AGENTS.md, cmd/wavewalletdk-wasm/CLAUDE.md, coinselect/AGENTS.md, coinselect/CLAUDE.md, credit/AGENTS.md, credit/CLAUDE.md, db/AGENTS.md, db/CLAUDE.md, db/actordelivery/AGENTS.md, db/actordelivery/CLAUDE.md, db/actordelivery/migrations/AGENTS.md, db/actordelivery/migrations/CLAUDE.md, db/actordelivery/sqlc/AGENTS.md, db/actordelivery/sqlc/CLAUDE.md, db/migrate/AGENTS.md, db/migrate/CLAUDE.md, db/sqlc/AGENTS.md, db/sqlc/CLAUDE.md, fraud/AGENTS.md, fraud/CLAUDE.md, gateway/AGENTS.md, gateway/CLAUDE.md, harness/AGENTS.md, harness/CLAUDE.md, indexer/AGENTS.md, indexer/CLAUDE.md, internal/AGENTS.md, internal/CLAUDE.md, internal/actortest/AGENTS.md, internal/actortest/CLAUDE.md, internal/cmd/tools/accounting/AGENTS.md, internal/cmd/tools/accounting/CLAUDE.md, internal/indexerlimits/AGENTS.md, internal/indexerlimits/CLAUDE.md, internal/sqlbase/AGENTS.md, internal/sqlbase/CLAUDE.md, internal/testutils/AGENTS.md, internal/testutils/CLAUDE.md, internal/wasmhost/AGENTS.md, internal/wasmhost/CLAUDE.md, ledger/AGENTS.md, ledger/CLAUDE.md, lib/AGENTS.md, lib/CLAUDE.md, lib/actormsg/AGENTS.md, lib/actormsg/CLAUDE.md, lib/arkscript/AGENTS.md, lib/arkscript/CLAUDE.md, lib/bip322/AGENTS.md, lib/bip322/CLAUDE.md, lib/recovery/AGENTS.md, lib/recovery/CLAUDE.md, lib/scripts/AGENTS.md, lib/scripts/CLAUDE.md, lib/tree/AGENTS.md, lib/tree/CLAUDE.md, lib/tx/AGENTS.md, lib/tx/CLAUDE.md, lib/tx/arktx/AGENTS.md, lib/tx/arktx/CLAUDE.md, lib/tx/checkpoint/AGENTS.md, lib/tx/checkpoint/CLAUDE.md, lib/tx/oor/AGENTS.md, lib/tx/oor/CLAUDE.md, lib/tx/psbtutil/AGENTS.md, lib/tx/psbtutil/CLAUDE.md, lib/types/AGENTS.md, lib/types/CLAUDE.md, lndbackend/AGENTS.md, lndbackend/CLAUDE.md, lwwallet/AGENTS.md, lwwallet/CLAUDE.md, mailbox/AGENTS.md, mailbox/CLAUDE.md, mailbox/conn/AGENTS.md, mailbox/conn/CLAUDE.md, mailbox/pb/AGENTS.md, mailbox/pb/CLAUDE.md, mailbox/rpc/AGENTS.md, mailbox/rpc/CLAUDE.md, metrics/AGENTS.md, metrics/CLAUDE.md, oor/AGENTS.md, oor/CLAUDE.md, p-models/AGENTS.md, p-models/CLAUDE.md, p-models/durableactor/AGENTS.md, p-models/durableactor/CLAUDE.md, p-models/durableactor/bridge/AGENTS.md, p-models/durableactor/bridge/CLAUDE.md, proofkeys/AGENTS.md, proofkeys/CLAUDE.md, round/AGENTS.md, round/CLAUDE.md, rpc/AGENTS.md, rpc/CLAUDE.md, rpc/oorpb/AGENTS.md, rpc/oorpb/CLAUDE.md, rpc/restclient/AGENTS.md, rpc/restclient/CLAUDE.md, rpc/roundpb/AGENTS.md, rpc/roundpb/CLAUDE.md, rpc/swapclientrpc/AGENTS.md, rpc/swapclientrpc/CLAUDE.md, rpc/wavewalletrpc/AGENTS.md, rpc/wavewalletrpc/CLAUDE.md, rpcauth/AGENTS.md, rpcauth/CLAUDE.md, rules/AGENTS.md, rules/CLAUDE.md, scripts/AGENTS.md, scripts/CLAUDE.md, scripts/check-sample-waved-conf/AGENTS.md, scripts/check-sample-waved-conf/CLAUDE.md, scripts/verify-schema-registry/AGENTS.md, scripts/verify-schema-registry/CLAUDE.md, sdk/ark/AGENTS.md, sdk/ark/CLAUDE.md, sdk/swaps/AGENTS.md, sdk/swaps/CLAUDE.md, sdk/swaps/sqlc/AGENTS.md, sdk/swaps/sqlc/CLAUDE.md, sdk/wavewalletdk/AGENTS.md, sdk/wavewalletdk/CLAUDE.md, sdk/wavewalletdk/mobile/AGENTS.md, sdk/wavewalletdk/mobile/CLAUDE.md, serverconn/AGENTS.md, serverconn/CLAUDE.md, serverconn/hellotestpb/AGENTS.md, serverconn/hellotestpb/CLAUDE.md, serverconn/mailboxpull/AGENTS.md, serverconn/mailboxpull/CLAUDE.md, swapclientserver/AGENTS.md, swapclientserver/CLAUDE.md, swaprpc/AGENTS.md, swaprpc/CLAUDE.md, swapwallet/AGENTS.md, swapwallet/CLAUDE.md, systest/AGENTS.md, systest/CLAUDE.md, timeout/AGENTS.md, timeout/CLAUDE.md, tools/AGENTS.md, tools/CLAUDE.md, txconfirm/AGENTS.md, txconfirm/CLAUDE.md, unroll/AGENTS.md, unroll/CLAUDE.md, unrollplan/AGENTS.md, unrollplan/CLAUDE.md, vhtlcrecovery/AGENTS.md, vhtlcrecovery/CLAUDE.md, vhtlcrecovery/coordinator/AGENTS.md, vhtlcrecovery/coordinator/CLAUDE.md, vhtlcrecovery/unrollpolicy/AGENTS.md, vhtlcrecovery/unrollpolicy/CLAUDE.md, vtxo/AGENTS.md, vtxo/CLAUDE.md, wallet/AGENTS.md, wallet/CLAUDE.md, walletcore/AGENTS.md, walletcore/CLAUDE.md, waved/AGENTS.md, waved/CLAUDE.md, waverpc/AGENTS.md, waverpc/CLAUDE.md |
| Machine-readable docs (llms.txt) | met | 15 / 15 | llms.txt served by the project website (https://wavelength.lightning.engineering/llms.txt) |
| Legible commit history | met | 40 / 40 | 100 of 100 human commits state their intent (structured subject or explanatory body) |

### Verify loop (build / test / typecheck) — 74/100 (Good)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| One-command bootstrap | met | 18 / 18 | Makefile |
| Automated tests | met | 22 / 22 | — |
| Lint / format config | met | 11 / 11 | .golangci.yml |
| Static type checking | met | 11 / 11 | Go (statically typed) |
| Reproducible environment | met | 10 / 10 | Dockerfile, lockfile |
| Demonstrated agent practice | not met | 0 / 10 | no agent-authored commits among the last 100 |
| Automated maintenance | not met | 0 / 8 | no automated dependency updates observed |
| OpenSSF Scorecard: Pinned-Dependencies | partial | 2 / 10 | dependency not pinned by hash detected -- score normalized to 2 |

### Code legibility for models — 98/100 (Exceptional)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Type-checkable code | met | 45 / 45 | Go (statically typed) |
| Manageable file sizes | partial | 53 / 55 | 49/1340 source files over 60KB |

### Machine-readable interfaces — 100/100 (Exceptional)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| API schema (OpenAPI/GraphQL/proto) | met | 40 / 40 | arkrpc/ark.proto, arkrpc/indexer.proto, mailbox/pb/mailbox.proto, rpc/oorpb/oorwire.proto, rpc/roundpb/round.proto, rpc/swapclientrpc/swap_client.proto, rpc/wavewalletrpc/wallet.proto, serverconn/testdata/hello.proto, swaprpc/swap.proto, waverpc/daemon.proto |
| MCP server | met | 20 / 20 | — |
| Runnable examples | met | 40 / 40 | example |

## Collection warnings

- Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token
- GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository

## What this report is

inspect.software measures public repositories against a single published, versioned methodology and reports the result as a 1–100 health index. Findings are signals derived from what is visible in public repository data — they are not a security audit, a warranty, or an endorsement, and no result depends on payment.

- Methodology, formulas and weights: https://inspect.software/methodology.md
- What a result does and does not claim: https://inspect.software/wiki/signals-not-warranties.md
- Rating bands: https://inspect.software/wiki/scoring-bands.md
- Corrections: https://inspect.software/contact.md
- Index of all documents: https://inspect.software/llms.txt