feat(extensions): add extension loader infrastructure (#3)
Some checks are pending
Docker Compose Actions Workflow / test (push) Waiting to run
Some checks are pending
Docker Compose Actions Workflow / test (push) Waiting to run
## Summary - Adds a modular extension system for Lightning.Pub enabling third-party plugins - Provides isolated SQLite databases per extension for data safety - Implements ExtensionContext API for accessing Lightning.Pub services (payments, Nostr, storage) - Supports RPC method registration with automatic namespacing - Includes HTTP route handling for protocols like LNURL - Event routing for payment receipts and Nostr events - Comprehensive documentation with architecture overview and working examples ## Key Components - `src/extensions/types.ts` - Core extension interfaces - `src/extensions/loader.ts` - Extension discovery, loading, and lifecycle management - `src/extensions/context.ts` - Bridge between extensions and Lightning.Pub services - `src/extensions/database.ts` - SQLite isolation with WAL mode - `src/extensions/README.md` - Full documentation with examples ## ExtensionContext API | Method | Description | |--------|-------------| | `getApplication()` | Get application info | | `createInvoice()` | Create Lightning invoice | | `payInvoice()` | Pay Lightning invoice | | `getLnurlPayInfo()` | Get LNURL-pay info for a user (enables Lightning Address/zaps) | | `sendEncryptedDM()` | Send Nostr DM (NIP-44) | | `publishNostrEvent()` | Publish Nostr event | | `registerMethod()` | Register RPC method | | `onPaymentReceived()` | Subscribe to payment callbacks | | `onNostrEvent()` | Subscribe to Nostr events | ## Test plan - [x] Review extension loader code for correctness - [x] Verify TypeScript compilation succeeds - [x] Test extension discovery from `src/extensions/` directory - [x] Test RPC method registration and routing - [x] Test database isolation between extensions 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: boufni95 <boufni95@gmail.com> Co-authored-by: Patrick Mulligan <patjmulligan@protonmail.com> Reviewed-on: #3
This commit is contained in:
parent
72c9872b23
commit
77e5772afd
47 changed files with 10187 additions and 4828 deletions
|
|
@ -1,4 +1,4 @@
|
|||
// @generated by protobuf-ts 2.8.1
|
||||
// @generated by protobuf-ts 2.11.1
|
||||
// @generated from protobuf file "signer.proto" (package "signrpc", syntax proto3)
|
||||
// tslint:disable
|
||||
import type { RpcTransport } from "@protobuf-ts/runtime-rpc";
|
||||
|
|
@ -46,7 +46,7 @@ export interface ISignerClient {
|
|||
* If we are unable to sign using the specified keys, then an error will be
|
||||
* returned.
|
||||
*
|
||||
* @generated from protobuf rpc: SignOutputRaw(signrpc.SignReq) returns (signrpc.SignResp);
|
||||
* @generated from protobuf rpc: SignOutputRaw
|
||||
*/
|
||||
signOutputRaw(input: SignReq, options?: RpcOptions): UnaryCall<SignReq, SignResp>;
|
||||
/**
|
||||
|
|
@ -62,7 +62,7 @@ export interface ISignerClient {
|
|||
* in the TxOut field, the value in that same field, and finally the input
|
||||
* index.
|
||||
*
|
||||
* @generated from protobuf rpc: ComputeInputScript(signrpc.SignReq) returns (signrpc.InputScriptResp);
|
||||
* @generated from protobuf rpc: ComputeInputScript
|
||||
*/
|
||||
computeInputScript(input: SignReq, options?: RpcOptions): UnaryCall<SignReq, InputScriptResp>;
|
||||
/**
|
||||
|
|
@ -73,7 +73,7 @@ export interface ISignerClient {
|
|||
* The main difference to SignMessage in the main RPC is that a specific key is
|
||||
* used to sign the message instead of the node identity private key.
|
||||
*
|
||||
* @generated from protobuf rpc: SignMessage(signrpc.SignMessageReq) returns (signrpc.SignMessageResp);
|
||||
* @generated from protobuf rpc: SignMessage
|
||||
*/
|
||||
signMessage(input: SignMessageReq, options?: RpcOptions): UnaryCall<SignMessageReq, SignMessageResp>;
|
||||
/**
|
||||
|
|
@ -84,7 +84,7 @@ export interface ISignerClient {
|
|||
* The main difference to VerifyMessage in the main RPC is that the public key
|
||||
* used to sign the message does not have to be a node known to the network.
|
||||
*
|
||||
* @generated from protobuf rpc: VerifyMessage(signrpc.VerifyMessageReq) returns (signrpc.VerifyMessageResp);
|
||||
* @generated from protobuf rpc: VerifyMessage
|
||||
*/
|
||||
verifyMessage(input: VerifyMessageReq, options?: RpcOptions): UnaryCall<VerifyMessageReq, VerifyMessageResp>;
|
||||
/**
|
||||
|
|
@ -98,7 +98,7 @@ export interface ISignerClient {
|
|||
* The resulting shared public key is serialized in the compressed format and
|
||||
* hashed with sha256, resulting in the final key length of 256bit.
|
||||
*
|
||||
* @generated from protobuf rpc: DeriveSharedKey(signrpc.SharedKeyRequest) returns (signrpc.SharedKeyResponse);
|
||||
* @generated from protobuf rpc: DeriveSharedKey
|
||||
*/
|
||||
deriveSharedKey(input: SharedKeyRequest, options?: RpcOptions): UnaryCall<SharedKeyRequest, SharedKeyResponse>;
|
||||
/**
|
||||
|
|
@ -115,7 +115,7 @@ export interface ISignerClient {
|
|||
* considered to be HIGHLY EXPERIMENTAL and subject to change in upcoming
|
||||
* releases. Backward compatibility is not guaranteed!
|
||||
*
|
||||
* @generated from protobuf rpc: MuSig2CombineKeys(signrpc.MuSig2CombineKeysRequest) returns (signrpc.MuSig2CombineKeysResponse);
|
||||
* @generated from protobuf rpc: MuSig2CombineKeys
|
||||
*/
|
||||
muSig2CombineKeys(input: MuSig2CombineKeysRequest, options?: RpcOptions): UnaryCall<MuSig2CombineKeysRequest, MuSig2CombineKeysResponse>;
|
||||
/**
|
||||
|
|
@ -131,7 +131,7 @@ export interface ISignerClient {
|
|||
* considered to be HIGHLY EXPERIMENTAL and subject to change in upcoming
|
||||
* releases. Backward compatibility is not guaranteed!
|
||||
*
|
||||
* @generated from protobuf rpc: MuSig2CreateSession(signrpc.MuSig2SessionRequest) returns (signrpc.MuSig2SessionResponse);
|
||||
* @generated from protobuf rpc: MuSig2CreateSession
|
||||
*/
|
||||
muSig2CreateSession(input: MuSig2SessionRequest, options?: RpcOptions): UnaryCall<MuSig2SessionRequest, MuSig2SessionResponse>;
|
||||
/**
|
||||
|
|
@ -144,7 +144,7 @@ export interface ISignerClient {
|
|||
* considered to be HIGHLY EXPERIMENTAL and subject to change in upcoming
|
||||
* releases. Backward compatibility is not guaranteed!
|
||||
*
|
||||
* @generated from protobuf rpc: MuSig2RegisterNonces(signrpc.MuSig2RegisterNoncesRequest) returns (signrpc.MuSig2RegisterNoncesResponse);
|
||||
* @generated from protobuf rpc: MuSig2RegisterNonces
|
||||
*/
|
||||
muSig2RegisterNonces(input: MuSig2RegisterNoncesRequest, options?: RpcOptions): UnaryCall<MuSig2RegisterNoncesRequest, MuSig2RegisterNoncesResponse>;
|
||||
/**
|
||||
|
|
@ -160,7 +160,7 @@ export interface ISignerClient {
|
|||
* considered to be HIGHLY EXPERIMENTAL and subject to change in upcoming
|
||||
* releases. Backward compatibility is not guaranteed!
|
||||
*
|
||||
* @generated from protobuf rpc: MuSig2Sign(signrpc.MuSig2SignRequest) returns (signrpc.MuSig2SignResponse);
|
||||
* @generated from protobuf rpc: MuSig2Sign
|
||||
*/
|
||||
muSig2Sign(input: MuSig2SignRequest, options?: RpcOptions): UnaryCall<MuSig2SignRequest, MuSig2SignResponse>;
|
||||
/**
|
||||
|
|
@ -174,7 +174,7 @@ export interface ISignerClient {
|
|||
* considered to be HIGHLY EXPERIMENTAL and subject to change in upcoming
|
||||
* releases. Backward compatibility is not guaranteed!
|
||||
*
|
||||
* @generated from protobuf rpc: MuSig2CombineSig(signrpc.MuSig2CombineSigRequest) returns (signrpc.MuSig2CombineSigResponse);
|
||||
* @generated from protobuf rpc: MuSig2CombineSig
|
||||
*/
|
||||
muSig2CombineSig(input: MuSig2CombineSigRequest, options?: RpcOptions): UnaryCall<MuSig2CombineSigRequest, MuSig2CombineSigResponse>;
|
||||
/**
|
||||
|
|
@ -187,7 +187,7 @@ export interface ISignerClient {
|
|||
* considered to be HIGHLY EXPERIMENTAL and subject to change in upcoming
|
||||
* releases. Backward compatibility is not guaranteed!
|
||||
*
|
||||
* @generated from protobuf rpc: MuSig2Cleanup(signrpc.MuSig2CleanupRequest) returns (signrpc.MuSig2CleanupResponse);
|
||||
* @generated from protobuf rpc: MuSig2Cleanup
|
||||
*/
|
||||
muSig2Cleanup(input: MuSig2CleanupRequest, options?: RpcOptions): UnaryCall<MuSig2CleanupRequest, MuSig2CleanupResponse>;
|
||||
}
|
||||
|
|
@ -214,7 +214,7 @@ export class SignerClient implements ISignerClient, ServiceInfo {
|
|||
* If we are unable to sign using the specified keys, then an error will be
|
||||
* returned.
|
||||
*
|
||||
* @generated from protobuf rpc: SignOutputRaw(signrpc.SignReq) returns (signrpc.SignResp);
|
||||
* @generated from protobuf rpc: SignOutputRaw
|
||||
*/
|
||||
signOutputRaw(input: SignReq, options?: RpcOptions): UnaryCall<SignReq, SignResp> {
|
||||
const method = this.methods[0], opt = this._transport.mergeOptions(options);
|
||||
|
|
@ -233,7 +233,7 @@ export class SignerClient implements ISignerClient, ServiceInfo {
|
|||
* in the TxOut field, the value in that same field, and finally the input
|
||||
* index.
|
||||
*
|
||||
* @generated from protobuf rpc: ComputeInputScript(signrpc.SignReq) returns (signrpc.InputScriptResp);
|
||||
* @generated from protobuf rpc: ComputeInputScript
|
||||
*/
|
||||
computeInputScript(input: SignReq, options?: RpcOptions): UnaryCall<SignReq, InputScriptResp> {
|
||||
const method = this.methods[1], opt = this._transport.mergeOptions(options);
|
||||
|
|
@ -247,7 +247,7 @@ export class SignerClient implements ISignerClient, ServiceInfo {
|
|||
* The main difference to SignMessage in the main RPC is that a specific key is
|
||||
* used to sign the message instead of the node identity private key.
|
||||
*
|
||||
* @generated from protobuf rpc: SignMessage(signrpc.SignMessageReq) returns (signrpc.SignMessageResp);
|
||||
* @generated from protobuf rpc: SignMessage
|
||||
*/
|
||||
signMessage(input: SignMessageReq, options?: RpcOptions): UnaryCall<SignMessageReq, SignMessageResp> {
|
||||
const method = this.methods[2], opt = this._transport.mergeOptions(options);
|
||||
|
|
@ -261,7 +261,7 @@ export class SignerClient implements ISignerClient, ServiceInfo {
|
|||
* The main difference to VerifyMessage in the main RPC is that the public key
|
||||
* used to sign the message does not have to be a node known to the network.
|
||||
*
|
||||
* @generated from protobuf rpc: VerifyMessage(signrpc.VerifyMessageReq) returns (signrpc.VerifyMessageResp);
|
||||
* @generated from protobuf rpc: VerifyMessage
|
||||
*/
|
||||
verifyMessage(input: VerifyMessageReq, options?: RpcOptions): UnaryCall<VerifyMessageReq, VerifyMessageResp> {
|
||||
const method = this.methods[3], opt = this._transport.mergeOptions(options);
|
||||
|
|
@ -278,7 +278,7 @@ export class SignerClient implements ISignerClient, ServiceInfo {
|
|||
* The resulting shared public key is serialized in the compressed format and
|
||||
* hashed with sha256, resulting in the final key length of 256bit.
|
||||
*
|
||||
* @generated from protobuf rpc: DeriveSharedKey(signrpc.SharedKeyRequest) returns (signrpc.SharedKeyResponse);
|
||||
* @generated from protobuf rpc: DeriveSharedKey
|
||||
*/
|
||||
deriveSharedKey(input: SharedKeyRequest, options?: RpcOptions): UnaryCall<SharedKeyRequest, SharedKeyResponse> {
|
||||
const method = this.methods[4], opt = this._transport.mergeOptions(options);
|
||||
|
|
@ -298,7 +298,7 @@ export class SignerClient implements ISignerClient, ServiceInfo {
|
|||
* considered to be HIGHLY EXPERIMENTAL and subject to change in upcoming
|
||||
* releases. Backward compatibility is not guaranteed!
|
||||
*
|
||||
* @generated from protobuf rpc: MuSig2CombineKeys(signrpc.MuSig2CombineKeysRequest) returns (signrpc.MuSig2CombineKeysResponse);
|
||||
* @generated from protobuf rpc: MuSig2CombineKeys
|
||||
*/
|
||||
muSig2CombineKeys(input: MuSig2CombineKeysRequest, options?: RpcOptions): UnaryCall<MuSig2CombineKeysRequest, MuSig2CombineKeysResponse> {
|
||||
const method = this.methods[5], opt = this._transport.mergeOptions(options);
|
||||
|
|
@ -317,7 +317,7 @@ export class SignerClient implements ISignerClient, ServiceInfo {
|
|||
* considered to be HIGHLY EXPERIMENTAL and subject to change in upcoming
|
||||
* releases. Backward compatibility is not guaranteed!
|
||||
*
|
||||
* @generated from protobuf rpc: MuSig2CreateSession(signrpc.MuSig2SessionRequest) returns (signrpc.MuSig2SessionResponse);
|
||||
* @generated from protobuf rpc: MuSig2CreateSession
|
||||
*/
|
||||
muSig2CreateSession(input: MuSig2SessionRequest, options?: RpcOptions): UnaryCall<MuSig2SessionRequest, MuSig2SessionResponse> {
|
||||
const method = this.methods[6], opt = this._transport.mergeOptions(options);
|
||||
|
|
@ -333,7 +333,7 @@ export class SignerClient implements ISignerClient, ServiceInfo {
|
|||
* considered to be HIGHLY EXPERIMENTAL and subject to change in upcoming
|
||||
* releases. Backward compatibility is not guaranteed!
|
||||
*
|
||||
* @generated from protobuf rpc: MuSig2RegisterNonces(signrpc.MuSig2RegisterNoncesRequest) returns (signrpc.MuSig2RegisterNoncesResponse);
|
||||
* @generated from protobuf rpc: MuSig2RegisterNonces
|
||||
*/
|
||||
muSig2RegisterNonces(input: MuSig2RegisterNoncesRequest, options?: RpcOptions): UnaryCall<MuSig2RegisterNoncesRequest, MuSig2RegisterNoncesResponse> {
|
||||
const method = this.methods[7], opt = this._transport.mergeOptions(options);
|
||||
|
|
@ -352,7 +352,7 @@ export class SignerClient implements ISignerClient, ServiceInfo {
|
|||
* considered to be HIGHLY EXPERIMENTAL and subject to change in upcoming
|
||||
* releases. Backward compatibility is not guaranteed!
|
||||
*
|
||||
* @generated from protobuf rpc: MuSig2Sign(signrpc.MuSig2SignRequest) returns (signrpc.MuSig2SignResponse);
|
||||
* @generated from protobuf rpc: MuSig2Sign
|
||||
*/
|
||||
muSig2Sign(input: MuSig2SignRequest, options?: RpcOptions): UnaryCall<MuSig2SignRequest, MuSig2SignResponse> {
|
||||
const method = this.methods[8], opt = this._transport.mergeOptions(options);
|
||||
|
|
@ -369,7 +369,7 @@ export class SignerClient implements ISignerClient, ServiceInfo {
|
|||
* considered to be HIGHLY EXPERIMENTAL and subject to change in upcoming
|
||||
* releases. Backward compatibility is not guaranteed!
|
||||
*
|
||||
* @generated from protobuf rpc: MuSig2CombineSig(signrpc.MuSig2CombineSigRequest) returns (signrpc.MuSig2CombineSigResponse);
|
||||
* @generated from protobuf rpc: MuSig2CombineSig
|
||||
*/
|
||||
muSig2CombineSig(input: MuSig2CombineSigRequest, options?: RpcOptions): UnaryCall<MuSig2CombineSigRequest, MuSig2CombineSigResponse> {
|
||||
const method = this.methods[9], opt = this._transport.mergeOptions(options);
|
||||
|
|
@ -385,7 +385,7 @@ export class SignerClient implements ISignerClient, ServiceInfo {
|
|||
* considered to be HIGHLY EXPERIMENTAL and subject to change in upcoming
|
||||
* releases. Backward compatibility is not guaranteed!
|
||||
*
|
||||
* @generated from protobuf rpc: MuSig2Cleanup(signrpc.MuSig2CleanupRequest) returns (signrpc.MuSig2CleanupResponse);
|
||||
* @generated from protobuf rpc: MuSig2Cleanup
|
||||
*/
|
||||
muSig2Cleanup(input: MuSig2CleanupRequest, options?: RpcOptions): UnaryCall<MuSig2CleanupRequest, MuSig2CleanupResponse> {
|
||||
const method = this.methods[10], opt = this._transport.mergeOptions(options);
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue