Quickstart

The fastest way to bootstrap a TAC project is using our CLI tool:

npx create-tac-app my-tac-project

This creates a new directory with a fully configured TAC project including:

• Smart contracts with proxy implementation
• Frontend with TAC SDK integration
• TON wallet connection setup
• Cross-chain messaging examples

Make sure you have the required tools and accounts:

• Node.js v18.0.0 or higher
• Blockchain Accounts:
  • Ethereum wallet with testnet TAC tokens for deployment
  • TON wallet for testing (Tonkeeper or TON Space recommended)
• Get Testnet Tokens:
  • TAC tokens: TAC Testnet Faucet

Navigate to the contracts directory and deploy to TAC testnet:

cd my-tac-project/contracts
npm install
npx hardhat run scripts/deploy.js --network tacTestnet

Take note of the deployed addresses:

• SimpleMessage contract address
• MessageProxy contract address

These will be displayed in your console after successful deployment.

Open lib/contract_addresses.ts and update with your deployed contract addresses:

export const CONTRACT_ADDRESSES = {
  simpleMessage: "0xYourSimpleMessageAddress",
  messageProxy: "0xYourMessageProxyAddress"
};

This connects your frontend to the smart contracts you just deployed.

Return to the project root and start the Next.js development server:

cd ..
npm install
npm run dev

Your TAC application is now running at http://localhost:3000.

Open your application in the browser and:

1. Click the “Connect Wallet” button
2. Choose your TON wallet (Tonkeeper, TON Space, etc.)
3. Approve the connection in your wallet
4. Verify your wallet address appears in the interface

The starter app includes a messaging example that demonstrates cross-chain communication from TON to your EVM smart contracts.

Try the example functionality:

1. Send a Message: Use the message form to send data from TON to your EVM contract
2. Track Status: Watch the transaction progress through cross-chain stages
3. View Results: See the message stored on the EVM side

This demonstrates the complete flow of hybrid dApp interaction.

Now start customizing for your use case:

Smart Contracts (contracts/ directory):

• Modify SimpleMessage.sol for your business logic
• Update MessageProxy.sol for custom cross-chain handling
• Add new contracts as needed

Frontend (pages/ and components/ directories):

• Customize the UI components
• Add new pages and functionality
• Integrate additional TAC SDK features

Cross-Chain Features:

• Asset bridging between TON and EVM
• Multi-step cross-chain workflows
• Advanced transaction tracking