release: dev → main (KYC poll backoff + cleanups)

src/app/(mobile-ui)/notifications/page.tsx

@@ -9,7 +9,7 @@
 import { formatGroupHeaderDate, getDateGroup, getDateGroupKey } from '@/utils/dateGrouping.utils'
 import React, { useEffect, useMemo, useRef, useState } from 'react'
 import Image from 'next/image'
-import { PEANUTMAN_LOGO } from '@/assets'
+import { PEANUTMAN } from '@/assets'
 import Link from 'next/link'
 import EmptyState from '@/components/Global/EmptyStates/EmptyState'
 import { Button } from '@/components/0_Bruddle/Button'
@@ -61,7 +61,7 @@
         return () => {
             if (element) observer.unobserve(element)
         }
     }, [nextPageCursor, isLoadingMore])
 
     const loadNextPage = async () => {
         // load the next page when the sentinel enters the viewport
@@ -172,7 +172,7 @@
                                                     onClick={() => handleNotificationClick(notif.id)}
                                                 >
                                                     <Image
-                                                        src={notif.iconUrl ?? PEANUTMAN_LOGO}
+                                                        src={notif.iconUrl ?? PEANUTMAN}
                                                         alt="icon"
                                                         width={32}
                                                         height={32}

src/app/(mobile-ui)/qr-pay/__tests__/qr-pay-states.test.tsx

@@ -48,7 +48,7 @@
     default: (props: any) => {
         // next/image uses 'fill' boolean; strip non-DOM props
         const { priority, layout, objectFit, fill, ...rest } = props
         return <img {...rest} />
     },
 }))
 
@@ -81,7 +81,7 @@
 
 // The page imports PeanutThinking from @/assets/mascot and STAR_STRAIGHT_ICON
 // from @/assets/icons directly — mock those paths, not the @/assets barrel, and
-// keep sibling exports (e.g. PEANUTMAN_LOGO, ETHEREUM_ICON used by QRScanner) intact.
+// keep sibling exports (e.g. PEANUTMAN, ETHEREUM_ICON used by QRScanner) intact.
 jest.mock('@/assets/mascot', () => ({
     ...jest.requireActual('@/assets/mascot'),
     PeanutThinking: '/peanut-guy.gif',

src/app/dev/loading-words/page.tsx

@@ -1,6 +1,6 @@
 'use client'
 
-import { PEANUTMAN_LOGO } from '@/assets/mascot'
+import { PEANUTMAN } from '@/assets/mascot'
 import { PAYMENT_LOADING_WORDS } from '@/components/Global/PeanutLoading/words'
 import { useEffect, useState } from 'react'
 
@@ -41,7 +41,7 @@ export default function LoadingWordsPreview() {
                     </h2>
                     <div className="flex flex-col items-center justify-center gap-6 rounded-sm border border-n-1 bg-primary-3 px-6 py-16 shadow-[4px_4px_0_0_#000]">
                         <div className="animate-spin">
-                            <img src={PEANUTMAN_LOGO.src} alt="Peanut" className="h-10 w-10" />
+                            <img src={PEANUTMAN.src} alt="Peanut" className="h-10 w-10" />
                         </div>
                         <LoadingMessage word={WORDS[index]} className="text-base font-medium" />
                     </div>

src/assets/illustrations/index.ts

@@ -8,7 +8,6 @@ export { default as HandThumbsUpV2 } from './hand-thumbs-up-v2.svg'
 export { default as HandToken } from './new-hand-token.svg'
 export { default as AboutPeanut } from './new-hero-description.svg'
 //export { default as PeanutArmHoldingBeer } from './peanut-arm-holding-beer.svg'
-export { default as PEANUT_LOGO_BLACK } from './peanut-logo-dark.svg'
 export { default as PeanutsBG } from './peanuts-bg.svg'
 export { default as Sparkle } from './sparkle.svg'
 export { default as Star } from './star.svg'

src/assets/logos/index.ts

@@ -1,4 +1,5 @@
 export { default as PEANUT_LOGO } from './peanut-logo.svg';
+export { default as PEANUT_LOGO_BLACK } from './peanut-logo-dark.svg';
 export { default as MEPA_ARGENTINA_LOGO } from './mepa-arg.svg';
 export { default as PIX_BRZ_LOGO } from './pix-brz.svg';
 export { default as DEVCONNECT_LOGO } from './devconnect.svg';

src/assets/mascot/index.ts

@@ -15,7 +15,7 @@ export { default as PeanutWalking } from './peanut-walking.webp' // mid-stride,
 export { default as PeanutPointingDown } from './peanut-pointing-down.webp' // both hands pointing down — marketing CTA
 
 // Stills
-export { default as PEANUTMAN_LOGO } from './peanut-logo.svg'
+export { default as PEANUTMAN } from './peanutman.svg'
 export { default as PEANUTMAN_PFP } from './peanut-pfp.svg'
 export { default as PEANUTMAN_HOLDING_BEER } from './peanut-beer.svg'
 export { default as PEANUTMAN_MOBILE } from './peanut-club.webp'

src/components/AddWithdraw/AddWithdrawCountriesList.tsx

@@ -34,6 +34,7 @@ import { railJurisdictionForBank } from '@/utils/bridge.utils'
 import { getRegionIntent } from '@/utils/regions.utils'
 import { useTosGuard } from '@/hooks/useTosGuard'
 import { BridgeTosStep } from '@/components/Kyc/BridgeTosStep'
+import ProvideEmailStep from '@/components/Kyc/ProvideEmailStep'
 import { useModalsContext } from '@/context/ModalsContext'
 import underMaintenanceConfig, { PIX_BRAZIL_ONRAMP_MAINTENANCE } from '@/config/underMaintenance.config'
 
@@ -126,6 +127,7 @@ const AddWithdrawCountriesList = ({ flow }: AddWithdrawCountriesListProps) => {
     const bankCountry = useMemo(() => railJurisdictionForBank(currentCountry?.id), [currentCountry?.id])
     const gate = useMemo(() => gateFor('deposit', { channel: 'bank', country: bankCountry }), [gateFor, bankCountry])
     const { guardWithTos, showBridgeTos, hideTos } = useTosGuard()
+    const [showProvideEmail, setShowProvideEmail] = useState(false)
     const { setIsSupportModalOpen } = useModalsContext()
 
     // stores the callback to replay after tos acceptance in the list view
@@ -149,6 +151,8 @@ const AddWithdrawCountriesList = ({ flow }: AddWithdrawCountriesListProps) => {
                 if (gate.kind === 'accept-tos') {
                     pendingAfterTosRef.current = onAfterTos ?? null
                     guardWithTos()
+                } else if (gate.kind === 'provide-email') {
+                    setShowProvideEmail(true)
                 } else {
                     setIsKycModalOpen(true)
                 }
@@ -178,6 +182,11 @@ const AddWithdrawCountriesList = ({ flow }: AddWithdrawCountriesListProps) => {
             }
             if (gate.kind === 'accept-tos') {
                 guardWithTos()
+            } else if (gate.kind === 'provide-email') {
+                // A rail that flipped to email-blocked between form-open and submit
+                // is self-serve — open the email sheet, NOT the contact-support KYC
+                // modal (mirrors checkBridgeGate; the whole point of provide-email).
+                setShowProvideEmail(true)
             } else {
                 setIsKycModalOpen(true)
             }
@@ -379,6 +388,11 @@ const AddWithdrawCountriesList = ({ flow }: AddWithdrawCountriesListProps) => {
                 onSkip={hideTos}
                 reasonCode={gate.kind === 'accept-tos' ? gate.reason?.code : undefined}
             />
+            <ProvideEmailStep
+                visible={showProvideEmail}
+                onComplete={() => setShowProvideEmail(false)}
+                onSkip={() => setShowProvideEmail(false)}
+            />
             <SumsubKycModals flow={sumsubFlow} />
         </>
     )

src/components/AddWithdraw/__tests__/AddWithdrawCountriesList.test.tsx

@@ -160,6 +160,10 @@ jest.mock('@/components/AddWithdraw/DynamicBankAccountForm', () => ({ DynamicBan
 jest.mock('@/components/Global/TokenAndNetworkConfirmationModal', () => ({ __esModule: true, default: () => null }))
 jest.mock('@/components/Kyc/SumsubKycModals', () => ({ SumsubKycModals: () => null }))
 jest.mock('@/components/Kyc/BridgeTosStep', () => ({ BridgeTosStep: () => null }))
+jest.mock('@/components/Kyc/ProvideEmailStep', () => ({
+    __esModule: true,
+    default: (props: any) => (props.visible ? <div data-testid="provide-email-sheet" /> : null),
+}))
 jest.mock('@/components/Kyc/InitiateKycModal', () => ({
     InitiateKycModal: (props: any) => (props.visible ? <div data-testid="initiate-kyc-modal" /> : null),
 }))
@@ -235,6 +239,22 @@ describe('AddWithdrawCountriesList — bank gate', () => {
         expect(mockPush).not.toHaveBeenCalled()
         expect(screen.getByTestId('initiate-kyc-modal')).toBeInTheDocument()
     })
+
+    // provide-email is a self-serve gate (one email unblocks the rail) — it must
+    // open the email sheet, NEVER the contact-support KYC modal. Both the click
+    // gate (checkBridgeGate) and the form-submit gate (handleFormSubmit) must
+    // route it there; a missing branch on the submit path turned self-serve
+    // recovery into a support ticket (2026-07 review finding).
+    it('an email-blocked gate opens the provide-email sheet, not the contact-support KYC modal', () => {
+        setCapabilities('provide-email', [{ status: 'blocked', channel: 'bank', country: 'US' }])
+
+        render(<AddWithdrawCountriesList flow="add" />)
+        fireEvent.click(screen.getByTestId('method-bank'))
+
+        expect(screen.getByTestId('provide-email-sheet')).toBeInTheDocument()
+        expect(screen.queryByTestId('initiate-kyc-modal')).toBeNull()
+        expect(mockPush).not.toHaveBeenCalled()
+    })
 })
 
 /**

src/components/Badges/badge.utils.ts

@@ -9,7 +9,7 @@
 // Codes here must match the backend registry (peanut-api-ts
 // src/acknowledgments/seed-definitions.ts). How the whole system works + how to
 // add a badge: peanut-api-ts/docs/BADGES.md.
-import { PEANUTMAN_LOGO } from '@/assets/mascot'
+import { PEANUTMAN } from '@/assets/mascot'
 
 export type BadgeMeta = {
     path: string
@@ -245,7 +245,7 @@ export const BADGE_CODES: readonly string[] = Object.keys(BADGES)
 export function getBadgeIcon(code?: string): string {
     // .src: the svg import is StaticImageData (typed `any` by the module shim, so the
     // annotation alone can't enforce this) — raw <img src> consumers need a string URL.
-    return (code && BADGES[code]?.path) || PEANUTMAN_LOGO.src
+    return (code && BADGES[code]?.path) || PEANUTMAN.src
 }
 
 // returns the public-facing description for a badge code (third-person perspective)

src/components/Card/CardFace.tsx

@@ -4,7 +4,7 @@ import Image from 'next/image'
 import { twMerge } from 'tailwind-merge'
 import { Icon } from '@/components/Global/Icons/Icon'
 import { PEANUT_CARD_HAND, VISA_BRAND_MARK } from '@/assets/cards'
-import { PEANUTMAN_LOGO } from '@/assets/mascot'
+import { PEANUTMAN } from '@/assets/mascot'
 
 export interface RevealedCardDetails {
     pan: string
@@ -86,7 +86,7 @@ const CardFace: FC<Props> = ({
             <div className="relative flex h-full w-full flex-col p-4">
                 {/* Top row: peanut icon (no wordmark) + Visa */}
                 <div className="flex items-start justify-between">
-                    <Image src={PEANUTMAN_LOGO} alt="" aria-hidden className="h-10 w-auto" />
+                    <Image src={PEANUTMAN} alt="" aria-hidden className="h-10 w-auto" />
                     <Image src={VISA_BRAND_MARK} alt="Visa" className="h-6 w-auto brightness-0 invert" />
                 </div>
 

src/components/Card/share-asset/PixelatedCardFace.tsx

@@ -23,11 +23,11 @@
 
 import { type FC, type CSSProperties } from 'react'
 import { CARD_W, CARD_H } from './shareAssetLayout'
-import { PEANUTMAN_LOGO } from '@/assets/mascot'
+import { PEANUTMAN } from '@/assets/mascot'
 import PEANUT_CARD_HAND_PIXEL_ASSET from '@/assets/cards/peanut-card-hand-pixel.png'
 import VISA_BRAND_MARK_ASSET from '@/assets/cards/visa-brand-mark.png'
 
-const ASSET_PEANUTMAN_LOGO = PEANUTMAN_LOGO.src
+const ASSET_PEANUTMAN = PEANUTMAN.src
 const ASSET_VISA_BRAND = VISA_BRAND_MARK_ASSET.src
 const ASSET_CARD_HAND_PIXEL = PEANUT_CARD_HAND_PIXEL_ASSET.src
 
@@ -93,9 +93,9 @@ export const PixelatedCardFace: FC<PixelatedCardFaceProps> = ({
                 style={{ top: 24, left: 28, right: 28, zIndex: 2 }}
             >
                 {blurAll ? (
-                    <PixelatedImg src={ASSET_PEANUTMAN_LOGO} displayW={52} displayH={52} />
+                    <PixelatedImg src={ASSET_PEANUTMAN} displayW={52} displayH={52} />
                 ) : (
-                    <img src={ASSET_PEANUTMAN_LOGO} alt="" aria-hidden style={{ height: 52, width: 'auto' }} />
+                    <img src={ASSET_PEANUTMAN} alt="" aria-hidden style={{ height: 52, width: 'auto' }} />
                 )}
                 {!hideVisa &&
                     (blurAll ? (

src/components/Claim/Link/Initial.view.tsx

@@ -42,7 +42,7 @@ import { evmChainIdToRhinoName } from '@/constants/rhino.consts'
 import { getTokenSymbol } from '@/utils/general.utils'
 import { Button } from '@/components/0_Bruddle/Button'
 import Image from 'next/image'
-import { PEANUT_LOGO_BLACK, PEANUTMAN_LOGO } from '@/assets'
+import { PEANUT_LOGO_BLACK, PEANUTMAN } from '@/assets'
 import { GuestVerificationModal } from '@/components/Global/GuestVerificationModal'
 import { useCapabilities } from '@/hooks/useCapabilities'
 import MantecaFlowManager from './MantecaFlowManager'
@@ -822,7 +822,7 @@ export const InitialClaimLinkView = (props: IClaimScreenProps) => {
                 <div className="flex items-center gap-1">
                     <div>Receive on </div>
                     <div className="flex items-center gap-1">
-                        <Image src={PEANUTMAN_LOGO} alt="Peanut Logo" className="size-5" />
+                        <Image src={PEANUTMAN} alt="Peanut Logo" className="size-5" />
                         <Image src={PEANUT_LOGO_BLACK} alt="Peanut Logo" />
                     </div>
                 </div>

src/components/Claim/Link/SendLinkActionList.tsx

@@ -25,10 +25,10 @@ import { useContext, useMemo, useState } from 'react'
 import ActionModal from '@/components/Global/ActionModal'
 import Divider from '../../0_Bruddle/Divider'
 import { Button } from '@/components/0_Bruddle/Button'
-import { PEANUT_LOGO_BLACK } from '@/assets/illustrations'
+import { PEANUT_LOGO_BLACK } from '@/assets/logos'
 import Image from 'next/image'
 import { useRouter } from 'next/navigation'
-import { PEANUTMAN_LOGO } from '@/assets/mascot'
+import { PEANUTMAN } from '@/assets/mascot'
 import { BankClaimType, useDetermineBankClaimType } from '@/hooks/useDetermineBankClaimType'
 import useSavedAccounts from '@/hooks/useSavedAccounts'
 import { tokenSelectorContext } from '@/context'
@@ -243,7 +243,7 @@ export default function SendLinkActionList({
                 >
                     {showDevconnectMethod ? <div>Claim on</div> : <div>Continue with </div>}
                     <div className="flex items-center gap-1">
-                        <Image src={PEANUTMAN_LOGO} alt="Peanut Logo" className="size-5" />
+                        <Image src={PEANUTMAN} alt="Peanut Logo" className="size-5" />
                         <Image src={PEANUT_LOGO_BLACK} alt="Peanut Logo" />
                     </div>
                 </Button>

src/components/Global/ConfirmInviteModal/index.tsx

@@ -1,7 +1,7 @@
 'use client'
 import { type FC } from 'react'
 import Image from 'next/image'
-import { PEANUT_LOGO_BLACK, PEANUTMAN_LOGO } from '@/assets'
+import { PEANUT_LOGO_BLACK, PEANUTMAN } from '@/assets'
 import Modal from '../Modal'
 import { Button } from '@/components/0_Bruddle/Button'
 import { PeanutWavingHello } from '@/assets/mascot'
@@ -52,7 +52,7 @@ const ConfirmInviteModal: FC<ConfirmInviteModalProps> = ({
                         <Button className="w-full" shadowSize="4" variant="purple" onClick={handleContinueWithPeanut}>
                             <div>Join</div>
                             <div className="flex items-center gap-1">
-                                <Image src={PEANUTMAN_LOGO} alt="Peanut Logo" className="size-5" />
+                                <Image src={PEANUTMAN} alt="Peanut Logo" className="size-5" />
                                 <Image src={PEANUT_LOGO_BLACK} alt="Peanut Logo" />
                             </div>
                         </Button>

src/components/Global/CreateAccountButton/index.tsx

@@ -1,6 +1,6 @@
 'use client'
 
-import { PEANUT_LOGO_BLACK, PEANUTMAN_LOGO } from '@/assets'
+import { PEANUT_LOGO_BLACK, PEANUTMAN } from '@/assets'
 import { Button } from '@/components/0_Bruddle/Button'
 import Image from 'next/image'
 
@@ -13,7 +13,7 @@ const CreateAccountButton = ({ onClick }: CreateAccountButtonProps) => {
         <Button onClick={onClick} shadowSize="4">
             <div>Create a</div>
             <div className="flex items-center gap-1">
-                <Image src={PEANUTMAN_LOGO} alt="Peanut Logo" className="size-5" />
+                <Image src={PEANUTMAN} alt="Peanut Logo" className="size-5" />
                 <Image src={PEANUT_LOGO_BLACK} alt="Peanut Logo" />
             </div>
             <div>account</div>

src/components/Global/NoMoreJailModal/index.tsx

@@ -3,7 +3,7 @@ import { useEffect, useState } from 'react'
 import posthog from 'posthog-js'
 import { ANALYTICS_EVENTS, MODAL_TYPES } from '@/constants/analytics.consts'
 import Image from 'next/image'
-import { PEANUT_LOGO_BLACK, PEANUTMAN_LOGO } from '@/assets'
+import { PEANUT_LOGO_BLACK, PEANUTMAN } from '@/assets'
 import Modal from '../Modal'
 import { Button } from '@/components/0_Bruddle/Button'
 import { PeanutWhistling } from '@/assets/mascot'
@@ -55,7 +55,7 @@ const NoMoreJailModal = () => {
                     <Button className="w-full" shadowSize="4" variant="purple" onClick={onClose}>
                         <div>Start using</div>
                         <div className="flex items-center gap-1">
-                            <Image src={PEANUTMAN_LOGO} alt="Peanut Logo" className="size-5" />
+                            <Image src={PEANUTMAN} alt="Peanut Logo" className="size-5" />
                             <Image src={PEANUT_LOGO_BLACK} alt="Peanut Logo" />
                         </div>
                     </Button>

src/components/Global/PeanutLoading/CyclingLoading.tsx

@@ -1,6 +1,6 @@
 'use client'
 
-import { PEANUTMAN_LOGO } from '@/assets/mascot'
+import { PEANUTMAN } from '@/assets/mascot'
 import { useEffect, useState } from 'react'
 import { PAYMENT_LOADING_WORDS } from './words'
 
@@ -26,7 +26,7 @@ export default function CyclingLoading() {
         <div className="w-full flex-col items-center justify-center self-center text-center">
             <div className="flex w-full items-center justify-center self-center">
                 <div className="animate-spin">
-                    <img src={PEANUTMAN_LOGO.src} alt="logo" className="h-10" />
+                    <img src={PEANUTMAN.src} alt="logo" className="h-10" />
                     <span className="sr-only">{word}</span>
                 </div>
             </div>

src/components/Global/PeanutLoading/index.tsx

@@ -1,4 +1,4 @@
-import { PEANUTMAN_LOGO } from '@/assets'
+import { PEANUTMAN } from '@/assets'
 import { twMerge } from 'tailwind-merge'
 
 export default function PeanutLoading({
@@ -18,7 +18,7 @@ export default function PeanutLoading({
                 )}
             >
                 <div className={twMerge('animate-spin')}>
-                    <img src={PEANUTMAN_LOGO.src} alt="logo" className="h-10" />
+                    <img src={PEANUTMAN.src} alt="Peanut mascot" className="h-10" />
                     <span className="sr-only">{message ?? 'Loading...'}</span>
                 </div>
             </div>

src/components/Global/QRScanner/index.tsx

@@ -1,7 +1,7 @@
 import { createPortal } from 'react-dom'
 import { Button } from '@/components/0_Bruddle/Button'
 import { MERCADO_PAGO, PIX } from '@/assets/payment-apps'
-import { PEANUTMAN_LOGO } from '@/assets/mascot'
+import { PEANUTMAN } from '@/assets/mascot'
 import { ETHEREUM_ICON } from '@/assets/icons'
 import Image from 'next/image'
 import { Icon } from '../Icons/Icon'
@@ -14,7 +14,7 @@ import CameraPermissionModal from './CameraPermissionModal'
 // ============================================================================
 
 const PAYMENT_METHODS = [
-    { src: PEANUTMAN_LOGO, alt: 'Peanut', name: 'Peanut' },
+    { src: PEANUTMAN, alt: 'Peanut', name: 'Peanut' },
     { src: MERCADO_PAGO, alt: 'Mercado Pago', name: 'Mercado Pago' },
     { src: PIX, alt: 'PIX', name: 'PIX' },
     { src: ETHEREUM_ICON, alt: 'Ethereum and EVMs', name: 'ETH & EVMs' },