A JavaScript SDK for Ethereum and the Compound Protocol
We’re excited to announce a brand new software program growth package that we’ve been engaged on. Enter Compound.js; a JavaScript SDK for Ethereum and the Compound Protocol. This device streamlines the software program growth course of for constructing DApps that speed up DeFi.
On the time of this announcement, the SDK is formally in beta. It’s out there for all, open supply, on GitHub and NPM. Compound.js works within the internet browser and Node.js. It has only one dependency: the newest model of Ethers.js.
Constructed with simplicity in thoughts, builders can write intuitive, one-line strategies to initialize JSON RPC requests that work together with the Compound Protocol.
Along with Compound strategies, builders could make generic Ethereum learn and write calls to any good contract. Lastly, REST API calls will be made to the Compound API that’s hosted by Compound Labs.
Studying and writing from the blockchain will be completed swiftly with Compound.js; no must initialize an object.
Within the following examples, A JSON RPC supplier or Web3 supplier will be handed because the supplier attribute within the choices object. When writing to the blockchain, a personal key or mnemonic will be handed within the choices object as properly.
Write to the Blockchain (eth_sendTransaction)
Write operations are initialized with Compound.eth.trx. The return worth is an Ethers.js transaction object. Right here is an instance for sending ETH within the internet browser.
Learn from the Blockchain (eth_call)
Studying from any good contract on the blockchain will be completed utilizing Compound.eth.learn. Right here is an instance for studying the USDC stability within the Uniswap USDC-ETH pair.
A contract ABI can be handed to the choices object. In that case, you’ll then present a string of the strategy identify because the second parameter, as an alternative of the entire technique definition.
Easy one-liners can be found for main protocol strategies like provide, redeem, borrow, repayBorrow, and extra.
In examples like the next, a Compound object have to be instantiated first. The constructor can have window.ethereum handed within the browser, or a personal key/mnemonic alongside a JSON RPC supplier if you happen to’re utilizing Node.js.
Supplying to the Protocol
Right here is an instance for supplying Ether to the Compound Protocol utilizing Compound.js.
Extra examples of object initialization and deeper description of the transaction choices parameter can be found within the Compound.js GitHub repository readme.
Governance and COMP Strategies
The SDK has elegant strategies for Compound governance performance by means of the COMP and Governor good contracts.
Right here is an instance for fetching the quantity of COMP token that has accrued for an handle (extra on COMP Distribution right here).
Voting on a Compound governance proposal is as easy utilizing the SDK’s castVote technique.
Extra governance associated strategies are outlined within the Compound.js Documentation.
Getting Costs
Fetching costs from the Open Worth Feed will be completed with the getPrice technique.
The primary parameter is the asset that you really want the worth of, and the second parameter (non-obligatory) is the asset you need that worth transformed to. The default output is USD with 6 decimal locations.
This technique helps all property which might be posted to the Open Worth Feed, and likewise cTokens.
The Compound REST API will be queried utilizing Compound.js. Every of the out there companies has their very own technique.
- market
- account
- cToken
- governance
Every of the request parameters outlined within the documentation (linked above) will be handed within the JavaScript object parameter. Right here is an instance for querying the Market Historical past Service.
Compound.js is in open beta and is offered free of charge on NPM. The plan for subsequent steps is so as to add extra Compound Protocol associated strategies for ease of growth. Additionally, smarter logging of errors and outcomes would tremendously enhance the developer expertise.
Do not forget that the Compound Protocol is decentralized and upgraded by the neighborhood. Because of this, this SDK will morph nevertheless the neighborhood sees match!
A neighborhood contribution information might be out there sooner or later for anybody to assist enhance the SDK.
In case you have questions or feedback, please be part of the Compound Discord and ship us a message within the #💻growth channel.