⚠️ Breaking Changes
1. Unified Error Handling with NotifiError — notifi-frontend-client, notifi-react
Mutation methods now properly throw errors when the backend returns payload errors. Previously, these errors were silently ignored.
Affected methods:
deleteAlertsensureFusionAlertsverifyCbwTargetverifyXmtpTargetViaXip42createWebPushTargetupdateWebPushTargetdeleteWebPushTarget
Migration: Wrap calls in try/catch where needed:
try {
await client.deleteAlerts({ ids: alertIds });
} catch (error) {
if (error instanceof NotifiValidationError) {
// Handle validation error
}
}2. WalletKeys Type Renames — notifi-wallet-provider
The following types have been renamed to better reflect their blockchain scope. No runtime impact — TypeScript types only.
| Old Name | New Name |
|---|---|
MetamaskWalletKeys |
EvmWalletKeys |
KeplrWalletKeys |
CosmosWalletKeys |
PhantomWalletKeys |
SolanaWalletKeys |
LaceWalletKeys |
CardanoWalletKeys |
Migration: Update import references accordingly:
// Before
import { Types } from '@notifi-network/notifi-wallet-provider';
type MyKeys = Types.MetamaskWalletKeys;
// After
import { Types } from '@notifi-network/notifi-wallet-provider';
type MyKeys = Types.EvmWalletKeys;Details: #976
3. Removal of Dead GraphQL Endpoints — notifi-graphql
The following long-deprecated endpoints have been permanently removed from NotifiService:
broadcastMessageconnectWalletcreateDirectPushAlert/deleteDirectPushAlertsendMessagegetConfigurationForDappgetConnectedWalletsgetFilters
Migration: Remove any direct calls to these methods. They have been non-functional on the backend for some time.
Details: #977
4. Removal of Xion Wallet Support — notifi-wallet-provider
The useXion hook and all Xion-related types and utilities have been removed.
Migration: If you were using Xion wallet integration, please migrate to an alternative supported wallet.
Details: #969
5. Wagmi Dependency Updated to v3+ — notifi-wallet-provider
Migration: If your project uses wagmi or WalletConnect alongside notifi-wallet-provider, ensure your project's wagmi dependency is also updated to v3+.
Details: #969
⚙️ New Features
Cardano Wallet Support — notifi-wallet-provider
Full Cardano wallet support is now available:
- Lace wallet integration (#938)
- Additional Cardano wallets: External, NuFi, OKX, Yoroi, Ctrl (#944)
- Cardano signing strategy and
signArbitraryoptimization - Unit test coverage for
CARDANO_SIGN_MESSAGEauthentication (#946)
🔧 Enhancements
Target Deletion Behavior — notifi-react, notifi-frontend-client
The "Remove" CTA on target list items now deletes the target rather than merely unlinking it, providing a cleaner and more intuitive UX. Applies to Telegram, Discord, and Wallet targets.
Details: #962
notifi-wallet-provider — Critical Stability & Hook Fixes (#976)
- Fixed
QueryClientre-instantiation on every render (MVP-6787) - Fixed Rules of Hooks violation —
forEachhook calls inhookCreatorsstatically unrolled (MVP-6788) - Fixed loading state leak for Keplr and Phantom wallets (MVP-6790, MVP-6791)
- Replaced module-level mutable
timerwithuseReffor correct React lifecycle management (MVP-6792) - Removed global
Bufferoverride to reduce side effects (MVP-6793) - Updated README with wagmi / WalletConnect Project ID configuration guide
notifi-react — UI Customization
- Custom icons set in Admin Portal are now correctly displayed in the Inbox History View (#950)
- NavTab components now expose a dedicated CSS class for easier style overrides (#949)
- TopicStack errors are now contained at the card level, preventing app-level crashes (#951)
🔒 Security
- Reduced npm dependency vulnerabilities; remaining issues are non-actionable upstream transitive dependencies (lerna, nx, webpack, xmtp) (#966)