programmable structures for web3 companies and funds
git clone https://github.com/kalidao/kali-contracts
cd kali-contracts
yarn
npx hardhat test
├─ KaliDAOfactory — "Deploys new Kali DAO with event and return of address"
│ ├─ KaliDAO — "DAO core module with Comp-style token voting and adjustment of membership, low-level calls on quorum/supermajority"
│ │ ├─IKaliDAOextension — "Interface for DAO to mint and burn shares as outputs of interactions with whitelisted external contracts"
│ │ ├─ReentrancyGuard — "Security module that provides reentrancy checks on core DAO functions"
│ │ ├─NFThelper — "Utility for DAO to receive `safeTransfer()` of NFTs under ERC-721 & ERC-1155 standards"
│ │ ├─Multicall — "Utility for DAO to batch transactions to itself"
│ │ ├─KaliDAOtoken — "Pausable Comp-style voting token with metaTX support"Kali is a protocol for on-chain orgs inspired by Compound and Moloch DAO governance. The smart contract code is simple to make it easier to read and secure assets on (less code, less to break). For example, Kali reduces Comp-style governance into a single contract, and can support extensions to add contracts as apps, such as crowdsales and redemptions against pooled funds. Kali contracts are further optimized for gas efficiency and functions are written to be easily adapted via modules through overrides.
Designed for Legal DAC
Kali is built for on-chain companies and funds. Proposals are broken out into a variety of types that each can have their own governance settings, such as simple/super majority and quorum requirements. Further, Kali supports hashing and amending docs from deployment and through proposals, providing a hook to wrap organizations into legal templates to rationalize membership rules and liabilities. Legal forms are maintained as open source goods by LexDAO legal engineers. Incorporation, and full-service legal engineering support is also being integrated into an MVP UI to allow Kali users to solve their org painpoints quickly and cheaply (stay tuned).
Kali tokens (KaliDAOtoken) represent voting stakes, and can be launched as transferable or non-transferable, with such settings being updateable via PAUSE proposal (see below). This allows for DACs to launch with closed membership (similar to Moloch-style 'clubs') but still retain the option to open their seats to the public. This configurability, in addition to appealing to different deployer preferences, can allow orgs to plan around compliance objectives.
Voting weight can also be delegated, and such weight automatically updates upon token transfers from delegators, incorporating functionality from Comp-style tokens (with an improvement of 'auto delegation' to new accounts to avoid an extra transaction for Kali users).
As a UX feature, meta-transactions can be made with Kali tokens, such as gas-less (relayed) transfers via EIP-2612 permit(), and delegation using EIP-712 off-chain signatures. Similarly, voteBySig() allows for voting meta-transactions, effectively allowing DAOs to subsidize and make voting free for members.
Kali tokens are further designed with gas efficiency in mind and have incorporated optimization techniques from RariCapital's solmate library.
Kali supports both ERC-721 and ERC-1155 NFT safeTransferFrom() through the NFThelper module. NFTs can be managed through CALL proposals (see below).
Proposals can be made under 11 types:
| Proposal | Description | Inputs | proposalType | description | accounts1 | amounts1 | payloads1 |
|---|---|---|---|---|---|---|---|
MINT |
create more membership tokens | → | 0 |
any | [recipient address, ...] |
[amount to mint, ...] |
any |
BURN |
burn membership tokens, similar to Moloch DAO ragekick() |
→ | 1 |
any | [member address, ...] |
[amount to burn, ...] |
any |
CALL |
make external calls to other smart contracts, similar to Moloch DAO Minion |
→ | 2 |
any | [external contract address, ...] |
[amount, ...] |
[ABI, ...] |
PERIOD |
adjust voting period | → | 3 |
any | any | [0 < x < 365] |
any |
QUORUM |
adjust voting quorum requirement, that is, the % of membership tokens that must vote for proposals to pass | → | 4 |
any | any | [x < 100] |
any |
SUPERMAJORITY |
adjust super-majority requirement, that is, the % of member approvals required for proposals to pass | → | 5 |
any | any | [51 < x < 100] |
any |
TYPE |
set ProposalType to a VoteType |
→ | 6 |
any | any | [ProposalType, VoteType] |
any |
PAUSE |
toggle member token transferability | → | 7 |
any | any | any | any |
EXTENSION |
toggle approval for certain contract external calls via extensionCall() |
→ | 8 |
any | [extension contract address, ...] |
any | [ABI, ...] |
ESCAPE |
delete a pending proposal in case of reverts as an extra safeguard for proposal clearing | → | 9 |
any | [proposal #] |
any | any |
DOCS |
amend the org docs string stored in DAO - these docs can be reasoned about by other contracts | → | 10 |
any | any | any | any |
VoteType is assigned to ProposalType upon Kali creation and determines threshold vote settings for proposals to pass.
SIMPLE_MAJORITY: Proposal must pass 51% threshold.
SIMPLE_MAJORITY_QUORUM_REQUIRED: Proposal must pass both 51% threshold and quorum setting.
SUPERMAJORITY: Proposal must pass supermajority threshold (which will be greater than 51%).
SUPERMAJORITY_QUORUM_REQUIRED: Proposal must pass supermajority threshold and quorum setting.
Kali allows orgs to flexibly extend their rules for minting and burning shares through external contract calls by using an interface, IKaliDAOExtension and callExtension(). In this manner, the core Kali contracts can remain simple and easy to verify, while still giving a great deal of optionality to orgs as they determine their goals. Saving gas and making it more clear where calls are being directed, Kali extensions are each a single contract that DAOs register to, avoiding duplicative contract deployment costs.
Currently, the following extensions are supported on deployment (by factory call to setExtension()) or can be added through Kali proposals:
A DAO can set a price for its membership in ETH or a designated token, a time limit for purchases, as well as limit purchases among a whitelist. Whitelisting is managed through an external access control contract, KaliWhitelistManager, which allows multiple DAOs to use the same merkle root to offer membership. Altogether, this allows for more immediate access and weighting of membership based on predictable contributions. Further, a DAO can update a crowdsale in the event terms need to be amended.
A DAO can allow members to burn their tokens to claim their fair share of DAO capital similar to Moloch-style ragequit(). To enable this extension, a DAO approves it to pull assets from the core contract and sets approved tokens. The list of approved tokens can be updated by each DAO.
Users can call this extension to make a proposal to a DAO with an escrowed sum of ETH, tokens or NFT, familiar to Moloch-style tribute offerings. This extension is dissimilar to others, in that it does not offer immediate updates to membership balances, but merely adds an economic element to normal proposals that must be approved by existing members.
DAO tokens can be scheduled for vesting, as well, to allow founders and other DAO stakeholders to have predictable lockups of their voting weight.
Proposals support batching for membership (MINT/BURN) so that groups of accounts can be updated, as well as for EXTENSION external calls, so that complex contract interactions can be arranged, such as approving and executing DeFi positions.
Further, all Kali function calls are batchable using multicall(), adapted from Uniswap V3, which allows members to make multiple proposals or process the same in a single transaction, saving gas and time.
Kali adopts standard security conventions, including a ReentrancyGuard module for core functions to avoid the potential of reentrancy attacks, as well as an internal function, _computeDomainSeparator() to help protect against signature replay in the event of a blockchain fork. In addition, as much as possible, Kali incorporates well-tested and common solidity patterns to make the code easier to audit and avoid 'reinventing the wheel', which can lead to the known unknown of novel attack surfaces. Tests are also included in JavaScript to demonstrate the performance of Kali operations. An audit report provided by BlockApex can be reviewed here for the Kali core contracts.
KaliDAOfactory: 0x1405101a6959a2105d659bA13c58609eA6E9FEeb
KaliDAOtribute: 0xE490B0cF7feE153d93Aa200E9Ff7021aBe3df346
KaliDAOcrowdsale: 0x4ED219Ef77EF8367649496b1D0876BC065ed1ecc
KaliDAOredemption: 0x43709960A5b35d40B0C0836162B85e88b03FE3a5
FixedERC20factory: 0x6aBab95BB30710159B3e40bF6e049f935547D12b
Special thanks to Auryn Macmillan and James Young for comments on early iterations of extensions concept, t11s for gas-golfing tips, and Q for help understanding how to develop dapp.
