A standard for token contracts providing Atomic Swap-based American Call Option functionalities.
This standard provides functionality to make Atomic Swap-based American Call Option payment. The Atomic Swap protocol based on Hashed Time-Locked Contract (HTLC) 1 has optionality 2, and such optionality can be utilised to construct American Call Options without trusted third party. This standard defines the common way of implementing this protocol. In particular, this EIP defines technical terms, provides interfaces, and gives reference implementations of this protocol.
Atomic Swap allows users to atomically exchange their tokens without trusted third parties while the HTLC is commonly used for the implementation. However, the HTLC-based Atomic Swap has optionality. More specifically, the swap initiator can choose to proceed or abort the swap for several hours, which gives him time for speculating according to the exchange rate. A discussion2 shows that the HTLC-based Atomic Swap is equivalent to an American Call Option in finance. On the other hand,thanks to such optionality, the HTLC-based Atomic Swap can be utilised to construct American Call Options without trusted third party. A paper3 proposes a secure Atomic-Swap-based American Call Option protocol on smart contracts. This protocol not only eliminates the arbitrage opportunity but also prevents any party from locking the other party's money maliciously. This EIP aims at providing the standard of implementing this protocol in existing token standards.
The Atomic Swap-based American Call Option smart contract should follow the syntax and semantics of Ethereum smart contracts.
initiator: the party who publishes the advertisement of the swap.participant: the party who agrees on the advertisement and participates in the swap with initiator.asset: the amount of token(s) to be exchanged.premium: the amount of token(s) that initiator pays to participant as the premium.redeem: the action to claim the token from the other party.refund: the action to claim the token from the party herself/himself, because of timelock expiration.secrect: a random string chosen by initiator as the preimage of a hash.secrectHash: a string equals to the hash of secrect, used for constructing HTLCs.timelock: a timestamp representing the timelimit, before when the asset can be redeemed, and otherwise can only be refunded.This mapping stores the metadata of the swap contracts, including the parties and tokens involved. Each contract uses different secretHash, and is distinguished by secretHash.
This mapping stores the detail of the asset initiators want to sell, including the amount, the timelock and the state. It is associated with the swap contract with the same secretHash.
This mapping stores the details of the asset participants want to sell, including the amount, the timelock and the state. It is associated with the swap contract with the same secretHash.
This mapping stores the details of the premium initiators attach in the swap contract, including the amount, the timelock and the state. It is associated with the swap contract with the same secretHash.
This function sets up the swap contract, including the both parties involved, the tokens to exchanged, and so on.
The initiator invokes this function to fill and lock the token she/he wants to sell and join the contract.
The initiator invokes this function to fill and lock the premium.
The participant invokes this function to fill and lock the token she/he wants to sell and join the contract.
One of the parties invokes this function to get the token from the other party, by providing the preimage of the hash lock secret.
One of the parties invokes this function to get the token back after the timelock expires.
The participant invokes this function to get the premium. This can be invoked only if the participant has already invoked participate and the participant's token is redeemed or refunded.
The initiator invokes this function to get the premium back after the timelock expires.
This event indicates that one party has set up the contract using the function setup().
This event indicates that initiator has filled and locked the token to be exchanged using the function initiate().
This event indicates that participant has filled and locked the token to be exchanged using the function participate().
This event indicates that initiator has filled and locked premium using the function fillPremium().
These two events indicate that asset has been redeemed by the other party before the timelock by providing secret.
These two events indicate that asset has been refunded by the original owner after the timelock expires.
This event indicates that premium has been redeemed by participant. This implies that asset is either redeemed by initiator if it can provide the preimage of secrectHash before asset timelock expires; or refunded by participant if asset timelock expires.
This event indicates that premium has been refunded back to initiator, because of participant doesn't participate at all, by the time of premium timelock expires.
initiateTimestamp should cover the whole swap process.This proposal is fully backward compatible. Functionalities of existing standards will not be affected by this proposal, as it only provides additional features to them.
Please visit here to find our example implementation.
Copyright and related rights waived via CC0.