Interface for all security tokens (ISecurityToken.sol)

View Source: contracts/interfaces/ISecurityToken.sol

ISecurityToken

Events

event Transfer(address indexed from, address indexed to, uint256  value);
event Approval(address indexed owner, address indexed spender, uint256  value);
event ModuleAdded(uint8[]  _types, bytes32 indexed _name, address indexed _moduleFactory, address  _module, uint256  _moduleCost, uint256  _budget, bytes32  _label, bool  _archived);
event UpdateTokenDetails(string  _oldDetails, string  _newDetails);
event UpdateTokenName(string  _oldName, string  _newName);
event GranularityChanged(uint256  _oldGranularity, uint256  _newGranularity);
event FreezeIssuance();
event FreezeTransfers(bool  _status);
event CheckpointCreated(uint256 indexed _checkpointId, uint256  _investorLength);
event SetController(address indexed _oldController, address indexed _newController);
event TreasuryWalletChanged(address  _oldTreasuryWallet, address  _newTreasuryWallet);
event DisableController();
event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
event TokenUpgraded(uint8  _major, uint8  _minor, uint8  _patch);
event ModuleArchived(uint8[]  _types, address  _module);
event ModuleUnarchived(uint8[]  _types, address  _module);
event ModuleRemoved(uint8[]  _types, address  _module);
event ModuleBudgetChanged(uint8[]  _moduleTypes, address  _module, uint256  _oldBudget, uint256  _budget);
event TransferByPartition(bytes32 indexed _fromPartition, address  _operator, address indexed _from, address indexed _to, uint256  _value, bytes  _data, bytes  _operatorData);
event AuthorizedOperator(address indexed operator, address indexed tokenHolder);
event RevokedOperator(address indexed operator, address indexed tokenHolder);
event AuthorizedOperatorByPartition(bytes32 indexed partition, address indexed operator, address indexed tokenHolder);
event RevokedOperatorByPartition(bytes32 indexed partition, address indexed operator, address indexed tokenHolder);
event IssuedByPartition(bytes32 indexed partition, address indexed to, uint256  value, bytes  data);
event RedeemedByPartition(bytes32 indexed partition, address indexed operator, address indexed from, uint256  value, bytes  data, bytes  operatorData);
event DocumentRemoved(bytes32 indexed _name, string  _uri, bytes32  _documentHash);
event DocumentUpdated(bytes32 indexed _name, string  _uri, bytes32  _documentHash);
event ControllerTransfer(address  _controller, address indexed _from, address indexed _to, uint256  _value, bytes  _data, bytes  _operatorData);
event ControllerRedemption(address  _controller, address indexed _tokenHolder, uint256  _value, bytes  _data, bytes  _operatorData);
event Issued(address indexed _operator, address indexed _to, uint256  _value, bytes  _data);
event Redeemed(address indexed _operator, address indexed _from, uint256  _value, bytes  _data);

Functions

symbol

function symbol() external view
returns(string)

Arguments

name

function name() external view
returns(string)

Arguments

decimals

function decimals() external view
returns(uint8)

Arguments

totalSupply

function totalSupply() external view
returns(uint256)

Arguments

balanceOf

function balanceOf(address owner) external view
returns(uint256)

Arguments

allowance

function allowance(address owner, address spender) external view
returns(uint256)

Arguments

transfer

function transfer(address to, uint256 value) external nonpayable
returns(bool)

Arguments

transferFrom

function transferFrom(address from, address to, uint256 value) external nonpayable
returns(bool)

Arguments

approve

function approve(address spender, uint256 value) external nonpayable
returns(bool)

Arguments

decreaseAllowance

function decreaseAllowance(address spender, uint256 subtractedValue) external nonpayable
returns(bool)

Arguments

increaseAllowance

function increaseAllowance(address spender, uint256 addedValue) external nonpayable
returns(bool)

Arguments

canTransfer

Transfers of securities may fail for a number of reasons. So this function will used to understand the cause of failure by getting the byte value. Which will be the ESC that follows the EIP 1066. ESC can be mapped with a reson string to understand the failure cause, table of Ethereum status code will always reside off-chain

function canTransfer(address _to, uint256 _value, bytes _data) external view
returns(statusCode bytes1, reasonCode bytes32)

Returns

byte Ethereum status code (ESC)

Arguments

initialize

Initialization function

function initialize(address _getterDelegate) external nonpayable

Arguments

canTransferByPartition

The standard provides an on-chain function to determine whether a transfer will succeed, and return details indicating the reason if the transfer is not valid.

function canTransferByPartition(address _from, address _to, bytes32 _partition, uint256 _value, bytes _data) external view
returns(statusCode bytes1, reasonCode bytes32, partition bytes32)

Returns

ESC (Ethereum Status Code) following the EIP-1066 standard

Arguments

canTransferFrom

Transfers of securities may fail for a number of reasons. So this function will used to understand the cause of failure by getting the byte value. Which will be the ESC that follows the EIP 1066. ESC can be mapped with a reson string to understand the failure cause, table of Ethereum status code will always reside off-chain

function canTransferFrom(address _from, address _to, uint256 _value, bytes _data) external view
returns(statusCode bytes1, reasonCode bytes32)

Returns

byte Ethereum status code (ESC)

Arguments

setDocument

Used to attach a new document to the contract, or update the URI or hash of an existing attached document

function setDocument(bytes32 _name, string _uri, bytes32 _documentHash) external nonpayable

Arguments

removeDocument

Used to remove an existing document from the contract by giving the name of the document.

function removeDocument(bytes32 _name) external nonpayable

Arguments

getDocument

Used to return the details of a document with a known name (bytes32).

function getDocument(bytes32 _name) external view
returns(documentUri string, documentHash bytes32, documentTime uint256)

Returns

string The URI associated with the document.

Arguments

getAllDocuments

Used to retrieve a full list of documents attached to the smart contract.

function getAllDocuments() external view
returns(documentNames bytes32[])

Returns

bytes32 List of all documents names present in the contract.

Arguments

isControllable

In order to provide transparency over whether controllerTransfer / controllerRedeem are useable or not isControllable function will be used.

function isControllable() external view
returns(controlled bool)

Returns

bool true when controller address is non-zero otherwise return false.

Arguments

isModule

Checks if an address is a module of certain type

function isModule(address _module, uint8 _type) external view
returns(isValid bool)

Arguments

issue

This function must be called to increase the total supply (Corresponds to mint function of ERC20).

function issue(address _tokenHolder, uint256 _value, bytes _data) external nonpayable

Arguments

issueMulti

issue new tokens and assigns them to the target _tokenHolder.

function issueMulti(address[] _tokenHolders, uint256[] _values) external nonpayable

Returns

success

Arguments

issueByPartition

Increases totalSupply and the corresponding amount of the specified owners partition

function issueByPartition(bytes32 _partition, address _tokenHolder, uint256 _value, bytes _data) external nonpayable

Arguments

redeemByPartition

Decreases totalSupply and the corresponding amount of the specified partition of msg.sender

function redeemByPartition(bytes32 _partition, uint256 _value, bytes _data) external nonpayable

Arguments

redeem

This function redeem an amount of the token of a msg.sender. For doing so msg.sender may incentivize using different ways that could be implemented with in the redeem function definition. But those implementations are out of the scope of the ERC1594.

function redeem(uint256 _value, bytes _data) external nonpayable

Arguments

redeemFrom

This function redeem an amount of the token of a msg.sender. For doing so msg.sender may incentivize using different ways that could be implemented with in the redeem function definition. But those implementations are out of the scope of the ERC1594.

function redeemFrom(address _tokenHolder, uint256 _value, bytes _data) external nonpayable

Arguments

operatorRedeemByPartition

Decreases totalSupply and the corresponding amount of the specified partition of tokenHolder

function operatorRedeemByPartition(bytes32 _partition, address _tokenHolder, uint256 _value, bytes _data, bytes _operatorData) external nonpayable

Arguments

checkPermission

Validate permissions with PermissionManager if it exists, If no Permission return false

function checkPermission(address _delegate, address _module, bytes32 _perm) external view
returns(hasPermission bool)

Returns

success

Arguments

getModule

Returns module list for a module type

function getModule(address _module) external view
returns(moduleName bytes32, moduleAddress address, factoryAddress address, isArchived bool, moduleTypes uint8[], moduleLabel bytes32)

Returns

bytes32 Name

Arguments

getModulesByName

Returns module list for a module name

function getModulesByName(bytes32 _name) external view
returns(modules address[])

Returns

address[] List of modules with this name

Arguments

getModulesByType

Returns module list for a module type

function getModulesByType(uint8 _type) external view
returns(modules address[])

Returns

address[] List of modules with this type

Arguments

getTreasuryWallet

use to return the global treasury wallet

function getTreasuryWallet() external view
returns(treasuryWallet address)

Arguments

totalSupplyAt

Queries totalSupply at a specified checkpoint

function totalSupplyAt(uint256 _checkpointId) external view
returns(supply uint256)

Arguments

balanceOfAt

Queries balance at a specified checkpoint

function balanceOfAt(address _investor, uint256 _checkpointId) external view
returns(balance uint256)

Arguments

createCheckpoint

Creates a checkpoint that can be used to query historical balances / totalSuppy

function createCheckpoint() external nonpayable
returns(checkpointId uint256)

Arguments

getCheckpointTimes

Gets list of times that checkpoints were created

function getCheckpointTimes() external view
returns(checkpointTimes uint256[])

Returns

List of checkpoint times

Arguments

getInvestors

returns an array of investors NB - this length may differ from investorCount as it contains all investors that ever held tokens

function getInvestors() external view
returns(investors address[])

Returns

list of addresses

Arguments

getInvestorsAt

returns an array of investors at a given checkpoint NB - this length may differ from investorCount as it contains all investors that ever held tokens

function getInvestorsAt(uint256 _checkpointId) external view
returns(investors address[])

Returns

list of investors

Arguments

getInvestorsSubsetAt

returns an array of investors with non zero balance at a given checkpoint

function getInvestorsSubsetAt(uint256 _checkpointId, uint256 _start, uint256 _end) external view
returns(investors address[])

Returns

list of investors

Arguments

iterateInvestors

generates subset of investors NB - can be used in batches if investor list is large

function iterateInvestors(uint256 _start, uint256 _end) external view
returns(investors address[])

Returns

list of investors

Arguments

currentCheckpointId

Gets current checkpoint ID

function currentCheckpointId() external view
returns(checkpointId uint256)

Returns

Id

Arguments

isOperator

Determines whether _operator is an operator for all partitions of _tokenHolder

function isOperator(address _operator, address _tokenHolder) external view
returns(isValid bool)

Returns

Whether the _operator is an operator for all partitions of _tokenHolder

Arguments

isOperatorForPartition

Determines whether _operator is an operator for a specified partition of _tokenHolder

function isOperatorForPartition(bytes32 _partition, address _operator, address _tokenHolder) external view
returns(isValid bool)

Returns

Whether the _operator is an operator for a specified partition of _tokenHolder

Arguments

partitionsOf

Return all partitions

function partitionsOf(address _tokenHolder) external view
returns(partitions bytes32[])

Returns

List of partitions

Arguments

dataStore

Gets data store address

function dataStore() external view
returns(dataStoreAddress address)

Returns

data store address

Arguments

changeDataStore

Allows owner to change data store

function changeDataStore(address _dataStore) external nonpayable

Arguments

changeTreasuryWallet

Allows to change the treasury wallet address

function changeTreasuryWallet(address _wallet) external nonpayable

Arguments

withdrawERC20

Allows the owner to withdraw unspent POLY stored by them on the ST or any ERC20 token.

function withdrawERC20(address _tokenContract, uint256 _value) external nonpayable

Arguments

changeModuleBudget

Allows owner to increase/decrease POLY approval of one of the modules

function changeModuleBudget(address _module, uint256 _change, bool _increase) external nonpayable

Arguments

updateTokenDetails

Changes the tokenDetails

function updateTokenDetails(string _newTokenDetails) external nonpayable

Arguments

changeName

Allows owner to change token name

function changeName(string _name) external nonpayable

Arguments

changeGranularity

Allows the owner to change token granularity

function changeGranularity(uint256 _granularity) external nonpayable

Arguments

freezeTransfers

Freezes all the transfers

function freezeTransfers() external nonpayable

Arguments

unfreezeTransfers

Un-freezes all the transfers

function unfreezeTransfers() external nonpayable

Arguments

freezeIssuance

Permanently freeze issuance of this security token.

function freezeIssuance(bytes _signature) external nonpayable

Arguments

addModuleWithLabel

Attachs a module to the SecurityToken

function addModuleWithLabel(address _moduleFactory, bytes _data, uint256 _maxCost, uint256 _budget, bytes32 _label, bool _archived) external nonpayable

Arguments

addModule

Function used to attach a module to the security token

function addModule(address _moduleFactory, bytes _data, uint256 _maxCost, uint256 _budget, bool _archived) external nonpayable

Arguments

archiveModule

Archives a module attached to the SecurityToken

function archiveModule(address _module) external nonpayable

Arguments

unarchiveModule

Unarchives a module attached to the SecurityToken

function unarchiveModule(address _module) external nonpayable

Arguments

removeModule

Removes a module attached to the SecurityToken

function removeModule(address _module) external nonpayable

Arguments

setController

Used by the issuer to set the controller addresses

function setController(address _controller) external nonpayable

Arguments

controllerTransfer

This function allows an authorised address to transfer tokens between any two token holders. The transfer must still respect the balances of the token holders (so the transfer must be for at most balanceOf(_from) tokens) and potentially also need to respect other transfer restrictions.

function controllerTransfer(address _from, address _to, uint256 _value, bytes _data, bytes _operatorData) external nonpayable

Arguments

because use of _data parameter is implementation specific). | | _operatorData | bytes | data attached to the transfer by controller to emit in event. (It is more like a reason string for calling this function (aka force transfer) which provides the transparency on-chain). |

controllerRedeem

This function allows an authorised address to redeem tokens for any token holder. The redemption must still respect the balances of the token holder (so the redemption must be for at most balanceOf(_tokenHolder) tokens) and potentially also need to respect other transfer restrictions.

function controllerRedeem(address _tokenHolder, uint256 _value, bytes _data, bytes _operatorData) external nonpayable

Arguments

because use of _data parameter is implementation specific). | | _operatorData | bytes | data attached to the transfer by controller to emit in event. (It is more like a reason string for calling this function (aka force transfer) which provides the transparency on-chain). |

disableController

Used by the issuer to permanently disable controller functionality

function disableController(bytes _signature) external nonpayable

Arguments

getVersion

Used to get the version of the securityToken

function getVersion() external view
returns(version uint8[])

Arguments

getInvestorCount

Gets the investor count

function getInvestorCount() external view
returns(investorCount uint256)

Arguments

holderCount

Gets the holder count (investors with non zero balance)

function holderCount() external view
returns(count uint256)

Arguments

transferWithData

Overloaded version of the transfer function

function transferWithData(address _to, uint256 _value, bytes _data) external nonpayable

Returns

bool success

Arguments

transferFromWithData

Overloaded version of the transferFrom function

function transferFromWithData(address _from, address _to, uint256 _value, bytes _data) external nonpayable

Returns

bool success

Arguments

transferByPartition

Transfers the ownership of tokens from a specified partition from one address to another address

function transferByPartition(bytes32 _partition, address _to, uint256 _value, bytes _data) external nonpayable
returns(partition bytes32)

Returns

The partition to which the transferred tokens were allocated for the _to address

Arguments

balanceOfByPartition

Get the balance according to the provided partitions

function balanceOfByPartition(bytes32 _partition, address _tokenHolder) external view
returns(balance uint256)

Returns

Amount of tokens as per the given partitions

Arguments

granularity

Provides the granularity of the token

function granularity() external view
returns(granularityAmount uint256)

Returns

uint256

Arguments

polymathRegistry

Provides the address of the polymathRegistry

function polymathRegistry() external view
returns(registryAddress address)

Returns

address

Arguments

upgradeModule

Upgrades a module attached to the SecurityToken

function upgradeModule(address _module) external nonpayable

Arguments

upgradeToken

Upgrades security token

function upgradeToken() external nonpayable

Arguments

isIssuable

A security token issuer can specify that issuance has finished for the token (i.e. no new tokens can be minted or issued).

function isIssuable() external view
returns(issuable bool)

Returns

bool true signifies the minting is allowed. While false denotes the end of minting

Arguments

authorizeOperator

Authorises an operator for all partitions of msg.sender. NB - Allowing investors to authorize an investor to be an operator of all partitions but it doesn't mean we operator is allowed to transfer the LOCKED partition values. Logic for this restriction is written in operatorTransferByPartition() function.

function authorizeOperator(address _operator) external nonpayable

Arguments

revokeOperator

Revokes authorisation of an operator previously given for all partitions of msg.sender. NB - Allowing investors to authorize an investor to be an operator of all partitions but it doesn't mean we operator is allowed to transfer the LOCKED partition values. Logic for this restriction is written in operatorTransferByPartition() function.

function revokeOperator(address _operator) external nonpayable

Arguments

authorizeOperatorByPartition

Authorises an operator for a given partition of msg.sender

function authorizeOperatorByPartition(bytes32 _partition, address _operator) external nonpayable

Arguments

revokeOperatorByPartition

Revokes authorisation of an operator previously given for a specified partition of msg.sender

function revokeOperatorByPartition(bytes32 _partition, address _operator) external nonpayable

Arguments

operatorTransferByPartition

Transfers the ownership of tokens from a specified partition from one address to another address

function operatorTransferByPartition(bytes32 _partition, address _from, address _to, uint256 _value, bytes _data, bytes _operatorData) external nonpayable
returns(partition bytes32)

Returns

The partition to which the transferred tokens were allocated for the _to address

Arguments

transfersFrozen

function transfersFrozen() external view
returns(isFrozen bool)

Arguments

transferOwnership

Allows the current owner to transfer control of the contract to a newOwner.

function transferOwnership(address newOwner) external nonpayable

Arguments

isOwner

function isOwner() external view
returns(bool)

Returns

true if msg.sender is the owner of the contract.

Arguments

owner

function owner() external view
returns(ownerAddress address)

Returns

the address of the owner.

Arguments

controller

function controller() external view
returns(controllerAddress address)

Arguments

moduleRegistry

function moduleRegistry() external view
returns(moduleRegistryAddress address)

Arguments

securityTokenRegistry

function securityTokenRegistry() external view
returns(securityTokenRegistryAddress address)

Arguments

polyToken

function polyToken() external view
returns(polyTokenAddress address)

Arguments

tokenFactory

function tokenFactory() external view
returns(tokenFactoryAddress address)

Arguments

getterDelegate

function getterDelegate() external view
returns(delegate address)

Arguments

controllerDisabled

function controllerDisabled() external view
returns(isDisabled bool)

Arguments

initialized

function initialized() external view
returns(isInitialized bool)

Arguments

tokenDetails

function tokenDetails() external view
returns(details string)

Arguments

updateFromRegistry

function updateFromRegistry() external nonpayable

Arguments

Last updated