@ton/sandbox 0.21.0 → 0.22.0-ecbeta.1

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;
@@ -69,6 +71,9 @@ export type SmartContractSnapshot = {
     lastTxTime: number;
     verbosity?: Partial<LogsVerbosity>;
 };
+export type ExtraCurrency = {
+    [key: number]: bigint;
+};
 export declare class SmartContract {
     #private;
     readonly address: Address;
@@ -76,6 +81,8 @@ export declare class SmartContract {
     constructor(shardAccount: ShardAccount, blockchain: Blockchain);
     snapshot(): SmartContractSnapshot;
     loadFrom(snapshot: SmartContractSnapshot): void;
+    get ec(): ExtraCurrency;
+    set ec(nv: ExtraCurrency);
     get balance(): bigint;
     set balance(v: bigint);
     get lastTransactionHash(): bigint;

package/dist/blockchain/SmartContract.js

@@ -122,6 +122,13 @@ class EmulationError extends Error {
     }
 }
 exports.EmulationError = EmulationError;
+function extractEc(cc) {
+    const r = {};
+    for (const [k, v] of cc) {
+        r[k] = v;
+    }
+    return r;
+}
 class SmartContract {
     constructor(shardAccount, blockchain) {
         _SmartContract_account.set(this, void 0);
@@ -150,6 +157,21 @@ class SmartContract {
         __classPrivateFieldSet(this, _SmartContract_lastTxTime, snapshot.lastTxTime, "f");
         __classPrivateFieldSet(this, _SmartContract_verbosity, snapshot.verbosity === undefined ? undefined : { ...snapshot.verbosity }, "f");
     }
+    get ec() {
+        return extractEc(this.account.account?.storage.balance.other ?? core_1.Dictionary.empty(core_1.Dictionary.Keys.Uint(32), core_1.Dictionary.Values.BigVarUint(5)));
+    }
+    set ec(nv) {
+        const cc = core_1.Dictionary.empty(core_1.Dictionary.Keys.Uint(32), core_1.Dictionary.Values.BigVarUint(5));
+        for (const [k, v] of Object.entries(nv)) {
+            cc.set(Number(k), v);
+        }
+        const acc = this.account;
+        if (acc.account === undefined) {
+            acc.account = createEmptyAccount(this.address);
+        }
+        acc.account.storage.balance.other = cc;
+        this.account = acc;
+    }
     get balance() {
         return this.account.account?.storage.balance.coins ?? 0n;
     }
@@ -222,6 +244,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 +265,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/dist/utils/message.d.ts

@@ -1,4 +1,4 @@
-import { Address, Cell, Message, StateInit } from "@ton/core";
+import { Address, Cell, Dictionary, Message, StateInit } from "@ton/core";
 /**
  * Creates {@link Message} from params.
  */
@@ -15,4 +15,5 @@ export declare function internal(params: {
     forwardFee?: bigint;
     createdAt?: number;
     createdLt?: bigint;
+    ec?: Dictionary<number, bigint> | [number, bigint][];
 }): Message;

package/dist/utils/message.js

@@ -6,12 +6,24 @@ const core_1 = require("@ton/core");
  * Creates {@link Message} from params.
  */
 function internal(params) {
+    let ecd = undefined;
+    if (params.ec !== undefined) {
+        if (Array.isArray(params.ec)) {
+            ecd = core_1.Dictionary.empty(core_1.Dictionary.Keys.Uint(32), core_1.Dictionary.Values.BigVarUint(5));
+            for (const [k, v] of params.ec) {
+                ecd.set(k, v);
+            }
+        }
+        else {
+            ecd = params.ec;
+        }
+    }
     return {
         info: {
             type: 'internal',
             dest: params.to,
             src: params.from,
-            value: { coins: params.value },
+            value: { coins: params.value, other: ecd },
             bounce: params.bounce ?? true,
             ihrDisabled: params.ihrDisabled ?? true,
             bounced: params.bounced ?? false,

package/package.json

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