//File: contracts\Owned.sol pragma solidity ^0.4.11; /// @dev `Owned` is a base level contract that assigns an `owner` that can be /// later changed contract Owned { /// @dev `owner` is the only address that can call a function with this /// modifier modifier onlyOwner() { require(msg.sender == owner); _; } address public owner; /// @notice The Constructor assigns the account deploying the contract to be /// the `owner` function Owned() { owner = msg.sender; } address public newOwner; /// @notice `owner` can step down and assign some other address to this role /// but after this function is called the current owner still has ownership /// powers in this contract; change of ownership is a 2 step process /// @param _newOwner The address of the new owner. A simple contract with /// the ability to accept ownership but the inability to do anything else /// can be used to create an unowned contract to achieve decentralization function changeOwner(address _newOwner) onlyOwner { newOwner = _newOwner; } /// @notice `newOwner` can accept ownership over this contract function acceptOwnership() { require(msg.sender == newOwner); owner = newOwner; } } //File: ./contracts/LPVault.sol pragma solidity ^0.4.11; /// @title LPVault /// @author Jordi Baylina /// @notice This contract holds ether securely for liquid pledging systems. For /// this iteration the funds will come straight from the Giveth Multisig as a /// safety precaution, but once fully tested and optimized this contract will /// be a safe place to store funds equipped with optional variable time delays /// to allow for an optional escape hatch to be implemented /// @dev `LiquidPledging` is a basic interface to allow the `LPVault` contract /// to confirm and cancel payments in the `LiquidPledging` contract. contract LiquidPledging { function confirmPayment(uint64 idNote, uint amount); function cancelPayment(uint64 idNote, uint amount); } /// @dev `LPVault` is a higher level contract built off of the `Owned` /// contract that holds funds for the liquid pledging system. contract LPVault is Owned { LiquidPledging public liquidPledging; // liquidPledging contract's address bool public autoPay; // if false, payments will take 2 txs to be completed enum PaymentStatus { Pending, // means the payment is awaiting confirmation Paid, // means the payment has been sent Canceled // means the payment will never be sent } /// @dev `Payment` is a public structure that describes the details of /// each payment the `ref` param makes it easy to track the movements of /// funds transparently by its connection to other `Payment` structs struct Payment { PaymentStatus state; // bytes32 ref; // an input that references details from other contracts address dest; // recipient of the ETH uint amount; // amount of ETH (in wei) to be sent } // @dev An array that contains all the payments for this LPVault Payment[] public payments; // @dev `liquidPledging` is the only address that can call a function with /// this modifier modifier onlyLiquidPledging() { require(msg.sender == address(liquidPledging)); _; } /// @dev USED FOR TESTING??? function VaultMock() { } function () payable { } /// @notice `setLiquidPledging` is used to attach a specific liquid pledging /// instance to this LPvault. Keep in mind this isn't a single pledge but /// instead an entire liquid pledging contract. /// @param _newLiquidPledging A full liquid pledging contract function setLiquidPledging(address _newLiquidPledging) onlyOwner { require(address(liquidPledging) == 0x0); liquidPledging = LiquidPledging(_newLiquidPledging); } /// @notice `setAutopay` is used to toggle whether the LPvault will /// automatically confirm a payment after the payment has been authorized. /// @param _automatic If true payments will confirm automatically function setAutopay(bool _automatic) onlyOwner { autoPay = _automatic; } /// @notice `authorizePayment` is used in order to approve a payment /// from the liquid pledging contract. Whenever a project or other address /// needs to receive a payment it needs to be authorized with this contract. /// @param _ref This parameter is used to reference details about the /// payment from another contract. /// @param _dest This is the address that payments will end up being sent to /// @param _amount This is the amount that the payment is being authorized /// for. function authorizePayment( bytes32 _ref, address _dest, uint _amount ) onlyLiquidPledging returns (uint) { uint idPayment = payments.length; payments.length ++; payments[idPayment].state = PaymentStatus.Pending; payments[idPayment].ref = _ref; payments[idPayment].dest = _dest; payments[idPayment].amount = _amount; AuthorizePayment(idPayment, _ref, _dest, _amount); if (autoPay) doConfirmPayment(idPayment); return idPayment; } /// @notice `confirmPayment` is a basic function used to allow the /// owner of the vault to initiate a payment confirmation. Since /// `authorizePayment` is the only pay to populate the `payments` array /// this is generally used when `autopay` is `false` after a payment has /// has been authorized. /// @param _idPayment Array lookup for the payment. function confirmPayment(uint _idPayment) onlyOwner { doConfirmPayment(_idPayment); } /// @notice `doConfirmPayment` is used to actually initiate a payment /// to the final destination. All of the payment information should be /// set before calling this function. /// @param _idPayment Array lookup for the payment. function doConfirmPayment(uint _idPayment) internal { require(_idPayment < payments.length); Payment storage p = payments[_idPayment]; require(p.state == PaymentStatus.Pending); p.state = PaymentStatus.Paid; liquidPledging.confirmPayment(uint64(p.ref), p.amount); p.dest.transfer(p.amount); // only ETH denominated in wei ConfirmPayment(_idPayment); } /// @notice `cancelPayment` is used when `autopay` is `false` in order /// to allow the owner to cancel a payment instead of confirming it. /// @param _idPayment Array lookup for the payment. function cancelPayment(uint _idPayment) onlyOwner { doCancelPayment(_idPayment); } /// @notice `doCancelPayment` This carries out the task of actually /// canceling a payment instead of confirming it. /// @param _idPayment Array lookup for the payment. function doCancelPayment(uint _idPayment) internal { require(_idPayment < payments.length); Payment storage p = payments[_idPayment]; require(p.state == PaymentStatus.Pending); p.state = PaymentStatus.Canceled; liquidPledging.cancelPayment(uint64(p.ref), p.amount); CancelPayment(_idPayment); } /// @notice `multiConfirm` allows for more efficient confirmation of /// multiple payments. /// @param _idPayments An array of multiple payment ids function multiConfirm(uint[] _idPayments) onlyOwner { for (uint i=0; i < _idPayments.length; i++) { doConfirmPayment(_idPayments[i]); } } /// @notice `multiCancel` allows for more efficient cancellation of /// multiple payments. /// @param _idPayments An array of multiple payment ids function multiCancel(uint[] _idPayments) onlyOwner { for (uint i=0; i < _idPayments.length; i++) { doCancelPayment(_idPayments[i]); } } /// @notice `nPayments` Basic getter to return the number of payments /// currently held in the system. Since payments are not removed from /// the array this represents all payments over all time. function nPayments() constant returns (uint) { return payments.length; } event ConfirmPayment(uint indexed idPayment); event CancelPayment(uint indexed idPayment); event AuthorizePayment(uint indexed idPayment, bytes32 indexed ref, address indexed dest, uint amount); }