Document Tact language limitations due to blockchain/TVM/validator limitations

[anton-trunov]

For instance, how large maps can be, etc.

• Account state size's upper bound is around 65k cells, which, for instance, constraints a single contract map size to be about 20k - 30k entries (it seems to be 2^16 cells)
• Contract size, see e.g. https://github.com/tact-lang/tact/issues/171#issuecomment-2022587472

[0kenx]

This limit is contradictory to our tests. We deployed a contract on testnet and added 66k entries to a map.

https://testnet.tonviewer.com/kQDrXvmitxbGvjpXwRtc5NMuN_4tDkJ83f3myVK04VrviF2v

import "@stdlib/deploy";
import "@stdlib/ownable";
import "./utils/transfer_helpers";

message Increment {
    count: Int;
}

contract MapOnlineTest with Deployable, OwnableTransferable {
    const STORAGE_GAS_RESERVE: Int = ton("0.2");

    owner: Address;
    logo: Int;
    total_map: map<Int, Int>;
    total: Int = 0;

    init(owner: Address, logo: Int) {
        self.owner = owner;
        self.logo = logo;
    }

    receive("fund gas") {}

    receive(msg: Increment) {
        self.requireOwner();
        repeat (msg.count) {
            self.total_map.set(self.total, 1);
            self.total = self.total + 1;
        }

    }

    receive("withdraw dust") {
        self.requireOwner();
        send_ton(
            self.owner,
            myBalance() - self.STORAGE_GAS_RESERVE, 
            false,
            "Dust withdrawn".asComment()
        );
    }

    get fun balance(): Int {
        return myBalance();
    }

    get fun total(): Int {
        return self.total;
    }

    get fun total_map(index: Int): Int? {
        return self.total_map.get(index);
    }
}