━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
                MYCELIUM TOOLKIT FOR ON-LINE GOVERNANCE
                       Khleedril, September 2025
               ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━


Table of Contents
─────────────────

1. GIT Branches
2. Building
3. Deployment
.. 1. People / Bootstrap Stage Zero
.. 2. Projects / Bootstrap Stage One


The Mycelium network is a non-discoverable, totally un-centred, network
of nodes which mutually assert that a small set of other nodes belong to
actual, trustworthy people, and each node offers opinions of other
people in some contexts.  The network can be used to establish the
authenticity of strangers as actual people, and to conduct opinion polls
regarding some project issues.

At the moment the network is only useful for people involved in FOSS
projects who run their own web site.  When user-friendliness is worked
out, it will be available to a much wider audience.


1 GIT Branches
══════════════

  main
        this branch, providing all available white papers, and the code
        to produce the `mycelium', `polling-booth' and `adjudicator'
        applications,
  boot-0
        the minimal, self-contained code to produce the `mycelium'
        application,
  broken-guile-implementation
        partial development of a Guile version of the `mycelium'
        application; see the git log for information.


2 Building
══════════

  Users should have a Rust toolchain available.  The project can be
  built simply by running `cargo build --release'.


3 Deployment
════════════

3.1 People / Bootstrap Stage Zero
─────────────────────────────────

  To be a verified person on the network you need to be familiar with
  the Bootstrap Stage Zero white paper (available in this directory),
  must modify the head of the code of `mycelium.rs', and then run this
  program as a web service proxied by another web server which can deal
  with TLS security.  [Out of band, you will want to hook up with some
  trusted friends who are also engaging with the Mycelium network to
  establish mutual cross-references with each other.]

  You will find a refined version of mycelium.rs in the
  `rust/src/bin/bootstrap-0' directory.  If you want total peace of
  mind, the original self-contained simpler version is available in the
  `boot-0' branch of this repository (in either case you should ensure
  you are up to date with the head of the branch).


3.2 Projects / Bootstrap Stage One
──────────────────────────────────

  Projects wishing to vote on an issue should be familiar with the
  Bootstrap Stage One white paper (available in this directory), must
  modify the heads of the `polling_booth.rs' and `adjudicator.rs' files
  and the files referenced therein, and then run these two programs
  under a public web server.  [This will need to be accompanied by a lot
  of out-of-band work of general, social, project governance to
  establish the parameters of a vote (including a hard deadline),
  advertise it, and make sure that all the governors of a project are on
  board.]