Socialuty

Socialuty aims to be a distributed social network: each user can have it's own ”web-pear” (that can host more than one user, anyway), and comunication among pears is made through the socialuty protocol, just in a p2p fashion.

Socialuty will be also the first “web-app” implementation of the pear in php, but ideally anyone could write it's own, even a desktop one, provided she respect the protocol.

This document is about both the protocol spec and the web-app requirements & design, written down while on the job…

Enjoy!

There is no protocol spec for login: each pear can implement its own.

To use the app users must be logged in.

This is done through an html form containing username and password field.
https protocol must be preferred.
Password are stored/sent as MD5 hashes.

users table:

An user can optionally register to the socialuty.org site as to allow people to find her.
Here is the http to the registration page:

POST /register.php HTTP/1.1
host: www.socialuty.org
User-Agent: <useragent>
Content-Type: application/x-www-form-urlencoded
Content-Length: <length>

firstname=[firstname]
&lastname=[lastname]
&country=[country]
&city=[city]
&home=[pear-url]


HTTP/1.1 200 OK
Content-Type: text/xml

<socialuty:response xmlns:socialuty="www.socialuty.org">
    <socialuty:result>
        <code>S_OK</ code>
        <description>welcome</description>
        <details>...</details>
    </socialuty:result>
    <socialuty:data>
        <userid>1234567890</userid>
    </socialuty:data>
</socialuty:response>