Broker Setup

From Bittylicious
Jump to navigation Jump to search

Offers

Bank Details

Here, you are required to enter all information required in order for a buyer to pay you. The position field corresponds to the position in which this will be displayed, from low to high.

Example information would be

Position Heading Information
10 Sort code 123456
20 Account number 72498324
30 Account name Mr. J Bloggs
40 Bank name Halifax

SSL keys

Linux Instructions

  1. Install openssl using your package manager
  2. Run openssl genrsa 4096 > private.key and keep this key private
  3. Also run openssl rsa -pubout < private.key > public.key and send us public.key via email to admin@bittylicious.com.

Mac OS X Instructions

  1. Install openssl
  2. Run openssl genrsa -out private.key 4096 and keep this key private
  3. Also run openssl rsa -in private.key -pubout > publickey.pem and send us publickey.pem. This can be done by typing cat publickey.pem.

Windows Instructions

There are two ways to do this. The first is to use our preprepared batch file to generate everything for you, and the second is to do things manually.

Automatic (using the Bittylicious Client)

  1. Download Openssl from [1]. Select the first option Complete package, except sources
  2. Run the downloaded file and install openssl-(version)-setup.exe
  3. Download and run our batch file bittykey.bat
  4. Send public.key, which will have opened up automatically, to admin@bittylicious.com

Manual

  1. Download Openssl from [2]. Select the first option Complete package, except sources
  2. Run the downloaded file and install openssl-(version)-setup.exe
  3. Run cmd.exe from the Start/Run menu and navigate to the a directory that you own. For example, for your desktop, something like cd C:\Users\Username\Desktop would work, where Username is your Windows username.
  4. Run the OpenSSL binary to generate your key. Running a command like "C:\Program Files (x86)\GnuWin32\bin\openssl.exe" genrsa 4096 > private.key typically works. You might need to remove the ' (x86)' portion depending on your version of Windows.
  5. Run the following command to create public.key: "C:\Program Files (x86)\GnuWin32\bin\openssl.exe" rsa -pubout < private.key > public.key
  6. The files are placed in your Desktop directory, i.e. C:\Users\Username\Desktop so you can retrieve them with Windows Explorer.

Signing trades

In order to accept any trades, whether automatically or manually, you need to sign a message using your private key. The reason for this is that no Bitcoins can be sent without you explicitly authorising them. Even if the main Bittylicious server gets compromised, the service that sends the Bitcoins will refuse to send them unless a message is signed using your private key.

The original software uses PHP so follow the instructions below to use it. The exact command line arguments to run are provided on the page for each trade, but feel free to see if you get suitable output by running sign.php 1 1 1.

If you have trouble getting PHP working, we do have a web/Javascript-based signer that should work on any modern web browser, and this might be particularly useful on the move. It keeps all key information on your local device so should be safe to use.

Click here to download the software: Media:Sign.zip.

Windows PHP Instructions

  • Download the latest PHP installer from PHP.net and run it. You need to download a version with Installer in the title. At the time of writing, only PHP 5.3 has this available. It doesn't matter whether you use the Thread safe or Non thread safe version.
  • On the Web Server Setup page, click Do not setup a web server.
  • On the Choose Items to Install page, ensure that Script Executable is selected as Entire feature will be installed on local hard drive. Leave all other settings as their defaults - do not install everything.
  • If you used the batch file in the OpenSSL section:
    • Run cmd from the start menu
    • Type cd %UserProfile%\Desktop\Bittylicious
    • Type php sign.php 1 1 1 to test the program.
  • If you did not use the batch file in the OpenSSL section:
    • Extract sign.php from the download above to a suitable location.
    • Run cmd from the start menu.
    • cd to the location that you extracted sign.php to.
    • Type php sign.php 1 1 1 to test the program.

If, when running php, you get the error 'php' is not recognized as an internal or external command, operable program or batch file. then the PHP installer probably did not correctly change your Windows path. To change this manually yourself, do the following:

  • In the start menu, run the Edit the system environment variables program.
  • Click on Environment Variables...' in the bottom left.
  • Find Variable Path in the System Variables box in the lower half of the windows.
  • Click on this variable so it is highlighted blue and then click Edit...'
  • In the Variable value: box, add the text C:\Program Files (x86)\PHP\; on the leftmost side. This means the text box will probably look like C:\Program Files (x86)\PHP\;%SystemRoot etc. Do not forget the semicolon - this is important.
  • Click OK in all the windows to exit the System Properties window.
  • Try and run php again.

Linux PHP Instructions

  • Install php using your package manager, e.g. apt-get install php

Javascript Instructions (Beta)

Access this over the Internet on the Bittylicious site.

Note that we strongly recommend you download this to be run locally in case our web site ever becomes compromised and you inadvertently give away your private key.