Android Docs

SIMBA CarDemo Android Docs


  • Hit the “Clone or Download” button in the upper right corner of the GitHub page

  • Hit the “Download ZIP” button.

  • “Extract the file” with your extractor of choice.

  • Open Android Studio and click “Open an existing Android Studio Project.”

  • Navigate to where the extracted project is and select the project directory of the project (the one that contains the “app” folder) and hit “OK.”

  • After a brief install, Android Studio should open the project.

  • Dependencies

    • This demo app uses the following:

    • Retrofit, okhttp, and gson for GETs and POSTs

    • Web3j, Kethereum, and bitcoinj for the HDwallets

    • Dexter for making permissions easier to handle at run time.



HDwallets are not setup to be encrypted when stored locally. This should be addressed for any usage apart from demo purposes.

Here is a playlist on the SIMBA Chain Youtube channel to get you up to speed on using the dashboard.

Smart Contract

Here is the smart contract I used for Android

contract Application {
function Application() public {}

function carSale (
string soldTo,
string amount,
string _bundleHash
public {}

function registerCar (
string VIN,
string Make,
string Model,
string _bundleHash
public {}

function accidentReport (
string report_name,
string _bundleHash
public {}

Creating an app on the SIMBA Dashboard

Before starting make sure you have an account on the Simba Dashboard and an Ethereum wallet with Ether in it on the Rinkeby testnet

  • Create The Smart Contract
  • Create The Application
  • Configure The Application(Ethereum Blockchain, Rinkeby Network, IPFS Filesystem, Permission disabled)
  • Generate API Key(This is not the API name)


Converting the Cardemo example to your app

  • Updating the URL

    • In ~Line 16

    • In GetActivity.kt ~Line 37 and ~Line 87

    • In DetailActivity.kt ~Line 63

    • In PostActivity.kt ~Line 196 and ~Line 298


    The only part of the URL you need to change is “ioscardemo2” with whatever you chose for your app’s API name(not the name of your apikey)

  • Updating API Key

    • In Methods.kt ~Line 20, ~Line 2, ~Line 30, ~Line 35, and ~Line 41

    • In ~Line 19


© Copyright 2020 Revision 59ccc164.

Built with Sphinx using a theme provided by Read the Docs.