Cakeshop

An integrated development environment and SDK for Ethereum-like ledgers

What is it?

Cakeshop is a set of tools and APIs for working with Ethereum-like ledgers, packaged as a Java web application archive (WAR) that gets you up and running in under 60 seconds.

Included in the package is the geth Ethereum server, a Solidity compiler and all dependencies.

It provides tools for managing a local blockchain node, setting up clusters, exploring the state of the chain, and working with contracts.

Download

Binary packages are available for macOS, Windows, and Linux platforms on the releases page.

Quickstart

Requirements

Java 7+
Java app server (Tomcat, Jetty, etc) [Optional]

Running via Spring Boot

Download WAR file
Run java -jar cakeshop.war
Navigate to http://localhost:8080/cakeshop/

Running via App Server

Download WAR file
Put in /webapps folder of your app server
Add Java system property -Dspring.profiles.active=local to startup script (setenv.sh for tomcat)
Start app server
Navigate to http://localhost:8080/cakeshop/ (default port is usually 8080)

Running via Docker

Run via docker and access UI on http://localhost:8080/cakeshop/

docker run -it -p 8080:8080 jpmc/cakeshop

Running under a specific environment

docker run -it -p 8080:8080 -e JAVA_OPTS="-Dspring.profiles.active=local" jpmc/cakeshop

Note that DAG generation will take time and Cakeshop will not be available until it's complete. If you already have a DAG for epoch 0 in your $HOME/.ethash folder, then you can expose that to your container:

docker run -it -p 8080:8080 -v $HOME/.ethash:/opt/cakeshop/.ethash jpmc/cakeshop

Running with Quorum

This will show you how to quickly setup and connect to the 7nodes Quorum cluster example from the quorum-examples repository. It can be used as a starting point for setting up other integrations.

(requires VirtualBox and Vagrant)

git clone https://github.com/jpmorganchase/quorum-examples.git
cd quorum-examples
vagrant up
vagrant ssh

(in vagrant shell)
vagrant$ cd quorum-examples/7nodes
vagrant$ ./init.sh && ./start.sh

(in host shell)
java -jar cakeshop.war example
java -jar cakeshop.war

At this point you should have Cakeshop running and connected to node 1 in the Quorum cluster (dd1 on RPC port 22000).

You can change the node you're connected to by running the last two commands again from another directory and modifying the properties file at data/local/application.properties to point to a different RPC port in the range 22000-22006 before starting Cakeshop.

Contributing

Thank you for your interest in contributing to Cakeshop!

Cakeshop is built on open source and we fully intend to accept public contributions in the near future. Until then, feel free to file issues and open pull requests, but note that we won't be merging them until the necessary processes are in place.

License

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

 http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

See the LICENSE and THIRD_PARTY files for additional license information.

niklaszantner/cakeshop