Introduction

Welcome to the documentation for Pulsar 🚀 - TUWA’s comprehensive solution for creating world-class transaction tracking experiences in your Web3 applications.

The Challenge

Building a great Web3 user experience goes far beyond just submitting transactions to the blockchain. Modern dApp users expect:

• Real-time updates on their transaction status.
• Clear visual feedback, from pending to confirmation.
• Robust error handling with actionable retry options.
• Multi-chain support across different networks.
• Beautiful interfaces that don’t feel like developer tools.

Building this tracking infrastructure manually is complex, time-consuming, and distracts from your core product features. Different wallet types, transaction replacements, network congestion, and cross-chain operations create a maze of edge cases that are difficult to handle correctly.

Our Solution: Pulsar

Pulsar transforms transaction tracking from a complex technical challenge into a simple integration. We provide everything you need to deliver a seamless, professional transaction experience with just a few lines of code.

🏗️ Architecture Overview

Our modular, adapter-based approach gives you maximum flexibility while maintaining simplicity:

┌────────── @tuwaio/pulsar-core ──────────┐
│ • Headless engine powered by Zustand    │
│ • Persistent transaction history      │
│ • Adapter-based architecture            │
└─────────────────────────────────────────┘
                      │
          ┌───────────┴───────────┐
          │                       │
┌─────────▼─────────┐   ┌─────────▼──────────┐
│ @tuwaio/pulsar-evm│   │ @tuwaio/pulsar-react │
│ • EVM Adapter     │   │ • React hooks for    │
│ • Safe Tracker    │   │   easy integration   │
│ • Gelato Tracker  │   └────────────────────┘
└───────────────────┘             │
                                  │
                  ┌───────────────▼───────────────┐
                  │ @tuwaio/nova-transactions (UI)│
                  │ • Pre-built modals            │
                  │ • Status components           │
                  └───────────────────────────────┘

✨ Key Features

🧠 Intelligent Core Engine

• Headless Architecture: Use with any UI framework or build your own from scratch.
• TypeScript-First: Full type safety and an excellent developer experience.
• Persistent State: Transaction history survives page reloads.
• Zustand-Powered: Lightweight, fast, and predictable state management.

⛓️ Flexible Chain Support

• All EVM Networks: Ethereum, Polygon, Arbitrum, Base, Optimism, and more via @tuwaio/pulsar-evm.
• Adapter Architecture: Easily extendable to support other ecosystems like Solana, Starknet, etc.
• Multi-Tracker Support: Handles standard transactions, Gelato meta-transactions, and Safe multi-sig.

🎨 Beautiful UI Components by Nova

• Out-of-the-Box Solutions: @tuwaio/nova-transactions provides a complete UI suite.
• Smart Notifications: Non-intrusive toasts with real-time updates.
• Detailed Modals: In-depth progress tracking with retry and speed-up capabilities.
• Simple Integration: Hooks from @tuwaio/pulsar-react make connecting the UI to the Pulsar core effortless.

🎯 Developer Experience

• One-Line Integration: Get started in minutes, not hours.
• Wallet Agnostic: Works seamlessly with RainbowKit, ConnectKit, and any other wagmi-based setup.
• Fully Customizable: Match your brand with CSS variables and component overrides.
• Production-Ready: Battle-tested with proper error handling and edge case coverage.

📦 Package Overview

🎯 Perfect For

• DeFi Protocols: DEXs, lending platforms, yield farming interfaces.
• NFT Marketplaces: Minting, trading, and auction platforms.
• Gaming dApps: In-game transactions and asset management.
• DAO Interfaces: Governance voting and treasury management.
• Any Web3 App that needs a professional transaction UX.

What’s Next?

Ready to transform your transaction experience? Here’s your journey:

1. Getting Started  - Set up Pulsar in your project.
2. Quick Start  - Build your first tracked transaction.
3. API Reference  - Dive deep into customization options.

Built with ❤️ by the TUWA Team