7 Commits

Author SHA1 Message Date
Danil Kovtonyuk
5036c65643 add xDAI 2021-08-25 22:31:20 +10:00
Danil Kovtonyuk
89a69519b2 fix: test 2021-08-17 17:14:50 +10:00
Danil Kovtonyuk
3fce50efbb fix: constructor 2021-08-17 17:04:01 +10:00
Danil Kovtonyuk
9b0c229ace add polygon 2021-06-15 13:26:02 +03:00
Danil Kovtonyuk
a508e41652 fix: bscgas property 2021-06-10 23:33:59 +03:00
Danil Kovtonyuk
bb58318b6f add defaultFallbackGasPrices option 2021-06-03 15:16:49 +03:00
Danil Kovtonyuk
32c256bc4e update readme 2021-06-03 13:01:25 +03:00
10 changed files with 110 additions and 49 deletions

View File

@@ -2,10 +2,13 @@
A library that has a collection of onchain and offchain gas price oracle URLs
## Supported networks
### Ethereum Mainnet
Current offchain list:
- https://ethgasstation.info/json/ethgasAPI.json
- https://gas-oracle.zoltu.io/
- https://www.etherchain.org/api/gasPriceOracle
- https://gasprice.poa.network/
- https://www.gasnow.org/api/v3/gas/price
@@ -14,6 +17,24 @@ Current onchain list:
- [chainlink](https://etherscan.io/address/0x169e633a2d1e6c10dd91238ba11c4a708dfef37c#readContract)
### Binance Smart Chain
Current offchain list:
- https://bscgas.info/
### xDAI Chain
Current offchain list:
- https://www.xdaichain.com/for-developers/developer-resources/gas-price-oracle
### Polygon (Matic) Network
Current offchain list:
- https://gasstation-mainnet.matic.network/
## Installation
`npm i gas-price-oracle`
@@ -30,8 +51,15 @@ const { GasPriceOracle } = require('gas-price-oracle');
```js
const options = {
chainId: 1,
defaultRpc: 'https://api.mycryptoapi.com/eth',
timeout: 10000,
defaultFallbackGasPrices: {
instant: 28,
fast: 22,
standard: 17,
low: 11,
},
};
const oracle = new GasPriceOracle(options);
// optional fallbackGasPrices

View File

@@ -1,6 +1,6 @@
{
"name": "gas-price-oracle",
"version": "0.3.0",
"version": "0.3.5",
"description": "Gas Price Oracle library for Ethereum dApps.",
"main": "lib/index.js",
"homepage": "https://github.com/peppersec/gas-price-oracle",

View File

@@ -3,7 +3,7 @@ import { OffChainOracle, OffChainOracles, OnChainOracles } from '../types';
const bscgas: OffChainOracle = {
name: 'bscgas',
url: 'https://bscgas.info/gas',
instantPropertyName: 'imediate',
instantPropertyName: 'instant',
fastPropertyName: 'fast',
standardPropertyName: 'standard',
lowPropertyName: 'slow',

View File

@@ -1,25 +1,20 @@
import { NetworkConfig } from '../types';
import {
onChainOracles as mainnetOnchainOracles,
offChainOracles as mainnetOffChainOracles,
} from './mainnet';
import {
onChainOracles as binanceOnchainOracles,
offChainOracles as binanceOffchainOracles,
} from './binance';
import mainnetOracles from './mainnet';
import binanceOracles from './binance';
import xdaiOracles from './xdai';
import polygonOracles from './polygon';
export enum ChainId {
MAINNET = 1,
BINANCE = 56,
XDAI = 100,
POLYGON = 137,
}
export const networks: NetworkConfig = {
[ChainId.MAINNET]: {
onChainOracles: mainnetOnchainOracles,
offChainOracles: mainnetOffChainOracles,
},
[ChainId.BINANCE]: {
onChainOracles: binanceOnchainOracles,
offChainOracles: binanceOffchainOracles,
},
[ChainId.MAINNET]: mainnetOracles,
[ChainId.BINANCE]: binanceOracles,
[ChainId.XDAI]: xdaiOracles,
[ChainId.POLYGON]: polygonOracles,
};

View File

@@ -11,17 +11,6 @@ const ethgasstation: OffChainOracle = {
additionalDataProperty: null,
};
const zoltu: OffChainOracle = {
name: 'zoltu',
url: 'https://gas-oracle.zoltu.io/',
instantPropertyName: 'percentile_99',
fastPropertyName: 'percentile_90',
standardPropertyName: 'percentile_60',
lowPropertyName: 'percentile_30',
denominator: 1,
additionalDataProperty: null,
};
const etherchain: OffChainOracle = {
name: 'etherchain',
url: 'https://www.etherchain.org/api/gasPriceOracle',
@@ -79,7 +68,6 @@ export const offChainOracles: OffChainOracles = {
gasNow,
poa,
etherchain,
zoltu,
};
export const onChainOracles: OnChainOracles = {

23
src/config/polygon.ts Normal file
View File

@@ -0,0 +1,23 @@
import { OffChainOracle, OffChainOracles, OnChainOracles } from '../types';
const maticGasStation: OffChainOracle = {
name: 'maticGasStation',
url: 'https://gasstation-mainnet.matic.network',
instantPropertyName: 'fastest',
fastPropertyName: 'fast',
standardPropertyName: 'standard',
lowPropertyName: 'safeLow',
denominator: 1,
additionalDataProperty: null,
};
export const offChainOracles: OffChainOracles = {
maticGasStation,
};
export const onChainOracles: OnChainOracles = {};
export default {
offChainOracles,
onChainOracles,
};

23
src/config/xdai.ts Normal file
View File

@@ -0,0 +1,23 @@
import { OffChainOracle, OffChainOracles, OnChainOracles } from '../types';
const blockscout: OffChainOracle = {
name: 'blockscout',
url: 'https://blockscout.com/xdai/mainnet/api/v1/gas-price-oracle',
instantPropertyName: 'fast',
fastPropertyName: 'average',
standardPropertyName: 'slow',
lowPropertyName: 'slow',
denominator: 1,
additionalDataProperty: null,
};
export const offChainOracles: OffChainOracles = {
blockscout,
};
export const onChainOracles: OnChainOracles = {};
export default {
offChainOracles,
onChainOracles,
};

View File

@@ -12,6 +12,7 @@ import {
} from './types';
import BigNumber from 'bignumber.js';
const defaultFastGas = 22;
export class GasPriceOracle {
lastGasPrice: GasPrice;
offChainOracles: OffChainOracles;
@@ -20,6 +21,12 @@ export class GasPriceOracle {
chainId: ChainId.MAINNET,
defaultRpc: 'https://api.mycryptoapi.com/eth',
timeout: 10000,
defaultFallbackGasPrices: {
instant: defaultFastGas * 1.3,
fast: defaultFastGas,
standard: defaultFastGas * 0.85,
low: defaultFastGas * 0.5,
},
};
constructor(options?: Options) {
@@ -27,10 +34,14 @@ export class GasPriceOracle {
Object.assign(this.configuration, options);
}
const { offChainOracles, onChainOracles } = networks[this.configuration.chainId];
const network = networks[this.configuration.chainId];
if (network) {
const { offChainOracles, onChainOracles } = network;
this.offChainOracles = { ...offChainOracles };
this.onChainOracles = { ...onChainOracles };
}
}
async askOracle(oracle: OffChainOracle): Promise<GasPrice> {
const {
@@ -175,14 +186,7 @@ export class GasPriceOracle {
}
async gasPrices(fallbackGasPrices?: GasPrice, median = true): Promise<GasPrice> {
const defaultFastGas = 22;
const defaultFallbackGasPrices = {
instant: defaultFastGas * 1.3,
fast: defaultFastGas,
standard: defaultFastGas * 0.85,
low: defaultFastGas * 0.5,
};
this.lastGasPrice = this.lastGasPrice || fallbackGasPrices || defaultFallbackGasPrices;
this.lastGasPrice = this.lastGasPrice || fallbackGasPrices || this.configuration.defaultFallbackGasPrices;
try {
this.lastGasPrice = median
? await this.fetchMedianGasPriceOffChain()

View File

@@ -21,6 +21,11 @@ export type OnChainOracle = {
export type OnChainOracles = { [key: string]: OnChainOracle };
export type AllOracles = {
offChainOracles: OffChainOracles;
onChainOracles: OnChainOracles;
};
export type GasPrice = {
[key in GasPriceKey]: number;
};
@@ -31,13 +36,11 @@ export type Options = {
chainId?: number;
defaultRpc?: string;
timeout?: number;
defaultFallbackGasPrices?: GasPrice;
};
export type Config = Required<Options>;
export type NetworkConfig = {
[key in number]: {
offChainOracles: OffChainOracles;
onChainOracles: OnChainOracles;
};
[key in number]: AllOracles;
};

View File

@@ -207,9 +207,6 @@ describe('fetchMedianGasPriceOffChain', function () {
describe('askOracle', function () {
it('all oracles should answer', async function () {
// TODO: remove after fix POA
delete offChainOracles['poa'];
for (const o of Object.values(offChainOracles) as Array<OffChainOracle>) {
try {
const gas: GasPrice = await oracle.askOracle(o);