coinbase / coinbase/onchainkit

Feature Request: Add first-class transaction status polling hook with configurable confirmations

Open
#2,565 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
TypeScript
Stars
1k
Forks
520
Avg merge
32m
Merged PRs (30d)
2

Description

### Describe the solution you'd like

After submitting a transaction, applications typically need to:
- poll for transaction confirmation
- handle dropped or replaced transactions
- wait for a configurable number of confirmations
- surface intermediate states in the UI

## Expected Behavior
- Developers can track transaction lifecycle using a simple hook.
- Confirmation depth (e.g., 1, 2, N confirmations) is configurable.
- Hook handles common edge cases (dropped, replaced, timeout).

### Describe alternatives you've considered.

Proposed Solution

- Introduce a useTransactionStatus hook that:
- polls transaction receipt and block confirmations
- exposes standardized status values (pending, confirmed, failed, dropped)
- supports configurable confirmation depth and polling interval
- Detect and surface replaced or dropped transactions.
- Integrate cleanly with existing OnchainKit provider configuration.

Contributor guide

No contributing guide indexed for this repository

Research direction

No file or test is named. Start by reading the existing OnchainKit provider configuration and transaction-related hook entry points to understand current patterns. Done means a documented useTransactionStatus hook exposes pending, confirmed, failed, and dropped states, supports configurable confirmations and polling, and handles replacement and timeout cases.

Written by the indexing model from the issue text.

Assessment

Tech stack
react, typescript
Domain
frontend
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.