@strikefinance/strike-js
v1.0.0
Published
A JavaScript SDK for Ethereum and the Strike Protocol.
Downloads
7
Readme
Strike.js
A JavaScript SDK for Ethereum and the Strike Protocol. Wraps around Ethers.js. Works in the web browser and Node.js.
This SDK is in open beta, and is constantly under development. USE AT YOUR OWN RISK.
Ethereum Read & Write
JSON RPC based Ethereum read and write.
Read
const Strike = require('@strike-finance/strike-js'); // in Node.js
const sUsdtAddress = Strike.util.getAddress(Strike.sUSDT);
(async function() {
let supplyRatePerBlock = await Strike.eth.read(
sUsdtAddress,
'function supplyRatePerBlock() returns (uint)',
[], // [optional] parameters
{} // [optional] call options, provider, network, ethers.js "overrides"
);
console.log('USDT supplyRatePerBlock:', supplyRatePerBlock.toString());
})().catch(console.error);
Write
const toAddress = '0xa0df350d2637096571F7A701CBc1C5fdE30dF76A';
(async function() {
const trx = await Strike.eth.trx(
toAddress,
'function send() external payable',
[],
{
value: Strike._ethers.utils.parseEther('1.0'), // 1 ETH
provider: window.ethereum, // in a web browser
}
);
const toAddressEthBalance = await Strike.eth.getBalance(toAddress);
})().catch(console.error);
Strike Protocol
Simple methods for using the Strike protocol.
const strike = new Strike(window.ethereum); // in a web browser
// Ethers.js overrides are an optional 3rd parameter for `supply`
// const trxOptions = { gasLimit: 250000, mantissa: false };
(async function() {
console.log('Supplying ETH to the Strike protocol...');
const trx = await strike.supply(Strike.ETH, 1);
console.log('Ethers.js transaction object', trx);
})().catch(console.error);
Install / Import
Web Browser
<script type="text/javascript" src="https://cdn.jsdelivr.net/npm/@strike-finance/strike-js@latest/dist/browser/strike.min.js"></script>
<script type="text/javascript">
window.Strike; // or `Strike`
</script>
Node.js
npm install @strike-finance/strike-js
const Strike = require('@strike-finance/strike-js');
// or, when using ES6
import Strike from '@strike-finance/strike-js';
More Code Examples
See the docblock comments above each function definition or the official Strike.js Documentation.
Instance Creation
The following are valid Ethereum providers for initialization of the SDK.
var strike = new Strike(window.ethereum); // web browser
var strike = new Strike('http://127.0.0.1:8545'); // HTTP provider
var strike = new Strike(); // Uses Ethers.js fallback mainnet (for testing only)
var strike = new Strike('ropsten'); // Uses Ethers.js fallback (for testing only)
// Init with private key (server side)
var strike = new Strike('https://mainnet.infura.io/v3/_your_project_id_', {
privateKey: '0x_your_private_key_', // preferably with environment variable
});
// Init with HD mnemonic (server side)
var strike = new Strike('mainnet' {
mnemonic: 'clutch captain shoe...', // preferably with environment variable
});
Constants and Contract Addresses
Names of contracts, their addresses, ABIs, token decimals, and more can be found in /src/constants.ts
. Addresses, for all networks, can be easily fetched using the getAddress
function, combined with contract name constants.
console.log(Strike.BUSD, Strike.ETH, Strike.sETH);
// BUSD, ETH, sETH
const sUsdtAddress = Strike.util.getAddress(Strike.sUSDT);
// Mainnet sUSDT address. Second parameter can be a network like 'ropsten'.
Mantissas
Parameters of number values can be plain numbers or their scaled up mantissa values. There is a transaction option boolean to tell the SDK what the developer is passing.
// 1 Busd
await strike.borrow(Strike.BUSD, '1000000000000000000', { mantissa: true });
// `mantissa` defaults to false if it is not specified or if an options object is not passed
await strike.borrow(Strike.BUSD, 1, { mantissa: false });
Transaction Options
Each method that interacts with the blockchain accepts a final optional parameter for overrides, much like Ethers.js overrides.
// The options object itself and all options are optional
const trxOptions = {
mantissa, // Boolean, parameters array arg of 1 ETH would be '1000000000000000000' (true) vs 1 (false)
abi, // Definition string or an ABI array from a solc build
provider, // JSON RPC string, Web3 object, or Ethers.js fallback network (string)
network, // Ethers.js fallback network provider, "provider" has precedence over "network"
from, // Address that the Ethereum transaction is send from
gasPrice, // Ethers.js override `Strike._ethers.utils.parseUnits('10.0', 'gwei')`
gasLimit, // Ethers.js override - see https://docs.ethers.io/ethers.js/v5-beta/api-contract.html#overrides
value, // Number or string
data, // Number or string
chainId, // Number
nonce, // Number
privateKey, // String, meant to be used with `Strike.eth.trx` (server side)
mnemonic, // String, meant to be used with `Strike.eth.trx` (server side)
};
API
The Strike API is accessible from Strike.js. The corresponding services are defined in the api
namespace on the class.
Strike.api.account
Strike.api.sToken
Strike.api.marketHistory
Strike.api.governance
The governance method requires a second parameter (string) for the corresponding endpoint shown in the documentation.
proposals
voteReceipts
accounts
Here is an example for using the account
endpoint. The network
parameter in the request body is optional and defaults to mainnet
.
const main = async () => {
const account = await Strike.api.account({
"addresses": "0xB61C5971d9c0472befceFfbE662555B78284c307",
"network": "ropsten"
});
let busdBorrowBalance = 0;
if (Object.isExtensible(account) && account.accounts) {
account.accounts.forEach((acc) => {
acc.tokens.forEach((tok) => {
if (tok.symbol === Strike.sBUSD) {
busdBorrowBalance = +tok.borrow_balance_underlying.value;
}
});
});
}
console.log('busdBorrowBalance', busdBorrowBalance);
}
main().catch(console.error);
Test
Tests are available in ./test/*.test.js
. The tests are configured in ./test/index.js
. Methods are tested using a forked chain using ganache-core. A JSON RPC provider URL needs to be configured as an environment variable before running the tests (MAINNET_PROVIDER_URL
). Archive state must be available to run the tests. For free archive node access, get a provider URL from Alchemy.
## Run all tests
npm test
## Run a single test (Mocha JS grep option)
npm test -- -g 'runs eth.getBalance'
Build for Node.js & Web Browser
git clone [email protected]:StrikeFinance/strike-js.git
cd strike-js/
npm install
npm run build
Web Browser Build
<!-- Local build (do `npm install` first) -->
<script type="text/javascript" src="./dist/browser/strike.min.js"></script>
<!-- Public NPM -> jsdeliver build -->
<script type="text/javascript" src="https://cdn.jsdelivr.net/npm/@strike-finance/strike-js@latest/dist/browser/strike.min.js"></script>
Node.js Build
// Local build (do `npm install` first)
const Strike = require('./dist/nodejs/index.js');
// Public NPM build
const Strike = require('@strike-finance/strike-js');