search

interledger-deprecated / tutorials

Interledger tutorials
17 stars 9 forks source link

Create logical progression from Letter Shop to http-ilp tutorial #23

Closed michielbdejong closed 6 years ago

michielbdejong commented 6 years ago

By making the Letter Shop Bonus a 'client' script instead of a proxy, it fits better before the http-ilp, streaming-payments, and trustlines tutorials, which all follow that same setup (shop + client).

In the Letter Shop, the client script is first introduced as a script that parses the html page, to make it clearly felt by the reader that a machine-readable Pay header is useful. It then introduces the very simple 'interledger-condition' payment method.

The http-ilp tutorial then first stays with the approach of showing what's going on, explaining how interledger-psk is better for repeated use, and how we can add a prepaid balance.

Then it replaces exploits the fact that we're now within the http-ilp standard, to replace the client script with ilp-curl, a handy debug tool which manages your plugin credentials.

And the last step is to show how the Letter Shop could be written within a webserver middleware framework like koa.

adrianhopebailie commented 6 years ago

Is there a plan somewhere that shows these progressions?

If not then I suggest we put that down somewhere before ad-hoc changes are made to the tutorials that might have to be reverted if other tutorials change.

michielbdejong commented 6 years ago

The documentation of the plan, as far as I am aware, consists mainly of https://github.com/interledger/tutorials/pull/23#issue-271272101 and also https://github.com/interledger/tutorials/pull/5#issuecomment-341437691.

Are there plans for other tutorials to change? If so, you're right, would be good to keep that coordinated in one single plan.

michielbdejong commented 6 years ago

I split out the part that affects the Letter Shop Bonus Step, to better coordinate this work with @adrianhopebailie's work. That part is now in #25.

michielbdejong commented 6 years ago

Making progress with the shop2/client2 that uses client-generated shared secret and Pay-Token/Pay-Balance functionality. Once I have that working, will write shop3/client3 which are already referenced in the text, and that contain the latest tweaks to become compatible with ilp-curl (using two shared secrets, deriving clientId from those, and moving clientId into psk data).

adrianhopebailie commented 6 years ago

LGTM