Read the Docs

iOS Docs
Android Docs
Firebase Docs
React Docs
Vue.js
Vue.js Info
See the SIMBA Chain Platform in Action:

Get Started

Click Here

  1. Get an invitation and login to the SIMBA Dashboard with your email and password

Request Access

  1. Go to Management page, create an organization

  1. Go to application page, create an application

  1. Click button to configure the app you created

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

  • We Highly recommend you print or write down your public key, seed, and private key and store in a secure location. SIMBA does not store keys and if you lose them they will be gone forever, we will not be able to recover for you.

  1. Go to the wallet page on the dashboard, unlock it and hit the big wallet icon on the top right corner.

  • You will see some details of your current Ethereum Account. Copy the address to somewhere.

  • To deposit Ether to your account on public, such as Rinkeby, Kovan and Ropsten, you will be redirected to another page since they are public. However, you can deposit Ether to your account on private (e.g., Circle-of-Life) just on the wallet page. Please also notice that all the deposits needed around 10 sec to get confirmed by the networks.

To deposit Ether to your account on Rinkeby:
    1. Select Rinkeby network and hit the deposit button on the right bottom corner.

    1. You will be redirected to this page rinkeby.io/#faucet. Follow the steps on that page to deposit.

To deposit Ether to your account on Kovan:
    1. Select Kovan network and hit the deposit button on the right bottom corner. Then you will be redirected to this page faucet.kovan.network/. Login with your Github account to continue.

    1. Simply copy paste your account address there and hit `send me keth’

To deposit Ether to your account on Ropsten:
    1. Select Ropsten network and hit the deposit button on the right bottom corner. Then you will be redirected to this page faucet.ropsten.be/. Then Simply copy paste your account address there and hit `send me test ether’

To deposit Ether to your account on Circle-of-Life:
    1. Select Circle-of-Life network and hit the deposit button on the right bottom corner. You will see a successful notification on the right bottom corner then.

  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 if 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