Improve documentation, add mark constants, add removeMinter method

This commit is contained in:
nolash 2021-03-01 10:23:55 +01:00
parent 364731b220
commit aab0bc243c
Signed by: lash
GPG Key ID: 21D2E7BB88C2A746
9 changed files with 199 additions and 83 deletions

View File

@ -14,29 +14,26 @@
- Then the resulting balances after one tax period of those two trading would be 1080 Sarafu while the remaining non-active users would be 980 Sarafu. If this behaviour continued in the next tax period, with the same two users only trading (with no net balance changes), they would have 1158.39999968 Sarafu and those users that are not trading would have their balances further reduced to 960.40 Sarafu. If this continued on ~forever those two active trading users would have the entire token supply and the non-trading users would eventually reach a zero balance. - Then the resulting balances after one tax period of those two trading would be 1080 Sarafu while the remaining non-active users would be 980 Sarafu. If this behaviour continued in the next tax period, with the same two users only trading (with no net balance changes), they would have 1158.39999968 Sarafu and those users that are not trading would have their balances further reduced to 960.40 Sarafu. If this continued on ~forever those two active trading users would have the entire token supply and the non-trading users would eventually reach a zero balance.
- this example calculation for 3 tax periods can be found here: https://gitlab.com/grassrootseconomics/cic-docs/-/blob/master/demurrage-redist-sarafu.ods - this example calculation for 3 tax periods can be found here: https://gitlab.com/grassrootseconomics/cic-docs/-/blob/master/demurrage-redist-sarafu.ods
## Nomenclature
## Variables * `Demurrage` aka Decay amount: A percentage of token supply that will be charged once per minute and evenly redistributed to _active_ users every Demurrage Period (minutes)
* Base balance: The inflated balance of each user is stored for bookkeeping.
* Inputs to Constructor (Set only once during contract deployment can't be changed ) * Sink Token Address: Rounding errors and if no one trades the tax goes to this address
* `Demurrage` aka Decay amount: A percentage of token supply that will be charged once per minute and evenly redistributed to _active_ users every Demurrage Period (minutes) * Demurrage Period (minutes)- aka `period`: The number of minutes over which a user must be _active_ to receive tax-redistibution.
* Demurrage Period (minutes)- aka `period`: The number of minutes over which a user must be _active_ to receive tax-redistibution.
* Inflated Balance: The inflated balance of each user is stored for bookkeeping.
* Number of Decimals: Resolution on token (TODO) (Default 6)
* Minimum Activity Volume: (TODO) the minimum transaction amount to be considered active
* Sink Token Address: Rounding errors and if no one trades the tax goes to this address
## Ownership ## Ownership
* Contract creator is owner * Contract creator is owner
* Ownership can be transferred (also to ownership void contract "no more changes can be made") * Ownership can be transferred
## Mint ## Mint
* Owner can add minters * Owner can add minters and remove
- A faucet contract would be a minter and choose the amount of tokens to mint and distribute to new _validated_ users. - A faucet contract would be a minter and choose the amount of tokens to mint and distribute to new _validated_ users.
- The interface says the amount and is at the caller's discretion per contract call. _validation_ is outside of this contract. - The interface says the amount and is at the caller's discretion per contract call. _validation_ is outside of this contract.
* A minter can remove itself
* Minters can mint any amount * Minters can mint any amount
@ -49,7 +46,6 @@
- e.g. a `demurrage` after the 2nd minute would be give a `demurrageModifier = (1-0.02)^2 = 0.9604`. - e.g. a `demurrage` after the 2nd minute would be give a `demurrageModifier = (1-0.02)^2 = 0.9604`.
* All client-facing values (_balance output_ , _transfer inputs_) are adjusted with `demurrageModifier`. * All client-facing values (_balance output_ , _transfer inputs_) are adjusted with `demurrageModifier`.
- e.g. `_balance output_ = user_balance - user_balance * demurrageModifier` - e.g. `_balance output_ = user_balance - user_balance * demurrageModifier`
* Edge case: `approve` call, which may be called on either side of a period.
## Redistribution ## Redistribution
@ -62,27 +58,39 @@
- Check if user has participated in `period`. (_active_ user heartbeat) - Check if user has participated in `period`. (_active_ user heartbeat)
- Each _active_ user balance in the `period` is increased by `(total supply at end of period * demurrageModifier ) / number_of_active_participants` via minting - Each _active_ user balance in the `period` is increased by `(total supply at end of period * demurrageModifier ) / number_of_active_participants` via minting
- Participation field is zeroed out for that user. - Participation field is zeroed out for that user.
* Fractions must be rounded down (TODO) * Fractions must be rounded down
- Remainder is "dust" and should be sent to a dedicated "sink" token address (TODO) - Remainder is "dust" and should be sent to a dedicated Sink Token Address.
- If no one is _active_ all taxes go to the same sink address - If no one is _active_ all taxes go to the Sink Token Address.
## Data structures ## Data structures
* One word per account: * One word per `account`:
- bits 000-159: value - bits 000-071: value
- bits 160-255: period - bits 072-103: period
- (we have more room here in case we want to cram something else in) - bits 104-255: (Unused)
* One word per redistribution period: * One word per `redistributions` period:
- bits 000-055: period - bits 000-031: period
- bits 056-215: supply - bits 032-103: supply
- bits 216-253: participant count - bits 104-139: participant count
- bits 254: Set if individual redistribution amounts are fractions (TODO) - bits 140-159: demurrage modifier
- bits 255: Set if "dust" has been transferred to sink (TODO) - bits 160-254: (Unused)
- bits 255: Set if individual redistribution amounts are fractions
* One word for the `demurrageModifier` (should be replaced with 2 x uint128 instead):
- bits 000-127: Accumulated demurrage modifier from last calculation
- bits 128-255: Period of last calculated demurrage modifier
### Notes
Accumulated demurrage modifier in `demurrageModifier` is 128 bit, but will be _truncated_ do 20 bits in `redistributions`. The 128 bit resolution is to used to reduce the impact of fractional drift of the long-term accumulation of the demurrage modifier. However, the demurrage snapshot values used in `redistributions` are parts-per-million and can be fully contained within a 20-bit value.
## QA ## QA
* Basic python tests in place * Basic python tests in place
* How to determine and generate test vectors, and how to adapt them to scripts. * How to determine and generate sufficient test vectors, and how to adapt them to scripts.
* Audit sources? * Audit sources?
## Known issues
* A `transferFrom` following an `approve` call, when called across period thresholds, may fail if margin to demurraged amount is insufficient.

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

View File

@ -1,6 +1,6 @@
[metadata] [metadata]
name = sarafu-token name = sarafu-token
version = 0.0.1a1 version = 0.0.1a2
description = ERC20 token with redistributed continual demurrage description = ERC20 token with redistributed continual demurrage
author = Louis Holbrook author = Louis Holbrook
author_email = dev@holbrook.no author_email = dev@holbrook.no

View File

@ -112,6 +112,32 @@ class Test(unittest.TestCase):
self.assertEqual(balance, int(2000 * 0.98)) self.assertEqual(balance, int(2000 * 0.98))
def test_minter_control(self):
with self.assertRaises(eth_tester.exceptions.TransactionFailed):
tx_hash = self.contract.functions.mintTo(self.w3.eth.accounts[2], 1024).transact({'from': self.w3.eth.accounts[1]})
with self.assertRaises(eth_tester.exceptions.TransactionFailed):
tx_hash = self.contract.functions.addMinter(self.w3.eth.accounts[1]).transact({'from': self.w3.eth.accounts[1]})
tx_hash = self.contract.functions.addMinter(self.w3.eth.accounts[1]).transact({'from': self.w3.eth.accounts[0]})
r = self.w3.eth.getTransactionReceipt(tx_hash)
self.assertEqual(r.status, 1)
with self.assertRaises(eth_tester.exceptions.TransactionFailed):
tx_hash = self.contract.functions.addMinter(self.w3.eth.accounts[2]).transact({'from': self.w3.eth.accounts[1]})
tx_hash = self.contract.functions.mintTo(self.w3.eth.accounts[2], 1024).transact({'from': self.w3.eth.accounts[1]})
with self.assertRaises(eth_tester.exceptions.TransactionFailed):
tx_hash = self.contract.functions.addMinter(self.w3.eth.accounts[1]).transact({'from': self.w3.eth.accounts[2]})
tx_hash = self.contract.functions.removeMinter(self.w3.eth.accounts[1]).transact({'from': self.w3.eth.accounts[1]})
r = self.w3.eth.getTransactionReceipt(tx_hash)
self.assertEqual(r.status, 1)
with self.assertRaises(eth_tester.exceptions.TransactionFailed):
tx_hash = self.contract.functions.mintTo(self.w3.eth.accounts[2], 1024).transact({'from': self.w3.eth.accounts[1]})
def test_base_amount(self): def test_base_amount(self):
tx_hash = self.contract.functions.mintTo(self.w3.eth.accounts[1], 1000).transact() tx_hash = self.contract.functions.mintTo(self.w3.eth.accounts[1], 1000).transact()
r = self.w3.eth.getTransactionReceipt(tx_hash) r = self.w3.eth.getTransactionReceipt(tx_hash)

View File

@ -60,20 +60,21 @@ class Test(unittest.TestCase):
pass pass
@unittest.skip('this function has been removed from contract')
def test_tax_period(self): def test_tax_period(self):
t = self.contract.functions.taxLevel().call() t = self.contract.functions.taxLevel().call()
logg.debug('taxlevel {}'.format(t)) logg.debug('taxlevel {}'.format(t))
a = self.contract.functions.toTaxPeriodAmount(1000000, 0).call() a = self.contract.functions.toDemurrageAmount(1000000, 0).call()
self.assertEqual(a, 1000000) self.assertEqual(a, 1000000)
a = self.contract.functions.toTaxPeriodAmount(1000000, 1).call() a = self.contract.functions.toDemurrageAmount(1000000, 1).call()
self.assertEqual(a, 980000) self.assertEqual(a, 980000)
a = self.contract.functions.toTaxPeriodAmount(1000000, 2).call() a = self.contract.functions.toDemurrageAmount(1000000, 2).call()
self.assertEqual(a, 960400) self.assertEqual(a, 960400)
a = self.contract.functions.toTaxPeriodAmount(980000, 1).call() a = self.contract.functions.toDemurrageAmount(980000, 1).call()
self.assertEqual(a, 960400) self.assertEqual(a, 960400)

View File

@ -71,6 +71,9 @@ class Test(unittest.TestCase):
# TODO: check receipt log outputs # TODO: check receipt log outputs
def test_redistribution_storage(self): def test_redistribution_storage(self):
redistribution = self.contract.functions.redistributions(0).call();
self.assertEqual(redistribution.hex(), '000000000000000000000000f424000000000000000000000000000000000001')
self.contract.functions.mintTo(self.w3.eth.accounts[1], 1000000).transact() self.contract.functions.mintTo(self.w3.eth.accounts[1], 1000000).transact()
self.contract.functions.mintTo(self.w3.eth.accounts[2], 1000000).transact() self.contract.functions.mintTo(self.w3.eth.accounts[2], 1000000).transact()

View File

@ -11,6 +11,6 @@ test: all
python ../python/tests/test_redistribution.py python ../python/tests/test_redistribution.py
install: all install: all
cp -v RedistributedDemurrageToken.{json,bin} ../python/eth_address_declarator/data/ cp -v RedistributedDemurrageToken.{json,bin} ../python/sarafu_token/data/
.PHONY: test install .PHONY: test install

View File

@ -2,51 +2,121 @@ pragma solidity > 0.6.11;
// SPDX-License-Identifier: GPL-3.0-or-later // SPDX-License-Identifier: GPL-3.0-or-later
// TODO: assign bitmask values to contants
contract RedistributedDemurrageToken { contract RedistributedDemurrageToken {
// Redistribution bit field, with associated shifts and masks
// (Uses sub-byte boundaries)
bytes32[] public redistributions; // uint1(isFractional) | uint95(unused) | uint20(demurrageModifier) | uint36(participants) | uint72(value) | uint32(period)
uint8 constant shiftRedistributionPeriod = 0;
uint256 constant maskRedistributionPeriod = 0x00000000000000000000000000000000000000000000000000000000ffffffff; // (1 << 32) - 1
uint8 constant shiftRedistributionValue = 32;
uint256 constant maskRedistributionValue = 0x00000000000000000000000000000000000000ffffffffffffffffff00000000; // ((1 << 72) - 1) << 32
uint8 constant shiftRedistributionParticipants = 104;
uint256 constant maskRedistributionParticipants = 0x00000000000000000000000000000fffffffff00000000000000000000000000; // ((1 << 36) - 1) << 104
uint8 constant shiftRedistributionDemurrage = 140;
uint256 constant maskRedistributionDemurrage = 0x000000000000000000000000fffff00000000000000000000000000000000000; // ((1 << 20) - 1) << 140
uint8 constant shiftRedistributionIsFractional = 255;
uint256 constant maskRedistributionIsFractional = 0x8000000000000000000000000000000000000000000000000000000000000000; // 1 << 255
// Account bit field, with associated shifts and masks
// Mirrors structure of redistributions for consistency
mapping (address => bytes32) account; // uint152(unused) | uint32(period) | uint72(value)
uint8 constant shiftAccountValue = 0;
uint256 constant maskAccountValue = 0x0000000000000000000000000000000000000000000000ffffffffffffffffff; // (1 << 72) - 1
uint8 constant shiftAccountPeriod = 72;
uint256 constant maskAccountPeriod = 0x00000000000000000000000000000000000000ffffffff000000000000000000; // ((1 << 32) - 1) << 72
// TODO: use 2 x uint128 instead
// Demurrage cache bit field, with associated shifts and masks
uint256 public demurrageModifier; // PPM uint128(block) | uint128(periodppm)
uint8 constant shiftDemurrageValue = 0;
uint256 constant maskDemurrageValue = 0x00000000000000000000000000000000ffffffffffffffffffffffffffffffff;
uint8 constant shiftDemurragePeriod = 128;
uint256 constant maskDemurragePeriod = 0xffffffffffffffffffffffffffffffff00000000000000000000000000000000;
// Implements EIP172
address public owner; address public owner;
// Implements ERC20
string public name; string public name;
// Implements ERC20
string public symbol; string public symbol;
// Implements ERC20
uint256 public decimals; uint256 public decimals;
// Implements ERC20
uint256 public totalSupply; uint256 public totalSupply;
// Minimum amount of (demurraged) tokens an account must spend to participate in redistribution for a particular period
uint256 public minimumParticipantSpend; uint256 public minimumParticipantSpend;
// 128 bit resolution of the demurrage divisor
// (this constant x 1000000 is contained within 128 bits)
uint256 constant ppmDivider = 100000000000000000000000000000000; uint256 constant ppmDivider = 100000000000000000000000000000000;
uint256 public immutable periodStart; // timestamp // Timestamp of start of periods (time which contract constructor was called)
uint256 public immutable periodDuration; // duration in SECONDS uint256 public immutable periodStart;
uint256 public immutable taxLevel; // PPM per MINUTE
uint256 public demurrageModifier; // PPM uint128(block) | uint128(ppm)
bytes32[] public redistributions; // uint1(isFractional) | uint95(unused) | uint20(demurrageModifier) | uint36(participants) | uint72(value) | uint32(period) // Duration of a single redistribution period in seconds
mapping (address => bytes32) account; // uint152(unused) | uint32(period) | uint72(value) uint256 public immutable periodDuration;
// Demurrage in ppm per minute
uint256 public immutable taxLevel;
// Addresses allowed to mint new tokens
mapping (address => bool) minter; mapping (address => bool) minter;
// Storage for ERC20 approve/transferFrom methods
mapping (address => mapping (address => uint256 ) ) allowance; // holder -> spender -> amount (amount is subject to demurrage) mapping (address => mapping (address => uint256 ) ) allowance; // holder -> spender -> amount (amount is subject to demurrage)
address sinkAddress; // receives redistribuion remainders // Address to send unallocated redistribution tokens
address sinkAddress;
// Implements ERC20
event Transfer(address indexed _from, address indexed _to, uint256 _value); event Transfer(address indexed _from, address indexed _to, uint256 _value);
// Implements ERC20
event Approval(address indexed _owner, address indexed _spender, uint256 _value); event Approval(address indexed _owner, address indexed _spender, uint256 _value);
// New tokens minted
event Mint(address indexed _minter, address indexed _beneficiary, uint256 _value); event Mint(address indexed _minter, address indexed _beneficiary, uint256 _value);
event Debug(bytes32 _foo);
// New demurrage cache milestone calculated
event Decayed(uint256 indexed _period, uint256 indexed _periodCount, uint256 indexed _oldAmount, uint256 _newAmount); event Decayed(uint256 indexed _period, uint256 indexed _periodCount, uint256 indexed _oldAmount, uint256 _newAmount);
// When a new period threshold has been crossed
event Period(uint256 _period); event Period(uint256 _period);
// Redistribution applied on a single eligible account
event Redistribution(address indexed _account, uint256 indexed _period, uint256 _value); event Redistribution(address indexed _account, uint256 indexed _period, uint256 _value);
// Temporary event used in development, will be removed on prod
event Debug(bytes32 _foo);
constructor(string memory _name, string memory _symbol, uint8 _decimals, uint256 _taxLevelMinute, uint256 _periodMinutes, address _defaultSinkAddress) public { constructor(string memory _name, string memory _symbol, uint8 _decimals, uint256 _taxLevelMinute, uint256 _periodMinutes, address _defaultSinkAddress) public {
// ACL setup
owner = msg.sender; owner = msg.sender;
minter[owner] = true; minter[owner] = true;
periodStart = block.timestamp;
periodDuration = _periodMinutes * 60; // ERC20 setup
name = _name; name = _name;
symbol = _symbol; symbol = _symbol;
decimals = _decimals; decimals = _decimals;
// Demurrage setup
periodStart = block.timestamp;
periodDuration = _periodMinutes * 60;
demurrageModifier = ppmDivider * 1000000; // Represents 38 decimal places demurrageModifier = ppmDivider * 1000000; // Represents 38 decimal places
demurrageModifier |= (1 << 128); demurrageModifier |= (1 << 128);
taxLevel = _taxLevelMinute; // Represents 38 decimal places taxLevel = _taxLevelMinute; // Represents 38 decimal places
sinkAddress = _defaultSinkAddress;
bytes32 initialRedistribution = toRedistribution(0, 1000000, 0, 1); bytes32 initialRedistribution = toRedistribution(0, 1000000, 0, 1);
redistributions.push(initialRedistribution); redistributions.push(initialRedistribution);
// Misc settings
sinkAddress = _defaultSinkAddress;
minimumParticipantSpend = 10 ** uint256(_decimals); minimumParticipantSpend = 10 ** uint256(_decimals);
} }
@ -57,7 +127,14 @@ contract RedistributedDemurrageToken {
return true; return true;
} }
/// ERC20 // Given address will no longer be allowed to call the mintTo() function
function removeMinter(address _minter) public returns (bool) {
require(msg.sender == owner || _minter == msg.sender);
minter[_minter] = false;
return true;
}
/// Implements ERC20
function balanceOf(address _account) public view returns (uint256) { function balanceOf(address _account) public view returns (uint256) {
uint256 baseBalance; uint256 baseBalance;
uint256 anchorDemurrageAmount; uint256 anchorDemurrageAmount;
@ -78,7 +155,7 @@ contract RedistributedDemurrageToken {
/// Balance unmodified by demurrage /// Balance unmodified by demurrage
function baseBalanceOf(address _account) public view returns (uint256) { function baseBalanceOf(address _account) public view returns (uint256) {
return uint256(account[_account]) & 0xffffffffffffffffff; return uint256(account[_account]) & maskAccountValue;
} }
/// Increases base balance for a single account /// Increases base balance for a single account
@ -96,8 +173,8 @@ contract RedistributedDemurrageToken {
oldBalance = baseBalanceOf(_account); oldBalance = baseBalanceOf(_account);
newBalance = oldBalance + _delta; newBalance = oldBalance + _delta;
require(uint160(newBalance) > uint160(oldBalance), 'ERR_WOULDWRAP'); // revert if increase would result in a wrapped value require(uint160(newBalance) > uint160(oldBalance), 'ERR_WOULDWRAP'); // revert if increase would result in a wrapped value
workAccount &= 0xfffffffffffffffffffffffffffffffffffffffffffff000000000000000000; workAccount &= (~maskAccountValue);
workAccount |= newBalance & 0xffffffffffffffffff; workAccount |= (newBalance & maskAccountValue);
account[_account] = bytes32(workAccount); account[_account] = bytes32(workAccount);
return true; return true;
} }
@ -117,8 +194,8 @@ contract RedistributedDemurrageToken {
oldBalance = baseBalanceOf(_account); oldBalance = baseBalanceOf(_account);
require(oldBalance >= _delta, 'ERR_OVERSPEND'); // overspend guard require(oldBalance >= _delta, 'ERR_OVERSPEND'); // overspend guard
newBalance = oldBalance - _delta; newBalance = oldBalance - _delta;
workAccount &= 0xfffffffffffffffffffffffffffffffffffffffffffff000000000000000000; workAccount &= (~maskAccountValue);
workAccount |= newBalance & 0xffffffffffffffffff; workAccount |= (newBalance & maskAccountValue);
account[_account] = bytes32(workAccount); account[_account] = bytes32(workAccount);
return true; return true;
} }
@ -144,31 +221,31 @@ contract RedistributedDemurrageToken {
function toRedistribution(uint256 _participants, uint256 _demurrageModifierPpm, uint256 _value, uint256 _period) private pure returns(bytes32) { function toRedistribution(uint256 _participants, uint256 _demurrageModifierPpm, uint256 _value, uint256 _period) private pure returns(bytes32) {
bytes32 redistribution; bytes32 redistribution;
redistribution |= bytes32((_demurrageModifierPpm & 0x0fffff) << 140); redistribution |= bytes32((_demurrageModifierPpm << shiftRedistributionDemurrage) & maskRedistributionDemurrage);
redistribution |= bytes32((_participants & 0x0fffffffff) << 104); redistribution |= bytes32((_participants << shiftRedistributionParticipants) & maskRedistributionParticipants);
redistribution |= bytes32((_value & 0xffffffffffffffffff) << 32); redistribution |= bytes32((_value << shiftRedistributionValue) & maskRedistributionValue);
redistribution |= bytes32(_period & 0xffffffff); redistribution |= bytes32(_period & maskRedistributionPeriod);
return redistribution; return redistribution;
} }
// Serializes the demurrage period part of the redistribution word // Serializes the demurrage period part of the redistribution word
function toRedistributionPeriod(bytes32 redistribution) public pure returns (uint256) { function toRedistributionPeriod(bytes32 redistribution) public pure returns (uint256) {
return uint256(redistribution) & 0xffffffff; return uint256(redistribution) & maskRedistributionPeriod;
} }
// Serializes the supply part of the redistribution word // Serializes the supply part of the redistribution word
function toRedistributionSupply(bytes32 redistribution) public pure returns (uint256) { function toRedistributionSupply(bytes32 redistribution) public pure returns (uint256) {
return uint256(redistribution & 0x00000000000000000000000000000000000000ffffffffffffffffff00000000) >> 32; return (uint256(redistribution) & maskRedistributionValue) >> shiftRedistributionValue;
} }
// Serializes the number of participants part of the redistribution word // Serializes the number of participants part of the redistribution word
function toRedistributionParticipants(bytes32 redistribution) public pure returns (uint256) { function toRedistributionParticipants(bytes32 redistribution) public pure returns (uint256) {
return uint256(redistribution & 0x00000000000000000000000000000fffffffff00000000000000000000000000) >> 104; return (uint256(redistribution) & maskRedistributionParticipants) >> shiftRedistributionParticipants;
} }
// Serializes the number of participants part of the redistribution word // Serializes the number of participants part of the redistribution word
function toRedistributionDemurrageModifier(bytes32 redistribution) public pure returns (uint256) { function toRedistributionDemurrageModifier(bytes32 redistribution) public pure returns (uint256) {
return uint256(redistribution & 0x000000000000000000000000fffff00000000000000000000000000000000000) >> 140; return (uint256(redistribution) & maskRedistributionDemurrage) >> shiftRedistributionDemurrage;
} }
// Client accessor to the redistributions array length // Client accessor to the redistributions array length
@ -185,8 +262,8 @@ contract RedistributedDemurrageToken {
currentRedistribution = redistributions[redistributions.length-1]; currentRedistribution = redistributions[redistributions.length-1];
participants = toRedistributionParticipants(currentRedistribution) + 1; participants = toRedistributionParticipants(currentRedistribution) + 1;
tmpRedistribution = uint256(currentRedistribution); tmpRedistribution = uint256(currentRedistribution);
tmpRedistribution &= 0xfffffffffffffffffffffffffffff000000000ffffffffffffffffffffffffff; tmpRedistribution &= (~maskRedistributionParticipants);
tmpRedistribution |= (participants & 0x0fffffffff) << 104; tmpRedistribution |= ((participants << shiftRedistributionParticipants) & maskRedistributionParticipants);
redistributions[redistributions.length-1] = bytes32(tmpRedistribution); redistributions[redistributions.length-1] = bytes32(tmpRedistribution);
@ -198,8 +275,8 @@ contract RedistributedDemurrageToken {
uint256 currentRedistribution; uint256 currentRedistribution;
currentRedistribution = uint256(redistributions[redistributions.length-1]); currentRedistribution = uint256(redistributions[redistributions.length-1]);
currentRedistribution &= 0xffffffffffffffffffffffffffffffffffffff000000000000000000ffffffff; currentRedistribution &= (~maskRedistributionValue);
currentRedistribution |= totalSupply << 32; currentRedistribution |= (totalSupply << shiftRedistributionValue);
redistributions[redistributions.length-1] = bytes32(currentRedistribution); redistributions[redistributions.length-1] = bytes32(currentRedistribution);
return true; return true;
@ -225,13 +302,13 @@ contract RedistributedDemurrageToken {
// Deserialize the pemurrage period for the given account is participating in // Deserialize the pemurrage period for the given account is participating in
function accountPeriod(address _account) public view returns (uint256) { function accountPeriod(address _account) public view returns (uint256) {
return (uint256(account[_account]) & 0x00000000000000000000000000000000000000ffffffff000000000000000000) >> 72; return (uint256(account[_account]) & maskAccountPeriod) >> shiftAccountPeriod;
} }
// Save the given demurrage period as the currently participation period for the given address // Save the given demurrage period as the currently participation period for the given address
function registerAccountPeriod(address _account, uint256 _period) private returns (bool) { function registerAccountPeriod(address _account, uint256 _period) private returns (bool) {
account[_account] &= 0xffffffffffffffffffffffffffffffffffffff00000000ffffffffffffffffff; account[_account] &= bytes32(~maskAccountPeriod);
account[_account] |= bytes32(_period << 72); account[_account] |= bytes32((_period << shiftAccountPeriod) & maskAccountPeriod);
incrementRedistributionParticipants(); incrementRedistributionParticipants();
return true; return true;
} }
@ -268,11 +345,11 @@ contract RedistributedDemurrageToken {
if (truncatedResult < redistributionSupply) { if (truncatedResult < redistributionSupply) {
redistributionPeriod = toRedistributionPeriod(_redistribution); // since we reuse period here, can possibly be optimized by passing period instead redistributionPeriod = toRedistributionPeriod(_redistribution); // since we reuse period here, can possibly be optimized by passing period instead
redistributions[redistributionPeriod-1] &= 0xfffffffffffffffffffffffffffff000000000ffffffffffffffffffffffffff; // just to be safe, zero out all participant count data, in this case there will be only one redistributions[redistributionPeriod-1] &= bytes32(~maskRedistributionParticipants); // just to be safe, zero out all participant count data, in this case there will be only one
redistributions[redistributionPeriod-1] |= 0x8000000000000000000000000000000000000100000000000000000000000000; redistributions[redistributionPeriod-1] |= bytes32(maskRedistributionIsFractional | (1 << shiftRedistributionParticipants));
} }
increaseBaseBalance(sinkAddress, unit / ppmDivider); //truncatedResult); increaseBaseBalance(sinkAddress, unit / ppmDivider);
return unit; return unit;
} }
@ -285,8 +362,8 @@ contract RedistributedDemurrageToken {
return false; return false;
} }
// is this needed? // TODO: is this needed?
redistributions[_period-1] |= 0x8000000000000000000000000000000000000000000000000000000000000000; redistributions[_period-1] |= bytes32(maskRedistributionIsFractional);
periodSupply = toRedistributionSupply(redistributions[_period-1]); periodSupply = toRedistributionSupply(redistributions[_period-1]);
increaseBaseBalance(sinkAddress, periodSupply - _remainder); increaseBaseBalance(sinkAddress, periodSupply - _remainder);
@ -294,14 +371,17 @@ contract RedistributedDemurrageToken {
} }
// Deserialize demurrage amount from demurrage bitfield
function toDemurrageAmount(uint256 _demurrage) public pure returns (uint256) { function toDemurrageAmount(uint256 _demurrage) public pure returns (uint256) {
return _demurrage & 0x00000000000000000000000000000000ffffffffffffffffffffffffffffffff; return _demurrage & maskDemurrageValue;
} }
// Deserialize demurrage period from demurrage bitfield
function toDemurragePeriod(uint256 _demurrage) public pure returns (uint256) { function toDemurragePeriod(uint256 _demurrage) public pure returns (uint256) {
return (_demurrage & 0xffffffffffffffffffffffffffffffff00000000000000000000000000000000) >> 128; return (_demurrage & maskDemurragePeriod) >> shiftDemurragePeriod;
} }
// Calculate and cache the demurrage value corresponding to the (period of the) time of the method call
function applyDemurrage() public returns (bool) { function applyDemurrage() public returns (bool) {
uint256 epochPeriodCount; uint256 epochPeriodCount;
uint256 periodCount; uint256 periodCount;
@ -316,8 +396,8 @@ contract RedistributedDemurrageToken {
lastDemurrageAmount = toDemurrageAmount(demurrageModifier); lastDemurrageAmount = toDemurrageAmount(demurrageModifier);
newDemurrageAmount = decayBy(lastDemurrageAmount, periodCount); newDemurrageAmount = decayBy(lastDemurrageAmount, periodCount);
demurrageModifier = 0; demurrageModifier = 0;
demurrageModifier |= (newDemurrageAmount & 0x00000000000000000000000000000000ffffffffffffffffffffffffffffffff); demurrageModifier |= (newDemurrageAmount & maskDemurrageValue);
demurrageModifier |= (epochPeriodCount << 128); demurrageModifier |= ((epochPeriodCount << shiftDemurragePeriod) & maskDemurragePeriod);
emit Decayed(epochPeriodCount, periodCount, lastDemurrageAmount, newDemurrageAmount); emit Decayed(epochPeriodCount, periodCount, lastDemurrageAmount, newDemurrageAmount);
return true; return true;
} }
@ -334,7 +414,6 @@ contract RedistributedDemurrageToken {
// Recalculate the demurrage modifier for the new period // Recalculate the demurrage modifier for the new period
// After this, all REPORTED balances will have been reduced by the corresponding ratio (but the effecive totalsupply stays the same) // After this, all REPORTED balances will have been reduced by the corresponding ratio (but the effecive totalsupply stays the same)
//function applyTax() public returns (uint256) {
function changePeriod() public returns (bool) { function changePeriod() public returns (bool) {
bytes32 currentRedistribution; bytes32 currentRedistribution;
bytes32 nextRedistribution; bytes32 nextRedistribution;
@ -380,11 +459,11 @@ contract RedistributedDemurrageToken {
return true; return true;
} }
// Reverse a value reduced by demurrage by the given period to its original value
function growBy(uint256 _value, uint256 _period) public view returns (uint256) { function growBy(uint256 _value, uint256 _period) public view returns (uint256) {
uint256 valueFactor; uint256 valueFactor;
uint256 truncatedTaxLevel; uint256 truncatedTaxLevel;
// TODO: if can't get to work, reverse the iteration from current period.
valueFactor = 1000000; valueFactor = 1000000;
truncatedTaxLevel = taxLevel / ppmDivider; truncatedTaxLevel = taxLevel / ppmDivider;
@ -395,12 +474,11 @@ contract RedistributedDemurrageToken {
} }
// Calculate a value reduced by demurrage by the given period // Calculate a value reduced by demurrage by the given period
// TODO: higher precision // TODO: higher precision if possible
function decayBy(uint256 _value, uint256 _period) public view returns (uint256) { function decayBy(uint256 _value, uint256 _period) public view returns (uint256) {
uint256 valueFactor; uint256 valueFactor;
uint256 truncatedTaxLevel; uint256 truncatedTaxLevel;
// TODO: if can't get to work, reverse the iteration from current period.
valueFactor = 1000000; valueFactor = 1000000;
truncatedTaxLevel = taxLevel / ppmDivider; truncatedTaxLevel = taxLevel / ppmDivider;
@ -436,7 +514,8 @@ contract RedistributedDemurrageToken {
baseValue = ((supply / participants) * (taxLevel / 1000000)) / ppmDivider; baseValue = ((supply / participants) * (taxLevel / 1000000)) / ppmDivider;
value = (baseValue * demurrage) / 1000000; value = (baseValue * demurrage) / 1000000;
account[_account] &= bytes32(0xffffffffffffffffffffffffffffffffffffff00000000ffffffffffffffffff); // zero out period for the account
account[_account] &= bytes32(~maskAccountPeriod);
increaseBaseBalance(_account, value); increaseBaseBalance(_account, value);
emit Redistribution(_account, period, value); emit Redistribution(_account, period, value);
@ -469,7 +548,6 @@ contract RedistributedDemurrageToken {
changePeriod(); changePeriod();
applyRedistributionOnAccount(msg.sender); applyRedistributionOnAccount(msg.sender);
// TODO: Prefer to truncate the result, instead it seems to round to nearest :/
baseValue = toBaseAmount(_value); baseValue = toBaseAmount(_value);
result = transferBase(msg.sender, _to, baseValue); result = transferBase(msg.sender, _to, baseValue);
emit Transfer(msg.sender, _to, _value); emit Transfer(msg.sender, _to, _value);