@settlemint/sdk-portal 2.3.2-prebafe7cb → 2.3.2-prede7bc05

package/README.md

@@ -42,6 +42,7 @@
     - [HandleWalletVerificationChallengeOptions\<Setup\>](#handlewalletverificationchallengeoptionssetup)
     - [Transaction](#transaction)
     - [TransactionEvent](#transactionevent)
+    - [TransactionReceipt](#transactionreceipt)
     - [WaitForTransactionReceiptOptions](#waitfortransactionreceiptoptions)
     - [WebsocketClientOptions](#websocketclientoptions)
   - [Type Aliases](#type-aliases)
@@ -600,7 +601,7 @@ console.log("Transaction hash:", result.StableCoinFactoryCreate?.transactionHash
 
 > **createPortalClient**\<`Setup`\>(`options`, `clientOptions?`): `object`
 
-Defined in: [sdk/portal/src/portal.ts:71](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/portal.ts#L71)
+Defined in: [sdk/portal/src/portal.ts:72](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/portal.ts#L72)
 
 Creates a Portal GraphQL client with the provided configuration.
 
@@ -614,8 +615,8 @@ Creates a Portal GraphQL client with the provided configuration.
 
 | Parameter | Type | Description |
 | ------ | ------ | ------ |
-| `options` | \{ `accessToken`: `string`; `cache?`: `"default"` \| `"force-cache"` \| `"no-cache"` \| `"no-store"` \| `"only-if-cached"` \| `"reload"`; `instance`: `string`; \} | Configuration options for the Portal client |
-| `options.accessToken` | `string` | - |
+| `options` | \{ `accessToken?`: `string`; `cache?`: `"default"` \| `"force-cache"` \| `"no-cache"` \| `"no-store"` \| `"only-if-cached"` \| `"reload"`; `instance`: `string`; \} | Configuration options for the Portal client |
+| `options.accessToken?` | `string` | - |
 | `options.cache?` | `"default"` \| `"force-cache"` \| `"no-cache"` \| `"no-store"` \| `"only-if-cached"` \| `"reload"` | - |
 | `options.instance?` | `string` | - |
 | `clientOptions?` | `RequestConfig` | Additional GraphQL client configuration options |
@@ -628,8 +629,8 @@ An object containing the configured GraphQL client and graphql helper function
 
 | Name | Type | Defined in |
 | ------ | ------ | ------ |
-| `client` | `GraphQLClient` | [sdk/portal/src/portal.ts:75](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/portal.ts#L75) |
-| `graphql` | `initGraphQLTada`\<`Setup`\> | [sdk/portal/src/portal.ts:76](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/portal.ts#L76) |
+| `client` | `GraphQLClient` | [sdk/portal/src/portal.ts:76](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/portal.ts#L76) |
+| `graphql` | `initGraphQLTada`\<`Setup`\> | [sdk/portal/src/portal.ts:77](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/portal.ts#L77) |
 
 ##### Throws
 
@@ -681,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
 
@@ -697,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
 
@@ -756,7 +768,7 @@ const result = await handleWalletVerificationChallenge({
 
 > **waitForTransactionReceipt**(`transactionHash`, `options`): `Promise`\<[`Transaction`](#transaction)\>
 
-Defined in: [sdk/portal/src/utils/wait-for-transaction-receipt.ts:90](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wait-for-transaction-receipt.ts#L90)
+Defined in: [sdk/portal/src/utils/wait-for-transaction-receipt.ts:80](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wait-for-transaction-receipt.ts#L80)
 
 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.
@@ -794,37 +806,88 @@ 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:43](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wait-for-transaction-receipt.ts#L43)
+Defined in: [sdk/portal/src/utils/wait-for-transaction-receipt.ts:34](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wait-for-transaction-receipt.ts#L34)
 
 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:43](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wait-for-transaction-receipt.ts#L43) |
+| <a id="createdat"></a> `createdAt` | `string` | Timestamp when the transaction was created | [sdk/portal/src/utils/wait-for-transaction-receipt.ts:41](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wait-for-transaction-receipt.ts#L41) |
+| <a id="from"></a> `from` | `string` | The sender address (duplicate of receipt.from) | [sdk/portal/src/utils/wait-for-transaction-receipt.ts:39](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wait-for-transaction-receipt.ts#L39) |
+| <a id="functionname"></a> `functionName` | `string` | The name of the function called in the transaction | [sdk/portal/src/utils/wait-for-transaction-receipt.ts:45](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wait-for-transaction-receipt.ts#L45) |
+| <a id="iscontract"></a> `isContract` | `boolean` | Whether the transaction is a contract deployment | [sdk/portal/src/utils/wait-for-transaction-receipt.ts:47](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wait-for-transaction-receipt.ts#L47) |
+| <a id="transactionhash"></a> `transactionHash` | `string` | The hash of the transaction (duplicate of receipt.transactionHash) | [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) |
+
 ***
 
 #### TransactionEvent
 
-Defined in: [sdk/portal/src/utils/wait-for-transaction-receipt.ts:15](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wait-for-transaction-receipt.ts#L15)
+Defined in: [sdk/portal/src/utils/wait-for-transaction-receipt.ts:8](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wait-for-transaction-receipt.ts#L8)
 
 Represents an event emitted during a transaction execution
 
+##### Properties
+
+| Property | Type | Description | Defined in |
+| ------ | ------ | ------ | ------ |
+| <a id="args"></a> `args` | `Record`\<`string`, `unknown`\> | The arguments emitted by the event | [sdk/portal/src/utils/wait-for-transaction-receipt.ts:12](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wait-for-transaction-receipt.ts#L12) |
+| <a id="eventname"></a> `eventName` | `string` | The name of the event that was emitted | [sdk/portal/src/utils/wait-for-transaction-receipt.ts:10](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wait-for-transaction-receipt.ts#L10) |
+| <a id="topics"></a> `topics` | `` `0x${string}` ``[] | Indexed event parameters used for filtering and searching | [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) |
+
+***
+
+#### TransactionReceipt
+
+Defined in: [sdk/portal/src/utils/wait-for-transaction-receipt.ts:20](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wait-for-transaction-receipt.ts#L20)
+
+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:28](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wait-for-transaction-receipt.ts#L28) |
+| <a id="events"></a> `events` | [`TransactionEvent`](#transactionevent)[] | Array of events emitted during the transaction | - | [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) |
+| <a id="revertreason"></a> `revertReason` | `string` | The raw reason for transaction reversion, if applicable | - | [sdk/portal/src/utils/wait-for-transaction-receipt.ts:22](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wait-for-transaction-receipt.ts#L22) |
+| <a id="revertreasondecoded"></a> `revertReasonDecoded` | `string` | Human-readable version of the revert reason | - | [sdk/portal/src/utils/wait-for-transaction-receipt.ts:24](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wait-for-transaction-receipt.ts#L24) |
+
 ***
 
 #### WaitForTransactionReceiptOptions
 
-Defined in: [sdk/portal/src/utils/wait-for-transaction-receipt.ts:68](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wait-for-transaction-receipt.ts#L68)
+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)
 
 Options for waiting for a transaction receipt
 
@@ -832,11 +895,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:59](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/utils/wait-for-transaction-receipt.ts#L59) |
+
 ***
 
 #### 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
 
@@ -844,13 +915,20 @@ 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
 
 > **ClientOptions** = `z.infer`\<*typeof* [`ClientOptionsSchema`](#clientoptionsschema)\>
 
-Defined in: [sdk/portal/src/portal.ts:24](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/portal.ts#L24)
+Defined in: [sdk/portal/src/portal.ts:25](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/portal.ts#L25)
 
 Type representing the validated client options.
 
@@ -860,7 +938,7 @@ Type representing the validated client options.
 
 > **RequestConfig** = `ConstructorParameters`\<*typeof* `GraphQLClient`\>\[`1`\]
 
-Defined in: [sdk/portal/src/portal.ts:10](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/portal.ts#L10)
+Defined in: [sdk/portal/src/portal.ts:11](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/portal.ts#L11)
 
 Configuration options for the GraphQL client, excluding 'url' and 'exchanges'.
 
@@ -868,9 +946,9 @@ Configuration options for the GraphQL client, excluding 'url' and 'exchanges'.
 
 #### ClientOptionsSchema
 
-> `const` **ClientOptionsSchema**: `ZodObject`\<\{ `accessToken`: `ZodString`; `cache`: `ZodOptional`\<`ZodEnum`\<\{ `default`: `"default"`; `force-cache`: `"force-cache"`; `no-cache`: `"no-cache"`; `no-store`: `"no-store"`; `only-if-cached`: `"only-if-cached"`; `reload`: `"reload"`; \}\>\>; `instance`: `ZodUnion`\<readonly \[`ZodString`, `ZodString`\]\>; \}, `$strip`\>
+> `const` **ClientOptionsSchema**: `ZodObject`\<\{ `accessToken`: `ZodOptional`\<`ZodString`\>; `cache`: `ZodOptional`\<`ZodEnum`\<\{ `default`: `"default"`; `force-cache`: `"force-cache"`; `no-cache`: `"no-cache"`; `no-store`: `"no-store"`; `only-if-cached`: `"only-if-cached"`; `reload`: `"reload"`; \}\>\>; `instance`: `ZodUnion`\<readonly \[`ZodString`, `ZodString`\]\>; \}, `$strip`\>
 
-Defined in: [sdk/portal/src/portal.ts:15](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/portal.ts#L15)
+Defined in: [sdk/portal/src/portal.ts:16](https://github.com/settlemint/sdk/blob/v2.3.2/sdk/portal/src/portal.ts#L16)
 
 Schema for validating Portal client configuration options.
 

package/dist/browser/portal.d.ts

@@ -0,0 +1,252 @@
+import { AbstractSetupSchema, FragmentOf, ResultOf, VariablesOf, initGraphQLTada, readFragment } from "gql.tada";
+import { GraphQLClient } from "graphql-request";
+import { z } from "zod/v4";
+import * as graphql_ws0 from "graphql-ws";
+import { Address, Hex, TransactionReceipt as TransactionReceipt$1 } from "viem";
+
+//#region src/utils/websocket-client.d.ts
+/**
+* Options for the GraphQL WebSocket client
+*/
+/**
+ * Options for the GraphQL WebSocket client
+ */
+interface WebsocketClientOptions {
+  /**
+   * The GraphQL endpoint URL for the Portal API
+   */
+  portalGraphqlEndpoint: string;
+  /**
+   * The access token for authentication with the Portal API
+   */
+  accessToken?: string;
+}
+/**
+ * Creates a GraphQL WebSocket client for the Portal API
+ *
+ * @param {WebsocketClientOptions} options - The options for the client
+ * @returns {Client} The GraphQL WebSocket client
+ * @example
+ * import { getWebsocketClient } from "@settlemint/sdk-portal";
+ *
+ * const client = getWebsocketClient({
+ *   portalGraphqlEndpoint: "https://portal.settlemint.com/graphql",
+ *   accessToken: "your-access-token",
+ * });
+ */
+declare function getWebsocketClient({
+  portalGraphqlEndpoint,
+  accessToken
+}: WebsocketClientOptions): graphql_ws0.Client;
+
+//#endregion
+//#region src/utils/wait-for-transaction-receipt.d.ts
+/**
+ * Represents an event emitted during a transaction execution
+ */
+interface TransactionEvent {
+  /** The name of the event that was emitted */
+  eventName: string;
+  /** The arguments emitted by the event */
+  args: Record<string, unknown>;
+  /** Indexed event parameters used for filtering and searching */
+  topics: Hex[];
+}
+/**
+ * Represents the structure of a blockchain transaction receipt
+ */
+interface TransactionReceipt extends TransactionReceipt$1<string, number, "Success" | "Reverted"> {
+  /** The raw reason for transaction reversion, if applicable */
+  revertReason: string;
+  /** Human-readable version of the revert reason */
+  revertReasonDecoded: string;
+  /** Array of events emitted during the transaction */
+  events: TransactionEvent[];
+  /** The address of the contract deployed in the transaction */
+  contractAddress: Address;
+}
+/**
+ * Represents the structure of a blockchain transaction with its receipt
+ */
+interface Transaction {
+  receipt: TransactionReceipt;
+  /** The hash of the transaction (duplicate of receipt.transactionHash) */
+  transactionHash: string;
+  /** The sender address (duplicate of receipt.from) */
+  from: string;
+  /** Timestamp when the transaction was created */
+  createdAt: string;
+  /** The contract address involved in the transaction */
+  address: string;
+  /** The name of the function called in the transaction */
+  functionName: string;
+  /** Whether the transaction is a contract deployment */
+  isContract: boolean;
+}
+/**
+ * Options for waiting for a transaction receipt
+ */
+interface WaitForTransactionReceiptOptions extends WebsocketClientOptions {
+  /** Optional timeout in milliseconds before the operation fails */
+  timeout?: number;
+}
+/**
+ * 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.
+ *
+ * @param transactionHash - The hash of the transaction to wait for
+ * @param options - Configuration options for the waiting process
+ * @returns The transaction details including receipt information when the transaction is confirmed
+ * @throws Error if the transaction receipt cannot be retrieved within the specified timeout
+ *
+ * @example
+ * import { waitForTransactionReceipt } from "@settlemint/sdk-portal";
+ *
+ * const transaction = await waitForTransactionReceipt("0x123...", {
+ *   portalGraphqlEndpoint: "https://example.settlemint.com/graphql",
+ *   accessToken: "your-access-token",
+ *   timeout: 30000 // 30 seconds timeout
+ * });
+ */
+declare function waitForTransactionReceipt(transactionHash: string, options: WaitForTransactionReceiptOptions): Promise<Transaction>;
+
+//#endregion
+//#region src/utils/wallet-verification-challenge.d.ts
+/**
+ * Custom error class for challenge-related errors
+ */
+declare class ChallengeError extends Error {
+  readonly code: string;
+  constructor(message: string, code: string);
+}
+/**
+ * Options for handling a wallet verification challenge
+ */
+interface HandleWalletVerificationChallengeOptions<Setup extends AbstractSetupSchema> {
+  /** The portal client instance */
+  portalClient: GraphQLClient;
+  /** The GraphQL query builder */
+  portalGraphql: initGraphQLTada<Setup>;
+  /** The ID of the verification challenge */
+  verificationId: string;
+  /** The wallet address to verify */
+  userWalletAddress: Address;
+  /** The verification code provided by the user */
+  code: string | number;
+  /** The type of verification being performed */
+  verificationType: "otp" | "secret-code" | "pincode";
+}
+/**
+ * Handles a wallet verification challenge by generating an appropriate response
+ *
+ * @param options - The options for handling the wallet verification challenge
+ * @returns Promise resolving to an object containing the challenge response and optionally the verification ID
+ * @throws {ChallengeError} If the challenge cannot be created or is invalid
+ * @example
+ * import { createPortalClient } from "@settlemint/sdk-portal";
+ * import { handleWalletVerificationChallenge } from "@settlemint/sdk-portal";
+ *
+ * const { client, graphql } = createPortalClient({
+ *   instance: "https://portal.example.com/graphql",
+ *   accessToken: "your-access-token"
+ * });
+ *
+ * const result = await handleWalletVerificationChallenge({
+ *   portalClient: client,
+ *   portalGraphql: graphql,
+ *   verificationId: "verification-123",
+ *   userWalletAddress: "0x123...",
+ *   code: "123456",
+ *   verificationType: "otp"
+ * });
+ */
+declare function handleWalletVerificationChallenge<const Setup extends AbstractSetupSchema>({
+  portalClient,
+  portalGraphql,
+  verificationId,
+  userWalletAddress,
+  code,
+  verificationType
+}: HandleWalletVerificationChallengeOptions<Setup>): Promise<{
+  challengeResponse: string;
+  verificationId?: string;
+}>;
+
+//#endregion
+//#region src/portal.d.ts
+/**
+ * Configuration options for the GraphQL client, excluding 'url' and 'exchanges'.
+ */
+type RequestConfig = ConstructorParameters<typeof GraphQLClient>[1];
+/**
+ * Schema for validating Portal client configuration options.
+ */
+declare const ClientOptionsSchema: z.ZodObject<{
+  instance: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
+  accessToken: z.ZodOptional<z.ZodString>;
+  cache: z.ZodOptional<z.ZodEnum<{
+    default: "default";
+    "force-cache": "force-cache";
+    "no-cache": "no-cache";
+    "no-store": "no-store";
+    "only-if-cached": "only-if-cached";
+    reload: "reload";
+  }>>;
+}, z.core.$strip>;
+/**
+ * Type representing the validated client options.
+ */
+type ClientOptions = z.infer<typeof ClientOptionsSchema>;
+/**
+ * Creates a Portal GraphQL client with the provided configuration.
+ *
+ * @param options - Configuration options for the Portal client
+ * @param clientOptions - Additional GraphQL client configuration options
+ * @returns An object containing the configured GraphQL client and graphql helper function
+ * @throws If the provided options fail validation
+ *
+ * @example
+ * import { createPortalClient } from "@settlemint/sdk-portal";
+ * import { loadEnv } from "@settlemint/sdk-utils/environment";
+ * import { createLogger, requestLogger } from "@settlemint/sdk-utils/logging";
+ * import type { introspection } from "@schemas/portal-env";
+ *
+ * const env = await loadEnv(false, false);
+ * const logger = createLogger();
+ *
+ * const { client: portalClient, graphql: portalGraphql } = createPortalClient<{
+ *   introspection: introspection;
+ *   disableMasking: true;
+ *   scalars: {
+ *     // Change unknown to the type you are using to store metadata
+ *     JSON: unknown;
+ *   };
+ * }>(
+ *   {
+ *     instance: env.SETTLEMINT_PORTAL_GRAPHQL_ENDPOINT!,
+ *     accessToken: env.SETTLEMINT_ACCESS_TOKEN!,
+ *   },
+ *   {
+ *     fetch: requestLogger(logger, "portal", fetch) as typeof fetch,
+ *   },
+ * );
+ *
+ * // Making GraphQL queries
+ * const query = portalGraphql(`
+ *   query GetPendingTransactions {
+ *     getPendingTransactions {
+ *       count
+ *     }
+ *   }
+ * `);
+ *
+ * const result = await portalClient.request(query);
+ */
+declare function createPortalClient<const Setup extends AbstractSetupSchema>(options: ClientOptions, clientOptions?: RequestConfig): {
+  client: GraphQLClient;
+  graphql: initGraphQLTada<Setup>;
+};
+
+//#endregion
+export { ClientOptions, ClientOptionsSchema, FragmentOf, HandleWalletVerificationChallengeOptions, RequestConfig, ResultOf, Transaction, TransactionEvent, TransactionReceipt, VariablesOf, WaitForTransactionReceiptOptions, WebsocketClientOptions, createPortalClient, getWebsocketClient, handleWalletVerificationChallenge, readFragment, waitForTransactionReceipt };
+//# sourceMappingURL=portal.d.ts.map