ERC725

Solidity contract

ERC725.sol

The ERC725 is the contract combining:

• ERC725X: contract that allow a generic execution using different types of operations.

• ERC725Y: contract that allow for a generic data storage in a smart contract.

note

ERC725 contract also contains the method from ERC165:

function supportsInterface(bytes4 interfaceId) public view returns (bool)

---

Functions

constructor

constructor(address initialOwner)

Sets the initial owner of the contract.

Parameters:

Name	Type	Description
initialOwner	address	The address to set as the owner of the contract.

owner

function owner() public view returns (address owner)

Returns the address of the current owner of the smart contract.

Return Values:

Name	Type	Description
owner	address	The current owner of the contract.

transferOwnership

function transferOwnership(address newOwner) public {

Transfers the ownership of the contract to the newOwner address.

Triggers the OwnershipTransferred event when ownership is transferred.

Parameters:

Name	Type	Description
newOwner	address	The address to set as the owner of the contract.

execute - ERC725X

function execute(
    uint256 operationType,
    address target,
    uint256 value,
    bytes memory data
) public payable returns (bytes memory result)

Executes a call on any other smart contracts, transfers value, or deploys a new smart contract.

The operationType can be the following:

• 0 for CALL
• 1 for CREATE
• 2 for CREATE2
• 3 for STATICCALL
• 4 for DELEGATECALL

Triggers the Executed event when a call is successfully executed using CALL/STATICCALL/DELEGATECALL operations.

Triggers the ContractCreated event when a smart contract is created using CREATE/CREATE2 operations.

note

The execute(...) function can only be called by the current owner of the contract.

The operation types staticcall (3) and delegatecall (4) do not allow to transfer value.

Parameters:

Name	Type	Description
operationType	uint256	The type of operation that needs to be executed.
target	address	The address to interact with. The address to will be unused if a contract is created (operations 1 & 2).
value	uint256	The amount of native tokens to transfer with the transaction (in Wei).
data	bytes	The calldata (ABI-encoded payload of a function to run on an other contract), or the bytecode of the contract to deploy.

Return Values:

Name	Type	Description
result	bytes	The data that was returned by the function called on the external contract, or the address of the contract created (operations 1 & 2).

execute (Array) - ERC725X

function execute(
    uint256[] memory operationsType,
    address[] memory targets,
    uint256[] memory values,
    bytes[] memory datas
) public payable returns (bytes[] memory results)

Executes batch of calls on any other smart contracts, transfers value, or deploys a new smart contract.

Triggers the Executed event on each call iteration when a call is successfully executed using CALL/STATICCALL/DELEGATECALL operations.

Triggers the ContractCreated event on each contract creation iteration when a smart contract is created using CREATE/CREATE2 operations.

note

The execute(...) function can only be called by the current owner of the contract.

Parameters:

Name	Type	Description
operationsType	uint256[]	The list of operation that needs to be executed.
targets	address[]	The list of addresses to interact with. The addresses targets will be unused if a contract is created (operations 1 & 2).
values	uint256[]	The list of amount of native tokens to transfer with the transaction (in Wei).
datas	bytes[]	The list of calldata (ABI-encoded payload of a function to run on an other contract), or the list of bytecodes of the contracts to deploy.

Return Values:

Name	Type	Description
result	bytes[]	The array of data that was returned by the functions called on the external contract, or the addresses of the contracts created (operations 1 & 2).

setData - ERC725Y

function setData(
    bytes32 dataKey,
    bytes memory dataValue
) public

Sets a value in the account storage for a particular data key.

Triggers the DataChanged event when successfully setting the data.

note

The setData(...) function can only be called by the current owner of the contract.

Parameters:

Name	Type	Description
dataKey	bytes32	The data key for which the data will be set.
dataValue	bytes	The data to be set.

getData - ERC725Y

function getData(bytes32 dataKey) public view returns (bytes memory dataValue)

Retrieves the value set for the given data key.

Parameters:

Name	Type	Description
dataKey	bytes32	The data key to retrieve data from.

Return Values:

Name	Type	Description
dataValue	bytes	The data for the requested data key.

setData (Array) - ERC725Y

function setData(
    bytes32[] memory dataKeys,
    bytes[] memory dataValues
) public

Sets an array of data at multiple data keys in the account storage.

Triggers the DataChanged event when successfully setting each data key/value pair.

note

The setData(...) function can only be called by the current owner of the contract.

Parameters:

Name	Type	Description
dataKeys	bytes32[]	The data keys for which to set data.
dataValues	bytes[]	The array of data to set.

getData (Array) - ERC725Y

function getData(bytes32[] memory dataKeys) public view returns (bytes[] memory dataValues)

Retrieves an array of values for multiple given data keys.

Parameters:

Name	Type	Description
dataKeys	bytes32[]	The data keys to retrieve data from.

Return Values:

Name	Type	Description
dataValues	bytes[]	An array of the data for the requested data keys.

Events

OwnershipTransferred

event OwnershipTransferred(
    address previousOwner,
    address newOwner,
)

MUST be fired when transferOwnership(...) function is successfully executed.

Values:

Name	Type	Description
previousOwner	address	The previous owner of the contract.
newOwner	address	The new owner of the contract.

Executed

event Executed(
    uint256 operationType,
    address target,
    uint256 value,
    bytes4 selector
)

MUST be fired when execute(...) function creates a new call using the CALL, STATICCALL, or DELEGATECALL operation.

Values:

Name	Type	Description
operationType	uint256	Either 0 (for CALL), 3 (for STATICCALL) or 3 (for DELEGATECALL).
target	address	The smart contract or address that was called.
value	uint256	The value transferred.
selector	bytes4	The bytes4 selector of the function called on the target address.

ContractCreated

event ContractCreated(
    uint256 operationType,
    address contractAddress,
    uint256 value,
    bytes32 salt
)

MUST be fired when the execute(...) function creates a new contract using the CREATE or CREATE2 operation.

Values:

Name	Type	Description
operationType	uint256	Either 1 (for CREATE) or 2 (for CREATE2).
to	address	The address of the created contract.
value	uint256	The value sent to the contract.
salt	bytes32	The salt used in CREATE2 operation. Will be bytes32(0) in case of CREATE operation.

DataChanged

event DataChanged(bytes32 dataKey, bytes dataValue)

MUST be fired when the setData(...) function is successfully executed.

Values:

Name	Type	Description
dataKey	bytes32	The data key which data value is set.
dataValue	bytes	The data value to set.

References

• ERC725 (Standard Specification, GitHub)
• Solidity implementations (GitHub)