SDK Documentation
This page describes the use of the Morpho SDK.
- Morpho's AaveV3-ETH Optimizer SDK is a TypeScript-based toolkit for building decentralized applications (dApps) using Morpho-AaveV3 smart contracts.
- The SDK is a "plug-and-play" adapter, easing the construction of any app or script that requires interaction with the Morpho AaveV3-ETH Optimizer contracts. It also provides seamless integration with RxJS for reactive programming, facilitating efficient handling of async data streams.
- The SDK is still under development, and any feedback is welcome.
GitHub - morpho-org/morpho-aave-v3-sdk
GitHub
Open source SDK
- Knowledge of blockchain, TypeScript, and decentralized applications.
- Node.js (v.^14.0) and npm/yarn installed on your system.
- ethers (v.^5.7.0).
- Installation
using npm or yarn:
npm install @morpho-org/morpho-aave-v3-sdk
yarn add @morpho-org/morpho-aave-v3-sdk
- 1.First example using
getMarketsData()
import { MorphoAaveV3Adapter } from "@morpho-org/morpho-aave-v3-sdk";
import sdk from "@morpho-org/morpho-aave-v3-sdk/lib";
import { getDefaultProvider } from "ethers";
sdk.setConfiguration({
defaultProvider: new providers.JsonRpcProvider(
"https://RPC"
) as providers.BaseProvider,
});
export const main = async () => {
try {
const adapter: MorphoAaveV3Adapter = MorphoAaveV3Adapter.fromChain({});
await adapter.refreshAll("latest");
const marketsData: any = adapter.getMarketsData();
console.log(marketsData);
} catch (error) {
console.error(`Failed to run main function: ${error}`);
}
};
main()
.then(() => process.exit(0))
.catch((error: Error) => {
console.error(`Failed to run script: ${error}`);
process.exit(1);
});
it returns: (WETH market displayed below)
{
'0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2': {
address: '0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2',
chainUsdPrice: BigNumber { _hex: '0x2a4caf8e00', _isBigNumber: true },
poolLiquidity: BigNumber { _hex: '0x14b060d6c505e0096e3a', _isBigNumber: true },
scaledPoolBorrow: BigNumber { _hex: '0x227a5fc1c09a6e8edbf8', _isBigNumber: true },
poolStableBorrow: BigNumber { _hex: '0x00', _isBigNumber: true },
scaledPoolSupply: BigNumber { _hex: '0x373ca00a23f10d32f418', _isBigNumber: true },
scaledMorphoBorrowOnPool: BigNumber { _hex: '0x00', _isBigNumber: true },
scaledMorphoSupplyInP2P: BigNumber { _hex: '0x0c0f6eca2c5369', _isBigNumber: true },
scaledMorphoBorrowInP2P: BigNumber { _hex: '0x0c0f6de638908d', _isBigNumber: true },
scaledMorphoGlobalPoolSupply: BigNumber { _hex: '0x0476aaf59bf29efb2d', _isBigNumber: true },
indexes: {
poolBorrowIndex: [BigNumber],
poolSupplyIndex: [BigNumber],
p2pBorrowIndex: [BigNumber],
p2pSupplyIndex: [BigNumber],
lastUpdateTimestamp: [BigNumber]
},
aaveIndexes: {
lastUpdateTimestamp: [BigNumber],
liquidityIndex: [BigNumber],
variableBorrowIndex: [BigNumber],
liquidityRate: [BigNumber],
variableBorrowRate: [BigNumber]
},
idleSupply: BigNumber { _hex: '0x00', _isBigNumber: true },
deltas: { supply: [Object], borrow: [Object] },
scaledMorphoCollateral: BigNumber { _hex: '0x00', _isBigNumber: true },
scaledMorphoSupplyOnPool: BigNumber { _hex: '0x046f9bf8d96886fa26', _isBigNumber: true },
usdPrice: BigNumber { _hex: '0x2a4caf8e00', _isBigNumber: true },
poolBorrow: BigNumber { _hex: '0x22e5a5d0e0f5b89f23d3', _isBigNumber: true },
poolSupply: BigNumber { _hex: '0x379484acf21e7c0cda6c', _isBigNumber: true },
morphoBorrowInP2P: BigNumber { _hex: '0x0c14ce865f5014', _isBigNumber: true },
morphoBorrowOnPool: BigNumber { _hex: '0x00', _isBigNumber: true },
morphoSupplyInP2P: BigNumber { _hex: '0x0c14ce865f5013', _isBigNumber: true },
morphoSupplyOnPool: BigNumber { _hex: '0x0476aaf59bf29ef743', _isBigNumber: true },
morphoGlobalSupplyOnPool: BigNumber { _hex: '0x047dc52da81df255d5', _isBigNumber: true },
totalMorphoSupply: BigNumber { _hex: '0x0476b70a6a78fe4756', _isBigNumber: true },
totalMorphoBorrow: BigNumber { _hex: '0x0c14ce865f5014', _isBigNumber: true },
totalMorphoCollateral: BigNumber { _hex: '0x00', _isBigNumber: true },
poolBorrowAPY: BigNumber { _hex: '0x0196', _isBigNumber: true },
poolSupplyAPY: BigNumber { _hex: '0xd7', _isBigNumber: true },
p2pSupplyAPY: BigNumber { _hex: '0x0136', _isBigNumber: true },
p2pBorrowAPY: BigNumber { _hex: '0x0136', _isBigNumber: true },
matchingRatio: BigNumber { _hex: '0x01', _isBigNumber: true },
supplyMatchingRatio: BigNumber { _hex: '0x00', _isBigNumber: true },
borrowMatchingRatio: BigNumber { _hex: '0x2710', _isBigNumber: true },
borrowMorphoRewardsRate: BigNumber { _hex: '0x00', _isBigNumber: true },
supplyMorphoRewardsRate: BigNumber { _hex: '0x00', _isBigNumber: true },
collateralMorphoRewardsRate: BigNumber { _hex: '0x00', _isBigNumber: true }
},
...
...
}
and all other information on the other available markets.
- 2.Second example using
getUserMarketsData()
export const main = async () => {
try {
const adapter: MorphoAaveV3Adapter = MorphoAaveV3Adapter.fromChain({
_provider: getDefaultProvider(
"https://YOUR_HTTPS_ACCESS"
),
});
await adapter.connect("0x395012DF0D443a7639E46Fcb0DAF756a9Bbf3c6c"); // User selected randomly
await adapter.refreshAll("latest");
const userDataUsdc: any =
adapter.getUserMarketsData()[
"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48" // This is the USDC market
];
console.log(userDataUsdc);
} catch (error) {
console.error(`Failed to run main function: ${error}`);
}
};
main()
.then(() => process.exit(0))
.catch((error: Error) => {
console.error(`Failed to run script: ${error}`);
process.exit(1);
});
will returns:
{
underlyingAddress: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
scaledSupplyOnPool: BigNumber { _hex: '0x00', _isBigNumber: true },
scaledCollateral: BigNumber { _hex: '0x97a2d2', _isBigNumber: true },
scaledSupplyInP2P: BigNumber { _hex: '0x00', _isBigNumber: true },
scaledBorrowOnPool: BigNumber { _hex: '0x00', _isBigNumber: true },
scaledBorrowInP2P: BigNumber { _hex: '0x00', _isBigNumber: true },
walletBalance: BigNumber { _hex: '0x10179138', _isBigNumber: true },
approval: BigNumber { _hex: '0x00', _isBigNumber: true },
nonce: BigNumber { _hex: '0x01', _isBigNumber: true },
permit2Approval: BigNumber {
_hex: '0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffff67697f',
_isBigNumber: true
},
totalCollateral: BigNumber { _hex: '0x9896d7', _isBigNumber: true },
supplyInP2P: BigNumber { _hex: '0x00', _isBigNumber: true },
supplyOnPool: BigNumber { _hex: '0x00', _isBigNumber: true },
borrowInP2P: BigNumber { _hex: '0x00', _isBigNumber: true },
borrowOnPool: BigNumber { _hex: '0x00', _isBigNumber: true },
totalBorrow: BigNumber { _hex: '0x00', _isBigNumber: true },
totalSupply: BigNumber { _hex: '0x00', _isBigNumber: true },
supplyMatchingRatio: BigNumber { _hex: '0x00', _isBigNumber: true },
borrowMatchingRatio: BigNumber { _hex: '0x00', _isBigNumber: true },
matchingRatio: BigNumber { _hex: '0x00', _isBigNumber: true },
experiencedBorrowAPY: BigNumber { _hex: '0x00', _isBigNumber: true },
experiencedCollateralAPY: BigNumber { _hex: '0xe0', _isBigNumber: true },
experiencedSupplyAPY: BigNumber { _hex: '0x00', _isBigNumber: true },
experiencedBorrowMorphoEmission: BigNumber { _hex: '0x00', _isBigNumber: true },
experiencedSupplyMorphoEmission: BigNumber { _hex: '0x00', _isBigNumber: true },
experiencedCollateralMorphoEmission: BigNumber { _hex: '0x00', _isBigNumber: true }
}
Third example to retrieve the supply emission of MORPHO rewards emitted for 1000$ using
getMarketsData(): on the WETH market:export const main = async () => {
try {
const adapter: MorphoAaveV3Adapter = MorphoAaveV3Adapter.fromChain();
await adapter.refreshAll("latest");
const marketsData: any = adapter.getMarketsData();
const marketAddress = "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"; //WETH market
const specificMarketData = marketsData[marketAddress];
const SECONDS_PER_YEAR = BigNumber.from(31_536_000);
let supplyMorphoEmission: BigNumber = constants.Zero;
const scalingValueUnderlying = utils
.parseUnits("1000") // 1000$ in underlying
.mul(pow10(18))
.div(specificMarketData.usdPrice.mul(10 ** 10));
supplyMorphoEmission = scalingValueUnderlying
.mul(specificMarketData.supplyMorphoRewardsRate)
.mul(SECONDS_PER_YEAR) // in WAD
.div(specificMarketData.totalMorphoSupply.add(scalingValueUnderlying))
.div(pow10(18));
console.log(supplyMorphoEmission.toString());
} catch (error) {
console.error(`Failed to run main function: ${error}`);
}
};
main()
.then(() => process.exit(0))
.catch((error: Error) => {
console.error(`Failed to run script: ${error}`);
process.exit(1);
});
Will returns
BigNumber { _hex: '0x15', _isBigNumber: true }
Developers seeking to make advanced customizations can find additional resources and extended documentation in the full documentation provided in the README.
If you have any questions or need further assistance, please don't hesitate to reach out on Discord.
Last modified 2mo ago