SmartHoldem GateWay

App in development process now..

Gateway for exchanges, stores, services etc

This application provides full interaction with SmartHoldem (STH) BlockChain with RPC-JSON

Features:

• Receipt of payments (+)
• Validate Addresses (+)
• Sending payments (+)
• Generate user addresses (+)
• Alert service about new payment (+)
• Payment statistics (+)
• Integration with others BlockChain platforms (~)
• BIP39 (+)
• BIP44 (~)
• BIP32 (~)
• Invoices
• Logs sth.log (+)

Requirements

• NodeJs 8.x+
• SmartHoldem Node-A (optional) https://github.com/smartholdem/smartholdem-node-a

Install

cd smartholdem-gateway
npm install -g npm forever grunt-cli
npm install

Settings

mv sample.config.json config.json
nano config.json

{
  "app": {
    "port": 3000, // Default App port
    "localhostOnly": false,
    "appKey": "Your_Uniq_Any_Private_Random_Password",
    "debug": false,
    "backups": true
  },
  "smartholdem": {
    "preferredNode": "127.0.0.1", // SmartHoldem Node IP-Address
    "masterAddress": "", // Main STH-Address
    "masterKey": "", // Main STH-Address Pass Phrase
    "salt": "", // required to generate internal addresses
    "consolidateOnMasterAddress": true,
    "confirmations": 10,
    "blocks": 6, // the number of processed blocks
    "minAmount": 10
  },
  "callbacks": {
    "sendCallback": false, // notify about incoming transactions external service
    "password": "1234567890", // external service password
    "alertTxUrl": "http://yourWebSite.com/newtx" // web service url
  }
}

Run

As daemon background process:

sh restart.sh

As debug console:

npm start

Stop process

sh stop.sh

View Logs

tail -f ./sth.log

API

Get STH Address

A new address will be created if not found in the database.

GET http://localhost:3000/api/getaddress/username

return address json

{
  "addr": "SWE5yaoYZbKKn6n6SXBur3gceetUJTR1yk"
}

Validate Address

GET http://localhost:3000/api/validate/SWE5yaoYZbKKn6n6SXBur3gceetUJTR1yk

Get New STH Address BIP39

BIP39 Addresses are not saved to the database.

GET http://localhost:3000/api/getnewaddress/bip39

return json

{
  "address": "SWkELwTqgUrfQ81DfKRbk6q7UXYrvzZgQb",
  "passphrase": "thought love copper tag image trigger swamp warm flee crunch input direct",
  "pubkey": "02c61c9c01ca0852690c793989b99c084b82a6287ece6045c1b64ee4a7d4daac0d"
}

Backup GateWay Database

POST http://localhost:3000/api/db/backup
-H "accept: application/json"
-H "appkey: YourAppKey"

Backup saved to /backup/backupjson.log.gz

for more examples see tests/test-backup.js

Send STH to address from Master-Address

Send STH from Master-Address

POST http://localhost:3000/api/sendtoaddress
-H "accept: application/json"
-H "appkey: YourAppKey"
-d "{'recipient': '<RecipientAddress>', 'amount': 1.00}"

for more examples see tests/test-sendtoaddress.js

{
    success: true,
    transactionIds:
        ['1ac9f2b8527a8076b4d81d71f0706e045d3e50a7be97fa4a41d729fd48a54831']
}

SendFrom

Send STH from custom address

POST http://localhost:3000/api/sendfrom
-H "accept: application/json"
-H "appkey: YourAppKey"
-d "{'passphrase':'<AddressPassPhrase>','recipient': '<RecipientAddress>', 'amount': 1.00}"

return json result

{
    success: true,
    transactionIds:
        ['1ac9f2b8527a8076b4d81d71f0706e045d3e50a7be97fa4a41d729fd48a54831']
}

Reports Tx Out

Get a list of outgoing transactions

GET http://localhost:3000/api/reports/txout

return json

Reports Tx In Wait

Get a list of pending incoming transactions

GET http://localhost:3000/api/reports/txinwait

return json

Reports Tx In Success

Get a list of success incoming transactions

GET http://localhost:3000/api/reports/txinsuccess

return json

IMPORTANT NOTE

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.