coinbase / coinbase/onchainkit

Documentation Request: Clarify how loading and pending states are exposed by OnchainKit hooks

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

Description

### Is your documentation request related to a problem? Please describe.

## Overview
OnchainKit hooks often involve asynchronous wallet and onchain interactions, but it is not always clear how loading or pending states are represented or how long those states should be expected to last.

## Problem Description
Developers may be unsure when an action is considered “in progress” versus “completed” or “failed.” This uncertainty can lead to inconsistent UI states or premature user interactions.

## Expected Behavior
Loading and pending states should be clearly documented so developers understand when actions are actively processing and when it is safe to update UI or trigger follow-up actions.

## Proposed Solution
Add concise documentation describing the lifecycle of common OnchainKit hooks, including how and when loading or pending states are set and cleared.

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.