Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/pinax-network/substreams-erc20-supply
ERC-20 Token Supply Substreams
https://github.com/pinax-network/substreams-erc20-supply
erc20 ethereum streamingfast substreams
Last synced: about 2 months ago
JSON representation
ERC-20 Token Supply Substreams
- Host: GitHub
- URL: https://github.com/pinax-network/substreams-erc20-supply
- Owner: pinax-network
- License: mit
- Created: 2023-09-19T20:00:55.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2024-08-09T15:21:08.000Z (5 months ago)
- Last Synced: 2024-08-09T16:44:18.484Z (5 months ago)
- Topics: erc20, ethereum, streamingfast, substreams
- Language: Rust
- Homepage:
- Size: 573 KB
- Stars: 0
- Watchers: 7
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# `ERC-20` Token Supply [Substreams](https://substreams.streamingfast.io)
[](https://github.com/pinax-network/substreams-erc20-supply/actions/workflows/test.yml)
> Extends [ERC-20 Balance Changes](https://github.com/streamingfast/substreams-erc20-balance-changes) with token supply.
### First block containing ERC20 Transfers
| Chain | Block number |
| ------- | ------------ |
| ETH | 913 198 |
| Polygon | 2764 |
| BSC | 64 253 |
## Quickstart
```
$ gh repo clone pinax-network/substreams-erc20-supply
$ cd substreams-erc20-supply
$ make
$ make gui
```
## Releases `.spkg`
- https://github.com/pinax-network/substreams-erc20-supply/releases
## References
- [Ethereum Docs: ERC-20 Token Standard](https://ethereum.org/en/developers/docs/standards/tokens/erc-20/)
- [EIPS: ERC-20 Token Standard ](https://eips.ethereum.org/EIPS/eip-20)
- [OpenZeppelin implementation](https://github.com/OpenZeppelin/openzeppelin-contracts/blob/9b3710465583284b8c4c5d2245749246bb2e0094/contracts/token/ERC20/ERC20.sol)
- [ConsenSys implementation](https://github.com/ConsenSys/Tokens/blob/fdf687c69d998266a95f15216b1955a4965a0a6d/contracts/eip20/EIP20.sol)
## Map Outputs
### `map_token_supply`
```json
{
"items": [
{
"address": "dac17f958d2ee523a2206206994597c13d831ec7",
"supply": "39025187376288180"
},
{
"address": "c944e90c64b2c07662a292be6244bdf05cda44a7",
"supply": "10759041473295613153705888512"
},
...
]
}
```
### `graph_out`
```json
{
"entityChanges": [
{
"entity": "TotalSupply",
"id": "c944e90c64b2c07662a292be6244bdf05cda44a7",
"ordinal": "0",
"operation": "OPERATION_CREATE",
"fields": [
{
"name": "address",
"newValue": { "string": "c944e90c64b2c07662a292be6244bdf05cda44a7" }
},
{
"name": "block",
"newValue": { "bigint": "18242188" }
},
{
"name": "supply",
"newValue": { "bigint": "10759041473295613153705888512" }
},
{
"name": "timestamp",
"newValue": { "bigint": "1696000391" }
}
]
},
...
]
}
```
```mermaid
graph TD;
map_token_supply[map: map_token_supply];
balance_changes:map_valid_balance_changes --> map_token_supply;
store_supply[store: store_supply];
map_token_supply --> store_supply;
db_out[map: db_out];
sf.substreams.v1.Clock[source: sf.substreams.v1.Clock] --> db_out;
store_supply -- deltas --> db_out;
```
### Modules
```yaml
Package name: erc20_supply
Version: v0.1.8
Doc: ERC-20 Token Supply
Modules:
----
Name: map_token_supply
Initial block: 0
Kind: map
Input: map: balance_changes:map_valid_balance_changes
Output Type: proto:erc20.supply.types.v1.TotalSupplies
Hash: 6d670090dd23e7197e90a091d714f981e6adbe15
Doc: Extracts ERC20 token total supply
Name: store_supply
Initial block: 0
Kind: store
Input: map: map_token_supply
Value Type: string
Update Policy: set
Hash: 94b9609de07ce414aca6bf261483ccce68a6b592
Doc: Stores last supply seen
Name: db_out
Initial block: 0
Kind: map
Input: source: sf.substreams.v1.Clock
Input: store: store_supply
Output Type: proto:sf.substreams.sink.database.v1.DatabaseChanges
Hash: c9f1a2ca2d47ed888839e6d3d2e9fb12006bdef6
```