LNURL

LNURL은 결제용 payRequest, 인출용 withdrawRequest, 인증용 login과 추가 확장을 포함합니다. 지갑마다 지원하는 LUD가 다릅니다. “LNURL 지원”은 모든 작업이 되거나 승인의 효과가 같다는 뜻이 아닙니다. [LNURL — LUD index] [Lightning Labs — LNURL glossary]

LUD-01의 기본 LNURL은 HTTPS나 onion URL을 Bech32로 인코딩합니다. 암호화도 BOLT 11 청구서도 아닙니다. URL 또는 GET 뒤 JSON 응답의 tag가 종류를 정합니다. 지갑은 도메인과 작업을 식별해야 하며 QR 외관만으로 수취인을 확인하지 못합니다. [LNURL — LUD-01 encoding]

payRequest는 callback, minSendable, maxSendable, metadata를 반환합니다. 한도와 선택한 amount는 msat 단위이며 1000 msat는 1 satoshi입니다. 조건 승인 뒤 지갑은 pr의 청구서를 요청하고 결제 전에 금액을 확인합니다. 고정 링크 자체는 결제 증거가 아닙니다. [LNURL — LUD-06 payRequest]

Metadata는 JSON 배열을 담은 문자열로 text/plain 항목이 필수이고 다른 유형은 선택입니다. 설명은 도메인, 금액과 함께 읽어야 합니다. 기본 LNURL은 HTTP 코드만이 아닌 JSON 본문을 해석합니다. ERROR 또는 pr 청구서 수신을 결제 성공으로 혼동하면 안 됩니다. [LNURL — LUD-01 encoding] [LNURL — LUD-06 payRequest]

withdrawRequest는 k1, callback과 msat 단위 minWithdrawable/maxWithdrawable을 반환합니다. 자신의 지갑이 수신 청구서를 만들어 지급할 서비스에 pr로 보냅니다. Status OK는 요청 접수이며 지갑은 실제 수신을 기다립니다. 인출 링크는 권한을 담을 수 있으므로 공개 결제 연락처처럼 취급하지 마세요. [LNURL — LUD-03 withdrawRequest]

tag login의 LNURL-auth는 k1과 도메인별 linkingKey를 사용합니다. 동의 뒤 지갑은 secp256k1 기반 ECDSA로 서명하며 서비스에 seed를 보내지 않습니다. Action은 등록, 로그인, 연결이나 다른 허가일 수 있습니다. 서명은 bitcoin 결제나 자동적인 사람의 신원 증명이 아닙니다. [LNURL — LUD-04 authentication]

HTTPS는 전송을 보호하지만 서비스는 요청과 시각을 알 수 있습니다. 반복 사용은 연결될 수 있습니다. Auth는 전체 도메인에서 키를 파생하므로 하위 도메인을 바꾸면 linkingKey가 바뀌어 다른 계정이 될 수 있습니다. 파생 방식이 달라 지갑 사이 로그인 이전은 보장되지 않습니다. LNURL은 bitcoin 보관 방식을 정하지 않습니다. [LNURL — LUD-01 encoding] [LNURL — LUD-04 authentication]

선택적 LUD-21은 verify URL을 추가합니다. 응답은 settled true/false를 구분하고 preimage를 줄 수 있습니다. Status OK만으로 settled true가 되지 않습니다. 해당 청구서 연결과 지갑 상태를 확인하세요. 응답을 잃어도 무작정 다시 결제하지 말고 가용성, 수신 유동성과 동의 범위를 별도로 확인하세요. [LNURL — LUD index] [LNURL — LUD-21 verification]