martin/DecentraSanta
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Added an explanation to the front page

Browse Source
This commit is contained in:
Martin Asprusten 2025-04-20 19:01:25 +02:00
parent e38628cbc6
commit 343cd24095
3 changed files with 61 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
WebServer/static/style.css
View File

@ -37,3 +37,7 @@ textarea {
height: 20vh; height: 20vh;
font-size: 20px; font-size: 20px;
} }
.leftjust {
text-align: left;
}

11
WebServer/templates/exchange.html
View File

@ -8,19 +8,28 @@
</head> </head>
<body> <body>
<h1>Santa exchange</h1> <h1>Santa exchange</h1>
<p id="santaexchangename">This santa exchange is named: </p>
<button onclick="copyLinkToClipboard();">Copy link to clipboard</button><br /><br /><br />
<p>Status:</p>
<pre id="statusParagraph"></pre>
<label for="own_name">Your name: </label><br /><input type="text" id="own_name" /><br /> <label for="own_name">Your name: </label><br /><input type="text" id="own_name" /><br />
<br /> <br />
<label for="info_for_santa">Info for your santa (e.g. shipping address or similar):</label><br /> <label for="info_for_santa">Info for your santa (e.g. shipping address or similar):</label><br />
<textarea id="info_for_santa"></textarea><br /> <textarea id="info_for_santa"></textarea><br />
<button id="submit_info_button" onclick="submitInfo();">Submit your info</button> <button id="submit_info_button" onclick="submitInfo();">Submit your info</button>
<br /><br /><br /> <br /><br /><br />
<pre id="statusParagraph"></pre>
<button id="start_exchange_button" onclick="submitStart();">Start with current participants</button> <button id="start_exchange_button" onclick="submitStart();">Start with current participants</button>
<p>Current participants:</p> <p>Current participants:</p>
<ul id='participantList'> <ul id='participantList'>
</ul> </ul>
<script type="text/javascript"> <script type="text/javascript">
document.getElementById('santaexchangename').innerHTML += window.location.pathname.substring(1);
function copyLinkToClipboard() {
navigator.clipboard.writeText(window.location.href);
}
const socket = io(); const socket = io();
const client_id = Math.floor(Math.random() * 2**64) const client_id = Math.floor(Math.random() * 2**64)

51
WebServer/templates/index.html
View File

@ -9,10 +9,11 @@
<body> <body>
<div class="bodyDiv"> <div class="bodyDiv">
<h1>DecentraSanta</h1> <h1>DecentraSanta</h1>
<p>Welcome to the decentralised secret santa exchange. This website uses cryptography to distribute secret santas <p>
in such a way that no one but you, not even the server the communication goes through, can know who you're Welcome to the decentralised secret santa exchange. This website uses cryptography to distribute secret
giving a santas in such a way that no one but you, not even the server the communication goes through, can know who
gift to.</p> you're giving a gift to.
</p>
<p>You can either start a new secret santa exchange, or join an existing one.</p> <p>You can either start a new secret santa exchange, or join an existing one.</p>
@ -23,6 +24,48 @@
<input type="text" id="existing_address" /> <input type="text" id="existing_address" />
<br/> <br/>
<button id="join_existing" onclick="onJoinExchange();">Join existing exchange</button> <button id="join_existing" onclick="onJoinExchange();">Join existing exchange</button>
<br /><br /><br /><br />
<p>
<b>
WARNING: I have partially rolled my own crypto for this project. Please don't use it for anything serious!
</b>
</p>
<p class="leftjust">
How does this work: the simplified analogy is that we build a deck of cards numbered from 1 up to the number
of participants. This deck is shuffled, and each participant draws a card. The cards determine the secret
santa order: The participant who draws card 1 is the secret santa for the participant who draws card 2, who
is secret santa for the participant who draws card 3, and so forth.
</p>
<p>
In this analogy, once the participants have drawn their cards, they each anonymously put up a mailbox that
is marked with number of the card they drew. Each participant then puts their name and address (secretly)
into the mailbox with the number of their secret santa. Finally, they secretly open their mailboxes to find
the name and address of the recipient of their gifts.
</p>
<p>
More technically: the shuffling and drawing of the cards is done using the
<a href="https://people.csail.mit.edu/rivest/pubs/SRA81.pdf">mental poker algorithm described by Shamir,
Rivest, and Adleman.</a> This algorithm depends on a commutative encryption algorithm. Here, I have used the
SRA algorithm, which is a modification of the RSA algorithm where the modulus used to encrypt and decrypt
values is public, but the both the encryption and decryption keys are kept private. I couldn't find any
Python libraries that implement this algorithm, so I have implemented it on my own. I make no guarantees
that this is secure in any way.
</p>
<p>
In the analogy above, the mailboxes represent public key cryptography. It is possible to anonymously announce
a participant's public key using the same mental poker algorithm from above: each participant publishes a
"card" containing, in encrypted form, their public key and the card number they drew in the previous step.
Each other participant then encrypts this card with their own key. Once all the cards have been encrypted
in this way, each participant then removes their key, shuffles the deck, and applies a new key (which should
make it impossible to correlate cards before and after shuffling). Finally, each participant removes their
key from each of the cards. This should give a deck of cards containing participant numbers and public keys,
shuffled in such a way that it is impossible to know which card originated from which participant.
</p>
<p>
Finally, each participant publishes their name and address, encrypted so that only their secret santa can read
it. Each participant must then try to decrypt all of these encrypted messages until their gift receiver is found.
</p>
<p><a href="https://gitea.martinserver.no/martin/DecentraSanta">The source code for this web site can be found here!</a></p>
</div> </div>
<script type="text/javascript"> <script type="text/javascript">