377 lines
12 KiB
Markdown
377 lines
12 KiB
Markdown
+++
|
|
+++
|
|
|
|
# Activity
|
|
|
|
an Activity is just an object that has an `actor`
|
|
|
|
{{<toc>}}
|
|
|
|
## what does it mean to be an Activity
|
|
|
|
for C2S: if it has `actor` then do not wrap it in a Create when it gets POSTed to outbox
|
|
|
|
## implementations
|
|
|
|
### mastodon
|
|
|
|
supported activity types <https://github.com/mastodon/mastodon/tree/main/app/lib/activitypub/activity>
|
|
|
|
- Accept (accept a follow request)
|
|
- Add (adds hashtag or status to featured collection)
|
|
- Announce (reblog a status)
|
|
- Block (block an account)
|
|
- Create (create a message or status)
|
|
- Delete (delete account or status)
|
|
- Flag (report accounts and/or statuses)
|
|
- Follow (request to follow a local account)
|
|
- Like (favourite a status)
|
|
- Move (migrate an account's followers)
|
|
- Reject (reject follow request or remove follower)
|
|
- Remove (removes hashtag or status from featured collection)
|
|
- Undo (undoes some activities if possible)
|
|
- Update (update account info or edit a status)
|
|
|
|
#### extended logic
|
|
|
|
- **Accept**
|
|
- **Accept Follow** -- authorize a follow request
|
|
- (when relay is findable by `object` as follow_activity_id)
|
|
- (when `object` is uri of existing follow request)
|
|
- (when `object` is embedded Follow)
|
|
- **Accept Follow `<Account>`**
|
|
- **Add**
|
|
- (must have `target`)
|
|
- (`target` must be a `toot:featured` collection)
|
|
- (`object` must be inlined?)
|
|
- **Add Hashtag to `target<featured>`** -- feature a hashtag
|
|
- (takes `object.name` and removes prefix `#`)
|
|
- (creates FeaturedTag entity for the `actor`'s account)
|
|
- **Add `object<Status>` to `target<featured>`** -- pin a status
|
|
- (`object` must be transformable to status)
|
|
- (status must be authored by `actor`)
|
|
- (status must not already be pinned)
|
|
- **Announce**
|
|
- (must be related to local activity)
|
|
- (i.e. `actor<Account>` followed by local accounts)
|
|
- (or requested through relay)
|
|
- (or `object` refers to a status whose account is local)
|
|
- (`object` resolves to a status)
|
|
- **Announce `object<Status>`** -- creates a reblog of a status
|
|
- (stop if:)
|
|
- (no status)
|
|
- (status not boostable)
|
|
- (requested through relay)
|
|
- (find existing reblog or create)
|
|
- **Block**
|
|
- (`object` resolves to an account)
|
|
- (the resolved account exists and is local)
|
|
- **Block `object<Account>`** -- block an account
|
|
- (unfollow the `object<Account>`)
|
|
- (force `object<Account>` to unfollow you)
|
|
- (reject any follow requests from `object<Account>`)
|
|
- (create a block asynchronously)
|
|
- **Create**
|
|
- (dereference the `object`)
|
|
- **Create EncryptedMessage** -- creates an encrypted message
|
|
- (tries to find a device id)
|
|
- (extracts `messageType`, `cipherText`, `digest`, `messageFranking`)
|
|
- **Create `object<Status>`** -- creates a status
|
|
- (rejected if)
|
|
- (unsupported object type)
|
|
- (`object` is a string)
|
|
- (not in supported types)
|
|
- Note
|
|
- Question
|
|
- (not in converted types)
|
|
- Image
|
|
- Audio
|
|
- Video
|
|
- Article
|
|
- Page
|
|
- Event
|
|
- (or invalid origin)
|
|
- (or tombstone exists for `object` uri)
|
|
- (or not related to local activity)
|
|
- **Delete**
|
|
- (if `actor` matches `object`)
|
|
- **Delete `object<Account>`** -- delete your own account
|
|
- **Delete `object<Status>`** -- delete a status
|
|
- (create tombstone unless origin is invalid)
|
|
- (forward deletion if forwardable)
|
|
- (remove status from database and timelines)
|
|
- **Flag**
|
|
- (`object` array is resolved as accounts and statuses)
|
|
- (then filtered for local)
|
|
- **Flag `object<Account,Status>`** -- report an account and/or statuses
|
|
- (foreach account get reported statuses)
|
|
- (create a report against the account w/ optional status ids and content)
|
|
- **Follow**
|
|
- (`object` must be a local account that exists)
|
|
- **Follow `object<Account>`** -- request to follow a local account
|
|
- (create or update follow request)
|
|
- (auto-reject if:)
|
|
- (`object<Account>` is blocking `actor<Account>`)
|
|
- (`object<Account>` is domain-blocking `actor`'s domain)
|
|
- (`object<Account>` has moved/redirected)
|
|
- (`object<Account>` is the instance actor)
|
|
- (send an Accept Follow if a follow already exists)
|
|
- (otherwise create a follow request)
|
|
- (if you are silenced or they are locked, send frq notification)
|
|
- (otherwise send Accept Follow and follow notification)
|
|
- **Like**
|
|
- (resolve status from `object`)
|
|
- **Like `object<Status>`** -- favourite a status
|
|
- (stop if:)
|
|
- (no status resolved)
|
|
- (status is not from a local account)
|
|
- (delete arrived first)
|
|
- (you already favourited this status)
|
|
- (create a favourite by `actor<Account>` for `object<Status>`)
|
|
- **Move**
|
|
- (`actor` must match `object` and resolve to account)
|
|
- (resolve `target` as account)
|
|
- **Move `object<Account>` to `target<Account>`** -- migrate your followers
|
|
- (stop if:)
|
|
- (no `target<Account>`)
|
|
- (`target<Account>` is suspended)
|
|
- (`target.alsoKnownAs` doesn't include `object`)
|
|
- (set a redirect)
|
|
- (async move followers from `object<Account>` to `target<Account>`)
|
|
- **Reject**
|
|
- **Reject Follow** -- reject a follow request or remove follower
|
|
- (when relay is findable by `object` as follow_activity_id)
|
|
- (when `object` is uri of existing follow request)
|
|
- (when `object` is uri of existing follow)
|
|
- (call UnfollowService for `actor<Account>`)
|
|
- (when `object` is embedded Follow)
|
|
- **Reject Follow `Follow.object<Account>`**
|
|
- **Remove**
|
|
- (must have `target`)
|
|
- (`target` must be a `toot:featured` collection)
|
|
- (`object` must be inlined?)
|
|
- **Remove Hashtag from `target<featured>`** -- unfeature a hashtag
|
|
- (takes `object.name` and removes prefix `#`)
|
|
- (deletes FeaturedTag entity for the `actor`'s account)
|
|
- **Remove `object<Status>` from `target<featured>`** -- unpin a status
|
|
- (`object` must be transformable to status)
|
|
- (status must be authored by `actor`)
|
|
- (destroy pin if existing pin found)
|
|
- **Undo**
|
|
- (`object` should be inlined or else it may not be handled)
|
|
- **Undo Announce** -- unreblog a status
|
|
- (stop if no `Announce.id`)
|
|
- (resolve `Announce.id` as status reblog)
|
|
- (call RemoveStatusService on status)
|
|
- **Undo Accept** -- unfollow an account [yes this is the assumption]
|
|
- (find follow by `object.object.id` and revoke it)
|
|
- **Undo Follow**
|
|
- (resolve `object.object` as account)
|
|
- (stop if not exists or not local)
|
|
- **Undo Follow `<Account>`** -- unfollow an account
|
|
- (`Undo.actor` unfollows `Follow.object<Account>` if following)
|
|
- **Undo Like**
|
|
- (resolve `object.object` as status)
|
|
- (stop if no status or if status is not local)
|
|
- **Undo Like `<Status>`** -- unfavourite a status
|
|
- (if `actor` has favourited the status:)
|
|
- (find a favourite on that status by that account)
|
|
- (destroy it)
|
|
- **Undo Block**
|
|
- (resolve `object.object` as account)
|
|
- (stop if not exists or not local)
|
|
- **Undo Block `<Account>`** --unblock an account
|
|
- (call UnblockService if `actor` is blocking `Block.object<Account>`)
|
|
- **Undo `object<IRI>`**
|
|
- (try_undo_announce)
|
|
- (find reblogged status by `object` uri and `actor`)
|
|
- (if found, remove reblog and stop, else continue)
|
|
- (try_undo_accept)
|
|
- (do nothing, continue) [because Accept uri is not stored]
|
|
- (try_undo_follow)
|
|
- (find `actor<Account>` follow request/relation by `object` uri)
|
|
- (if found, destroy it and stop, else continue)
|
|
- (try_undo_like)
|
|
- (do nothing, continue) ["too costly", no index by Like uri]
|
|
- (try_undo_block)
|
|
- (find `actor<Account>` block by `object` uri)
|
|
- (if found, call UnblockService and stop, else continue)
|
|
- **Update**
|
|
- (dereference `object`)
|
|
- (if `object.type` in `Application Group Organization Person Service`)
|
|
- **Update `object<Account>`** -- update an account's info
|
|
- (stop if `actor.id` does not match `object.id`)
|
|
- (call ProcessAccountService)
|
|
- (else if `object.type` in `Note Question`)
|
|
- **Update `object<Status>`** -- edit a status
|
|
- (stop if invalid origin)
|
|
- (resolve `object` as status)
|
|
- (stop if no status)
|
|
- (call ProcessStatusUpdateService)
|
|
|
|
### pixelfed
|
|
|
|
<https://github.com/pixelfed/pixelfed/blob/dev/app/Util/ActivityPub/Inbox.php>
|
|
|
|
(seems to require inlining in a lot of places? not 100% sure but that's what it looks like to me)
|
|
|
|
- Add
|
|
- (must be inlined?)
|
|
- Add Story (not final)
|
|
- Create
|
|
- (requires `to` for some reason, so `cc` only will break)
|
|
- Create Question
|
|
- (a single `to` item will create a DM if no `cc`)
|
|
- Create Note.inReplyTo
|
|
- Create Note.attachment
|
|
- Follow
|
|
- Follow `object<Profile>`
|
|
- Announce
|
|
- Announce `object<Status>`
|
|
- Accept
|
|
- Accept Follow (anything else will return immediately)
|
|
- Delete
|
|
- Delete `object<Profile>` (if `object` == `actor` and is valid string uri)
|
|
- Delete [Person, Tombstone, Story] (???)
|
|
- Delete Person
|
|
- Delete Tombstone (???)
|
|
- Delete Story (not final)
|
|
- Like
|
|
- Like `object<Status>`
|
|
- Reject
|
|
- (does nothing)
|
|
- Undo
|
|
- (must be inlined)
|
|
- Undo Accept
|
|
- (does nothing)
|
|
- Undo Announce
|
|
- Undo Block
|
|
- (does nothing)
|
|
- Undo Follow
|
|
- Undo Like
|
|
- View
|
|
- View Story (not final)
|
|
- (also seems to get story id by whatever is after the last slash?)
|
|
- Story:Reaction (not final; undocumented extension)
|
|
- (`id` and `actor` must be valid urls)
|
|
- (`inReplyTo` and `to` must be local)
|
|
- (`object` must not resolve to Status)
|
|
- (seems to get story id by whatever is after the last slash?)
|
|
- Story:Reply (not final; undocumented extension)
|
|
- (`id` and `actor` must be valid urls)
|
|
- (`inReplyTo` and `to` must be local)
|
|
- (`object` must not resolve to Status)
|
|
- (seems to get story id by whatever is after the last slash?)
|
|
- Update (commented out)
|
|
|
|
### misskey
|
|
|
|
<https://github.com/misskey-dev/misskey/blob/develop/packages/backend/src/core/activitypub/type.ts>
|
|
|
|
- Create
|
|
- Delete
|
|
- Update
|
|
- Read
|
|
- Undo
|
|
- Follow
|
|
- Accept
|
|
- Reject
|
|
- Add
|
|
- Remove
|
|
- Like | EmojiReaction | EmojiReact
|
|
- Announce
|
|
- Block
|
|
- Flag
|
|
|
|
<https://github.com/misskey-dev/misskey/blob/develop/packages/backend/src/core/activitypub/ApInboxService.ts>
|
|
|
|
### pleroma
|
|
|
|
ObjectValidator <https://git.pleroma.social/pleroma/pleroma/-/blob/develop/lib/pleroma/web/activity_pub/object_validator.ex>
|
|
|
|
validate()
|
|
|
|
- Block
|
|
- Undo
|
|
- Delete
|
|
- Create ChatMessage
|
|
- Create [Question Answer Audio Video Event Article Note Page]
|
|
- [Event Question Audio Video Article Note Page]
|
|
- Event
|
|
- Question
|
|
- Audio
|
|
- Video
|
|
- Article
|
|
- Note
|
|
- Page
|
|
- Update [Question Answer Audio Video Event Article Note Page]
|
|
- [Accept Reject Follow Update Like EmojiReact Announce]
|
|
- Accept
|
|
- Reject
|
|
- Follow
|
|
- Update
|
|
- Like
|
|
- EmojiReact
|
|
- Announce
|
|
- ChatMessage
|
|
- Answer
|
|
- [Add Remove]
|
|
|
|
SideEffects <https://git.pleroma.social/pleroma/pleroma/-/blob/develop/lib/pleroma/web/activity_pub/side_effects.ex>
|
|
|
|
handle()
|
|
|
|
- Accept
|
|
- Accept Follow
|
|
- Reject
|
|
- Reject Follow
|
|
- Follow
|
|
- Block
|
|
- Update
|
|
- Update `object<User>`
|
|
- Update `object<Object>`
|
|
- Like
|
|
- Create
|
|
- Create ChatMessage
|
|
- Create Question
|
|
- Create Answer
|
|
- Create [Audio Video Event Article Note Page]
|
|
- Announce
|
|
- Undo
|
|
- Undo Like
|
|
- Undo EmojiReact
|
|
- Undo Announce
|
|
- Undo Block
|
|
- EmojiReact
|
|
- Delete
|
|
- Add
|
|
- Remove
|
|
|
|
Transmogrifier <https://git.pleroma.social/pleroma/pleroma/-/blob/develop/lib/pleroma/web/activity_pub/transmogrifier.ex>
|
|
|
|
handle_incoming()
|
|
|
|
- Flag
|
|
- Listen Audio
|
|
- Like._misskey_reaction
|
|
- Create [Question Answer ChatMessage Audio Video Event Article Note Page]
|
|
- [Like EmojiReact Announce Add Remove]
|
|
- (fetch `actor` and `object`)
|
|
- [Update Block Follow Accept Reject]
|
|
- (fetch `actor`)
|
|
- Delete
|
|
- (check if Create exists)
|
|
- Undo Follow
|
|
- Undo
|
|
- (get `object` by `id` and expand it)
|
|
- Move
|
|
|
|
prepare_outgoing()
|
|
|
|
- [Create Listen]
|
|
- Update `object<updatable>`
|
|
- [Note Question Audio Video Event Article Page]
|
|
- Announce
|
|
- Accept -> Accept Follow
|
|
- Reject -> Reject Follow
|
|
- Answer -> Note |