chore: rename to TxTracer (#1)

Author: i582

README.md

@@ -1,6 +1,6 @@
-# retracer-core
+# TxTracer-core
 
-**retracer-core** is a core library for deep analysis, emulation, and tracing of transactions on the TON blockchain. The library allows you to reproduce transaction execution in a local sandbox, obtain detailed reports on computation, actions, and money flow, and collect low-level information about blocks, accounts, and messages.
+**TxTracer-core** is a core library for deep analysis, emulation, and tracing of transactions on the TON blockchain. The library allows you to reproduce transaction execution in a local sandbox, obtain detailed reports on computation, actions, and money flow, and collect low-level information about blocks, accounts, and messages.
 
 ## Features
 
@@ -13,15 +13,15 @@
 ## Installation
 
 ```bash
-yarn add @tact-lang/retracer-core
+yarn add @tact-lang/txtracer-core
 # or
-npm install @tact-lang/retracer-core
+npm install @tact-lang/txtracer-core
 ```
 
 ## Quick Start
 
 ```ts
-import { retrace } from "@tact-lang/retracer-core"
+import { retrace } from "@tact-lang/txtracer-core"
 
 // Example: trace a transaction by its hash
 const result = await retrace(false, "YOUR_TX_HASH")
@@ -33,19 +33,19 @@ console.log(result)
 ### Transaction Tracing
 
 ```ts
-import { retrace } from "@tact-lang/retracer-core"
+import { retrace } from "@tact-lang/txtracer-core"
 
 /**
  * @param testnet - true for testnet, false for mainnet
  * @param txHash - hex transaction hash
- * @returns Detailed execution report (RetraceResult)
+ * @returns Detailed execution report (TraceResult)
  */
 const result = await retrace(testnet, txHash)
 ```
 
 ### Helper Methods
 
-All methods are exported from `@tact-lang/retracer-core` and can be used independently:
+All methods are exported from `@tact-lang/txtracer-core` and can be used independently:
 
 - **findBaseTxByHash(testnet, txHash)** — Find base transaction info by hash.
 - **findRawTxByHash(testnet, baseTxInfo)** — Get full transaction details.
@@ -63,7 +63,7 @@ All methods are exported from `@tact-lang/retracer-core` and can be used indepen
 
 ## Types
 
-All main types (transactions, blocks, messages, tracing results) are exported from `@tact-lang/retracer-core` and are fully typed (see [src/types.ts](src/types.ts)).
+All main types (transactions, blocks, messages, tracing results) are exported from `@tact-lang/txtracer-core` and are fully typed (see [src/types.ts](src/types.ts)).
 
 ## License
 
@@ -72,4 +72,4 @@ MIT © TON Studio
 ## Links
 
 - [TON Documentation](https://ton.org/docs/)
-- [Source code & issue tracker](https://github.com/tact-lang/retracer-core)
+- [Source code & issue tracker](https://github.com/tact-lang/txtracer-core)

package.json

@@ -1,7 +1,7 @@
 {
-    "name": "@tact-lang/retracer-core",
+    "name": "@tact-lang/txtracer-core",
     "version": "0.0.1",
-    "description": "Core retracer library for collecting transaction information",
+    "description": "Core TxTracer library for collecting transaction information",
     "main": "dist/index.js",
     "scripts": {
         "build": "tsc --declaration",
@@ -18,14 +18,14 @@
     ],
     "repository": {
         "type": "git",
-        "url": "git+https://github.com/tact-lang/retracer-core.git"
+        "url": "git+https://github.com/tact-lang/txtracer-core.git"
     },
     "author": "TON Studio",
     "license": "MIT",
     "bugs": {
-        "url": "https://github.com/tact-lang/retracer-core/issues"
+        "url": "https://github.com/tact-lang/txtracer-core/issues"
     },
-    "homepage": "https://github.com/tact-lang/retracer-core#readme",
+    "homepage": "https://github.com/tact-lang/txtracer-core#readme",
     "files": [
         "dist",
         "!dist/test"

src/methods.ts

@@ -19,7 +19,7 @@ import {
     BlockInfo,
     BlocksResponse,
     RawTransaction,
-    RetraceMoneyResult,
+    TraceMoneyResult,
     TransactionData,
     ComputeInfo,
     GetLibResponse,
@@ -546,7 +546,7 @@ export const computeFinalData = (res: EmulationResultSuccess, balanceBefore: big
 
     if (emulatedTx.description.type !== "generic") {
         throw new Error(
-            "Retracer doesn't support non-generic transaction. Given type: " +
+            "TxTracer doesn't support non-generic transaction. Given type: " +
                 emulatedTx.description.type,
         )
     }
@@ -566,7 +566,7 @@ export const computeFinalData = (res: EmulationResultSuccess, balanceBefore: big
                   gasFees: computePhase.gasFees,
               }
 
-    const money: RetraceMoneyResult = {
+    const money: TraceMoneyResult = {
         balanceBefore,
         sentTotal,
         totalFees,

src/runner.ts

@@ -1,4 +1,4 @@
-import {RetraceResult} from "./types"
+import {TraceResult} from "./types"
 import {
     collectUsedLibraries,
     computeFinalData,
@@ -31,12 +31,12 @@ import {Buffer} from "node:buffer"
  * 4.  Emulate the target transaction itself with full VM verbosity.
  * 5.  Parse the resulting VM log (`c5`, action list, stack trace), compare the
  *     calculated state‑hash with the on‑chain one and assemble a
- *     `RetraceResult` object for the caller.
+ *     `TraceResult` object for the caller.
  *
  * @param testnet  When `true`, work against testnet endpoints; otherwise mainnet.
  * @param txLink   Hex hash that uniquely identifies the transaction to retrace.
  *
- * @returns        A {@link RetraceResult} containing:
+ * @returns        A {@link TraceResult} containing:
  *                 1. an integrity flag `stateUpdateHashOk`
  *                 2. decoded an incoming message (sender / contract / amount)
  *                 3. balance delta, gas and fees
@@ -49,7 +49,7 @@ import {Buffer} from "node:buffer"
  *                 diverges (TVM returns non‑success); or if state‑hash
  *                 mismatch is detected after replay.
  */
-export const retrace = async (testnet: boolean, txLink: string): Promise<RetraceResult> => {
+export const retrace = async (testnet: boolean, txLink: string): Promise<TraceResult> => {
     const baseTx = await findBaseTxByHash(testnet, txLink)
     if (baseTx === undefined) {
         throw new Error("Cannot find transaction info")

src/test/__snapshots__/test.spec.ts.snap

@@ -157,19 +157,19 @@ exports[`transactions should return correct information for transaction with ext
 }
 `;
 
-exports[`transactions should return correct information for transaction with external-in message for wallet v5 that retracer cannot fully recreate 1`] = `"b5ee9c7241021401000281000114ff00f4a413f4bcf2c80b01020120020d020148030402dcd020d749c120915b8f6320d70b1f2082106578746ebd21821073696e74bdb0925f03e082106578746eba8eb48020d72101d074d721fa4030fa44f828fa443058bd915be0ed44d0810141d721f4058307f40e6fa1319130e18040d721707fdb3ce03120d749810280b99130e070e2100f020120050c020120060902016e07080019adce76a2684020eb90eb85ffc00019af1df6a2684010eb90eb858fc00201480a0b0017b325fb51341c75c875c2c7e00011b262fb513435c280200019be5f0f6a2684080a0eb90fa02c0102f20e011e20d70b1f82107369676ebaf2e08a7f0f01e68ef0eda2edfb218308d722028308d723208020d721d31fd31fd31fed44d0d200d31f20d31fd3ffd70a000af90140ccf9109a28945f0adb31e1f2c087df02b35007b0f2d0845125baf2e0855036baf2e086f823bbf2d0882292f800de01a47fc8ca00cb1f01cf16c9ed542092f80fde70db3cd81003f6eda2edfb02f404216e926c218e4c0221d73930709421c700b38e2d01d72820761e436c20d749c008f2e09320d74ac002f2e09320d71d06c712c2005230b0f2d089d74cd7393001a4e86c128407bbf2e093d74ac000f2e093ed55e2d20001c000915be0ebd72c08142091709601d72c081c12e25210b1e30f20d74a111213009601fa4001fa44f828fa443058baf2e091ed44d0810141d718f405049d7fc8ca0040048307f453f2e08b8e14038307f45bf2e08c22d70a00216e01b3b0f2d090e2c85003cf1612f400c9ed54007230d72c08248e2d21f2e092d200ed44d0d2005113baf2d08f54503091319c01810140d721d70a00f2e08ee2c8ca0058cf16c9ed5493f2c08de20010935bdb31e1d74cd0b4d6c35e"`;
+exports[`transactions should return correct information for transaction with external-in message for wallet v5 that txtracer cannot fully recreate 1`] = `"b5ee9c7241021401000281000114ff00f4a413f4bcf2c80b01020120020d020148030402dcd020d749c120915b8f6320d70b1f2082106578746ebd21821073696e74bdb0925f03e082106578746eba8eb48020d72101d074d721fa4030fa44f828fa443058bd915be0ed44d0810141d721f4058307f40e6fa1319130e18040d721707fdb3ce03120d749810280b99130e070e2100f020120050c020120060902016e07080019adce76a2684020eb90eb85ffc00019af1df6a2684010eb90eb858fc00201480a0b0017b325fb51341c75c875c2c7e00011b262fb513435c280200019be5f0f6a2684080a0eb90fa02c0102f20e011e20d70b1f82107369676ebaf2e08a7f0f01e68ef0eda2edfb218308d722028308d723208020d721d31fd31fd31fed44d0d200d31f20d31fd3ffd70a000af90140ccf9109a28945f0adb31e1f2c087df02b35007b0f2d0845125baf2e0855036baf2e086f823bbf2d0882292f800de01a47fc8ca00cb1f01cf16c9ed542092f80fde70db3cd81003f6eda2edfb02f404216e926c218e4c0221d73930709421c700b38e2d01d72820761e436c20d749c008f2e09320d74ac002f2e09320d71d06c712c2005230b0f2d089d74cd7393001a4e86c128407bbf2e093d74ac000f2e093ed55e2d20001c000915be0ebd72c08142091709601d72c081c12e25210b1e30f20d74a111213009601fa4001fa44f828fa443058baf2e091ed44d0810141d718f405049d7fc8ca0040048307f453f2e08b8e14038307f45bf2e08c22d70a00216e01b3b0f2d090e2c85003cf1612f400c9ed54007230d72c08248e2d21f2e092d200ed44d0d2005113baf2d08f54503091319c01810140d721d70a00f2e08ee2c8ca0058cf16c9ed5493f2c08de20010935bdb31e1d74cd0b4d6c35e"`;
 
-exports[`transactions should return correct information for transaction with external-in message for wallet v5 that retracer cannot fully recreate 2`] = `undefined`;
+exports[`transactions should return correct information for transaction with external-in message for wallet v5 that txtracer cannot fully recreate 2`] = `undefined`;
 
-exports[`transactions should return correct information for transaction with external-in message for wallet v5 that retracer cannot fully recreate 3`] = `"EQAGV9thOGkeBhzFzLOom0er5l6ertdXHWDoQv4yoKL1ELkU"`;
+exports[`transactions should return correct information for transaction with external-in message for wallet v5 that txtracer cannot fully recreate 3`] = `"EQAGV9thOGkeBhzFzLOom0er5l6ertdXHWDoQv4yoKL1ELkU"`;
 
-exports[`transactions should return correct information for transaction with external-in message for wallet v5 that retracer cannot fully recreate 4`] = `undefined`;
+exports[`transactions should return correct information for transaction with external-in message for wallet v5 that txtracer cannot fully recreate 4`] = `undefined`;
 
-exports[`transactions should return correct information for transaction with external-in message for wallet v5 that retracer cannot fully recreate 5`] = `55778062000001n`;
+exports[`transactions should return correct information for transaction with external-in message for wallet v5 that txtracer cannot fully recreate 5`] = `55778062000001n`;
 
-exports[`transactions should return correct information for transaction with external-in message for wallet v5 that retracer cannot fully recreate 6`] = `1743947933`;
+exports[`transactions should return correct information for transaction with external-in message for wallet v5 that txtracer cannot fully recreate 6`] = `1743947933`;
 
-exports[`transactions should return correct information for transaction with external-in message for wallet v5 that retracer cannot fully recreate 7`] = `
+exports[`transactions should return correct information for transaction with external-in message for wallet v5 that txtracer cannot fully recreate 7`] = `
 {
   "exitCode": 0,
   "gasFees": 1975600n,
@@ -179,14 +179,14 @@ exports[`transactions should return correct information for transaction with ext
 }
 `;
 
-exports[`transactions should return correct information for transaction with external-in message for wallet v5 that retracer cannot fully recreate 8`] = `
+exports[`transactions should return correct information for transaction with external-in message for wallet v5 that txtracer cannot fully recreate 8`] = `
 "x{0EC3C86D03}
  x{}
  x{4200429221FC2CCFF352ED1A7F21824D62705F59838DD95FDAB31AF54A10943E141D20DB0F1A0000000000000000000000000001}
   x{000000003130302054656C656772616D205374617273200A0A52656623573069313642655568}"
 `;
 
-exports[`transactions should return correct information for transaction with external-in message for wallet v5 that retracer cannot fully recreate 9`] = `
+exports[`transactions should return correct information for transaction with external-in message for wallet v5 that txtracer cannot fully recreate 9`] = `
 {
   "balanceAfter": 10895548167n,
   "balanceBefore": 11358352965n,

src/test/test.spec.ts

@@ -1,5 +1,5 @@
 import {retrace} from "../runner"
-import {RetraceResult} from "../types"
+import {TraceResult} from "../types"
 
 const DEFAULT_TIMEOUT = 100_000
 const DELAY_FOR_RATE_LIMIT = process.env["CI"] === undefined ? 5000 : 10_000
@@ -60,7 +60,7 @@ describe("transactions", () => {
     )
 
     it(
-        "should return correct information for transaction with external-in message for wallet v5 that retracer cannot fully recreate",
+        "should return correct information for transaction with external-in message for wallet v5 that txtracer cannot fully recreate",
         async () => {
             await wait()
 
@@ -88,7 +88,7 @@ describe("transactions", () => {
         DEFAULT_TIMEOUT,
     )
 
-    function checkResult(res: RetraceResult, expectedOk: boolean = true): void {
+    function checkResult(res: TraceResult, expectedOk: boolean = true): void {
         expect(res.stateUpdateHashOk).toEqual(expectedOk)
         expect(res.codeCell?.toBoc().toString("hex")).toMatchSnapshot()
         expect(res.inMsg.sender?.toString()).toMatchSnapshot()

src/types.ts

@@ -243,7 +243,7 @@ export type ComputeInfo =
           gasFees: bigint
       }
 
-export interface RetraceInMessage {
+export interface TraceInMessage {
     /**
      * Sender of in-message
      *
@@ -262,7 +262,7 @@ export interface RetraceInMessage {
     amount: bigint | undefined
 }
 
-export interface RetraceEmulatedTx {
+export interface TraceEmulatedTx {
     /**
      * Unix timestamp of the emulated transaction
      */
@@ -295,7 +295,7 @@ export interface RetraceEmulatedTx {
     vmLogs: string
 }
 
-export interface RetraceMoneyResult {
+export interface TraceMoneyResult {
     /**
      * Account balance before transaction
      */
@@ -315,8 +315,8 @@ export interface RetraceMoneyResult {
     balanceAfter: bigint
 }
 
-// Retracer result
-export interface RetraceResult {
+// TxTracer result
+export interface TraceResult {
     /**
      * Sets to true if the emulated transaction hash is equal to one from the real blockchain
      */
@@ -328,15 +328,15 @@ export interface RetraceResult {
     /**
      * Information about in-message
      */
-    inMsg: RetraceInMessage
+    inMsg: TraceInMessage
     /**
      * Information about money-related things
      */
-    money: RetraceMoneyResult
+    money: TraceMoneyResult
     /**
      * Information about emulated transaction
      */
-    emulatedTx: RetraceEmulatedTx
+    emulatedTx: TraceEmulatedTx
     emulatorVersion: {
         commitHash: string
         commitDate: string

yarn.lock

@@ -1097,9 +1097,9 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@tact-lang/retracer-core@workspace:.":
+"@tact-lang/txtracer-core@workspace:.":
   version: 0.0.0-use.local
-  resolution: "@tact-lang/retracer-core@workspace:."
+  resolution: "@tact-lang/txtracer-core@workspace:."
   dependencies:
     "@ton/core": "npm:^0.60.1"
     "@ton/crypto": "npm:^3.3.0"