Skip to content
No description, website, or topics provided.
JavaScript Shell
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
contracts
diagrams
migrations
scripts
test
.gitignore
.solcover.js
.soliumignore
.soliumrc.json
.travis.yml
README.md
package-lock.json
package.json
truffle-config.js

README.md

Fundable Token

Build Status Coverage Status npm

This is the reference implementation of EIP-2019 Fundable 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.

Summary

An extension to the ERC-20 standard token that allows Token wallet owners to request a wallet to be funded, by calling the smart contract and attaching a fund instruction string.

Abstract

Token wallet owners (or approved addresses) can order tokenization requests through blockchain. This is done by calling the orderFund or orderFundFrom methods, which initiate the workflow for the token contract operator to either honor or reject the fund request. In this case, fund instructions are provided when submitting the request, which are used by the operator to determine the source of the funds to be debited in order to do fund the token wallet (through minting).

In general, it is not advisable to place explicit routing instructions for debiting funds 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.

Sequence diagrams

Fund executed

The following diagram shows the sequence of the payout creation and execution.

Fundable Token: Fund executed

Fund cancelled

The following diagram shows the sequence of the payout creation and cancellation.

Fundable Token: Fund cancelled

Fund rejected

The following diagram shows the sequence of the payout creation and rejection.

Fundable Token: Fund rejected

State diagram

Fundable: State Diagram

Install

npm install eip2019

Usage

To write your custom contracts, import the contract and extend it through inheritance.

pragma solidity ^0.5.0;

import 'eip2019/contracts/Fundable.sol';

contract MyFundable is Fundable {
    // 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.

Fund information

Whenever a payout is ordered, payment information has to be provided with the necessary information for the off-chain transfer. EIP-2019 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",
    "funds": [
        {
            "amount": 1.00,
            "fundingSubjectId": "caaa2bd3-dc42-436a-b70b-d1d7dac23741",
            "receiverInformation": "Example funds receiver information"
        }
    ]
}

Amongst other things, if defines the funded amount, an ID to a predefined bank account or credit card and the receiver information. Additionally some IDs are defined to properly mark the transfer.

Tests

To run the unit tests execute npm test.

Code coverage

To get the code coverage report execute npm run coverage

You can’t perform that action at this time.