UNPKG

fortress-js

Version:

A JavaScript SDK for Binance Smart Chain and the Fortress Protocol.

912 lines (824 loc) 27 kB
/** * @file COMP * @desc These methods facilitate interactions with the COMP token smart * contract. */ import { ethers } from 'ethers'; import * as eth from './eth'; import { netId } from './helpers'; import { address, abi } from './constants'; import { sign } from './EIP712'; import { CallOptions, TrxResponse, Signature, EIP712Domain, DelegateTypes, DelegateSignatureMessage, Provider, } from './types'; import { BigNumber } from '@ethersproject/bignumber/lib/bignumber'; const keccak256 = ethers.utils.keccak256; /** * Applies the EIP-55 checksum to an Ethereum address. * * @param {string} _address The Ethereum address to apply the checksum. * * @returns {string} Returns a string of the Ethereum address. */ function toChecksumAddress(_address) { const chars = _address.toLowerCase().substring(2).split(''); const expanded = new Uint8Array(40); for (let i = 0; i < 40; i++) { expanded[i] = chars[i].charCodeAt(0); } const hash = keccak256(expanded); let ret = ''; for (let i = 0; i < _address.length; i++) { if (parseInt(hash[i], 16) >= 8) { ret += _address[i].toUpperCase(); } else { ret += _address[i]; } } return ret; } /** * Get the balance of FORTRESS tokens held by an address. * * @param {string} _address The address in which to find the FORTRESS balance. * @param {Provider | string} [_provider] An Ethers.js provider or valid network * name string. * * @returns {string} Returns a string of the numeric balance of FORTRESS. The value * is scaled up by 18 decimal places. * * @example * * ``` * (async function () { * const bal = await Fortress.fortress.getFortressBalance('0x2775b1c75658Be0F640272CCb8c72ac986009e38'); * console.log('Balance', bal); * })().catch(console.error); * ``` */ export async function getFortressBalance( _address: string, _provider : Provider | string='mainnet' ) : Promise<string> { const provider = await eth._createProvider({ provider: _provider }); const net = await eth.getProviderNetwork(provider); const errorPrefix = 'Fortress [getFortressBalance] | '; if (typeof _address !== 'string') { throw Error(errorPrefix + 'Argument `_address` must be a string.'); } try { _address = toChecksumAddress(_address); } catch(e) { throw Error(errorPrefix + 'Argument `_address` must be a valid Ethereum address.'); } const compAddress = address[net.name].COMP; const parameters = [ _address ]; const trxOptions: CallOptions = { _compoundProvider: provider, abi: abi.COMP, }; const result = await eth.read(compAddress, 'balanceOf', parameters, trxOptions); return result.toString(); } /** * Get the amount of FORTRESS tokens accrued but not yet claimed by an address. * * @param {string} _address The address in which to find the FORTRESS accrued. * @param {Provider | string} [_provider] An Ethers.js provider or valid network * name string. * * @returns {string} Returns a string of the numeric accruement of FORTRESS. The * value is scaled up by 18 decimal places. * * @example * * ``` * (async function () { * const acc = await Fortress.fortress.getFortressAccrued('0x4Ddc2D193948926D02f9B1fE9e1daa0718270ED5'); * console.log('Accrued', acc); * })().catch(console.error); * ``` */ export async function getFortressAccrued( _address: string, _provider : Provider | string='mainnet' ) : Promise<string> { const provider = await eth._createProvider({ provider: _provider }); const net = await eth.getProviderNetwork(provider); const errorPrefix = 'Fortress [getFortressAccrued] | '; if (typeof _address !== 'string') { throw Error(errorPrefix + 'Argument `_address` must be a string.'); } try { _address = toChecksumAddress(_address); } catch(e) { throw Error(errorPrefix + 'Argument `_address` must be a valid Ethereum address.'); } const lensAddress = address[net.name].CompoundLens; const compAddress = address[net.name].COMP; const comptrollerAddress = address[net.name].Comptroller; const parameters = [ compAddress, comptrollerAddress, _address ]; const trxOptions: CallOptions = { _compoundProvider: provider, abi: abi.CompoundLens, }; const result = await eth.read(lensAddress, 'getFTSBalanceMetadataExt', parameters, trxOptions); return result.allocated.toString(); } /** * Create a transaction to claim accrued FORTRESS tokens for the user. * * @param {CallOptions} [options] Options to set for a transaction and Ethers.js * method overrides. * * @returns {object} Returns an Ethers.js transaction object of the vote * transaction. * * @example * * ``` * const fortress = new Fortress(window.ethereum); * * (async function() { * * console.log('Claiming Fortress...'); * const trx = await fortress.claimFortress(); * console.log('Ethers.js transaction object', trx); * * })().catch(console.error); * ``` */ export async function claimFortress( options: CallOptions = {} ) : Promise<TrxResponse> { await netId(this); try { let userAddress = this._provider.address; if (!userAddress && this._provider.getAddress) { userAddress = await this._provider.getAddress(); } const comptrollerAddress = address[this._network.name].Comptroller; const trxOptions: CallOptions = { ...options, _compoundProvider: this._provider, abi: abi.Comptroller, }; const parameters = [ userAddress ]; const method = 'claimFortress(address)'; return eth.trx(comptrollerAddress, method, parameters, trxOptions); } catch(e) { const errorPrefix = 'Fortress [claimFortress] | '; e.message = errorPrefix + e.message; return e; } } /** * Create a transaction to delegate Fortress Governance voting rights to an * address. * * @param {string} _address The address in which to delegate voting rights to. * @param {CallOptions} [options] Options to set for `eth_call`, optional ABI * (as JSON object), and Ethers.js method overrides. The ABI can be a string * of the single intended method, an array of many methods, or a JSON object * of the ABI generated by a Solidity compiler. * * @returns {object} Returns an Ethers.js transaction object of the vote * transaction. * * @example * * ``` * const fortress = new Fortress(window.ethereum); * * (async function() { * const delegateTx = await fortress.delegate('0xa0df350d2637096571F7A701CBc1C5fdE30dF76A'); * console.log('Ethers.js transaction object', delegateTx); * })().catch(console.error); * ``` */ export async function delegate( _address: string, options: CallOptions = {} ) : Promise<TrxResponse> { await netId(this); const errorPrefix = 'Fortress [delegate] | '; if (typeof _address !== 'string') { throw Error(errorPrefix + 'Argument `_address` must be a string.'); } try { _address = toChecksumAddress(_address); } catch(e) { throw Error(errorPrefix + 'Argument `_address` must be a valid Ethereum address.'); } const compAddress = address[this._network.name].COMP; const trxOptions: CallOptions = { ...options, _compoundProvider: this._provider, abi: abi.COMP, }; const parameters = [ _address ]; const method = 'delegate'; return eth.trx(compAddress, method, parameters, trxOptions); } /** * Delegate voting rights in Fortress Governance using an EIP-712 signature. * * @param {string} _address The address to delegate the user's voting rights to. * @param {number} nonce The contract state required to match the signature. * This can be retrieved from the FORTRESS contract's public nonces mapping. * @param {number} expiry The time at which to expire the signature. A block * timestamp as seconds since the unix epoch. * @param {object} signature An object that contains the v, r, and, s values of * an EIP-712 signature. * @param {CallOptions} [options] Options to set for `eth_call`, optional ABI * (as JSON object), and Ethers.js method overrides. The ABI can be a string * of the single intended method, an array of many methods, or a JSON object * of the ABI generated by a Solidity compiler. * * @returns {object} Returns an Ethers.js transaction object of the vote * transaction. * * @example * * ``` * const fortress = new Fortress(window.ethereum); * * (async function() { * const delegateTx = await fortress.delegateBySig( * '0xa0df350d2637096571F7A701CBc1C5fdE30dF76A', * 42, * 9999999999, * { * v: '0x1b', * r: '0x130dbca2fafa07424c033b4479687cc1deeb65f08809e3ab397988cc4c6f2e78', * s: '0x1debeb8250262f23906b1177161f0c7c9aa3641e8bff5b6f5c88a6bb78d5d8cd' * } * ); * console.log('Ethers.js transaction object', delegateTx); * })().catch(console.error); * ``` */ export async function delegateBySig( _address: string, nonce: number, expiry: number, signature: Signature = { v: '', r: '', s: '' }, options: CallOptions = {} ) : Promise<TrxResponse> { await netId(this); const errorPrefix = 'Fortress [delegateBySig] | '; if (typeof _address !== 'string') { throw Error(errorPrefix + 'Argument `_address` must be a string.'); } try { _address = toChecksumAddress(_address); } catch(e) { throw Error(errorPrefix + 'Argument `_address` must be a valid Ethereum address.'); } if (typeof nonce !== 'number') { throw Error(errorPrefix + 'Argument `nonce` must be an integer.'); } if (typeof expiry !== 'number') { throw Error(errorPrefix + 'Argument `expiry` must be an integer.'); } if ( !Object.isExtensible(signature) || !signature.v || !signature.r || !signature.s ) { throw Error(errorPrefix + 'Argument `signature` must be an object that ' + 'contains the v, r, and s pieces of an EIP-712 signature.'); } const compAddress = address[this._network.name].COMP; const trxOptions: CallOptions = { ...options, _compoundProvider: this._provider, abi: abi.COMP, }; const { v, r, s } = signature; const parameters = [ _address, nonce, expiry, v, r, s ]; const method = 'delegateBySig'; return eth.trx(compAddress, method, parameters, trxOptions); } /** * Create a delegate signature for Fortress Governance using EIP-712. The * signature can be created without burning gas. Anyone can post it to the * blockchain using the `delegateBySig` method, which does have gas costs. * * @param {string} delegatee The address to delegate the user's voting rights * to. * @param {number} [expiry] The time at which to expire the signature. A block * timestamp as seconds since the unix epoch. Defaults to `10e9`. * * @returns {object} Returns an object that contains the `v`, `r`, and `s` * components of an Ethereum signature as hexadecimal strings. * * @example * * ``` * const fortress = new Fortress(window.ethereum); * * (async () => { * * const delegateSignature = await fortress.createDelegateSignature('0xa0df350d2637096571F7A701CBc1C5fdE30dF76A'); * console.log('delegateSignature', delegateSignature); * * })().catch(console.error); * ``` */ export async function createDelegateSignature( delegatee: string, expiry = 10e9 ) : Promise<Signature> { await netId(this); const provider = this._provider; const compAddress = address[this._network.name].COMP; const chainId = this._network.id; let userAddress = this._provider.address; if (!userAddress && this._provider.getAddress) { userAddress = await this._provider.getAddress(); } const originalProvider = this._originalProvider; const nonce = +(await eth.read( compAddress, 'function nonces(address) returns (uint)', [ userAddress ], { provider: originalProvider } )).toString(); const domain: EIP712Domain = { name: 'Compound', chainId, verifyingContract: compAddress }; const primaryType = 'Delegation'; const message: DelegateSignatureMessage = { delegatee, nonce, expiry }; const types: DelegateTypes = { EIP712Domain: [ { name: 'name', type: 'string' }, { name: 'chainId', type: 'uint256' }, { name: 'verifyingContract', type: 'address' }, ], Delegation: [ { name: 'delegatee', type: 'address' }, { name: 'nonce', type: 'uint256' }, { name: 'expiry', type: 'uint256' } ] }; const signer = provider.getSigner ? provider.getSigner() : provider; const signature = await sign(domain, primaryType, message, types, signer); return signature; } /** * Get the mintable FAI amount of address. * * @param {string} _address The address in which to get mintable FAI amount. * @param {CallOptions} [options] Options to set for `eth_call`, optional ABI * (as JSON object), and Ethers.js method overrides. The ABI can be a string * of the single intended method, an array of many methods, or a JSON object * of the ABI generated by a Solidity compiler. * * @returns {string} Returns a string of the numeric amount of mintable FAI. The * value is scaled up by 18 decimal places. * * @example * * ``` * const fortress = new Fortress(window.ethereum); * * (async () => { * * const amount = await fortress.getMintableFAI('0x4Ddc2D193948926D02f9B1fE9e1daa0718270ED5'); * console.log('MintableFAI amount', amount); * * })().catch(console.error); * ``` */ export async function getMintableFAI( _address: string, options: CallOptions = {} ) : Promise<string> { const errorPrefix = 'Fortress [getMintableFAI] | '; if (typeof _address !== 'string') { throw Error(errorPrefix + 'Argument `_address` must be a string.'); } try { _address = toChecksumAddress(_address); } catch(e) { throw Error(errorPrefix + 'Argument `_address` must be a valid Ethereum address.'); } const comptrollerAddress = address[this._network.name].Comptroller; const parameters = [ _address ]; const trxOptions: CallOptions = { ...options, _compoundProvider: this._provider, abi: abi.Comptroller, }; const result = await eth.read(comptrollerAddress, 'getMintableFAI', parameters, trxOptions); if (result.length > 1 && result[0].toString() === "0") { return result[1].toString(); } else { throw Error(errorPrefix + 'Contract error occured'); } } /** * Get the FAI mint rate. * * @param {CallOptions} [options] Options to set for `eth_call`, optional ABI * (as JSON object), and Ethers.js method overrides. The ABI can be a string * of the single intended method, an array of many methods, or a JSON object * of the ABI generated by a Solidity compiler. * * @returns {string} Returns a string of the numeric FAI mint rate. * * @example * * ``` * const fortress = new Fortress(window.ethereum); * * (async () => { * * const rate = await fortress.getFAIMintRate(); * console.log('FAI mint rate', rate); * * })().catch(console.error); * ``` */ export async function getFAIMintRate( options: CallOptions = {} ) : Promise<string> { const comptrollerAddress = address[this._network.name].Comptroller; const trxOptions: CallOptions = { ...options, _compoundProvider: this._provider, abi: abi.Comptroller, }; const result = await eth.read(comptrollerAddress, 'getFAIMintRate', [], trxOptions); return result.toString(); } /** * Get the mintFAIGuardianPaused. * * @param {CallOptions} [options] Options to set for `eth_call`, optional ABI * (as JSON object), and Ethers.js method overrides. The ABI can be a string * of the single intended method, an array of many methods, or a JSON object * of the ABI generated by a Solidity compiler. * * @returns {boolean} Returns a string of the boolean mintFAIGuardianPaused. * * @example * * ``` * const fortress = new Fortress(window.ethereum); * * (async () => { * * const _mintFAIGuardianPaused = await fortress.mintFAIGuardianPaused(); * console.log('mintFAIGuardianPaused', _mintFAIGuardianPaused); * * })().catch(console.error); * ``` */ export async function mintFAIGuardianPaused( options: CallOptions = {} ) : Promise<string> { const comptrollerAddress = address[this._network.name].Comptroller; const trxOptions: CallOptions = { ...options, _compoundProvider: this._provider, abi: abi.Comptroller, }; const result = await eth.read(comptrollerAddress, 'mintFAIGuardianPaused', [], trxOptions); return result; } /** * Get the repayFAIGuardianPaused. * * @param {CallOptions} [options] Options to set for `eth_call`, optional ABI * (as JSON object), and Ethers.js method overrides. The ABI can be a string * of the single intended method, an array of many methods, or a JSON object * of the ABI generated by a Solidity compiler. * * @returns {boolean} Returns a string of the boolean repayFAIGuardianPaused. * * @example * * ``` * const fortress = new Fortress(window.ethereum); * * (async () => { * * const _repayFAIGuardianPaused = await fortress.repayFAIGuardianPaused(); * console.log('repayFAIGuardianPaused', _repayFAIGuardianPaused); * * })().catch(console.error); * ``` */ export async function repayFAIGuardianPaused( options: CallOptions = {} ) : Promise<string> { const comptrollerAddress = address[this._network.name].Comptroller; const trxOptions: CallOptions = { ...options, _compoundProvider: this._provider, abi: abi.Comptroller, }; const result = await eth.read(comptrollerAddress, 'repayFAIGuardianPaused', [], trxOptions); return result; } /** * Get the minted FAI amount of the address. * * @param {string} _address The address in which to get the minted FAI amount. * @param {CallOptions} [options] Options to set for `eth_call`, optional ABI * (as JSON object), and Ethers.js method overrides. The ABI can be a string * of the single intended method, an array of many methods, or a JSON object * of the ABI generated by a Solidity compiler. * * @returns {string} Returns a string of the numeric amount of minted FAI. The * value is scaled up by 18 decimal places. * * @example * * ``` * const fortress = new Fortress(window.ethereum); * * (async () => { * * const amount = await fortress.mintedFAIOf('0x4Ddc2D193948926D02f9B1fE9e1daa0718270ED5'); * console.log('Minted FAI amount', amount); * * })().catch(console.error); * ``` */ export async function mintedFAIOf( _address: string, options: CallOptions = {} ) : Promise<string> { const errorPrefix = 'Fortress [mintedFAIOf] | '; if (typeof _address !== 'string') { throw Error(errorPrefix + 'Argument `_address` must be a string.'); } try { _address = toChecksumAddress(_address); } catch(e) { throw Error(errorPrefix + 'Argument `_address` must be a valid Ethereum address.'); } const comptrollerAddress = address[this._network.name].Comptroller; const parameters = [ _address ]; const trxOptions: CallOptions = { ...options, _compoundProvider: this._provider, abi: abi.Comptroller, }; const result = await eth.read(comptrollerAddress, 'mintedFAIOf', parameters, trxOptions); return result.toString(); } /** * Get the minted FAI amount of the address. * * @param {string} _address The address in which to get the minted FAI amount. * @param {CallOptions} [options] Options to set for `eth_call`, optional ABI * (as JSON object), and Ethers.js method overrides. The ABI can be a string * of the single intended method, an array of many methods, or a JSON object * of the ABI generated by a Solidity compiler. * * @returns {string} Returns a string of the numeric amount of minted FAI. The * value is scaled up by 18 decimal places. * * @example * * ``` * const fortress = new Fortress(window.ethereum); * * (async () => { * * const amount = await fortress.mintedFAIs('0x4Ddc2D193948926D02f9B1fE9e1daa0718270ED5'); * console.log('Minted FAI amount', amount); * * })().catch(console.error); * ``` */ export async function mintedFAIs( _address: string, options: CallOptions = {} ) : Promise<string> { const errorPrefix = 'Fortress [mintedFAIs] | '; if (typeof _address !== 'string') { throw Error(errorPrefix + 'Argument `_address` must be a string.'); } try { _address = toChecksumAddress(_address); } catch(e) { throw Error(errorPrefix + 'Argument `_address` must be a valid Ethereum address.'); } const comptrollerAddress = address[this._network.name].Comptroller; const parameters = [ _address ]; const trxOptions: CallOptions = { ...options, _compoundProvider: this._provider, abi: abi.Comptroller, }; const result = await eth.read(comptrollerAddress, 'mintedFAIs', parameters, trxOptions); return result.toString(); } /** * Get the faiController. * * @param {CallOptions} [options] Options to set for `eth_call`, optional ABI * (as JSON object), and Ethers.js method overrides. The ABI can be a string * of the single intended method, an array of many methods, or a JSON object * of the ABI generated by a Solidity compiler. * * @returns {string} Returns a string of the faiController address. * * @example * * ``` * const fortress = new Fortress(window.ethereum); * * (async () => { * * const faiControllerAddress = await fortress.faiController(); * console.log('faiControllerAddress', faiControllerAddress); * * })().catch(console.error); * ``` */ export async function faiController( options: CallOptions = {} ) : Promise<string> { const comptrollerAddress = address[this._network.name].Comptroller; const trxOptions: CallOptions = { ...options, _compoundProvider: this._provider, abi: abi.Comptroller, }; const result = await eth.read(comptrollerAddress, 'faiController', [], trxOptions); return result; } /** * Get the faiMintRate. * * @param {CallOptions} [options] Options to set for `eth_call`, optional ABI * (as JSON object), and Ethers.js method overrides. The ABI can be a string * of the single intended method, an array of many methods, or a JSON object * of the ABI generated by a Solidity compiler. * * @returns {string} Returns a string of the numeric faiMintRate. * * @example * * ``` * const fortress = new Fortress(window.ethereum); * * (async () => { * * const faiMintRate = await fortress.faiMintRate(); * console.log('faiMintRate', faiMintRate); * * })().catch(console.error); * ``` */ export async function faiMintRate( options: CallOptions = {} ) : Promise<string> { const comptrollerAddress = address[this._network.name].Comptroller; const trxOptions: CallOptions = { ...options, _compoundProvider: this._provider, abi: abi.Comptroller, }; const result = await eth.read(comptrollerAddress, 'faiMintRate', [], trxOptions); return result.toString(); } /** * Mint FAI in the Fortress Protocol. * * @param {number | string | BigNumber} mintFAIAmount A string, number, or BigNumber * object of the amount of an asset to mintFAI. Use the `mantissa` boolean in * the `options` parameter to indicate if this value is scaled up (so there * are no decimals) or in its natural scale. * @param {CallOptions} [options] Call options and Ethers.js overrides for the * transaction. * * @returns {object} Returns an Ethers.js transaction object of the mintFAI * transaction. * * @example * * ``` * const fortress = new Fortress(window.ethereum); * * // const trxOptions = { gasLimit: 250000, mantissa: false }; * * (async function() { * * console.log('Minting FAI in the Fortress Protocol...'); * const trx = await fortress.mintFAI(1); * console.log('Ethers.js transaction object', trx); * * })().catch(console.error); * ``` */ export async function mintFAI( mintFAIAmount: string | number | BigNumber, options: CallOptions = {} ) : Promise<TrxResponse> { await netId(this); const errorPrefix = 'Fortress [mintFAI] | '; if ( typeof mintFAIAmount !== 'number' && typeof mintFAIAmount !== 'string' && !ethers.BigNumber.isBigNumber(mintFAIAmount) ) { throw Error(errorPrefix + 'Argument `amount` must be a string, number, or BigNumber.'); } if (!options.mantissa) { mintFAIAmount = +mintFAIAmount; mintFAIAmount = mintFAIAmount * Math.pow(10, 18); } mintFAIAmount = ethers.BigNumber.from(mintFAIAmount.toString()); try { const comptrollerAddress = address[this._network.name].Comptroller; const trxOptions: CallOptions = { ...options, _compoundProvider: this._provider, abi: abi.Comptroller, }; const parameters = [ mintFAIAmount ]; return eth.trx(comptrollerAddress, 'mintFAI', parameters, trxOptions); } catch(e) { const errorPrefix = 'Fortress [mintFAI] | '; e.message = errorPrefix + e.message; return e; } } /** * Repay FAI in the Fortress Protocol. * * @param {number | string | BigNumber} repayFAIAmount A string, number, or BigNumber * object of the amount of an asset to repay. Use the `mantissa` boolean in * the `options` parameter to indicate if this value is scaled up (so there * are no decimals) or in its natural scale. * @param {CallOptions} [options] Call options and Ethers.js overrides for the * transaction. * * @returns {object} Returns an Ethers.js transaction object of the repayFAI * transaction. * * @example * * ``` * const fortress = new Fortress(window.ethereum); * * // const trxOptions = { gasLimit: 250000, mantissa: false }; * * (async function() { * * console.log('Repaying FAI in the Fortress Protocol...'); * const trx = await fortress.repayFAI(1); * console.log('Ethers.js transaction object', trx); * * })().catch(console.error); * ``` */ export async function repayFAI( repayFAIAmount: string | number | BigNumber, options: CallOptions = {} ) : Promise<TrxResponse> { await netId(this); const errorPrefix = 'Fortress [mintFAI] | '; if ( typeof repayFAIAmount !== 'number' && typeof repayFAIAmount !== 'string' && !ethers.BigNumber.isBigNumber(repayFAIAmount) ) { throw Error(errorPrefix + 'Argument `amount` must be a string, number, or BigNumber.'); } if (!options.mantissa) { repayFAIAmount = +repayFAIAmount; repayFAIAmount = repayFAIAmount * Math.pow(10, 18); } repayFAIAmount = ethers.BigNumber.from(repayFAIAmount.toString()); try { const comptrollerAddress = address[this._network.name].Comptroller; const trxOptions: CallOptions = { ...options, _compoundProvider: this._provider, abi: abi.Comptroller, }; const parameters = [ repayFAIAmount ]; return eth.trx(comptrollerAddress, 'repayFAI', parameters, trxOptions); } catch(e) { const errorPrefix = 'Fortress [repayFAI] | '; e.message = errorPrefix + e.message; return e; } }