> ## Documentation Index
> Fetch the complete documentation index at: https://candy-208aed2d-85.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Spec ja

# go-lcpd 実装仕様（日本語概要）

このページは `go-lcpd/spec.md` の日本語概要です。
正規（normative）な実装仕様は英語版の `go-lcpd/spec.md` を参照してください（このリポジトリでは英語版が SSOT です）。

## これは何？

`go-lcpd` は LCP（Lightning Compute Protocol）の参照実装（daemon）です。
Lightning の BOLT #1 カスタムメッセージを `lnd` のピア接続上でやり取りし、Requester 側のフロー（quote → pay → result）をローカル gRPC API で操作できるようにします。

## 主要ポイント（抜粋）

* 単一の真実（SSOT）:
  * gRPC API: `go-lcpd/proto/lcpd/v1/lcpd.proto`
  * wire protocol: `protocol/protocol.md`（LCP v0.1, `protocol_version=1`）
* transport:
  * 独自 TCP/UDP transport は実装しません（peer messaging は `lnd` に委譲）
* 互換性:
  * unknown odd message を無視、unknown even を切断（BOLT #1 parity）
  * unknown TLV は無視（forward compatibility）
* セキュリティ:
  * 支払い前に invoice の `description_hash == terms_hash` 等を検証
  * quote expiry / envelope expiry の制限と重複排除で replay/DoS を軽減
  * ログには生のプロンプト/出力や秘密情報（API key / macaroon / invoice 文字列など）を残さない
* テスト:
  * Lightning 統合テストは regtest を opt-in で実行（`go test ./...` に外部プロセスを要求しない）

## 参考

* go-lcpd 英語仕様（SSOT）: `go-lcpd/spec.md`
* LCP 英語 wire 仕様（SSOT）: `protocol/protocol.md`