The results of this project were defined by several intended outcomes. A large contribution to these outcome manifests itself in the form of a working demonstrator. This section will act as a guide for this demo, as it consists of multiple separate components interacting to complete a scenario.
This introduction and scenario will talk about the demonstrator that can be run locally on your machine. However there are also public hosted versions of these demo components, which you can find here:
Purpose of the demo¶
The demo hosts a couple of components, that come into play when a content-creator is hosting web monetized content that visiting users pay for through micropayments. These micropayments are sent over the interledger network from the visting users wallet to the content creators wallet.
Aligning with Solid's vision, all required data is stored in the visiting user's Solid pod. Our demonstrator and the use of its various components is driven by the effort to further decentralize the web. The Web Monetization Provider component was introduced to further facilitate this decentralization.
This demo will allow you to log in to your personal Solid pod and register a personal payment pointer. Afterwards you can subscribe to the Web Monetization Provider, that will manage micropayments on your behalf (with the chosen payment pointer). The Microstore component can then be visited to showcase how (once logged in with your Solid WebID) the registered WMP can be requested from your Solid WebID and instructed to pay micropayments to the content provider's payment pointer embedded in the web page.
The whole demonstrator can be set up and executed locally.
You will need a working docker installation. We recommend installing Docker Desktop. It should also include a Docker Compose install. (which installs by default with Docker Desktop).
A basic git installation will be required, just to be able to clone the repository on your local pc.
As a limitation of this demonstrator, not all components work with just any Solid pod. It is however not a technical limitation. To successfully go through the demonstrator, the user wil have to create an account and pod at solidcommunity.net.
To run this setup, you just have to clone the repository locally and then execute the docker compose file from the cloned folder.
git clone https://github.com/KNowledgeOnWebScale/solid-web-monetization.git cd solid-web-monetization docker compose up -d
This will start all demo components on your pc.
|Accountant||http://wallet.localhost||Allows you to edit your payment pointers stored in your WebID (on your Solid pod).|
|Web Monetization Provider||http://wmp.localhost||Allows you to register the WMP in your WebID (on your Solid pod) and setup a subscription to pay the WMP.|
|Microstore||http://store.localhost||Website of the content creator that has unlockable monetized content for users logged in with WebID.|
|Docs||http://docs.localhost||These docs are also hosted locally on your pc now.|
If you want a more detailed explanation, you can follow the demo scenario.
docker-compose.yml file that is being used has quite a few services that are worth explaining:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88