Federation

• an [[idea]].
  • #pull [[fediverse]] [[commons]]
  • a [[subset]] of the [[internet]].
    • The part that is willing to [[federate]].
    • The part that works for its [[users]].
    • The set of all [[open platforms]]; those who follow [[open protocols]] and try to build [[commons]].
• [[go]] https://fediverse.party/en/portal/servers
  • I heartily recommend you choose an [[instance]] of any type (there are many) and join now.
  • Prioritize this in particular if you’re hooked with platforms such as [[instagram]] or [[twitter]] :)
• The [[agora]] is part of the [[federation]].
  • It tries to run projects of [[public utility]].

federation

Agora Federation

The Agora supports a basic level of ActivityPub federation, allowing users from other federated platforms (like Mastodon, Pleroma, etc.) to follow and receive updates from users within the Agora.

This document outlines the current implementation.

Key Endpoints

WebFinger

• Endpoint: /.well-known/webfinger?resource=acct:<user>@<domain>
• Purpose: Allows users on other servers to discover Agora users. When a remote user searches for @<user>@<your.agora.domain>, their server queries this endpoint.
• Implementation: The Agora checks if the requested user exists. If they do, it returns a JSON response containing a link to the user’s ActivityPub profile (actor) URL.

Actor Profile

• Endpoint: /users/<username> (also aliased to /u/<username>)
• Purpose: Provides the ActivityPub actor profile for an Agora user. This is a machine-readable JSON object that describes the user.
• Implementation: The profile includes:
  • The user’s unique id.
  • Their preferredUsername.
  • Links to their inbox and outbox.
  • A link to their human-readable Agora profile page (/u/<user>).
  • A public key (publicKeyPem) for verifying signed requests.

Inbox

• Endpoint: /u/<user>/inbox (POST)
• Purpose: Receives activities from other servers.
• Implementation:
  • Handles Follow, Like, Create (Reply), and Announce (Boost) activities.
  • Incoming requests are verified using HTTP Signatures.
  • Follow: Adds the follower to the database and sends an Accept activity back.
  • Reactions: Stores Likes, Replies, and Boosts in the reactions table in SQLite.

Outbox

• Endpoint: /u/<user>/outbox (GET)
• Purpose: Shows a collection of the user’s recent public activities.
• Implementation:
  • It returns an OrderedCollection of the user’s 20 most recent subnodes, formatted as Create activities wrapping a Note object.
  • Each Note object has a stable, unique ID (/u/<user>/note/<path>) that returns the ActivityPub JSON representation, ensuring compatibility with Mastodon and other platforms.

Federation Logic

Following a User

1. A user on a remote server follows an Agora user.
2. The remote server sends a Follow activity to the Agora user’s inbox.
3. The Agora validates the activity (HTTP Signature) and adds the follower to its database.
4. The Agora sends an Accept activity back to the remote server.
5. Immediately after sending the Accept, the Agora sends the new follower the 5 most recent subnodes from the followed user. This is to populate the new follower’s timeline with some initial content.

Sending Posts (Federating)

• Initial Posts: As described above, the 5 most recent posts are sent to new followers.
• Worker Process: To automatically push new content to existing followers, you must run the Federation Worker.
• Tracking: The Agora tracks which subnodes have been federated in a dedicated SQLite table (federated_subnodes). This prevents sending the same subnode to the same follower multiple times.

Running the Federation Worker

The federation worker is a separate process that polls the Git repositories for new commits and broadcasts them to followers.

Manual Run (Single Pass):

uv run python3 scripts/federation_worker.py --once

Continuous Loop (Default Interval: 5 minutes):

uv run python3 scripts/federation_worker.py

Systemd Service: It is recommended to run this as a systemd service (e.g., agora-federation.service) to ensure it runs continuously in the background.

Security

• Keys: The Agora automatically generates a private.pem and public.pem key pair on first run if they don’t exist.
• Signed Requests: All outgoing activities (like Accept and Create) are signed with the user’s private key. Remote servers can fetch the public key from the actor profile to verify that the requests are legitimate.
• Incoming Verification: The Inbox strictly validates HTTP Signatures on incoming requests to prevent spoofing.

• [[flancian]] https://social.coop/@flancian/107542654808110563 pull
• [[coopcloud@social.coop]] https://social.coop/@coopcloud/108950300391144857 pull
• [[youronlyone@c.im]] https://c.im/@youronlyone/110066291428862570 pull
• [[youronlyone@c.im]] https://c.im/@youronlyone/110127804564078858 pull
• [[rmdes@mstdn.social]] https://mstdn.social/@rmdes/110543301691291958 pull

• [[flancian@social.coop]] https://social.coop/@flancian/111128108156181385 pull

• [[flancian]] https://social.coop/@flancian/107672853186141499 pull
• [[flancian@social.coop]] https://social.coop/@flancian/109410867949239650 pull
• [[flancian@social.coop]] https://social.coop/@flancian/109802582357575302 pull
• [[coopcloud@social.coop]] https://social.coop/@coopcloud/110255932717432624 pull

• [[flancian]] https://twitter.com/flancian/status/1472628360446681099 pull
• [[flancian]] https://twitter.com/flancian/status/1476964637509926916 pull
• [[flancian]] https://twitter.com/flancian/status/1494745798264954887 pull
• [[flancian]] https://twitter.com/flancian/status/1515040468618424321 pull
• [[flancian]] https://twitter.com/flancian/status/1520779834254897152 pull
• [[2022-11-28 16:24:09+00:00]] @[[flancian]]: https://twitter.com/flancian/status/1597265096530571264 pull

• [[flancian]] https://twitter.com/flancian/status/1485297146417004544 pull
• [[2022-11-26 15:53:06+00:00]] @[[flancian]]: https://twitter.com/flancian/status/1596532508828499970 pull
• [[2022-12-18 23:15:05+00:00]] @[[flancian]]: https://twitter.com/flancian/status/1604616268643966976 pull

• [[2024-11-02T23:07:10.185Z]] @[[flancia.org]]: https://bsky.app/profile/did:plc:xu4fhdxwmrptiwfvq5ymbkxx/post/3l7ysi7xus52x

• [[2022-03-23 22:01:20]] [[@charismatic_shell:matrix.org]] (link):
  • [[federation]]? [[praying mantis]]?

• [[2022-11-26 15:42:35+00:00]] @[[flancian@social.coop]] https://social.coop/@flancian/109410867949239650:
  • A #Flancian believes it is through a [[re evolution]] ~ #reevolution of the #base and [[super structure]] that we will unlock the true potential of humanity and our allies in the #Commons and its #Federation.
• [[2023-02-03 20:00:42+00:00]] @[[flancian@social.coop]] https://social.coop/@flancian/109802582357575302:
  • I think @elonmusk is trying to enclose or disrupt the [[Commons]] with the Twitter API changes, maybe unconsciously. But I also believe if he knew the long term implications of what he’s doing he would stop doing it: he would change his mind and embrace the #Federation.

• [[2022-11-28 16:24:09+00:00]] @[[flancian]]: https://twitter.com/flancian/status/1597265096530571264 pull

RT @dakkar@s.thenautilus.net CW: meta, #federation explanation

Aha! Finally found a clear and complete diagram of activity dissemination in #ActivityPub! It uses Mastodon-specific terms, but the logic works and matches both the code and the behaviour I’ve seen. From (1/2)

• [[2022-11-26 15:53:06+00:00]] @[[flancian]]: https://twitter.com/flancian/status/1596532508828499970 pull

A #Flancian believes it is through a [[re evolution]] ~ #reevolution of the #base and [[super structure]] that we will unlock the true potential of humanity and our allies in the #Commons and its #Federation.