Protocol guide

version 0.4, English translation

Introduction

The aim of the TerraCommuni protocol is to enable anyone on the planet, even without an Internet connection, to prove that they wished, at a specific time and place, to be sent digital messages to the messaging ID of their choice. Put another way, the TerraCommuni protocol allows anyone to say “I’m present here and now, and I can be contacted at this phone number or e-mail address”.

The aim of the TerraCommuni project is to be able to contact people located anywhere on the planet, to enter into a relationship with them, consult them (polls, votes, discussions, etc.) or send them digital resources (cryptocurrency, content, etc.) while knowing how many people can be reached at each registered number or address.

In this way, TerraCommuni can be used to distribute 100 euros in crypto-currency to each pre-registered person in any area of the planet. This could be useful, for example, to pay out individual financial aid if the area has been hit by a disaster caused by climate drift caused by over-consumption in wealthier countries, by an earthquake or by conflict.

Individual roles

The protocol assumes that its contributors play one of three roles:

  1. The ceremony organizer gathers the participants in a place of his choice and at a specific time, takes video and photos of them, and publishes these videos and photos scrupulously following the present protocol;

  2. The participant is photographed and videotaped with an identifier that enables a message to be sent to him or her (e.g. telephone number or e-mail address), in full compliance with the requirements of this protocol;

  3. The partner subsequently designates the geographical area of its choice, selects the most recent ceremonies that comply with the protocol in this area, and gives the participants thus selected access to a digital asset; for example, cryptocurrency, voting rights in a remote consultation, rights to respond to a survey, or access rights to a computer application.

Ceremony compliance criteria

To comply with protocol, a ceremony must meet all the following conditions to the best of its ability:

  • Criteria #1, video and photographic evidence: the ceremony must include at least one video and one photo; it may include several.

  • Criteria #2, unity of location: all videos and photos of the ceremony are taken in the same place (a few meters or tens of meters apart at most).

  • Criteria #3, unity of time: all ceremony videos and photos are taken at the same time (a few minutes or tens of minutes apart at most).

  • Criteria #4, unity of action: on the video showing all the participants, they all actively demonstrate, without leaving any room for reasonable doubt, their consent and intention to publicly take part in the ceremony; for example, the organizer asks the participants out loud: “Are we together in Paris, France, on Wednesday May 24, 2023?” and the participants reply “Yes, we are together! “Then the organizer asks them: “Are we together for this TerraCommuni public ceremony?” and the participants reply in unison “Yes, we are together!”; conversely, this is not a photo or video taken in the middle of a crowd, without their knowledge, in a public place, pretending that the people in the crowd are all taking part in the ceremony.

  • Criteria #5, a background recognizable by satellite: All videos and photos show large objects in the background that can be recognized without too much difficulty on public satellite images of the location; for example, landmarks that are easily recognizable via a service such as Google Earth; for example, a famous building or one with remarkable architecture, a soccer field, a stadium, a remarkable tree in this location, a road junction, an industrial structure (a large chimney, a pylon, large pipes, a factory, …), the estuary of a river, a pond, a characteristic mountain or lake, …

  • Criteria #6, with all the participants: on at least one of the videos and at least one of the photos, you can clearly distinguish and count all the participants in the ceremony; but some photos or videos may show only a subset of these participants; for example, a photo of a sub-group to get a closer look.

  • Criteria #7, visibly real and alive: on the video, you can see that all the participants are real, living people; for example, they make a hand gesture, or you can see and hear them waving, making noise, talking, singing or dancing.

  • Criteria #8, ceremonies simultaneous in time but distant in space: the ceremony takes place at the same time as the nearest ceremonies, but is far enough away from the nearest ceremonies; indeed, no one can be in two places at once; if the nearest ceremony takes place at the same time, no participant has time to reach it before the end to take part in both ceremonies; thus, participants are counted only once; so partners can trust the ceremonies to send each person an equal share per person of digital resources (cryptocurrency, access or voting rights, etc.). ); for partners to place their trust in the ceremony, the organizer and participants had better coordinate with neighboring organizers and participants so that the ceremonies are simultaneous but sufficiently far apart;

  • Criteria #9, identifiers: In all the videos and photos of the ceremony, some (or all) of the participants can be seen holding a piece of paper on which is handwritten and clearly legible one and only one messaging identifier, such as a telephone number or e-mail address;

  • Criteria #10, the word TerraCommuni on each paper: above the identifier, the participant handwrites the word “TerraCommuni” and, if possible, also draws the logo.

  • Criteria #11, one paper per identifier: Each identifier appears on the paper of one and only one participant in the ceremony. Two participants cannot hold the same ID.

  • Criteria #12, shared identifiers: Participants who do not hold an identifier are implicitly identified by one of the identifiers held by one of the other participants; this can be referred to as a shared identifier.

  • Criteria #13, several participants per identifier: On the identifier paper, just below the identifier, the number of participants identified by this identifier (shared identifier) is handwritten and clearly legible; for example “8 people” if this identifier identifies its holder and 7 other participants.

  • Criteria #14, only one participant per identifier: If a number of people is not entered under an identifier, this means that the identifier identifies only the participant holding it, and no other participant.

  • Criteria #15, an accurate count: If we count the total number of participants identified by the identifiers (by adding the number of people indicated on the papers held in hand), then we must not arrive at a total greater than the number of participants visible on the video and on the photo of the complete group.

  • Criteria #16, clearly legible identifiers and numbers: On the video, all identifiers and the numbers of people they identify are clearly legible;

  • Criteria #17, the ceremony sheet: the video also shows the following clearly legible, handwritten information on a sheet of paper held in the hand of one of the participants:

  • The TC logo and the name in handwriting

  • The organizer’s identifier (telephone number or e-mail address)

  • The longitude and latitude of the ceremony location (with at least 4 digits after the decimal point);

  • Date and local time of ceremony start (to the nearest 10 minutes);

  • The number (or “height”) of a block very recently added to the Ethereum blockchain, as recently as possible at the time of the ceremony start (the latest blocks added, their number and hash can be accessed via a blockchain explorer website such as https://etherscan.io/blocks, https://blockchair.com/ethereum/blocks#, https://beaconcha.in/blocks or https://www.blockchain.com/explorer/blocks/eth).

  • The first 6 characters of this block’s hash, preceded by “0x” and possibly followed by “…”; for example: “0xa14b0c…”.

  • Criteria #18, the shadow of a vertical object on the ground: The video and at least one of the photos must show the solar shadow cast on horizontal ground (not on a slope) by a large vertical object such as a vertical post, the corner of a building, a wire held vertically by one of the participants or, at worst, the shadow of people standing upright.

  • Criteria #19, an azimuth recognizable by satellite: The video and photo showing the shadow cast on the ground must enable the direction of this shadow to be identified later, using a satellite view, and therefore both the location of the object casting its shadow and the location of another object towards which this shadow points; For example, the pole must have a location that is remarkable from a satellite view (in front of a large gate or at the corner of a street), and the shadow of the pole must clearly point towards a building, a street corner or a tree that is also remarkable; in this way, the azimuth of the sun at the time of the ceremony can be measured on the satellite view, and the accuracy of the time and place of the ceremony can be verified by geodesic calculation;

  • Criteria #20, a suspended wire: At least one video and one photo show a wire suspended vertically between the thumb and forefinger of one of the participants; for example, a telephone charger weighted down by its block, or a string weighted down by a stone.

  • Criteria #21, the shadow of the thumb and forefinger: in this video and photo, we can clearly see the sun’s shadow cast by the thumb and forefinger; for example, on a sheet of white paper or light-coloured fabric.

  • Criteria #22, equal distance from the wire and the wire’s shadow: The fingers and the shadow of the participant’s fingers must be at equal distance from the camera, i.e. the fingers must be neither in front of nor behind their shadow, in relation to the camera; to achieve this, the photographer must position himself so that the sun is neither in front of nor behind him, but exactly on his left, exactly above him, exactly on his right, or exactly on the curve that connects these three points in the sky ; this is the only way to measure the angle of elevation of the sun with sufficient precision (how many degrees from the zenith or horizon), and to verify the accuracy of the time and place of the ceremony by geodesic calculation.

  • Criteria #23, rapid publication of the ceremony: All videos and photos and main data of the ceremony are published as quickly as possible on a website that stamps the publication with a reliable and unalterable indication of the date and time of publication; this website thus attests to the end time of the ceremony; for example, the ceremony is published on https://terracommuni.org/page/ceremony_new and timestamped by the site (or, even better, via an Ethereum transaction contained the IPFS hash of the ceremony files and data) ; main data of the ceremony includes longitude, latitude, date, time, block number, block hash and identifier of the organizer and their assistant.

  • Criteria #24, data subsequently added by the organizer: Certain data can be filled in by the organizer within a reasonable time (a few hours to a few days) after publication; this data includes the version of the TerraCommuni protocol to which this ceremony claims to conform and the identifiers of all participants and the number of participants identified by each identifier.

Ongoing considerations

The following are additions or modifications to the protocol that are under consideration for a future version.

Data in JSON format

A future version of the protocol could include the following condition:

  • Data in JSON format: ceremony data is accessible in JSON format with the following fields: version, organizer, latitude, longitude, date, time, block_number, block_hash, identifiers; identifiers is a list of key-value pairs (a JavaScript object) whose key designates a participant identifier and whose value represents the number of participants identified by this identifier.

Notices

A later version of the protocol could include the following condition:

  • Notices: each ceremony can receive notices published by any Internet user about its compliance with the protocol; a notice includes a general compliance score (0 if the ceremony is considered completely non-compliant, 1, 2, 3 or 4 for intermediate levels of compliance, 5 if the ceremony is considered compliant with all the conditions of the protocol), a supporting text and a list of the conditions of the protocol to which this ceremony would not be compliant.

Alternative for shadows

All the conditions relating to shadows aim to make the azimuth and elevation of the sun measurable during the ceremony. Perhaps there’s a simpler way of estimating the sun’s azimuth and elevation than photographing the shadow cast on the ground and the shadow cast on the sheet. Perhaps a simpler solution could be found by placing the sun in the camera’s field of view with a number of judiciously positioned markers, to create a sort of navigational sextant. In this case, however, we need to be able to :

  • we need to be able to estimate the angle of elevation of the sun in relation to the horizontal; to do this, all you have to do is take a selfie with the sun exactly behind you, provided that, on the one hand, the arm holding the phone is straight and the image of your eyes on the screen is exactly aligned with the horizon, and that, on the other hand, your second arm is stretched vertically towards the zenith (like a zealous student raising his finger to ask the teacher to answer) and that, finally, you are standing either strictly in profile (like a bullfighter facing the bull) or strictly facing the phone;

  • we can estimate the sun’s azimuth; for this, all we need is for the sun to be aligned with a very distant landmark such as the top of a mountain, the end of a road, a building that can be seen but is more than a kilometer away, etc.; or for two closer topographical landmarks (two posts, a post and the corner of a building, a tree and a gate 20 metres apart, etc.) to be aligned with each other and with the sun.

Is it simpler and more practical than shadows from the pole and wire? Is it more reliable and accurate? We’d have to try.

For example, in the photo below, if the sun were at palm level, then it would be at about 45° elevation above the horizon. And if distant topographical landmarks were visible in the background, the sun’s azimuth could also be estimated.

Frequently asked questions

(to be completed)

  • Question 1?

  • answer

  • Question 2 ?

  • answer

Video and photo examples

The photographs below are taken from tests of earlier versions of the protocol, in which ceremonies were performed individually rather than with group videos and photos. They continue to be useful, however, to illustrate some of the requirements of the current version of the protocol, and to give practical advice to ceremony organizers on how to ensure that their ceremony complies as closely as possible with the protocol, thereby earning the trust of donors.

Example of a ceremony photo and video (above, clickable photo to access the associated video): this photo of the very first TerraCommuni ceremony prototype allows you to compare the azimuth of people’s shadows on the photograph (or linked video) and on the suncalc.org geodesic calculation site; the background buildings, the orientation of the roads and the shape of the triangular median on which the participants stand is easily verifiable on the satellite view.

Example of a shadow cast on the ground (above): the lamppost is located on a median strip at the end of a series of parking spaces; its location can be identified on the Google Maps satellite view; its shadow is cast on the ground as far as the end of the 5th white strip of the parking lot; this end can be identified on the satellite view; the shadow of the lamppost could therefore be drawn on the satellite view and, as the latter is oriented towards North, the azimuth of the shadow and therefore that of the sun could be measured.

Example of the shadow of the fingers holding the thread (above): we can easily measure the angle between the wire of the phone charger and the straight line that would join the top of the wire and its shadow on the sheet of paper; the sun is located almost exactly to the left of the photographer, so the distance between the participant’s index finger and the camera is equal to the distance between the shadow of the index finger and the camera ; if we analyze the photo more precisely, we see that the shadow of the wire is located slightly further from the camera than the wire itself is; to meet the condition more precisely, the photographer would have had to take 1 or 2 chassé steps to the right so that the sun would not be located slightly behind him but exactly to his left.

Example of shadows cast on the ground (above): in the photo, the shadow of the pole appears to point towards the fence visible in the background on the right; according to the suncalc.org website, at the time and place the photo was taken, the sun was indeed casting shadows in this direction, so the declaration of ceremony location, date and time is credible.

Example of background landmarks (above): these two photos were taken at the same location, but the one on the right shows more background landmarks easily recognizable on a satellite view than the one on the right, including a soccer pitch and, in the distance, a nearby mine tower.

Example of shadows (above): in the photo, the angle between the vertical wire and the shadow of the fingers holding the wire can be measured, but the sheet of paper is set back from the fingers because the photographer is not ideally positioned; he should have positioned himself so that the sun was not behind him, but rather exactly to his left ; as for the shadow cast on the ground by the person, or by the post, which appears to be located to the right of the person (to the left of the photographer), it seems almost parallel to the wall, and we can therefore easily estimate its azimuth if we manage to locate this wall on the satellite view (which proved easy in this case).

Example of shadows (above): the pole’s location is easy to spot on a satellite view: near the gate, between the hedge and the road; the direction of its shadow is relatively easy to plot on the satellite image (shadow almost parallel to the hedge, i.e. azimuth barely differing by a few degrees of angle); the angle between the vertical wire and the projection of the shadow of the fingers is clearly visible, but the photographer is not in the ideal position to measure it; he should have shifted 3 or 4 steps to the left so that the sun was not slightly in front of him but exactly to his left.

Example of shadows and background markers (above): the exact location of the pole isn’t very easy to spot on a satellite view of this location, because in these 3 photos you can just see that it’s close to the wall, but not exactly where it is along the wall; his shadow is parallel to the wall, so the azimuth of the sun is equal to the azimuth of the wall, which is ideal; in the left-hand photo, the photographer is almost in front of the participant, but the sun is slightly behind him, so it’s not perfect for measuring the angle between the wire and the projection of the shadow of the fingers; in the middle photo, the situation is worse, because the sun is clearly behind the photographer and, consequently, the shadow of the fingers is clearly set back from the fingers themselves and, consequently, the angle measurable on the photograph between the image of the vertical wire and the image of the shadow of the fingers is clearly less than the angle actually formed (in 3 dimensions) between the wire and the sunbeam casting the shadow of the fingers; in the photo on the right, the sun is almost exactly behind the photographer and the shadow of the fingers is therefore located behind the fingers; consequently, the angle between the vertical wire and the projection of the shadow of the fingers is not measurable in the photo on the right; but the photo in the middle, and even more so the one on the right, have a big advantage: they feature numerous landmarks in the background, easily recognizable on a satellite image (mainly the road and the building opposite).

Example of the location of the vertical object (above): compared with the 3 previous photos, taken during the same ceremony, this one provides important additional information: the pole is located close to this gate.

Example of a shadow near midday (above): in the middle of the day, shadows are shorter and therefore their direction is more difficult to plot on a satellite view to estimate the sun’s azimuth, but on the other hand, the sun’s elevation is easier to estimate because the angle between the vertical and the projection of the shadow of the fingers is almost zero.

Example of erroneous coordinates (above): this photo is interesting for several reasons: the latitude and longitude shown in the photo are those detected by the smartphone in use at the time the photo was taken; however, the satellite view of these coordinates doesn’t identify any of the buildings in the background, so it’s impossible to estimate the azimuth of the shadow of the person and the pole; this is caused by the phone indicating the wrong latitude and longitude; it would probably have been necessary to wait 1 or 2 minutes before taking the photo for the phone to detect its real GPS position; or it would have been necessary to take several photos so that many background landmarks would have been visible and recognizable by satellite, and so that the last shots would have given the smartphone time to correct its coordinates; this problem could also be due to a faulty phone (slow or faulty GPS); to limit this risk of GPS error, the ceremony organizer could have located in advance, on a Google Maps map, the latitude and longitude coordinates of the place where the ceremony would then take place; moreover, the sun is located exactly behind the photographer and, consequently, the angle visible on the photograph, between the vertical wire and the projection of the shadow of the fingers, is very small, even though the photograph was taken at the end of the day, with the sun relatively low on the horizon; the photographer would have had to make a quarter-turn around the participant to place the sun exactly on his left or right; this would have enabled him to photograph the entire angle formed between the vertical wire and the sunbeam casting the shadow of the fingers on the sheet of paper.