All notable changes to this project will be documented in this file.
2.1.0 13-09-18
rateis now accepted as multiplied by 10^18 to allow settting higher price than 1ETH/POLY per token.
- Added support for multiple stable coins in USDTSTO.
- Added
buyTokensViewandgetTokensMintedByTierto USDTSTO. - Added
getSTODetailsto USDTSTO. - Added an Array of Tiers that will hold data about every tier in USDTSTO.
- Added
buyWithETHRateLimited,buyWithPOLYRateLimitedandbuyWithUSDRateLimitedto USDTSTO. - Added
getTokensSoldByTierto return sold (not minted during finalisation) tokens in each tier to USDTSTO. - Removed individual mappings for tier data removed in UDSTSTO.
getInvestors,getAllInvestorsData,getInvestorsDataadded to GTM to allow easy data queries.modifyDefaults(uint64 _defaultFromTime, uint64 _defaultToTime)added which sets a default timestamp used whenfromTimeortoTimeare 0- Add
address[] public investorsto record a list of all addresses that have been added to the whitelist (getInvestors). - General Transfer Manager: Fix for when
allowAllWhitelistIssuancesis FALSE - General Transfer Manager: Make GTM a Proxy based implementation to reduce deployment gas costs
- Changed the version of
GeneralTransferManagerFactoryfrom1.0.0to2.1.0.
- Removed
0x0check for the_fromaddress toManualApprovalTransferManager. This allows for the Issuer/Transfer Agent to approve a one-off mint of tokens that otherwise would not be possible. - Changed the version of
ManualApprovalTransferManagerFactoryfrom1.0.0to2.1.0. - Deployed 2.0.1
ManualApprovalTransferManagerFactoryto address 0x6af2afad53cb334e62b90ddbdcf3a086f654c298
- Changed the version of
ERC20DividendCheckpointFactory&EtherDividendCheckpointFactoryfrom1.0.0to2.1.0. - Applied proxy pattern to Dividends modules
getAllModulesAndPermsFromTypes()does not take securityToken address as a parameter anymore.
1.5.0 15-08-18
- Added
getInvestorsAtwhich returns the investors (non-zero balances) at a particular checkpoint - Added
iterateInvestorsto allow an a subset ofinvestorsto be returned from the security token in caseinvestorsis large. ChangeModuleBudgetin SecurityToken now takes in the change in budget rather than absoulte budget. Added boolean paramter to decide increase/decrease.- Added
createCheckpoint() withPerm(CHECKPOINT)to dividend checkpoint modules. - Added
deleteDelegate()to general permission manager. It will disable the delegate but not delete the perms. - Migrated from
npmtoyarn. - Added
SingleTradeVolumeRestrictionManagermodule - Added flag in
PercentageTransferManagerto allow ignoring of issuance transfers - Added
transferWithData,transferFromWithData,mintWithData,burnWithDatato allow passing of abytes _datafor off-chain validation - Added ability for modules to have multiple types
- Added
namefield to dividends struct in DividendCheckpoint. #295 - Added
getTagsByType,getTagsByTypeAndToken,getModulesByType,getModulesByTypeAndTokento MR - Added
getTokensByOwnerto STR - Added withholding tax to ether & erc20 dividends
- Generalised MakerDAO oracle to allow different instances referencing different currencies
- Added DAI as a fundraising currency to USDTieredSTO
transferTickerOwnership()function is introduced inTickerRegistryto transfer the ticker ownership after the registeration #191.getTickersByOwner()function is used to get the list of tickers owned by the issuer #189.- New function
addCustomTicker()is used the add the Ticker in tickerRegistry. To avail the facility to Registry owner to add the tokens without paying the fee #190. - Adding the functionality to change the
version,name,description,titleof a Module factory. - Add the
registrationTimestampin theSecurityTokenDatastructure that also leads the change in thegetSecurityTokenData()return parameters. #199 - Add
_deployedAtnew parameter in theaddCustomSecurityToken. #199 - Add
getReputationOfFactory()&getModuleListOfType()functions to get the array type data from the ModuleRegistry contract. - Add
_setupCostinLogGenerateModuleFromFactoryevent. - Add new function
getAllModulesByName(), To get the list of modules having the same name. #198. - Add new function
modifyTickerDetails(), To modify the details of undeployed ticker. #230
- 0x0 and duplicate address in exclusions are no longer allowed in dividend modules.
- All permissions are denied if no permission manager is active.
- Generalize the STO varaible names and added them in
ISTO.solto use the common standard in all STOs. - Generalize the event when any new token get registered with the polymath ecosystem.
LogNewSecurityTokenshould emit _ticker, _name, _securityTokenAddress, _owner, _addedAt, _registrant respectively. #230 - Change the function name of
withdraPolytowithdrawERC20and make the function generalize to extract tokens from the ST contract. parmeters are contract address and the value need to extract from the securityToken.
- Removed investors list pruning
- Remove
swarmHashfrom theregisterTicker(), addCustomTicker(), generateSecurityToken(), addCustomSecurityToken()functions of TickerRegistry.sol and SecurityTokenRegistry.sol. #230 - Remove
Logprefix from all the event present in the ecosystem. - Removed
addTagByModuleType&removeTagsByModuleTypefrom MR.
======
1.4.1 13-08-18
- Test cases for 1.4.1 migration
- STR Migration script
- Encrypted API Key for CMC queries in PolyOracle
- Remove endData update from unpause function
- Allow custom tokens to be added when STR is paused
- PolyOracle does not revert on out of order callbacks (silently ignores instead)
- Removed USDTieredSTO > STR dependency by moving oracle registry to PolymathRegistry
- Rounding edge cases in USDTieredSTO.sol that could have reverted valid transactions
- Fix #239: fix basic fee logic for ongoing module fees
- Fix #238: make beneficial investments optionally supported (default to not allowed)
1.4.0 13-08-18
- USDTieredSTO module added as a new STO type. Allows to raise with multiple tiers while pegging price to USD. The USDTieredSTO contract gets the USD to POLY/ETH rate from the STR which contains references to pricing oracles.
- Added PolyOracle to get POLY/USD price for the USDTieredSTO.
- Added MakerDAOOracle to get ETH/USD price for the USDTieredSTO.
- Added CLI for USDTieredSTO.
- Scripts for monitoring Oracles' status.
- Scripts for monitoring Polymath stats (Tokens registered, tokens deployed, STOs launched).
- Test cases for 1.4.1 migration
- STR Migration script
- Encrypted API Key for CMC queries in PolyOracle
- Modified CappedSTOFactory to comply with minor interface changes in iSTO. It now uses a mapping named
fundRaiseTypeto specify the fundraise type (ETH / POLY) - Remove endData update from unpause function
- Allow custom tokens to be added when STR is paused
- PolyOracle does not revert on out of order callbacks (silently ignores instead)
- Removed USDTieredSTO > STR dependency by moving oracle registry to PolymathRegistry
- Modified function name in TickerRegistry and SecurityTokenRegistry from
changePolyRegisterationFeetochangePolyRegistrationFee. Event name is modified too fromLogChangePolyRegisterationFeetoLogChangePolyRegistrationFee - Minor CLI fixes
- Change in the datastructure of SymbolDetails new variable
expiredTimestampintroduced and change the variable nametimestamptoregisteredTimestampin Tickerregistry.sol #192. - Rounding edge cases in USDTieredSTO.sol that could have reverted valid transactions
- Bug in ManualApprovalTransferManager that allowed anyone to reduce anyone's transfer allowance
=======
1.3.0 25-07-18
- Implemented
finishedIssuerMinting / finishedSTOMinting. The former permanently forbids the issuer from minting tokens. The latter permanently forbids STO modules from minting tokens. - Added registry of registries. Contracts should point to the registry which acts as a proxy and delegates to the corresponding registry contract.
- Added ModifyWhitelistMulti to Percentage Transfer Manager.
- Add the
Transferevent in the getTokens function call ofPolyTokenFaucet.sol. - Introduce the
_validflag in the event ofLogModifyWhitelistinPercentageTransferManager.sol
- Removed _locked parameter from modules. This was only used on STOs to allow the issuer to indicate they would not be minting more tokens after the STO (since it wouldn't be possible to remove it), but now we have the finishedSTOMinting flag that they can use to indicate so in a more transparent way.
1.2.1 27-06-18
- Further minting can be forbids on the Issuer level and the STO level using the functions
finishMintingIssuer(),finishMintingSTO(). modifyWhitelistMultiadded inPercentageTransferManagercontract.
##Changed
- Added extra parameter to TransferManager.verifyTransfer to indicate whether the call is part of a transfer or not.
- Logic of module locking is removed and also removes the
_lockedparameter. - Remove
finishMinting()function from theSecurityTokencontract.
1.2.0 22-05-18
- ERC20DividendCheckpoint module added for on-chain dividend ERC20 payments
- EtherDividendCheckpoint module added for on-chain dividend ETH payments
- Iterable list of investors available on-chain
- STOs are pausable now. It is facilated by using the Pausable contract.
- ManualApprovalTransferManager - allows approval or blocking of explicit address pairs for transfers.
- Module Factories now allow their owner to set 3 types of fees: Setup fee, Usage fee, Monthly fee.
- Added Checkpoint feature to token. This allows the issuer to create snapshots of the token's balances and totalSupply to be used for casting votes or distributing dividends. Created CLI to demo this feature.
- Further minting is forbidden by adding one additional check for
mintingFinishedflag. Issuer can stop minting by calling thefinishMinting()function. - Issuer can prevent addresses from participating in the STO. To facilitate this,
_canBuyFromSTOhas been added to modifyWhitelist function. - Added multi-mint feature.
- Event
LogGenerateModuleFromFactoryemitted at the level of ModuleFactory to log the creation of the module using the respective module factory. - Added registration fee of
250 POLYfor registering ticker or security token with registry contracts, fee can be changed usingchangePolyRegistrationFee. - Added ReclaimTokens contract to handle retrieving ERC20 Tokens sent to our contracts.
- Added Pausable feature to registry functions
registerTicker,generateSecurityToken,registerModule,addCustomSecurityToken. - Added Registry contract to handle upgradability functionality with a function to change the reference address between registry contracts.
- POLY faucet CLI is added in demo.
getDividendIndex()is introduced inERC20DividendCheckpoint&EtherDividendCheckpointcontract.
- Added extra parameter to TransferManager.verifyTransfer to indicate whether the call is part of a transfer or not.
- Added a new return type to verifyTransfer methods called FORCE_VALID which would override any INVALID returned by TransferManagers if needed. For example, this could be used if we wanted the Manual Approval TM to force a transfer to happen even if the CountTM said that the 2000 investor cap had been reached.
- Burning tokens now respects TransferManagers and investorCount.
- Updated CLI with MultiMint process.
- Change the
setupCostofcappedSTOFactoryfrom0 POLYto20K POLY. - Add one more parameter called the
_ownerin theaddCustomSecurityToken(). - Change
_addModulein SecurityToken.sol to get MR address from STR contract. - Update CLI with POLY payments.
ExchangeTransferManagerFactoryandExchangeTransferManageris removed from repository.
1.1.0 18-05-18
- Factored out the second reference to the POLY token from ISTO contracts
- Defaulted all STs to have 18 decimals
- Removed decimals parameter from
generateSecurityToken - Modified TokenBurner to be an interface
- Moved CappedSTO specific functions to CappedSTO from ISTO
- Moved TokenBurner & PolyToken contracts to test directory (out of main contract directory)
- Modified IST20 interface to inherit from ERC20 interfaces
- Modified verifyTransfer function in TransferManagers to return a Result enumeration instead of boolean
- Fixed
capReached()which was checking fundsRaised agains cap, but the cap is expressed in tokens. - Constant key variables migrated from the securityToken to ISecurityToken contract.
- Solidity compiler version get changed to 0.4.23 that leads to the addition of reason string in the
requireandrevertstatements. - zeppelin-solidity package version and name get changed to openzeppelin-solidity v1.9.0.
- whitelists for CountTransferManager and PercentageTransferManager to bypass logic
- added CountTransferManager to restrict the total number of token holders
- added PercentageTransferManager to restrict the total percentage of tokens held by any single holder
- generateSecurityToken in SecurityTokenRegistry takes an additional parameter specifying whether the token is divisible.
- IModule contract takes the polyToken contract address as the constructor argument to wrapping all the factories with the polyToken contract address.
takeFee()new function introduced to extract the POLY token from the factory. It only be called by the owner of the factory.- Added ability for issuer to provide a signed piece of data to allow investors to whitelist themselves.
_securityTokenAddressget indexed in theLogNewSecurityTokenevent.- Now each investor have its
expiryTimefor the KYC. After the expiryTime limit reached, investor will not abe to use transfer related functions. - Transfers of tokens gets paused at the level of all TM as well as on the ST level. To facilitate this 3 functions get added namely
pause(),unpause(),freezeTransfers(). All 3 functions are called by the issuer of the securityToken only. - Security token has got a new feature of burning the tokens, To use this feature user need to call the
burn()function but before that issuer need to deploy theTokenBurnercontract and set its address into the SecurityToken contract using the functionsetTokenBurner().
investorStatus()function in securityToken contract has removed.
0.3.1 06-04-18
- Add
emitkeyword to emit the events. - Two new variable is added at the time of registration of ticker.
swarmHashrepresents the off-chain data storage location on IPFS andownerIt reperesent the ethereum address of the owner. LogRegisterTickeremits two more variable called_swarmHashand_owner.- Two events are added in
GeneralPermissionManagercontract to facilitate the notifications for the UI end.LogChangePermission:Emit when permissions to a delegate get changed.
LogAddPermission: Emit when delegate is added in permission manager contract. getInstructions()is a public function added into the factories contracts. Use to get the useful instructions about the corresponding factory._securityTokenRegistryis more argument is added in securityTokenV2 contract.
- All contracts get migrated from solc version 0.4.18 to 0.4.21.
- Now symbols get stored in smart contract in uppercase instead of lowercase.
- Public variable
STRAdressname in TickerRegistry smart contract changed tostrAddress. - Function
permissions()name in all module factories get changed togetPermissions(). - Function
delegateDetails()name gets changed togetDelegateDetails()in GeneralPermissionManager contract. STVersionProxy_001 & STVersionProxy_002contract name changed to STVersionProxy001 & STVersionProxy002 respectively.
0.3.0 02-04-18
- Multiple events are added to
ModuleRegistrycontract to facilitate the Logging of the operations.
LogModuleUsed: Emit when Module get used by a securityToken.
LogModuleRegistered: Emit when a new module gets registered by the polymath for securityToken to use.
LogModuleVerified: Emit when module get verified by the ModuleRegistry owner. - ModuleRegistry now know about the SecurityTokenRegistry by using the function
setTokenRegistryand it only is called by the owner of the ModuleRegistry contract. verifyModulefunction added to verify the newly added modules on the polymath platform. It is a type of ownable function.securityTokenRegistrypublic variable added to store the address of the SecurityTokenRegistry. Andverifiedmapping added to hold the list of verifiedmoduleFactoryaddresses with a bool flag.- Now
getSecurityTokenData()is added to get the securityToken data instead of calling directly the public mappingsecurityTokens. - New variable
tokensSoldis added in the cappedSTO contract. It is used to track the amount of securityTokens sold. - New moduleFactory called
ExchangeTransferManagerFactoryis added in to the list of the available modules in the Polymath V1 system. - _budget is a new parameter added in the
addModule. It signifies the budget of the ongoing module in terms of POLY token. - Two new events added into the securityToken contract to facilitate the logging of the operations.
LogModuleRemoved: Event emit when module get removed from the securityToken.LogModuleBudgetChanged: Emit when module budget get changed. getModuleDatafunction added in the securityToken to get the data of the Module with the help of moduleType and the index of the module user want to get.removeModulenew function added facilitate the removal of the module from the securityToken. It is ownable type function.changeModuleBudgetfunction added to change the budget of the module that already been added. It is ownable type function.
- In early release token symbol in uppercase or in lowercase entertain differently. But for this release both upercase and lowercase symbol name are same.
- Address of the owner of the securityToken is removed from the strucuture of the
SecurityTokenData. - Mapping
securityTokensin ISecurityTokenRegistry is now being private instead of public. expiryLimitdefault value get changed to 7 days instead of the 90 days in TickerRegistry.- contact variable is replaced by the tokenName variable in
SymbolDetailsstructure of TickerRegistry. - Token name is now emitted in the
LogRegisterTickerevent corresponds to _name variable. - Now checkValidity function takes three arguments insted of two, tokenName is the third one.
- Cap is based on the number of securityToken sold instead of the quantity of the fundraised type.
- buyTokensWithPoly has only one argument called
_investedPolyonly. Beneficiary Address should be its msg.sender. - getRaiseEther() function name changed to getRaisedEther().
- getRaisePoly() function name changed to getRaisedPoly().
LogModuleAddedemit one more variable called _budget.modulesmapping in the securityToken contract now returns the array of ModuleData.
adminvaraible is removed from the TickerRegistry contract.
0.2.0 26-03-18
- ModuleRegistry contract will provide the list of modules by there types.
SecurityTokenRegistryis now working on the basis of the proxy version of the securitytoken contract. For that SecurityTokenRegistry has one more variable in the constructor called _STVersionProxy .setProtocolVersionnew function added in the SecurityTokenRegistry to set the protocol version followed to generate the securityToken. Only be called by thepolymath admin.SecurityTokennow have the integration with polyToken. At the time ofaddModule()SecurityToken approve the cost of the module to moduleFactory as the spender.- New function
withdrawPoly(uint256 _amount)is added to withdrawal the unused POLY from the securityToken contract. Called only by the owner of the contract. checkPermission(address _delegate, address _module, bytes32 _perm)function is added to check the permissions on the service providers(delegate).STVersionProxy_001.sol&STVersionProxy_002.solare the two new contract added. Both of those are the proxy contract use to generate the SecurityToken. Both contract constructor takes two variables address oftransferManagerFactoryaddress of thepermissionManagerFactory.- New Module type is added called
PermissionManager. It has three contracts called GeneralPermissionManagerFactory, GeneralPermissionManager, IPermissionManager. GeneralPermissionMangeris all about providing the permission to the delegate corresponds to the SecurityToken. Major functionality is added, check, change the permission of the delegate.- Two more functions added for each factory type i.e
getDescription()&getTitle(). CappedSTOis now Configurable by choosing the type of fundraise. Either POLY or ETH.CappedSTOtakes 3 more constructor arguments fundRaiseType (uint8), the address of the polyToken & address of the fund's receiver.buyTokensWithPoly(address _beneficiary, uint256 _investedPoly)new function added in cappedSTO to facilitate the funds raising with the POLY.verifyInvestment(address _beneficiary, uint256 _fundsAmount)new function added in ISTO to check whether the investor provides the allowance to the CappedSTO or not.LogModifyWhitelistevent of GeneralTransferManager emit two more variables. i.e address which added the investor in whitelist(_addedBy) and records the timestamp at which modification in whitelist happen(_dateAdded).permissions()function added in GeneralTransferManager to get all permissions.PolyToken.solcontract is added at contracts/helpers/PolyToken.sol. For now, it has no big use.
- ModuleRegistry only holds the module type of modules only not there names or cost anymore.
- No More ModuleReputation struct for counting the reputation of module. Now
reputationmapping only contains the list of the addresses those used that module factory. checkModule()of ModuleRegistry contract rename touseModule()with same function parameters.- Event
LogModuleAddedemit only 5 variables instead of 6. timestamp is no longer be a part of the event. SecurityTokenRegistrarnow renamed asSecurityTokenRegistry.- Deployment of the securityToken is now performed by the proxy contracts and call being generated form the SecurityTokenRegistry.
TickerRegistrarrenamed asTickerRegistry.- TickerRegistry is now Ownable contract.
setTokenRegistrarfunctio of TickerRegistry renamed tosetTokenRegistry.- SecurityToken constructor has one change in the variable. i.e
_moduleRegistrycontract address is replaced by the_owneraddress. - Their is no
_permparameter in theaddModule()function of the securityToken contract. Now only 4 parameters left. - Type of Mudules changed
- Permission has a type 1
- TransferManager has a type 2
- STO has a type 3 - Location of SecurityToken changed to
contracts/token/SecurityToken.sol - GeneralTransferManager takes only 1 variables as constructor argument i.e address of the securityToken.
- Functions of GeneralTransferManager earlier controlled by the owner only, now those can be controlled by the delegates as well with having proper permissions.
getCost()is removed from the ModuleRegistry contract.SafeMath.solcontract is replaced by the zeppelin-solidity library contract .- No more
SecurityTokensandsymbolinformation will be directly part of the SecurityTokenRegistry. Those information will accessed by inheriting theISecurityTokenRegistry. - Remove the Delegable.sol, AclHelpers.sol, DelegablePorting.sol contracts. Now permission manager factory takes their place . *
delegatesmapping removed from the GeneralTransferManager.