Infocalypse offers efficient, decentralized (p2p), anonymous code-sharing over Freenet ( ).

1. Status

This extension is not distributed with Mercurial.

Author: dkarbott

Maintainer: ArneBab



Web page:

Simple Setup including dependencies:

2. Overview

The Infocalypse 2.0 hg extension is an extension for Mercurial that allows you to create, publish and maintain incrementally updateable repositories in Freenet.

For better persistency, Infocalypse stores graphs of Mercurial bundles in Freenet, which can be reinserted by any user of the repo.

Some of the links in this article can only be retrieved over Freenet.

3. Configuration

Infocalypse can be installed normally or anonymously.

Configure your .hgrc to enable the extension by adding following lines:

infocalypse = /full/path/to/wiki_hacking/infocalypse

Run fn-setup to create the config file and temp dir. i.e.

hg fn-setup [--truster NAME]

If you did not use --truster, you can prepare the easier usage with user-id separately by running

hg fn-setupwot --truster NAME

4. Usage

In the most recent version from the setup script you can just push and pull normally to and from freenet keys.

If you setup a user-ID via --truster NAME, you can use freenet like a typical hosting platform (using ArneBab as an example ID):

   1 # freenet -> local
   2 hg clone freenet://ArneBab/life-repo
   3 # local -> freenet
   4 hg clone life-repo real-life
   5 hg clone real-life freenet://ArneBab/real-life
   6 # send pull request
   7 cd real-life
   8 hg fn-pull-request --wot ArneBab/life-repo
   9 (enter message)
  10 # check for pull-requests
  11 cd ../life-repo
  12 sleep 1800 # (wait for confidential delivery)
  13 hg fn-check-notifications --wot ArneBab

For practical examples, see

For details see or freenet:USK@-bk9znYylSCOEDuSWAvo5m72nUeMxKkDmH3nIqAeI-0,qfu5H3FZsZ-5rfNBY-jQHS5Ke7AT2PtJWd13IrPZjcg,AQACAAE/feral_codewright/16/infocalypse_howto.html#basic

Bare Basics are:

  1. Generate a key: hg fn-genkey → get a USK key (the last of the keys), from now on called KEY.

  2. In the KEY replace NAME by <project name>.R1 for higher reliability and redundancy or <project name>.R0 for stronger anonymity when inserting.

  3. Create a freenet-based repo: hg fn-create --uri KEY

  4. Push the changes: hg fn-push [--aggressive] [--uri KEY] ; aggressive makes sure you use the latest revision, even if you specify an older one.

  5. Pull changes from others: hg fn-pull [--aggressive] [--uri REQUESTKEY]; request key is the public key which is also used for retrieving a freesite. It is NOT the KEY.

  6. Reinsert if the repo is inaccessible: for i in 1 2 3 4 5: do hg fn-reinsert --level $i; done; DO NOT use fn-reinsert if you're concerned about correlation attacks - level 2, 3 and 5 can be done by any contributor, not only the author of the code, so you can “sponsor” a repository.

5. See also


Infocalypse (last edited 2022-10-29 08:38:20 by ArneBab)