Skip to content
This repository has been archived by the owner on May 12, 2021. It is now read-only.

A social triangulation zome for hApps with small communities with ties between its participants

Notifications You must be signed in to change notification settings

holochain-open-dev/social-triangulation

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

47 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Social Triangulation Zome

TLDR: "this hApp can only be joined by friends of friends".

This social triangulation zome is a basic membrane to be reused in holochain applications. It may be useful in contexts where the application is tuned for a small number of participants that loosely know each other, or have to live nearby, etc.

This is a work in progress, not production ready. Contact us if you want to collaborate!

Membrane workflow

  1. The hApp includes this zome and sets two properties in the DNA:
  • initial_members: initial list of friends that are allowed in the hApp.
  • necessary_vouches: number of friends that have to "vouch" for you to be allowed in the hApp. This must be equal or less than the number of initial members.
  1. The agents with address inside the initial_members join the hApp. They are automatically valid.
  2. If an agent wants to enter the hApp, the agents that are already inside the app have to vouch for him, using their agent address. When the agent receives a number of vouches equal or more than the necessary_vouches, they can install the hApp and enter the network.
  3. From now on, this new agent can also vouch for other agents to enter the hApp.

Todo list

  • Implement tests when tryorama accepts DNA properties.
  • Implement UI native module
  • Publish code to npm and crates.io

Building

Assuming you have nix-shell installed, to build the DNA, execute:

nix shell
hc package

Tests

Until @holochain/tryorama supports passing in properties, tests have to be manual, since there is no way to automatically start vouching for anyone if the initial_members property can't be set.

Usage

This is a membrane zome: it only defines how agents can enter the network. It does not define any domain logic in your application, but rather has to be used with other zomes that do.

Usage until there is a better zome distribution channel:

  1. Copy and paste the zome code into your application.
  2. Set the initial_members and necessary_vouches properties in the app.json.
  3. Good to go!

About

A social triangulation zome for hApps with small communities with ties between its participants

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published