LedgerProject/Anastasis

Password-less key recovery via multi-factor multi-party authentication

GNU Anastasis

Password-less key recovery via multi-factor multi-party authentication.

Table of contents

• Documentation
• Upstream Repositories
• Built with
• Software used
• Directory structure
• Installation instructions
• Trying it out

Documentation

Documentation about the system and for installing the Anastasis binaries can be found at https://docs.anastasis.lu/.

Upstream Repositories

The canonical repositories are as follows:

• anastasis
• anastasis-gtk
• wallet-core

Built with

• GCC
• TypeScript
• preact-cli

Software used

• GNUnet
• GNU Taler
• GNU libmicrohttpd
• many other GNU packages (gcc, autoconf, gettext, gtk+, make, ...)
• preact

Directory structure

• anastasis-$VERSION: core logic and backend
• anastasis-gtk-$VERSION: Gtk+ graphical user interface
• wallet-core-$VERSION: TypeScript implementation of the anastasis client (anastasis-core and anastasis-webui)
  • Other packages in wallet-core, like taler-util and taler-wallet-cli were developed before / independent of LEDGER and are used as dependencies.

Installation instructions

Installation on Debian 11

As root, run:

echo 'deb https://deb.taler.net/apt/debian/ bullseye main' > /etc/apt/sources.list/taler.list
wget -O - https://taler.net/taler-systems.gpg.key | apt-key add -
apt update
apt install anastasis-gtk

Installation on Ubuntu 20.04

Run:

sudo echo 'deb https://deb.taler.net/apt/ubuntu/ focal-fossa main' > /etc/apt/sources.list/taler.list
wget -O - https://taler.net/taler-systems.gpg.key | sudo apt-key add -
sudo apt update
sudo apt install anastasis-gtk

Building GNU Anastasis from source

Follow the build instructions in the

• anastasis/
• anastasis-gtk/

subdirectories.

To build the Web UI, run:

cd wallet-core
pnpm run compile
cd packages/anastasis-webui
pnpm run build

The resulting Web application (static files) will be in build/. These files need to be served via HTTP (to serve locally, use e.g. python3 -m http.server).

Trying it out

At this point, you must claim to live in 'Demoland' to test the client software. In lieu of a social security number, you need to pick a prime number (2, 3, 5, 7, ...) to generate a unique identifier in 'Demoland'.

If you want to run your own service, anastasis-gtk contains a script src/testing/test_prepare.sh that can be used to start four Anastasis backends on localhost. In this case, you should claim to live in 'Testland' and you will need a square number (0, 1, 4, 9, 16, ...).

A publicly deployed version of the anastasis-webui runs at https://webui.anastasis.lu/