Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

OpenTransact-style Ripple server

branch: master

Adding Gemfile.lock to version control. This will allow recovery from…

… bad bundler upgrades and allow everyone to use a known-good version of gems.
latest commit 7bf7986fc6
John Paul Lewicke authored December 06, 2011
Octocat-spinner-32 config Fixed Glassfish daemonization issue. March 06, 2011
Octocat-spinner-32 public Revised deployment script and added files for Romualdo\'s diagrams. December 24, 2010
Octocat-spinner-32 spec User account information now includes a balance field, showing the ne… March 31, 2011
Octocat-spinner-32 .gitignore Adding Gemfile.lock to version control. This will allow recovery from… December 06, 2011
Octocat-spinner-32 Capfile Working on Capistrano deployment. December 14, 2010
Octocat-spinner-32 Gemfile Passwords now hashed using bcrypt. March 28, 2011
Octocat-spinner-32 Gemfile.lock Adding Gemfile.lock to version control. This will allow recovery from… December 06, 2011
Octocat-spinner-32 LICENSE Making progress on reservations. November 19, 2010
Octocat-spinner-32 README.md Working on deployment script ; still can\'t launch Rivulet automatica… December 27, 2010
Octocat-spinner-32 Rakefile RSpec now works. March 18, 2011
Octocat-spinner-32 app_classes.rb Re-adding algo filters and cleaning up old debug statements. March 26, 2011
Octocat-spinner-32 auth.rb Passwords now hashed using bcrypt. March 28, 2011
Octocat-spinner-32 config.ru Working on deployment and documentation. November 19, 2010
Octocat-spinner-32 neo_classes.rb User account information now includes a balance field, showing the ne… March 31, 2011
Octocat-spinner-32 parse.rb Making progress on reservations. November 19, 2010
Octocat-spinner-32 routes.rb Passwords now hashed using bcrypt. March 28, 2011
Octocat-spinner-32 test.rb User account information now includes a balance field, showing the ne… March 31, 2011
Octocat-spinner-32 test_init.rb Passwords now hashed using bcrypt. March 28, 2011
README.md

Rivulet

Rivulet is a simple webservice that allows people to pay each other with IOUs and promises, even if the people making a trade don't know or trust each other. If you want to pay a stranger, it searches both of your social trust networks for a sequence of mutual acquaintances to vouch for you by extension.

Rivulet is a simplified version of Ryan Fugger's Ripple Monetary System. It's intended to be plugged into existing websites, and doesn't support exchange rates, multiple units of account charging interest or demurrage, or ship with much of a user interface.

If you're looking for a simple way for your users to trade babysitting sessions, car rides, books or CDs, or even to replace money, you've found the right github repo.

Benefits and Features

Rivulet allows website developers to quickly add a digital payment system for their users that is trustworthy. Since users set whom they trust, they feel empowered.

Rivulet is hard for people to game: doing sham transactions or setting up sock-puppets doesn't earn them any more trust from other users.

Rivulet is spam-resistant: even if 20,000 spammers set up accounts, they can't steal anything from legitimate users since they'll be disconnected from the main trust network.

Rivulet scales well: it can handle simultaneous requests, find trust paths between people with more than 6 degrees of separation, and handle trust networks with tens of thousands of participants.

Rivulet uses ACID transactions, so payments will either go through completely or not have any affect. Simultaneous attempts to pay with the same IOUs won't end up causing double payments or corruption.

Rivulet is a simple RESTful web service, so it's easy to integrate with your existing website. You can keep your existing interface and integrate Rivulet the way you want to. It's based on OpenTransact, the fledgling spec for simple financial transactions.

Installation

So far, Rivulet has been successfully run on OS X and Ubuntu 10.10/10.4. It should also work well on Linux and on VPS hosting services like Amazon EC2 or Linode.

  1. Install JRuby. (You need this instead of regular Ruby since Rivulet uses the Java graph database Neo4j, and hence runs on the JVM. This also makes Rivulet unsuitable for running on Heroku.)

  2. Download a copy of Rivulet to a working directory using git: git clone https://github.com/jplewicke/rivulet.git

  3. Install bundler: sudo jruby -S gem install bundler If your version of rubygems is not up-to-date, you can run sudo jruby -S gem update. You may need to follow the steps outlined here to update a really old version.

  4. Change directories to the directory that Rivulet was downloaded into.

  5. Install all of Rivulet's other dependencies: sudo jruby -S bundle install

  6. Set up some test data for Rivulet's test suite: jruby -S bundle exec test_init.rb . This will create 500 users(User_0 - User_499) with random credit relationships.

  7. Run the unit tests to make sure that most stuff is working on your system: jruby -S bundle exec test.rb . Since the OpenTransact asset reservations aren't working completely, you should expect the last couple tests to fail.

  8. Start the server: jruby -S bundle exec glassfish

  9. Try Rivulet's client by opening up http://localhost:4567/ in your web browser(only tested on Firefox so far).

Deploying Rivulet to EC2

If you want to run Rivulet on http://aws.amazon.com/ec2/, you can download a copy of Rivulet(steps 1 and 2 above), and then take the following steps to launch your own copy of Rivulet on EC2:

  1. Signup for Amazon Web Services and configure your keys and environment variables the way they describe.

  2. Create a .caprc file in your home directory to store information about passwords and the locations of certain cryptographic keys. Mine looks sort of like this: set :aws_private_key_path, "/Users/jplewicke/.ec2/ec2-keypair" set :password, "sudo_password" set :aws_private_key_name, "ec2-keypair" ssh_options[:keys] = %w(/Users/jplewicke/.ssh/id_rsa)

  3. Make sure you have https://github.com/capistrano/capistrano installed by running cap -V.

  4. Change directories so that you're in the rivulet directory.

  5. Run cap ec2:add_server.

Using Rivulet

If you're trying to get Rivulet talking to another webapp, you'll probably want to reference either routes.rb or test.rb to see some examples of how to communicate with Rivulet from the command line.

Updating Rivulet

You can update your copy of Rivulet's source code by running git pull origin master. Since the Neo4j database schema isn't stable yet, you will want to avoid doing this for anything that modifies neo_classes.rb . I'll be linking to a better guide to contributing patches and such with git as soon as I find one.

License

Rivulet is available under the GNU Affero General Public License, as seen in the LICENSE file. Briefly speaking, this means that if you modify this program, you have to make your changes available to anyone who interacts with it over a network.

If you have a particular application that requires different licensing, please contact John Paul Lewicke at jplewicke@gmail.com . Rivulet uses the graph database Neo4j, which charges licensing fees for use with closed source code.

The JQuery files in public/ contain their own licensing information.

Acknowledgements

Romualdo has helped a ton with testing and wrote an awesome graphical viewer for the current status of credit relationships.

Thanks to Romualdo and Miles for testing Rivulet on their setups, and to Ryan for getting this whole crazy Ripple thing going in the first place.

Something went wrong with that request. Please try again.