Read the Docs

See the SIMBA Chain Platform in Action:

Setup Ethereum Wallet

  1. Click button and setup your local Ethereum Wallet

  1. Type in any password you would like to encrypt your wallet in your browser

  1. Hit the wallet icon and reveal the keys, write down your seed for future account recovery

  1. Close the dialog window, scroll down and hit deposit, you will be redirected to Rinkeby Faucet, follow as its instruction

  1. You could logout your account and then recover it with your seed

  1. Check transactions/balance related with this account in 3 public test networks

Create a Smart Contract

  1. Go to smart contract page, hit toggle manual mode button

  1. Copy the snippet below (slashes are not included), the hit the save button at the right-bottom corner

///////////////////////////////////////////////////////////////////
pragma solidity ^0.4.24;
contract CarDealership {
string bundleHash;
function registerCar(string VIN, string Make, string Model, string _bundleHash, bytes32 assetId, bytes32 car) public {}
function accidentReport(string report_name, string assetID, string _bundleHash, bytes32 assetId, bytes32 car) public {}
function carSale(string soldTo, bytes20 amount, string assetID, string _bundleHash, bytes32 assetId, bytes32 car) public {}
}
///////////////////////////////////////////////////////////////////

  1. Give a name (carDemo) and select an organization to save

Configure a DAPP

  1. Go back to application page, hit configure on the app you created, then select blockchain type and network (Ethereum & Rinkeby)

  1. Select filesystem (IPFS default)

  1. Select smart contract you created (carDemo)

  1. Give a name for your api which is used to generated a link for you. So the name is unique, try something different, you might ignore permission at this time

  1. After you hit configure button, you need to unlock your wallet with the password. Notice that id you do not have enough balance, the deployment will stay at pending status forever (failed)

  1. Hit deploy button to finish this application configuration

  1. Waiting for the deployment (it should be 10-20 seconds)

  1. Come back and refresh the page, the app shows deployed

Check Application

  1. Click view button, scroll down and add an api key

Generate an API Key

  1. Add an API name and click Generate Key.

Call Smart Contract Methods

  1. Unlock your wallet to receive method calls.

  1. All method calls.

View All Transactions

  1. View all transactions.

API Endpoints

  1. Go back to application page and hit the api button on the application card, you will see this dialog

  1. Click details button, you will be redirected to the api website where you need authorize yourself with the api key you created at step 23

SIMBA API Webapp

  1. You could check out a webapp built with SIMBA API at github.com/SIMBAChain/CarDemo (Check the code for more details)

  1. Just replace the api name you used at step 17, and replace the api key you created at step 23, then you should be able to run this app locally (suppose you know how to use npm and build VueJs)

  1. Post page

  1. The API you need to post. There are 2 steps.

Take method registerCar as an example, you need post to /newCarDemo/registerCar/ first, then sign the returned message with the local wallet.
Second post goes to /newCarDemo/transaction/{id}/{txn_id}

  1. Get page

  1. Three endpoints to get.

Get with /newCarDemo/registerCar/ to have all records related with registerCar.
Get with /newCarDemo/transcation/{txn_id} to have specific record.
Get with /newCarDemo/transcation/{txn_id}/bundle to have the file attached on this record

Check out the live demo

View Now