Understanding user experience standards
Learn what good integration looks like
Demo environment and testing platform
using TON Foundation’s testing infrastructure
Testing your implementation
verify your basic integration works
Go-live procedure
what’s needed for production integrations
Support
get help
FAQ
frequently asked questions
Understanding user experience standards
Before building your integration, experience TON Connect as a user to understand what good integration looks like and what your users will expect.Try these wallets first
Use Tonkeeper or MyTonWallet to experience TON Connect. Both support mobile, desktop, and browser extensions. Wallet in Telegram demonstrates the UX for wallets implemented as Telegram Mini Apps.Basic flow experience
Open the React Demo dApp and connect one of these wallets. Notice how the connection works — desktop to mobile uses QR codes, mobile browser to wallet clicks directly, browser extensions connect instantly, and in-wallet browsers connect with one click. After connecting, try sending a basic transaction and test signing features like “Sign Text”. Pay attention to how transaction details are displayed, how approval works, and how errors are handled. This is the standard your users will expect from your wallet.Demo environment and testing platform
TON Foundation provides demo dApps and a comprehensive testing platform with all necessary test scenarios. You don’t need to create your own test cases — everything is already prepared.Demo dApps
We have a dApp for TON Connect testing, which is used in most test cases. In our testing platform it is called GENERAL. Additionally, there are several demo dApps used for testing specific scenarios, in our testing platform it is called CUSTOM. Keep in mind that each test case has a Description field indicating which dApp to use: GENERAL or CUSTOM.Testing platform
Our testing platform, Allure TestOps, contains manual test scenarios you execute yourself. Navigate to test suites matching your wallet’s platforms and run each test case manually. Observe all test scenarios via this link with these credentials:- Login:
guest - Password:
Test123!
| # | Test suite | Coverage |
|---|---|---|
| 1 | Common Checks | PR formatting, manifest validation, platform installation |
| 2 | Connection and Transaction Sending | Core functionality across platforms and dApps |
| 3 | Disconnection Testing | Session termination scenarios |
| 4 | Transaction Data Validation | Wallet-side security checks |
| 5 | Max Messages | Batch transaction handling |
| 6 | App Domain Validation | Security testing for TON Proof wallets |
| 7 | Extra Currency Support | Advanced currency features |
| 8 | Merkle Proof/Update | Advanced cryptographic operations |
| 9 | Sign data | Custom payload signing |
- Description: Which dApp to use GENERAL or CUSTOM along with its URL.
- Preconditions: What setup is needed before starting.
- Scenario: Manual actions to perform.
- Expected results: What should happen if your integration works correctly.
Testing your implementation
After building your integration, verify that it works with a basic connection test.Basic connection test
- Open the React Demo dApp
- Click “Connect Wallet” to see the connection modal
- Choose connection method:
- Scan universal QR code: Use your mobile wallet to scan the QR code (works with any TON Connect wallet)
- Find your wallet in the testing wallets list and click it for direct connection
- Complete the connection based on your wallet type (extension, mobile app, or web wallet)
- Try sending a simple transaction to confirm full functionality
Go-live procedure
Wallet submission
Submit a pull request to the wallet-list repository with your wallet manifest which was tested with the testing platform.Audit process
Once your team has opened a pull request to add the wallet to the official wallets-list repository on GitHub, please advise your BizDev liaison so an audit slot can be scheduled. A typical review cycle lasts three to five business days. During this period, TON Foundation engineers verify the TON Connect integration, assessing connection flows, transaction signing, security controls, error handling, and overall user experience across every supported platform. At the end of each iteration you will receive a written report that summarizes the test results. After you supply an updated build and a brief changelog, the engineering team performs a re-test under the same three-to-five-day service level.Release
When the audit is approved, the pull request moves to the maintainers’ queue for a final repository review. This check — focused on completeness of metadata and technical compliance — normally takes one business day. Once the pull request is merged, your wallet becomes discoverable to TON ecosystem dApps. Please keep the manifest endpoint continuously available and update the repository entry whenever you release significant changes to the wallet.Support
TON Foundation’s engineering team is available throughout the entire integration lifecycle – from design review to pre-production validation – to surface issues early and help you reach production smoothly. When you request support, please include the relevant following information so we can diagnose and resolve issues quickly:- Wallet platform and version: e.g., macOS 15.3.2, Chrome 137.0.7151.69, wallet version 1.2.3
- Issue summary: Brief description of the problem or the attached URL to the corresponding Allure scenario, if available, along with any questions related to it.
- Reproduction steps: Clear, step-by-step instructions (or sample requests/transactions) that consistently trigger the issue.