Stomra Guides

EikHub · Guide

Signed receipts on EikHub

For each person an issue is sent to, EikHub can give the building a signed receipt of what they received, opened and printed.

An issue is sent, EikHub records what happens for each recipient, signs and time-stamps a receipt, the authoring tool saves it beside the issue, and anyone can check it offline 1 THE ISSUE 2 SENT AND SEEN 3 THE RECEIPT 4 IN THE BUILDING Issue 3 A-101 rev B, A-104 rev B for construction written by the drawing tool A. Recipient, Example AB sent · 09:12 delivered · 09:12 opened · 10:41 viewed A-101 rev B downloaded a print sha256 3f9c…e1 Receipt the issue, by hash the recipient every event signed by EikHub time-stamped drawings/ issues/ issue-3.json issue-3/ receipts/ s-….json saved by the drawing tool, when the project asks for it Anyone checks it later, offline: EikHub's published key + the time-stamp authority's certificate
A receipt is EikHub's signed word about one recipient of one issue. It is kept in the building beside the issue, so it outlives any link or account.

Why a receipt

An issue releases revisions of drawings to people for a purpose: for review, for tender, for construction. Later someone may say "we never got revision B". A portal can show its own log, but that log lives in the portal. A receipt is that record as a file in the building, signed so that it can be checked by anyone, years later, without EikHub.

For someone the issue record does not name, such as a subcontractor a consultant passed it on to, the receipt is the building's only record that they received it at all, and it says who sent it to them.

A receipt is EikHub's word about what it saw. A contract that rests on receipt may also ask for the recipient's own signed word; EikHub's receipt does not replace that.

Sending an issue

The issue itself is written by the drawing tool, such as Stomra, when it issues: it names the revisions, the purpose and the recipients. EikHub sends it.

  1. Open the issue. On the building's Drawings tab, show the drawings as Issues and open one. The page shows what it released, its checks and sign-offs, and every sending of it so far.
  2. Choose the recipients. Pick the people the issue names and give each an address, or add someone else by name and organisation. The address stays on EikHub, for the email only; the receipt names the person, never the address.
  3. Add a note if you want, and press Send.
  4. Keep the links. Each recipient gets an email that says what changed since the revision they last received, with a link that opens without an account for 30 days. The links are shown to you once, under "The links, shown this once."

A sending can be withdrawn per recipient: the link stops at once. A version that holds no issue record can still be sent, but its recipients will have no receipt, and the page says so.

Planning comes before sending: Plan an issue on the Drawings tab chooses the drawings the model has moved on from, with status, purpose, clouds and recipients. EikHub records the plan; the drawing tool issues it.

What EikHub records

For each recipient the issue page shows what has happened, with the time of each:

EventOn the pageWhat happened
sentSentEikHub sent the issue to the recipient.
deliveredDelivered to their mailThe recipient's mail system took the message.
openedOpened the linkThe recipient opened the issue for the first time.
viewedLooked at …They looked at a revision the issue releases; the event says which.
downloadedPrinted … as PDF, or Took …They took a file, such as a print, named by its digest and what it was printed from.
withdrawnLink withdrawnThe sender withdrew the issue from them.
supersededTold that … is replacedA later issue released a newer revision of a drawing they had received, and they were told.

EikHub's prints are the same bytes every time they are made from the same revision, so a print's digest can be checked by anyone who prints it again.

What a receipt holds

Press Receipt beside a recipient to get theirs. It holds:

EikHub signs it with a key it uses for receipts and nothing else, and an independent time-stamp authority dates the signature. A later receipt for the same person holds all the earlier events too; until something new happens, EikHub offers the same file again.

The format is OpenEik's (Part XVIII, Review and issue), so any tool that reads OpenEik can read and check it.

Saving receipts into the building

Receipts go into the building only when the project asks, issue by issue. On an issue's page, press Save the receipts into the building. From then on, the drawing tool saves each recipient's newest receipt beside the issue, at drawings/issues/<issue>/receipts/, when it next publishes the building. EikHub never writes the building itself.

Checking a receipt

A receipt is checked offline, with two things:

Any tool that implements OpenEik can check a receipt, given the host's keys. A receipt changed after signing, or signed outside its key's dates, fails.

Paper on site: the QR check

Every print EikHub makes carries a QR code with its revision's digest. Scan it, or type the digest at eikhub.com/check, and you learn whether that sheet is still current, which revision replaced it, or that the drawing was withdrawn ("Do not build from it"). Whoever holds the sheet learns that and no more; a member of the building who signs in sees when it was issued and what changed.

Personal data

A receipt says when a named person looked at what, so it is personal data. That is why it enters the building only when the project asks for it, why it names people and never their addresses, and why each transmittal email tells the recipient what EikHub records and that the sender may save it into the building.