This tutorial will show you how to deploy a Long Short Pair (LSP) contract by using the UMA
launch-lsp repository. By following these instructions, you will be able to launch a custom LSP on Kovan testnet and Ethereum mainnet.
At the end of this deployment process, you should have a deployed contract on Kovan testnet and Ethereum mainnet. The following is an overview of the deployment steps below.
- Clone the repo
- Install the dependencies
- Set your parameters
- Run the deployment on testnet (Kovan)
- Run the deployment on mainnet (Ethereum)
Before deploying a contract, you should verify that your desired price identifier and collateral currency are already approved on the network you are trying to deploy to.
View approved price identifiers and currencies here:
- Approved mainnet collateral currencies
- Approved mainnet price identifiers
- Approved Kovan collateral currencies subgraph query
To add a new price identifier or collateral currency to mainnet, please propose one to UMA voters by following the instructions detailed here.
To add a new price identifier or collateral currency to Kovan, please contact the UMA team in Discord.
- Clone the repo:
git clone https://github.com/UMAprotocol/launch-lsp.git
You will need to install nodejs v14 (we recommend nvm to manage node versions) and yarn.
Note: these additional dependencies are required -- you may or may not have them on your system already:
These dependencies are installed on MacOS by installing the XCode Developer Tools. For Linux, the example ubuntu installation command for additional deps is:
sudo apt-get update && sudo apt-get install -y libudev-dev libusb-1.0-0-dev
Each deployment requires the following parameters to be set at the point of deployment.
gasprice:The gas price used for your contract deployment.
url:your node URL.
mnemonic:Your 12 word seed phrase or mnemonic.
expirationTimestamp:Timestamp at which your contract will expire.
collateralPerPair:The amount of collateral required to mint each long and short pair.
priceIdentifier:The approved price identifier to be used.
collateralToken:Approved collateral currency to be used.
pairName:The desired name of the token pair.
longSynthName:The full-length name of the long token.
longSynthSymbol:The ticker name of the long token.
shortSynthName:The full-length name of the short token.
shortSynthSymbol:The ticker name of the short token or ticker symbol.
enableEarlyExpiration:If set to true, the LSP contract can request to be settled early by calling the optimistic oracle. If not needed, the parameter will be set to false.
fpl: The financial library your contract will use to calculate the payment at expiry. For the list of the available financial product libraries we have available, you can go here.
financialProductLibraryAddress:Contract address providing settlement payout logic. Only required if a custom financial product library is used and
fplis not included.
customAncillaryData:Custom ancillary data to be passed along with the price request. If not needed, this flag can be excluded and will be left as a 0-length bytes array.
proposerReward:Proposal reward to be forwarded to the created contract to be used to incentivize price proposals.
optimisticOracleLivenessTime:Custom liveness window for disputing optimistic oracle price proposals in seconds. A longer liveness time provides more security, while a shorter one provides faster settlement. By default, this is set to 7200 seconds.
optimisticOracleProposerBond:Additional bond a proposer must post with the optimistic oracle. A higher bond makes incorrect disputes and proposals more costly.
Financial Product Library (FPL) parameters can be set by adding the following parameters to your deployment script depending on the FPL you are using. Please visit launch-lsp for FPL descriptions and example deployment scripts for each FPL.
lowerBound:Lower bound of a price range for certain financial product libraries. Cannot be included if strikePrice is specified.
strikePrice:Alias for lowerBound, used for certain financial product libraries with no upper bound. Cannot be included if lowerBound is specified.
upperBound:Upper bound of a price range for certain financial product libraries.
basePercentage:The percentage of collateral per pair used as the floor. This parameter is used with the 'SuccessToken' FPL where the remaining percentage functions like an embedded call option.
The below financial product libraries require the following FPL parameters:
For additional guidance on what each FPL parameter means, please utilize the launch-lsp repo.
Before running this command, you should customize the parameters to your needs. YOUR_NODE_URL should be filled in with a url for the network that you wish to deploy to. You should also choose the corresponding financial product library (FPL) that makes sense for your use case. The script has been pre-filled with
CoveredCall which uses
--strikePrice to set the FPL parameter.
All the required Kovan addresses can be seen on our Github repo with the most important items in the list for specific launch are:
Before deploying, please note that the script will deploy to the network that your node URL is for. If using Infura for a Kovan deployment,
YOUR_NODE_URL will follow this format:
Run the deployment script with your specific parameters.
node index.js --gasprice 5 --url YOUR_NODE_URL --mnemonic "your mnemonic (12 word seed phrase)" --pairName "token pair name" --expirationTimestamp 1672538400 --collateralPerPair 250000000000000000 --priceIdentifier UMAUSD --longSynthName "long token name" --longSynthSymbol UMA-1222 --shortSynthName "short token name" --shortSynthSymbol UMA-1222s --collateralToken 0x489Bf230d4Ab5c2083556E394a28276C22c3B580 --customAncillaryData "twapLength:3600" --optimisticOracleLivenessTime 3600 --fpl CoveredCall --strikePrice 12000000000000000000 --proposerReward 20000000000000000000 --optimisticOracleProposerBond 40000000000000000000
The method to deploy onto mainnet is the exact same as with Kovan, except
url will need to be amended for use on Ethereum mainnet.
All the required Ethereum Mainnet addresses can be seen on our Github repo with the most important items in the list for specific launch are:
Please note that the script will deploy to the network that your node URL is for. If using Infura for mainnet,
YOUR_NODE_URL will follow this format:
You can now run the deployment script. From within the
launch-lsp directory, run:
node index.js --gasprice 80 --url YOUR_NODE_URL --mnemonic "your mnemonic (12 word seed phrase)" --pairName "token pair name" --expirationTimestamp 1672538400 --collateralPerPair 250000000000000000 --priceIdentifier UMAUSD --longSynthName "long token name" --longSynthSymbol UMA-1222 --shortSynthName "short token name" --shortSynthSymbol UMA-1222s --collateralToken 0x04Fa0d235C4abf4BcF4787aF4CF447DE572eF828 --customAncillaryData "twapLength:3600" --optimisticOracleLivenessTime 3600 --fpl CoveredCall --strikePrice 12000000000000000000 --proposerReward 20000000000000000000 --optimisticOracleProposerBond 40000000000000000000
Once deployed, the script will list the address of your newly deployed LSP. A successful output will look like this:
Simulating Deployment...Simulation successful. Expected Address: 0x44978157afE92c926619EBB54599bbc483eBe871