Skip to content

An exclusive Holder DAO with dividends function and perpetual voting for a Trustee

License

Notifications You must be signed in to change notification settings

o0ragman0o/Bakt

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

47 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BAKT

v0.3.6-beta

© 2017 Darryl Morris

License: MIT

Ropsten: 0.3.6-beta

Exclusive Token Holder Fund Contract

[{"constant":false,"inputs":[{"name":"_resource","type":"bytes32"}],"name":"changeResource","outputs":[{"name":"","type":"bool"}],"payable":false,"type":"function"},{"constant":false,"inputs":[{"name":"_spender","type":"address"},{"name":"_amount","type":"uint256"}],"name":"approve","outputs":[{"name":"","type":"bool"}],"payable":false,"type":"function"},{"constant":true,"inputs":[],"name":"ptxHead","outputs":[{"name":"","type":"uint8"}],"payable":false,"type":"function"},{"constant":true,"inputs":[{"name":"_addr","type":"address"}],"name":"etherBalanceOf","outputs":[{"name":"","type":"uint256"}],"payable":false,"type":"function"},{"constant":true,"inputs":[],"name":"totalSupply","outputs":[{"name":"","type":"uint256"}],"payable":false,"type":"function"},{"constant":true,"inputs":[{"name":"","type":"address"}],"name":"holders","outputs":[{"name":"id","type":"uint8"},{"name":"votingFor","type":"address"},{"name":"offerExpiry","type":"uint40"},{"name":"lastClaimed","type":"uint256"},{"name":"tokenBalance","type":"uint256"},{"name":"etherBalance","type":"uint256"},{"name":"votes","type":"uint256"},{"name":"offerAmount","type":"uint256"}],"payable":false,"type":"function"},{"constant":true,"inputs":[],"name":"timeToCalm","outputs":[{"name":"","type":"uint40"}],"payable":false,"type":"function"},{"constant":true,"inputs":[],"name":"regName","outputs":[{"name":"","type":"bytes32"}],"payable":false,"type":"function"},{"constant":false,"inputs":[{"name":"_from","type":"address"},{"name":"_to","type":"address"},{"name":"_amount","type":"uint256"}],"name":"transferFrom","outputs":[{"name":"","type":"bool"}],"payable":false,"type":"function"},{"constant":true,"inputs":[],"name":"acceptingPayments","outputs":[{"name":"","type":"bool"}],"payable":false,"type":"function"},{"constant":false,"inputs":[{"name":"_value","type":"uint256"}],"name":"withdraw","outputs":[{"name":"","type":"bool"}],"payable":false,"type":"function"},{"constant":true,"inputs":[],"name":"resource","outputs":[{"name":"","type":"bytes32"}],"payable":false,"type":"function"},{"constant":true,"inputs":[],"name":"fundBalance","outputs":[{"name":"","type":"uint256"}],"payable":false,"type":"function"},{"constant":false,"inputs":[],"name":"calm","outputs":[{"name":"","type":"bool"}],"payable":false,"type":"function"},{"constant":true,"inputs":[],"name":"committedEther","outputs":[{"name":"","type":"uint256"}],"payable":false,"type":"function"},{"constant":true,"inputs":[],"name":"getHolders","outputs":[{"name":"","type":"address[256]"}],"payable":false,"type":"function"},{"constant":false,"inputs":[],"name":"purchase","outputs":[{"name":"","type":"bool"}],"payable":true,"type":"function"},{"constant":true,"inputs":[{"name":"","type":"uint256"}],"name":"pendingTxs","outputs":[{"name":"blocked","type":"bool"},{"name":"timeLock","type":"uint40"},{"name":"from","type":"address"},{"name":"to","type":"address"},{"name":"value","type":"uint256"},{"name":"data","type":"bytes"}],"payable":false,"type":"function"},{"constant":false,"inputs":[{"name":"_value","type":"uint256"}],"name":"payDividends","outputs":[{"name":"","type":"bool"}],"payable":false,"type":"function"},{"constant":false,"inputs":[{"name":"_txIdx","type":"uint256"}],"name":"blockPendingTx","outputs":[{"name":"","type":"bool"}],"payable":false,"type":"function"},{"constant":false,"inputs":[{"name":"_candidate","type":"address"}],"name":"vote","outputs":[{"name":"","type":"bool"}],"payable":false,"type":"function"},{"constant":true,"inputs":[{"name":"_addr","type":"address"}],"name":"balanceOf","outputs":[{"name":"","type":"uint256"}],"payable":false,"type":"function"},{"constant":true,"inputs":[],"name":"PANICPERIOD","outputs":[{"name":"","type":"uint40"}],"payable":false,"type":"function"},{"constant":false,"inputs":[{"name":"_accepting","type":"bool"}],"name":"acceptPayments","outputs":[{"name":"","type":"bool"}],"payable":false,"type":"function"},{"constant":true,"inputs":[],"name":"tokenPrice","outputs":[{"name":"","type":"uint256"}],"payable":false,"type":"function"},{"constant":false,"inputs":[],"name":"destroy","outputs":[],"payable":false,"type":"function"},{"constant":false,"inputs":[{"name":"_addr","type":"address"},{"name":"_amount","type":"uint256"}],"name":"issue","outputs":[{"name":"","type":"bool"}],"payable":false,"type":"function"},{"constant":false,"inputs":[{"name":"_addr","type":"address"},{"name":"_value","type":"uint256"}],"name":"withdrawFrom","outputs":[{"name":"","type":"bool"}],"payable":false,"type":"function"},{"constant":true,"inputs":[],"name":"panicked","outputs":[{"name":"","type":"bool"}],"payable":false,"type":"function"},{"constant":true,"inputs":[],"name":"totalDividends","outputs":[{"name":"","type":"uint256"}],"payable":false,"type":"function"},{"constant":false,"inputs":[],"name":"sendPending","outputs":[{"name":"","type":"bool"}],"payable":false,"type":"function"},{"constant":false,"inputs":[{"name":"_to","type":"address"},{"name":"_amount","type":"uint256"}],"name":"transfer","outputs":[{"name":"","type":"bool"}],"payable":false,"type":"function"},{"constant":false,"inputs":[{"name":"_addr","type":"address"}],"name":"addHolder","outputs":[{"name":"","type":"bool"}],"payable":false,"type":"function"},{"constant":true,"inputs":[{"name":"","type":"uint256"}],"name":"holderIndex","outputs":[{"name":"","type":"address"}],"payable":false,"type":"function"},{"constant":true,"inputs":[],"name":"ptxTail","outputs":[{"name":"","type":"uint8"}],"payable":false,"type":"function"},{"constant":false,"inputs":[{"name":"_to","type":"address"},{"name":"_value","type":"uint256"},{"name":"_data","type":"bytes"}],"name":"execute","outputs":[{"name":"","type":"uint8"}],"payable":false,"type":"function"},{"constant":true,"inputs":[],"name":"TXDELAY","outputs":[{"name":"","type":"uint40"}],"payable":false,"type":"function"},{"constant":false,"inputs":[{"name":"_addr","type":"address"}],"name":"revokeOffer","outputs":[{"name":"","type":"bool"}],"payable":false,"type":"function"},{"constant":false,"inputs":[{"name":"_amount","type":"uint256"}],"name":"redeem","outputs":[{"name":"","type":"bool"}],"payable":false,"type":"function"},{"constant":false,"inputs":[{"name":"_addr","type":"address"},{"name":"_amount","type":"uint256"}],"name":"withdrawFor","outputs":[{"name":"","type":"bool"}],"payable":false,"type":"function"},{"constant":true,"inputs":[{"name":"_owner","type":"address"},{"name":"_spender","type":"address"}],"name":"allowance","outputs":[{"name":"","type":"uint256"}],"payable":false,"type":"function"},{"constant":false,"inputs":[{"name":"_addr","type":"address"}],"name":"vacate","outputs":[{"name":"","type":"bool"}],"payable":false,"type":"function"},{"constant":true,"inputs":[],"name":"decimalPlaces","outputs":[{"name":"","type":"uint8"}],"payable":false,"type":"function"},{"constant":false,"inputs":[],"name":"PANIC","outputs":[{"name":"","type":"bool"}],"payable":false,"type":"function"},{"constant":false,"inputs":[{"name":"_panicPeriodInSeconds","type":"uint40"},{"name":"_pendingPeriodInSeconds","type":"uint40"}],"name":"_init","outputs":[{"name":"","type":"bool"}],"payable":false,"type":"function"},{"constant":true,"inputs":[],"name":"trustee","outputs":[{"name":"","type":"address"}],"payable":false,"type":"function"},{"constant":true,"inputs":[],"name":"VERSION","outputs":[{"name":"","type":"bytes32"}],"payable":false,"type":"function"},{"inputs":[{"name":"_creator","type":"address"},{"name":"_regName","type":"bytes32"},{"name":"_trustee","type":"address"}],"payable":false,"type":"constructor"},{"payable":true,"type":"fallback"},{"anonymous":false,"inputs":[{"indexed":false,"name":"state","type":"bool"}],"name":"AcceptingPayments","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"name":"value","type":"uint256"}],"name":"Deposit","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"name":"sender","type":"address"},{"indexed":true,"name":"recipient","type":"address"},{"indexed":false,"name":"value","type":"uint256"}],"name":"Withdrawal","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"name":"pTX","type":"uint256"},{"indexed":true,"name":"sender","type":"address"},{"indexed":true,"name":"recipient","type":"address"},{"indexed":false,"name":"value","type":"uint256"},{"indexed":false,"name":"timeLock","type":"uint256"}],"name":"TransactionPending","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"name":"by","type":"address"},{"indexed":true,"name":"pTX","type":"uint256"}],"name":"TransactionBlocked","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"name":"sender","type":"address"},{"indexed":true,"name":"recipient","type":"address"},{"indexed":false,"name":"value","type":"uint256"}],"name":"TransactionFailed","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"name":"value","type":"uint256"}],"name":"DividendPaid","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"name":"from","type":"address"},{"indexed":true,"name":"to","type":"address"},{"indexed":false,"name":"value","type":"uint256"}],"name":"Transfer","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"name":"owner","type":"address"},{"indexed":true,"name":"spender","type":"address"},{"indexed":false,"name":"value","type":"uint256"}],"name":"Approval","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"name":"trustee","type":"address"}],"name":"Trustee","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"name":"holder","type":"address"}],"name":"NewHolder","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"name":"holder","type":"address"}],"name":"HolderVacated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"name":"holder","type":"address"}],"name":"IssueOffer","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"name":"holder","type":"address"}],"name":"OfferRevoked","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"name":"holder","type":"address"},{"indexed":false,"name":"amount","type":"uint256"}],"name":"TokensCreated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"name":"holder","type":"address"},{"indexed":false,"name":"amount","type":"uint256"}],"name":"TokensDestroyed","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"name":"by","type":"address"}],"name":"Panicked","type":"event"},{"anonymous":false,"inputs":[],"name":"Calm","type":"event"}]

Bakt is a payable and dividends paying Ethereum contract in which ERC20 token holders elect a single holder as Trustee to manage the fund. It may be suitable for private investor groups of up to 255 members who have pre-established trust arrangements. It does not enforce trust in the trustee.

Bakt:

  • Holds a fund of Ether.
  • Can accept payments to its default function.
  • Maintains a balance of committed and uncommitted ether.
  • Records Holders' proportional investments in the form of transferable ERC20 tokens.
  • Allows token transfer only to another registered Holder.
  • Records Holders' balance of ether.
  • Creates new tokens when a Holder purchases an offer with ether.
  • Destroys tokens upon a Holder redeeming tokens for ether proportional to their share of the fund upto the token price.
  • Allows Holders to vote for a Trustee in proportion to their holdings.
  • Allows the Trustee to issue a token offer to a potential or existing Holder at a rate of 1000 tokens/ether.
  • Allows the Trustee to revoke an outstanding offer.
  • Allows the Trustee to add new holders.
  • Allows the Trustee to pay dividends to the Holders.
  • Allows the Trustee to unilaterally order the withdrawal of uncommitted funds.
  • Allows the Trustee to destroy the contract on the condition of 0 supply and 0 committed ether
  • Allows Holders to order the withdrawal of their balance of ether.
  • Prevents pending transactions from being sent until after a set delay.
  • Allows a holder with greater than 10% of tokens to block a pending transaction.
  • Allows any holder to execute a transaction past its pending timestamp.
  • Allows a holder with greater than 10% of tokens to cause a panic.
  • Prevents all actions during a panic except for voting, blocking, receiving payments and calming.
  • Allows any holder to calm after an elapsed period after a panic.

Architecture

Governance Model

Bakt provides a perpetual and liquid mechanism to elect a trustee of the fund. This requires a vote count across the entire membership of holders in O(N) time after every change to a single holder's voting preference or balance of tokens. A necessary bounding limit upon holder numbers is required to prevent Out Of Gas errors. This has been set at 255 and so forces the election loop to O(255) time regardless of the actual number of Holders registered.

This limit impacts upon the freedom to transfer tokens by limiting the recipients to registered holders only. It is this property which renders the contract exclusive.

Holders are explicitly added to the contract by the Trustee and a new holder's voting preference defaults to the current Trustee until they explicitly change it by calling vote().

Token Model

The token model used is a variable supply in which tokens are created upon purchase() of an issue() offering and destroyed upon redeem() (I have avoided the terms buy and sell which I use to indicate in other contracts the invariable supply trading of tokens).

An issue(address, amount) will create an offer of new tokens to a holder for the constant rate of 1000 tokens/ether and which expires within 7 days.

A purchase() creates and amount of new tokens from an offer to a holder

A redeem(amount) destroys the amount of tokens and commits a value of ether to the holder's etherBalance of:

by proprtion held of fund balance

balanceOf[holder] * fundBalance / totalSupply

or where fundBalance / totalSupply > 0.001 ether

amount * 0.001 ether

Fund Model

The contract manages its balance of ether in a number of sub-balances which it tracks through a the metric committedEther. committedEther is subtracted from the contract balance to derive fundBalance():

fundBalance = this.balance - committedEther;

The Trustee has access to the fundBalance and may order its withdrawal at any time or commit an amount of it as dividends payments.

committedEther is the total ether held in all holder etherBalance's, pending transactions and unclaimed dividends.

committedEther = etherBalances[1..255] + unclaimed dividends[1..255] + pending transactions[0..255]

A holder can order the withdrawal of their etherBalance at any time by calling withdraw(uint).

Ether can leave the contract only through a call to sendPending().

Security Model

Given the potential for the trustee to unilaterally steal the fundBalance, a time delay for pending transactions must be set upon initialising the contract. Transactions initiated by withdraw() (by holders) and execute() (by the trustee) will be subject to this delay and open for inspection and blocking by other holders.

A followup call to sendPending() will execute the oldest transaction in the pending queue (a FIFO queue) if its time lock has expired or revert the transaction if it was blocked.

An additional PANIC() mechanism can be enacted to block most state mutating functions of the contract panic period set during initialisation. The exceptions are vote() block() and PANIC(). This should only be called if there is serious behavioural problems with the contract or the trustee. It is intended to allow time for the holders to be notified and vote for a different trustee.

Deployment

Bakts can be created by calling createNew(<name>, <owner>) of a deployed BaktFactory contract. Bakt factories have been deployed at:

Live:

Ropsten:

Rinkeby: 0xb8bd4eb11e55d928a40d2e5c0b927724c7044288

[{"constant":false,"inputs":[{"name":"_resource","type":"bytes32"}],"name":"changeResource","outputs":[{"name":"","type":"bool"}],"payable":false,"type":"function"},{"constant":true,"inputs":[],"name":"regName","outputs":[{"name":"","type":"bytes32"}],"payable":false,"type":"function"},{"constant":false,"inputs":[{"name":"_value","type":"uint256"}],"name":"withdraw","outputs":[{"name":"","type":"bool"}],"payable":false,"type":"function"},{"constant":true,"inputs":[],"name":"resource","outputs":[{"name":"","type":"bytes32"}],"payable":false,"type":"function"},{"constant":true,"inputs":[],"name":"value","outputs":[{"name":"","type":"uint256"}],"payable":false,"type":"function"},{"constant":false,"inputs":[{"name":"_fee","type":"uint256"}],"name":"set","outputs":[{"name":"","type":"bool"}],"payable":false,"type":"function"},{"constant":false,"inputs":[],"name":"destroy","outputs":[],"payable":false,"type":"function"},{"constant":true,"inputs":[],"name":"owner","outputs":[{"name":"","type":"address"}],"payable":false,"type":"function"},{"constant":false,"inputs":[{"name":"_from","type":"address"},{"name":"_value","type":"uint256"}],"name":"withdrawFrom","outputs":[{"name":"","type":"bool"}],"payable":false,"type":"function"},{"constant":false,"inputs":[{"name":"_owner","type":"address"}],"name":"changeOwner","outputs":[{"name":"","type":"bool"}],"payable":false,"type":"function"},{"constant":false,"inputs":[{"name":"_to","type":"address"},{"name":"_value","type":"uint256"}],"name":"withdrawFor","outputs":[{"name":"","type":"bool"}],"payable":false,"type":"function"},{"constant":false,"inputs":[{"name":"_regName","type":"bytes32"},{"name":"_owner","type":"address"}],"name":"createNew","outputs":[{"name":"kAddr_","type":"address"}],"payable":true,"type":"function"},{"constant":true,"inputs":[],"name":"VERSION","outputs":[{"name":"","type":"bytes32"}],"payable":false,"type":"function"},{"inputs":[{"name":"_creator","type":"address"},{"name":"_regName","type":"bytes32"},{"name":"_owner","type":"address"}],"payable":false,"type":"constructor"},{"payable":true,"type":"fallback"},{"anonymous":false,"inputs":[{"indexed":false,"name":"creator","type":"address"},{"indexed":false,"name":"regName","type":"bytes32"},{"indexed":false,"name":"addr","type":"address"}],"name":"Created","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"name":"oldOwner","type":"address"},{"indexed":true,"name":"newOwner","type":"address"}],"name":"ChangedOwner","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"name":"resource","type":"bytes32"}],"name":"ChangedResource","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"name":"sender","type":"address"},{"indexed":false,"name":"value","type":"uint256"}],"name":"Deposit","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"name":"to","type":"address"},{"indexed":false,"name":"value","type":"uint256"}],"name":"Withdrawal","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"name":"from","type":"address"},{"indexed":false,"name":"value","type":"uint256"}],"name":"WithdrawFrom","type":"event"}]

Setup

The Bakt contract can be operated from an Ethereum wallet such as Parity or Mist by selecting Watch Contracts and filling in the details and ABI.

A newly deployed contract must be initialised by calling the function _init(_panicPeriodISeconds, _pendingPeriodInSeconds). The address of the creating account is the Trustee and can add new holders with a call to addHolder(address) or 'issue(address, amount)'

GUI

A Meteor driven GUI is provided to make creation and interaction with Bakts simpler and resides in the /app subdirectory of this repository. This GUI can also create new Bakts.

Bakt Functions

Constructor

function Bakt(address _creator, bytes32 _regName, address _trustee)

A SandalStraps compliant constructor

_creator The address of the creating contract or account (used by a SandalStraps factory)

_regName A unique name in the scope of a SandalStraps registrar

_trustee The address of the initial holder (will be msg.sender if blank)

default

function() payable;

Accepts payment to the default function

destroy

function destroy();

Destroy the contract and transfer remaining ether to the trustee address on the conditions that:

  • all tokens have been destroyed
  • committed ether is 0

_init

function _init(uint40 _panicDelayInSeconds, uint40 _pendingDelayInSeconds) returns (bool);

WARNING This action is one off and is irrevocable! This will set the OTP (One Time Programable) panic and pending periods. Holders cannot be added until this function has been called.

_panicDelayInSeconds The panic delay period in seconds. (1 day == 86400 seconds)

_pendingDelayInSeconds The pending period in seconds.

fundBalance

function fundBalance() constant returns (uint);

Returns the balance of uncommitted ether funds.

commitedEther

function committedEther() constant returns (uint);

Returns the combined balance of ether committed to holder accounts, unclaimed dividends and values in pending transactions.

tokenPrice

function tokenPrice() constant returns (uint);

Returns the constant TOKENPRICE.

trustee

function trustee() constant returns (address);

Returns the ether price at which to buy tokens

regName

function regName() constant returns (bytes32)

A unique name within the scope of a SandalStraps Registrar

holders

function holders(address);

Returns Holder data cast from struct Holder to an array

address The address of a holder.

holderIndex

function holderIndex(uint) constant returns (address[]);

Returns an address of a holder at an index from 1 to 255

uint8 The index of a holder

pendingTxs

function pendingTxs(uint);

Returns transaction details cast from struct TX to array

uint8 The index of a pending transaction

ptxHead

function ptxHead() constant returns (uint8);

Return the pending transaction index of the youngest pending transaction

ptxTail

function ptxTail() constant returns (uint8);

Returns the pending transaction index of the oldest pending transaction

ERC20 Functions

totalSupply

function totalSupply() constant returns (uint);

Return total count of tokens

balanceOf

function balanceOf(address _addr) constant returns (uint);

Returns the ERC20 token balance of the holder

_addr The address of a holder

transfer

function transfer(address _to, uint _amount) returns (bool);

Transfers an amount of tokens from one registered holder to another

_to the address of a Holder to transfer token to

_amount Amount of tokens to transfer

transferFrom

function transferFrom(address _from, address _to, uint256 _amount) returns (bool);

Transfers tokens from one registered holder to another by an allowed third-party

_from The addres of a holder from which to transfer

_to The address of a holder to transfer to

_amount The amount of tokens to transfer

approve

function approve(address _spender, uint256 _amount) returns (bool);

Approves a third-party account to transfer an amount of tokens on behalf of the Holder

_spender The address of the approved third-party (not restricted to registered holders)

_amount The amount which is allowed to be transfered

allowance

function allowance(address _owner, address _spender) constant returns (uint256);

Returns the amount of remaining tokens that an approved thrid-party can send

_owner The adddress of the holder owning tokens

_spender The address of the account approved to transfer tokens

Security Functions

PANIC

function PANIC() returns (bool);

Allows a Holder with >10% to cause the contract to Panic. This will block most state changing functions for a delay of 2 days. Exceptions are vote(), blockPendingTx(uint _txIdx) and PANIC()

calm

function calm() returns (bool);

Allows a Holder to release the contract from a Panicked state after the panic period has expired.

panicked

function panicked() returns (bool);

Returns the Panic flag state. false == calm, true == panicked

timeToCalm

function timeToCalm() returns (uint40);

Returns the time-stamp after which a Panic can be released by calm()

sendPending

function sendPending() returns (bool);

Execute the first transaction in the pendingTxs queue after it's pending time lock has expired. The transaction will be reverted if it has been blocked or fails.

blockPending

function blockPendingTx(uint _txIdx) returns (bool);

Allows a holder with >10% to block a pending transaction with the given index. Transactions can be blocked by any holder at any time but must still be cleared from the pending transactions queue once the time lock has expired.

_txIdx _txIdx Index of the transaction in the pending transactions table.

Holder Functions

vote

function vote(address _candidate) returns (bool);

Allows a Holder to vote for a preferred Trustee

_candidate The address of the preferred holder

etherBalanceOf

function etherBalanceOf(address _addr) constant returns (uint);

Returns a holder's withdrawable balance of ether

_addr The address of a holder

withdraw

function withdraw(uint _value) returns (bool);

Initiate a withdrawal from the Holder's etherBalance. It must be followed up with sendPending() once the time lock has expired.

_value The value in ether to be withdrawn.

Returns success.

withdrawFor

function withdrawFor(address _addr uint _value) returns (bool);

Initiate a withdrawal from a Holder's etherBalance to their etherum account. It must be followed up with sendPending() once the time lock has expired.

_addr The address of a holder

_value The value in ether to be withdrawn.

Returns success

withdrawFrom

function withdrawFrom(uint _value) returns (bool);

Calls withdraw(_value) of an external contract in which the Bakt instance may have a balance of value.

_addr The address of an external contract.

_value The value in ether to be withdrawn.

Returns success

purchase

function purchase() payable returns (bool);

Create tokens from an offer.

redeem

function redeem(uint _amount) returns (bool);

Destructively redeems token for their ether value being the lesser of _amount * fundBalance()/totalSupply or _amount / tokenPrice()

_amount The amount of tokens to redeem.

Returns success

vacate

function vacate(address _addr) returns (bool);

To vacate and deregister a Holder on the conditions that:

  • their token balance is 0
  • their ether balance is 0
  • there are no pending transactions

_addr The address of a holder to vacate.

Trustee Functions

execute

function execute(address _to, uint _value, bytes _data) returns (uint8);

Allows the trustee to unilaterally order a transaction as the contract and potentially withdraw the entire fundBalance(). Such transactions are held in the pending transactions queue for a period of 1 day during which they may be blocked by any holder.

_to The recipient address

_value value of ether to send upto a maximum of fundBalance()

_data the call data to be sent with the transaction.

payDividends

function payDividends(uint _value) returns (bool);

Allows the Trustee to commit an amount of ether from fundBalance() to be collected by the holders in proportion to their token holdings.

_value An amount of ether to be distributed to holders.

addHolder

function addHolder(address _addrs) returns (bool);

Allows the Trustee to register new holder accounts by providing an array of addresses.

_addrs and array of upto 20 addresses.

issue

function issue(address _addr, uint _amount) returns (bool);

Issues a token offer to a potential or existing holder. The offer expires within 7 days.

_addr The address of a holder to who an offer will be made.

_amount The amount of tokens to be created in the offer.

Returns success

revoke

function revoke(address _addr) returns (bool)

Revoke an outstanding offer.

_addr The address of a holder to whom an offer had been made.

Returns success.

Events

Deposit(value);

Triggered when contract recieved a payment.

Withdrawal(sender, recipient, value);

Triggered when a ether is sent from the contract.

TransactionPending(pTX, sender, recipient, value, timeLock);

Triggered when a transaction is ordered.

TransactionBlocked(by, pTX);

Triggered when a pending transaction is blocked by a holder.

TransactionFailed(sender, recipient, value);

Triggered when a transaction fails either by being blocked or failure of receipt.

DividendsPaid(supply, value);

Triggered when the trustee pays dividends.

Transfer(from, to, value);

ERC20 transfer notification.

Approval(owner,  spender, value);

ERC20 approval notification.

Trustee(trustee);

Triggered on change of trustee.

NewHolder(holder);

Trigger when a new holder is added.

HolderVacated(holder);

Triggered when a holder vacates.

TokensCreated(holder, amount);

Triggered when tokens are created during a funding round.

TokensDestroyed(holder, amount);

Triggered when tokes are destroyed during a redeeming round.

Panicked(by);

Triggered when a hold causes a panic.

Calm();

Triggered when a holder calms a panic.

OfferRevoked(address)

Triggered when an odder is revoked.

HolderVacated(address)

Triggered when a holder vacates.

AcceptingPayments(bool)

Trigger when there is a change to payment acceptance.

About

An exclusive Holder DAO with dividends function and perpetual voting for a Trustee

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published