feat: Bitcoin Lightning Network plugin

[AbdelStark]

Relates to:

Risks

Low. It's an optional client to use.

Background

What does this PR do?

What kind of change is this?

Features (non-breaking change which adds functionality)

Why are we doing this? Any context or related work?

Nostr is the simplest open protocol that is able to create a censorship-resistant global "social" network once and for all.

It's nature and strong focus on censorship-resistance makes it a perfect fit for the Eliza agent framework.

Configuration

Here are the env variables that need to be set in the .env file:

Variable	Description	Example
BITCOIN_LNBITS_NODE_URL	The LNBits Node URL	wss://relay.damus.io,wss://relay.primal.net
BITCOIN_LNBITS_ADMIN_KEY	The LNBits Node admin key	...
BITCOIN_LNBITS_READ_KEY	The LNBits Node read key	...

Sample configuration:

# Bitcoin Lightning Network
## lnbits information
BITCOIN_LNBITS_NODE_URL="https://demo.lnbits.com"
BITCOIN_LNBITS_ADMIN_KEY="..."
BITCOIN_LNBITS_READ_KEY="..."

Pluging must be set in the Character definition, example:

{
    "name": "goku",
    "clients": ["direct"],
    "modelProvider": "anthropic",
     "plugins": ["@ai16z/plugin-bitcoin-lightning-network"]   
}

Changes summary

• Add env variables for Lightning Networl in .env.example.
• Implement Bitcoin lightning network plugin in Eliza (in packages/plugin-bitcoin-lightning-network).
  • Implement PayInvoice action
  • Implement LNBitsProvider for interactions with LNBits Node to process payments.

Documentation changes needed?

My changes do not require a change to the project documentation.

Testing

Where should a reviewer start?

Detailed testing steps

• As anon
    - run pnpm run dev --characters="characters/ln.character.json"
    - interact with agent to ask for payment of an invoice: "Pay this invoice lnbc1270n1pnktxjgpp5s3df3ksvh9g27x9t7m4n4g0r7hvcyrs5d3qt8lf6dt6xhrd2hr5sdqqcqzzsxqyz5vqsp503sljhzqeu8zpcwl8retv6v849yl3z2vkj5v47ah62mef8zktxsq9qxpqysgqlxrj3rwk3tjamezv543dmadn3up374c2g4529pjcld2ww7s25rzhrt7e2627tdq4r4rjwxchmp24gp327cfnc62hxe99gn2eps77eeqqapgzf6"

Screenshots

Discord username

abdel.stark