tycho_arbitrum_uniswap_v3

kayibal

v0.2.0/49 downloads/Repository

Package ref

tycho-arbitrum-uniswap-v3@v0.2.0

Download .spkg

Run package

CLI

Run map_pool_events from the command line.

substreams run tycho-arbitrum-uniswap-v3@v0.2.0 map_pool_events

Authenticate by running substreams auth or directly on thegraph.market (see docs).

Modules

Execution graph

5 modules

mapMain

map_pool_events

from #37418321

Output

tycho.evm.v1.BlockChanges

Inputs

sf.ethereum.type.v2.Block map_pools_created store_pools store_pools_balances

map

map_balance_changes

from #37418321

Output

tycho.evm.uniswap.v3.BalanceDeltas

Inputs

sf.ethereum.type.v2.Block store_pools

map

map_pools_created

from #37418321

Output

tycho.evm.v1.BlockChanges

Inputs

paramssf.ethereum.type.v2.Block

store

store_pools

from #37418321

Store value

proto:uniswap.v3.Pool

Update policy

set_if_not_exists

Inputs

map_pools_created

store

store_pools_balances

from #37418321

Store value

bigint

Update policy

add

Inputs

map_balance_changes

Protobuf

tycho.evm.v1

BlockChangesmain

tycho.evm.v1.BlockChanges

A set of transaction changes within a single block. This message must be the output of your substreams module.

Blockblock = 1

The block for which these changes are collectively computed.

TransactionChanges[]changes = 2

The set of transaction changes observed in the specified block.

AccountBalanceChange

tycho.evm.v1.AccountBalanceChange

A struct for following the token balance changes for a contract.

bytestoken = 1

The address of the ERC20 token whose balance changed.

bytesbalance = 2

The new balance of the token. Note: it must be a big endian encoded int.

Attribute

tycho.evm.v1.Attribute

A custom struct representing an arbitrary attribute of a protocol component. This is mainly used by the native integration to track the necessary information about the protocol.

stringname = 1

The name of the attribute.

bytesvalue = 2

The value of the attribute.

ChangeTypechange = 3

The type of change the attribute underwent.

BalanceChange

tycho.evm.v1.BalanceChange

A struct for following the changes of Total Value Locked (TVL) of a protocol component. Note that if a ProtocolComponent contains multiple contracts, the TVL is tracked for the component as a whole. E.g. for UniswapV2 pair WETH/USDC, this tracks the USDC and WETH balance of the pair contract.

bytestoken = 1

The address of the ERC20 token whose balance changed.

bytesbalance = 2

The new balance of the token. Note: it must be a big endian encoded int.

bytescomponent_id = 3

The id of the component whose TVL is tracked. Note: This MUST be utf8 encoded. If the protocol component includes multiple contracts, the balance change must be aggregated to reflect how much tokens can be traded.

Block

tycho.evm.v1.Block

A struct describing a block.

byteshash = 1

The blocks hash.

bytesparent_hash = 2

The parent blocks hash.

uint64number = 3

The block number.

uint64ts = 4

The block timestamp.

BlockEntityChanges

tycho.evm.v1.BlockEntityChanges

A set of transaction changes within a single block.

Blockblock = 1

The block for which these changes are collectively computed.

TransactionEntityChanges[]changes = 2

The set of transaction changes observed in the specified block.

ContractChange

tycho.evm.v1.ContractChange

Changes made to a single contract's state.

bytesaddress = 1

The contract's address

bytesbalance = 2

The new balance of the contract, empty bytes indicates no change.

bytescode = 3

The new code of the contract, empty bytes indicates no change.

ContractSlot[]slots = 4

The changes to this contract's slots, empty sequence indicates no change.

ChangeTypechange = 5

Whether this is an update, a creation or a deletion.

AccountBalanceChange[]token_balances = 6

The new ERC20 balances of the contract.

ContractSlot

tycho.evm.v1.ContractSlot

A key value entry into contract storage.

bytesslot = 2

A contract's storage slot.

bytesvalue = 3

The new value for this storage slot.

EntityChanges

tycho.evm.v1.EntityChanges

A component is a set of attributes that are associated with a custom entity.

stringcomponent_id = 1

A unique identifier of the entity within the protocol.

Attribute[]attributes = 2

The set of attributes that are associated with the entity.

ProtocolComponent

tycho.evm.v1.ProtocolComponent

A struct describing a part of the protocol. Note: For example this can be a UniswapV2 pair, that tracks the two ERC20 tokens used by the pair, the component would represent a single contract. In case of VM integration, such component would not need any attributes, because all the relevant info would be tracked via storage slots and balance changes. It can also be a wrapping contract, like WETH, that has a constant price, but it allows swapping tokens. This is why the name ProtocolComponent is used instead of "Pool" or "Pair".

stringid = 1

A unique identifier for the component within the protocol. Can be e.g. a stringified address or a string describing the trading pair.

bytes[]tokens = 2

Addresses of the ERC20 tokens used by the component.

bytes[]contracts = 3

Addresses of the contracts used by the component. Usually it is a single contract, but some protocols use multiple contracts.

Attribute[]static_att = 4

Static attributes of the component. These attributes MUST be immutable. If it can ever change, it should be given as an EntityChanges for this component id. The inner ChangeType of the attribute has to match the ChangeType of the ProtocolComponent.

ChangeTypechange = 5

Type of change the component underwent.

ProtocolTypeprotocol_type = 6

/ Represents the functionality of the component.

ProtocolType

tycho.evm.v1.ProtocolType

stringname = 1

FinancialTypefinancial_type = 2

Attribute[]attribute_schema = 3

ImplementationTypeimplementation_type = 4

Transaction

tycho.evm.v1.Transaction

A struct describing a transaction.

byteshash = 1

The transaction hash.

bytesfrom = 2

The sender of the transaction.

bytesto = 3

The receiver of the transaction.

uint64index = 4

The transactions index within the block. TODO: should this be uint32? to match the type from the native substream type?

TransactionChanges

tycho.evm.v1.TransactionChanges

A set of changes aggregated by transaction.

Transactiontx = 1

The transaction instance that results in the changes.

ContractChange[]contract_changes = 2

Contains the changes induced by the above transaction, aggregated on a per-contract basis. Contains the contract changes induced by the above transaction, usually for tracking VM components.

EntityChanges[]entity_changes = 3

Contains the entity changes induced by the above transaction. Usually for tracking native components or used for VM extensions (plugins).

ProtocolComponent[]component_changes = 4

An array of newly added components.

BalanceChange[]balance_changes = 5

An array of balance changes to components.

TransactionEntityChanges

tycho.evm.v1.TransactionEntityChanges

Transactiontx = 1

EntityChanges[]entity_changes = 2

ProtocolComponent[]component_changes = 3

An array of newly added components.

BalanceChange[]balance_changes = 4

An array of balance changes to components.

ChangeTypeenum

tycho.evm.v1.ChangeType

CHANGE_TYPE_UNSPECIFIED = 0

CHANGE_TYPE_UPDATE = 1

CHANGE_TYPE_CREATION = 2

CHANGE_TYPE_DELETION = 3

FinancialTypeenum

tycho.evm.v1.FinancialType

SWAP = 0

LEND = 1

LEVERAGE = 2

PSM = 3

ImplementationTypeenum

tycho.evm.v1.ImplementationType

VM = 0

CUSTOM = 1

Show 3 dependencies

uniswap.v3

BalanceDelta

uniswap.v3.BalanceDelta

A change to a pool's balance.

bytestoken_address = 1

The address of the ERC20 token.

bytesamount = 2

The delta of the token.

boolsign = 3

The sign of the delta, true for positive, false for negative.

bytespool_address = 4

The address of the pool whose balance changed.

uint64ordinal = 5

Used to determine the order of the balance changes. Necessary for the balance store.

BalanceDeltas

uniswap.v3.BalanceDeltas

A group of BalanceDelta

BalanceDelta[]deltas = 1

Pool

uniswap.v3.Pool

bytesaddress = 1

bytestoken0 = 2

bytestoken1 = 3

bytescreated_tx_hash = 4