1.0.0 • Published 2 years ago
@perp/v2-sdk v1.0.0
Perpetual Protocol V2 SDK
An SDK for Perpetual Protocol V2
Setup
Install the lib
yarn add @perp/v2-sdk
Commit:
Use commitlint and commitizen to regulate commit message.
git ci
Test:
yarn test
Layers
- Market: Tradable pairs for positions.
Market
- values:
indexPrice
,markPrice
,tradingVolume24h
,fundingRate
- values:
- Pool (extends Market): Addable pairs for liquidity.
Pool
- values:
TVL
,APR
- values:
- Wallet: Manages user’s assets in his/her connected web3 wallet. (e.g. MetaMask)
Wallet
DepositHistory
WithdrawHistory
- Vault: Manages user’s assets stored inside Perpetual Protocol.
Vault
- methods:
deposit
,withdraw
- values:
accountBalance
,totalPnl
- methods:
- ClearingHouse: Manage transactions.
ClearingHouse
- methods:
- openPosition, closePosition
- addLiquidity, removeLiquidity
- methods:
- Position:
Position
PositionDraft
PositionHistory
FundingPaymentHistory
Usage
Create a perpetualProtocol instance.
- Now we only support optimism
const perp = new PerpetualProtocol({
chainId: 10,
providerConfigs: [ { rpcUrl: "https://mainnet.optimism.io"}] })
await perp.init()
Open a position
- Remember to provide your singer when connecting.
For example:
Open a Long
position using quoteToken
.
baseToken: ETH
quoteToken: USD
const perp = new PerpetualProtocol({
chainId: 10,
providerConfigs: [ { rpcUrl: "https://mainnet.optimism.io"}] })
await perp.init()
await perp.connect({ signer })
const tickerSymbol = "ETHUSD"
const slippage = new Big(0.02) // remember to transformed to Big type
const amountInput = new Big(100) // remember to transformed to Big type
const side = PositionSide.LONG
const isAmountInputBase = false // we are not using base token to open a long position here.
const newPositionDraft = perp.clearingHouse.createPositionDraft({
tickerSymbol,
side,
amountInput,
isAmountInputBase,
})
perp.clearingHouse.openPosition(positionDraft, slippage)
Close a position
const tickerSymbol = "ETHUSD"
const position = await perp.positions.getTakerPositionByTickerSymbol(tickerSymbol)
perp.clearingHouse.closePosition(position, slippage)
Add liquidity
Remember to provide your singer when connecting.
For example: Use
quoteToken
to add liquidity. baseToken: ETH quoteToken: USD
const perpParam = {
chainId: 10,
providerConfigs: [ { rpcUrl: "https://mainnet.optimism.io"}]
}
const perp = new PerpetualProtocol(perpParam)
await perp.init()
await perp.connect({ signer })
const tickerSymbol = "ETHUSD"
const market = perp.markets.getMarket({ tickerSymbol })
const lowerTick = perp.market.getPriceToTick(lowerTickPrice)
const upperTick = perp.market.getPriceToTick(upperTickPrice)
const slippage = new Big(0.02) // remember to transformed to Big type
const rawBaseAmount = undefined
const rawQuoteAmount = new Big(100) // remember to transformed to Big type
const liquidityDraft = perp.clearingHouse.createLiquidityDraft({
tickerSymbol,
rawBaseAmount,
rawQuoteAmount,
upperTick,
lowerTick,
})
perp.clearingHouse.addLiquidity(liquidityDraft, slippage)
Close liquidity
ratio
means how much ratio you would like to remove. 1 means 100%- Use
filterFn
to filter out liquidity you would like to remove.
const ratio = new Big(1) // remember to transformed to Big type
const slippage = new Big(0.02) // remember to transformed to Big type
const liquidity = perp.liquidities.getTotalLiquidities().filter(filterFn)
perp.clearingHouse.removeLiquidity(liquidity, ratio, slippage)
0.1.4-multicollateral
2 years ago
1.0.0
2 years ago
0.1.5-multicollateral
2 years ago
0.1.2
2 years ago
0.1.6-alpha
2 years ago
0.1.5-alpha
2 years ago
0.1.6-multicollateral
2 years ago
0.1.8
2 years ago
0.1.7
2 years ago
0.1.9
2 years ago
0.1.4
2 years ago
0.1.3
2 years ago
0.1.6
2 years ago
0.1.1
2 years ago
0.1.0
2 years ago