Setting Up Your Environment

Prerequisites

• Node.js version 22 or later

• npm or yarn package manager

Installation

Create Project

Create a new project and follow the on-screen instructions, then navigate to your project directory and install required packages:

npm create ton@latest
cd your-project-name
npm install

Install TetraChain Dependencies

Install the Tycho emulator and required TON packages:

npm install @tychosdk/emulator @ton/sandbox @ton/ton @ton/core @ton/crypto

Network Configuration

Create blueprint.config.ts:

import { Config } from '@ton/blueprint';

export const config: Config = {
    network: {
        endpoint: 'https://tetra.tonapi.io', // API endpoint URL
        type: 'mainnet', // Network type
        version: 'tonapi', // API provider
    },
};

Configuring TVM Executor for TetraChain

TetraChain uses a custom executor and gas configuration. This setup initializes the Tycho executor, ensuring your tests and deployments use Tetra-specific gas prices and limits instead of standard TON parameters.

import { Blockchain } from '@ton/sandbox';
import { TychoExecutor } from '@tychosdk/emulator';
import { TonApiClient } from '@ton-api/client';
import { Address } from '@ton/core';

// Connect to Tetra API
const tonapi = new TonApiClient({
    baseUrl: 'https://tetra.tonapi.io/',
});

// Fetch Tetra configuration
const configAccount = await tonapi.blockchain.getBlockchainRawAccount(
    Address.parse('-1:5555555555555555555555555555555555555555555555555555555555555555'),
);

const config = configAccount.data!.asSlice().loadRef();

// Create blockchain with Tycho executor
const blockchain = await Blockchain.create({
    executor: await TychoExecutor.create(),
    config,
});

Additional Resources

• Blueprint Documentation

• Tycho Emulator