Aum's I2P SAM Resources

WTF is 'SAM'?

SAM - Simple Anonymous Messaging - is a protocol that allows I2P applications (including server, client and peer2peer applications) to access the I2P network via a simple protocol over an unencrypted TCP socket, within a local machine or LAN.

An implementation of this protocol, as a standalone .jar file for the server, and a python library for the client, is available below.

This first cut of i2psam only supports SESSION, RAW, DATAGRAM and DEST messages so far, with no special options. Stream support, and extensive option support, is coming later.

Interested persons are warmly encouraged to port the SAM client library to other languages, such as C/C++, Perl, Ruby... (java programmers need not bother, because you can already link directly into the I2P messaging and streaming APIs).

Please note that the SAM API presently requires existing internet apps to be modified in respect of their networking back-end. However, there is scope for 'shimming' techniques (eg a socket lib replacement in the style of tsocks) which could allow any application to talk over I2P without modification.

Gimme!

Download Full Package (includes SAM Server standalone jar file, plus python client API and demo) - i2psam-0.1.0.tar.gz
View SAM Server and Client API Documentation
View SAM Server source code (written in Jython)
View SAM Client API plus demo source code (written in pure Python)

The Big Picture

David McNab

Last modified: Tue Apr 6 21:13:00 NZST 2004