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.
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/react-sdk |
| Add wallet connect to a non-React dApp | Embedded Wallet Integration | @thru/browser-sdk or @thru/embedded-provider |
| Explain what the user sees during approval | Approval and Signing | @thru/protocol |
| 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 use the wallet to approve connection and sign serialized transactions
- you will use
@thru/thru-sdkor 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
- Troubleshooting when the wallet flow is present but not behaving as expected