Skip to content
Web Monetization logo Web Monetization
GitHub

Activity Streams JSON-LD

Social web community servers and apps can expose the wallet address or payment pointer of a user or post to a Web Monetization client, such as the Interledger Foundation’s Web Monetization browser extension or embedded SDK.

The monetization property from the Web Monetization namespace (https://webmonetization.org/ns.jsonld) applies to an Activity Streams 2.0 Object.

A Web Monetization wallet address or payment pointer can be applied to either an Actor performing an action of creation or an Object Type created by the Actor.

A monetization property must only be applied to an Object Type when its desired monetization attribution is distinct from the Actor who created it.

User Profile example

Section titled “User Profile example”
{
  "@context": [
    "https://www.w3.org/ns/activitystreams",
    "https://w3id.org/security/v1",


    // Add the Web Monetization context
    "https://webmonetization.org/ns.jsonld",


    {
      "Hashtag": "as:Hashtag",
    },
  ],
  "id": "https://alpaca.gold/users/Jeremiah",
  "type": "Person",
  "following": "https://alpaca.gold/users/Jeremiah/following",
  "followers": "https://alpaca.gold/users/Jeremiah/followers",
  "inbox": "https://alpaca.gold/users/Jeremiah/inbox",
  "outbox": "https://alpaca.gold/users/Jeremiah/outbox",
  "preferredUsername": "Jeremiah",
  "name": "Jeremiah Lee",
  "summary": "<p>I want you to get paid when you go viral. <a href=\"https://alpaca.gold/tags/WebMonetizationRocks\" class=\"mention hashtag\" rel=\"tag\">#<span>WebMonetizationRocks</span></a></p>",
  "url": "https://alpaca.gold/@Jeremiah",
  "published": "2023-01-06T00:00:00Z",
  "publicKey": {},
  "endpoints": {
    "sharedInbox": "https://alpaca.gold/inbox",
  },
  "tag": [{
          "type": "Hashtag",
          "href": "https://alpaca.gold/tags/WebMonetizationRocks",
          "name": "#WebMonetizationRocks",
    }],


  // Wallet address when viewing this user’s profile and posts
  "monetization": "https://fynbos.me/jeremiah",
}

User post (Note) example

Section titled “User post (Note) example”
{
  "@context": [
    "https://www.w3.org/ns/activitystreams",
    "https://webmonetization.org/ns.jsonld",


    // Add the Web Monetization context
    "https://webmonetization.org/ns.jsonld",


    {
      "ostatus": "http://ostatus.org#",
      "atomUri": "ostatus:atomUri",
      "conversation": "ostatus:conversation"
    }
  ],
  "id": "https://demo.interledger.social/users/WebMonetizationTest/statuses/113917664614618248",
  "type": "Note",
  "published": "2025-01-30T14:00:14Z",
  "url": "https://demo.interledger.social/@WebMonetizationTest/113917664614618248",
  "attributedTo": "https://demo.interledger.social/users/WebMonetizationTest",
  "to": ["https://www.w3.org/ns/activitystreams#Public"],
  "cc": [
    "https://demo.interledger.social/users/WebMonetizationTest/followers",
    "https://alpaca.gold/users/Jeremiah"
  ],
  "atomUri": "https://demo.interledger.social/users/WebMonetizationTest/statuses/113917664614618248",
  "conversation": "tag:demo.interledger.social,2025-01-30:objectId=26:objectType=Conversation",
  "content": "<p>“When you go viral, you should get paid.” —<span class=\"h-card\" translate=\"no\"><a href=\"https://alpaca.gold/@Jeremiah\" class=\"u-url mention\">@<span>Jeremiah</span></a></span></p>",
  "contentMap": {
    "en": "<p>“When you go viral, you should get paid.” —<span class=\"h-card\" translate=\"no\"><a href=\"https://alpaca.gold/@Jeremiah\" class=\"u-url mention\">@<span>Jeremiah</span></a></span></p>"
  },
  "tag": [{
    "type": "Mention",
    "href": "https://alpaca.gold/users/Jeremiah",
    "name": "@[email protected]"
  }],


  // Wallet address distinct from the Note’s author
  "monetization": "https://fynbos.me/jeremiah"
}

Post with multiple wallet addresses example

Section titled “Post with multiple wallet addresses example”
{
  "@context": [
    "https://www.w3.org/ns/activitystreams",


    // Add the Web Monetization context
    "https://webmonetization.org/ns.jsonld",


    {
      "ostatus": "http://ostatus.org#",
      "atomUri": "ostatus:atomUri",
      "conversation": "ostatus:conversation",
      "Hashtag": "as:Hashtag"
    }
  ],
  "id": "https://alpaca.gold/users/Jeremiah/statuses/816659822732776311",
  "type": "Note",
  "published": "2025-03-03T02:03:03Z",
  "url": "https://alpaca.gold/@Jeremiah/816659822732776311",
  "attributedTo": "https://alpaca.gold/users/Jeremiah",
  "to": ["https://www.w3.org/ns/activitystreams#Public"],
  "cc": ["https://alpaca.gold/users/Jeremiah/followers"],
  "atomUri": "https://alpaca.gold/users/Jeremiah/statuses/816659822732776311",
  "conversation": "tag:alpaca.gold,2025-03-03:objectId=4838002:objectType=Conversation",
  "content": "<p>I can’t take full credit for the awesomeness of this post.</p>",
  "replies": {
    "id": "https://alpaca.gold/users/Jeremiah/statuses/816659822732776311/replies",
    "type": "Collection",
    "first": {
      "type": "CollectionPage",
      "next": "https://alpaca.gold/users/Jeremiah/statuses/816659822732776311/replies?only_other_accounts=true&page=true",
      "partOf": "https://alpaca.gold/users/Jeremiah/statuses/816659822732776311/replies"
    }
  },


  // Wallet address when viewing this Note
  "monetization": ["https://fynbos.me/jeremiah", "https://fynbos.me/adam"]
}