pxt-calliope/docs/projects/micro-coin.md
Sam El-Husseini 7e23340df1
Spellcheck docs (#1652)
* Spelling mistakes
2018-11-20 13:26:26 -08:00

3.7 KiB
Raw Blame History

micro:coin

~ avatar

Have you heard about BitCoin and all those new Crypto currencies? Well micro:bit has micro:coin now!

~

How does a @boardname@ make coins?

Each @boardname@ contains a block chain, a sequence of blocks, that is public and can't be modified. Each block represents a coin. To mine new coins, the user shakes the @boardname@ and, if they are in luck, their coin added to the chain as a new block! Once the block is added, it is broadcasted to the other @boardname@ (the block chain is public and can't be modified so it's ok to share it). Other @boardname@s receive the block, validate the transaction and update their block chain as needed.

Pressing A shows the number of block you added to the chain, that's your score. Pressing B shows you the length of the chain.

Happy mining!

Coins, blocks, chains

A block chain is a list of blocks that record transactions of a crypto-currency like BitCoin. A block might contain information like the time it was created (mined) and who mined it. The most important part of the block is it's hash. This is a special number made from the information in the last block of the block list combined with the hash number of previous block in the list. The new block contains information for the current transaction and this new hash number. The new block is added to the list of previous blocks. This list is then transmitted to the crypto currency network. It's really hard (like impossible) to tamper or forge a hash which allows the block chain to be transmitted publicly.

~ hint

Build yourself a @boardname@ wallet to hold your coins!

~

Code

The code uses blocks from radio-blockchain package.

  • Click on Advanced, then Extensions
  • search for blockchain and add radio-blockchain
// shaking is mining...
input.onGesture(Gesture.Shake, () => {
    led.stopAnimation()
    basic.clearScreen()
    basic.pause(200) // display a short pause
    if (Math.randomRange(0, 2) == 0) { // 30% chances to add a transaction
        // we found a coin!!!
        blockchain.addBlock(1);
        basic.showIcon(IconNames.Diamond);
    } else {
        // missed!
        basic.showIcon(IconNames.Asleep);
    }
})

// show my coins
input.onButtonPressed(Button.A, () => {
    led.stopAnimation()
    let coins = blockchain.valuesFrom(blockchain.id()).length;
    basic.showNumber(coins);
    basic.showString("COINS");
})

// show the block chain size
input.onButtonPressed(Button.B, () => {
    led.stopAnimation()
    basic.showNumber(blockchain.length());
    basic.showString("BLOCKS");
})

// instructions on how to play
basic.showString("A=COINS B=CHAIN SHAKE=MINE")

How does the blockchain code work?

The radio-blockchain package uses radio to transmit blocks between @boardname@s. You can see how this package works by reading the JavaScript sources at https://github.com/microsoft/pxt-radio-blockchain. To go right to the blockchain code, see this file:

main.ts - contains the complete JavaScript source for the blockhain. Have a good read!

References

radio
radio-blockchain=github:Microsoft/pxt-radio-blockchain#v0.1.4