User Guidelines

To ensure a smooth and secure experience when using applications integrated with the zkPass TransGate-SDK, please refer to the following platform-specific instructions and recommendations.

🖥️ Desktop (Windows / macOS)

Recommended Setup:

  • Browser: Latest version of Google Chrome or Brave

  • Wallet: MetaMask browser extension (ensure it is installed, unlocked, and connected)

Usage Instructions:

Option1: Install the TransGate on Google Extension Store

  1. Open the application link in your browser.

  2. When prompted, approve the wallet connection via MetaMask.

  3. Grant permissions for pop-ups and cross-site cookies (if disabled, verification flow may be blocked).

  4. Log in the data source like usual, zkPass verification will run in-browser; please do not close the tab during the process.

Option2: Scan the QR Code and finish the process on mobile. 👇

📱 iOS (iPhone)

✅ Instant Access via App Clip (No App Installation Required)

zkPass SDK is fully supported through Apple’s App Clip experience, offering a seamless and secure verification process with no installation needed.

Instructions:

  1. Open the zkPass-integrated dApp link in Safari or scan the associated QR code.

  2. An App Clip card will appear — tap “Open” to launch the zkPass verification flow.

  3. You will be guided through wallet connection and data verification within the App Clip environment.

  4. Complete the process and return to the main dApp. No persistent app or background services will remain.

Requirements:

  • iOS 14.3 or later

  • Safari or camera access (for QR codes)

  • Ensure App Clips are enabled under iOS Settings → App Clips

📱 Android Devices

Required: Install TransGate App from Google Play Store

On Android, zkPass SDK operates via a native client—TransGate—to ensure secure communication and proof generation.

✅ Recommended Method: Chrome Browser + MetaMask Mobile App

  1. Open the application link in Chrome or another Chromium-based browser.

  2. Upon wallet connection request, select MetaMask or via WalletConnect.

  3. Approve all requests in MetaMask and return to the original browser tab to complete verification.

⚠️ MetaMask In-App Browser (Android):

  • Due to system-level restrictions, MetaMask’s in-app browser does not fully support dApp redirects or advanced authentication features.

  • Use a standalone browser for better stability.

  1. Open Mise Browser Download Mise from https://mise.xyz if you haven't already.

  2. Go to the Extension Page Open this link in Mise: 👉 TransGate on Chrome Web Store

  3. Click "Add to Chrome" Confirm the prompt and wait for the installation to finish.

  4. Verify Installation After installation, you should see the TransGate icon in the top-right corner of your browser. Visit any zkPass-supported page to start using it.

Last updated