SLA to Offload Spectrum Sensing - to other nodes to increase efficiency of devices utilizing cognitive radio

Forked from https://arxiv.org/abs/1703.04502

1. Install TruffleJS
2. Install Ganache - run a local Ethereum blockchain to run tests, execute commands, and inspect state
3. Install NodeJS > version 9

1. start Ganache
2. In a new Terminal window, run:
3. cd "project download directory where truffle.js lives"
4. truffle compile
5. truffle migrate (this will 'connect' to your local instance of Ethereum (Ganache), utilizing the dev settings in truffle.js)
6. truffle test
7. truffle exec js/simulation.js

7. npm install
8. truffle exec js/simulation.js

The config of the simulation.js is in lines ~17-33.

Loquat:sla-solidity milean$ truffle exec js/simulation.js
Using network 'development'.

Starting with owner:
0x627306090abab3a6e1400e9345bc60c78a8bef57
Starting with helpers:
[ '0xf17f52151ebef6c7334fad080c5704d77216b732',
'0xc5fdf4076b8f3a5357c5e395ab970b5b54098fef' ]
Starting with sensing_band 10 bandwidth_granularity 100 costPerRound 1000000000000000000
newSensingService()
got new SensingService contract at 0xf2beae25b23f0ccdd234410354cb42d08ed54981
increasing funds for sensingContract from owner's account

set interval to run at 2000
Connection successful
Requesting node: default
Running round 0
events:
NewRoundCreated
RoundCompleted
NotifyUsersToValidate
IncrementedAmountOwed
... Payout
Amount owed withdrawn: 5000000000000000000 from helper 0xf17f52151ebef6c7334fad080c5704d77216b732
Payout
Amount owed withdrawn: 11000000000000000000 from helper 0xc5fdf4076b8f3a5357c5e395ab970b5b54098fef
{ round_index: 11,
helpers:
{ '0xf17f52151ebef6c7334fad080c5704d77216b732': { gasUsed: 1233808, times_cheated: 6 },
'0xc5fdf4076b8f3a5357c5e395ab970b5b54098fef': { gasUsed: 1209540, times_cheated: 0 } },
su: { gasUsed: 276936 },
... ^C

Contracts are like objects in the Object-Oriented Programming paradigm. Every time a contract is deployed by the developers, the code for the classes in OOP are deployed in the Ethereum network. In contracts, every time a user wants to set up spectrum sensing offloading, a new Contract is created with the secondary user and set of Helpers, using the code stored on the Ethereum network. Whenever any interaction is done with the contract, such as calling a method, a new "transaction" is generated.

Contracts are stored on the blockchain (database) as "Executable code", and other people can interact with it, depending on their role. This is what happens when you call 'truffle migrate', it moves the code onto the blockchain specified in the config (truffle.js)

1. Extract the folder containing the matlab codes.
2. Make sure all the files are extracted in the same location.

1. Open the mat file 'Simulation2.m'. This is the source mat file with calls to different functions.
2. Set the 'mc_index' to desired value to obtain required number of monte carlo iterations.
3. Set the 'transition_probabilities' under the '%% Randomize PU Activity with Markov Chains' section to obtain different PU activity scenarios. The probability matrix is defined as [1|1 0|1 ; 1|0 0|0] .So, for example , low PU activity of 10% ON would be [0.1 0.9 ;0.1 0.9].
4. Click on 'RUN'.
5. The simulation results(5 plots) are generated after sometime.

1. There are totally 9 mat files (1 source and 8 functions) - Simulation2 (source) , validate, validate_majority, evaluate, evaluate_majority, collision, collision_majority, collision_probability and lost_opp.
2. Comments are provided within the source file for easy readability purposes.
3. Functions validate/validate_majority - It computes the average result of helper matrices to determine the PU activity state. evaluate/evaluate_majority - It evaluates the presence of cheaters and identifies them in a 'cheating record' matrix. collision/collision_majority - It computes the no. of collisions of SU with PU. collision_probability - It computes the ratio (no_collisions) / (no_tx_attempts + no_collisions) to determine the probability of collisions when SU is transmitting. Lost_opp -It computes the TX opportunities lost by SU when PU activity is 0.