A DHT-based relay and post store for ActivityPub hashtags
 
 
 
Go to file
Trolli Schmittlauch b46f66e2c0 update Readme with latest branch name and pointer to SocialHub 2021-08-16 20:12:53 +02:00
app increase HTTP timeout for initial post publication to 60 seconds 2020-09-22 19:47:39 +02:00
src add log messages for failed relays as well 2020-09-17 02:17:57 +02:00
test fix tests 2020-08-17 13:39:22 +02:00
.gitignore remove unnecessary directory level 2020-05-19 00:01:32 +02:00
.hlint.yaml adjust hlint hints to ignore lambda-case 2020-05-29 21:30:18 +02:00
CHANGELOG.md remove unnecessary directory level 2020-05-19 00:01:32 +02:00
FediChord.asn1 indicate in LeaveRequest whether to expect a migration 2020-08-17 12:36:02 +02:00
Hash2Pub.cabal update ghc to 8.6.4, nixpkgs base to 20.09 2021-01-01 14:33:03 +01:00
LICENSE remove unnecessary directory level 2020-05-19 00:01:32 +02:00
Readme.md update Readme with latest branch name and pointer to SocialHub 2021-08-16 20:12:53 +02:00
Setup.hs remove unnecessary directory level 2020-05-19 00:01:32 +02:00
cabal.project.renameinfuture disable online package fetching, only starts to work with cabal 3.4 and needs to be renamed then 2020-07-14 13:40:13 +02:00
default.nix update ghc to 8.6.4, nixpkgs base to 20.09 2021-01-01 14:33:03 +01:00
democlient.hs remove unnecessary directory level 2020-05-19 00:01:32 +02:00
demoserver.hs remove unnecessary directory level 2020-05-19 00:01:32 +02:00
hashtest.hs remove unnecessary directory level 2020-05-19 00:01:32 +02:00
shell-minimal.nix add nix shell environment without HIE for smaller foot print 2020-08-13 13:09:48 +02:00
shell.nix update ghc to 8.6.4, nixpkgs base to 20.09 2021-01-01 14:33:03 +01:00
stylish.sh Linting integration 2020-05-19 12:42:06 +02:00

Readme.md

Hash2Pub

This is heavily WIP and does not provide any useful functionality yet.
I aim for always having the mainline branch in a state where it builds and tests pass.

A fully-decentralised relay for global hashtag federation in ActivityPub based on a distributed hash table. It allows querying and subscribing to all posts of a certain hashtag and is implemented in Haskell.

This is the practical implementation of the concept presented in the paper Decentralised Hashtag Search and Subscription for Federated Social Networks. A 30 minutes introduction talk is available as well.

The ASN.1 module schema used for DHT messages can be found in FediChord.asn1.

For further questions and discussins, please refer to the Hash2Pub topic in SocialHub.

Building

The project and its developent environment are built with Nix.

The development environment can be entered with nix-shell shell-minimal.nix. Then the project can be built with cabal build from within the environment, or using nix-shell --command "cabal build" shell-minimal.nix to do both steps at once.

While the shell-minimal.nix environment contains everything necessary for building and testing this project, the shell.nix additionally contains the Haskell IDE engine hie and the documentation for all used Haskell packages for more convenient development.
Be aware that these need to be build from source and can take a very long time to build.