--- name: minipay-integration description: Build Mini Apps for MiniPay wallet. Use when building applications for MiniPay, detecting MiniPay wallet, or creating mobile-first dApps for Celo. license: Apache-2.0 metadata: author: celo-org version: "1.0.0" --- # MiniPay Integration This skill covers building Mini Apps for MiniPay, the fastest growing non-custodial wallet in the Global South with 10M+ activations. ## When to Use - Building Mini Apps for MiniPay - Detecting MiniPay wallet in your dApp - Creating mobile-first payment applications - Integrating with MiniPay's discovery page ## What is MiniPay? MiniPay is a stablecoin wallet with a built-in Mini App discovery page. It's available as: - Built into Opera Mini browser (Android) - Standalone app (Android and iOS) Key features: - Phone number mapping to wallet addresses - Sub-cent transaction fees - 2MB lightweight footprint - Supports USDm (cUSD), USDC, and USDT ## Quick Start ### Create a MiniPay App ```bash npx @celo\/celo-composer@latest create -t minipay ``` This scaffolds a Next.js app pre-configured for MiniPay. ## Detecting MiniPay Check if the user is using MiniPay: ```typescript function isMiniPay(): boolean { return typeof window !== "undefined" && window.ethereum?.isMiniPay === true; } ``` **Important:** This code must run in a browser environment, not Node.js. ## Connecting Wallet MiniPay automatically injects the wallet. Request account access: ```typescript async function connectWallet(): Promise { if (typeof window === "undefined" || !window.ethereum) { return null; } const accounts = await window.ethereum.request({ method: "eth_requestAccounts", params: [], }); return accounts[0] || null; } ``` **Important:** Hide the "Connect Wallet" button when inside MiniPay - the connection is implicit. ```typescript const [address, setAddress] = useState(null); const inMiniPay = isMiniPay(); useEffect(() => { if (inMiniPay) { connectWallet().then(setAddress); } }, [inMiniPay]); return (

{!inMiniPay && (