joschisan/ln_module_ng.md

Last active April 17, 2024 16:56

Star (0) You must be signed in to star a gist
Fork (0) You must be signed in to fork a gist

Select an option

Learn more about clone URLs
Clone this repository at <script src="https://gist.github.com/joschisan/21e8faa5839ef372138fdbf80ffc64f9.js"></script>
Save joschisan/21e8faa5839ef372138fdbf80ffc64f9 to your computer and use it in GitHub Desktop.

Raw

SendStates

graph LR

Funding -- funding transaction is rejected --> Failure
Funding -- funding transaction is accepted --> Funded
Funded -- payment attempt expires --> Refunding
Funded -- gateway cancels payment attempt --> Refunding
Funded -- payment is confirmed  --> Success
Refunding -- payment is confirmed --> Success
Refunding -- ecash is minted --> Refunded
Refunding -- minting ecash fails --> Failure

ReceiveStates

graph LR

Pending -- payment is confirmed --> Claiming
Pending -- invoice expires --> Expired
Claiming -- ecash is minted --> Claimed
Claiming -- minting ecash fails --> Failure

m1sterc001guy commented Oct 31, 2023

Got it, I keep forgetting that either the client or the gateway can submit these transactions.

If that's the case, what is the use case for the gateway returning the preimage/forfeit signature back to the client? Couldn't it just construct/submit these transactions itself?

Author

joschisan commented Oct 31, 2023

it returns the preimage as a response to the post request so the payment can be shown to the user as settled as quickly as possible.
The forfeit signature is needed to proof to the federation that the gateway agrees to cancel the outgoing contract.