This is the reference implementation of EIP-2021 Payoutable token. This implementation will change over time with the standard and is not stable at the moment.
Feedback is appreciated and can given at the discussion of the EIP.
An extension to the ERC-20 standard token that allows Token wallet owners to request payout from their wallet, by calling the smart contract and attaching a payout instruction string.
Token wallet owners (or approved addresses) can order payout requests through blockchain. This is done by calling the orderPayoutFrom or orderPayoutFrom methods, which initiate the workflow for the token contract operator to either honor or reject the payout request. In this case, payout instructions are provided when submitting the request, which are used by the operator to determine the destination of the funds.
In general, it is not advisable to place explicit routing instructions for the payouts on a verbatim basis on the blockchain, and it is advised to use a private communication alternatives, such as private channels, encrypted storage or similar, to do so (external to the blockchain ledger). Another (less desirable) possibility is to place these instructions on the instructions field in encrypted form.
The following diagram shows the sequence of the payout creation and execution.
The following diagram shows the sequence of the payout creation and cancellation.
The following diagram shows the sequence of the payout creation and rejection.
npm install eip2021
To write your custom contracts, import the contract and extend it through inheritance.
pragma solidity ^0.5.0;
import 'eip2021/contracts/Payoutable.sol';
contract MyPayoutable is Payoutable {
// your custom code
}You need an ethereum development framework for the above import statements to work! Check out these guides for Truffle, Embark or Buidler.
Whenever a payout is ordered, payment information has to be provided with the necessary information for the off-chain transfer. EIP-2021 leaves the structure of this information up to the implementer, but recommends ISO-20022 as a starting point.
The unit tests use a JSON version of this standard, which can be seem below.
{
"messageId": "Example Message ID",
"payouts": [
{
"amount": 1.00,
"bankAccountId": "caaa2bd3-dc42-436a-b70b-d1d7dac23741",
"remittanceInformation": "Example Remittance Information"
}
]
}Amongst other things, if defines the transferred amount, an ID to a predefined bank account and remittance information. Additionally an ID is defined to properly mark the transfer.
To run the unit tests execute npm test.
To get the code coverage report execute npm run coverage