@daostack/arc-experimental
v0.1.2-rc.8
Published
A platform for building DAOs
Downloads
61
Readme
Arc
Arc is the base layer of the DAO stack. It consists of a set of smart contracts deployed on the Ethereum blockchain that define the basic building blocks and standard components that can be used to implement any DAO.
Arc is a modular, upgradeable platform that allows for a rapid natural selection of governance systems.
Figure 1: Arc's structure
Every box in Figure 1 represents a smart contract.
The Token contract probably does not require an explanation, being the most popular use-case of the Ethereum network.
The Avatar contract is the face of an organization on the blockchain, e.g. if the organization is to hold ownership of anything, like ownership over a contract or asset, the owner address will be the Avatar.
The Reputation contract stores a DAO's reputation data. In Arc, Reputation represents a user's decision power in a given DAO. It is very similar to a token, with two main differences: one, it is non-transferable, and two, it can be granted or taken away by the DAO.
On the right side of the figure we have the schemes. Schemes are simple pieces of logic describing the different actions a DAO can take. One example is a scheme for funding proposals, in which everyone can suggest and vote on proposals, and if a proposal is approved, it is automatically funded.
At the bottom are the global constraints. Global constraints prevent current and future modules from breaking certain overarching rules, e.g. a cap on an organization’s total possible reputation.
The Controller is an access control module that keeps a record of all the registered schemes in a DAO and the permissions for each scheme. It also records all global constraints and enforces them by reverting transactions that violate them.
Go here for a full primer on Arc.
Security
DAOstack Arc is still in its alpha version. Arc is intended to provide secure, tested, and community-audited code, but please use common sense when doing anything that deals with real money! We take no responsibility for your implementation decisions and any security problem you might experience.
Getting Started
- Install buidler and initialize your project
- Install the
@daostack/arc
package:npm install @daostack/arc
..sol
Source code is found undernode_modules/@daostack/arc/contracts
.json
Compiled contracts are found undernode_modules/@daostack/arc/build/contracts
- Import in your project:
You should be able to find theimport '@daostack/arc/contracts/universalSchemes/UniversalScheme.sol'; contract MyContract is UniversalScheme { ... }
@daostack/arc
contracts (.json) already built and ready for deployment in thenode_modules/@daostack/arc/build/contracts/
folder. - Read the documentation to get a better understanding of how to use Arc.
Contribute
PRs are welcome, but please first consult with the Contribution guide.
Join us on Discord!
To contribute to Arc development start by cloning the repo and installing the dependencies:
git clone https://github.com/daostack/arc
cd arc
npm install
Commands
Available commands while developing:
npm run build
- Compile all contracts to thebuild/
folder.npm run test
- This will run ganache-cli, compile, migrate and run all tests.npm run lint
- Check all JavaScript code for style & good practices.npm run solhint
- Check all Solidity code for style & good practices.npm run docs:<update|build|deploy|preview>
- See this for details.
Docker
Arc has a prebuilt Docker image that makes development environments consistent and cross-platform. To start developing inside this environment:
- Install Docker in your favorite OS/platform.
- Run
docker run --rm -it -v <path to repo>:/home/arc daostack/arc
(*May require Admin/root permissions). - The container will automatically
git clone
orgit fetch
depending on if<path to repo>
is empty, and will install any dependencies. - Continue development inside the container.
License
This is an open-source project (GPL license).