A crucible is a decentralized commitment contract designed to encourage self-improvement through the use of economic and phycological incentives like loss aversion, accountability, and peer pressure.
This project is the core of the Crucible smart contract that lives on the ethereum blockchain. Included in this repo is:
- the Foundry contract for initiating and registering instances of new Crucibles
- the Crucible contract code
- extensive tests for all the above
Getting Started (development)
This contract is very low level. This repo contains everything one needs to make changes, test, and deploy those underlying contracts. You can see how to interact with it from the tests, however, this is not ideal. To interact with this contract directly, we recommend using one of the following client libraries:
npm install -g firstname.lastname@example.org npm install -g ganache-cli npm install -g zos git clone email@example.com:godsflaw/crucible.git cd crucible npm install
to compile, deploy, and test contracts
npm run deploy && npm test
spin up in docker container
docker build -t godsflaw/crucible:<BRANCH> . docker run -p 8545:8545 godsflaw/crucible:<BRANCH>
version bump before PR is merged to dev
You need to update the version in package.json, then run the following:
Make sure you verify the diff, commit, and push all changes to your PR.
hopping between environments easily
If you have the vault containers built with the instructions from
then you can deploy and test code on any testnet/staging/production right
from your development environment. The staging and production vault containers
are only available to those with privledged access to the wallet keys.
npm run deploy will automatically spin them up.
Once you have the production and development vault containers, you can simply
npm run deploy and
npm test with the correct environment.
NOTE: only works in (
# staging ./scripts/plumb-env . ./env-staging export VAULT_ADDR=http://localhost:8200 npm run deploy && npm test # kovan ./scripts/plumb-env . ./env-kovan export VAULT_ADDR=http://localhost:8200 npm run deploy && npm test # ropsten ./scripts/plumb-env . ./env-ropsten export VAULT_ADDR=http://localhost:8200 npm run deploy && npm test # production (you might need to kill the staging vault) ./scripts/plumb-env . ./env-production export VAULT_ADDR=http://localhost:8200 npm run deploy && npm test
Flipping back to the
development environment is easy with:
./scripts/plumb-env . ./env-development
Deploys are handled through github triggers.
First, all changes must start with github issues in the form
N is a unique monotomically increasing id. Code changes come in on github PRs
with branches named
CRUCIBLE-N is the corresponding issue.
When a PR is made, and for every commit pushed against that PR, a continuous
integration run is fired off on codefresh. This run builds a docker container
and runs the unit tests against that PR's code.
When the PR has been reviewed, all items of review have been addressed, the PR passes CI tests, and a code owner has approved it for merge, it can then be squashed and merged right from the github interface.
NOTE: Please use squash+merge so that the entire change commits as one chunk. This makes rollbacks considerably easier.
Deploying these contracts to staging (rinkeby) or other tests networks happens
when that PR is merged. Any commit that lands on the
dev branch is
automatically built, deployed, tested, and run in staging. Sometimes this step
can cause a migration to be recommitted, if this happens, you must wait for the
dev test run to complete.
NOTE: Many PRs can be on
dev at once, for this reason, the unit tests run
again to make sure all that code works. In addition to unit tests, a set of
integration tests runs in staging to make sure the contracts perform correctly
in the wild.
Once staging looks good by passing all tests with everyone's code working together, then the entire thing can be deployed to production with the following git command:
git push origin dev:master
Again, this will build, deploy, test, and run the contract code. Please be very carful to follow all the earlier steps looking for errors. Any mistakes here can have extreme consiqunces including loss of funds from the contract owners to users.
NOTE: Since the nature of a crucible is to spawn off a new contract to handle that event, there is some protection against mistakes here. Existing crucibles should not be impacted by broken code. Nevertheless, we must take care not to break the Foundry, or new Crucibles created after code is launched. Also, be careful not to introduce any changes that could lead to all the funds in our main hot wallet being depleated.