Skip to content

SDK 8.0.0 Release Notes

Latest

Choose a tag to compare

@eric-notifi eric-notifi released this 25 Mar 07:42
· 3 commits to main since this release

⚠️ Breaking Changes

1. Unified Error Handling with NotifiErrornotifi-frontend-client, notifi-react

Mutation methods now properly throw errors when the backend returns payload errors. Previously, these errors were silently ignored.

Affected methods:

  • deleteAlerts
  • ensureFusionAlerts
  • verifyCbwTarget
  • verifyXmtpTargetViaXip42
  • createWebPushTarget
  • updateWebPushTarget
  • deleteWebPushTarget

Migration: Wrap calls in try/catch where needed:

try {
  await client.deleteAlerts({ ids: alertIds });
} catch (error) {
  if (error instanceof NotifiValidationError) {
    // Handle validation error
  }
}

Details: #953, #976

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:

  • broadcastMessage
  • connectWallet
  • createDirectPushAlert / deleteDirectPushAlert
  • sendMessage
  • getConfigurationForDapp
  • getConnectedWallets
  • getFilters

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 signArbitrary optimization
  • Unit test coverage for CARDANO_SIGN_MESSAGE authentication (#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 QueryClient re-instantiation on every render (MVP-6787)
  • Fixed Rules of Hooks violation — forEach hook calls in hookCreators statically unrolled (MVP-6788)
  • Fixed loading state leak for Keplr and Phantom wallets (MVP-6790, MVP-6791)
  • Replaced module-level mutable timer with useRef for correct React lifecycle management (MVP-6792)
  • Removed global Buffer override 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)