@settlemint/sdk-portal 2.3.2-pr8227fae7 → 2.3.2-pr8d084a79

package/README.md

@@ -30,6 +30,7 @@
 - [Examples](#examples)
   - [Deploy contract](#deploy-contract)
   - [Get pending transactions](#get-pending-transactions)
+  - [Monitoring alerting](#monitoring-alerting)
   - [Send transaction using hd wallet](#send-transaction-using-hd-wallet)
 - [API Reference](#api-reference)
   - [Functions](#functions)
@@ -40,6 +41,8 @@
   - [Interfaces](#interfaces)
     - [HandleWalletVerificationChallengeOptions\<Setup\>](#handlewalletverificationchallengeoptionssetup)
     - [Transaction](#transaction)
+    - [TransactionEvent](#transactionevent)
+    - [TransactionReceipt](#transactionreceipt)
     - [WaitForTransactionReceiptOptions](#waitfortransactionreceiptoptions)
     - [WebsocketClientOptions](#websocketclientoptions)
   - [Type Aliases](#type-aliases)
@@ -219,6 +222,236 @@ const query = portalGraphql(`
 const result = await portalClient.request(query);
 console.log(`There are ${result.getPendingTransactions?.count} pending transactions`);
 
+```
+### Monitoring alerting
+
+```ts
+/**
+ * This example demonstrates how to implement real-time transaction monitoring and alerting.
+ *
+ * The process involves:
+ * 1. Creating a WebSocket subscription to monitor all blockchain transactions
+ * 2. Setting up custom handlers for different monitoring scenarios
+ * 3. Processing transactions in real-time as they are confirmed
+ * 4. Implementing specific monitoring functions for addresses, events, and failures
+ * 5. Triggering alerts based on predefined conditions
+ *
+ * This pattern is useful for applications that need to:
+ * - Detect suspicious activities for security purposes
+ * - Track high-value transfers or specific contract interactions
+ * - Monitor for failed transactions that require attention
+ * - Implement compliance reporting and audit trails
+ * - Build automated workflows that respond to on-chain events
+ * - Provide real-time notifications to stakeholders
+ */
+
+import type { FormattedExecutionResult } from "graphql";
+import { type Transaction, type WebsocketClientOptions, getWebsocketClient } from "../portal.js"; // Replace this path with "@settlemint/sdk-portal"
+
+/**
+ * Handlers for different monitoring scenarios
+ * You can implement your own handlers
+ */
+export type AlertHandlers = {
+  onAddressActivity: (transaction: Transaction, addresses: string[]) => void;
+  onEvent: (transaction: Transaction, eventNames: string[]) => void;
+  onFailure: (transaction: Transaction) => void;
+};
+
+/**
+ * Monitors all blockchain transactions by subscribing to transaction updates via GraphQL.
+ * This function continuously logs all transaction receipts as they are received.
+ *
+ * @param options - Configuration options for connecting to the Portal API
+ * @param handlers - Optional handlers for different monitoring scenarios
+ * @throws Error if the subscription fails
+ *
+ * @example
+ * import { monitorAllTransactions } from "@settlemint/sdk-portal";
+ *
+ * monitorAllTransactions({
+ *   portalGraphqlEndpoint: "https://example.settlemint.com/graphql",
+ *   accessToken: "your-access-token"
+ * }, {
+ *   onAddressActivity: (tx, address) => {
+ *     console.log(`Address ${address} was involved in transaction ${tx.transactionHash}`);
+ *   },
+ *   onEvent: (tx, eventName) => {
+ *     console.log(`Event ${eventName} detected in transaction ${tx.transactionHash}`);
+ *   },
+ *   onFailure: (tx, reason) => {
+ *     console.log(`Transaction ${tx.transactionHash} failed: ${reason}`);
+ *   }
+ * });
+ */
+export function monitorAllTransactions(options: WebsocketClientOptions, handlers: AlertHandlers) {
+  const wsClient = getWebsocketClient(options);
+
+  const subscription = wsClient.iterate<{
+    getProcessedTransactions: {
+      records: Transaction[];
+    };
+  }>({
+    query: `subscription getProcessedTransactions {
+      getProcessedTransactions(pageSize: 1) {
+        records {
+          receipt {
+            transactionHash
+            to
+            status
+            from
+            type
+            revertReason
+            revertReasonDecoded
+            logs
+            events
+            contractAddress
+          }
+          transactionHash
+          from
+          createdAt
+          address
+          functionName
+          isContract
+        }
+      }
+    }`,
+  });
+
+  // Start the monitoring process
+  processSubscription(subscription, handlers);
+
+  return subscription;
+}
+
+/**
+ * Internal helper to process the subscription stream
+ */
+async function processSubscription(
+  subscription: AsyncIterable<
+    FormattedExecutionResult<
+      {
+        getProcessedTransactions: {
+          records: Transaction[];
+        };
+      },
+      unknown
+    >
+  >,
+  handlers: AlertHandlers,
+) {
+  (async () => {
+    for await (const result of subscription) {
+      if (result?.data?.getProcessedTransactions?.records) {
+        const records = result.data.getProcessedTransactions.records;
+        const transaction = records.at(-1);
+
+        if (transaction) {
+          processTransaction(transaction, handlers);
+        }
+      }
+    }
+  })();
+}
+
+/**
+ * Process a single transaction with the configured handlers
+ */
+function processTransaction(transaction: Transaction, handlers: AlertHandlers) {
+  // Monitor specific addresses (example addresses)
+  handlers.onAddressActivity(transaction, ["0x742d35Cc6634C0532925a3b844Bc454e4438f44e"]);
+
+  // Monitor for specific events
+  handlers.onEvent(transaction, ["Transfer", "Approval"]);
+
+  // Monitor for failed transactions
+  handlers.onFailure(transaction);
+}
+
+/**
+ * Monitors transactions from or to specific addresses.
+ *
+ * @param transaction - The transaction to check
+ * @param addresses - The addresses to monitor
+ *
+ * @example
+ * import { monitorSpecificAddresses } from "@settlemint/sdk-portal";
+ *
+ * monitorSpecificAddresses(transaction, ["0x742d35Cc6634C0532925a3b844Bc454e4438f44e"]);
+ */
+export function monitorSpecificAddresses(transaction: Transaction, addresses: string[]) {
+  const { from, address } = transaction;
+  const { to } = transaction.receipt;
+  const isInvolved = addresses.some((address) => [from, to].includes(address));
+
+  if (isInvolved) {
+    notify(`[ADDRESS] Address ${address} was involved in transaction ${transaction.transactionHash}`);
+  }
+}
+
+/**
+ * Monitors transactions for specific contract events.
+ *
+ * @param transaction - The transaction to check
+ * @param eventNames - The event names to monitor
+ *
+ * @example
+ * import { monitorContractEvents } from "@settlemint/sdk-portal";
+ *
+ * monitorContractEvents(transaction, ["Transfer", "Approval"]);
+ */
+export function monitorContractEvents(transaction: Transaction, eventNames: string[]) {
+  const events = transaction.receipt.events;
+
+  const eventDetected = events.find((event) => eventNames.includes(event.eventName));
+  if (eventDetected) {
+    notify(`[EVENT] Event ${eventDetected.eventName} detected in transaction ${transaction.transactionHash}`);
+  }
+}
+
+/**
+ * Monitors for failed transactions that require attention.
+ *
+ * @param transaction - The transaction to check
+ *
+ * @example
+ * import { monitorFailedTransactions } from "@settlemint/sdk-portal";
+ *
+ * monitorFailedTransactions(transaction, "Unknown reason");
+ */
+export function monitorFailedTransactions(transaction: Transaction) {
+  const status = transaction.receipt?.status;
+
+  if (status === "Reverted") {
+    const reason = transaction.receipt.revertReasonDecoded;
+    notify(`[FAILED] Transaction ${transaction.transactionHash} failed: ${reason}`);
+  }
+}
+
+const notify = (message: string) => {
+  console.log(message);
+};
+
+/**
+ * Example usage - monitoring specific on-chain activity
+ */
+export function runMonitoringExample() {
+  // Basic usage
+  monitorAllTransactions(
+    {
+      portalGraphqlEndpoint: "https://example.settlemint.com/graphql",
+      accessToken: process.env.SETTLEMINT_ACCESS_TOKEN!,
+    },
+    {
+      onAddressActivity: monitorSpecificAddresses,
+      onEvent: monitorContractEvents,
+      onFailure: monitorFailedTransactions,
+    },
+  );
+}
+
+runMonitoringExample();
+
 ```
 ### Send transaction using hd wallet
 
@@ -449,7 +682,7 @@ const result = await portalClient.request(query);
 
 > **getWebsocketClient**(`options`): `Client`
 
-Defined in: [sdk/portal/src/utils/websocket-client.ts:23](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/websocket-client.ts#L23)
+Defined in: [sdk/portal/src/utils/websocket-client.ts:30](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/websocket-client.ts#L30)
 
 Creates a GraphQL WebSocket client for the Portal API
 
@@ -465,13 +698,24 @@ Creates a GraphQL WebSocket client for the Portal API
 
 The GraphQL WebSocket client
 
+##### Example
+
+```ts
+import { getWebsocketClient } from "@settlemint/sdk-portal";
+
+const client = getWebsocketClient({
+  portalGraphqlEndpoint: "https://portal.settlemint.com/graphql",
+  accessToken: "your-access-token",
+});
+```
+
 ***
 
 #### handleWalletVerificationChallenge()
 
 > **handleWalletVerificationChallenge**\<`Setup`\>(`options`): `Promise`\<\{ `challengeResponse`: `string`; `verificationId?`: `string`; \}\>
 
-Defined in: [sdk/portal/src/utils/wallet-verification-challenge.ts:106](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wallet-verification-challenge.ts#L106)
+Defined in: [sdk/portal/src/utils/wallet-verification-challenge.ts:103](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wallet-verification-challenge.ts#L103)
 
 Handles a wallet verification challenge by generating an appropriate response
 
@@ -524,7 +768,7 @@ const result = await handleWalletVerificationChallenge({
 
 > **waitForTransactionReceipt**(`transactionHash`, `options`): `Promise`\<[`Transaction`](#transaction)\>
 
-Defined in: [sdk/portal/src/utils/wait-for-transaction-receipt.ts:79](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wait-for-transaction-receipt.ts#L79)
+Defined in: [sdk/portal/src/utils/wait-for-transaction-receipt.ts:83](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wait-for-transaction-receipt.ts#L83)
 
 Waits for a blockchain transaction receipt by subscribing to transaction updates via GraphQL.
 This function polls until the transaction is confirmed or the timeout is reached.
@@ -562,29 +806,80 @@ const transaction = await waitForTransactionReceipt("0x123...", {
 
 #### HandleWalletVerificationChallengeOptions\<Setup\>
 
-Defined in: [sdk/portal/src/utils/wallet-verification-challenge.ts:73](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wallet-verification-challenge.ts#L73)
+Defined in: [sdk/portal/src/utils/wallet-verification-challenge.ts:64](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wallet-verification-challenge.ts#L64)
 
 Options for handling a wallet verification challenge
 
 ##### Type Parameters
 
-| Type Parameter | Description |
-| ------ | ------ |
-| `Setup` *extends* `AbstractSetupSchema` | The GraphQL schema setup type |
+| Type Parameter |
+| ------ |
+| `Setup` *extends* `AbstractSetupSchema` |
+
+##### Properties
+
+| Property | Type | Description | Defined in |
+| ------ | ------ | ------ | ------ |
+| <a id="code"></a> `code` | `string` \| `number` | The verification code provided by the user | [sdk/portal/src/utils/wallet-verification-challenge.ts:74](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wallet-verification-challenge.ts#L74) |
+| <a id="portalclient"></a> `portalClient` | `GraphQLClient` | The portal client instance | [sdk/portal/src/utils/wallet-verification-challenge.ts:66](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wallet-verification-challenge.ts#L66) |
+| <a id="portalgraphql"></a> `portalGraphql` | `initGraphQLTada`\<`Setup`\> | The GraphQL query builder | [sdk/portal/src/utils/wallet-verification-challenge.ts:68](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wallet-verification-challenge.ts#L68) |
+| <a id="userwalletaddress"></a> `userWalletAddress` | `` `0x${string}` `` | The wallet address to verify | [sdk/portal/src/utils/wallet-verification-challenge.ts:72](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wallet-verification-challenge.ts#L72) |
+| <a id="verificationid"></a> `verificationId` | `string` | The ID of the verification challenge | [sdk/portal/src/utils/wallet-verification-challenge.ts:70](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wallet-verification-challenge.ts#L70) |
+| <a id="verificationtype"></a> `verificationType` | `"otp"` \| `"secret-code"` \| `"pincode"` | The type of verification being performed | [sdk/portal/src/utils/wallet-verification-challenge.ts:76](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wallet-verification-challenge.ts#L76) |
 
 ***
 
 #### Transaction
 
-Defined in: [sdk/portal/src/utils/wait-for-transaction-receipt.ts:26](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wait-for-transaction-receipt.ts#L26)
+Defined in: [sdk/portal/src/utils/wait-for-transaction-receipt.ts:37](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wait-for-transaction-receipt.ts#L37)
 
 Represents the structure of a blockchain transaction with its receipt
 
+##### Properties
+
+| Property | Type | Description | Defined in |
+| ------ | ------ | ------ | ------ |
+| <a id="address"></a> `address` | `string` | The contract address involved in the transaction | [sdk/portal/src/utils/wait-for-transaction-receipt.ts:46](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wait-for-transaction-receipt.ts#L46) |
+| <a id="createdat"></a> `createdAt` | `string` | Timestamp when the transaction was created | [sdk/portal/src/utils/wait-for-transaction-receipt.ts:44](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wait-for-transaction-receipt.ts#L44) |
+| <a id="from"></a> `from` | `string` | The sender address (duplicate of receipt.from) | [sdk/portal/src/utils/wait-for-transaction-receipt.ts:42](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wait-for-transaction-receipt.ts#L42) |
+| <a id="functionname"></a> `functionName` | `string` | The name of the function called in the transaction | [sdk/portal/src/utils/wait-for-transaction-receipt.ts:48](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wait-for-transaction-receipt.ts#L48) |
+| <a id="iscontract"></a> `isContract` | `boolean` | Whether the transaction is a contract deployment | [sdk/portal/src/utils/wait-for-transaction-receipt.ts:50](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wait-for-transaction-receipt.ts#L50) |
+| <a id="transactionhash"></a> `transactionHash` | `string` | The hash of the transaction (duplicate of receipt.transactionHash) | [sdk/portal/src/utils/wait-for-transaction-receipt.ts:40](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wait-for-transaction-receipt.ts#L40) |
+
+***
+
+#### TransactionEvent
+
+Defined in: [sdk/portal/src/utils/wait-for-transaction-receipt.ts:14](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wait-for-transaction-receipt.ts#L14)
+
+Represents an event emitted during a transaction execution
+
+***
+
+#### TransactionReceipt
+
+Defined in: [sdk/portal/src/utils/wait-for-transaction-receipt.ts:23](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wait-for-transaction-receipt.ts#L23)
+
+Represents the structure of a blockchain transaction receipt
+
+##### Extends
+
+- `TransactionReceipt`\<`string`, `number`, `"Success"` \| `"Reverted"`\>
+
+##### Properties
+
+| Property | Type | Description | Overrides | Defined in |
+| ------ | ------ | ------ | ------ | ------ |
+| <a id="contractaddress"></a> `contractAddress` | `` `0x${string}` `` | The address of the contract deployed in the transaction | `TransactionReceiptViem.contractAddress` | [sdk/portal/src/utils/wait-for-transaction-receipt.ts:31](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wait-for-transaction-receipt.ts#L31) |
+| <a id="events"></a> `events` | [`TransactionEvent`](#transactionevent)[] | Array of events emitted during the transaction | - | [sdk/portal/src/utils/wait-for-transaction-receipt.ts:29](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wait-for-transaction-receipt.ts#L29) |
+| <a id="revertreason"></a> `revertReason` | `string` | The raw reason for transaction reversion, if applicable | - | [sdk/portal/src/utils/wait-for-transaction-receipt.ts:25](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wait-for-transaction-receipt.ts#L25) |
+| <a id="revertreasondecoded"></a> `revertReasonDecoded` | `string` | Human-readable version of the revert reason | - | [sdk/portal/src/utils/wait-for-transaction-receipt.ts:27](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wait-for-transaction-receipt.ts#L27) |
+
 ***
 
 #### WaitForTransactionReceiptOptions
 
-Defined in: [sdk/portal/src/utils/wait-for-transaction-receipt.ts:57](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wait-for-transaction-receipt.ts#L57)
+Defined in: [sdk/portal/src/utils/wait-for-transaction-receipt.ts:60](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wait-for-transaction-receipt.ts#L60)
 
 Options for waiting for a transaction receipt
 
@@ -592,11 +887,19 @@ Options for waiting for a transaction receipt
 
 - [`WebsocketClientOptions`](#websocketclientoptions)
 
+##### Properties
+
+| Property | Type | Description | Inherited from | Defined in |
+| ------ | ------ | ------ | ------ | ------ |
+| <a id="accesstoken"></a> `accessToken` | `string` | The access token for authentication with the Portal API | [`WebsocketClientOptions`](#websocketclientoptions).[`accessToken`](#accesstoken-1) | [sdk/portal/src/utils/websocket-client.ts:14](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/websocket-client.ts#L14) |
+| <a id="portalgraphqlendpoint"></a> `portalGraphqlEndpoint` | `string` | The GraphQL endpoint URL for the Portal API | [`WebsocketClientOptions`](#websocketclientoptions).[`portalGraphqlEndpoint`](#portalgraphqlendpoint-1) | [sdk/portal/src/utils/websocket-client.ts:10](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/websocket-client.ts#L10) |
+| <a id="timeout"></a> `timeout?` | `number` | Optional timeout in milliseconds before the operation fails | - | [sdk/portal/src/utils/wait-for-transaction-receipt.ts:62](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wait-for-transaction-receipt.ts#L62) |
+
 ***
 
 #### WebsocketClientOptions
 
-Defined in: [sdk/portal/src/utils/websocket-client.ts:10](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/websocket-client.ts#L10)
+Defined in: [sdk/portal/src/utils/websocket-client.ts:6](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/websocket-client.ts#L6)
 
 Options for the GraphQL WebSocket client
 
@@ -604,6 +907,13 @@ Options for the GraphQL WebSocket client
 
 - [`WaitForTransactionReceiptOptions`](#waitfortransactionreceiptoptions)
 
+##### Properties
+
+| Property | Type | Description | Defined in |
+| ------ | ------ | ------ | ------ |
+| <a id="accesstoken-1"></a> `accessToken` | `string` | The access token for authentication with the Portal API | [sdk/portal/src/utils/websocket-client.ts:14](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/websocket-client.ts#L14) |
+| <a id="portalgraphqlendpoint-1"></a> `portalGraphqlEndpoint` | `string` | The GraphQL endpoint URL for the Portal API | [sdk/portal/src/utils/websocket-client.ts:10](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/websocket-client.ts#L10) |
+
 ### Type Aliases
 
 #### ClientOptions

package/dist/portal.cjs

@@ -33,6 +33,81 @@ var import_validation = require("@settlemint/sdk-utils/validation");
 var import_gql = require("gql.tada");
 var import_graphql_request = require("graphql-request");
 var import_v4 = require("zod/v4");
+var import_gql2 = require("gql.tada");
+
+// src/utils/websocket-client.ts
+var import_graphql_ws = require("graphql-ws");
+function getWebsocketClient({ portalGraphqlEndpoint, accessToken }) {
+  if (!portalGraphqlEndpoint) {
+    throw new Error("portalGraphqlEndpoint is required");
+  }
+  if (!accessToken) {
+    throw new Error("accessToken is required");
+  }
+  const graphqlEndpoint = setWsProtocol(new URL(portalGraphqlEndpoint));
+  return (0, import_graphql_ws.createClient)({
+    url: `${graphqlEndpoint.protocol}//${graphqlEndpoint.host}/${accessToken}${graphqlEndpoint.pathname}${graphqlEndpoint.search}`
+  });
+}
+function setWsProtocol(url) {
+  if (url.protocol === "ws:" || url.protocol === "wss:") {
+    return url;
+  }
+  if (url.protocol === "http:") {
+    url.protocol = "ws:";
+  } else {
+    url.protocol = "wss:";
+  }
+  return url;
+}
+
+// src/utils/wait-for-transaction-receipt.ts
+async function waitForTransactionReceipt(transactionHash, options) {
+  const wsClient = getWebsocketClient(options);
+  const subscription = wsClient.iterate({
+    query: `subscription getTransaction($transactionHash: String!) {
+        getTransaction(transactionHash: $transactionHash) {
+          receipt {
+            transactionHash
+            to
+            status
+            from
+            type
+            revertReason
+            revertReasonDecoded
+            logs
+            events
+            contractAddress
+          }
+          transactionHash
+          from
+          createdAt
+          address
+          functionName
+          isContract
+        }
+      }`,
+    variables: { transactionHash }
+  });
+  const promises = [getTransactionFromSubscription(subscription)];
+  if (options.timeout) {
+    promises.push(createTimeoutPromise(options.timeout));
+  }
+  return Promise.race(promises);
+}
+function createTimeoutPromise(timeout) {
+  return new Promise((_, reject) => {
+    setTimeout(() => reject(new Error("Transaction receipt not found")), timeout);
+  });
+}
+async function getTransactionFromSubscription(subscription) {
+  for await (const result of subscription) {
+    if (result?.data?.getTransaction?.receipt) {
+      return result.data.getTransaction;
+    }
+  }
+  throw new Error("No transaction found");
+}
 
 // src/utils/wallet-verification-challenge.ts
 var import_node_crypto = require("crypto");
@@ -112,82 +187,7 @@ async function handleWalletVerificationChallenge({
   }
 }
 
-// src/utils/websocket-client.ts
-var import_graphql_ws = require("graphql-ws");
-function getWebsocketClient({ portalGraphqlEndpoint, accessToken }) {
-  if (!portalGraphqlEndpoint) {
-    throw new Error("portalGraphqlEndpoint is required");
-  }
-  if (!accessToken) {
-    throw new Error("accessToken is required");
-  }
-  const graphqlEndpoint = setWsProtocol(new URL(portalGraphqlEndpoint));
-  return (0, import_graphql_ws.createClient)({
-    url: `${graphqlEndpoint.protocol}//${graphqlEndpoint.host}/${accessToken}${graphqlEndpoint.pathname}${graphqlEndpoint.search}`
-  });
-}
-function setWsProtocol(url) {
-  if (url.protocol === "ws:" || url.protocol === "wss:") {
-    return url;
-  }
-  if (url.protocol === "http:") {
-    url.protocol = "ws:";
-  } else {
-    url.protocol = "wss:";
-  }
-  return url;
-}
-
-// src/utils/wait-for-transaction-receipt.ts
-async function waitForTransactionReceipt(transactionHash, options) {
-  const wsClient = getWebsocketClient(options);
-  const subscription = wsClient.iterate({
-    query: `subscription getTransaction($transactionHash: String!) {
-        getTransaction(transactionHash: $transactionHash) {
-          receipt {
-            transactionHash
-            to
-            status
-            from
-            type
-            revertReason
-            revertReasonDecoded
-            logs
-            events
-            contractAddress
-          }
-          transactionHash
-          from
-          createdAt
-          address
-          functionName
-          isContract
-        }
-      }`,
-    variables: { transactionHash }
-  });
-  const promises = [getTransactionFromSubscription(subscription)];
-  if (options.timeout) {
-    promises.push(createTimeoutPromise(options.timeout));
-  }
-  return Promise.race(promises);
-}
-function createTimeoutPromise(timeout) {
-  return new Promise((_, reject) => {
-    setTimeout(() => reject(new Error("Transaction receipt not found")), timeout);
-  });
-}
-async function getTransactionFromSubscription(subscription) {
-  for await (const result of subscription) {
-    if (result?.data?.getTransaction?.receipt) {
-      return result.data.getTransaction;
-    }
-  }
-  throw new Error("No transaction found");
-}
-
 // src/portal.ts
-var import_gql2 = require("gql.tada");
 var ClientOptionsSchema = import_v4.z.object({
   instance: import_validation.UrlOrPathSchema,
   accessToken: import_validation.ApplicationAccessTokenSchema,