https://github.com/021-projects/ethereum-oracles
Getting blockchain statistics from Ethereum oracles
https://github.com/021-projects/ethereum-oracles
Last synced: 3 months ago
JSON representation
Getting blockchain statistics from Ethereum oracles
- Host: GitHub
- URL: https://github.com/021-projects/ethereum-oracles
- Owner: 021-projects
- Created: 2022-03-27T17:21:12.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2022-03-27T17:21:34.000Z (over 4 years ago)
- Last Synced: 2025-01-17T12:48:24.393Z (over 1 year ago)
- Language: PHP
- Size: 7.81 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Ethereum oracles library
A library of convenient interfaces for receiving statistics data from different ethereum oracles.
### Ethereum Mainnet oracles
**Offchain**
| Class | Source | Features |
|--------------------------------------------|------------------------------------------------------------|-----------------------------|
| O21\EthereumOracles\OffChain\Blockscout | https://blockscout.com/eth/mainnet/api/v1/gas-price-oracle | No |
| O21\EthereumOracles\OffChain\Etherchain | https://etherchain.org/api/gasnow | Instant |
| O21\EthereumOracles\OffChain\EthGasStation | https://ethgasstation.info/json/ethgasAPI.json | Instant, BlockNumber, Speed |
| O21\EthereumOracles\OffChain\MaticNetwork | https://gasstation-mainnet.matic.network/ | Instant, BlockNumber |
### Usage
#### Get stats from Etherchain
```php
use O21\EthereumOracles\OffChain\Etherchain;
# ...
/** \O21\EthereumOracles\FeeStats\Stats $stats */
$stats = (new Etherchain)->getStats();
```
By default ``getStats()`` method fetching all provider supported features, but you can define only specific features like this
```php
use O21\EthereumOracles\OffChain\EthGasStation;
use O21\EthereumOracles\FeeStats\Feature;
# ...
(new EthGasStation)->getStats(Feature::Speed, Feature::BlockNumber);
```
##### Stats interface
| Property | Description | Required feature |
|-------------|------------------------------------------------------------|------------------|
| slow | Fee for low priority (>= 30 minutes) transaction in Gwei | No |
| standard | Fee for medium priority (< 5 minutes) transaction in Gwei | No |
| high | Fee for high priority transaction (< 2 minutes) in Gwei | No |
| instant | Fee for instant transaction (< 30 seconds) in Gwei | Instant | | |
| speed | Smallest value of (gasUsed / gaslimit) from last 10 blocks | Speed |
| blockNumber | Latest block number | BlockNumber |