Sui Replay CLI
Replay is a tool that allows you to replay a given transaction to check and analyze the transaction effects. In a nutshell, the replay tool will locally execute the transaction and compare its effects to the effects that exist on chain.
Using the replay tool, you can pass the --trace flag to generate execution traces for a transaction that can be used with the Move debugger. For more information about the Move debugger, see the Move Debugger page. You can run different analyses on the transaction traces such as gas profiling.
Usage
The main command for replaying a transaction follows. For all available flags and arguments, run sui replay --help.
sui replay --digest <digest>
After running this command, the tool generates a directory corresponding to the digest in <cur_directory>/.replay/<digest>, unless you set the --output-dir flag. The output directory is not automatically overwritten if you attempt to replay the same transaction more than once. If you want to overwrite this directory, include the --overwrite flag.
After successfully running the previous command, your console provides a response similar to the following:
Successfully replayed transaction
╭────────────────────────────────────────────────────────────────────────────────── ─────────────────╮
│ Transaction Effects │
├───────────────────────────────────────────────────────────────────────────────────────────────────┤
│ Digest: 5sbk5UYpQv1i84zkSBSWmowAmPTxw71U7Bb1gbiW5w4y │
│ Status: Success │
│ Executed Epoch: 816 │
│ Mutated Objects: │
│ ┌── │
│ │ ID: 0x03ff4587a65631bb43648a204588789e95c556eb3f577a0bbca49f0c70724fb6 │
│ │ Owner: Account Address ( 0xdae936b5ac98927cf44e9270dd3a045d04d17dd167f744e619d3ba79207f7068 ) │
│ │ Version: 524747425 │
│ │ Digest: 5a6zqDPxZi1iPYE4QCGGd9D2WN9fMzZGgAq4LQvYDKsH │
│ └── │
│ ┌── │
│ │ ID: 0x1e67adaf36d79a3f9e37dde8a8ea24122d4360b537cbaed29612c06267a5d23b │
│ │ Owner: Object ID: ( 0xe83c2da3f26cedac7ced3652dbfae0df591aeb51818d45fb33e91364d551d0cd ) │
│ │ Version: 524747425 │
│ │ Digest: 7CXwfqNEnXVHHDuFMxNQvpF7TqSDo65RkMh3byXX3qtW │
│ └── │
│ ┌── │
│ │ ID: 0x4044f18055b2eafa176865303c1d8aa257d2d750e4a003c24e86e2fab2151d4b │
│ │ Owner: Object ID: ( 0xa676f00193c93b812da927baf1e51bd408c2a32b14104df6c1af2b0e874f33ad ) │
│ │ Version: 524747425 │
│ │ Digest: B5qvW4VTQXHotjJ9becki57bnD45fcJvWN8gTzWViVN4 │
│ └── │
│ ┌── │
│ │ ID: 0x8ece4cb6de126eb5c7a375f90c221bdc16c81ad8f6f894af08e0b6c25fb50a45 │
│ │ Owner: Shared( 414117256 ) │
│ │ Version: 524747425 │
│ │ Digest: 68jzyz67fHfS3xczermH8FUmDXg82pJ75t8SWLkq5W3G │
│ └─ ─ │
│ ┌── │
│ │ ID: 0xd7aaa813f0ee8b63ea5a1ea85849a74f8d48210358b53d0de710de29566d6247 │
│ │ Owner: Object ID: ( 0xa30645bc6016097b9182a25eb57a50522a1c08216416b21be8fef564aeb6e0fe ) │
│ │ Version: 524747425 │
│ │ Digest: A57sAtSpBT6nmUMqbas5w6Kh6a7guhTgZTxM1JeQavy1 │
│ └── │
│ Shared Objects: │
│ ┌── │
│ │ ID: 0x8ece4cb6de126eb5c7a375f90c221bdc16c81ad8f6f894af08e0b6c25fb50a45 │
│ │ Version: 524747424 │
│ │ Digest: AHtPqe2Spt5N1ba5QiBtnkj3yBNTNV27av8FSKgbaS21 │
│ └── │
│ Deleted Objects: │
│ ┌── │
│ │ ID: 0xf2a44b7b1de81c8fbf11635411fa7cd2cdc8ae64b48dae13928d4d91066cf13b │
│ │ Version: 524747425 │
│ │ Digest: 7gyGAp71YXQRoxmFBaHxofQXAipvgHyBKPyxmdSJxyvz │
│ └── │
│ ┌── │
│ │ ID: 0xfe02a0286e87e702c6c9ccd87c3392033bdaf571aeed2f48982591e8ea5f21f5 │
│ │ Version: 524747425 │
│ │ Digest: 7gyGAp71YXQRoxmFBaHxofQXAipvgHyBKPyxmdSJxyvz │
│ └── │
│ Gas Object: │
│ ┌── │
│ │ ID: 0x03ff4587a65631bb43648a204588789e95c556eb3f577a0bbca49f0c70724fb6 │
│ │ Owner: Account Address ( 0xdae936b5ac98927cf44e9270dd3a045d04d17dd167f744e619d3ba79207f7068 ) │
│ │ Version: 524747425 │
│ │ Digest: 5a6zqDPxZi1iPYE4QCGGd9D2WN9fMzZGgAq4LQvYDKsH │
│ └── │
│ Gas Cost Summary: │
│ Storage Cost: 11187200 MIST │
│ Computation Cost: 1000000 MIST │
│ Storage Rebate: 13031568 MIST │
│ Non-refundable Storage Fee: 131632 MIST │
│ │
│ Transaction Dependencies: │
│ jTwsncjYXYtioZqfTZSpjLUaxWrNT2vyhSgjP3P9XGG │
│ 36GM8UKe7M71qQkSY468vnxcApxFuMErx4M8vF5fQdLs │
│ 4h5punxCyApywJVsWaux7Ym7mf7tzBECjp2avZTaLdue │
│ BvfZzvfVD8SYPAx6De3CVFrgrxdSVgEACqxtvBtiHm7R │
│ D3AKQmh6WsSv74cGeXpdE5cg3TdRHcptapPd2ySBQdFX │
│ D7LMC2Jzf9LH2FmeW4WW2qbHDgEBCfduDhFH3Y2LpQAH │
╰───────────────────────────────────────────────────────────────────────────────────────────────────╯
Transaction Gas Report for 5sbk5UYpQv1i84zkSBSWmowAmPTxw71U7Bb1gbiW5w4y
╭────────────────────────────┬──────────╮
│ Gas Info │ │
├────────────────────────────┼──────────┤
│ Computation Cost │ 1000000 │
│ Storage Cost │ 11187200 │
│ Storage Rebate │ 13031568 │
│ Non-Refundable Storage Fee │ 131632 │
│ Gas Used │ 947 │
│ Gas Budget │ 3089992 │
│ Gas Price │ 1000 │
│ Reference Gas Price │ 1000 │
│ Storage Gas Price │ 76 │
│ Rebate Rate │ 9900 │
╰────────────────────────────┴──────────╯
╭────────────────────────────────────────────────────────────────────┬───────┬────────────┬────────────╮
│ Object ID │ Bytes │ Old Rebate │ New Rebate │
├────────────────────────────────────────────────────────────────────┼───────┼────────────┼────────────┤
│ 0x03ff4587a65631bb43648a204588789e95c556eb3f577a0bbca49f0c70724fb6 │ 130 │ 988000 │ 988000 │
│ 0x1e67adaf36d79a3f9e37dde8a8ea24122d4360b537cbaed29612c06267a5d23b │ 461 │ 3503600 │ 3503600 │
│ 0x4044f18055b2eafa176865303c1d8aa257d2d750e4a003c24e86e2fab2151d4b │ 398 │ 3024800 │ 3024800 │
│ 0x8ece4cb6de126eb5c7a375f90c221bdc16c81ad8f6f894af08e0b6c25fb50a45 │ 175 │ 1330000 │ 1330000 │
│ 0xd7aaa813f0ee8b63ea5a1ea85849a74f8d48210358b53d0de710de29566d6247 │ 308 │ 2340800 │ 2340800 │
│ 0xf2a44b7b1de81c8fbf11635411fa7cd2cdc8ae64b48dae13928d4d91066cf13b │ 0 │ 988000 │ 0 │
│ 0xfe02a0286e87e702c6c9ccd87c3392033bdaf571aeed2f48982591e8ea5f21f5 │ 0 │ 988000 │ 0 │
╰──────────────────────────────────────────────── ────────────────────┴───────┴────────────┴────────────╯
The response above provides the transaction effects information, gas report, and a more detailed list of the each object's size and cost. For more information about the gas cost, please refer to the gas in sui page.
You can replay multiple transactions at once by using the --digests-path flag to specify a location of a file containing multiple transaction digests, one per line. By default, the entire batch is replayed regardless of the success or failure of an individual transaction execution. You can use the --terminate-early flag to terminate batch execution if an error occurs when replaying one of the transactions.