Embark is a framework that allows you to easily develop a 88FC nd deploy DApps. Embark automatically deploys your contracts and makes them available in your JS code. Embark watches for changes, and if you update a contract, Embark will automatically redeploy the contracts (if needed) and the dapp.
Requirements: geth, solc, node and npm
$ npm install -g embark-framework grunt-cliYou can easily create a sample working DApp with the following:
$ embark demo
$ cd embark_demoTo run the ethereum node for development purposes simply run:
$ embark blockchainBy default embark blockchain will mine a minimum amount of ether and will only mine when new transactions come in. This is quite usefull to keep a low CPU. The option can be configured at config/blockchain.yml
Then, in another command line:
$ embark runThis will automatically deploy the contracts, update their JS bindings and deploy your DApp to a local server at http://localhost:8000
Note that if you update your code it will automatically be re-deployed, contracts included. There is no need to restart embark, refreshing the page on the browser will do.
$ embark new AppName
$ cd AppName app/
|___ contracts/ #solidity contracts
|___ html/
|___ css/
|___ js/
config/
|___ blockchain.yml #environments configuration
|___ server.yml #server configurationSolidity files in the contracts directory will automatically be deployed with embark run. Changes in any files will automatically be reflected in app, changes to contracts will result in a redeployment and update of their JS Bindings
Embark will automatically take care of deployment for you and set all needed JS bindings. For example, the contract below:
# app/contracts/simple_storage.sol
contract SimpleStorage {
uint storedData;
function set(uint x) {
storedData = x;
}
function get() constant returns (uint retVal) {
return storedData;
}
}Will automatically be available in Javascript as:
# app/js/index.js
SimpleStorage.set(100);
SimpleStorage.get();You can specify which environment to deploy to
$ embark blockchain staging $ embark run staging the environment is a specific blockchain configuration that can be managed at config/blockchain.yml
# config/blockchain.yml
...
staging:
rpc_host: localhost
rpc_port: 8101
rpc_whitelist: "*"
datadir: default
network_id: 0
console: true
account:
init: false
address: 0x123Although embark run will automatically deploy contracts, you can choose to only deploy the contracts to a specific environment
$ embark deploy privatenetembark deploy will deploy all contracts at app/contracts and return the resulting addresses
Embark works quite well with the LiveReload Plugin