@ton/sandbox 0.21.0 → 0.22.0

package/CHANGELOG.md

@@ -5,6 +5,12 @@ 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.22.0] - 2024-09-17
+
+### Added
+
+- Added `blockchain.recordStorage` flag. If set to `true`, `BlockchainTransaction` will have `oldStorage` and `newStorage` fields. Note that enabling this flag will disable a certain optimization, which will slow down contract emulation
+
 ## [0.21.0] - 2024-09-16
 
 ### Added

package/dist/blockchain/Blockchain.d.ts

@@ -26,6 +26,8 @@ export type BlockchainTransaction = Transaction & {
     parent?: BlockchainTransaction;
     children: BlockchainTransaction[];
     externals: ExternalOut[];
+    oldStorage?: Cell;
+    newStorage?: Cell;
 };
 /**
  * @type SendMessageResult Represents the result of sending a message.
@@ -98,6 +100,7 @@ export declare class Blockchain {
     protected lock: AsyncLock;
     protected contractFetches: Map<string, Promise<SmartContract>>;
     protected nextCreateWalletIndex: number;
+    protected shouldRecordStorage: boolean;
     readonly executor: IExecutor;
     /**
      * Saves snapshot of current blockchain.
@@ -115,6 +118,8 @@ export declare class Blockchain {
      * @param snapshot Snapshot of blockchain
      */
     loadFrom(snapshot: BlockchainSnapshot): Promise<void>;
+    get recordStorage(): boolean;
+    set recordStorage(v: boolean);
     /**
      * @returns Current time in blockchain
      */

package/dist/blockchain/Blockchain.js

@@ -81,6 +81,12 @@ class Blockchain {
         this.globalLibs = snapshot.libs;
         this.nextCreateWalletIndex = snapshot.nextCreateWalletIndex;
     }
+    get recordStorage() {
+        return this.shouldRecordStorage;
+    }
+    set recordStorage(v) {
+        this.shouldRecordStorage = v;
+    }
     /**
      * @returns Current time in blockchain
      */
@@ -112,6 +118,7 @@ class Blockchain {
         this.lock = new AsyncLock_1.AsyncLock();
         this.contractFetches = new Map();
         this.nextCreateWalletIndex = 0;
+        this.shouldRecordStorage = false;
         this.networkConfig = blockchainConfigToBase64(opts.config);
         this.executor = opts.executor;
         this.storage = opts.storage;

package/dist/blockchain/SmartContract.d.ts

@@ -21,6 +21,8 @@ export type SmartContractTransaction = Transaction & {
     blockchainLogs: string;
     vmLogs: string;
     debugLogs: string;
+    oldStorage?: Cell;
+    newStorage?: Cell;
 };
 export type MessageParams = Partial<{
     now: number;

package/dist/blockchain/SmartContract.js

@@ -222,6 +222,10 @@ class SmartContract {
         }));
     }
     async runCommon(run) {
+        let oldStorage = undefined;
+        if (this.blockchain.recordStorage && this.account.account?.storage.state.type === 'active') {
+            oldStorage = this.account.account?.storage.state.state.data ?? undefined;
+        }
         const res = await run();
         if (this.verbosity.print && this.verbosity.blockchainLogs && res.logs.length > 0) {
             console.log(res.logs);
@@ -239,11 +243,17 @@ class SmartContract {
         __classPrivateFieldSet(this, _SmartContract_account, res.result.shardAccount, "f");
         __classPrivateFieldSet(this, _SmartContract_parsedAccount, undefined, "f");
         __classPrivateFieldSet(this, _SmartContract_lastTxTime, tx.now, "f");
+        let newStorage = undefined;
+        if (this.blockchain.recordStorage && this.account.account?.storage.state.type === 'active') {
+            newStorage = this.account.account?.storage.state.state.data ?? undefined;
+        }
         return {
             ...tx,
             blockchainLogs: res.logs,
             vmLogs: res.result.vmLog,
             debugLogs: res.debugLogs,
+            oldStorage,
+            newStorage,
         };
     }
     async get(method, stack = [], params) {

package/package.json

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