TON Blockchain

https://docs.ton.org
Admin
TON (The Open Network) is a decentralized layer-1 blockchain designed for speed, security, and...
Tokens:805,939
Snippets:9,983
Trust Score:10
Update:2 months ago
Show doc for...
Tokens:
Raw
### Clone and setup the examples repository

Source: https://docs.ton.org/contracts/techniques/groth16-examples

Initializes the local environment by cloning the repository and installing necessary dependencies.

```bash
git clone https://github.com/zk-examples/zk-ton-examples.git
cd zk-ton-examples
npm install
```

--------------------------------

### Install MyTonCtrl

Source: https://docs.ton.org/nodes/cpp/mytonctrl/overview

Fetches dependencies, downloads the installation script, and initiates the interactive setup wizard.

```bash
sudo apt update
sudo apt install -y curl wget git ca-certificates python3-pip
wget https://raw.githubusercontent.com/ton-blockchain/mytonctrl/master/scripts/install.sh
sudo bash install.sh
```

--------------------------------

### Installation Log Output Examples

Source: https://docs.ton.org/nodes/cpp/run-liteserver

Sample log entries showing download progress and successful completion.

```text
[#cf6515 8.5GiB/218GiB(3%) CN:8 DL:242MiB ETA:14m44s]
[#cf6515 8.7GiB/218GiB(4%) CN:8 DL:247MiB ETA:14m27s]
[#cf6515 9.0GiB/218GiB(4%) CN:8 DL:252MiB ETA:14m7s]
```

```text
[5/5] Mytonctrl installation completed
```

--------------------------------

### Example Installation Log Output

Source: https://docs.ton.org/nodes/cpp/run-archive-liteserver

Sample log entries showing the download progress of historical blocks.

```text
[info]    24.04.2026, 14:26:47.609 (UTC)  <ThreadPoolExecutor-0_3>STARTING DOWNLOADING e88e7e805dfa16dc6e7d3864fcc00159a1ee70edde7b421428783c2164453875
[info]    24.04.2026, 14:27:07.611 (UTC)  <ThreadPoolExecutor-0_3>DOWNLOADING e88e7e805dfa16dc6e7d3864fcc00159a1ee70edde7b421428783c2164453875 0% (0.0 / 4296.493726 MB), speed: 0.0 MB/s
[info]    24.04.2026, 14:27:07.623 (UTC)  <ThreadPoolExecutor-0_2>DOWNLOADING 7683b6bc2c19e007fc6d363dc233ff9a405c0fee7533c2904c06943f759c155f 3% (130.766577 / 4295.81461 MB), speed: 15.078028 MB/s
[info]    28.04.2026, 11:43:00.687 (UTC)  <ThreadPoolExecutor-0_1>DOWNLOADING fd41a820efc4f459bb1518c45fcc23023b0a95d9446c683705802bfb9d50a0c9 95% (4072.892954 / 4296.3534 MB), speed: 28.962779 MB/s
[info]    28.04.2026, 11:43:20.700 (UTC)  <ThreadPoolExecutor-0_1>DOWNLOADED fd41a820efc4f459bb1518c45fcc23023b0a95d9446c683705802bfb9d50a0c9
```

--------------------------------

### Start TON node command

Source: https://docs.ton.org/contribute/style-guide

Example of a runnable command for starting a TON node using placeholders.

```bash
ton-node start --ledger <LEDGER_DIR> --network testnet
```

--------------------------------

### installer

Source: https://docs.ton.org/nodes/cpp/mytonctrl/core

Launches the MyTonInstaller utility or executes specific installer commands.

```APIDOC
## installer

### Description
Launches the MyTonInstaller utility. If no arguments are provided, it opens the interactive console. If arguments are provided, they are forwarded to the installer's command mode.

### Syntax
`installer`
`installer <installer_command> [installer_args...]`
```

--------------------------------

### Install Prerequisites and Download Installer

Source: https://docs.ton.org/nodes/cpp/run-liteserver

Updates system packages and downloads the MyTonCtrl installation script.

```bash
sudo apt update
sudo apt install -y curl wget git ca-certificates python3-pip
wget https://raw.githubusercontent.com/ton-blockchain/mytonctrl/master/scripts/install.sh
```

--------------------------------

### Install project dependencies

Source: https://docs.ton.org/applications/appkit/get-started/quick-start

Navigate to the project directory and install the required packages.

```bash
cd project-name
npm install
```

--------------------------------

### Dynamic configuration example

Source: https://docs.ton.org/applications/ton-pay/ui-integration/button-js

A complete example showing how to mount the button and update its configuration via a user interaction.

```html
<div id="<CONTAINER_ID>"></div>
<button onclick="changeTheme()">Change Theme</button>

<script src="https://unpkg.com/@ton-pay/ui@0.1.1/dist/ton-pay-embed.js?containerId=<CONTAINER_ID>&callback=<CALLBACK_NAME>"></script>

<script>
  function changeTheme() {
    TonPayEmbed.mount({
      preset: "gradient",
      variant: "short",
      borderRadius: 99
    });
  }
</script>
```

--------------------------------

### Install Acton Toolchain

Source: https://docs.ton.org/contracts/standard/tokens/jettons/create

Use the official installer script to set up the Acton environment and verify the installation.

```bash
curl -LsSf https://ton.org/acton/install.sh | sh
```

```bash
acton --version
```

--------------------------------

### Install MyTonCtrl

Source: https://docs.ton.org/nodes/cpp/setup-mytonctrl

Execute the installation script with root privileges to set up system users and services.

```bash
wget https://raw.githubusercontent.com/ton-blockchain/mytonctrl/master/scripts/install.sh
sudo bash install.sh
```

--------------------------------

### Install WalletKit

Source: https://docs.ton.org/applications/walletkit/web/init

Install the WalletKit package using npm.

```bash
npm i @ton/walletkit
```

--------------------------------

### Run Multiplier Example

Source: https://docs.ton.org/contracts/techniques/groth16-examples

Executes the full lifecycle for the Multiplier circuit, including circuit compilation, trusted setup, and verifier export.

```bash
cd circuits/Multiplier
circom Multiplier.circom --r1cs --wasm --sym --prime bls12381
PTAU_ENTROPY="$(openssl rand -hex 32)"
ZKEY_ENTROPY="$(openssl rand -hex 32)"
npx snarkjs powersoftau new bls12-381 10 pot10_0000.ptau -v
npx snarkjs powersoftau contribute pot10_0000.ptau pot10_0001.ptau --name="First contribution" -v -e="$PTAU_ENTROPY"
npx snarkjs powersoftau prepare phase2 pot10_0001.ptau pot10_final.ptau -v
npx snarkjs groth16 setup Multiplier.r1cs pot10_final.ptau Multiplier_0000.zkey
npx snarkjs zkey contribute Multiplier_0000.zkey Multiplier_final.zkey --name="1st Contributor" -v -e="$ZKEY_ENTROPY"
npx snarkjs zkey export verificationkey Multiplier_final.zkey verification_key.json
cd ../..
npx export-ton-verifier ./circuits/Multiplier/Multiplier_final.zkey ./contracts/verifier_multiplier.tolk --tolk --contract-name multiplierVerifier
npx blueprint test Verifier_multiplier_tolk
```

```text
PASS tests/Verifier_multiplier_tolk.spec.ts
```

--------------------------------

### Run Archive Liteserver Installation

Source: https://docs.ton.org/nodes/cpp/run-archive-liteserver

Execute the installer for either Mainnet or Testnet in the background.

```bash
sudo -v && nohup sudo bash install.sh -m liteserver -n mainnet --archive > mytonctrl_installation.log 2>&1 &
```

```bash
sudo -v && nohup sudo bash install.sh -m liteserver -n testnet --archive > mytonctrl_installation.log 2>&1 &
```

--------------------------------

### Install TON Connect SDK

Source: https://docs.ton.org/applications/ton-connect/get-started

Install the SDK package via npm.

```bash
npm i @tonconnect/sdk
```

--------------------------------

### Monitor Installation Progress

Source: https://docs.ton.org/nodes/cpp/run-liteserver

Tracks the installation log file to verify progress and completion.

```bash
tail -f mytonctrl_installation.log
```

--------------------------------

### Install Dependencies

Source: https://docs.ton.org/contracts/techniques/signing

Install the required core and crypto packages for TON development.

```bash
npm install @ton/core @ton/crypto
```

--------------------------------

### Install dependencies

Source: https://docs.ton.org/contracts/standard/wallets/highload/v3/create

Install the necessary TON SDK packages via npm.

```bash
npm install @ton/ton @ton/core @ton/crypto
```

--------------------------------

### Accessing the installer context

Source: https://docs.ton.org/nodes/cpp/mytonctrl/installer

Commands to enter the installer context within the mytonctrl interface.

```bash
MyTonCtrl> installer
Installer>
```

--------------------------------

### Install necessary libraries

Source: https://docs.ton.org/applications/ton-pay/ui-integration/button-react

Run this command to install the required TON Pay and TON Connect packages.

```bash
npm install @ton-pay/ui-react @ton-pay/api @tonconnect/ui-react
```

--------------------------------

### Implement setup function for test initialization

Source: https://docs.ton.org/contracts/blueprint/testing/style-guide

Use a dedicated setup function to initialize the blockchain and contracts, ensuring consistency and reducing boilerplate in individual test cases.

```typescript
const setup = async () => {
    const blockchain = await Blockchain.create({ config: "slim" });

    const owner = await blockchain.treasury("deployer");
    const user = await blockchain.treasury("user");

    const contract = blockchain.openContract(await Parent.fromInit());

    const deployResult = await contract.send(owner.getSender(), { value: toNano(0.5) }, null);

    return { blockchain, owner, user, contract, deployResult };
};

it("should deploy correctly", async () => {
    const { owner, contract, deployResult } = await setup();

    expect(deployResult.transactions).toHaveTransaction({
        from: owner.address,
        to: contract.address,
        deploy: true,
        success: true,
    });
});
```

--------------------------------

### Operator Precedence Examples

Source: https://docs.ton.org/tolk/syntax/operators

Examples demonstrating grouping with parentheses and array construction with square brackets.

```tolk
(1 + 2) * 3
```

```tolk
pair = (1, 2)
```

```tolk
[1, 2]
```

--------------------------------

### Install AppKit packages

Source: https://docs.ton.org/applications/appkit/get-started/installation/vanilla-js

Install the core AppKit runtime, TON Connect UI transport, and TON core primitives.

```bash
npm i @ton/appkit @tonconnect/ui @ton/core
```

--------------------------------

### Run Validator Installation

Source: https://docs.ton.org/nodes/cpp/run-validator

Execute the installation script for either Mainnet or Testnet environments.

```shell
sudo bash install.sh -m single-nominator -n mainnet
```

```shell
sudo bash install.sh -m single-nominator -n testnet
```

--------------------------------

### Install TON Pay SDK

Source: https://docs.ton.org/applications/ton-pay/api-reference

Command to install the required API and React UI packages.

```bash
npm install @ton-pay/api @ton-pay/ui-react
```

--------------------------------

### TL-B Constructor Examples

Source: https://docs.ton.org/foundations/tlb/syntax-and-semantics

Examples of constructor definitions using different tag formats and prefixes.

```tlb
bool_true$1;
transfer#5fcc3d14;
some#_;
_#_.
```

--------------------------------

### Install @tonconnect/ui

Source: https://docs.ton.org/applications/ton-connect/get-started

Installation methods for the TON Connect UI library via npm or CDN.

```bash
npm i @tonconnect/ui
```

```html
<script src="https://unpkg.com/@tonconnect/ui@latest/dist/tonconnect-ui.min.js"></script>
```

--------------------------------

### Run Liteserver Installation

Source: https://docs.ton.org/nodes/cpp/run-liteserver

Executes the installation script in the background for either Mainnet or Testnet with specific data retention settings.

```bash
export ARCHIVE_TTL=2592000 STATE_TTL=86400 && sudo -v && nohup sudo bash install.sh -m liteserver -n mainnet -d > mytonctrl_installation.log 2>&1 &
```

```bash
export ARCHIVE_TTL=2592000 STATE_TTL=86400 && sudo -v && nohup sudo bash install.sh -m liteserver -n testnet -d > mytonctrl_installation.log 2>&1 &
```

--------------------------------

### cURL Request Example

Source: https://docs.ton.org/api/v3/api-v2/run-get-method

Example of a POST request to the runGetMethod endpoint using cURL.

```bash
curl -X POST "https://toncenter.com/api/v3/runGetMethod" \
  -H "Content-Type: application/json" \
  -d '{}'
```

--------------------------------

### Launch MyTonInstaller

Source: https://docs.ton.org/nodes/cpp/mytonctrl/core

Use these commands to open the interactive installer or execute specific provisioning tasks directly.

```bash
installer
installer clcf
installer enable THA
```

--------------------------------

### Get DNS Records cURL Request

Source: https://docs.ton.org/api/v3/dns/get-dns-records

Example of a basic GET request to the DNS records endpoint using cURL.

```bash
curl -X GET "https://toncenter.com/api/v3/dns/records"
```

--------------------------------

### Install WalletConnect dependencies

Source: https://docs.ton.org/applications/ton-connect/how-to/walletconnect-support

Install the required universal connector package alongside the TON Connect SDK.

```bash
npm install @tonconnect/sdk @reown/appkit-universal-connector
```

--------------------------------

### Minimal Fift Get Method Definition

Source: https://docs.ton.org/tvm/get-method

A basic example of a Fift smart contract implementing a get method by manually checking the function selector ID.

```Fift
"Asm.fif" include

<{
  // The ID from the top of the stack is compared with 97865
  97865 EQINT
  // If ID != 97865, an 11 error is thrown by convention
  11 THROWIFNOT
  // Otherwise, 123 is pushed as the result
  123 PUSHINT
}>s
```

--------------------------------

### Install Blueprint testing dependencies

Source: https://docs.ton.org/contracts/blueprint/testing/reference

Install the required sandbox and test utility packages via npm.

```bash
npm install --save-dev @ton/sandbox @ton/test-utils
```

--------------------------------

### Enable Fail2ban

Source: https://docs.ton.org/nodes/cpp/run-liteserver

Installs and starts Fail2ban to protect against SSH brute-force attacks.

```bash
sudo apt install -y fail2ban
sudo systemctl enable fail2ban
sudo systemctl start fail2ban
```

--------------------------------

### Get Wallet Information Request

Source: https://docs.ton.org/api/v3/api-v2/get-wallet-information

Example cURL request to retrieve wallet information.

```bash
curl -X GET "https://toncenter.com/api/v3/walletInformation?address=string"
```

--------------------------------

### Install mintless-toolbox

Source: https://docs.ton.org/contracts/standard/tokens/jettons/mintless/deploy

Build the community-developed utility for additional mintless jetton features.

```bash
git clone https://github.com/tonkeeper/mintless-toolbox.git
cd mintless-toolbox
make
```

--------------------------------

### Initialize Jetton Project

Source: https://docs.ton.org/contracts/standard/tokens/jettons/create

Create a new project using the jetton template and navigate into the directory.

```bash
acton new my-jetton --template jetton --agents
```

```bash
cd my-jetton
```

--------------------------------

### Get Nominator API Request

Source: https://docs.ton.org/api/smc-index/get-nominator-method

Example cURL request to retrieve nominator data.

```bash
curl -X GET "https://toncenter.com/api/smc-index/getNominator?nominator=string" \
  -H "X-API-Key: "
```

--------------------------------

### Expected node output

Source: https://docs.ton.org/contribute/style-guide

Example of the expected console output after starting a TON node.

```text
Node started. Workchain: 0  Shard: -1  Status: running
```

--------------------------------

### Create a project with flags

Source: https://docs.ton.org/applications/appkit/get-started/quick-start

Initialize a project non-interactively by passing the project name and app URL as arguments.

```bash
npm create ton-appkit project-name -- --app-url https://example.com
```

--------------------------------

### Get Address Information Request

Source: https://docs.ton.org/api/v3/api-v2/get-address-information

Example cURL request to retrieve address information from the API.

```bash
curl -X GET "https://toncenter.com/api/v3/addressInformation?address=string"
```

--------------------------------

### Initialize a TON project

Source: https://docs.ton.org/contracts/techniques/zero-knowledge

Create a new project using the Blueprint CLI.

```bash
npm create ton@latest ZkSimple && cd ZkSimple
```

--------------------------------

### Initialize and Install TON Pay Dependencies

Source: https://docs.ton.org/applications/ton-pay/quick-start

Commands to scaffold a new TypeScript React application and install the necessary TON Pay and TON Connect packages.

```bash
npx create-react-app my-app --template typescript
cd my-app
npm i @ton-pay/api @ton-pay/ui-react @tonconnect/ui-react
```

--------------------------------

### Execute Phase 2 of Trusted Setup

Source: https://docs.ton.org/contracts/techniques/zero-knowledge

Prepare the phase 2 parameters and generate the initial zkey for the circuit.

```bash
  snarkjs powersoftau prepare phase2 pot10_0001.ptau pot10_final.ptau -v
  snarkjs groth16 setup Multiplier.r1cs pot10_final.ptau Multiplier_0000.zkey
  snarkjs zkey contribute Multiplier_0000.zkey Multiplier_final.zkey --name="1st Contributor" -v -e="some random text"
```

--------------------------------

### Get Nominator Bookings Request

Source: https://docs.ton.org/api/smc-index/get-nominator-bookings-method

Example cURL request to retrieve nominator bookings from the API.

```bash
curl -X GET "https://toncenter.com/api/smc-index/getNominatorBookings?nominator=string&pool=string" \
  -H "X-API-Key: "
```

--------------------------------

### Get Nominator Earnings Request

Source: https://docs.ton.org/api/smc-index/get-nominator-earnings-method

Example cURL request to retrieve nominator earnings from the API.

```bash
curl -X GET "https://toncenter.com/api/smc-index/getNominatorEarnings?nominator=string&pool=string" \
  -H "X-API-Key: "
```

--------------------------------

### Start Bicycle Services

Source: https://docs.ton.org/applications/payments/setup

Initialize the PostgreSQL and payment processor containers.

```bash
docker compose up -d payment-postgres
docker compose up -d payment-processor
```

--------------------------------

### Run the development server

Source: https://docs.ton.org/applications/appkit/get-started/quick-start

Start the local development server to view the application.

```bash
npm run dev
```

--------------------------------

### Get Jetton Wallets Request

Source: https://docs.ton.org/api/v3/jettons/get-jetton-wallets

Example cURL request to fetch Jetton wallet data from the API.

```bash
curl -X GET "https://toncenter.com/api/v3/jetton/wallets"
```

--------------------------------

### Build Project

Source: https://docs.ton.org/contracts/standard/tokens/jettons/create

Compile contracts and build the UI.

```bash
npm run build
```

--------------------------------

### Get Jetton Masters cURL Request

Source: https://docs.ton.org/api/v3/jettons/get-jetton-masters

Example request to fetch Jetton masters from the TON API.

```bash
curl -X GET "https://toncenter.com/api/v3/jetton/masters"
```

--------------------------------

### Get Pool Bookings cURL Request

Source: https://docs.ton.org/api/smc-index/get-pool-bookings-method

Example request using cURL to retrieve pool bookings from the TON Center API.

```bash
curl -X GET "https://toncenter.com/api/smc-index/getPoolBookings?pool=string" \
  -H "X-API-Key: "
```

--------------------------------

### Deploying a contract with initial storage

Source: https://docs.ton.org/tolk/features/contract-storage

Demonstrates initializing a contract's storage structure during deployment using imported storage definitions.

```tolk
// all symbols from imported files become visible
import "storage"

fun deploy(ownerAddress: address, minterAddress: address) {
    val emptyWalletStorage: WalletStorage = {
        ownerAddress,
        minterAddress,
        // the other two use their defaults
    };
    // ...
}
```

--------------------------------

### Get Pool API Request

Source: https://docs.ton.org/api/smc-index/get-pool-method

Example cURL request to retrieve pool data using the specified API endpoint and header authentication.

```bash
curl -X GET "https://toncenter.com/api/smc-index/getPool?pool=string" \
  -H "X-API-Key: "
```

--------------------------------

### Initialize gnark Go Project

Source: https://docs.ton.org/contracts/techniques/zero-knowledge

Create a new Go module directory for gnark circuit development.

```bash
mkdir zk-ton-gnark && cd zk-ton-gnark
go mod init zk-ton-gnark
```

--------------------------------

### Enable First Node Bootstrap

Source: https://docs.ton.org/nodes/cpp/mytonctrl/installer

Example of enabling the first node bootstrap component.

```bash
enable FN
```

--------------------------------

### Blockchain Initialization Examples

Source: https://docs.ton.org/contracts/blueprint/testing/reference

Various ways to instantiate the blockchain with different configurations.

```typescript
// Basic blockchain
const blockchain = await Blockchain.create();

// With slim config for faster execution
const blockchain = await Blockchain.create({ config: 'slim' });

// With remote storage
const blockchain = await Blockchain.create({
    storage: new RemoteBlockchainStorage(client)
});

// With auto-deploy libraries
const blockchain = await Blockchain.create({
    autoDeployLibs: true
});
```

--------------------------------

### Install @tonconnect/protocol

Source: https://docs.ton.org/applications/ton-connect/api-reference/protocol

Install the package via npm.

```bash
npm i @tonconnect/protocol
```

--------------------------------

### Install Dependencies

Source: https://docs.ton.org/contracts/standard/tokens/jettons/create

Install project dependencies using npm.

```bash
npm ci
```

--------------------------------

### Prepare Windows Project Directory

Source: https://docs.ton.org/contracts/standard/tokens/jettons/create

Create the necessary folder structure for a manual Windows setup.

```powershell
mkdir jetton-windows
cd jetton-windows
mkdir contracts
mkdir gen
mkdir build
mkdir scripts
```

--------------------------------

### Initialize AppKit

Source: https://docs.ton.org/applications/appkit/reference/appkit

Configure and instantiate the AppKit runtime with network adapters and wallet connectors.

```javascript
// Initialize AppKit
const appKit = new AppKit({
    networks: {
        [Network.mainnet().chainId]: {
            apiClient: {
                url: 'https://toncenter.com',
                key: 'your-key',
            },
        },
        // Optional: add testnet
        // [Network.testnet().chainId]: {
        //     apiClient: {
        //         url: 'https://testnet.toncenter.com',
        //         key: 'your-key',
        //     },
        // },
    },
    connectors: [
        createTonConnectConnector({
            tonConnectOptions: {
                manifestUrl: 'https://tonconnect-sdk-demo-dapp.vercel.app/tonconnect-manifest.json',
            },
        }),
    ],
});
```

--------------------------------

### Initialize WalletKit with TypeScript

Source: https://docs.ton.org/applications/walletkit/web/init

Minimum functional setup for WalletKit including network configuration, device info, and bridge settings.

```TypeScript
import {
  TonWalletKit,
  Network, 
  createDeviceInfo,
  createWalletManifest,
} from '@ton/walletkit';

const kit = new TonWalletKit({
  networks: {
    [Network.mainnet().chainId]: {
      apiClient: {
        url: 'https://toncenter.com',
        key: '<MAINNET_API_KEY>',
      },
    },
    [Network.testnet().chainId]: {
      apiClient: {
        url: 'https://testnet.toncenter.com',
        key: '<TESTNET_API_KEY>',
      },
    },
  },

  deviceInfo: createDeviceInfo({
    appVersion: '0.0.1',
  }),

  walletManifest: createWalletManifest(),

  bridge: {
    bridgeUrl: 'https://connect.ton.org/bridge',
  },
});

await kit.waitForReady();
```

--------------------------------

### Install @tonconnect/ui-react

Source: https://docs.ton.org/applications/ton-connect/api-reference/ui-react

Use npm to install the package in your React project.

```bash
npm i @tonconnect/ui-react
```

--------------------------------

### Initialize Acton Jetton Project

Source: https://docs.ton.org/contracts/standard/tokens/jettons/create

Create a new project using the Acton CLI template.

```bash
acton new my-jetton-app --template jetton --app
```

--------------------------------

### Installation Completion Log

Source: https://docs.ton.org/nodes/cpp/run-archive-liteserver

The specific log entry indicating successful installation.

```text
[5/5] Mytonctrl installation completed
```

--------------------------------

### Initialize WalletKit Instance

Source: https://docs.ton.org/applications/walletkit/android/init

Create the WalletKit instance using the previously defined configuration.

```kotlin
import io.ton.walletkit.ITONWalletKit

// Instance
val walletKit = ITONWalletKit.initialize(
    context = context,
    config = configuration
)
```

--------------------------------

### Create a contract interactively

Source: https://docs.ton.org/contracts/blueprint/develop

Launches a guided prompt to initialize a new contract.

```bash
npx blueprint create
```

--------------------------------

### Install @ton/mcp skills

Source: https://docs.ton.org/onboarding/ai/quick-start

Command to install the necessary skills for the MCP server.

```bash
npx skills add ton-connect/kit/packages/mcp
```

--------------------------------

### Start the storage daemon

Source: https://docs.ton.org/foundations/web3/ton-storage

Initializes the official storage daemon with specified configuration, IP, port, and database directory.

```bash
storage-daemon -v 3 -C global.config.json -I <ip>:3333 -p 5555 -D storage-db
```

--------------------------------

### Install ZK dependencies

Source: https://docs.ton.org/contracts/techniques/zero-knowledge

Install snarkjs and the TON verifier export library.

```bash
npm install snarkjs @types/snarkjs export-ton-verifier@latest
```

--------------------------------

### Initialize a new Blueprint project

Source: https://docs.ton.org/contracts/blueprint/overview

Use this command to scaffold a new TON smart contract project with all necessary dependencies and structure.

```bash
npm create ton@latest
```

--------------------------------

### Build tonutils-reverse-proxy from source

Source: https://docs.ton.org/foundations/web3/ton-sites

Compile the Go implementation from the repository.

```bash
git clone https://github.com/tonutils/reverse-proxy
cd reverse-proxy && make build
```

--------------------------------

### Initialize WalletKit instance

Source: https://docs.ton.org/applications/walletkit/ios/init

Create the WalletKit instance using the previously defined configuration and a storage provider.

```swift
import TONWalletKit

// Instructs how to store intermediate events and other data from WalletKit.
let storage: TONWalletKitStorageType = .memory // .keychain or .custom(/* custom storage */)

// Instance
let walletKit = try await TONWalletKit.initialize(
      configuration: configuration,
      storage: storage
)
```

--------------------------------

### Install TON Pay SDK

Source: https://docs.ton.org/applications/ton-pay/invoices

Install the required package via npm.

```bash
npm install @ton-pay/api
```

--------------------------------

### Create a new smart contract

Source: https://docs.ton.org/contracts/blueprint/cli

Initializes a new contract project structure including source, wrapper, test, and deployment files.

```bash
npx blueprint create <CONTRACT> --type <TYPE>
```

```bash
npx blueprint create
```

```bash
npx blueprint create <CONTRACT> --type <TYPE>
```

```bash
# Create empty Tolk contract
npx blueprint create MyToken --type tolk-empty

# Create Tolk counter example
npx blueprint create SimpleCounter --type tolk-counter

# Create contract interactively
npx blueprint create
```

--------------------------------

### Example Full VM Logs Output

Source: https://docs.ton.org/contracts/blueprint/debug

Detailed output format including binary offsets, stack state, and gas usage for each instruction.

```text
...
execute PUSHCONT x30
gas remaining: 999018
stack: [ 500000000 CS{Cell{02b168008d0d4580cd8f09522be7c0390a7a632bda4a99291c435b767c95367ebe78e9af0023d36bc5f97853f4c898f868f95b035ae8f555a321d0ffce8d9f6165e2252d7a9077359400060e9fc800000000003d0902d1b85b3919} bits: 711..711; refs: 2..2} 0 Cont{vmc_std} ]
code cell hash: F9EAC82B7999AEEF696D592FE2469B9069FB05ED35C92213D7EE516F45AB97CA offset: 344
execute IFJMP
gas remaining: 999000
stack: [ 500000000 CS{Cell{02b168008d0d4580cd8f09522be7c0390a7a632bda4a99291c435b767c95367ebe78e9af0023d36bc5f97853f4c898f868f95b035ae8f555a321d0ffce8d9f6165e2252d7a9077359400060e9fc800000000003d0902d1b85b3919} bits: 711..725; refs: 2..2} ]
code cell hash: F9EAC82B7999AEEF696D592FE2469B9069FB05ED35C92213D7EE516F45AB97CA offset: 352
execute LDU 64
handling exception code 9: cell underflow
default exception handler, terminating vm with exit code 9
```

--------------------------------

### Install TASM globally

Source: https://docs.ton.org/tvm/tools/ton-assembly

Install the TASM tool suite globally using npm.

```bash
npm install -g @ton/tasm
```

--------------------------------

### Download MyTonCtrl Installer

Source: https://docs.ton.org/nodes/cpp/run-validator

Download the installation script for the MyTonCtrl validator management tool.

```shell
wget https://raw.githubusercontent.com/ton-blockchain/mytonctrl/master/scripts/install.sh
```

--------------------------------

### Deploy Example Contract Script

Source: https://docs.ton.org/contracts/techniques/vanity

Use the Blueprint network provider to deploy a target contract through the vanity contract wrapper.

```typescript
import { toNano, Address } from '@ton/core';
import { ExampleContract } from '../wrappers/ExampleContract';
import { VanityContract } from '../wrappers/VanityContract';
import { compile, NetworkProvider } from '@ton/blueprint';

export async function run(provider: NetworkProvider) {
    const vanityContract = provider.open(
        VanityContract.createFromConfig({
            owner: Address.parse('<OWNER_ADDR>'),
            salt: Buffer.from('<SALT_HEX>', 'hex'),
        }),
    );

    const exampleContract = provider.open(
        ExampleContract.createFromConfig(
            {},
            await compile('ExampleContract'),
        ),
    );

    const init = exampleContract.init!;

    await vanityContract.sendDeploy(
        provider.sender(),
        toNano('0.01'), // attach value for deployment fees
        init.code,
        init.data,
    );

    await provider.waitForDeploy(vanityContract.address);
}
```

--------------------------------

### Install ZFS Utilities

Source: https://docs.ton.org/nodes/cpp/run-archive-liteserver

Installs the ZFS file system utilities on Ubuntu/Debian systems.

```bash
sudo apt update
sudo apt install -y zfsutils-linux
```

--------------------------------

### Install tonutils-reverse-proxy on Linux

Source: https://docs.ton.org/foundations/web3/ton-sites

Download and prepare the Go-based reverse proxy implementation.

```bash
wget https://github.com/tonutils/reverse-proxy/releases/latest/download/tonutils-reverse-proxy-linux-amd64
chmod +x tonutils-reverse-proxy-linux-amd64
```

--------------------------------

### Webhook Payload Examples

Source: https://docs.ton.org/applications/ton-pay/webhooks

Example JSON payloads for successful and failed transfer events.

```json
{
  "event": "transfer.completed",
  "timestamp": "2024-01-15T14:30:00.000Z",
  "data": {
    "amount": "10.5",
    "rawAmount": "10500000000",
    "senderAddr": "<SENDER_ADDR>",
    "recipientAddr": "<RECIPIENT_ADDR>",
    "asset": "TON",
    "assetTicker": "TON",
    "status": "success",
    "reference": "<REFERENCE>",
    "bodyBase64Hash": "<BODY_BASE64_HASH>",
    "txHash": "<TX_HASH>",
    "traceId": "<TRACE_ID>",
    "commentToSender": "Thanks for the purchase",
    "commentToRecipient": "Payment for order #1234",
    "date": "2024-01-15T14:30:00.000Z"
  }
}
```

```json
{
  "event": "transfer.completed",
  "timestamp": "2024-01-15T14:35:00.000Z",
  "data": {
    "amount": "10.5",
    "rawAmount": "10500000000",
    "senderAddr": "<SENDER_ADDR>",
    "recipientAddr": "<RECIPIENT_ADDR>",
    "asset": "TON",
    "assetTicker": "TON",
    "status": "failed",
    "reference": "<REFERENCE>",
    "bodyBase64Hash": "<BODY_BASE64_HASH>",
    "txHash": "<TX_HASH>",
    "traceId": "<TRACE_ID>",
    "commentToSender": "Transaction failed",
    "commentToRecipient": "Payment for order #5678",
    "date": "2024-01-15T14:35:00.000Z",
    "errorCode": 36,
    "errorMessage": "Not enough GRAM"
  }
}
```

--------------------------------

### Start and Verify Docker Containers

Source: https://docs.ton.org/nodes/cpp/integrating-with-prometheus

Commands to launch the monitoring stack and check container status.

```bash
docker compose up -d
docker compose ps
```

--------------------------------

### Install mintless-proof-generator

Source: https://docs.ton.org/contracts/standard/tokens/jettons/mintless/deploy

Build the official utility from the TON blockchain core repository.

```bash
git clone https://github.com/ton-blockchain/ton
cd ton
git checkout testnet
mkdir build && cd build
cmake ../
make mintless-proof-generator
```

--------------------------------

### Install provider SDK dependency

Source: https://docs.ton.org/applications/appkit/get-started/providers

Install the required SDK package for specific providers before registration.

```bash
npm i @ston-fi/omniston-sdk
```

--------------------------------

### Initialize wallet with private key signer

Source: https://docs.ton.org/applications/walletkit/web/init-wallet

Create a signer from a private key stored in local storage and initialize the wallet adapter.

```TypeScript
import {
  Signer,
  WalletV5R1Adapter,
  Network
} from '@ton/walletkit';

// 1. Create a signer
const signer = await Signer.fromPrivateKey(
  localStorage.getItem('PRIVATE_KEY')!,
);

// 2. Create a wallet adapter
const walletAdapter = await WalletV5R1Adapter.create(signer, {
  network: Network.mainnet(),
  client: kit.getApiClient(Network.mainnet()),
});

// 3. Initialize the wallet
const wallet = await kit.addWallet(walletAdapter);
```

--------------------------------

### Example keys.txt content

Source: https://docs.ton.org/languages/fift/multisig

Format for the keys.txt file containing one public key per line.

```text
PubExXl3MdwPVuffxRXkhKN1avcGYrm6QgJfsqdf4dUc0an7/IA
PubH821csswh8R1uO9rLYyP1laCpYWxhNkx+epOkqwdWXgzY4
```

--------------------------------

### Non-inlinable Function Example

Source: https://docs.ton.org/tolk/features/compiler-optimizations

Example of a function that cannot be inlined due to a return statement in the middle of the body.

```tolk
fun executeForPositive(userId: int) {
    if (userId <= 0) {
        return;
    }
    // ...
}
```

--------------------------------

### Initialize a new Blueprint project

Source: https://docs.ton.org/contracts/blueprint/first-smart-contract

Creates a new project directory with a specified contract name and template type.

```bash
npm create ton@latest -- Example --contractName FirstContract --type tolk-empty
```

--------------------------------

### Example of recv_internal Argument Usage

Source: https://docs.ton.org/languages/func/special-functions

A specific declaration example showing how arguments are assigned from the stack.

```func
() recv_internal(cell in_msg_cell, slice in_msg_body)
```

--------------------------------

### toHaveTransaction Usage Examples

Source: https://docs.ton.org/contracts/blueprint/testing/reference

Examples of using toHaveTransaction to verify deployment, operations, and complex conditions.

```typescript
// Check deployment transaction
expect(result.transactions).toHaveTransaction({
    from: deployer.address,
    to: contract.address,
    deploy: true,
    success: true
});

// Check specific operation with value
expect(result.transactions).toHaveTransaction({
    from: user.address,
    to: contract.address,
    value: toNano('1'),
    op: 0x12345678,
    success: true
});

// Use functions for complex matching
expect(result.transactions).toHaveTransaction({
    value: (v) => v >= toNano('0.1'),
    exitCode: (code) => code !== 0
});
```

--------------------------------

### Create Wallet V5 Instance

Source: https://docs.ton.org/contracts/standard/wallets/interact

Example of creating Wallet V5R1 contract instances for both testnet and mainnet.

```typescript
import { mnemonicToPrivateKey } from '@ton/crypto';
import { WalletContractV5R1 } from '@ton/ton';

// 12- or 24-word mnemonic (space-separated).
const mnemonic = 'foo bar baz ...';

// async function for await
const main = async () => {
    const keyPair = await mnemonicToPrivateKey(
        mnemonic.split(' '),
    );

    // testnet
    const testnetV5Wallet = WalletContractV5R1.create({
        walletId: {
            networkGlobalId: -3,
        },
        publicKey: keyPair.publicKey,
        workchain: 0,
    });

    console.log(testnetV5Wallet.address);

    // mainnet
    const mainnetV5Wallet = WalletContractV5R1.create({
        walletId: {
            networkGlobalId: -239,
        },
        publicKey: keyPair.publicKey,
        workchain: 0,
    });

    console.log(mainnetV5Wallet.address);
};

void main();
```

--------------------------------

### Image Source Path Examples

Source: https://docs.ton.org/contribute/snippets/image

Examples of using relative and absolute paths for the src property.

```jsx
<Image src="<IMAGE>" />
```

```jsx
<Image src="/images/<IMAGE>" />
```

--------------------------------

### Initialize Arkworks Rust Project

Source: https://docs.ton.org/contracts/techniques/zero-knowledge

Set up a new Rust project with essential Arkworks dependencies for circuit development.

```bash
cargo init
cargo add ark-bls12-381 ark-ff ark-groth16 ark-r1cs-std ark-relations ark-snark ark-snarkjs ark-std rand@0.8.5
```
Tokens:
Raw