@organigram/blockly-solidity
v0.1.1
Published
Solidity language generator for Google Blockly graphical language.
Downloads
4
Readme
Solidity for Blockly
About
This projects goal is to add support for the Solidity language (the main language used to create smart contracts for the Ethereum blockchain) in the Blockly visual programming tool.
Motivations
I see a lot of articles here and there stating that the blockchain makes it possible to build decentralized communities. Those articles are completely oblivious to the fact that even if smart contracts execution is indeed enforced by a decentralized blockchain network, those contracts are still written by actual developers.
Taking into account that "code is law", the ability to actually write smart contracts becomes a new logical SPOF. No true decentralized community will ever exist as long as the production of its code (its "laws") is not accessible to just any of its members.
Thus, the need to make it easier to create, distribute and run smart contracts with as less technical skills as possible. Blockly being an initiative to introduce programming to children, it felt like the right way to start experimenting.
Use with NPM
Blockly Solidity adds its generator in the Blockly.Solidity namespace, and its blocks in Blockly.Blocks.
npm install --save blockly blockly-solidity
- ES6 (React, Meteor, Vue, Angular)
// Blockly import * as Blockly from 'blockly/core' import 'blockly/blocks' // Solidity generator and blocks. import 'blockly-solidity' // Or separately. import 'blockly-solidity/solidity' import 'blockly-solidity/blocks'
- CommonJS (Node)
// Blockly var Blockly = require('blockly/core') require('blockly/blocks') // Solidity generator and blocks. require('blockly-solidity') // Or separately. require('blockly-solidity/solidity') require('blockly-solidity/blocks')
- Unpkg (Browser)
<!-- Blockly --> <script src="//unpkg.com/blockly/core.js"></script> <script src="//unpkg.com/blockly/blocks.js"></script> <!-- Solidity generator and blocks. --> <script src="//unpkg.com/blockly-solidity"></script> <!-- Separately. --> <script src="//unpkg.com/blockly-solidity/solidity.js"></script> <script src="//unpkg.com/blockly-solidity/blocks.js"></script>
Development
mkdir www && cd www
git clone https://github.com/google/blockly.git
git clone https://github.com/promethe42/blockly-solidity.git
python -m SimpleHTTPServer
Then open http://localhost in your favorite web browser.
Features
- support for the
bool
,int
anduint
types - smart contract states, constructor and methods
- declaration, read and assignation of contract states
- declaration and read of method parameters
- math operators
+
,-
,/
,x
if then else
control structures- scopes for contract states and method parameters
- type-safe state assignations
- state/method parameters name & type refactoring
I'm guessing other features (such as loops and more complex math/logical expressions) might work, but I didn't have enough time to test them.
Todo
- variables
- scoped variables
- compile the generated Solidity code
- one-button deployment of the compiled contract
Example
This Blockly program:
will generate the following Solidity code:
pragma solidity ^0.4.2;
contract Counter {
uint counter = 0;
uint max = 0;
function () { throw; }
function Counter(uint max) {
this.max = max;
this.counter = 0;
}
function increment(this.counter = this.counter + 1;) {
if (this.counter >= this.max) {
this.counter = 0;
}
}
}