The Interledger Community 🌱: rubensworks

Incentivizing Decentralized Application Development within Solid through Web Monetization — Grant Report 2

rubensworks — Mon, 07 Feb 2022 08:06:17 +0000

This is the final report of our project to enable the monetization of Solid applications,
allowing Solid identities to be linked to Web Monetization wallets,
and incorporating payment processing into Solid’s authentication.

Learn more about our project here: https://github.com/KNowledgeOnWebScale/solid-web-monetization

Project Update

After our initial smooth progress on the application to assign payment pointers to a Solid WebID, we struggled a bit on the next part of the project. An initial scan of the Interledger technology stack gave the impression of a mature ecosystem, with ample library and documentation support. This lead us to believe that it would be straightforward to perform Interledger Protocol based STREAM payments, right from the user's browser to the target payment pointer of a content creator (present inside the HTML of his/her website). What we found however was that every library and example that we discovered had several issues that could always be described as one or more of the following:

Libraries were written for node but not browser compatible because of internal node-specific library dependencies.
Documentation was outdated (but not mentioned as being outdated).
No pointer or link to what the correct newer libraries to use were now (since redesigns in this space seemed to happen multiple times, making older libraries obsolete but still publicly available)
Little to no response on dedicated Slack channels
Missing formal abstraction to request executing payment from a wallet, based on the payment pointer. Since any wallet could host its own auhtentication method and API for doing so, and there is no formal discovery mechanism.

This led us to request for a 3 month (time) extension for the project.

We decided to take a deeper dive at how Coil works, since they are the only party that we know of who does Web Monetization in practice. That made us realise that even Coil doesn't execute ILP payments from a user's payment pointer to another user's payment pointer directly. Instead they offer a subscription-based service (via credit card payments) to users that can run Coil's browser extension. This extension can act like a local service (browser extensions are more priveleged than javascript executing in the browser), but as far as we known the extension also just contacts their servers to execute payments on behalf of the user, by making a payment from Coil's wallet (which holds the funds generated by the subscriptions) to the Wallets of the content creators.

This inspired us to refresh our view on this problem. It lead us to propose a Solid Web Monetization Provider specification for a component that works much like Coil's service. The key difference is that it is a Solid-based application, that stores personal data in the user's Solid Pod. The user is also free to pick any Solid Web Monetization Provider he/she wants (and thus trusts!) to subscribe to and perform Web Monetization in his/her behalf.

Once we made that change, the demonstrator and specification soon followed.

Progress on objectives

One of our three original objectives was to be able to configure a link between a user's Solid identity and his/her wallet. This was completed at the time of our first report. Nothing has really changed here, except that deployment of the Accountant application is no longer done on the GitHub pages. Instead we've opted for a Docker image build, so the whole demonstrator can be boostrapped by a single docker-compose.yml file.

A second objective was creating a prototype monetized Solid application. This objective has also been successfully completed in the form of the Microstore application. This application is also built as a docker image. The microstore app is an example application which has two use cases showing how locked/premium content can be unlocked once micropayments are started using web monetization.

A third and last objective was tying into the Solid authentication library to trigger a check for payment pointers in the user's Solid Identity. Since the only requirement for our scripts to work, is having access to the user's public Solid WebID document, a hard tie-in at this time was not needed. As a result, we've encapsulated the required code in a client library that works alongside the Web Monetization Provider implemenation, instead of extending the Solid authentication library directly.

In the future however it could be integrated in the Solid authentication process, which in turn could even be handled by the visiting user's browser agent by means of an extension. That would truly require nothing else than a <meta name="monetization" content="$my.pointer"> tag from the content creator to enable micropayments.

Key activities

Milestone 1: Application to configure a Web Monetization wallet into a Solid identity
- Task 1.1. Extension of WebID ontology to include link to Web Monetization Wallet
  
  [Status: Finished]
  
  We are of the opinion that Payment Pointers should have an extra indirection so that more properties can be attached to a single payment pointer. This would allow a user to (in the future):
  - Mark a payment pointer with a purpose/tag (eg. work, personal)
  - Mark a payment pointer as default (if there are multiples)
  - Use different types of Payment Pointers (right now we are working with an InterledgerPaymentPointer type)
  - Easily add any more propeties in the future if deemed necessary.
  Our solution initially required RDF BlankNodes to implement this. However blank nodes are still problematic when parsing and writing RDF, so we've opted to skolemize the blank nodes.
- Task 1.2. Application to configure a Web Monetization wallet into a Solid identity
  
  [Status: Finished]
  
  This started out as a React-Typescript project, because we wanted to reuse the @inrupt/solid-ui-react library. This library leans on top of the @inrupt/solid-client-authn-browser library. Since however the newest features of that underlaying library weren't available yet and we needed more fine grained control, the @inrupt/solid-ui-react library was dropped. Because the team is very familiar with angular applications, we then quickly rewrote the application as an angular application using that lower-level @inrupt/solid-client-authn-browser libary.
  
  When the user logs in, he/she can choose between 3 identity providers: inrupt.net, solidcomminity.net and a custom identity provider (url). The latter one can (among others) be used to refer to the Community Solid Server (CSS).
Milestone 2: Extension of the Solid authentication library with Web Monetization support
- Task 2.1. Analysis of Solid/WebID authentication protocol
[Status: Finished]

This task involves studying Solid OIDC, Solid OIDC Primer and DPoP tokens. This knowledge was used to implement the authentication flow for the Solid Web Monetization Provider application.
- Task 2.2. Analysis of Web Monetization protocol
[Status: Finished]

This task involves reading the Web Monetization Specification and theorizing about web monetization use cases in a Solid context.
- Task 2.3. Theoretical integration of WebID and Web Monetization protocols
[Status: Finished]

This task manifested itself in the design of the Solid Web Monetization Provider specification that we proposed.
- Task 2.4. Implementation of integrated protocol
[Status: Finished]

This task manifested itself in the proof of concept authentication implementation of the Solid Web Monetization Provider specification that we did in the form of the Solid Web Monetization Provider application.
Milestone 3: Prototypical Web Monetized Solid application
- Task 3.1. Implementation of prototypical Solid application
[Status: Finished]

This task required the implementation of a prototypical Solid application. The result of this task is the Microstore application. This application is an example of a Web Monetized Solid application: it has two subpages which represent a typical use case each (paywall and mixed content). Micropayments allow the visiting user to see the locked content.
- Task 3.2. Integration testing of Web Monetization in combination with Solid authentication
[Status: Finished]

This task has been reduced somewhat in the sense that manual tests using the prototype implementation of the Microstore application were the main point of focus. Besides, the actual authentiation steps in the client-side application (Microstore and Accountant) were handled by the @inrupt/solid-client-authn-browser library, which is already thoroughly tested.
- Milestone 4: Documentation and tutorials
- Task 4.1. Documentation for Solid users to configure a Web Monetization wallet
[Status: Finished]

For this task documentation was written and publicly hosted on the Github Pages.
- The practical docs are meant for users, explaining how to use the Accountant application.
- The technical docs are meant for developers, on how to implement an application like the Accountant application.
  - Task 4.2. Documentation for application developers to monetize their application
[Status: Finished]

For this task documentation was written and publicly hosted on the Github Pages.
- The practical docs are meant for users, explaining how to use the Microstore application.
- The technical docs are meant for developers, on how to implement an application like the Microstore application.
  - Milestone 5: Dissemination of the main results and findings of this project
  - Task 5.1. Presentation at Web-related conferences via publications and tutorials
[Status: Finished]

A demonstrator was built and a scenario was detailed to go through the demonstrator. A demonstration paper is in the making which will be presented at a conference in the near future.
- Task 5.2. Publishing prototype on the Web as a live demonstration
[Status: Finished]

The demonstrator is publicly available at the GitHub repository, documentation on how to get it running is hosted on the GitHub Pages. It can be installed locally by anyone using Docker Compose and the docker-compose.yml file. The setup is documented here.

The demonstrator will also be hosted online at (url coming soon).

Communications and marketing

We are collaborating with other initiatives that combine Web Monetization with Solid on https://github.com/solid/webmonetization.

What’s next?

The next steps would be hearing possible objections or suggestion to the Solid Web Monetization Provider specification proposal. If this specification is followed, it would allow us to hook into Solid authentication code (right after the authentication step is done). Which would make it possible to immediatly fetch the required information from the user's Solid WebID to perform micropayments on web monetization supported webpages.

What community support would benefit your project?

We would be very excited to see Solid app developers interested in implementing monetization using our WMP client.

Relevant links/resources

Demos

Solid Accountant: configure Web Monetization wallet into a Solid identity.
Solid MicroStore: prototypical Web Monetized Solid application.
Solid WMP: Web Monetization Provider with a fake currency,

Incentivizing Decentralized Application Development within Solid through Web Monetization — Grant Report #1

rubensworks — Mon, 26 Jul 2021 06:26:27 +0000

Introduction

The Solid decentralization effort decouples data from services, so that users are in full control over their personal data.
Since services can not primarily depend on data collection as a primary business model anymore, alternative forms of monetization,
such as micropayments via Web Monetization are essential for incentivizing application development.

The goals of our project involve enabling the monetization of Solid application, allowing Solid identities to be linked to Web Monetization wallets, and incorporating payment processing into Solid’s authentication.
In this first report, we share our current progress on this project.

Learn more about our project here: https://github.com/KNowledgeOnWebScale/solid-web-monetization

Project Update

Our first focus on the project was having a (web) application to assign payment pointers to a Solid WebID. This is a requirement to get started on the rest of the project. It also gave us a chance to dig in to Solid development and the use of different libraries. That web application is now ready, and allows us to log in to a Solid identity provider of your choice and then add one or more payment pointers to that WebID.

Progress on objectives

One of our three original objectives was to be able to configure a link between a user's Solid identity and his/her wallet. With the before mentioned application that allows adding payment pointers, we feel that this objective is near to completion. Of course some minor tweaks might be done in the future, but the bulk of that work is done. There is also an auto deployment available of that application via our CI/CD pipeline, which is hosted at https://knowledgeonwebscale.github.io/solid-web-monetization/.

Originally we were planning on using the @inrupt/solid-ui-react library to leverage most of the work, but we have since moved from React to Angular and used the lower level @inrupt/solid-client-authn-browser library to leverage the solid auth work. We chose N3 for parsing and writing the RDF data in the Solid WebID.

A second objective involves tying into the Solid authentication library to trigger a check for payment pointers in the user's Solid Identity. This objective has not been started yet. We are however researching the different libraries that can be used to carry out the actual payments. This involves using the Interledger's STREAM protocol and finding supported libraries. This last task has proven to be difficult, as all browser JS/TS plugin libraries that are responsible for settling payments on different networks (eg. paypal, ripple), are still in development. We are currently exploring our options here, since so far we were not able to compile them for a browser environment (instead of a node environment). Once we get some prototype payment transactions going, we can move on to this second objective of integrating into the Solid authentication hook.

The third objective was creating a prototype monetized Solid application. This is an objective that will be saved for last, since it is easiest when all links of the full chain have been researched and implemented.

Key activities

Milestone 1: Application to configure a Web Monetization wallet into a Solid identity
- Task 1.1. Extension of WebID ontology to include link to Web Monetization Wallet
  
  [Status: Finished]
  
  We are of the opinion that Payment Pointers should have an extra indirection so that more properties can be attached to a single payment pointer. This would allow a user to (in the future):
  - Mark a payment pointer with a purpose/tag (eg. work, personal)
  - Mark a payment pointer as default (if there are multiples)
  - Use different types of Payment Pointers (right now we are working with an InterledgerPaymentPointer type)
  - Easily add any more propeties in the future if deemed necessary.
  Our solution initially required RDF BlankNodes to implement this. However blank nodes are still problematic when parsing and wrinting RDF, so we've opted to skolemize the blank nodes.
- Task 1.2. Application to configure a Web Monetization wallet into a Solid identity
  
  [Status: Finished]
  
  This started out as a React-Typescript project, because we wanted to reuse the @inrupt/solid-ui-react library. This library leans on top of the @inrupt/solid-client-authn-browser library. Since however the newest features of that underlaying library weren't available yet and we needed more fine grained control, the @inrupt/solid-ui-react library was dropped. Because the team is very familiar with angular applications, we then quickly rewrote the application as an angular application using that lower-level @inrupt/solid-client-authn-browser libary.
  
  When the user logs in, he/she can choose between 3 identity providers: inrupt.net, solidcomminity.net and a custom identity provider (url). The latter one can (among others) be used to refer to the Community Solid Server (CSS).
Milestone 2: Extension of the Solid authentication library with Web Monetization support
- Task 2.1. Analysis of Solid/WebID authentication protocol
  
  [Status: Started]
  
  Theoretical work on this task has started. Most work so far has gone into researching the OAuth extensions that Solid/WebID would require on top of the standard OIDC/OAuth 2.0 workflow since we are familiar with that flow. More specifically this meant reading up on Proof of Posession Tokens (PoP), Provider Selection, WebID URI derivation, Provider Confirmation.
  
  More work needs to be done here to thoroughly grasp the workflow, before integrating it into the Solid authentication hooks.
- Task 2.2. Analysis of Web Monetization protocol
  
  [Status: Ongoing]
  
  This task is ongoing. It involves reading the Web Monetization Specification and theorizing about web monetization use cases and how to practically surface some decisions to the user (eg. picking a payment pointer, setting a payment limit, etc).
- Task 2.3. Theoretical integration of WebID and Web Monetization protocols
  
  [Status: Not started]
- All following tasks and milestones have not been started yet

Communications and marketing

We are collaborating with other initiatives that combine Web Monetization with Solid on https://github.com/solid/webmonetization.

What’s next?

The next milestone is of course Milestone 2. Once we have a deep enough insight into the protocols and specifications we can start the theoretical integration of the WebID and Web Monetization protocols (Task 2.3) and follow it up with the implementation. This would then immediatly get us started on Milestone 3 and its tasks.

What community support would benefit your project?

We welcome any help and insights regarding any browser-ready JS libraries that can be used to carry out actual payments.

Relevant links/resources

Learn more about our progress here: https://github.com/KNowledgeOnWebScale/solid-web-monetization/projects/1

The Interledger Community 🌱: rubensworks

Incentivizing Decentralized Application Development within Solid through Web Monetization — Grant Report 2

Project Update

Progress on objectives

Key activities

Communications and marketing

What’s next?

What community support would benefit your project?

Relevant links/resources

Demos

Repositories

Documentation

Library

Specification

Incentivizing Decentralized Application Development within Solid through Web Monetization — Grant Report #1

Introduction

Project Update

Progress on objectives

Key activities

Communications and marketing

What’s next?

What community support would benefit your project?

Relevant links/resources