Contributor Modifications Guide

Adding/Modifying Events in Contracts

Ethereum Contracts

• When we make upgrades/updates to our contracts, we may choose to add a new event, update the name of the event or the name of one of the fields.

Subgraph

• If we are interested in indexing these new events and returning this data, we need to add do the following to add this information to the subgraph:

1. Add the new entity to the schema.graphql file in packages/subgraph.
2. Create a mapping handler function in the appropriate folder (src/mappings/[contract]).
3. Add the new entity under dataSources.mapping.entities to the appropriate dataSource in dataSources in both subgraph.template.yaml and test-subgraph.template.yaml.
4. Add the new/modified event under dataSources.mapping.eventHandlers and its handler (name of handler function). Look at the subgraph.template.yaml as an example.

Note: if you want to run tests/subgraph locally after an event has been modified (contract ABI changes, so you need to rebuild contracts), look at tasks/testenv-ctl.sh for further guidance on the necessary steps required to do so.

SDK-Core

1. Now, we need to update the sdk-core/src/subgraph/schema.graphql file. We can do this by running yarn generate-graphql-schema inside the packages/sdk-core directory if a subgraph with the new schema has been deployed to the feature-matic endpoint. If it hasn't been deployed, we must spin up and deploy a local instance of the subgraph and use the local endpoint with this command: npx get-graphql-schema http://localhost:8000/subgraphs/name/superfluid-test > src/subgraph/schema.graphql.
2. Next, we need to add an interface for the new events into sdk-core/src/events.ts or a new entity into the specific entity file. We add the new event under AccountEvents or OtherEvents depending on whether the event is specifically related to an account or not.
3. Then, we need to add the event to the query in sdk-core/src/subgraph/queries/getAllEvents.graphql. This will ensure that the getAllEvents.ts file gets generated properly. We also need to add a query for the new event, add this query to the larger events query and a query fragment in: events.graphql.
4. Lastly, we must add a case for our new event in sdk-core/src/mapGetAllEventsQueryEvents.ts (for event entities, for HOL entities, each entity will have its own file and mapping function). We specify the name of the entity for the case: case "EntityName": and return a typeGuard object passing in the desired event as the generic and we map each of the properties accordingly.