Skip to content
No description, website, or topics provided.
Branch: master
Clone or download
Latest commit 62b681c May 10, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.vscode Linter Update Sep 30, 2018
ABI kovan/mainnet deploy v0.2.1 - network stake May 2, 2019
config All tests passing. Add revert messages. add plcr tests Mar 26, 2019
migrations Update staking and unstaking for bonds to activate and no need for co… Apr 26, 2019
scripts Compile Script Update Dec 16, 2018
test add tracking variables for bonded stake May 2, 2019
.DS_Store Add constraint to expiration, changed deposit to createBond. Update docs Apr 30, 2019
.babelrc dapploy integrated Oct 30, 2018
.eslintrc Round Tripping Claim in Test Aug 30, 2018
.gitattributes Initial commit Aug 28, 2018
.gitignore All tests passing. Add revert messages. add plcr tests Mar 26, 2019
.snyk fix: .snyk & package.json to reduce vulnerabilities May 9, 2019
.soliumrc.json Allow generic bytes interface on responses from diviners...substantia… Jan 31, 2019
.travis.yml Fix tests on XyBlockProducer and update names Mar 9, 2019 kovan/mainnet deploy v0.2.1 - network stake May 2, 2019
LICENSE Create LICENSE May 10, 2019 proxy test rename and add testing guide in Mar 13, 2019 Update May 7, 2019
index.js Circle CI Sep 29, 2018
package.json fix: .snyk & package.json to reduce vulnerabilities May 9, 2019
truffle.js Change names and change gas limit Apr 9, 2019
yarn.lock pre-mainnet release Apr 30, 2019
zos.kovan.json kovan/mainnet deploy v0.2.1 - network stake May 2, 2019
zos.mainnet.json kovan/mainnet deploy v0.2.1 - network stake May 2, 2019


Build Status Greenkeeper badge David Badge David Badge BCH compliance

The Smart Contract Library for XYO

Made with ❤️ by [XY - The Persistent Company] (

Table of Contents -Sections


Simple Consensus Smart Contract Dapp Library (dapp-scsc-solidity)

Short Description

A Simple Consensus Smart Contract library for all nodes in XYO

Long Description

This package has been built to streamline the dApp build process for anyone ready to integrate XYO into their project. Especially crucial in this library are the XyGovernance and XyStakingConsensus contracts. The XyPayOnDelivery contract is a solid example of the execution of all nodes in XYO, and is used with our Payable on Delivery Demo. The package contains contracts that are upgradeable (with the exception of the Parameterizer) so that you can fix security vulnerabilities and introduce new features without migrating all of the data unecessarily.



  • In the command line go ahead and install using npm
    npx zos link dapp-scsc-solidity
  • Run


  • Familiarity with
    • Solidity
    • Web3
    • Truffle
    • Ganache



  • Watch this video on staking a node in XYO
  • Check out dApper
    • dApper allows you to interact with the smart contracts from the scsc library on the browser


  • Follow the walkthrough below to familiarize yourself with the scsc in the dApper environment. This is a good starting point to understanding how our scsc interacts with XYO.


How to add stake on XYO Diviner

Access our SCSC library through IPFS

use this hash QmaHuJh3u5J4W8WYhJnfH1yZUWWwUaehsVLbUPMEd4ymqN

Then direct your browser to use our dAppper tool

with the hash

The contract will load, giving you access to the contracts through the contract simulator.

Start with the XyERC20Token

Connect your metamask wallet on the Kovan network

Check your balance using the balanceOf() function from the ERC20 contract

Once you have verified that you have enough balance to stake the diviner, select the XyStakingConsensus contract This contract stores all the stake of the network

Approve the stake for the Diviner in the XyERC20 contract (make sure that you have the address for the XyStakingConsensus) using the approve() function.

Go through metamask to submit the transaction. You have now approved stake, let's keep going.

Create a diviner

The diviner is represented by a Stakable token

  • Mint one token with your wallet address by selecting the XyBlockProducer and the address below

  • Select the mint() function and paste your wallet address into the beneficiary field

  • Confirm the transaction on metamask

This will produce one non-fungible token (ERC721). This is unique to this specific diviner.

Then select the tokenByIndex() function and enter 0 for your token address.

Copy the token address, this is virtual id of your diviner

Return to the XyStakingConsensusContract and select its address below

  • Select the stake() function
  • Paste the diviner id into the stakee field
  • enter an amount to stake (make sure it is in your approved limits!)
  • Click execute

You have just successfully added stake to a diviner!

note you are the staker, and the stakingId is the ledger of the stake that you have in the diviner

To check out the data of the stake, select the stakeData() function, paste in the stakingId in the sole field.

You will now get a returned JSON object with your stake amount, the block it was staked on, the staker, and the stakee.




  • Sends a specific value of tokens from your XYO account to another

  • parameters

    • address _to
    • uint256 _value


  • Sends a specific value of tokens from one (not yours) XYO address to another XYO address

  • parameters

    • address _from
    • address _to
    • uint256 _value
  • returns

    • bool success


  • Sets an allowance for tokens for another address check out our staking walkthrough for an example

  • parameters

    • address _spender
    • uint256 _value
  • returns

    • bool success


  • Sets an allowance for tokens for another address with a notification for the other contract

  • parameters

    • address _spender
    • uint _value
    • bytes memory _extraData
  • returns

    • bool success & approval notification with _value and _extraData


  • destroys tokens

  • parameters

    • uint256 _value
  • returns

    • bool success


  • Destroys tokens from another account

  • parameters

    • address _from
    • uint256 _value
  • returns

    • bool success


This contract is used to track ownership of stakable addresses in XYO This contract is upgradeable


  • Allows a contract governor to add and remove a block producer

  • parameters

    • uint stakee
    • bool enable


  • Mints a stakable address with the account has as the token id this emits a transfer event to the sender

  • parameters

    • address beneficiary


  • Burns a token (only a governor can do this)

  • If the token belongs to a block producer, it deletes the token from its listing

  • parameters

    • uint stakee


  • A method to view if a stakee exists

  • parameters

    • uint stakee
  • returns

    • stakee


  • A method to view if a stakee is a block producer

  • parameters

    • uint stakee
  • returns

    • stakee from the blockProducersIndex


  • A method to view the number of block producers

  • returns

    • number of block producers


Manages the stake for multiple clients in a decentralized consensus This contract is upgradeable


  • Returns the latest block submitted on the chain

  • returns

    • uint _latest


  • Withdraw reward balance

  • parameters

    • uint xyoBounty
  • returns

    • uint requestId


  • Escrows eth and XYO to ensure that it covers the answer mining cost

  • Stores the new request in the request pool and emits the submission

  • parameters

    • uint request
    • uint xyoBounty
    • address xyoSender
    • IXyRequester.RequestType requestType


  • Submits a new block at the consensus blockchain, with a verified stake over 51% and returns weiMining for successful creation.

  • parameters

    • uint blockProducer
    • uint previousBlock
    • uint[] memory _requests
    • bytes32 payloadData
    • bytes memory responses
    • address[] memory signers
    • bytes32[] memory sigR
    • bytes32[] memory sigS
    • uint8[] memory sigV
  • returns

    • uint (newBlock)


  • A method to view the number of requests in the consensus block

  • returns

    • requestChain.length


  • A method to view the number of blocks in the consensus chain

  • returns

    • blockChain.length


  • A Payment on delivery contract, check out our Payable On Delivery Demo to see how it works
  • This contract is upgradeable


  • Called by the client to request an intersection question (is the item delivered?)

  • parameters

    • uint requestId
    • uint xyoBounty
    • uint xyoPayOnDelivery
    • uint weiPayOnDelivery
    • address payable beneficiary


  • Called by SCSC, if there is an intersection, executes a transfer to beneficiary and deletes the request from the request pool

  • parameters

    • uint requestId
    • IXyRequester.RequestType
    • bytes memory responseData


  • This contract is called in submitResponse with the request Id and who needs to be paid. In the submitResponse contract that is the beneficiary. This contract is a refunding mechanism that is utilized as a payment mechanism upon successful completion of a request/response.

  • parameters

    • uint requestId
    • address payable payee


  • Gets the number of requests currently in play

  • returns

    • requests.length


  • Kevin Weiler
  • Phillip Lorenzo


If you'd like to contribute to the SCSC as a developer or just run the project from source the directions below should help you get started.

First, clone the repository. And set the branch to the develop branch

  git clone -b develop

Then change working directory to that of the repository

  cd dapp-scsc-solidity

Download dependencies

  yarn install

After installing, go ahead and open in your favorite text editor, ours is Visual Studio Code

 ➜ dapp-scsc-solidity code .

Execute these truffle steps:

Set up a local Ganache instance

ganache-cli --port 8545 --deterministic < if you want to set the networkID --networkId idNumber>

Using the deterministic flag is a good way to keep consistent when in development mode

keep this terminal window open!

In another terminal window (or tab)

Compile the contracts

truffle compile

Migrate the contracts

truffle migrate

You will see transactions for each contract in your Ganache instance and their addressess

Test the contracts

truffle test

Ganache will work again executing transactions while executing the unit tests. Note if you did not compile or migrate, no worries, this command will do that for you.

We recommend testing after any revisions you make to contracts.

If you would like to know more about how the contracts are upgradeable, read the file.

Developer Guide

Developers should conform to git flow workflow. Additionally, we should try to make sure every commit builds. Commit messages should be meaningful serve as a meta history for the repository. Please squash meaningless commits before submitting a pull-request.




Package developed using ZeppelinOS

Made with ❤️ by [XY - The Persistent Company] (

You can’t perform that action at this time.