Call Pair Contracts
Description of the Calls Pair Core contract, methods and functions
A Hedgey Calls Smart Contract is a protocol for peer to peer call options trading. Each pairs contract is unique for a single asset currency and payment currency. The Asset currency is the underlying asset that the options are written against, and the payment currency is the currency for which premiums are paid, and the strike is based on. Once a pair has been created by the factory, then anyone may create options on the contract.
First the key parameters that define any call option
  • Address "short" - this is the call writer, or the "short position"
  • uint "assetAmt" - this is the quantity of the underlying asset currency
  • uint "strike" - this is the price at which the call buyer can purchase the underlying asset for, denominated in the payment currency and is independent of the size of the assetAmt
  • uint "totalPurchase" - this is the strike * the asset amount to render the exact amount of payment currency the call buyer would have to pay to exercise the option
  • uint "price" - this is the premium price that buyer must pay to the writer to open the contract
  • uint "expiry" - the second when the call agreement expires and can no longer be exercised by the buyer
  • bool "open" - defines if the call agreement is open, meaning a match has occurred where a buyer has paid the seller and both are locked into the contract. The seller can no longer exit their position, it has become an obligation.
  • bool "tradeable" - this defines whether the agreement can be bought or sold (both primary and secondary market)
  • address "long" - this is the call buyer, or the "long position"
  • bool "exercised" - this defines if the call agreement has been exercised by the call buyer
There are two ways to generate a new call option:
  1. 1.
    As a Asset Currency Holder - you can create a "new ask". A new ask is the method which you are acting as the potential call writer, and asking for someone to take the other side and buy your call agreement. When someone buys your call, they pay you the premium for the right to purchase the underlying asset, at which point the call is now Open.
  2. 2.
    If you are looking to purchase a call, you can place a "new bid" into the market. When another party who is on the opposite side agrees with your terms, they can sell you the call agreement, at which point the option is Open.
For the remainder of the documentation we will broadly refer to the asset currency as "token" and payment currency as "cash". In addition we will refer to the call writer as the "short" or "writer", and the call buyer as the "long" or "owner".
Copy link