@rholabs/rho-sdk

Rho Protocol SDK

Installation

npm install @rholabs/rho-sdk

Getting Started

The following example creates Rho SDK with default configuration:

import RhoSDK from '@rholabs/rho-sdk';

const rhoSDK = new RhoSDK({ network: 'testnet' });

RhoSDKParams: Object (optional)

export type RhoSDKNetwork = 'mainnet' | 'testnet' | 'custom'

export interface RhoSDKParams {
  network?: RhoSDKNetwork
  routerAddress?: string
  viewAddress?: string;
  quoterAddress?: string
  rpcUrl?: string;
  oracleServiceUrl?: string
  privateKey?: string
  provider?: JsonRpcProvider | BrowserProvider
  signer?: JsonRpcSigner
}

API Reference

getActiveMarketIds(offset, limit)

Get active market ids

Parameters

1. offset - Number (optional)
2. limit - Number (optional)

Returns

String[]

---

getActiveMarkets({ oraclePackages, offset, limit })

Get active markets

Parameters

1. oraclePackages - OraclePackages[] (optional)
2. offset - Number (optional)
3. limit - Number (optional)

Returns

MarketInfo[]

---

getPortfolio({ userAddress, oraclePackages, offset, limit })

Get user portfolio

Parameters

1. userAddress - String
2. oraclePackages - OraclePackages[] (optional)
3. offset - Number (optional)
4. limit - Number (optional)

Returns

MarketPortfolio[]

---

getTradeQuote({ marketId, futureId, notional, userAddress, oraclePackages? })

Get trade quote

Parameters

1. marketId - String
2. futureId - String
3. notional - BigInt
4. userAddress - String
5. oraclePackages - OraclePackages[] (optional)

Returns

TradeQuote

---

getLiquidityProvisionQuote({ marketId, futureId, notional, operation, lowerBound, upperBound, userAddress, oraclePackages? })

Get liquidity provision quote

Parameters

1. marketId - String
2. futureId - String
3. notional - BigInt
4. operation - LiquidityOperation
5. lowerBound - String
6. upperBound - String
7. userAddress - String
8. oraclePackages - OraclePackages[] (optional)

Returns

LiquidityQuote

---

executeTrade({ marketId, futureId, notional, riskDirection, futureRateLimit, collateral, deadlineTimestamp, settleMaturedPositions?, oraclePackages? })

Execute trade

Parameters

1. marketId - String
2. futureId - String
3. notional - BigInt
4. riskDirection - RiskDirection
5. futureRateLimit - BigInt
6. collateral - BigInt
7. deadline - Number (optional, Date.now() + 5 * 60 * 1000)
8. settleMaturedPositions - Boolean (optional, true)
9. oraclePackages - OraclePackages[] (optional)

Returns

TransactionReceipt

---

deposit({ marketId, recipientAddress, amount, settleMaturedPositions?, oraclePackages? })

Deposit

Parameters

1. marketId - String
2. recipientAddress - String
3. amount - BigInt
4. settleMaturedPositions - Boolean (optional)
5. oraclePackages - OraclePackages[] (optional)

Returns

TransactionReceipt

---

withdraw({ marketId, amount, settleMaturedPositions?, oraclePackages? })

Withdraw

Parameters

1. marketId - String
2. amount - BigInt
3. settleMaturedPositions - Boolean (optional, true)
4. oraclePackages - OraclePackages[] (optional)

Returns

TransactionReceipt

---

provideLiquidity({ marketId, futureId, notional, collateral, lowerBound, upperBound, deadlineTimestamp?, settleMaturedPositions?, oraclePackages? })

Provide liquidity

Parameters

1. marketId - String
2. futureId - String
3. notional - BigInt
4. collateral - BigInt
5. lowerBound - String
6. upperBound - String
7. deadline - Number (optional, Date.now() + 5 * 60 * 1000)
8. settleMaturedPositions - Boolean (optional, true)
9. oraclePackages - OraclePackages[] (optional)

Returns

TransactionReceipt

---

removeLiquidity({ marketId, futureId, notional, collateral, lowerBound, upperBound, deadlineTimestamp?, settleMaturedPositions?, oraclePackages? })

Remove liquidity

Parameters

1. marketId - String
2. futureId - String
3. notional - BigInt
4. collateral - BigInt
5. lowerBound - String
6. upperBound - String
7. deadline - Number
8. settleMaturedPositions - Boolean (optional, Date.now() + 5 * 60 * 1000)
9. oraclePackages - OraclePackages[] (optional)

Returns

TransactionReceipt

---

Using in browser / Node.Js

Basic configuration (read only)

import RhoSDK from '@rholabs/rho-sdk';

const rhoSDK = new RhoSDK({ network: 'testnet' })

Node.JS

import RhoSDK from '@rholabs/rho-sdk';

const rhoSDK = new RhoSDK({
  network: 'testnet',
  privateKey: '<PRIVATE_KEY>'
})

Testing

Create .env file:

TEST_PRIVATE_KEY=12345```
and run the tests with the following command:

yarn test

### Publishing

npm login npm publish --access public