WebFunds ZIP Package - Trial

If reading this file within your WebFunds directory, you might like to check the latest version.

Table of Contents


Current Version G3: XX.YY.ZZ: General (Unix, Windows) and also Mac OSX and now, the source :


As a general notice - current servers (issuance, pumphouse, koalagold) are now much more reliable.

1.10.6: Interim release to get some pumphouse client mods out.

1.10.5: Back into internal CVS. Minor release not including much functionality.

1.10.4: (Snapshot release only, not in CVS, not supported.)

As a general notice - current issuance servers are only marginally reliable due to their platforms and net connections.

1.10.3: Update of many minor fixes.

1.10.2: Lots of work in SOX to prepare the ground for Lucaya.

1.10.1: Substantial changes to mailbox flow in support of Rafi's. This release was the a demo Rafi's: it is now usable but this was a tech demo only. (The real real Rafi's is coming in Lucaya...)


Go to History on site for earlier changes or this release History to see details of all prior changes to the WebFunds (G3).

A new fourth generation (G4) rewrite of the WebFunds client, called Lucaya, is available only via CVS.

Getting it Going

General Information

In general, you need a JVM program. See Other Components for more help on Java.

Note that the Unix instructions are the only ones tested at the moment. Use the Unix notes as a guide to getting other platforms working.


. . . Unix
Unzip it

Assuming that you want WebFunds installed in a directory appl, then do something like:

      $ cd appl
      $ unzip /tmp/WebFunds.zip
      $ cd WebFunds
Prepare (once only)

Create runlocal and set the variables as indicated in run. Here's an example:

      export   JDK=/usr/local/jdk1.2.2

The run script looks in the above variables and some well known places. If you find any new places, let us know so we can add them to the list.

You might also need to do:

        $ chmod 755 run

To run WebFunds 3G (the older version) do:

      $ cd appl/WebFunds
      $ ./run

To run Lucaya instead, do:

      $ ./lucaya


OLD, probably out of date.

. . . Mac OSX
Download WebFunds

from WebFunds download directory into a place that is browser-dependant.

Double-Click tgz

Open the '.tgz' that is downloaded by doubleclicking on it. This will open up WebFunds in the same place, and put an Icon there.

Double-click Icon

Double-click on the WebFunds Icon. This will start up WebFunds.

(Note that these instructions should be the same as for any other Mac OSX application.)


OLD, probably out of date.

This version is only for developer access, there is no support for install wizards from WebFunds.org. The download page on the site might include some hints as to where to get user-friendly downloads.

. . . Microsoft
Unzip it

Unzip it somehow, but *preserve* the directories.

Prepare (once only)

Create runlocal.bat by copying runlocal_example.bat and set the variables in there.


Double-click on the [DOS] run PIF file.

Jars List

These JARs need to be available:

  1. Cryptix Jars (includes OpenPGP):
    1. cryptix-jce-api.jar
    2. cryptix-jce-provider.jar
    3. cryptix-openpgp-provider.jar
    4. cryptix-message-api.jar
    5. cryptix-pki-api.jar
  2. Diags: jakarta-log4j.jar
  3. TableLayout.jar
  4. SOX.jar
  5. WebFunds.jar

Check the run* scripts for further hints.


When reporting difficulties, bear in mind:

Other Components

You need these first:


WebFunds works with Java 2 (a.k.a. JDK 1.3 to JDK 1.5). You need a JDK or JRE. WebFunds is expected to work with any of these distributions:

JDK 1.5

Works on FreeBSD.

JDK 1.4

Works on Mac OSX, Linux, Windows platforms.

JDK 1.3

Deprecated. Support is no longer provided for anything less than 1.4. Lucaya will not work.

You have to obtain these from Javasoft or somewhere similar. JRE's should also work. Nobody has reported it as working with any non-Javasoft sourced JVM.

The legacy generation is WebFunds "3G" (third generation). The forward generation is Lucaya (the fourth generation) and that is written for JDK 1.5 (it is hacked to work on 1.4). You should migrate to JDK 1.5 as a matter of routine.

For MacOS

Mac OSX has Java pre-installed, but it may be old (1.3?).

Quick Intro to WebFunds 3G Usage

Setting Up

The distribution includes some contracts, but these are not installed.

Contracts - Lucaya

Select the [Contracts] Tab at the top. The ones already installed will be shown on the left, you can select one, and then use the inner Tabs on the right to examine different aspects of the contracts.

To add a new contract, click on the icon with the big plus and follow the wizard! You can find some contracts on the WebFunds Contracts Repository. Note that these contracts are not issued by WebFunds, and we don't have much to say about how good or bad they are. You have to read them and agree yourself!

Contracts - 3G
To introduce new contracts, hit the [new] button. It should show a browse dialog with some files.

Contracts are files with a .asc suffix. Select one. It will appear on the contracts browser in the main box.

On the main box, left-click (double-click for Macs) on the little icon to open it up Then, right-click (option-click) for a pop-up menu Select [add account].

Enter a name, and wait whilst the keys are generated. Then, you can right-click on the account to bring up the account menu. Select Add Contract and choose one.


In WebFunds you can create as many accounts as you like. One big difference: In 3G the accounts are actually groups of subaccounts, where each subaccount relates to one contract. But in Lucaya, accounts are called Holdings and are tied to one contract, there are no subaccounts.

Accounts - Lucaya

Select the [Holdings] tab at the top. Click on the new Holding icon which looks like a folder with a star. In the wizard, select an instrument (contract) and follow on. You will need to select a name.

Unlimited Transactions

With no money, you can always do two things to test WebFunds:

Try it! Create as much money as you like, but only pay it to yourself :-)

Payments - Lucaya

Select your Holding on the left, and now select the new Payment and Payment settle icons. Create a payment of any amount, cut and paste it into the [Deposit] box and click.

This form of payment can be sent to anyone in email. (Note - there is no integration between Lucaya outwards to Pumphouse or to 3G at the moment. To be added.)

Click on the [Transactions] tab to see the status.

Payments - 3G

To create a payment, right-click on the contract within the account. On the menu, select payment.

A payment dialog pops up, you can enter a 0 amount, then hit Make Payment. The written payment can be sent by mail to another person with WebFunds.

When you settle (deposit) a payment from another user, WebFunds asks you for a name for this other user's account.


When you have exchanged a payment with someone else, WebFunds Lucaya will provide an alpha version of secure SOX chat (this is called Rafi's as a project name). You will now be able to send a secure chat message to your payment counterparty.

To find the payment, go to the [Holdings] tab and select a a Holding. Go to the [Transactions] tab and select a transaction that was exchanged with the person you wanted to talk to.

When you select a settled payment with someone else (not a self-payment), the Chat icon will come alive. Click on it and try a chat session.

Note that Rafi's Chat is very alpha. The chat messages go out via the Ricardo Issuance Server for that contract using datagrams. It takes a while to initiate - like 3-10 minutes (short term version issue). There is no 'presence' so you won't know if anyone is online.

But smileys work and that's the main thing for serious ecommerce.



If WebFunds reports that it cannot get through to the servers, it may be that your firewall is blocking outward connections. WebFunds uses HTTP protocols, but is directed to non-HTTP ports by the servers. This is the "correct" thing to do, but may in future also attempt to communicate on the HTTP port 80 in order to bypass firewall checks.

To use the WebFunds 3G proxy feature, pass these arguments on the command line:

             -ph host -pp port   -save true

These arguments will be interpreted as Java properties settings, and if the latter pair is added, will be saved for future use.

Or, check with your administrator to see if outward connections get blocked to higher-number ports.

Sun Unlimited Strength Policy Bug

If WebFunds throws exceptions that appear to be coming from the crypto code, it may be that the Sun Unlimited Strength Cryptography Policy Files are not installed in Java.

This is a bug with Sun's Java, and there is a limit to that which the WebFunds team can do to fix this. WebFunds code has already been re-routed to minimise the effect of this bug. In the event that this bug still interferes with your program, here is the basic methodology, with some caveats, for fixing this bug in your installation of Java.

Go to the Sun Java site and search for the Unlimited Strength Cryptography Policy Files . Or, use google, which knows better. Download them and install them as per the instructions found there.

Beware that Sun does not ship these files within any Java distribution, and nor permit them to be shipped or otherwise supplied. Further, the files are deprecated and removed from Sun's site for any version that is about a year old (beyond support date). The upshot of this is that the Sun JCE architecture is no longer supported by Sun for practical usage of cryptography in commercial applications.


Activity is now stored in History on site for latest changes or release History to see details of all changes prior to this release.

Copyright © 1999-2004 Systemics Inc. All rights reserved.