Installation
Install the TAC SDK using your preferred package manager:Basic Import and Setup
Import the core SDK components you’ll need for your application:Environment Configuration
Network Selection
The SDK supports both testnet and mainnet environments. Always start development on testnet:Always test your integration thoroughly on testnet before deploying to
mainnet. Cross-chain operations are irreversible once confirmed.
Environment Variables
For security, store sensitive configuration in environment variables:Framework Integration
React Integration
For React applications, wrap the SDK in a context provider:Next.js Integration
For Next.js applications, handle client-side initialization:Vue.js Integration
For Vue applications, create a composable:TON Connect Integration
For browser applications, integrate with TON Connect for wallet connectivity:Install TON Connect
Configure TON Connect
TON Connect Manifest
Create a manifest file for your application:TypeScript Configuration
If using TypeScript, ensure yourtsconfig.json
includes proper module resolution:
SDK Configuration Options
The SDK accepts several configuration options during initialization:Configuration Options Reference
Configuration Options Reference
Network Options:
Network.TESTNET
- For development and testingNetwork.MAINNET
- For production applications
delay
- Delay between operations in milliseconds (default: 1000)
contractOpener
- Custom TonClient instance for TON operationssettingsAddress
- Custom settings contract address
provider
- Custom provider for TAC operationssettingsAddress
- Custom settings contract address
Verification
Test your installation with a simple initialization:Common Issues and Solutions
Module Resolution Errors
Module Resolution Errors
If you encounter module resolution errors, ensure you’re using a modern bundler that supports ES modules:Webpack 5:Vite:
Network Connection Issues
Network Connection Issues
If you experience network connection issues:
-
Check your network configuration:
- Verify firewall settings - Ensure your environment can access TON and TAC endpoints
- Use environment-specific configuration - Different environments may require different endpoints
TypeScript Type Errors
TypeScript Type Errors
For TypeScript type errors:
-
Install type definitions:
-
Update your tsconfig.json:
-
Use explicit imports:
Next Steps
With the SDK installed and configured, you’re ready to start building hybrid dApps:SDK Initialization
Learn how to properly initialize and configure the SDK
Wallet Integration
Connect TON wallets and manage user authentication
Start with the Quick Start guide to send your first
cross-chain transaction and see the SDK in action.