Skip to content
Old v1 repo, please see now.
Java Perl JavaScript C CSS Python Other
Find file
Failed to load latest commit information.
Mu @ 3bd7403
c added sha1 hashing and bucketing of 'see' strings
erlang @ 5d45d0e Added erlang submodule
ezcrypto-js @ 1342d04
java Fix spelling of its vs it's in source and documentation.
node-sqlite @ 409251a added more shizit
org forgot to merge the last change, fixed
perl Fix spelling of its vs it's in source and documentation.
python Started on a Python telehash implementation.
.gitignore ignore stuff
.gitmodules Added erlang submodule
LICENSE a few fixes to to make fwds actually work, and some utility… finally deprecating this mostly v1 repo, adding pointers to new locat…

This is the old/depreicated v1 repo, all of the work since 2013 is now located at

TeleHash - Distributed JSON -

  • org/ contents (all docs so far)
  • perl/ test implementations and utils in Perl
  • c/ basic test stuff in C
  • ruby/ rudimentary testing in Ruby
  • erlang/ basic announcer in erlang
  • switchd/ plans to create a utility daemon to do the dirty work
  • diag/ graffle/diagrams of protocol states

What tech does one need to implement a switch?

  • UDP
  • JSON
  • SHA1
  • XOR'ing the 160 bits of a SHA1 hash
  • handling both network events and timers (and possibly interactions with the "app" it's serving)

What does a switch need to do?

- listen for UDP packets (off a random port)
- send something to an initial seed to discover its public IP:PORT
- announce itself and try to discover other switches nearby to it
- maintain the "lines" it has active with any other switches
    - validate sender/status
    - track bytes sent/received
- answer requests for nearby switches
- accept "taps" from other switches
- match incoming signals against any active taps and forward them
- that's plenty :) 
Something went wrong with that request. Please try again.