https://github.com/jesusthehun/lisk-bike

Lisk Bike PoC
https://github.com/jesusthehun/lisk-bike

bike-location blockchain lisk lisk-bike lisk-client lisk-sdk react-native sdk

Last synced: 3 months ago
JSON representation

Lisk Bike PoC

• Host: GitHub
• URL: https://github.com/jesusthehun/lisk-bike
• Owner: JesusTheHun
• Created: 2019-08-23T11:58:55.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2023-01-24T00:03:04.000Z (almost 2 years ago)
• Last Synced: 2024-10-14T01:25:38.401Z (3 months ago)
• Topics: bike-location, blockchain, lisk, lisk-bike, lisk-client, lisk-sdk, react-native, sdk
• Language: JavaScript
• Homepage: http://lisk.io
• Size: 2.78 MB
• Stars: 8
• Watchers: 5
• Forks: 2
• Open Issues: 32
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Lisk Bike

## Demo

You can try the mobile app on your device by following this link : https://expo.io/@jesusthehun/lisk-bike.

Download the **Expo Client** app and scan the QR code.

BEFORE YOU USE THE DEMO be aware that it will reveal your real location and store it into the demo blockchain.

If you are in a private location, you might want to use a local blockchain instead.

#### Bike Location Behavior

The bike location is updated when you move with your phone.

Since bike are not visible on the map if they are already rented, you won't see the bike's position updated until you return the bike.

## Development

### Blockchain using Docker

For the first run we have to create the database before we start the node app.

````bash

cd blockchain

docker-compose build

docker-compose up -d psql

docker exec -ti lisk-psql psql -h localhost -U lisk -d postgres -c "CREATE DATABASE lisk_dev OWNER lisk"

docker-compose up -d nodejs

````

Next times you can use `docker-compose start` and `docker-compose stop`

### Create some data

We will create two accounts, one for the company, one for rent.

The accounts will be store in json file in the script directory.

````bash

cd tests && node create-accounts.test.js 

````

We will now create  bikes using the company account.

The default bike location is in Paris, you can of course edit the script to change their default location.

````bash

node create-bikes.test.js ARG

````

### Mobile app

The app has been created with [Expo](https://expo.io/learn).

The blockchain needs to be running.

```bash

cd client && npm i

npm start

```

Scan the QR code with the **Expo Client** app and you are good to go !

## Technical details

### Rent & Return

To ensure consistency and reversability, both rent & return transaction must specify the previous transaction of each.

For example, to rent a bike you must specify the `lastRentTransactionId` and to return the bike you must specify the `lastReturnTransactionId`.

Read scripts for more details, they are pretty straight forward.