@@ -59,18 +59,20 @@ class IMMUTABLE_API UImmutablePassport : public UObject
5959
6060 /* *
6161 * Initialises passport. This sets up the Passport instance, configures the web browser, and waits for the ready signal.
62- * @param InitData Parameters to initialise the passport with.
63- * @param ResponseDelegate Callback delegate.
62+ *
63+ * @param InitData Parameters to initialise the passport with.
64+ * @param ResponseDelegate Callback delegate.
6465 */
6566 void Initialize (const FImmutablePassportInitData& InitData, const FImtblPassportResponseDelegate& ResponseDelegate);
6667
6768 /* *
6869 * Logs the user into Passport via device code auth and sets up the Immutable X provider.
70+ *
6971 * This will open the user's default browser and take them through Passport login.
70- * @param IsConnectImx If true, the "re-connect" method is used to authenticate into Passport with Immutable X.
71- * Else, "re-login" is used for authentication. To access a wallet with Immutable X or zkEVM later, you must call "Connect" again with this value set to true, or use "ConnectEvm."
72- * @param TryToRelogin If true, the game bridge will use a cached session to re-connect or re-login the user, avoiding the need for a web browser. If this attempt fails, it will fall back to device code authentication.
73- * @param ResponseDelegate Callback delegate.
72+ * @param IsConnectImx If true, the "re-connect" method is used to authenticate into Passport with Immutable X.
73+ * Else, "re-login" is used for authentication. To access a wallet with Immutable X or zkEVM later, you must call "Connect" again with this value set to true, or use "ConnectEvm."
74+ * @param TryToRelogin If true, the game bridge will use a cached session to re-connect or re-login the user, avoiding the need for a web browser. If this attempt fails, it will fall back to device code authentication.
75+ * @param ResponseDelegate Callback delegate.
7476 */
7577 void Connect (bool IsConnectImx, bool TryToRelogin, const FImtblPassportResponseDelegate& ResponseDelegate);
7678#if PLATFORM_ANDROID | PLATFORM_IOS | PLATFORM_MAC
@@ -79,9 +81,10 @@ class IMMUTABLE_API UImmutablePassport : public UObject
7981
8082 /* *
8183 * Logs the user out of Passport.
82- * @param DoHardLogout If true, clears sessions and any stored credentials from both the SDK/plugin and the browser.
83- * Else, clears session and any stored credentials from the SDK only, browser session and stored credentials are cleared when session expires.
84- * @param ResponseDelegate Callback delegate.
84+ *
85+ * @param DoHardLogout If true, clears sessions and any stored credentials from both the SDK/plugin and the browser.
86+ * Else, clears session and any stored credentials from the SDK only, browser session and stored credentials are cleared when session expires.
87+ * @param ResponseDelegate Callback delegate.
8588 */
8689 void Logout (bool DoHardLogout, const FImtblPassportResponseDelegate& ResponseDelegate);
8790
@@ -141,30 +144,35 @@ class IMMUTABLE_API UImmutablePassport : public UObject
141144
142145 /* *
143146 * Gets the currently saved ID token without verifying its validity.
147+ *
144148 * @param ResponseDelegate Callback delegate.
145149 */
146150 void GetIdToken (const FImtblPassportResponseDelegate& ResponseDelegate);
147151
148152 /* *
149153 * Gets the currently saved access token without verifying its validity.
154+ *
150155 * @param ResponseDelegate Callback delegate.
151156 */
152157 void GetAccessToken (const FImtblPassportResponseDelegate& ResponseDelegate);
153158
154159 /* *
155160 * Gets the wallet address of the logged in user.
161+ *
156162 * @param ResponseDelegate Callback delegate.
157163 */
158164 void GetAddress (const FImtblPassportResponseDelegate& ResponseDelegate);
159165
160166 /* *
161167 * Retrieves the email address of the user whose credentials are currently stored.
168+ *
162169 * @param ResponseDelegate Callback delegate.
163170 */
164171 void GetEmail (const FImtblPassportResponseDelegate& ResponseDelegate);
165172
166173 /* *
167174 * Gets the list of external wallets the user has linked to their Passport account via the
175+ *
168176 * @param ResponseDelegate Callback delegate.
169177 */
170178 void GetLinkedAddresses (const FImtblPassportResponseDelegate& ResponseDelegate);
@@ -212,22 +220,28 @@ class IMMUTABLE_API UImmutablePassport : public UObject
212220
213221 /* *
214222 * Retrieves the "result" as string field from Response.JsonObject.
215- * @param Response The response to use to retrieve the "result" as string field.
216- * @return The "result" as string field from Response.JsonObject if Response.JsonObject is valid, otherwise, an empty string.
223+ *
224+ * @param Response The response to use to retrieve the "result" as string field.
225+ *
226+ * @return The "result" as string field from Response.JsonObject if Response.JsonObject is valid, otherwise, an empty string.
217227 */
218228 static FString GetResponseResultAsString (const FImtblJSResponse& Response);
219229
220230 /* *
221231 * Retrieves the "result" as bool field from Response.JsonObject.
222- * @param Response The response to use to retrieve the "result" as bool field.
223- * @return True if Response.JsonObject is valid, otherwise, false.
232+ *
233+ * @param Response The response to use to retrieve the "result" as bool field.
234+ *
235+ * @return True if Response.JsonObject is valid, otherwise, false.
224236 */
225237 static bool GetResponseResultAsBool (const FImtblJSResponse& Response);
226238
227239 /* *
228240 * Retrieves the "result" as array field from Response.JsonObject and extracting them into an array of FString.
229- * @param Response The response to use to retrieve and extract.
230- * @return An array of FString extracted from the "result" field if Response.JsonObject is valid, otherwise, an empty array.
241+ *
242+ * @param Response The response to use to retrieve and extract.
243+ *
244+ * @return An array of FString extracted from the "result" field if Response.JsonObject is valid, otherwise, an empty array.
231245 */
232246 static TArray<FString> GetResponseResultAsStringArray (const FImtblJSResponse& Response);
233247
@@ -249,75 +263,88 @@ class IMMUTABLE_API UImmutablePassport : public UObject
249263
250264 /* *
251265 * Calls JavaScript function to the connected browser with specified parameters.
252- * @param Action The name of the JavaScript action to be called.
253- * @param Data The data to be passed to the JavaScript action as FString.
254- * @param ClientResponseDelegate Delegate to handle the response from the client.
255- * @param HandleJSResponse Delegate to handle the response from the JavaScript function.
256- * @param bCheckInitialized (Optional) If true, check if the passport is initialised. Else, initialised checks are skipped.
266+ *
267+ * @param Action The name of the JavaScript action to be called.
268+ * @param Data The data to be passed to the JavaScript action as FString.
269+ * @param ClientResponseDelegate Delegate to handle the response from the client.
270+ * @param HandleJSResponse Delegate to handle the response from the JavaScript function.
271+ * @param bCheckInitialized (Optional) If true, check if the passport is initialised. Else, initialised checks are skipped.
257272 */
258273 void CallJS (const FString& Action, const FString& Data, const FImtblPassportResponseDelegate& ClientResponseDelegate, const FImtblJSResponseDelegate& HandleJSResponse, const bool bCheckInitialized = true );
259274
260275 /* *
261276 * Sets up passport with the JavaScript connector
277+ *
262278 * @param Connector A weak pointer to the JavaScript Connector. If the connector is invalid set up will be aborted.
263279 */
264280 void Setup (TWeakObjectPtr<class UImtblJSConnector > Connector);
265281
266282 /* *
267283 * Reinstate the connection based on the provided JavaScript response.
284+ *
268285 * @param Response The JavaScript response object to reinstate the connection.
269286 */
270287 void ReinstateConnection (FImtblJSResponse Response);
271288
272289 /* *
273290 * Checks if the passport has been initialised before allowing an action to proceed.
274- * @param Action The name of the JavaScript action to be called. Used for logging purposes.
275- * @param ResponseDelegate Delegate to handle the response if the passport is not initialised.
276- * @return True if the passport is initialised, otherwise, false.
291+ *
292+ * @param Action The name of the JavaScript action to be called. Used for logging purposes.
293+ * @param ResponseDelegate Delegate to handle the response if the passport is not initialised.
294+ *
295+ * @return True if the passport is initialised, otherwise, false.
277296 */
278297 bool CheckIsInitialized (const FString& Action, const FImtblPassportResponseDelegate& ResponseDelegate) const ;
279298
280299 /* *
281300 * Retrieves the response delegate associated with a given JavaScript response from ResponseDelegates TMap.
282- * @param Response The Javascript response object containing the request Id.
283- * @return A TOptional containing the response delegate if found, otherwise, an empty TOptional.
301+ *
302+ * @param Response The Javascript response object containing the request Id.
303+ *
304+ * @return A TOptional containing the response delegate if found, otherwise, an empty TOptional.
284305 */
285306 TOptional<FImtblPassportResponseDelegate> GetResponseDelegate (const FImtblJSResponse& Response);
286307
287308 /* *
288309 * Confirms the device code by calling the appropriate JavaScript action.
289- * @param DeviceCode The device code to be confirmed.
290- * @param Interval The time interval to wait between attempts.
291- * @param ResponseDelegate A delegate to handle the response from the confirmation request.
310+ *
311+ * @param DeviceCode The device code to be confirmed.
312+ * @param Interval The time interval to wait between attempts.
313+ * @param ResponseDelegate A delegate to handle the response from the confirmation request.
292314 */
293315 void ConfirmCode (const FString& DeviceCode, const float Interval, const FImtblPassportResponseDelegate& ResponseDelegate);
294316
295317 /* *
296318 * Common callback that handles the responses from game bridge
319+ *
297320 * @param Response The JavaScript response object containing the result of the callback.
298321 */
299322 void OnBridgeCallbackResponse (FImtblJSResponse Response);
300323
301324 /* *
302325 * Callback from init (passport).
326+ *
303327 * @param Response The JavaScript response object containing the result of the callback.
304328 */
305329 void OnInitializeResponse (FImtblJSResponse Response);
306330
307331 /* *
308332 * Callback from init device flow (device code auth login flow).
333+ *
309334 * @param Response The JavaScript response object containing the result of the callback.
310335 */
311336 void OnInitDeviceFlowResponse (FImtblJSResponse Response);
312337
313338 /* *
314339 * Callback from logout.
340+ *
315341 * @param Response The JavaScript response object containing the result of the callback.
316342 */
317343 void OnLogoutResponse (FImtblJSResponse Response);
318344
319345 /* *
320346 * Callback from confirm code.
347+ *
321348 * @param Response The JavaScript response object containing the result of the callback.
322349 */
323350 void OnConfirmCodeResponse (FImtblJSResponse Response);
@@ -338,20 +365,24 @@ class IMMUTABLE_API UImmutablePassport : public UObject
338365
339366 /* *
340367 * Sets the specified state flags by applying a bitwise OR operation.
368+ *
341369 * @param StateIn The state flags to be set.
342370 */
343371 void SetStateFlags (uint8 StateIn);
344372
345373 /* *
346374 * Resets the specified state flags by applying a bitwise AND operation with the negated flags.
375+ *
347376 * @param StateIn The state flags to be reset.
348377 */
349378 void ResetStateFlags (uint8 StateIn);
350379
351380 /* *
352381 * Checks if the specified state flags are set.
353- * @param StateIn The state flags to check.
354- * @return True if all StateIn flags are set, otherwise, false.
382+ *
383+ * @param StateIn The state flags to check.
384+ *
385+ * @return True if all StateIn flags are set, otherwise, false.
355386 */
356387 bool IsStateFlagsSet (uint8 StateIn) const ;
357388
0 commit comments