Skip to main content

Unreal SDK Reference

Immutable's Unreal SDK reference covers all publicly available Unreal SDK methods, enabling you to easily integrate Passport into your Unreal-based game.

Information includes method descriptions, parameters and return types.
sdk referencesdk reference
💡WHO IS THIS FOR?
Developers building a game in Unreal.

Initialize

Initialises Passport. This sets up the Passport instance, configures the web browser, and waits for the ready signal.

Method parameters


FImmutablePassportInitDataInitDataREQUIRED

Parameters to initialise the Passport with.

FImtblPassportResponseDelegateResponseDelegateREQUIRED

The response delegate of type FImtblPassportResponseDelegate to call on response from JS.

Returns


void

No return value.


Connect

Logs the user into Passport via Device Code Authorisation. This will open the user's default browser and take them through the Passport login flow.

Method parameters


boolIsConnectImxREQUIRED

If true, uses the "re-connect" method to authenticate with Immutable X. Otherwise, uses "re-login" for authentication. To access a wallet with Immutable X or zkEVM later, you must either call Connect again with this set to true or use ConnectEvm, respectively. Please set this value to false for use on Immutable zkEVM.

boolTryToReloginREQUIRED

If true, attempts to re-connect or re-login the user using a cached session, avoiding the need to open a web browser. If this fails, it will fall back to Device Code Authorisation.

FImtblPassportResponseDelegateResponseDelegateREQUIRED

The response delegate of type FImtblPassportResponseDelegate to call on response from JS.

Returns


void

No return value.


ConnectPKCE

(Android, iOS, and macOS only) Logs into Passport using Authorization Code Flow with Proof Key for Code Exchange (PKCE).

Method parameters


boolIsConnectImxREQUIRED

If true, the game bridge will use a cached session to re-connect or re-login the user, avoiding the need to open a web browser. If this attempt fails, it will fall back to Device Code Authorisation. Please set this value to false for use on Immutable zkEVM.

FImtblPassportResponseDelegateResponseDelegateREQUIRED

The response delegate of type FImtblPassportResponseDelegate to call on response from JS.

Returns


void

No return value.


Logout

Logs the user out of Passport.

Method parameters


boolDoHardLogoutREQUIRED

If true, clears sessions and any stored credentials from both the SDK/plugin and the browser. Otherwise, only clears session and credentials from the SDK, leaving the browser session.

FImtblPassportResponseDelegateResponseDelegateREQUIRED

The response delegate of type FImtblPassportResponseDelegate to call on response from JS.

Returns


void

No return value.


ConnectEvm

Initializes the zkEVM provider.

Method parameters


FImtblPassportResponseDelegateResponseDelegateREQUIRED

The response delegate of type FImtblPassportResponseDelegate to call on response from JS.

Returns


void

No return value.


ZkEvmRequestAccounts

Authenticates the user and initializes their Passport wallet before returning an array of wallet addresses. Must be called before other zkEVM functions.

Method parameters


FImtblPassportResponseDelegateResponseDelegateREQUIRED

The response delegate of type FImtblPassportResponseDelegate to call on response from JS.

Returns


void

No return value.


ZkEvmGetBalance

Returns the balance of the account of the given address in wei.

Method parameters


FImmutablePassportZkEvmGetBalanceDataDataREQUIRED

The address and block number for the request.

FImtblPassportResponseDelegateResponseDelegateREQUIRED

The response delegate of type FImtblPassportResponseDelegate to call on response from JS.

Returns


void

No return value.


ZkEvmSendTransaction

Creates new message call transaction or a contract creation, if the data field contains code.

Method parameters


FImtblTransactionRequestRequestREQUIRED

The transaction request data.

FImtblPassportResponseDelegateResponseDelegateREQUIRED

The response delegate of type FImtblPassportResponseDelegate to call on response from JS.

Returns


void

No return value.


ZkEvmSendTransactionWithConfirmation

Similar to ZkEvmSendTransaction. Creates new message call transaction or a contract creation, if the data field contains code, and signs it using the account specified in from. Additionally, it also resolves to the FZkEvmTransactionReceipt once the transaction has been included in the chain for confirms blocks. If confirms is 0, and the transaction has not been mined, null is returned. The callback response data may contain the receipt of the transaction or null if it is still processing.

Method parameters


FImtblTransactionRequestRequestREQUIRED

The transaction request data.

FImtblPassportResponseDelegateResponseDelegateREQUIRED

The response delegate of type FImtblPassportResponseDelegate to call on response from JS.

Returns


void

No return value.


ZkEvmGetTransactionReceipt

Retrieves the transaction information of a given transaction hash. This function uses the Ethereum JSON-RPC eth_getTransactionReceipt method. Response will contain the receipt of the transaction or null if it is still processing.

Method parameters


FZkEvmTransactionReceiptRequestRequestREQUIRED

The request data(Hash) to perform the transaction.

FImtblPassportResponseDelegateResponseDelegateREQUIRED

The response delegate of type FImtblPassportResponseDelegate to call on response from JS.

Returns


void

No return value.


GetIdToken

Gets the currently saved ID token without verifying its validity.

Method parameters


FImtblPassportResponseDelegateResponseDelegateREQUIRED

The response delegate of type FImtblPassportResponseDelegate to call on response from JS.

Returns


void

No return value.


GetAccessToken

Gets the currently saved access token without verifying its validity.

Method parameters


FImtblPassportResponseDelegateResponseDelegateREQUIRED

The response delegate of type FImtblPassportResponseDelegate to call on response from JS.

Returns


void

No return value.


GetEmail

Retrieves the email address of the user whose credentials are currently stored.

Method parameters


FImtblPassportResponseDelegateResponseDelegateREQUIRED

The response delegate of type FImtblPassportResponseDelegate to call on response from JS.

Returns


void

No return value.


GetLinkedAddresses

Gets the list of external wallets the user has linked to their Passport account via the Dashboard.

Method parameters


FImtblPassportResponseDelegateResponseDelegateREQUIRED

The response delegate of type FImtblPassportResponseDelegate to call on response from JS.

Returns


void

No return value.


HasStoredCredentials

Checks if the user's credentials have been stored.

Method parameters


FImtblPassportResponseDelegateResponseDelegateREQUIRED

The response delegate of type FImtblPassportResponseDelegate to call on response from JS.

Returns


void

No return value.


ZkEvmSignTypedDataV4

Generates a signature for a typed data V4 object. Signs the EIP-712 structured message in JSON string format using the logged-in Passport account.

Method parameters


FStringRequestJsonStringREQUIRED

The EIP-712 structured data in JSON string format.

FImtblPassportResponseDelegateResponseDelegateREQUIRED

The response delegate of type FImtblPassportResponseDelegate to call on response from JS.

Returns


void

No return value.