Implement function calls, improve events

.changeset/itchy-peaches-juggle.md

@@ -0,0 +1,11 @@
+---
+"@near-lake/primitives": minor
+---
+
+Added:
+- `Block.functionCalls` to get an array of FunctionCallView in this block, with different filters
+- `Block.functionCallsToReceiver` to get an array of FunctionCallView to a specific receiver, optionally specifying method name
+- `FunctionCallView` type that provides complete information about the function call, including parsed arguments and events
+
+Changed:
+- `Event` class has been changed to inline RawEvent fields.

package.json

@@ -13,7 +13,7 @@
     "type": "git",
     "url": "git+https://github.com/near/near-lake-framework-js.git"
   },
-  "homepage": "https://near-indexers.io",
+  "homepage": "https://docs.near.org/concepts/advanced/near-lake-framework",
   "scripts": {
     "build": "turbo run build",
     "clean": "turbo run clean",

packages/near-lake-primitives/package.json

@@ -5,8 +5,8 @@
     "lake-primitives",
     "near-indexer"
   ],
-  "author": "NEAR Inc <hello@nearprotocol.com>",
-  "description": "Near Protocol primitive datatypes utilized by near-lake-framework",
+  "author": "Data Platform <dataplatform@near.org>",
+  "description": "Near Protocol primitive datatypes utilized by near-lake-framework and QueryAPI",
   "main": "dist/src/index.js",
   "files": [
     "/dist"

packages/near-lake-primitives/src/helpers.ts

@@ -0,0 +1,43 @@
+import { ExecutionStatus, ReceiptStatusFilter } from "./types/core/types";
+
+export function isMatchingReceiverSingle(
+  receiverId: string,
+  wildcardFilter: string
+) {
+  if (wildcardFilter === "*") {
+    return true;
+  }
+  const regExp = new RegExp(
+    wildcardFilter.replace(/\*/g, "[\\w\\d]+").replace(/\./g, "\\.")
+  );
+  return regExp.test(receiverId);
+}
+
+export function isMatchingReceiver(
+  receiverId: string,
+  contractFilter: string
+): boolean {
+  const filters = contractFilter.split(",").map((f) => f.trim());
+  return filters.some((f) => isMatchingReceiverSingle(receiverId, f));
+}
+
+export function isSuccessfulReceipt(receiptStatus: ExecutionStatus): boolean {
+  return (
+    receiptStatus.hasOwnProperty("SuccessValue") ||
+    receiptStatus.hasOwnProperty("SuccessReceiptId")
+  );
+}
+
+export function isMatchingReceiptStatus(
+  receiptStatus: ExecutionStatus,
+  statusFilter: ReceiptStatusFilter
+): boolean {
+  switch (statusFilter) {
+    case "all":
+      return true;
+    case "onlySuccessful":
+      return isSuccessfulReceipt(receiptStatus);
+    case "onlyFailed":
+      return receiptStatus.hasOwnProperty("Failure");
+  }
+}