@ton/sandbox 0.38.0-dev.20251014114055.f2fd72c → 0.38.0

package/CHANGELOG.md

@@ -5,6 +5,16 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.38.0] - 2025-10-15
+
+### Added
+
+- Added support for TVM v12
+
+### Changed
+
+- Failed actions are now partially handled when parsing send modes for transactions
+
 ## [0.37.2] - 2025-09-23
 
 ### Fixed

package/dist/blockchain/BlockchainSnapshot.js

@@ -4,6 +4,7 @@ exports.blockIdToSerializable = blockIdToSerializable;
 exports.snapshotToSerializable = snapshotToSerializable;
 exports.snapshotFromSerializable = snapshotFromSerializable;
 const core_1 = require("@ton/core");
+const SmartContract_1 = require("./SmartContract");
 const Event_1 = require("../event/Event");
 function blockIdToSerializable(blockId) {
     return {
@@ -48,7 +49,9 @@ function snapshotToSerializable(snapshot) {
                 debugLogs: transaction.debugLogs,
                 oldStorage: transaction.oldStorage?.toBoc().toString('base64'),
                 newStorage: transaction.newStorage?.toBoc().toString('base64'),
-                outActions: transaction.outActions ? writableToBase64((0, core_1.storeOutList)(transaction.outActions)) : undefined,
+                outActions: transaction.outActions
+                    ? writableToBase64((0, SmartContract_1.storeOutListExt)(transaction.outActions))
+                    : undefined,
                 externals: transaction.externals.map((external) => writableToBase64((0, core_1.storeMessageRelaxed)(external))),
                 mode: transaction.mode,
                 parentHash: transaction.parent?.hash().toString('hex'),
@@ -76,7 +79,7 @@ function snapshotFromSerializable(serialized) {
             debugLogs: t.debugLogs,
             oldStorage: t.oldStorage ? core_1.Cell.fromBase64(t.oldStorage) : undefined,
             newStorage: t.newStorage ? core_1.Cell.fromBase64(t.newStorage) : undefined,
-            outActions: t.outActions ? (0, core_1.loadOutList)(core_1.Cell.fromBase64(t.outActions).beginParse()) : undefined,
+            outActions: t.outActions ? (0, SmartContract_1.loadOutListExt)(core_1.Cell.fromBase64(t.outActions).beginParse()) : undefined,
             events: (0, Event_1.extractEvents)(transaction),
             mode: t.mode,
             externals: t.externals.map((ext) => (0, core_1.loadMessageRelaxed)(core_1.Cell.fromBase64(ext).beginParse())),

package/dist/blockchain/SmartContract.d.ts

@@ -1,4 +1,4 @@
-import { Address, Cell, Message, OutAction, ShardAccount, Transaction, TupleItem, TupleReader } from '@ton/core';
+import { Address, Builder, Cell, Message, OutAction, ShardAccount, Slice, Transaction, TupleItem, TupleReader } from '@ton/core';
 import { Blockchain } from './Blockchain';
 import { ExtraCurrency } from '../utils/ec';
 import { EmulationResult, RunCommonArgs, TickOrTock } from '../executor/Executor';
@@ -10,6 +10,15 @@ export declare function createShardAccount(args: {
     workchain?: number;
 }): ShardAccount;
 export declare function createEmptyShardAccount(address: Address): ShardAccount;
+type ExtendedActionType = OutAction['type'] | 'unknown';
+export type OutActionMalformed = {
+    type: 'malformed';
+    subtype: ExtendedActionType;
+    data: Cell;
+};
+export type OutActionExtended = OutAction | OutActionMalformed;
+export declare function storeOutListExt(actions: OutActionExtended[]): (builder: Builder) => void;
+export declare function loadOutListExt(data: Slice): OutActionExtended[];
 export type Verbosity = 'none' | 'vm_logs' | 'vm_logs_location' | 'vm_logs_gas' | 'vm_logs_full' | 'vm_logs_verbose';
 export type LogsVerbosity = {
     print: boolean;
@@ -23,7 +32,7 @@ export type SmartContractTransaction = Transaction & {
     debugLogs: string;
     oldStorage?: Cell;
     newStorage?: Cell;
-    outActions?: OutAction[];
+    outActions?: OutActionExtended[];
 };
 export type MessageParams = Partial<{
     now: number;
@@ -73,9 +82,13 @@ export type SmartContractSnapshot = {
     verbosity?: Partial<LogsVerbosity>;
 };
 export declare class SmartContract {
-    #private;
     readonly address: Address;
     readonly blockchain: Blockchain;
+    private _account;
+    private parsedAccount?;
+    private lastTxTime;
+    private _verbosity?;
+    private _debug?;
     constructor(shardAccount: ShardAccount, blockchain: Blockchain);
     snapshot(): SmartContractSnapshot;
     loadFrom(snapshot: SmartContractSnapshot): void;
@@ -106,3 +119,4 @@ export declare class SmartContract {
     get debug(): boolean;
     setDebug(debug: boolean | undefined): void;
 }
+export {};

package/dist/blockchain/SmartContract.js

@@ -3,6 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SmartContract = exports.EmulationError = exports.TimeError = exports.GetMethodError = void 0;
 exports.createShardAccount = createShardAccount;
 exports.createEmptyShardAccount = createEmptyShardAccount;
+exports.storeOutListExt = storeOutListExt;
+exports.loadOutListExt = loadOutListExt;
 const core_1 = require("@ton/core");
 const ec_1 = require("../utils/ec");
 const selector_1 = require("../utils/selector");
@@ -62,6 +64,73 @@ function createEmptyShardAccount(address) {
         lastTransactionHash: 0n,
     };
 }
+function preloadActionType(data) {
+    if (data.remainingBits < 32) {
+        return 'unknown';
+    }
+    const tag = data.preloadUint(32);
+    /*
+     * action_send_msg#0ec3c86d mode:(## 8)
+     *   out_msg:^(MessageRelaxed Any) = OutAction;
+     *
+     * action_set_code#ad4de08e new_code:^Cell = OutAction;
+     *
+     * action_reserve_currency#36e6b809 mode:(## 8)
+     *   currency:CurrencyCollection = OutAction;
+     *
+     * action_change_library#26fa1dd4 mode:(## 7)
+     *   libref:LibRef = OutAction;
+     *
+     */
+    switch (tag) {
+        case 0x0ec3c86d:
+            return 'sendMsg';
+        case 0xad4de08e:
+            return 'setCode';
+        case 0x36e6b809:
+            return 'reserve';
+        case 0x26fa1dd4:
+            return 'changeLibrary';
+        default:
+            return 'unknown';
+    }
+}
+function storeActionExt(action) {
+    if (action.type === 'malformed') {
+        return (builder) => {
+            builder.storeSlice(action.data.beginParse());
+        };
+    }
+    return (0, core_1.storeOutAction)(action);
+}
+function storeOutListExt(actions) {
+    const cell = actions.reduce((cell, action) => (0, core_1.beginCell)().storeRef(cell).store(storeActionExt(action)).endCell(), (0, core_1.beginCell)().endCell());
+    return (builder) => {
+        builder.storeSlice(cell.beginParse());
+    };
+}
+// loadOutList from @ton/core, but with exception handling
+function loadOutListExt(data) {
+    const actions = [];
+    while (data.remainingRefs) {
+        const nextCell = data.loadRef();
+        const dataOrig = data.clone();
+        const dataCell = data.asCell();
+        try {
+            actions.push((0, core_1.loadOutAction)(data));
+        }
+        catch {
+            const actionType = preloadActionType(dataOrig);
+            actions.push({
+                type: 'malformed',
+                subtype: actionType,
+                data: dataCell,
+            });
+        }
+        data = nextCell.beginParse();
+    }
+    return actions.reverse();
+}
 const verbosityToExecutorVerbosity = {
     none: 'short',
     vm_logs: 'full',
@@ -130,24 +199,24 @@ exports.EmulationError = EmulationError;
 class SmartContract {
     address;
     blockchain;
-    #account;
-    #parsedAccount;
-    #lastTxTime;
-    #verbosity;
-    #debug;
+    _account;
+    parsedAccount;
+    lastTxTime;
+    _verbosity;
+    _debug;
     constructor(shardAccount, blockchain) {
         this.address = shardAccount.account.addr;
-        this.#account = (0, core_1.beginCell)().store((0, core_1.storeShardAccount)(shardAccount)).endCell().toBoc().toString('base64');
-        this.#parsedAccount = shardAccount;
-        this.#lastTxTime = shardAccount.account?.storageStats.lastPaid ?? 0;
+        this._account = (0, core_1.beginCell)().store((0, core_1.storeShardAccount)(shardAccount)).endCell().toBoc().toString('base64');
+        this.parsedAccount = shardAccount;
+        this.lastTxTime = shardAccount.account?.storageStats.lastPaid ?? 0;
         this.blockchain = blockchain;
     }
     snapshot() {
         return (0, deepcopy_1.deepcopy)({
             address: this.address,
             account: this.account,
-            lastTxTime: this.#lastTxTime,
-            verbosity: this.#verbosity,
+            lastTxTime: this.lastTxTime,
+            verbosity: this._verbosity,
         });
     }
     loadFrom(snapshot) {
@@ -155,8 +224,8 @@ class SmartContract {
             throw new Error('Wrong snapshot address');
         }
         this.account = (0, deepcopy_1.deepcopy)(snapshot.account);
-        this.#lastTxTime = snapshot.lastTxTime;
-        this.#verbosity = snapshot.verbosity === undefined ? undefined : { ...snapshot.verbosity };
+        this.lastTxTime = snapshot.lastTxTime;
+        this._verbosity = snapshot.verbosity === undefined ? undefined : { ...snapshot.verbosity };
     }
     get ec() {
         return (0, ec_1.extractEc)(this.account.account?.storage.balance.other ??
@@ -191,15 +260,15 @@ class SmartContract {
         return this.account.account?.storage.state;
     }
     get account() {
-        if (this.#parsedAccount === undefined) {
-            this.#parsedAccount = (0, core_1.loadShardAccount)(core_1.Cell.fromBase64(this.#account).beginParse());
+        if (this.parsedAccount === undefined) {
+            this.parsedAccount = (0, core_1.loadShardAccount)(core_1.Cell.fromBase64(this._account).beginParse());
         }
-        return this.#parsedAccount;
+        return this.parsedAccount;
     }
     set account(account) {
-        this.#account = (0, core_1.beginCell)().store((0, core_1.storeShardAccount)(account)).endCell().toBoc().toString('base64');
-        this.#parsedAccount = account;
-        this.#lastTxTime = account.account?.storageStats.lastPaid ?? 0;
+        this._account = (0, core_1.beginCell)().store((0, core_1.storeShardAccount)(account)).endCell().toBoc().toString('base64');
+        this.parsedAccount = account;
+        this.lastTxTime = account.account?.storageStats.lastPaid ?? 0;
     }
     static create(blockchain, args) {
         return new SmartContract(createShardAccount(args), blockchain);
@@ -209,14 +278,14 @@ class SmartContract {
     }
     createCommonArgs(params) {
         const now = params?.now ?? this.blockchain.now ?? Math.floor(Date.now() / 1000);
-        if (now < this.#lastTxTime) {
-            throw new TimeError(this.address, this.#lastTxTime, now);
+        if (now < this.lastTxTime) {
+            throw new TimeError(this.address, this.lastTxTime, now);
         }
         return {
             config: this.blockchain.configBase64,
             libs: this.blockchain.libs ?? null,
             verbosity: verbosityToExecutorVerbosity[this.verbosity.vmLogs],
-            shardAccount: this.#account,
+            shardAccount: this._account,
             now,
             lt: this.blockchain.lt,
             randomSeed: params?.randomSeed ?? this.blockchain.random ?? Buffer.alloc(32),
@@ -272,16 +341,16 @@ class SmartContract {
             console.log(res.debugLogs);
         }
         const tx = (0, core_1.loadTransaction)(core_1.Cell.fromBase64(res.result.transaction).beginParse());
-        this.#account = res.result.shardAccount;
-        this.#parsedAccount = undefined;
-        this.#lastTxTime = tx.now;
+        this._account = res.result.shardAccount;
+        this.parsedAccount = undefined;
+        this.lastTxTime = tx.now;
         let newStorage = undefined;
         if (this.blockchain.recordStorage && this.account.account?.storage.state.type === 'active') {
             newStorage = this.account.account?.storage.state.state.data ?? undefined;
         }
         let outActions = undefined;
         if (res.result.actions) {
-            outActions = (0, core_1.loadOutList)(core_1.Cell.fromBase64(res.result.actions).beginParse());
+            outActions = loadOutListExt(core_1.Cell.fromBase64(res.result.actions).beginParse());
         }
         return {
             ...tx,
@@ -367,7 +436,7 @@ class SmartContract {
     get verbosity() {
         return {
             ...this.blockchain.verbosity,
-            ...this.#verbosity,
+            ...this._verbosity,
         };
     }
     set verbosity(value) {
@@ -375,21 +444,21 @@ class SmartContract {
     }
     setVerbosity(verbosity) {
         if (typeof verbosity === 'string') {
-            this.#verbosity = {
-                ...this.#verbosity,
+            this._verbosity = {
+                ...this._verbosity,
                 vmLogs: verbosity,
                 blockchainLogs: verbosity !== 'none',
             };
         }
         else {
-            this.#verbosity = verbosity;
+            this._verbosity = verbosity;
         }
     }
     get debug() {
-        return this.#debug ?? this.blockchain.debug;
+        return this._debug ?? this.blockchain.debug;
     }
     setDebug(debug) {
-        this.#debug = debug;
+        this._debug = debug;
     }
 }
 exports.SmartContract = SmartContract;

package/dist/utils/AsyncLock.d.ts

@@ -1,5 +1,5 @@
 export declare class AsyncLock {
-    #private;
+    private waiters;
     acquire(): Promise<void>;
     release(): Promise<void>;
     with<T>(fn: () => Promise<T>): Promise<T>;

package/dist/utils/AsyncLock.js

@@ -9,16 +9,16 @@ function createWaiter() {
     return { promise, resolve: resolveFn };
 }
 class AsyncLock {
-    #waiters = [];
+    waiters = [];
     async acquire() {
-        const waiters = this.#waiters.map((w) => w.promise);
-        this.#waiters.push(createWaiter());
+        const waiters = this.waiters.map((w) => w.promise);
+        this.waiters.push(createWaiter());
         if (waiters.length > 0) {
             await Promise.all(waiters);
         }
     }
     async release() {
-        const waiter = this.#waiters.shift();
+        const waiter = this.waiters.shift();
         if (waiter !== undefined) {
             waiter.resolve();
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ton/sandbox",
-  "version": "0.38.0-dev.20251014114055.f2fd72c",
+  "version": "0.38.0",
   "description": "TON transaction emulator",
   "main": "dist/index.js",
   "license": "MIT",