Overview
Use this section when you are integrating a Thru web app with the hosted embedded wallet at wallet.thru.org.
Start Here
Section titled “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.
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
Section titled “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 |
| Debug why a request or transaction flow failed | Troubleshooting | Explorer MCP |
What This Section Assumes
Section titled “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 use the wallet to approve connection and sign serialized transactions
- you will use
@thru/sdkor another client to actually submit signed transactions
Open Next
Section titled “Open Next”- Embedded Wallet Integration for the recommended integration path
- Approval and Signing before you design wallet status UI
- Troubleshooting when the wallet flow is present but not behaving as expected