RhinestoneDeposit Modal Docs
Back to Demo

01

Overview

@rhinestone/deposit-modal provides a production flow for deposit and withdraw into a Rhinestone smart account, with backend orchestration for bridging and status tracking.

User can either connect an EOA wallet directly or your app can pass an owner address (dappAddress) from an embedded/auth-managed wallet. The modal then creates or reuses a browser session owner key, sets up a deterministic smart account, enables sessions, and routes the transfer lifecycle through backend + processor.

What this docs section covers

1. Quickstart integration for both deposit and withdraw.

2. End-to-end architecture after the user transfer: backend validation, dedupe, processor intent execution, webhook storage, and status polling.

3. Failure/stuck handling paths: processor retries, failure events, modal timeout, and retry behavior.

Flow summary: wallet owner to local browser signer to smart account + session authorization to user transfer to backend/processor orchestration to webhook events to modal polling.