FIP: Set notification status using the Miniapp SDK

[vrypan]

Title: Set notification status using the Miniapp SDK
Type: Standards FIP
Author: @vrypan
Status: Idea

Abstract

This FIP describes tow extension to sdk.actions that give Miniapps more control to set/change the notification status.

Problem

sdk.actions.addMiniApp prompts the user to "Add to Farcasetr" and "Enable notifications". Then a user can use the miniapp menu to add/remove the miniapp and turn notifications on/off.

sdk.context.client gives visibility to the status of the app (added/not added, notifications enabled/disabled) but there is no way to ask a user to change these settings.

For example:

• If a user has added the app, the app has no way to offer them a way to turn off notifications.
• If a user has added the app, but has turned notifications off, the app has no way to prompt them to turn notifications on.

An other issue is many users have developed the habit of rejecting "Add to Farcaster" because they do not want to add more notifications to their notifications feed before understanding why the app needs them.

Specification

1. Extend sdk.actions.addMiniApp

Add an optional notifications: bool parameter to sdk.actions.addMiniApp() with default value true.

• sdk.actions.addMiniApp(notifications=false) will prompt the user to "Add to Farcaster"
• sdk.actions.addMiniApp(notifications=true) will prompt the user to "Add to Farcaster" and "Enable notifications"

2. New sdk.actions.setNotifications()

sdk.actions.setNotifications(status: bool), allows a miniapp to prompt the user to turn notifications on/off.

When called, the user will be prompted to enable/disable notifications (modal similar to addMiniApp().

If the app is not added to Farcaster, sdk.actions.setNotifications(status=true) will trigger a modal to "Add to Farcaster" and "Enable Notifications". In this case sdk.actions.setNotifications(status=true) will have the same result as sdk.actions.addMiniApp(notifications=true).