@apibara/starknet 2.1.0-beta.3 → 2.1.0-beta.31

package/dist/parser.cjs

@@ -37,7 +37,7 @@ function parseU256(data, offset) {
 function parseAsHex(data, offset) {
   assertInBounds(data, offset);
   return {
-    out: String(data[offset]),
+    out: data[offset],
     offset: offset + 1
   };
 }
@@ -53,7 +53,7 @@ function parseFelt252(data, offset) {
     offset: offset + 1
   };
 }
-function parseEmpty(data, offset) {
+function parseEmpty(_data, offset) {
   return { out: null, offset };
 }
 function parseArray(type) {
@@ -84,16 +84,17 @@ function parseStruct(parsers) {
   const sortedParsers = Object.entries(parsers).sort(
     (a, b) => a[1].index - b[1].index
   );
-  return (data, startingOffset) => {
+  const parser = (data, startingOffset) => {
     let offset = startingOffset;
     const out = {};
-    for (const [key, { parser }] of sortedParsers) {
-      const { out: value, offset: newOffset } = parser(data, offset);
+    for (const [key, { parser: parser2 }] of sortedParsers) {
+      const { out: value, offset: newOffset } = parser2(data, offset);
       out[key] = value;
       offset = newOffset;
     }
     return { out, offset };
   };
+  return parser;
 }
 function parseTuple(...parsers) {
   return (data, startingOffset) => {
@@ -131,3 +132,4 @@ exports.parseU32 = parseU32;
 exports.parseU64 = parseU64;
 exports.parseU8 = parseU8;
 exports.parseUsize = parseUsize;
+//# sourceMappingURL=parser.cjs.map

package/dist/parser.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.cjs","sources":["../src/parser.ts"],"sourcesContent":["/*\n * Calldata combinatorial parsers.\n *\n * Based on the Ekubo's event parser.\n *\n * MIT License\n *\n * Copyright (c) 2023 Ekubo, Inc.\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\nimport type { FieldElement } from \"./common\";\n\nexport type Parser<TOut> = (\n  data: readonly FieldElement[],\n  offset: number,\n) => { out: TOut; offset: number };\n\nexport class ParseError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"ParseError\";\n  }\n}\n\n// Primitive types.\n\nfunction assertInBounds(data: readonly FieldElement[], offset: number) {\n  if (offset >= data.length) {\n    throw new ParseError(\n      `Offset out of bounds. Data length ${data.length}, offset ${offset}`,\n    );\n  }\n}\n\nexport function parseBool(data: readonly FieldElement[], offset: number) {\n  assertInBounds(data, offset);\n  return { out: BigInt(data[offset]) > 0n, offset: offset + 1 };\n}\n\nexport function parseAsBigInt(data: readonly FieldElement[], offset: number) {\n  assertInBounds(data, offset);\n  return { out: BigInt(data[offset]), offset: offset + 1 };\n}\n\nexport const parseU8 = parseAsBigInt;\nexport const parseU16 = parseAsBigInt;\nexport const parseU32 = parseAsBigInt;\nexport const parseU64 = parseAsBigInt;\nexport const parseU128 = parseAsBigInt;\nexport const parseUsize = parseAsBigInt;\n\nexport function parseU256(data: readonly FieldElement[], offset: number) {\n  assertInBounds(data, offset + 1);\n  return {\n    out: BigInt(data[offset]) + (BigInt(data[offset + 1]) << 128n),\n    offset: offset + 2,\n  };\n}\n\nexport function parseAsHex(data: readonly FieldElement[], offset: number) {\n  assertInBounds(data, offset);\n  return {\n    out: data[offset],\n    offset: offset + 1,\n  };\n}\n\nexport const parseContractAddress = parseAsHex;\nexport const parseEthAddress = parseAsHex;\nexport const parseStorageAddress = parseAsHex;\nexport const parseClassHash = parseAsHex;\nexport const parseBytes31 = parseAsHex;\n\nexport function parseFelt252(data: readonly FieldElement[], offset: number) {\n  assertInBounds(data, offset);\n  return {\n    out: BigInt(data[offset]),\n    offset: offset + 1,\n  };\n}\n\nexport function parseEmpty(_data: readonly FieldElement[], offset: number) {\n  return { out: null, offset };\n}\n\n// Higher-level types.\n\nexport function parseArray<T>(type: Parser<T>): Parser<T[]> {\n  return (data: readonly FieldElement[], startingOffset: number) => {\n    let offset = startingOffset;\n    const length = BigInt(data[offset]);\n\n    offset++;\n\n    const out: T[] = [];\n    for (let i = 0; i < length; i++) {\n      const { out: item, offset: newOffset } = type(data, offset);\n      out.push(item);\n      offset = newOffset;\n    }\n\n    return { out, offset };\n  };\n}\n\nexport const parseSpan = parseArray;\n\nexport function parseOption<T>(type: Parser<T>) {\n  return (data: readonly FieldElement[], offset: number) => {\n    const hasValue = BigInt(data[offset]) === 1n;\n    if (hasValue) {\n      return type(data, offset + 1);\n    }\n    return { out: null, offset: offset + 1 };\n  };\n}\n\nexport function parseStruct<T extends Record<string, unknown>>(\n  parsers: { [K in keyof T]: { index: number; parser: Parser<T[K]> } },\n): Parser<{ [K in keyof T]: T[K] }> {\n  const sortedParsers = Object.entries(parsers).sort(\n    (a, b) => a[1].index - b[1].index,\n  );\n  const parser = (data: readonly FieldElement[], startingOffset: number) => {\n    let offset = startingOffset;\n    const out: Record<string, unknown> = {};\n    for (const [key, { parser }] of sortedParsers) {\n      const { out: value, offset: newOffset } = parser(data, offset);\n      out[key] = value;\n      offset = newOffset;\n    }\n    return { out, offset };\n  };\n  return parser as Parser<{ [K in keyof T]: T[K] }>;\n}\n\nexport function parseTuple<T extends Parser<unknown>[]>(\n  ...parsers: T\n): Parser<UnwrapParsers<T>> {\n  return (data: readonly FieldElement[], startingOffset: number) => {\n    let offset = startingOffset;\n    const out = [];\n    for (const parser of parsers) {\n      const { out: value, offset: newOffset } = parser(data, offset);\n      out.push(value);\n      offset = newOffset;\n    }\n    return { out, offset } as { out: UnwrapParsers<T>; offset: number };\n  };\n}\n\ntype UnwrapParsers<TP> = {\n  [Index in keyof TP]: TP[Index] extends Parser<infer U> ? U : never;\n};\n"],"names":["parser"],"mappings":";;AAkCO,MAAM,mBAAmB,KAAM,CAAA;AAAA,EACpC,YAAY,OAAiB,EAAA;AAC3B,IAAA,KAAA,CAAM,OAAO,CAAA,CAAA;AACb,IAAA,IAAA,CAAK,IAAO,GAAA,YAAA,CAAA;AAAA,GACd;AACF,CAAA;AAIA,SAAS,cAAA,CAAe,MAA+B,MAAgB,EAAA;AACrE,EAAI,IAAA,MAAA,IAAU,KAAK,MAAQ,EAAA;AACzB,IAAA,MAAM,IAAI,UAAA;AAAA,MACR,CAAqC,kCAAA,EAAA,IAAA,CAAK,MAAM,CAAA,SAAA,EAAY,MAAM,CAAA,CAAA;AAAA,KACpE,CAAA;AAAA,GACF;AACF,CAAA;AAEgB,SAAA,SAAA,CAAU,MAA+B,MAAgB,EAAA;AACvE,EAAA,cAAA,CAAe,MAAM,MAAM,CAAA,CAAA;AAC3B,EAAO,OAAA,EAAE,GAAK,EAAA,MAAA,CAAO,IAAK,CAAA,MAAM,CAAC,CAAI,GAAA,EAAA,EAAI,MAAQ,EAAA,MAAA,GAAS,CAAE,EAAA,CAAA;AAC9D,CAAA;AAEgB,SAAA,aAAA,CAAc,MAA+B,MAAgB,EAAA;AAC3E,EAAA,cAAA,CAAe,MAAM,MAAM,CAAA,CAAA;AAC3B,EAAO,OAAA,EAAE,KAAK,MAAO,CAAA,IAAA,CAAK,MAAM,CAAC,CAAA,EAAG,MAAQ,EAAA,MAAA,GAAS,CAAE,EAAA,CAAA;AACzD,CAAA;AAEO,MAAM,OAAU,GAAA,cAAA;AAChB,MAAM,QAAW,GAAA,cAAA;AACjB,MAAM,QAAW,GAAA,cAAA;AACjB,MAAM,QAAW,GAAA,cAAA;AACjB,MAAM,SAAY,GAAA,cAAA;AAClB,MAAM,UAAa,GAAA,cAAA;AAEV,SAAA,SAAA,CAAU,MAA+B,MAAgB,EAAA;AACvE,EAAe,cAAA,CAAA,IAAA,EAAM,SAAS,CAAC,CAAA,CAAA;AAC/B,EAAO,OAAA;AAAA,IACL,GAAA,EAAK,MAAO,CAAA,IAAA,CAAK,MAAM,CAAC,CAAK,IAAA,MAAA,CAAO,IAAK,CAAA,MAAA,GAAS,CAAC,CAAC,CAAK,IAAA,IAAA,CAAA;AAAA,IACzD,QAAQ,MAAS,GAAA,CAAA;AAAA,GACnB,CAAA;AACF,CAAA;AAEgB,SAAA,UAAA,CAAW,MAA+B,MAAgB,EAAA;AACxE,EAAA,cAAA,CAAe,MAAM,MAAM,CAAA,CAAA;AAC3B,EAAO,OAAA;AAAA,IACL,GAAA,EAAK,KAAK,MAAM,CAAA;AAAA,IAChB,QAAQ,MAAS,GAAA,CAAA;AAAA,GACnB,CAAA;AACF,CAAA;AAEO,MAAM,oBAAuB,GAAA,WAAA;AAC7B,MAAM,eAAkB,GAAA,WAAA;AACxB,MAAM,mBAAsB,GAAA,WAAA;AAC5B,MAAM,cAAiB,GAAA,WAAA;AACvB,MAAM,YAAe,GAAA,WAAA;AAEZ,SAAA,YAAA,CAAa,MAA+B,MAAgB,EAAA;AAC1E,EAAA,cAAA,CAAe,MAAM,MAAM,CAAA,CAAA;AAC3B,EAAO,OAAA;AAAA,IACL,GAAK,EAAA,MAAA,CAAO,IAAK,CAAA,MAAM,CAAC,CAAA;AAAA,IACxB,QAAQ,MAAS,GAAA,CAAA;AAAA,GACnB,CAAA;AACF,CAAA;AAEgB,SAAA,UAAA,CAAW,OAAgC,MAAgB,EAAA;AACzE,EAAO,OAAA,EAAE,GAAK,EAAA,IAAA,EAAM,MAAO,EAAA,CAAA;AAC7B,CAAA;AAIO,SAAS,WAAc,IAA8B,EAAA;AAC1D,EAAO,OAAA,CAAC,MAA+B,cAA2B,KAAA;AAChE,IAAA,IAAI,MAAS,GAAA,cAAA,CAAA;AACb,IAAA,MAAM,MAAS,GAAA,MAAA,CAAO,IAAK,CAAA,MAAM,CAAC,CAAA,CAAA;AAElC,IAAA,MAAA,EAAA,CAAA;AAEA,IAAA,MAAM,MAAW,EAAC,CAAA;AAClB,IAAA,KAAA,IAAS,CAAI,GAAA,CAAA,EAAG,CAAI,GAAA,MAAA,EAAQ,CAAK,EAAA,EAAA;AAC/B,MAAM,MAAA,EAAE,KAAK,IAAM,EAAA,MAAA,EAAQ,WAAc,GAAA,IAAA,CAAK,MAAM,MAAM,CAAA,CAAA;AAC1D,MAAA,GAAA,CAAI,KAAK,IAAI,CAAA,CAAA;AACb,MAAS,MAAA,GAAA,SAAA,CAAA;AAAA,KACX;AAEA,IAAO,OAAA,EAAE,KAAK,MAAO,EAAA,CAAA;AAAA,GACvB,CAAA;AACF,CAAA;AAEO,MAAM,SAAY,GAAA,WAAA;AAElB,SAAS,YAAe,IAAiB,EAAA;AAC9C,EAAO,OAAA,CAAC,MAA+B,MAAmB,KAAA;AACxD,IAAA,MAAM,QAAW,GAAA,MAAA,CAAO,IAAK,CAAA,MAAM,CAAC,CAAM,KAAA,EAAA,CAAA;AAC1C,IAAA,IAAI,QAAU,EAAA;AACZ,MAAO,OAAA,IAAA,CAAK,IAAM,EAAA,MAAA,GAAS,CAAC,CAAA,CAAA;AAAA,KAC9B;AACA,IAAA,OAAO,EAAE,GAAA,EAAK,IAAM,EAAA,MAAA,EAAQ,SAAS,CAAE,EAAA,CAAA;AAAA,GACzC,CAAA;AACF,CAAA;AAEO,SAAS,YACd,OACkC,EAAA;AAClC,EAAA,MAAM,aAAgB,GAAA,MAAA,CAAO,OAAQ,CAAA,OAAO,CAAE,CAAA,IAAA;AAAA,IAC5C,CAAC,GAAG,CAAM,KAAA,CAAA,CAAE,CAAC,CAAE,CAAA,KAAA,GAAQ,CAAE,CAAA,CAAC,CAAE,CAAA,KAAA;AAAA,GAC9B,CAAA;AACA,EAAM,MAAA,MAAA,GAAS,CAAC,IAAA,EAA+B,cAA2B,KAAA;AACxE,IAAA,IAAI,MAAS,GAAA,cAAA,CAAA;AACb,IAAA,MAAM,MAA+B,EAAC,CAAA;AACtC,IAAA,KAAA,MAAW,CAAC,GAAK,EAAA,EAAE,QAAAA,OAAO,EAAC,KAAK,aAAe,EAAA;AAC7C,MAAM,MAAA,EAAE,KAAK,KAAO,EAAA,MAAA,EAAQ,WAAcA,GAAAA,OAAAA,CAAO,MAAM,MAAM,CAAA,CAAA;AAC7D,MAAA,GAAA,CAAI,GAAG,CAAI,GAAA,KAAA,CAAA;AACX,MAAS,MAAA,GAAA,SAAA,CAAA;AAAA,KACX;AACA,IAAO,OAAA,EAAE,KAAK,MAAO,EAAA,CAAA;AAAA,GACvB,CAAA;AACA,EAAO,OAAA,MAAA,CAAA;AACT,CAAA;AAEO,SAAS,cACX,OACuB,EAAA;AAC1B,EAAO,OAAA,CAAC,MAA+B,cAA2B,KAAA;AAChE,IAAA,IAAI,MAAS,GAAA,cAAA,CAAA;AACb,IAAA,MAAM,MAAM,EAAC,CAAA;AACb,IAAA,KAAA,MAAW,UAAU,OAAS,EAAA;AAC5B,MAAM,MAAA,EAAE,KAAK,KAAO,EAAA,MAAA,EAAQ,WAAc,GAAA,MAAA,CAAO,MAAM,MAAM,CAAA,CAAA;AAC7D,MAAA,GAAA,CAAI,KAAK,KAAK,CAAA,CAAA;AACd,MAAS,MAAA,GAAA,SAAA,CAAA;AAAA,KACX;AACA,IAAO,OAAA,EAAE,KAAK,MAAO,EAAA,CAAA;AAAA,GACvB,CAAA;AACF;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/parser.d.cts

@@ -1,6 +1,6 @@
-import { F as FieldElement } from './shared/starknet.2b19268a.cjs';
-import '@effect/schema/AST';
-import '@effect/schema';
+import { a as FieldElement } from './shared/starknet.e649ecb1.cjs';
+import '@apibara/protocol/codec';
+import 'protobufjs/minimal.js';
 
 type Parser<TOut> = (data: readonly FieldElement[], offset: number) => {
     out: TOut;
@@ -28,7 +28,7 @@ declare function parseU256(data: readonly FieldElement[], offset: number): {
     offset: number;
 };
 declare function parseAsHex(data: readonly FieldElement[], offset: number): {
-    out: string;
+    out: `0x${string}`;
     offset: number;
 };
 declare const parseContractAddress: typeof parseAsHex;
@@ -40,7 +40,7 @@ declare function parseFelt252(data: readonly FieldElement[], offset: number): {
     out: bigint;
     offset: number;
 };
-declare function parseEmpty(data: readonly FieldElement[], offset: number): {
+declare function parseEmpty(_data: readonly FieldElement[], offset: number): {
     out: null;
     offset: number;
 };
@@ -53,17 +53,14 @@ declare function parseOption<T>(type: Parser<T>): (data: readonly FieldElement[]
     out: null;
     offset: number;
 };
-declare function parseStruct<T extends {
-    [key: string]: unknown;
-}>(parsers: {
+declare function parseStruct<T extends Record<string, unknown>>(parsers: {
     [K in keyof T]: {
         index: number;
         parser: Parser<T[K]>;
     };
-}): (data: readonly FieldElement[], startingOffset: number) => {
-    out: Record<string, unknown>;
-    offset: number;
-};
+}): Parser<{
+    [K in keyof T]: T[K];
+}>;
 declare function parseTuple<T extends Parser<unknown>[]>(...parsers: T): Parser<UnwrapParsers<T>>;
 type UnwrapParsers<TP> = {
     [Index in keyof TP]: TP[Index] extends Parser<infer U> ? U : never;

package/dist/parser.d.mts

@@ -1,6 +1,6 @@
-import { F as FieldElement } from './shared/starknet.2b19268a.mjs';
-import '@effect/schema/AST';
-import '@effect/schema';
+import { a as FieldElement } from './shared/starknet.e649ecb1.mjs';
+import '@apibara/protocol/codec';
+import 'protobufjs/minimal.js';
 
 type Parser<TOut> = (data: readonly FieldElement[], offset: number) => {
     out: TOut;
@@ -28,7 +28,7 @@ declare function parseU256(data: readonly FieldElement[], offset: number): {
     offset: number;
 };
 declare function parseAsHex(data: readonly FieldElement[], offset: number): {
-    out: string;
+    out: `0x${string}`;
     offset: number;
 };
 declare const parseContractAddress: typeof parseAsHex;
@@ -40,7 +40,7 @@ declare function parseFelt252(data: readonly FieldElement[], offset: number): {
     out: bigint;
     offset: number;
 };
-declare function parseEmpty(data: readonly FieldElement[], offset: number): {
+declare function parseEmpty(_data: readonly FieldElement[], offset: number): {
     out: null;
     offset: number;
 };
@@ -53,17 +53,14 @@ declare function parseOption<T>(type: Parser<T>): (data: readonly FieldElement[]
     out: null;
     offset: number;
 };
-declare function parseStruct<T extends {
-    [key: string]: unknown;
-}>(parsers: {
+declare function parseStruct<T extends Record<string, unknown>>(parsers: {
     [K in keyof T]: {
         index: number;
         parser: Parser<T[K]>;
     };
-}): (data: readonly FieldElement[], startingOffset: number) => {
-    out: Record<string, unknown>;
-    offset: number;
-};
+}): Parser<{
+    [K in keyof T]: T[K];
+}>;
 declare function parseTuple<T extends Parser<unknown>[]>(...parsers: T): Parser<UnwrapParsers<T>>;
 type UnwrapParsers<TP> = {
     [Index in keyof TP]: TP[Index] extends Parser<infer U> ? U : never;

package/dist/parser.d.ts

@@ -1,6 +1,6 @@
-import { F as FieldElement } from './shared/starknet.2b19268a.js';
-import '@effect/schema/AST';
-import '@effect/schema';
+import { a as FieldElement } from './shared/starknet.e649ecb1.js';
+import '@apibara/protocol/codec';
+import 'protobufjs/minimal.js';
 
 type Parser<TOut> = (data: readonly FieldElement[], offset: number) => {
     out: TOut;
@@ -28,7 +28,7 @@ declare function parseU256(data: readonly FieldElement[], offset: number): {
     offset: number;
 };
 declare function parseAsHex(data: readonly FieldElement[], offset: number): {
-    out: string;
+    out: `0x${string}`;
     offset: number;
 };
 declare const parseContractAddress: typeof parseAsHex;
@@ -40,7 +40,7 @@ declare function parseFelt252(data: readonly FieldElement[], offset: number): {
     out: bigint;
     offset: number;
 };
-declare function parseEmpty(data: readonly FieldElement[], offset: number): {
+declare function parseEmpty(_data: readonly FieldElement[], offset: number): {
     out: null;
     offset: number;
 };
@@ -53,17 +53,14 @@ declare function parseOption<T>(type: Parser<T>): (data: readonly FieldElement[]
     out: null;
     offset: number;
 };
-declare function parseStruct<T extends {
-    [key: string]: unknown;
-}>(parsers: {
+declare function parseStruct<T extends Record<string, unknown>>(parsers: {
     [K in keyof T]: {
         index: number;
         parser: Parser<T[K]>;
     };
-}): (data: readonly FieldElement[], startingOffset: number) => {
-    out: Record<string, unknown>;
-    offset: number;
-};
+}): Parser<{
+    [K in keyof T]: T[K];
+}>;
 declare function parseTuple<T extends Parser<unknown>[]>(...parsers: T): Parser<UnwrapParsers<T>>;
 type UnwrapParsers<TP> = {
     [Index in keyof TP]: TP[Index] extends Parser<infer U> ? U : never;

package/dist/parser.mjs

@@ -35,7 +35,7 @@ function parseU256(data, offset) {
 function parseAsHex(data, offset) {
   assertInBounds(data, offset);
   return {
-    out: String(data[offset]),
+    out: data[offset],
     offset: offset + 1
   };
 }
@@ -51,7 +51,7 @@ function parseFelt252(data, offset) {
     offset: offset + 1
   };
 }
-function parseEmpty(data, offset) {
+function parseEmpty(_data, offset) {
   return { out: null, offset };
 }
 function parseArray(type) {
@@ -82,16 +82,17 @@ function parseStruct(parsers) {
   const sortedParsers = Object.entries(parsers).sort(
     (a, b) => a[1].index - b[1].index
   );
-  return (data, startingOffset) => {
+  const parser = (data, startingOffset) => {
     let offset = startingOffset;
     const out = {};
-    for (const [key, { parser }] of sortedParsers) {
-      const { out: value, offset: newOffset } = parser(data, offset);
+    for (const [key, { parser: parser2 }] of sortedParsers) {
+      const { out: value, offset: newOffset } = parser2(data, offset);
       out[key] = value;
       offset = newOffset;
     }
     return { out, offset };
   };
+  return parser;
 }
 function parseTuple(...parsers) {
   return (data, startingOffset) => {
@@ -107,3 +108,4 @@ function parseTuple(...parsers) {
 }
 
 export { ParseError, parseArray, parseAsBigInt, parseAsHex, parseBool, parseBytes31, parseClassHash, parseContractAddress, parseEmpty, parseEthAddress, parseFelt252, parseOption, parseSpan, parseStorageAddress, parseStruct, parseTuple, parseU128, parseU16, parseU256, parseU32, parseU64, parseU8, parseUsize };
+//# sourceMappingURL=parser.mjs.map

package/dist/parser.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.mjs","sources":["../src/parser.ts"],"sourcesContent":["/*\n * Calldata combinatorial parsers.\n *\n * Based on the Ekubo's event parser.\n *\n * MIT License\n *\n * Copyright (c) 2023 Ekubo, Inc.\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\nimport type { FieldElement } from \"./common\";\n\nexport type Parser<TOut> = (\n  data: readonly FieldElement[],\n  offset: number,\n) => { out: TOut; offset: number };\n\nexport class ParseError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"ParseError\";\n  }\n}\n\n// Primitive types.\n\nfunction assertInBounds(data: readonly FieldElement[], offset: number) {\n  if (offset >= data.length) {\n    throw new ParseError(\n      `Offset out of bounds. Data length ${data.length}, offset ${offset}`,\n    );\n  }\n}\n\nexport function parseBool(data: readonly FieldElement[], offset: number) {\n  assertInBounds(data, offset);\n  return { out: BigInt(data[offset]) > 0n, offset: offset + 1 };\n}\n\nexport function parseAsBigInt(data: readonly FieldElement[], offset: number) {\n  assertInBounds(data, offset);\n  return { out: BigInt(data[offset]), offset: offset + 1 };\n}\n\nexport const parseU8 = parseAsBigInt;\nexport const parseU16 = parseAsBigInt;\nexport const parseU32 = parseAsBigInt;\nexport const parseU64 = parseAsBigInt;\nexport const parseU128 = parseAsBigInt;\nexport const parseUsize = parseAsBigInt;\n\nexport function parseU256(data: readonly FieldElement[], offset: number) {\n  assertInBounds(data, offset + 1);\n  return {\n    out: BigInt(data[offset]) + (BigInt(data[offset + 1]) << 128n),\n    offset: offset + 2,\n  };\n}\n\nexport function parseAsHex(data: readonly FieldElement[], offset: number) {\n  assertInBounds(data, offset);\n  return {\n    out: data[offset],\n    offset: offset + 1,\n  };\n}\n\nexport const parseContractAddress = parseAsHex;\nexport const parseEthAddress = parseAsHex;\nexport const parseStorageAddress = parseAsHex;\nexport const parseClassHash = parseAsHex;\nexport const parseBytes31 = parseAsHex;\n\nexport function parseFelt252(data: readonly FieldElement[], offset: number) {\n  assertInBounds(data, offset);\n  return {\n    out: BigInt(data[offset]),\n    offset: offset + 1,\n  };\n}\n\nexport function parseEmpty(_data: readonly FieldElement[], offset: number) {\n  return { out: null, offset };\n}\n\n// Higher-level types.\n\nexport function parseArray<T>(type: Parser<T>): Parser<T[]> {\n  return (data: readonly FieldElement[], startingOffset: number) => {\n    let offset = startingOffset;\n    const length = BigInt(data[offset]);\n\n    offset++;\n\n    const out: T[] = [];\n    for (let i = 0; i < length; i++) {\n      const { out: item, offset: newOffset } = type(data, offset);\n      out.push(item);\n      offset = newOffset;\n    }\n\n    return { out, offset };\n  };\n}\n\nexport const parseSpan = parseArray;\n\nexport function parseOption<T>(type: Parser<T>) {\n  return (data: readonly FieldElement[], offset: number) => {\n    const hasValue = BigInt(data[offset]) === 1n;\n    if (hasValue) {\n      return type(data, offset + 1);\n    }\n    return { out: null, offset: offset + 1 };\n  };\n}\n\nexport function parseStruct<T extends Record<string, unknown>>(\n  parsers: { [K in keyof T]: { index: number; parser: Parser<T[K]> } },\n): Parser<{ [K in keyof T]: T[K] }> {\n  const sortedParsers = Object.entries(parsers).sort(\n    (a, b) => a[1].index - b[1].index,\n  );\n  const parser = (data: readonly FieldElement[], startingOffset: number) => {\n    let offset = startingOffset;\n    const out: Record<string, unknown> = {};\n    for (const [key, { parser }] of sortedParsers) {\n      const { out: value, offset: newOffset } = parser(data, offset);\n      out[key] = value;\n      offset = newOffset;\n    }\n    return { out, offset };\n  };\n  return parser as Parser<{ [K in keyof T]: T[K] }>;\n}\n\nexport function parseTuple<T extends Parser<unknown>[]>(\n  ...parsers: T\n): Parser<UnwrapParsers<T>> {\n  return (data: readonly FieldElement[], startingOffset: number) => {\n    let offset = startingOffset;\n    const out = [];\n    for (const parser of parsers) {\n      const { out: value, offset: newOffset } = parser(data, offset);\n      out.push(value);\n      offset = newOffset;\n    }\n    return { out, offset } as { out: UnwrapParsers<T>; offset: number };\n  };\n}\n\ntype UnwrapParsers<TP> = {\n  [Index in keyof TP]: TP[Index] extends Parser<infer U> ? U : never;\n};\n"],"names":["parser"],"mappings":"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"}

package/dist/shared/starknet.e649ecb1.d.cts

@@ -0,0 +1,40 @@
+import { Codec, CodecType } from '@apibara/protocol/codec';
+import _m0 from 'protobufjs/minimal.js';
+
+declare const protobufPackage = "starknet.v2";
+/** A field element. */
+interface FieldElement$1 {
+    readonly x0?: bigint | undefined;
+    readonly x1?: bigint | undefined;
+    readonly x2?: bigint | undefined;
+    readonly x3?: bigint | undefined;
+}
+declare const FieldElement$1: {
+    encode(message: FieldElement$1, writer?: _m0.Writer): _m0.Writer;
+    decode(input: _m0.Reader | Uint8Array, length?: number): FieldElement$1;
+    fromJSON(object: any): FieldElement$1;
+    toJSON(message: FieldElement$1): unknown;
+    create(base?: DeepPartial<FieldElement$1>): FieldElement$1;
+    fromPartial(object: DeepPartial<FieldElement$1>): FieldElement$1;
+};
+type Builtin = Date | Function | Uint8Array | string | number | boolean | bigint | undefined;
+type DeepPartial<T> = T extends Builtin ? T : T extends globalThis.Array<infer U> ? globalThis.Array<DeepPartial<U>> : T extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : T extends {
+    readonly $case: string;
+} ? {
+    [K in keyof Omit<T, "$case">]?: DeepPartial<T[K]>;
+} & {
+    readonly $case: T["$case"];
+} : T extends {} ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : Partial<T>;
+
+type common_DeepPartial<T> = DeepPartial<T>;
+declare const common_protobufPackage: typeof protobufPackage;
+declare namespace common {
+  export { type common_DeepPartial as DeepPartial, FieldElement$1 as FieldElement, common_protobufPackage as protobufPackage };
+}
+
+declare const FieldElement: Codec<`0x${string}`, FieldElement$1>;
+type FieldElement = CodecType<typeof FieldElement>;
+
+export { FieldElement$1 as F, FieldElement as a, common as c };

package/dist/shared/starknet.e649ecb1.d.mts

@@ -0,0 +1,40 @@
+import { Codec, CodecType } from '@apibara/protocol/codec';
+import _m0 from 'protobufjs/minimal.js';
+
+declare const protobufPackage = "starknet.v2";
+/** A field element. */
+interface FieldElement$1 {
+    readonly x0?: bigint | undefined;
+    readonly x1?: bigint | undefined;
+    readonly x2?: bigint | undefined;
+    readonly x3?: bigint | undefined;
+}
+declare const FieldElement$1: {
+    encode(message: FieldElement$1, writer?: _m0.Writer): _m0.Writer;
+    decode(input: _m0.Reader | Uint8Array, length?: number): FieldElement$1;
+    fromJSON(object: any): FieldElement$1;
+    toJSON(message: FieldElement$1): unknown;
+    create(base?: DeepPartial<FieldElement$1>): FieldElement$1;
+    fromPartial(object: DeepPartial<FieldElement$1>): FieldElement$1;
+};
+type Builtin = Date | Function | Uint8Array | string | number | boolean | bigint | undefined;
+type DeepPartial<T> = T extends Builtin ? T : T extends globalThis.Array<infer U> ? globalThis.Array<DeepPartial<U>> : T extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : T extends {
+    readonly $case: string;
+} ? {
+    [K in keyof Omit<T, "$case">]?: DeepPartial<T[K]>;
+} & {
+    readonly $case: T["$case"];
+} : T extends {} ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : Partial<T>;
+
+type common_DeepPartial<T> = DeepPartial<T>;
+declare const common_protobufPackage: typeof protobufPackage;
+declare namespace common {
+  export { type common_DeepPartial as DeepPartial, FieldElement$1 as FieldElement, common_protobufPackage as protobufPackage };
+}
+
+declare const FieldElement: Codec<`0x${string}`, FieldElement$1>;
+type FieldElement = CodecType<typeof FieldElement>;
+
+export { FieldElement$1 as F, FieldElement as a, common as c };

package/dist/shared/starknet.e649ecb1.d.ts

@@ -0,0 +1,40 @@
+import { Codec, CodecType } from '@apibara/protocol/codec';
+import _m0 from 'protobufjs/minimal.js';
+
+declare const protobufPackage = "starknet.v2";
+/** A field element. */
+interface FieldElement$1 {
+    readonly x0?: bigint | undefined;
+    readonly x1?: bigint | undefined;
+    readonly x2?: bigint | undefined;
+    readonly x3?: bigint | undefined;
+}
+declare const FieldElement$1: {
+    encode(message: FieldElement$1, writer?: _m0.Writer): _m0.Writer;
+    decode(input: _m0.Reader | Uint8Array, length?: number): FieldElement$1;
+    fromJSON(object: any): FieldElement$1;
+    toJSON(message: FieldElement$1): unknown;
+    create(base?: DeepPartial<FieldElement$1>): FieldElement$1;
+    fromPartial(object: DeepPartial<FieldElement$1>): FieldElement$1;
+};
+type Builtin = Date | Function | Uint8Array | string | number | boolean | bigint | undefined;
+type DeepPartial<T> = T extends Builtin ? T : T extends globalThis.Array<infer U> ? globalThis.Array<DeepPartial<U>> : T extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : T extends {
+    readonly $case: string;
+} ? {
+    [K in keyof Omit<T, "$case">]?: DeepPartial<T[K]>;
+} & {
+    readonly $case: T["$case"];
+} : T extends {} ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : Partial<T>;
+
+type common_DeepPartial<T> = DeepPartial<T>;
+declare const common_protobufPackage: typeof protobufPackage;
+declare namespace common {
+  export { type common_DeepPartial as DeepPartial, FieldElement$1 as FieldElement, common_protobufPackage as protobufPackage };
+}
+
+declare const FieldElement: Codec<`0x${string}`, FieldElement$1>;
+type FieldElement = CodecType<typeof FieldElement>;
+
+export { FieldElement$1 as F, FieldElement as a, common as c };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apibara/starknet",
-  "version": "2.1.0-beta.3",
+  "version": "2.1.0-beta.31",
   "type": "module",
   "files": [
     "dist",
@@ -27,8 +27,8 @@
     "build": "pnpm build:proto && unbuild",
     "build:proto": "buf generate proto",
     "typecheck": "tsc --noEmit",
-    "test": "vitest",
-    "test:ci": "vitest run",
+    "test": "vitest --typecheck",
+    "test:ci": "vitest run --typecheck",
     "lint": "biome check .",
     "lint:fix": "pnpm lint --write",
     "format": "biome format . --write"
@@ -42,8 +42,7 @@
     "vitest": "^1.6.0"
   },
   "dependencies": {
-    "@apibara/protocol": "2.1.0-beta.3",
-    "@effect/schema": "^0.67.15",
+    "@apibara/protocol": "2.1.0-beta.31",
     "@scure/starknet": "^1.1.0",
     "abi-wan-kanabi": "^2.2.4",
     "effect": "^3.2.6",

package/src/abi-wan-helpers.ts

@@ -0,0 +1,140 @@
+/*
+
+This file extends "abi-wan-kanabi" to provide a more type-safe way to decode events.
+
+https://github.com/keep-starknet-strange/abi-wan-kanabi
+
+This is free and unencumbered software released into the public domain.
+Anyone is free to copy, modify, publish, use, compile, sell, or distribute this software, either in source code form or as a compiled binary, for any purpose, commercial or non-commercial, and by any means.
+In jurisdictions that recognize copyright laws, the author or authors of this software dedicate any and all copyright interest in the software to the public domain. We make this dedication for the benefit of the public at large and to the detriment of our heirs and successors. We intend this dedication to be an overt act of relinquishment in perpetuity of all present and future rights to this software under copyright law.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+For more information, please refer to https://unlicense.org
+
+*/
+
+import type { Abi } from "abi-wan-kanabi";
+import type {
+  AbiEventMember,
+  ExtractAbiEvent,
+  ExtractAbiEventNames,
+  StringToPrimitiveType,
+} from "abi-wan-kanabi/kanabi";
+
+export type AbiEventStruct = {
+  type: "event";
+  name: string;
+  kind: "struct";
+  members: AbiEventMember[];
+};
+
+export type AbiMember = {
+  name: string;
+  type: string;
+};
+
+export type AbiEventEnum = {
+  type: "event";
+  name: string;
+  kind: "enum";
+  variants: AbiEventMember[];
+};
+
+export type AbiEvent = AbiEventStruct | AbiEventEnum;
+
+export type AbiItem = Abi[number];
+
+export type DecodeEventArgs<
+  TAbi extends Abi = Abi,
+  TEventName extends ExtractAbiEventNames<TAbi> = ExtractAbiEventNames<TAbi>,
+  TStrict extends boolean = true,
+> = {
+  abi: TAbi;
+  eventName: TEventName;
+  event: Event;
+  strict?: TStrict;
+};
+
+export type DecodedEvent<
+  TAbi extends Abi = Abi,
+  TEventName extends ExtractAbiEventNames<TAbi> = ExtractAbiEventNames<TAbi>,
+> = Event & {
+  eventName: TEventName;
+  args: EventToPrimitiveType<TAbi, TEventName>;
+};
+
+export type DecodeEventReturn<
+  TAbi extends Abi = Abi,
+  TEventName extends ExtractAbiEventNames<TAbi> = ExtractAbiEventNames<TAbi>,
+  TStrict extends boolean = true,
+> = TStrict extends true
+  ? DecodedEvent<TAbi, TEventName>
+  : DecodedEvent<TAbi, TEventName> | null;
+
+// Helper type to resolve the payload type of a nested variant.
+// when the type name corresponds to an event; resolves it using EventToPrimitiveType,
+export type ResolveNestedVariantType<
+  TAbi extends Abi,
+  TTypeName extends string,
+> = EventToPrimitiveType<TAbi, TTypeName>; // resolve its structure recursively
+
+// Helper type to convert a variant member (nested or flat) into its corresponding tagged union part(s).
+export type VariantToTaggedUnion<
+  TAbi extends Abi,
+  TVariant extends AbiEventMember,
+> = TVariant extends { kind: "nested" }
+  ? // Nested: Use the helper to resolve the payload type.
+    { _tag: TVariant["name"] } & {
+      [K in TVariant["name"]]: ResolveNestedVariantType<TAbi, TVariant["type"]>;
+    }
+  : TVariant extends { kind: "flat" }
+    ? // Flat: Recursively call EventToPrimitiveType on the referenced event type.
+      // This will return the union of tagged types for the nested event.
+      EventToPrimitiveType<TAbi, TVariant["type"]>
+    : never; // Should not happen for valid ABIs
+
+// Main type to convert an event definition (struct or enum) to its TS representation.
+export type EventToPrimitiveType<
+  TAbi extends Abi,
+  TEventName extends ExtractAbiEventNames<TAbi>,
+> = ExtractAbiEvent<TAbi, TEventName> extends infer TEventDef
+  ? TEventDef extends {
+      type: "event";
+      kind: "struct";
+      members: infer TMembers extends readonly AbiEventMember[];
+    }
+    ? // Struct Event: A simple object with member names as keys and their primitive types as values.
+      {
+        [Member in TMembers[number] as Member["name"]]: StringToPrimitiveType<
+          TAbi,
+          Member["type"]
+        >;
+      }
+    : TEventDef extends {
+          type: "event";
+          kind: "enum";
+          variants: infer TVariants extends readonly AbiEventMember[];
+        }
+      ? // Enum Event: Create a union of all possible tagged types derived from its variants.
+        {
+          // Map each variant to its corresponding tagged union structure(s).
+          [Idx in keyof TVariants]: VariantToTaggedUnion<TAbi, TVariants[Idx]>;
+        }[number] // Indexing with [number] converts the tuple of union parts into a single union type.
+      : // Explicitly handle empty enum events to ensure the `extends never` check works reliably.
+        TEventDef extends { type: "event"; kind: "enum"; variants: [] }
+        ? never
+        : // Not an event definition found for TEventName -> never
+          never
+  : // If the event name is not found in the ABI, return never.
+    never;
+
+export function isEventAbi(item: AbiItem): item is AbiEvent {
+  return item.type === "event";
+}
+
+export function isStructEventAbi(item: AbiItem): item is AbiEventStruct {
+  return isEventAbi(item) && item.kind === "struct";
+}
+
+export function isEnumEventAbi(item: AbiItem): item is AbiEventEnum {
+  return isEventAbi(item) && item.kind === "enum";
+}