Overview

Use this section when you are integrating a Thru web app with the hosted embedded wallet at wallet.thru.org.

Start Here

Embedded Wallet Integration Set up the wallet in a web app, choose the right package layer, and wire `connect()` plus `signTransaction()` correctly.

Approval and Signing Understand the request lifecycle for connect and transaction signing, including cached reconnects, approval modals, and dApp UX expectations.

Signing Sessions Create, use, list, confirm, and revoke temporary wallet-owned signing sessions for repeated actions.

Troubleshooting Debug wallet integration failures such as origin issues, stalled approval flows, malformed transaction payloads, and transactions that never reach explorer.

Choose The Right Page

If your task is…	Open this page	Then open…
Add wallet connect to a React dApp	Embedded Wallet Integration	@thru/wallet with @thru/wallet/react
Add wallet connect to a non-React dApp	Embedded Wallet Integration	@thru/wallet
Explain what the user sees during approval	Approval and Signing	@thru/wallet protocol exports
Add a temporary signer for repeated app actions	Signing Sessions	@thru/wallet signing session APIs
Debug why a request or transaction flow failed	Troubleshooting	Explorer MCP

What This Section Assumes

• you are integrating the hosted wallet iframe rather than building a custom wallet
• your web app can reach https://wallet.thru.org/embedded
• you will send wallet-managed transaction intents to the wallet for approval and signing
• you will use @thru/sdk or another client to actually submit signed transactions

Open Next

• Embedded Wallet Integration for the recommended integration path
• Approval and Signing before you design wallet status UI
• Signing Sessions when an app needs temporary approval for repeated actions
• Troubleshooting when the wallet flow is present but not behaving as expected