Lend Examples
This page demonstrates how to query the Shade Lend contracts.
All Vaults
Query multiple vault registry contracts and return info about all the vaults in each registry.
input
ts
async function queryVaults({
queryRouterContractAddress,
queryRouterCodeHash,
lcdEndpoint,
chainId,
vaultRegistryContracts,
}:{
queryRouterContractAddress: string,
queryRouterCodeHash?: string,
lcdEndpoint?: string,
chainId?: string,
vaultRegistryContracts: LendVaultRegistryContract[]
}): Promise<BatchVaults>
type LendVaultRegistryContract = {
address: string,
codeHash: string,
vaultType: VaultType,
};
enum VaultType {
V1 = 'v1',
V2 = 'v2',
V3 = 'v3',
}async function queryVaults({
queryRouterContractAddress,
queryRouterCodeHash,
lcdEndpoint,
chainId,
vaultRegistryContracts,
}:{
queryRouterContractAddress: string,
queryRouterCodeHash?: string,
lcdEndpoint?: string,
chainId?: string,
vaultRegistryContracts: LendVaultRegistryContract[]
}): Promise<BatchVaults>
type LendVaultRegistryContract = {
address: string,
codeHash: string,
vaultType: VaultType,
};
enum VaultType {
V1 = 'v1',
V2 = 'v2',
V3 = 'v3',
}output
ts
type BatchVaults = BatchVaultsItem[]
type BatchVaultsItem = {
vaultRegistryContractAddress: string,
vaults: Vaults,
blockHeight: number,
}
type Vaults = {
[id: string]: Vault,
}
type Vault = {
id: string,
vaultType: VaultType,
name: string,
collateralAddress: string,
silkMaxAllowance: string,
silkAllowanceUsed: string,
maxLtv: number, // decimal percent
collateral: {
total: string,
elastic: string,
base: string,
safe: string,
lastAccruedAt: Date,
oracleDelay: number,
},
debt: {
total: string,
base: string,
lastAccruedAt: Date,
}
interestRate: {
current: number, // decimal percent
target: number,
delta: number,
ratePerSecond: number,
lastUpdatedAt: Date,
},
borrowFee: {
current: number, // decimal percent
target: number,
delta: number,
ratePerSecond: number,
lastUpdatedAt: Date,
},
liquidationFee: {
discount: number,
minimumDebt: string,
daoShare: number,
callerShare: number
}
isProtocolOnly: boolean,
status: LendContractStatus,
openPositions: number,
totalPositions: number,
whitelist: string[],
}
enum LendContractStatus {
NORMAL = 'normal',
DEPRECATED = 'deprecated',
FROZEN = 'frozen'
}
type BatchVaults = BatchVaultsItem[]
type BatchVaultsItem = {
vaultRegistryContractAddress: string,
vaults: Vaults,
blockHeight: number,
}
type Vaults = {
[id: string]: Vault,
}
type Vault = {
id: string,
vaultType: VaultType,
name: string,
collateralAddress: string,
silkMaxAllowance: string,
silkAllowanceUsed: string,
maxLtv: number, // decimal percent
collateral: {
total: string,
elastic: string,
base: string,
safe: string,
lastAccruedAt: Date,
oracleDelay: number,
},
debt: {
total: string,
base: string,
lastAccruedAt: Date,
}
interestRate: {
current: number, // decimal percent
target: number,
delta: number,
ratePerSecond: number,
lastUpdatedAt: Date,
},
borrowFee: {
current: number, // decimal percent
target: number,
delta: number,
ratePerSecond: number,
lastUpdatedAt: Date,
},
liquidationFee: {
discount: number,
minimumDebt: string,
daoShare: number,
callerShare: number
}
isProtocolOnly: boolean,
status: LendContractStatus,
openPositions: number,
totalPositions: number,
whitelist: string[],
}
enum LendContractStatus {
NORMAL = 'normal',
DEPRECATED = 'deprecated',
FROZEN = 'frozen'
}Single Vault
Query info for a single vault.
input
ts
async function queryVault({
vaultRegistryContractAddress,
vaultRegistryCodeHash,
vaultType,
vaultId,
lcdEndpoint,
chainId,
}:{
vaultRegistryContractAddress: string,
vaultRegistryCodeHash?: string,
vaultType: VaultType,
vaultId: string,
lcdEndpoint?: string,
chainId?: string,
}): Promise<Vault>async function queryVault({
vaultRegistryContractAddress,
vaultRegistryCodeHash,
vaultType,
vaultId,
lcdEndpoint,
chainId,
}:{
vaultRegistryContractAddress: string,
vaultRegistryCodeHash?: string,
vaultType: VaultType,
vaultId: string,
lcdEndpoint?: string,
chainId?: string,
}): Promise<Vault>output
See "Vault" type in the all vaults output.
Stability Pool
Query info for the stability pool data
input
ts
function queryStabilityPoolInfo({
queryRouterContractAddress,
queryRouterCodeHash,
lcdEndpoint,
chainId,
stabilityPoolContractAddress,
stabilityPoolCodeHash,
minBlockHeightValidationOptions,
}:{
queryRouterContractAddress: string,
queryRouterCodeHash?: string,
lcdEndpoint?: string,
chainId?: string,
stabilityPoolContractAddress: string,
stabilityPoolCodeHash: string,
minBlockHeightValidationOptions?: MinBlockHeightValidationOptions,
}): Promise<StabilityPoolInfo>function queryStabilityPoolInfo({
queryRouterContractAddress,
queryRouterCodeHash,
lcdEndpoint,
chainId,
stabilityPoolContractAddress,
stabilityPoolCodeHash,
minBlockHeightValidationOptions,
}:{
queryRouterContractAddress: string,
queryRouterCodeHash?: string,
lcdEndpoint?: string,
chainId?: string,
stabilityPoolContractAddress: string,
stabilityPoolCodeHash: string,
minBlockHeightValidationOptions?: MinBlockHeightValidationOptions,
}): Promise<StabilityPoolInfo>output
ts
type StabilityPoolInfo = {
silkDeposited: string,
bondAmount: string, // this is value used for calculation
// purposes. It does not represent a token amount.
blockHeight: number,
}type StabilityPoolInfo = {
silkDeposited: string,
bondAmount: string, // this is value used for calculation
// purposes. It does not represent a token amount.
blockHeight: number,
}