Description

Fixes a fatal native crash on Android originating in rive-react-native's checklist Rive animation on the wallet home onboarding screen. Affects ~2.3K production users

Root cause was in the .riv asset not being fully aligned with the code. The wallet home checklist Rive onboard_checklist_v05.riv had inconsistent State Machine inputs across its three artboards:

• 01_Add_Funds and 02_First_Trade were missing the Main trigger input that the code fires via fireState('State Machine 1', 'Main').

When the code fired a name that didn't match, Rive threw StateMachineInputException. rive-react-native's native code doesn't clear the pending Java exception before its next JNI call, violating ART's JNI rules and aborting the process (SIGABRT / SIGSEGV depending on device).

Fix:

• Added missing Main trigger inputs to 01_Add_Funds and 02_First_Trade, wired to the Intro → Main transition.
• Renamed "Outro " to "Outro" on 03_Notifications.
• Re-exported as onboard_checklist_v06.riv.
• Bumped the import in WalletHomeOnboardingSteps.tsx from v05 to v06.

Verified locally: previously-crashing flows on emulator and arm64 physical device no longer crash, and the ~0.25s animation flicker observed on flagship devices is also gone.

Changelog

CHANGELOG entry: Fixed a native crash on Android affecting users on the wallet home onboarding screen.

Related issues

Fixes: #31103
#31103

Manual testing steps

Feature: Wallet home onboarding checklist Rive animation

  Scenario: User steps through the onboarding checklist
    Given the user has completed primary onboarding on a fresh install
    And the wallet home onboarding checklist is visible
    When the user taps Skip or Continue through fund / trade / notifications steps
    Then the checklist animation plays intro → main → outro on each step
    And the app does not crash

  Scenario: User navigates away from a step and returns
    Given the user is on the trade or notifications step
    When the user taps the Primary button and navigates to the destination screen
    And the user returns to the wallet home screen
    Then the checklist Rive resumes correctly
    And the app does not crash

Screenshots/Recordings

Before

After

Pre-merge author checklist

• I've followed MetaMask Contributor Docs and MetaMask Mobile Coding Standards.
• I've completed the PR template to the best of my ability
• I've included tests if applicable
• I've documented my code using JSDoc format if applicable
• I've applied the right labels on the PR (see labeling guidelines). Not required for external contributors.

Performance checks (if applicable)

• I've tested on Android
  • Ideally on a mid-range device; emulator is acceptable
• I've tested with a power user scenario
  • Use these power-user SRPs to import wallets with many accounts and tokens
• I've instrumented key operations with Sentry traces for production performance metrics
  • See trace() for usage and addToken for an example

For performance guidelines and tooling, see the Performance Guide.

Pre-merge reviewer checklist

• I've manually tested the PR (e.g. pull and build branch, run the app, test code being changed).
• I confirm that this PR addresses all acceptance criteria described in the ticket it closes and includes the necessary testing evidence such as recordings and or screenshots.