QuickGatewayKit, a web-kit made for creating Ripple Gateways and Cryptocurrency Exchanges
Clone or download
Pull request Compare This branch is 237 commits ahead of verekia:master.
whotooktwarden Create index.html
For github.io creating index.html.
Latest commit 7ce02ca Aug 5, 2017
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
css Added modernizr, bootstrap, jquery, a main css file, and removed defa… Jun 16, 2015
docs Create setup_fedora-23.txt Mar 18, 2016
img Removed unused image Feb 1, 2012
js Added modernizr, bootstrap, jquery, a main css file, and removed defa… Jun 16, 2015
rippleapi Update getXRPETHxagate.php May 14, 2016
singlepage Add file to .gitignore Mar 17, 2016
HOWTO-RIPPLE-REST.md Rename RIPPLE-REST-HOWTO.md to HOWTO-RIPPLE-REST.md Jul 23, 2015
LICENSE.html Rename LICENSE.HTML to LICENSE.html Jul 16, 2015
README.md Update README.md Mar 17, 2016
README_IPN_FILES.md Updating web-kit with examples for usage with rippled-sign-submit pac… Dec 23, 2015
TODO.txt minor adjustments to setup.sh. addition of TODO.txt Aug 16, 2015
backupindex.html Create backupindex.html Jul 19, 2017
btcipn.php Updating web-kit with examples for usage with rippled-sign-submit pac… Dec 23, 2015
completed.php Update completed.php Mar 2, 2016
config.php Adding initial commit for Roast Coins front-end statistics Feb 20, 2016
deposit.php Security update Sep 11, 2015
ethipn.php Updating web-kit with examples for usage with rippled-sign-submit pac… Dec 23, 2015
fetch.php Update fetch.php May 14, 2016
footer.php Fixed footer error. Mar 15, 2016
full_index.php Update full_index.php Mar 2, 2016
get_crypto_symbol_by_external_address.php Update get_crypto_symbol_by_external_address.php Mar 2, 2016
get_external_address_by_timestamp.php Update get_external_address_by_timestamp.php Mar 2, 2016
get_transactions_by_blockhash.php Create get_transactions_by_blockhash.php Mar 4, 2016
get_transactions_by_external_address.php Update get_transactions_by_external_address.php Mar 2, 2016
get_transactions_by_txid.php Create get_transactions_by_txid.php Mar 4, 2016
header.php Added single page site template. Mar 15, 2016
include.php Update include.php Mar 15, 2016
index.html Create index.html Aug 5, 2017
index.php Fixed footer error. Mar 15, 2016
irba.php Update irba.php Aug 11, 2015
ltcipn.php Updating web-kit with examples for usage with rippled-sign-submit pac… Dec 23, 2015
nxtipn.php Updating web-kit with examples for usage with rippled-sign-submit pac… Dec 23, 2015
onepage.php Added single page site template. Mar 15, 2016
pending.php Update pending.php Mar 2, 2016
products.php Update products.php Aug 11, 2015
rcindex.php Update rcindex.php Mar 4, 2016
ripple_servers.md Add missing files. Mar 15, 2016
server_backup.sh Create server_backup.sh May 18, 2016
setup.sh Create setup.sh Mar 17, 2016
setup_tables.sh Create setup_tables.sh Aug 5, 2015
tables.php Create Tables dynamically Jul 22, 2015
test_sql.sh Create test_sql.sh Aug 5, 2015
tos.php Add missing files. Mar 15, 2016
tpl.php Update tpl.php Aug 11, 2015
withdraw.php Security update Sep 11, 2015
withdrawals.php Update withdrawals.php Aug 11, 2015
xd.php Security update Sep 11, 2015
xdeposit.php Update xdeposit.php Aug 11, 2015
xw.php Security update Sep 11, 2015
xwithdraw.php Update xwithdraw.php Aug 11, 2015
yd.php Security update Sep 11, 2015
ydeposit.php Update ydeposit.php Aug 11, 2015
yw.php Security update Sep 11, 2015
ywithdraw.php Update ywithdraw.php Aug 11, 2015

README.md

QuickGatewayKit

QuickGatewayKit

  1. Preamble

    QuickGatewayKit was produced in most part with Initializr. Many thanks and praise for http://www.initializr.com/ and Jonathan Verrecchia!! Many thanks and praise to the twbs/bootstrap team!!

    This web-kit is offered AS IS and WITHOUT WARRANTY. This web-kit is released under Creative Commons. See http://www.quickgatewaykit.org and refer to the demo site's footer for more details about this license.

    QuickGatewayKit was first authored on May 11, 2015 by Taylor Warden.

    QGK was created for interested developers to begin a Ripple-based business. QGK is being created with modularity in mind, so each step of development will not only further the long-term development roadmap, but allow developers different options through the variety of features which will be implemented with each version this web-kit releases. QGK is being created for developers of services for the Ripple protocol in mind, however, a secondary focus is this web-kit should be easily modified to allow for a Cryptocurrency Exchange to be created, with QGK being used as a resource for getting started.

    The development team of the QuickGatewayKit has joined forces with RoastBeefSandwhichCo who is working in collaboration with the QGK to provide a back-end service which will immediately replace gatewayd. The repository will be able to optionally support GWD once it has been fixed (read: overhauled) in the future. The Roast Coins interface will allow developers to automate inbound and outbound cryptocurrency settlement using the Ripple Consensus Ledger or their own propriertary implementation.

    Please do your own due diligence when developing a Ripple business, such as a Gateway. You must do your own research and contact relevent Government regulatory bodies within your country in writing with the final version of your Terms of Service before you conduct any business.

    It is VERY much suggested that before you continue any further to consult all of the Ripple Whitepapers found @ https://forum.ripple.com/viewtopic.php?t=4301

    I, TAYLOR WARDEN, HEREBY CLAIM NO RESPONSIBILITY THEREIN FOR ANY INDIVIDUAL, INDIVIDUALS, ENTITY, OR ENTITIES THAT MAY RECEIVE LEGAL ACTION, DIRECTLY OR INDIRECTLY, FOR THE USAGE OF THIS OR ANY PORTION OF THESE DOCUMENTS, IN PART OR IN FULL.
    IN THE CASE OF A CIVIL LAWSUIT BEING ISSUED REGARDING THE USAGE OF THESE MATERIALS, THE RESULTING LAWSUIT WILL BE HEARD FROM WITHIN A COURT OF ONTARIO, CANADA.

    1. TABLE OF CONTENTS

    2. Preamble

    3. Table of Contents

    4. Getting Started

    5. Editing the Front-end

    6. Editing the Back-end

    7. You now have a Mock Gateway!

    8. Donations

    9. Join the Ripple Community

    10. Consultation, Technical Writing, and more upon request

    The contents of this web-kit include the following:

    index.php: It is the home page of your Gateway website. The default deposit action is linked to this page via deposit.php

    tpl.php: this is your template file that you can copy, rename, and edit for a new page.

    tos.php: this is an extremely basic Terms of Service template. You ABSOLUTELY MUST have registered a LEGAL BUSINESS within your legal jurisidiction BEFORE YOU CONDUCT BUSINESS as a Ripple Gateway.
    If you have problems with writing your terms, hire a lawyer or consult twarden on the Official Ripple forums for the possibility of consulting or further resources.

    deposit.php: the script that processes the asset offered by default on index.php.

    withdrawals.php: the page to fill out a form to process a withdrawal notification via withdraw.php.

    xdeposit.php: the page for a dedicated deposit form for a second option.
    Processed via xd.php

    xwithdraw.php: the page for a dedicated withdrawal form for a second option.
    Processed via xw.php

    ydeposit.php: the page for a dedicated deposit form for a second option.
    Processed via xd.php

    ywithdraw.php: the page for a dedicated withdrawal form for a second option.
    Processed via xw.php

    1. Getting Started

    By now, you should have read the Ripple Whitepapers, know of how legal it is to operate a Gateway in your legal jurisdictionn, and have an idea of what you would like to offer to the Ripple network.

If your server is a freshly installed Ubuntu 14.04 LTS deployment, perform the following tasks
as root or as a user with sudo access.  QGK is tested on this distro and Debian 8.1 Jessie.

Copy and paste into the following sources.list file these respositories:

deb http://download.webmin.com/download/repository sarge contrib 

deb http://webmin.mirror.somersettechsolutions.co.uk/repository sarge contrib

Run sudo nano /etc/apt/sources.list, navigate to the bottom of the document
and paste the repository URLs at the bottom of the file.  Commit changes and exit.

Navigate to the QGK directory and run sh setup.sh.  This will update your system and install
software packages this webkit and your web server will require to operate.  

    Next, open index.php.  Read the document entirely an replace the lorem ipsum text with
    your business information.  When editing the form on this page, change XXXamount
    and XXX Amount to the default asset ticket for your Gateway.
    
    4.  Editing the Front-end
    
    When you have figured out your service fees for the IOUs your Gateway issues, edit the 
    remaining pages: xdeposit.php, ydeposit.php xwithdraw.php, and ywithdraw.php.
    
    Once you have completed that, you are nearly half way there.  Now, you must
    complete your Terms of Service.  A template to get you started is found within
    tos.php.

    include.php will replicate information such as the Gateway's name, operator's name,
as well as allow for you to manage accepted assets and their estimated delivery times.

header.php will replicate the menu bar hyperlinks across all pages.

footer.php will replicate the Terms of Service link, copyright notice, and license
across all pages.

In the event you would prefer a single page site layout, copy the javascript and css from the
singlepage directory and use the onepage.php template in lieu of index.php and tpl.php.  Find and
replace asset1-assest3 for your default assets and follow the below instructions for further back-end
set-up.

    5.  Editing the Back-end
    
    xd.php, xw.php, yd.php, yw.php, deposit.php, and withdraw.php are all back-end
    PHP scripts which process a deposit notification for the Gateway operator to process.
   
    Replace XXXamount and XXX amount with the proper asset codes.
    
    Index.php links to deposit.php
    Withdrawals.php links to withdraw.php
    xdeposit.php links to xd.php
    xwithdraw.php links to xw.php
    ydeposit.php links to yd.php
    ywithdraw.php links to yw.php
    
Follow the instructions found in the Roast Coins repository
https://github.com/RoastBeefSandwichCo/Roast-Coins
and be sure to edit config.php with your RC database
details for access to statistics of your Roast Coins installation provided in
rcindex.php.
    
    6.  You now have a Mock Gateway!  
    
    Now is the time to advertise your site and start market making over Ripple.  Now is the 
    time to network with other developers, market makers, and marketers in the industry
    to build your business!
    
    7.  Donations
    
    Please consider donating a small amount of XRP or Bitcoin to:
    https://www.bountysource.com/teams/qgk
    
    for the continued development of this web-kit if this resource 
    was helpful for starting your Ripple-based or Cryptocurrency Exchange business.
   
   8.  Join the Ripple Community!
   
   Join us at the official Ripple forums!  https://forum.ripple.com/

9. Consultation, Technical Writing, and more available upon request

If you or your business require consultation, technical writing, or require a block or ledgerchain solution,
please write to taylor at xagate dot com.