Aristhor Manual
V1.0 - 2026-06-10

General table of contents

17 pages across 3 parts. Click a title to jump straight to it.


Part 1: GENERAL INFORMATION

Top

Page 1 / 17

Introducing Aristhor


What is a blocksthor?

A blocksthor is a blockchain of testimonies created and managed directly by its users on the Aristhor platform. Unlike decentralized public blockchains (Bitcoin, Ethereum), a blocksthor is a private, named chain of blocks, where each block represents an act, event, or testimony that is timestamped and cryptographically signed.

Each block of a blocksthor contains a SHA-256d fingerprint calculated from its content and the fingerprint of the previous block, guaranteeing the immutability and traceability of the entire chain from the first block (zero-genesis block) to the last.

In summary: a blocksthor is an unalterable, signed, and timestamped digital record that you build block by block to attest to facts or events over time.

Principle of the testimony blockchain

The principle relies on cryptographic block chaining: each new block incorporates the fingerprint of the previous block into its own fingerprint calculation. Modifying a past block would invalidate the entire chain from that block onward, making any tampering detectable.

Each block is signed using a private PGP/OpenPGP key, whose corresponding public key is deposited on Aristhor. Anyone with this public key can verify the authenticity of the signature, and therefore the identity of the signer of each block.

The blocksthor is built and managed offline using the Blocksthor Maker, a tool available on Aristhor.com. The resulting fingerprints can then be published on Aristhor for public consultation.

The players: owner, users, warrantors

PlayerRole
Blocksthor ownerOwner of the blocksthor. They create it, manage it, add blocks, and define publication settings.
UsersUsers invited by the administrator to access the blocksthor. Depending on their rights, they can add blocks or view the content.
WarrantorsSelected users who place a warranty on a specific block of the blocksthor, attesting to the accuracy or reality of its content.

Concrete use cases

  • Intellectual property attestation: timestamp the creation of a work, piece of software, or design.
  • Compliance tracking: chronologically record quality checks, audits, or regulatory inspections.
  • Certified logbook: build an unalterable history of events (work, deliveries, interventions).
  • Service warranty: allow third parties to cryptographically guarantee that a service has been performed.
  • Proof of priority: demonstrate that information existed on a given date, before any dispute.
Top

Page 2 / 17

Understanding the PoA (Proof of Authority) blockchain


Core idea of PoA: We do not trust everyone, but rather a small group of identified, reputable players who validate operations.

Real-world analogies for Proof of Authority

1. The notary and the land registry

Imagine a register of real estate sales.

  • Each sale is recorded in a register (ledger).
  • Everyone can consult the register.
  • However, not everyone can write in it.
  • Only officially recognized notaries can record a transaction.
  • If a notary records a false sale, they risk losing their license and reputation.
Real worldPoA blockchain
Land registryBlockchain
Real estate saleTransaction
Licensed notariesValidators
Professional reputationAuthority
Entry in the registerCreating a block
Key idea: security relies on the identity and accountability of validators, not on computing power.

2. The town council that validates decisions

Imagine a town: residents propose projects, official decisions are recorded in a public register, but only elected members of the town council can vote on and sign decisions. Once approved, a decision is added to the register.

Real worldPoA blockchain
ResidentsUsers
Town councillorsValidators
Town registerBlockchain

This analogy clearly shows that not everyone needs to take part in validation.

3. A seaport's logbook

In a port, every ship's arrival or departure is logged. Several harbor masters are authorized to sign entries. The signatures are public and identifiable. If one of them cheats, their career is at stake. This is very close to the PoA logic: a few trusted players, known identity, strong accountability, permanent history.

4. Referees at a sporting competition

In a championship, results must be recorded. Only official referees can validate scores. Referees are known to everyone, and a referee who cheats risks suspension. Referees represent PoA validators — this analogy is particularly simple for a non-technical audience.

5. An aircraft's maintenance logbook

Every intervention on an aircraft is recorded in a logbook, signed by a certified mechanic, dated, and cannot be discreetly deleted. The logbook is trustworthy not because everyone watches it, but because the people who write in it are identified and accountable.

PoW, PoS and PoA: a comparative analogy

Imagine choosing who has the right to write the next line in a register:

MechanismPhysical analogy
Proof of Work (Bitcoin)Whoever wins an extremely difficult race — like a contest where the first person to solve a puzzle earns the right to write.
Proof of StakeWhoever has put up the most collateral — like co-owners who have tied up money and risk losing it if they cheat.
Proof of AuthorityWhoever holds an official mandate — like a notary, a court clerk, or an authorized official.
To remember: "A PoA blockchain works like a public register kept by a few officially recognized people. We trust them not because they are anonymous or wealthy, but because their identity and reputation are on the line with every validation."

Why do we call it a blockchain? Block chaining

Two concepts need to be distinguished: who has the right to write? (PoA) and why are past entries hard to change? (chaining). Here are the physical analogies that explain chaining.

The register where each page contains the previous page's fingerprint

Imagine a large paper register. Each page contains new transactions, its page number, and a unique fingerprint of the previous page. If someone modifies a line on page 1, the fingerprint of page 1 changes, the reference recorded on page 2 becomes invalid, page 3 becomes inconsistent... All the following pages would then have to be redone. This is very close to how a real blockchain works.

The book where each chapter cites the previous one

Imagine a novel written by several authors. Each new chapter begins with: "I confirm that the previous chapter is exactly the one whose fingerprint is XYZ." Each chapter therefore implicitly validates all the ones before it. Modifying an old chapter forces all the following ones to be rewritten — this is the "domino" effect.

Successive wax seals

Imagine a stack of envelopes. Each envelope contains documents and is closed with a seal. The fingerprint of the previous seal is reproduced on the next one. If someone opens envelope 1 and modifies its contents, seal A changes, envelope 2 no longer matches, then envelope 3, then all the following ones.

Numbered and signed pages

Imagine a notebook where each page is signed by a notary. Each page states the exact fingerprint of the previous page, and its signature is calculated from its own content plus that fingerprint. This way, each new page reinforces all the ones before it: the bigger the notebook gets, the harder it becomes to tamper with an old page without it being noticed.

Full PoA + blockchain analogy: Imagine a register kept by 10 licensed notaries. Every ten minutes, one of them fills in a new page. This page contains new transactions, but also the fingerprint of the previous page. The other notaries verify and accept the page. If someone tried to modify an old page, all the fingerprints of the following pages would become invalid and the other notaries would notice immediately.

Anchoring explained through analogies

Anchoring consists of using an external register (a public blockchain or a trusted third party) to certify and timestamp the existence of information stored elsewhere: it proves not only that it exists, but also on what date.

The notary who certifies a register

A company keeps an internal register of all its operations. Each evening, it calculates a unique fingerprint of its register for the day and hands over only this fingerprint to a notary, who records it in their official register. Later, the register's fingerprint is recalculated: if it matches the one recorded with the notary, the register has not been altered. The notary plays the role of the anchoring blockchain here.

A newspaper's front page

A classic method for proving that a document existed on a given date was to publish its fingerprint in a national newspaper. Once printed in thousands of copies, it becomes very difficult to claim that this proof did not exist on that day. Blockchain anchoring works in a similar way: a small proof is published in a register that is very difficult to alter.

The town hall's safe

Imagine several municipal departments, each with its own register. Every week, they produce a fingerprint of their register and deposit it in a public safe at the town hall. The safe contains only the fingerprints. If a department alters its register afterward, its fingerprint will no longer match the one deposited. The safe represents the anchoring blockchain.

The wax seal on a summary

Instead of having the 500 pages of a book validated, a single summary (the fingerprint) is produced and an official seal is affixed to that summary. Any change to the book changes the summary. The seal does not directly protect the book: it protects the proof of its state at a given moment. This is exactly the idea behind anchoring.

Combined PoA + anchoring analogy: A company has its own PoA blockchain kept by 10 internal notaries. Every day, they calculate a fingerprint of their entire chain and publish it in the official state gazette. Even if all the internal notaries conspired to rewrite history, they could not make the proof published in the official gazette disappear. Anchoring is therefore used to obtain an additional guarantee from a third party that is harder to corrupt.
To remember: "Anchoring consists of regularly depositing the fingerprint of one register into another, even more reliable register. That way, even if someone alters the original register, the proof deposited elsewhere makes it possible to detect the tampering."
Top

Page 3 / 17

First steps


Create an account and log in

To access Aristhor's features, you need an account. Account creation is available from the home page via the "Create an account" link.

  1. Go to aristhor.com and click on "Create an account".
  2. Enter your personal information (title, first name, last name, email).
  3. Validate your email address via the confirmation link received by email.
  4. Log in with your email and password.
Security: your email is used as your login. If you change it in "My account", remember to use this new email to log in.

The spaces: Discovery, Solo and Team

SpaceDescription
DiscoveryFree discovery space for new users. Access to the essential features to get started.
SoloFull personal space. Manage your blocksthor, public keys, warranties, and settings.
TeamCollaborative space. Share blocksthor and resources within a team or organization.

General navigation in the interface

  • My blocksthor: list and manage your blocksthor.
  • Fingerprints & Blocks: search and publicly view published blocksthor.
  • Public keys: submit and view public keys.
  • My warranties: manage your warranties.
  • Blocksthor Maker: access the tool for creating and managing blocksthor offline.

My account: contact details and profile photo

  • Edit your personal contact details (title, first name, last name, email, phone, address).
  • Add or change your profile photo (jpg, jpeg, png — 2 MB max. — 800×800 px minimum).
  • Add a default public key.
  • Configure your Mastodon access token.
  • Change your password.
Tip: use a square photo for the best result in the circular avatar.
Top

Page 4 / 17

Cryptography at the heart of Aristhor's Blocksthor blockchain


Every blockchain relies on two main technologies: the cryptographic fingerprint (or digital fingerprint) and the electronic signature (or digital signature)

Public key / private key: basic principles of the asymmetric cryptography behind signatures

  • The private key: known only to you, it lets you sign data. It must never be shared or stored online.
  • The public key: freely shareable, it lets anyone verify your signature. This is the key you deposit on Aristhor.

Aristhor uses the OpenPGP standard. Each public key is identified by its key fingerprint (40 hexadecimal characters).

Important: do not confuse the fingerprint of your public key (40 characters, OpenPGP) with the SHA-256d fingerprint of a block (64 hexadecimal characters).

The SHA-256d cryptographic fingerprint

The SHA-256d fingerprint is a cryptographic hash function that transforms any data into a string of 64 hexadecimal characters (256 bits). In Aristhor, each block has its own SHA-256d fingerprint, calculated from all of its fields.

Format: a SHA-256d fingerprint can be shortened to its first 16 characters 937da0210898846c to make it easier to search for and reduce the length of the string to be shared.

The two security levels: normal and high (AIR GAP)

LevelDescription
NormalThe private key is generated and used on a computer connected to the Internet.
High (AIR GAP)The private key is generated and used on equipment never connected to the Internet. Maximum security level.

The Blocksthor Maker: an overview of the tool

The Blocksthor Maker is an online tool that runs entirely in your browser. It lets you: generate PGP keys, create and manage blocksthor, verify integrity, calculate SHA-256d fingerprints, sign and verify signatures, and create Merkle trees. A "standalone" version of the Blocksthor Maker will soon be available for MacOS, Linux, and Windows.

Tip: for maximum security, use the "standalone" version of the Blocksthor Maker on offline (AIR GAP) equipment to create the blocksthor and add blocks.

The Blocksthor Reader: viewing without an account

The Blocksthor Reader is a reading and verification tool, separate from the Blocksthor Maker. It is accessible without being logged in to an Aristhor account, via a link in the public site's menu. It lets anyone explore a blocksthor, a block, a signature, or a public key, and verify its integrity, entirely within the browser.

Tip: unlike the Blocksthor Maker, the Blocksthor Reader does not let you create or modify a blocksthor: it is for consultation and verification only.
Top

Page 5 / 17

The fingerprints and blocks of your Blocksthor blockchain


The zero-genesis block and the permanent reference

The zero-genesis block is the first block of a blocksthor. Its SHA-256d fingerprint constitutes the permanent reference of the blocksthor (blockchain UUID). This reference never changes, regardless of how the chain evolves in the future.

Permanent ref. : the SHA-256d fingerprint of the zero-genesis block is the absolute, immutable identifier of your blocksthor.

The last block fingerprint

The fingerprint of the last block represents the current state of the blocksthor. It changes with each new block added. This is the fingerprint you publish on Aristhor and, optionally, on your Mastodon account, and of course anywhere else you like, such as in your email signature. The more widely this fingerprint is shared, the better.

Short fingerprint format (e.g. f7-4d)

FormatExampleInterpretation
Full (64 char.)f7a3b1[...]2c4dExact search
Short with -f7-4dStarts with f7, ends with 4d

Public publication and visibility of blocks

  • Allow search by fingerprint on aristhor.com: lets others publicly find your blocksthor(s) by searching for the full or short fingerprint of the last block or the zero-genesis block (permanent ref.)
  • Allow search by email on aristhor.com: lets others find your blocksthor and their states by your email. Requires public search by fingerprint to be enabled.
  • Public visibility of blocks: makes the full content of your blocksthor publicly readable and downloadable. Also requires public search by fingerprint to be enabled.
Warning: search by email can only be enabled if search by fingerprint is itself enabled.
Top

Page 6 / 17

Glossary and key concepts


Blocksthor, block, fingerprint, warranty, warrantor

TermDefinition
BlocksthorPrivate blockchain of testimonies, managed by an administrator on Aristhor.
BlockBasic unit of a blocksthor. Contains an index, a timestamp, metadata, a signature, and a SHA-256d fingerprint.
The zero-genesis blockFirst block of the chain. Its fingerprint constitutes the permanent reference (UUID) of the blocksthor.
The SHA-256d fingerprintCryptographic digest of 64 hexadecimal characters uniquely identifying a block or file.
WarrantyCryptographic attestation deposited by a third party (warrantor) regarding a specific block of a blocksthor.
WarrantorsUser who deposits a warranty signed with their private key.
Merkle treeCryptographic structure that groups several elements into a single, verifiable root fingerprint.
Merkle rootRoot fingerprint of a Merkle tree or of a single file.

Public key, digital signature, revocation

TermDefinition
Public keyFreely shareable cryptographic key used to verify a signature.
The private keySecret cryptographic key used to sign blocks or messages.
Public key fingerprintUnique identifier of a public key (40 hexadecimal characters, OpenPGP standard).
Public keyCryptographic value produced by the private key on a message. Proves the signer's identity.
RevokeAction of declaring a public key invalid (its "sibling" private key lost or compromised, etc.).
Web of trustNetwork of trust formed by cross-signatures between public keys.

Space, user quota

TermDefinition
SpaceWork environment determined by the user's role (Discovery, Solo, Team...).
User quotaMaximum number of users that can be associated with a blocksthor.

Access token (Mastodon)

TermDefinition
Mastodon access tokenAuthentication token (write:statuses scope) enabling automatic publishing to Mastodon.
Mastodon instanceMastodon server hosting your account (e.g. mastodon.social).

Part 2: EXPLORE

Top

Page 7 / 17

Search for a blocksthor


Search by full fingerprint or short format

The "Fingerprints & blocks" page lets you search for any blocksthor whose fingerprint has been made public. You can search by full fingerprint (64 characters) or by short format (f7-4d). The search is performed simultaneously on the last block fingerprint and the permanent reference.

Accepted formats:
f7a3b1[...]2c4d (full fingerprint)  |  f7-4d (short format with - as separator)

Search by owner's email

A second form lets you find a user's blocksthor from their email address. This search is only possible if the blocksthor's administrator has enabled the "Allow search by email" option.

Privacy: if you don't want to be found by email, leave the option disabled in your blocksthor's settings.

Understanding and reading the results

ColumnDescription
NameThe blocksthor's name, clickable to access its detail page.
Permanent ref.The first 16 characters of the zero-genesis block fingerprint.
SHA-256d fingerprint of the last blockThe first 16 characters of the last block fingerprint.

Viewing a blocksthor's public blocks

From a blocksthor's detail page, you can view the full content of the chain if and only if the "Public visibility of blocks" option is enabled. You can then copy or export the blocksthor to a .txt file.

Top

Page 8 / 17

Viewing public keys


Public key search

The "Public keys" section lets you search for keys deposited on Aristhor by key fingerprint (partial or full, 40 characters, OpenPGP format) or by the owner's email. Only keys with the "Searchable by fingerprint" or "Searchable by email" option enabled appear in public results.

Reading a public key record

InformationDescription
StatusValid or Revoked Valid or Revoked, with the revocation date.
Public key fingerprintUnique identifier of the key (40 characters, OpenPGP format).
Security level:Normal or high (AIR GAP).
Full keyArmored PGP content of the public key, copyable and exportable.
SignaturesList of public keys that have signed this key (web of trust).

Key signatures (web of trust)

The web of trust is a mechanism by which users mutually certify the authenticity of their public keys. On Aristhor, a user can sign another user's public key to attest to their identity. The more a key is signed by well-known users who also have a strong connection to its holder, the more trustworthy it becomes.

Verification: to verify a key fingerprint signature, use the Blocksthor Maker, "Verify a signature" tab.

Aristhor's public key

Aristhor publishes its own public key, accessible from the menu and the footer. It lets you verify that a signature genuinely comes from Aristhor.

Top

Page 9 / 17

Viewing warranties and warrantors


What is a warranty?

A warranty is an attestation deposited by a third party (the warrantor) regarding a specific block of a blocksthor. It is itself cryptographically signed by the warrantor with their private key and contains: the fingerprint of the warranted block, a "merkle root" fingerprint, the warrantor's signature, the fingerprint of their public key, and the date.

Searching for a block's warrantors

The "Warrantors of a block" page lets you find all the warranties deposited on a given block by selecting a blocksthor and specifying the block number including the warranties.

Reading and interpreting a warranty

FieldDescription
ContentText description of what the warrantor is attesting to.
Fingerprint of the warranted blockFingerprint of the block covered by the warranty.
Merkle rootRoot fingerprint of the Merkle tree of the grouped warranty or warranties.
Warrantor's public key fingerprintOpenPGP identifier of the sibling key of the private key used to sign the warranty.

Verifying the Merkle tree

The Merkle tree makes it possible to prove that a set of elements is referenced and intact, based on a single root fingerprint. Verification is performed in the Blocksthor Maker, "Merkle tree" tab.

Key property: modifying a single element of a Merkle tree invalidates the merkle root, making any tampering immediately detectable.
Top

Page 10 / 17

Information and documents


Browsing notes and news

The "Information" section gathers notes and news published on Aristhor (articles, announcements, tutorials). Each note is presented as a card with a title, date, associated image, content excerpt, and possibly a Pinned.

Associated documents and their preview

Each note can have associated documents. For images (jpg, jpeg, png), a thumbnail preview is shown in the table. Clicking the preview or "View" opens the image in a lightbox. For other file types, the "View" button opens the file in a new tab.

Filtering by category

Notes and documents can be filtered by category using a search form. The "Documents by category" page lists all documents in a given category with their previews.

Sorting and searching

Lists come with a column-sorting system. Contextual filters (category, date, system) are available to refine the results.

Top

Page 11 / 17

The Blocksthor Maker


Accessing and overview of the tool

The Blocksthor Maker runs entirely in your browser, without sending sensitive data to a server. Available sections: New blocksthor, New block, Explore, Fingerprint - Hash, Digital signature, Merkle tree, PGP keys.

Security: never load your private key into the Blocksthor Maker from equipment connected to the Internet if you are using the high security level (AIR GAP).

Creating a new blocksthor

  1. Go to the "New blocksthor" section.
  2. Fill in the genesis block metadata.
  3. Load your private PGP key and enter its password.
  4. Click "Create": the genesis block is signed and the blocksthor is generated in JSON format.
  5. Export the blocksthor to a .txt file to keep it.

Exploring and verifying a blocksthor's integrity

The "Explore" section lets you load a blocksthor file and view its details or verify its integrity by recalculating the fingerprint of each block.

Best practice: verify your blocksthor's integrity every time you retrieve it to add a new block.

Calculating fingerprints and verifying signatures

Calculating fingerprints: the "Fingerprint - Hash" section calculates SHA-512 | SHA-256 | SHA-256d | SHA-1, Blake, etc. fingerprints for any text or file.

Signature verification: provide the original message, the signature, and the signer's public key to verify the validity of a signature.

Part 3: MANAGE

Top

Page 12 / 17

Managing your blocksthor


Creating a blocksthor and importing a .txt file

Go to "My blocksthor" > "Add a blocksthor". Two approaches:

A. Manual creation: enter the name, permanent reference, last block fingerprint, and publication settings.

    B. Import from a .txt file (recommended):
  1. Click "Import the full blocksthor from a file".
  2. Select your .txt file exported from the Blocksthor Maker.
  3. The Blocks, Permanent reference, and Last block fingerprint fields are filled in automatically.
  4. Fill in the name and settings, then click "Save".

Tip: importing a file is the recommended method, as it avoids any manual fingerprint entry errors.

Practical organization of your blocksthor

Selecting and preparing files

  • Only select your important archives: only put the essentials on the blockchain.
  • Reduce file size: for example, use strong JPEG compression for images, since files will need to be stored for a long time and will accumulate.
  • Name files clearly and consistently: use only lowercase letters without accents and underscores (_) for spaces. E.g.: unnomdefichier_39-9B_4C-E5.jpg

Files kept outside the blocksthor folder

If you choose not to group all your "blockchained" files into a single folder and to leave them in your usual storage:

  1. Always add as a suffix the 4 identifiers of your blocksthor and the 4 identifiers of the block (the first 2 and last 2 characters of the fingerprint, separated by a dash), for example: unnomdefichier_39-9B_4C-E5.jpg.
  2. Place a text file with the same name (with a .txt extension) in the blocksthor folder, whose only content is the full file name: unnomdefichier_39-9B_4C-E5.jpg.

This way you will know that this file should be searched for on your equipment rather than in your blocksthor's main folder, which avoids duplicates and doubling your storage needs.

Warning: this method has its advantages, but it complicates portability and regular backup of your blocksthor's single overall folder.

Keeping a log

  • Keep a log such as a spreadsheet matching blocks to files, with keywords and descriptions, for a quick overview and understanding of your blocksthor's contents.
  • Don't aim for perfection: if you forgot a file in a multi-file block, it's not a big deal. Add it alone — or with other forgotten or new files — in a new block that you link to the previous one.

To remember:

A blocksthor's role: a blocksthor is not there to organize your files but to attest to them. What matters is that the file's fingerprint is in the blocksthor and that you can find which file produced that fingerprint. That's the only critical point!

Placing a file's fingerprint several times in different blocks is not a problem, even though it is best avoided. If it is necessary for consistency reasons (to recall that this file belongs with a certain group of files), place a text file acting as a shortcut in the files folder, indicating the block where the file "actually" is for the first time. This avoids unnecessarily growing the overall folder due to duplicates.

Lock / unlock for adding blocks

StateMeaning
AccessibleThe blocksthor is up to date. Users can view or download it normally.
LockedBlocks are being added. The content is not accessible. An estimated unlock date may be indicated.

Editing settings (publication, search, visibility)

  • Search by fingerprint: makes the blocksthor publicly findable by fingerprint.
  • Search by email: lets others find your blocksthor publicly via your email (requires search by fingerprint to be enabled).
  • Public visibility of blocks: displays the full content on the blocksthor's public page.

Publishing the fingerprint to Mastodon

If you have configured a Mastodon access token, the "Publish to Mastodon" button appears on your blocksthor's page. Aristhor then automatically publishes the name, a link to aristhor.com, the permanent reference, the last block fingerprint, and the hashtags #blocksthor #blockchain #aristhor.

Configuration: go to "My account" > "Mastodon - Access token". Generate the token with the write:statuses scope on your Mastodon instance.

Publishing the fingerprint to Telegram

If you have configured a Telegram Chat ID, the "Publish to Telegram" button appears on your blocksthor's page. Aristhor automatically sends a message containing the same information as a Mastodon post.

Configuration: go to "My account" > "Telegram - Chat ID". Enter the ID of the Telegram channel or group you want to publish your fingerprints to.

Publishing the fingerprint to Bluesky

If you have configured a Bluesky handle and an App Password, the "Publish to Bluesky" button appears on your blocksthor's page. Aristhor then automatically publishes the name, a link to aristhor.com, the permanent reference, the last block fingerprint, and the hashtags #blocksthor #blockchain #aristhor.

Configuration: go to "My account" > "Bluesky - Handle" and "Bluesky - App password". A more detailed dedicated guide is available to help you create this App Password.
Automatic publishing: each post to Mastodon, Telegram, or Bluesky automatically creates an entry in your "E & B Publications" section, thereby tracking the complete history of your broadcasts.
Top

Page 13 / 17

Managing a blocksthor's users


Adding a user by email

Only the administrator can invite users. From the "My blocksthor" menu, go to your blocksthor's page, then the "Users" section, enter the new user's email, and click "Add". The user must already have an Aristhor account.

Quota: once the quota is reached, no new users can be added.

Special information

RightDescription
Favorite blocksthorMarks this blocksthor as a favorite for the user.
PseudonymThe user's displayed name within this blocksthor.

Removing a user / leaving

  • Removing a user (administrator only): via the Remove.
  • Leaving (user): via the Leave. button. This action is irreversible unless you are re-invited.
Restriction: the administrator cannot remove themselves from their own blocksthor.

User quota

The quota defines the maximum number of users. This quota depends on the plan subscribed to for blocksthor created from the "My blocksthor" space, and outside of any special agreement.

Top

Page 14 / 17

Managing your public keys


Adding a new public key

  1. Go to "Public keys" > "Add a key".
  2. Enter your key fingerprint (40 characters, OpenPGP format).
  3. Paste or import the armored PGP content of your public key.
  4. Choose the security level [ Normal or High (AIR GAP) ].
  5. Enable the "Searchable by fingerprint" and "Searchable by email" options if desired.

Adding and verifying a signature

From the "Add signature" tab of a key's page: the signer generates, via the Blocksthor Maker, a signed attestation ("clearsign" format) declaring that they have personally verified the link between the key's fingerprint and its identifiers (name, email), then pastes or imports this attestation — the signature code (signer's fingerprint) is then automatically detected from its content. It is automatically verified before being added.

Revoking a key and replacing it

If your private key is compromised or lost, revoke your public key from its edit page. You can indicate the date, the fingerprint of the replacement key, and the reason for revocation. The revocation process takes place in the Blocksthor Maker.

Important: a revoked key remains visible on Aristhor and is clearly marked Revoked.

Exporting your key

The Export button downloads the public key to a .asc file. This file can be shared, loaded into the Blocksthor Maker, or imported into any third-party OpenPGP-compatible software.

Top

Page 15 / 17

Managing your warranties


Creating and finalizing a warranty

  1. In the Blocksthor Maker > "Warranties", load the elements to be warranted.
  2. Calculate the <strong>merkle root</strong> fingerprint of the warranted elements.
  3. Sign the merkle root fingerprint with your private key to obtain the <strong>warranty block</strong>.
  4. Export the warranty block in JSON format.
  5. On Aristhor, create a new warranty by importing the warranty block.

Exporting a warranty and its Merkle tree

  • Exporting the warranty: download the file of grouped warranties in text format.
  • Exporting the Merkle tree: export the JSON file of the complete tree for later verification.

Grouping warranties

Using the Export-Group, button, group several warranties covering the same block into a common Merkle tree. The warranted block is indicated in the call for warrantors.

Usage: grouping is useful when several warrantors have attested to the same block.

Archiving

Warranties can be archived to keep them without showing them in the active list. Archiving is reversible: find archived warranties under "Archived warranties".

Top

Page 16 / 17

My account and settings


Contact details, profile photo, pseudonym

The <em>"My account"</em> page lets you edit: personal contact details (title, first name, last name, email, phone, address), profile photo (jpg, jpeg, png — 2 MB max. — 800×800 px minimum, rendered as a circle), and pseudonym per blocksthor (from rights management).

After selecting a photo file, an instant preview is shown. Click "Save" to confirm the change.

Changing your password

  1. Enter your current password.
  2. Enter your new password (10 to 200 characters).
  3. Confirm by clicking "Save".

The icon lets you show or hide what you type.

Tip: choose a long password (16 characters minimum), combining letters, numbers, and special characters.

Configuring the Mastodon token

  1. On your Mastodon instance: Preferences > Development > New application.
  2. Check only the write:statuses scope and copy the generated token.
  3. Paste it into "My account" > "Mastodon - Access token".

The token is displayed masked (dots) and can be revealed via the icon.

Configuring the Telegram Chat ID

  1. In the Telegram app, add the @userinfobot or @myidbot bot to get your own Chat ID.
  2. To publish to a channel or group: add the Aristhor bot (@AristhorBot) to the target group or channel, then retrieve the group ID using a helper bot (e.g. @getidsbot).
  3. Paste the ID (e.g. -1001234564890) into "My account" > "Telegram - Chat ID".
Format: a Telegram group or channel Chat ID usually starts with -100 followed by digits. A personal Chat ID is a positive integer.

Configuring Bluesky

  1. Enter your Bluesky handle (e.g. aristhor.bsky.social) in "My account" > "Bluesky - Handle".
  2. Generate an App Password in your Bluesky account settings (never your main password).
  3. Paste it into "My account" > "Bluesky - App password".

The App Password is displayed masked (dots) and can be revealed via the icon.

To go further: a more detailed dedicated guide is available to walk you step by step through creating the Bluesky App Password.

Account deletion

Account deletion: immediate and permanent action from "My account" > "My settings".

Warning: deletion is irreversible. Export all your blocksthor and important data before deleting your account.
Top

Page 17 / 17

Anchoring


Principle of anchoring

Anchoring is a mechanism for cross-existence proof between blocksthor. It allows one blocksthor (the host blocksthor) to incorporate the current state of its users' blocksthor into a timestamped Merkle tree, thereby creating a tamper-proof collective fingerprint that certifies and timestamps the existence of each blocksthor at that date.

In practice: if you are a user of a blocksthor that accepts anchoring, you can indicate which blocksthor belonging to you you wish to anchor there. On each configured anchoring day, the system collects the latest block fingerprint of each declared blocksthor and automatically calculates a SHA-256d Merkle tree that groups them all together.

In summary: anchoring proves that, on a given date, the state of your blocksthor was incorporated into a verifiable collective fingerprint derived from a Merkle tree.

Configuring anchoring (host blocksthor administrator)

In your blocksthor's settings (My blocksthor > Edit), the administrator can enable the "Accepted anchors" section and set:

SettingDescription
Accepted anchorsEnables the anchoring feature for this blocksthor. Users will be able to declare a blocksthor to anchor.
Anchoring dayDay of the week on which the Merkle tree calculation is triggered (e.g. Monday).
FrequencyAnchoring pace within the month (e.g. every full week, the first week, etc.).
Tip: choose a fixed, regular day. Users are encouraged to make sure their blocksthor has a new block before that day, so their latest state is as recent as possible.

Declaring my blocksthor to anchor (user)

As a user of a blocksthor that accepts anchoring, go to My blocksthor > View > Users of this blocksthor > You > Information. A "My blocksthor to anchor" field appears: select the blocksthor belonging to you that you want to anchor in this host blocksthor.

Once declared, a reminder appears on the host blocksthor's page:

Reminder: you have anchored your blocksthor MY-SON in this blocksthor ARISTHOR-CLUB.

From the host blocksthor's page, the button, reserved for the host blocksthor's owner, gives you access to the list of anchored users and their latest fingerprints, as well as archived Merkle trees. Anchor,

The anchoring Merkle tree

The Merkle tree is calculated from the latest block fingerprints of each anchored blocksthor. Each leaf of the tree identifies its source blocksthor:

FieldDescription
blockchain_short_uuidShort identifier of the blocksthor (first 2 + last 2 characters of the permanent ref., e.g.: f8-cf))
hashSHA-256d fingerprint of this blocksthor's last block [ my-son ] at the time of anchoring

The Merkle root (merkle_root) summarizes the whole set into a single fingerprint of 64 hexadecimal characters. This value constitutes the synthetic proof of the collective anchoring.

What the tree attests toDetail
ExistenceThe last block fingerprint of each blocksthor was known on the anchoring date
Collective integrityThe Merkle root covers all users anchored that day
Non-repudiationThe tree is archived server-side; any change to a hash would invalidate the root

Each archived tree is exportable as .txt via the Export button. This file constitutes your proof of inclusion in the collective anchoring.

Best practice: systematically export and keep this .txt file after each anchoring. It is your only local proof that your blocksthor was anchored.

Anchoring file naming convention

To easily keep and find anchoring proofs, the recommended convention is as follows. Each anchoring corresponds to a named folder:

NNNN_block-file_anchor_XX-XX

  • NNNN — number of the inserted block, zero-padded to 4 digits (e.g.: 0876)
  • XX-XX — short identifier of the host blocksthor (first 2 + last 2 characters of the permanent ref., e.g.: fd-7d)

This folder contains:

FileDescription
NNNN_merkle_tree_XX-XX.txtThe Merkle tree exported from Aristhor — proof of collective anchoring
NNNN_nom-du-fichier.extThe file(s) inserted in this block (with the same block-number prefix)

Concrete example for block no. 876 of a blocksthor whose short identifier is f8-cf . The fingerprint of this block is inserted into the host blocksthor fd-7d :

0876_block-file_anchor_fd-7d/
    ├── 0876_merkle_tree_fd-7d.txt
    └── 0876_photo-reunion.jpg
Important: never modify the Merkle tree .txt file after export. Its content includes the merkle_root (root fingerprint), which must remain intact for any future verification.

Aristhor Manual — 17 pages — aristhor.com    Back to top