Skip to main content

Onboarding & KYC

First launch: sign in with Privy, provision a wallet, complete Bridge KYC. All subsequent app features gate on kyc.status === "approved".

Sequence

Screens

  • apps/mobile/app/login.tsx — email + OAuth entry point.
  • apps/mobile/app/kyc.tsx — collects name + email, opens Bridge link, polls status.
  • apps/mobile/app/_layout.tsxAuthGate chooses which screen to show based on session + KYC state.

Notes

  • Privy handles the wallet creation on their side. The mobile app receives an already-deployed smart wallet address; no on-chain action is needed here.
  • KYC data (documents, selfies) is submitted directly to Bridge via their hosted URL — GrinGo never sees or stores it.
  • kyc.status becomes approved via the customer.updated webhook. The mobile poll of GET /kyc/status is a UX convenience.