https://pawpub.entities.org.uk/ 2026-04-22T12:17:17+00:00 https://pawpub.entities.org.uk/ https://pawpub.entities.org.uk/_media/wiki/dokuwiki.svg text/html 2026-01-20T17:32:17+00:00 Anonymous (anonymous@undisclosed.example.com) https://pawpub.entities.org.uk/authentication?rev=1768930337&do=diff Server-to-server authentication In order for instances to verify each other's identity, a weak authentication mechanism is used, based on a simple DNS dialback negotiation. The process goes roughly like this: * Server A wants to prove its identity to Server B text/html 2026-01-20T17:32:17+00:00 Anonymous (anonymous@undisclosed.example.com) https://pawpub.entities.org.uk/digitigrade?rev=1768930337&do=diff Digitigrade Digitigrade is a PawPub implementation in PHP. Source code This article is a stub. If you have an account on this wiki, you can help by expanding it. text/html 2026-01-20T17:32:17+00:00 Anonymous (anonymous@undisclosed.example.com) https://pawpub.entities.org.uk/extensions?rev=1768930337&do=diff Extensions PawPub has a simple but flexible extension system, allowing additional features to be added to the protocol while preserving compatibility with other software that may not support them. Each extension is identified by a unique URI, which may or may not resolve to anything, although it's recommended to place documentation for the extension there. Extensions can either exist as extra properties attached to <script type="text/javascript"> catlist_baseurl = "https://pawpub.entities.org.u… text/html 2026-01-20T17:32:17+00:00 Anonymous (anonymous@undisclosed.example.com) https://pawpub.entities.org.uk/instance-metadata?rev=1768930337&do=diff Instance metadata For many features of PawPub to work properly, instances must provide metadata about themselves. For example, authentication and push use an instance-wide endpoint, which is specified in the instance metadata. It also provides some other information that clients or third-party services may wish to use. text/html 2026-01-20T17:32:17+00:00 Anonymous (anonymous@undisclosed.example.com) https://pawpub.entities.org.uk/instance?rev=1768930337&do=diff Instance An instance is a web server that provides PawPub functionality. They should usually have instance metadata and WebFinger as a minimum. This article is a stub. If you have an account on this wiki, you can help by expanding it. text/html 2026-01-20T17:32:17+00:00 Anonymous (anonymous@undisclosed.example.com) https://pawpub.entities.org.uk/objects?rev=1768930337&do=diff Objects PawPub has five fundamental types of “pushable object” (anything that can be pushed to another instance), which are: * Actor: represents an entity that can “do something”, e.g. a user * Note: represents a post, article or message of some kind text/html 2026-01-20T17:32:18+00:00 Anonymous (anonymous@undisclosed.example.com) https://pawpub.entities.org.uk/pagination?rev=1768930338&do=diff Pagination A pagination represents a single page of items (which may be any JSON data type) along with some metadata about the total number of items and how to access the previous and next pages, if present. It is used for example in actors' feed endpoints, to split up the data into more readily consumable chunks and to avoid making clients load too much at once. text/html 2026-01-20T17:32:17+00:00 Anonymous (anonymous@undisclosed.example.com) https://pawpub.entities.org.uk/pawpub?rev=1768930337&do=diff About PawPub PawPub, the subject of this wiki, is an experimental web-based protocol for federated social media, based on common standards like HTTP and JSON. While inspired by ActivityPub, it aims to be considerably simpler to understand and implement by having a more focused purpose, and easier to extend by having a well-defined text/html 2026-01-20T17:32:18+00:00 Anonymous (anonymous@undisclosed.example.com) https://pawpub.entities.org.uk/push?rev=1768930338&do=diff Pushing objects In order for other instances to discover your objects in a timely manner, you may want to push them. The recommended way to do this is to send the object directly to the push endpoint (listed in the remote instance's metadata), but for lightweight implementations you can also send just the text/html 2026-01-20T17:32:18+00:00 Anonymous (anonymous@undisclosed.example.com) https://pawpub.entities.org.uk/sidebar?rev=1768930338&do=diff Useful pages * About PawPub * Software and implementations * Objects * Actor * Note * Interaction * Extension * Tombstone * Instances * Instance metadata * Authentication * Push * Reporting * WebFinger * Extensions text/html 2026-01-22T22:23:14+00:00 Anonymous (anonymous@undisclosed.example.com) https://pawpub.entities.org.uk/software?rev=1769120594&do=diff Software and implementations Here is a (possibly incomplete) list of software relating to PawPub, including instance servers, client apps, tools, and anything else. Instance servers Name Author text/html 2026-01-20T17:32:18+00:00 Anonymous (anonymous@undisclosed.example.com) https://pawpub.entities.org.uk/start?rev=1768930338&do=diff PawPub documentation PawPub is an experimental web-based protocol for federated social media. It's designed to be easy to understand and (relatively) simple to implement, while still being featureful and extensible enough to support rich social software. Its creator text/html 2026-01-20T17:32:17+00:00 Anonymous (anonymous@undisclosed.example.com) https://pawpub.entities.org.uk/webfinger?rev=1768930337&do=diff WebFinger PawPub uses WebFinger to look up actors by their handles. The link entry uses a rel of https://pawpub.entities.org.uk/rel/actor, the type should be application/json, and the href should point to the URI of the actor being looked up. Since handles can contain any text whatsoever, it's important to text/html 2026-01-20T17:32:18+00:00 Anonymous (anonymous@undisclosed.example.com) https://pawpub.entities.org.uk/x-pawpub-actor?rev=1768930338&do=diff X-PawPub-Actor header When sending an authenticated request to another instance, it may be an action initiated by a local actor (on your instance), which is indicated by the X-PawPub-Actor HTTP request header, the value of which must be the URI of an actor you control (i.e. under the same hostname as what your