Push Protocol Notifications

WHAT IT DOES

Push Protocol Notifications gives developers, project teams, and community managers comprehensive tools for managing Push Protocol notification channels on-chain. It reads live on-chain data including Push Protocol channel state, notification records, subscriber lists, message history, delivery status, and channel metadata. You can create notification channels, send notifications, manage subscribers, and export channel data. The tool shows you in real time the channel name, owner, subscriber count, notification count, and active status—so you can build and manage your Web3 notification infrastructure effectively.

HOW TO USE

Connect your EVM wallet (must be the contract owner or authorized address). Enter the Push Protocol contract address, channel name, subscriber address, notification title and body, and channel metadata. Use "Check channel" to see your channel's name, owner, subscriber count, notification count, and active status. Click "Create channel" to register a new notification channel. Use "Send notification" to broadcast a message to all subscribers with a title and body. "Subscribe" and "Unsubscribe" manage channel subscriptions. "Export channel" downloads your channel data as JSON. Each action generates a transaction you review and sign in your wallet.

TECHNICAL APPROACH

This tool interacts with Push Protocol smart contracts using ethers v5.7.2. It calls createChannel(), sendNotification(), subscribe(), unsubscribe(), getChannel(), getSubscriberCount(), getNotificationCount(), and isSubscribed() on the Push contract to manage and query notification state. Channels are registered with a name and metadata, notifications are sent with title and body, and subscribers are tracked on-chain. All RPC calls are wrapped in a robust error handler that extracts the actual failure reason from Ethers error objects, digging three levels deep to avoid showing "[object Object]" when a transaction reverts. Transaction costing uses receipt.effectiveGasPrice post-EIP-1559 rather than tx.gasPrice, which overstates actual spend.

WHAT IT CANNOT SEE

This tool cannot verify off-chain message delivery or guarantee that notifications are received by subscribers. It cannot detect if a notification was read or if the subscriber's wallet received the notification. It cannot see off-channel notification data not stored on-chain. It cannot guarantee that subscribers are active or that the channel metadata is accurate. The tool provides Push Protocol notification management based on on-chain data, but it does not guarantee that notifications are delivered or that the subscriber list is complete.

PLEASE NOTE

This tool supports EVM‑compatible chains only (Ethereum, Goerli, Sepolia, Arbitrum, Optimism, Polygon). Solana, Tron, Starknet, SUI, TON, Aptos, Bitcoin, Cosmos, and XRP are not supported. This is a read‑write tool that requires signing transactions—always verify the Push Protocol contract address, channel name, and notification content before approving. No contract addresses are hardcoded; you paste the contracts you are managing. The tool is free and open under the BotGentz PLAYBOOK‑C specification.