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)
When you’re setting up a wallet, be sure to:
✅ Download and install only the latest version from their official source.
✅ Back up and keep your recovery phrases safe.
❌ Never share your recovery phrases with anyone, under any circumstances.
Usage Instructions:
Option1: Install the TransGate on Google Extension Store
Please kindly note that DON’T install any Transgate Extensions obtained from third-party channels. This measure ensures that all installed extensions have undergone proper vetting and are up to our standards. Stick to official link and protect your personal accounts securely.
IMPORTANT!
Please refrain from installing extensions from third-party sources. We cannot take responsibility for any problems that may occur as a result of installing such extensions. Stick to zkPass official link and trusted sources for a secure browsing experience.
Open the application link in your browser.
When prompted, approve the wallet connection via MetaMask.
Grant permissions for pop-ups and cross-site cookies (if disabled, verification flow may be blocked).
Log in the data source like usual, zkPass verification will run in-browser; please do not close the tab during the process.
Notes:
Ad blockers or privacy extensions may interfere with wallet communication. Disable them temporarily if issues occur.
Refresh the page if any UI components fail to load after connecting.
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:
Open the zkPass-integrated dApp link in Safari or scan the associated QR code.
An App Clip card will appear — tap “Open” to launch the zkPass verification flow.
You will be guided through wallet connection and data verification within the App Clip environment.
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
Notes:
Wallet connection will be handled in-session. MetaMask or WalletConnect will be triggered as needed.
All processes are sandboxed and privacy-preserving per Apple’s App Clip policies.
📱 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
Open the application link in Chrome or another Chromium-based browser.
Upon wallet connection request, select MetaMask or via WalletConnect.
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.
The TransGate Android app currently supports Android 12 and above. If your device isn’t compatible, using the Mise + TransGate extension is the recommended alternative below:
Open Mise Browser Download Mise from https://mise.xyz if you haven't already.
Go to the Extension Page Open this link in Mise: 👉 TransGate on Chrome Web Store
Click "Add to Chrome" Confirm the prompt and wait for the installation to finish.
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.
Important Reminder: to ensure the efficient use of computational and gas resources, it is advisable not to use multiple addresses to attest the same schema with the same account. Doing so will overwrite previous attestations, resulting in unnecessary resource consumption without yielding additional rewards.
Last updated