@apibara/indexer 0.2.3 → 0.2.4

package/dist/starknet/felt.d.ts

@@ -1,3 +1,11 @@
 import { z } from "zod";
 export type FieldElement = `0x${string}`;
 export declare const FieldElement: z.ZodEffects<z.ZodString, `0x${string}`, string>;
+/**
+ * Compute the selector from a function or event name.
+ *
+ * The return value is padded to 32 bytes.
+ * @param name the function/event name
+ * @returns a field element
+ */
+export declare function getSelector(name: string): FieldElement;

package/dist/starknet/felt.js

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { hash } from "starknet";
 export const FieldElement = z.string().transform((value, ctx) => {
     const regex = /^0x[0-9a-fA-F]{1,64}$/;
     if (!regex.test(value)) {
@@ -7,6 +8,18 @@ export const FieldElement = z.string().transform((value, ctx) => {
             message: `FieldElement must be a hex string with a 0x prefix, got ${value}`,
         });
     }
-    return value;
+    const bn = BigInt(value);
+    const padded = bn.toString(16).padStart(64, "0");
+    return `0x${padded}`;
 });
+/**
+ * Compute the selector from a function or event name.
+ *
+ * The return value is padded to 32 bytes.
+ * @param name the function/event name
+ * @returns a field element
+ */
+export function getSelector(name) {
+    return FieldElement.parse(hash.getSelectorFromName(name));
+}
 //# sourceMappingURL=felt.js.map

package/dist/starknet/felt.js.map

@@ -1 +1 @@
-{"version":3,"file":"felt.js","sourceRoot":"","sources":["../../src/starknet/felt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;IAC9D,MAAM,KAAK,GAAG,uBAAuB,CAAC;IAEtC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;QACtB,GAAG,CAAC,QAAQ,CAAC;YACX,IAAI,EAAE,CAAC,CAAC,YAAY,CAAC,MAAM;YAC3B,OAAO,EAAE,2DAA2D,KAAK,EAAE;SAC5E,CAAC,CAAC;KACJ;IAED,OAAO,KAAqB,CAAC;AAC/B,CAAC,CAAC,CAAC"}
+{"version":3,"file":"felt.js","sourceRoot":"","sources":["../../src/starknet/felt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAIhC,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;IAC9D,MAAM,KAAK,GAAG,uBAAuB,CAAC;IAEtC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;QACtB,GAAG,CAAC,QAAQ,CAAC;YACX,IAAI,EAAE,CAAC,CAAC,YAAY,CAAC,MAAM;YAC3B,OAAO,EAAE,2DAA2D,KAAK,EAAE;SAC5E,CAAC,CAAC;KACJ;IAED,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACzB,MAAM,MAAM,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IACjD,OAAO,KAAK,MAAM,EAAkB,CAAC;AACvC,CAAC,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC;AAC5D,CAAC"}

package/dist/starknet/felt.test.js

@@ -2,10 +2,12 @@ import { describe, expect, test } from "vitest";
 import { FieldElement } from "./felt";
 describe("FieldElement", () => {
     test("parse address", () => {
-        FieldElement.parse("0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7");
+        const output = FieldElement.parse("0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7");
+        expect(output).toEqual("0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7");
     });
     test("parse value", () => {
-        FieldElement.parse("0x1");
+        const output = FieldElement.parse("0x1");
+        expect(output).toEqual("0x0000000000000000000000000000000000000000000000000000000000000001");
     });
     test("parse invalid value", () => {
         expect(() => FieldElement.parse("0x")).toThrowError();

package/dist/starknet/felt.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"felt.test.js","sourceRoot":"","sources":["../../src/starknet/felt.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE;QACzB,YAAY,CAAC,KAAK,CAChB,oEAAoE,CACrE,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,aAAa,EAAE,GAAG,EAAE;QACvB,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC/B,MAAM,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC;IACxD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"felt.test.js","sourceRoot":"","sources":["../../src/starknet/felt.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE;QACzB,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAC/B,oEAAoE,CACrE,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CACpB,oEAAoE,CACrE,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,aAAa,EAAE,GAAG,EAAE;QACvB,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CACpB,oEAAoE,CACrE,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC/B,MAAM,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC;IACxD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/starknet/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./filter";
 export * from "./block";
+export { FieldElement, getSelector } from "./felt";
 export { Contract } from "./parser";
 import { Filter } from "./filter";
 /** Starknet network type and data filter. */

package/dist/starknet/index.js

@@ -1,4 +1,5 @@
 export * from "./filter";
 export * from "./block";
+export { FieldElement, getSelector } from "./felt";
 export { Contract } from "./parser";
 //# sourceMappingURL=index.js.map

package/dist/starknet/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/starknet/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/starknet/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC"}

package/dist/starknet/parser.d.ts

@@ -1,12 +1,16 @@
+import { type Abi } from "starknet";
 import { FieldElement } from "./felt";
 import { EventFilter } from "./filter";
-import { type Abi } from "starknet";
 /** Build a stream filter from a contract ABI. */
 export declare class Contract {
-    readonly contractAddress: FieldElement;
-    readonly contractAbi: Abi;
+    readonly address: FieldElement;
+    readonly abi: Abi;
+    private selectorToEvent;
     constructor(contractAddress: FieldElement, contractAbi: Abi);
     private _findEvent;
+    private _populateSelectorToEvent;
     /** Filter events based on their name from the contract's ABI. */
     eventFilter(name: string, opts?: Pick<EventFilter, "includeReceipt" | "includeTransaction" | "includeReverted">): EventFilter;
+    /** Returns the event name based on its selector. */
+    lookupEventFromSelector(selector: FieldElement): string | undefined;
 }

package/dist/starknet/parser.js

@@ -1,18 +1,30 @@
-import { hash } from "starknet";
+import { getSelector } from "./felt";
 /** Build a stream filter from a contract ABI. */
 export class Contract {
     // Read-only properties for the contract's address and its ABI.
-    contractAddress;
-    contractAbi;
+    address;
+    abi;
+    selectorToEvent;
     constructor(contractAddress, contractAbi) {
-        this.contractAddress = contractAddress;
-        this.contractAbi = contractAbi;
+        this.address = contractAddress;
+        this.abi = contractAbi;
+        this.selectorToEvent = {};
+        this._populateSelectorToEvent();
     }
     _findEvent(name) {
         // Find the event in the ABI matching the provided name.
-        const event = this.contractAbi.find((item) => item.type === "event" && item.name === name);
+        const event = this.abi.find((item) => item.type === "event" && item.name === name);
         return event;
     }
+    _populateSelectorToEvent() {
+        this.selectorToEvent = {};
+        for (const event of this.abi) {
+            if (event.type !== "event") {
+                return;
+            }
+            this.selectorToEvent[getSelector(event.name)] = event.name;
+        }
+    }
     /** Filter events based on their name from the contract's ABI. */
     eventFilter(name, opts = {}) {
         const event = this._findEvent(name);
@@ -22,12 +34,16 @@ export class Contract {
         }
         // Return the found event.
         return {
-            fromAddress: this.contractAddress,
-            keys: [hash.getSelectorFromName(event.name)],
+            fromAddress: this.address,
+            keys: [getSelector(event.name)],
             includeTransaction: opts.includeTransaction ?? false,
             includeReceipt: opts.includeReceipt ?? false,
             includeReverted: opts.includeReverted ?? false,
         };
     }
+    /** Returns the event name based on its selector. */
+    lookupEventFromSelector(selector) {
+        return this.selectorToEvent[selector];
+    }
 }
 //# sourceMappingURL=parser.js.map

package/dist/starknet/parser.js.map

@@ -1 +1 @@
-{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../src/starknet/parser.ts"],"names":[],"mappings":"AAGA,OAAO,EAAsB,IAAI,EAAE,MAAM,UAAU,CAAC;AAEpD,iDAAiD;AACjD,MAAM,OAAO,QAAQ;IACnB,+DAA+D;IACtD,eAAe,CAAe;IAC9B,WAAW,CAAM;IAE1B,YAAY,eAA6B,EAAE,WAAgB;QACzD,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAEO,UAAU,CAAC,IAAY;QAC7B,wDAAwD;QACxD,MAAM,KAAK,GAAyB,IAAI,CAAC,WAAW,CAAC,IAAI,CACvD,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CACtD,CAAC;QAEF,OAAO,KAAK,CAAC;IACf,CAAC;IAED,iEAAiE;IACjE,WAAW,CACT,IAAY,EACZ,OAGI,EAAE;QAEN,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAEpC,sDAAsD;QACtD,IAAI,CAAC,KAAK,EAAE;YACV,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,4BAA4B,CAAC,CAAC;SAC5D;QAED,0BAA0B;QAC1B,OAAO;YACL,WAAW,EAAE,IAAI,CAAC,eAAe;YACjC,IAAI,EAAE,CAAC,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAkB,CAAC;YAC7D,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,IAAI,KAAK;YACpD,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,KAAK;YAC5C,eAAe,EAAE,IAAI,CAAC,eAAe,IAAI,KAAK;SAC/C,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../src/starknet/parser.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,WAAW,EAAE,MAAM,QAAQ,CAAC;AAGnD,iDAAiD;AACjD,MAAM,OAAO,QAAQ;IACnB,+DAA+D;IACtD,OAAO,CAAe;IACtB,GAAG,CAAM;IAEV,eAAe,CAA+B;IAEtD,YAAY,eAA6B,EAAE,WAAgB;QACzD,IAAI,CAAC,OAAO,GAAG,eAAe,CAAC;QAC/B,IAAI,CAAC,GAAG,GAAG,WAAW,CAAC;QACvB,IAAI,CAAC,eAAe,GAAG,EAAE,CAAC;QAC1B,IAAI,CAAC,wBAAwB,EAAE,CAAC;IAClC,CAAC;IAEO,UAAU,CAAC,IAAY;QAC7B,wDAAwD;QACxD,MAAM,KAAK,GAAyB,IAAI,CAAC,GAAG,CAAC,IAAI,CAC/C,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CACtD,CAAC;QAEF,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,wBAAwB;QAC9B,IAAI,CAAC,eAAe,GAAG,EAAE,CAAC;QAC1B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE;YAC5B,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE;gBAC1B,OAAO;aACR;YACD,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC;SAC5D;IACH,CAAC;IAED,iEAAiE;IACjE,WAAW,CACT,IAAY,EACZ,OAGI,EAAE;QAEN,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAEpC,sDAAsD;QACtD,IAAI,CAAC,KAAK,EAAE;YACV,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,4BAA4B,CAAC,CAAC;SAC5D;QAED,0BAA0B;QAC1B,OAAO;YACL,WAAW,EAAE,IAAI,CAAC,OAAO;YACzB,IAAI,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC/B,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,IAAI,KAAK;YACpD,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,KAAK;YAC5C,eAAe,EAAE,IAAI,CAAC,eAAe,IAAI,KAAK;SAC/C,CAAC;IACJ,CAAC;IAED,oDAAoD;IACpD,uBAAuB,CAAC,QAAsB;QAC5C,OAAO,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC;CACF"}

package/dist/starknet/parser.test.js

@@ -1,14 +1,21 @@
 import { Contract } from "./parser";
 import { describe, expect, it } from "vitest";
-describe("Contract class tests", () => {
+describe("Contract", () => {
     const mockContractAddress = "0x0";
-    const mockEventAbi = {
-        type: "event",
-        name: "MockEvent",
-        kind: "struct",
-        members: [{ name: "param1", type: "felt", kind: "key" }],
-    };
-    const mockContractAbi = [mockEventAbi];
+    const mockContractAbi = [
+        {
+            type: "event",
+            name: "MockEvent",
+            kind: "struct",
+            members: [{ name: "param1", type: "felt", kind: "key" }],
+        },
+        {
+            type: "event",
+            name: "AnotherEvent",
+            kind: "struct",
+            members: [{ name: "param1", type: "felt", kind: "key" }],
+        },
+    ];
     it("should create an EventFilter for a valid event name", () => {
         const contract = new Contract(mockContractAddress, mockContractAbi);
         const filter = contract.eventFilter("MockEvent");
@@ -22,6 +29,17 @@ describe("Contract class tests", () => {
         expect(filter).toBeDefined();
         expect(filter.includeReceipt).toBeTruthy();
     });
+    it("can lookup an event name by its selector", () => {
+        const contract = new Contract(mockContractAddress, mockContractAbi);
+        const filter = contract.eventFilter("AnotherEvent");
+        const eventName = contract.lookupEventFromSelector(filter.keys?.[0] ?? "0x00");
+        expect(eventName).toEqual("AnotherEvent");
+    });
+    it("returns undefined if no event matches", () => {
+        const contract = new Contract(mockContractAddress, mockContractAbi);
+        const eventName = contract.lookupEventFromSelector("0x1234567890123456789012345678901234567890123456789012345678901234");
+        expect(eventName).toBeUndefined();
+    });
     it("should throw an error for an invalid event name", () => {
         const contract = new Contract(mockContractAddress, mockContractAbi);
         expect(() => {

package/dist/starknet/parser.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"parser.test.js","sourceRoot":"","sources":["../../src/starknet/parser.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAI9C,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,MAAM,mBAAmB,GAAiB,KAAK,CAAC;IAChD,MAAM,YAAY,GAAa;QAC7B,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;KACzD,CAAC;IAEF,MAAM,eAAe,GAAG,CAAC,YAAY,CAAC,CAAC;IAEvC,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,mBAAmB,EAAE,eAAe,CAAC,CAAC;QACpE,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;QAEjD,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QACrD,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,SAAS,EAAE,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,mBAAmB,EAAE,eAAe,CAAC,CAAC;QACpE,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;QAE3E,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,UAAU,EAAE,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,mBAAmB,EAAE,eAAe,CAAC,CAAC;QAEpE,MAAM,CAAC,GAAG,EAAE;YACV,QAAQ,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC,OAAO,CAAC,8CAA8C,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"parser.test.js","sourceRoot":"","sources":["../../src/starknet/parser.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAI9C,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;IACxB,MAAM,mBAAmB,GAAiB,KAAK,CAAC;IAEhD,MAAM,eAAe,GAAG;QACtB;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;SACzD;QACD;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,cAAc;YACpB,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;SACzD;KACF,CAAC;IAEF,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,mBAAmB,EAAE,eAAe,CAAC,CAAC;QACpE,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;QAEjD,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QACrD,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,SAAS,EAAE,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,mBAAmB,EAAE,eAAe,CAAC,CAAC;QACpE,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;QAE3E,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,UAAU,EAAE,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,mBAAmB,EAAE,eAAe,CAAC,CAAC;QACpE,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;QACpD,MAAM,SAAS,GAAG,QAAQ,CAAC,uBAAuB,CAChD,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,MAAM,CAC3B,CAAC;QAEF,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,mBAAmB,EAAE,eAAe,CAAC,CAAC;QACpE,MAAM,SAAS,GAAG,QAAQ,CAAC,uBAAuB,CAChD,oEAAoE,CACrE,CAAC;QAEF,MAAM,CAAC,SAAS,CAAC,CAAC,aAAa,EAAE,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,mBAAmB,EAAE,eAAe,CAAC,CAAC;QAEpE,MAAM,CAAC,GAAG,EAAE;YACV,QAAQ,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC,OAAO,CAAC,8CAA8C,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apibara/indexer",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "type": "module",
   "exports": {
     ".": {

package/src/starknet/felt.test.ts

@@ -4,13 +4,19 @@ import { FieldElement } from "./felt";
 
 describe("FieldElement", () => {
   test("parse address", () => {
-    FieldElement.parse(
+    const output = FieldElement.parse(
+      "0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7",
+    );
+    expect(output).toEqual(
       "0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7",
     );
   });
 
   test("parse value", () => {
-    FieldElement.parse("0x1");
+    const output = FieldElement.parse("0x1");
+    expect(output).toEqual(
+      "0x0000000000000000000000000000000000000000000000000000000000000001",
+    );
   });
 
   test("parse invalid value", () => {

package/src/starknet/felt.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { hash } from "starknet";
 
 export type FieldElement = `0x${string}`;
 
@@ -12,5 +13,18 @@ export const FieldElement = z.string().transform((value, ctx) => {
     });
   }
 
-  return value as FieldElement;
+  const bn = BigInt(value);
+  const padded = bn.toString(16).padStart(64, "0");
+  return `0x${padded}` as FieldElement;
 });
+
+/**
+ * Compute the selector from a function or event name.
+ *
+ * The return value is padded to 32 bytes.
+ * @param name the function/event name
+ * @returns a field element
+ */
+export function getSelector(name: string): FieldElement {
+  return FieldElement.parse(hash.getSelectorFromName(name));
+}

package/src/starknet/index.ts

@@ -1,5 +1,6 @@
 export * from "./filter";
 export * from "./block";
+export { FieldElement, getSelector } from "./felt";
 export { Contract } from "./parser";
 
 import { Filter } from "./filter";

package/src/starknet/parser.test.ts

@@ -3,16 +3,23 @@ import { describe, expect, it } from "vitest";
 import { FieldElement } from "./felt";
 import { EventAbi } from "starknet";
 
-describe("Contract class tests", () => {
+describe("Contract", () => {
   const mockContractAddress: FieldElement = "0x0";
-  const mockEventAbi: EventAbi = {
-    type: "event",
-    name: "MockEvent",
-    kind: "struct",
-    members: [{ name: "param1", type: "felt", kind: "key" }],
-  };
 
-  const mockContractAbi = [mockEventAbi];
+  const mockContractAbi = [
+    {
+      type: "event",
+      name: "MockEvent",
+      kind: "struct",
+      members: [{ name: "param1", type: "felt", kind: "key" }],
+    },
+    {
+      type: "event",
+      name: "AnotherEvent",
+      kind: "struct",
+      members: [{ name: "param1", type: "felt", kind: "key" }],
+    },
+  ];
 
   it("should create an EventFilter for a valid event name", () => {
     const contract = new Contract(mockContractAddress, mockContractAbi);
@@ -31,6 +38,25 @@ describe("Contract class tests", () => {
     expect(filter.includeReceipt).toBeTruthy();
   });
 
+  it("can lookup an event name by its selector", () => {
+    const contract = new Contract(mockContractAddress, mockContractAbi);
+    const filter = contract.eventFilter("AnotherEvent");
+    const eventName = contract.lookupEventFromSelector(
+      filter.keys?.[0] ?? "0x00",
+    );
+
+    expect(eventName).toEqual("AnotherEvent");
+  });
+
+  it("returns undefined if no event matches", () => {
+    const contract = new Contract(mockContractAddress, mockContractAbi);
+    const eventName = contract.lookupEventFromSelector(
+      "0x1234567890123456789012345678901234567890123456789012345678901234",
+    );
+
+    expect(eventName).toBeUndefined();
+  });
+
   it("should throw an error for an invalid event name", () => {
     const contract = new Contract(mockContractAddress, mockContractAbi);
 

package/src/starknet/parser.ts

@@ -1,28 +1,42 @@
-import { FieldElement } from "./felt";
-import { EventFilter } from "./filter";
+import { type Abi, EventAbi } from "starknet";
 
-import { type Abi, EventAbi, hash } from "starknet";
+import { FieldElement, getSelector } from "./felt";
+import { EventFilter } from "./filter";
 
 /** Build a stream filter from a contract ABI. */
 export class Contract {
   // Read-only properties for the contract's address and its ABI.
-  readonly contractAddress: FieldElement;
-  readonly contractAbi: Abi;
+  readonly address: FieldElement;
+  readonly abi: Abi;
+
+  private selectorToEvent: Record<FieldElement, string>;
 
   constructor(contractAddress: FieldElement, contractAbi: Abi) {
-    this.contractAddress = contractAddress;
-    this.contractAbi = contractAbi;
+    this.address = contractAddress;
+    this.abi = contractAbi;
+    this.selectorToEvent = {};
+    this._populateSelectorToEvent();
   }
 
   private _findEvent(name: string): EventAbi | undefined {
     // Find the event in the ABI matching the provided name.
-    const event: EventAbi | undefined = this.contractAbi.find(
+    const event: EventAbi | undefined = this.abi.find(
       (item) => item.type === "event" && item.name === name,
     );
 
     return event;
   }
 
+  private _populateSelectorToEvent(): void {
+    this.selectorToEvent = {};
+    for (const event of this.abi) {
+      if (event.type !== "event") {
+        return;
+      }
+      this.selectorToEvent[getSelector(event.name)] = event.name;
+    }
+  }
+
   /** Filter events based on their name from the contract's ABI. */
   eventFilter(
     name: string,
@@ -40,11 +54,16 @@ export class Contract {
 
     // Return the found event.
     return {
-      fromAddress: this.contractAddress,
-      keys: [hash.getSelectorFromName(event.name) as `0x${string}`],
+      fromAddress: this.address,
+      keys: [getSelector(event.name)],
       includeTransaction: opts.includeTransaction ?? false,
       includeReceipt: opts.includeReceipt ?? false,
       includeReverted: opts.includeReverted ?? false,
     };
   }
+
+  /** Returns the event name based on its selector. */
+  lookupEventFromSelector(selector: FieldElement): string | undefined {
+    return this.selectorToEvent[selector];
+  }
 }