Skip to main content

How to test the TridentGold app

Use the assigned TestFlight build on iOS to try the sandbox credential journey below. You will receive a synthetic credential, approve a presentation, and see the result in the hosted verifier demo.

Test builds and credentials are for testing only. The police certificate in this journey, which the app lists as Police Certificate of Character, is a synthetic fixture, not an official certificate.

The steps and screen labels below match the current TestFlight build. If you are on an older build and the screens do not match, ask your testing contact for the current build.

What you need​

  • A physical iPhone with TestFlight and access to the assigned TridentGold build.
  • A one-time sandbox credential code. You can get one yourself from the test credential page, or ask your testing contact for one.
  • An internet connection during issuance, status refresh, and presentation.
  • A browser for the verifier demo, on the phone or on another screen.

The testing contact will confirm the app version and build for this journey. An older TestFlight build may support accounts but lack these credential features.

Install on iPhone​

  1. Install Apple's TestFlight app from the App Store if needed.
  2. Open the TridentGold tester invitation supplied by your testing contact.
  3. In TestFlight, accept the invitation and install the assigned build.
  4. Open TridentGold and follow the account setup or sign-in prompts.

If the assigned build is not visible, ask the contact to check your invitation and release availability. Uploading a build does not make it immediately available to external testers.

Get a code yourself​

The sandbox gives out test credential codes without a person in the loop. Each code is for a made-up police certificate that describes no real person.

  1. Open the test credential page. On the iPhone itself is easiest, so you can paste the code into the app.
  2. Tap Get a test credential code.
  3. Tap Copy, then continue with the next section straight away. A code works once and expires after a few minutes. If it expires, get a new one.

Each network can get a few codes an hour, and the sandbox gives out a limited number each day. If the page asks you to wait, try again later or ask your testing contact for a code instead. Keep a code to yourself until you have used it.

Receive a test credential​

  1. In the app's wallet, tap Add credential. The button is on the card headed Add a passport or Trident ID; it also leads to the invitation-code option. If you hold a passport or Trident ID, use the + button at the top of the wallet instead.
  2. On Add a credential, under Invitation code, tap Enter code.
  3. Paste or type the code into Invitation code, using the code from the test credential page or the one your testing contact supplied privately. Do not enter your name, passport details, or real identity information.
  4. Tap Get credential and follow any device-unlock prompts. Keep the app open while it checks your code, prepares your credential, and saves it to your wallet.
  5. Open the stored credential and tap Refresh under Credential status. When the status reads Active and ready to use, the credential is ready for the presentation test.

You do not need a passport or an NFC scan for this journey.

Once partner-defined credentials are available in the sandbox, a partner organization testing its own credential type may give you a code for a Sandbox credential instead. Enter it the same way. The app shows a Sandbox badge on that credential and names TridentGold ZKNC Sandbox Issuer as its issuer: it is a synthetic sandbox credential defined by that organization and issued by the TridentGold ZKNC Sandbox Issuer. The rest of this page uses the police certificate from the test credential page.

Present to the verifier​

  1. Open the credential verifier demo in your browser.
  2. Choose Present a ZKNC credential to create a fresh request.
  3. Scan its QR code with the app, using the scan button at the top of the app, which opens Scan a TridentGold code. On the same phone, tap Open the TridentGold app on this device instead.
  4. In TridentGold, on Check before you share, review who is asking, why they are asking, what is Shared with them, and what is Proved without sharing. Tap Cancel if anything is unexpected. Otherwise, tap Share.
  5. Keep the app open while it prepares and sends the proof. The app shows Shared when the verifier accepts it. Return to the original browser tab to see Credential verified or the rejection.

The QR code opens an online request; it does not contain the credential or proof. Requests expire. If a request has expired or was already opened, start another from the demo page.

Install on Android​

Android testing is a separate track for the account experience. The credential journey above is iOS only in this release: Android is deferred throughout, and every piece of device evidence behind this release was produced on iPhone. Confirm the assigned build and supported flows with your testing contact before starting.

  1. On the phone, confirm that the Play Store is signed in with the approved Google account. Ask the testing contact to add it to the tester list first.
  2. Open the TridentGold Google Play internal-testing invitation.
  3. Tap Become a tester.
  4. Tap Download it on Google Play, then Install.

The installed app is named TridentGold.

Updates​

New iOS test builds appear in TestFlight. New Android builds arrive as normal Play Store updates. If an expected update is not visible, refresh the store page and allow time for a newly published build to finish processing.

Troubleshooting​

  • The Play Store says “Item not found” or will not load the page. In the Play Store, open the profile menu and confirm that the selected account is the one on the tester list. A fresh build may also take a few hours to appear.
  • Google Play says you are not eligible. Ask the testing contact to confirm that your Play Store account is on the approved tester list.
  • The TestFlight invitation will not open. Install TestFlight first, then reopen the invitation on the iPhone.
  • The app will not install or launch. Record the visible error, phone model, operating-system version, and app build number if available. Do not send account or credential data.

Report feedback safely​

Describe the steps you took, what you expected, what happened, the phone model, operating-system version, app build number, and approximate time. A screenshot is helpful only after checking that it contains no sensitive information.

Never include invitation codes, identity claims, passport photos or document numbers, credentials, account identifiers, recovery phrases, passkeys, tokens, QR payloads, or other private data in feedback.

See The current sandbox for what testers, issuers, verifiers, and relying parties can do today, and What works today for the current integration scope.