五一劳动节,讲讲NEO智能合约的调试

时间:2023-03-08 17:16:41

之前我们说过NEO智能合约的调试问题,过去了一段时间,有很多东西都发生了比较大的变化。让我们重新再来探讨一下这个话题。

先说日期,2018年4月27日,马上迎来劳动节。

 

以后可能还会再次谈论这个话题。

 

然后明确几个问题,把一些经常纠结的地方先说清楚

  1. 如果你连neo同步区块还没搞明白,先不要凑智能合约开发这个热闹。
  2. 我们只讨论C#开发智能合约的调试问题,其它的暂无工具开发计划。
  3. NEO官方没有智能合约调试工具,所以我们的工具是有很多定制的成分。
    1. 为什么要调试

一次编码,按下f5,一切正常,挥一挥衣袖就潇洒的离开,那是传说。

当代码执行不符合预期时,我们需要深入分析问题,需要更精细的观测手段。

 

而NEO官方并没有提供这样的工具,于是我们开发了一揽子工具用于解决调试问题

他们是:

  1. NeonDebug 替换的c#智能合约编译器
  2. NeoGUI-NEL 定制版NeoGUI 或者 NeoCli-NEl 定制版的NeoCli
  3. NeonDebugGUI,智能合约执行情况观测工具

 

为了3的正常运行,1 2 都是必须的,如果你想知道为什么,源码可以告诉你答案

 

https://github.com/NewEconoLab/neondebug

https://github.com/NewEconoLab/neo-gui-nel

 

  1. 合约的编译

你可曾听过NeoVM,AVM文件,就是智能合约编译生成的那东西,就是NeoVM的字节码,叫AVM是因为以前叫小蚁,ant的A,这个扩展名没一起改。

 

为了方便不那么了解虚拟机的开发者理解,我和C#的类库机制做一个对比。

 

这个AVM相当于是DLL,要调试一个c# DLL,你需要DLL PDB cs源码三部分内容。DLL存储字节码,PDB存储字节码地址和源码位置的映射,这样才能在断点时根据字节码执行位置定位到源码位置,而cs源码,就是为了让你调试时对照到代码

 

那么:

DLL-》AVM

PDB-》?

cs-》cs

 

标准的c#编译器neon.exe(如果不知道neon.exe,再好好补一下C#智能合约编译的相关资料),只生成了一个AVM和一个ABI文件,这个ABI是接口说明。

PDB对应的角色是空缺的

 

所以你需要 NEL 的 Neon.exe ,编译neondebug仓库的neondebug项目可以得到这个替换的neon.exe

 

设置环境变量,保证在任何路径可以执行neon

五一劳动节,讲讲NEO智能合约的调试

注意红框部分,有Debug字样

 

这个替换的编译器,就专门解决那个缺失的PDB问题,这个编译器和官方编译器代码随时同步更新,你直接使用这个替换的编译器就行,任何更新都会同步,不需要切换回官方编译器。

 

重启VS2017之后,来编译一个智能合约试试

五一劳动节,讲讲NEO智能合约的调试

注意红框部分,已经使用了我们的替换版本编译 有(debug)字样

下一行告诉你,在c:\neo\smartcontracts输出了些什么,让我们来看看。

五一劳动节,讲讲NEO智能合约的调试

首先原来的avm照样输出,这些是另外多输出的

 

文件名全部替换为了合约hash,avm还是那个avm

Abi.json还是那个abi

Cs是把智能合约源码copy 过来的,只支持一个智能合约项目有一个代码文件,所以不要分文件。

Map就是替代PDB的那个了,他记录字节码地址和源代码地址的映射关系

 

生成在这个路径也是有意义的,调试查看工具会直接来这个路径找合约,以前需要用调试查看工具再打开一次合约,现在不用了,直接用同一个路径。

 

  1. 合约的调用

A,用neogui 测试执行合约

    用neogui-nel,测试执行一个合约,只有nel定制版支持。

    五一劳动节,讲讲NEO智能合约的调试

五一劳动节,讲讲NEO智能合约的调试

试运行固定产生一个0x00 的log文件,看这个log就可以调试了,这个下一节再说,我们这里之说产生log文件的办法。

 

产生这个log是调试的唯一办法。

 

B 、用NEOCLI 测试执行合约

调用NEOCLI -NEL的 rpc invokescript 接口,会在返回值多返回一个fulllog字段,将其保存为文件,就是这个llvmhex文件,可以用来调试。

只有nel定制版支持

C、用NEOGUI发交易

用NEL定制版NEOGUI发起交易,只有nel定制版支持

 

五一劳动节,讲讲NEO智能合约的调试

 

发起交易,

五一劳动节,讲讲NEO智能合约的调试

会得到交易id同名的llvm文件

Id[0]

Id[1]

这种为鉴权合约的log

只有通过neogui nel定制版发起交易 或者 neocli nel定制版的 rpc接口 sendraw发起交易

才会产生鉴权合约的log,才可以调试鉴权合约,其他只调试应用合约

D、通过NEOCLI的sendraw RPC 发起交易

只有nel定制版支持

会得到交易id同名的llvm文件

Id[0]

Id[1]

这种为鉴权合约的log

E、通过其他方式产生的交易

由于交易会同步给每一个节点,定制的neo-gui-nel,和neo-gui-cli

可以得到所有的交易,无论是谁产生的。

但是做智能合约的调试的LOG是很耗时的,所以他并不总是打开的,有一个开关去控制他

这个开关在config.json里面

五一劳动节,讲讲NEO智能合约的调试

NEOGUI-nel的设置为true,表示只生成这个GUI自己发起的交易的LOG

打开这个同步就会变得非常慢,调试的时候再用。

 

NEOGUI-nel不修改这个config 也可以打开生成任何人发起的交易的开关

五一劳动节,讲讲NEO智能合约的调试

这里按一下让他显示为=false,然后之后同步的每一笔交易都会生成调试LOG了

这个只在内存修改,每次打开neo-gui都要看一眼。

 

  1. 合约的调试

编译,启动NeonDebugGUI

略,他也在NeonDebug仓库中

 

五一劳动节,讲讲NEO智能合约的调试

使用Load 打开对应的llvmhex.txt文件即可调试

这两个load,一个是打开一个对话框,一个是输入txid自己去找,结果都一样。

 

功能介绍

五一劳动节,讲讲NEO智能合约的调试

打开调试LOG以后

图中红黄蓝部分先注意一下

红色部分最重要,首先观察合约执行状态 halt break 为vm正常停机,程序正常走到结束。

Fault break为vm异常停机,你可以直接反着从最下边看看到底怎么了。

 

红色部分为整个VM内Dump下来的执行流程,也就是整个智能合约的过程到底干了什么,从红色部分选择最上面一项,然后用键盘的方向键下,往下挪,先完整的看几个合约,可以建立一些基本的感觉。

 

黄色部分为智能合约源码,当红色部分选中条目变化时,如果能找到对应的源码,黄色部分就会跳转高亮。

 

通常最主要的调试观测方法就是选红色、看黄色。

 

然后蓝色部分收集了所有syscall,因为neoVM的虚拟机自身是纯计算,所有对链产生影响或者和链互访的功能都是通过syscall进行的,看一个合约有哪些syscall就能快速了解这个合约的行为,当然这需要建立在熟悉的基础上,只要多看,就能熟悉。

调试小提示

  1. 红色部分最重要
  2. 选中条目时,执行栈显示的这条指令执行之后的状态。

比如

五一劳动节,讲讲NEO智能合约的调试

Equal指令是==表达式,他显示的false只能告诉你是不想等,要看是谁和谁比较,往前倒退一条指令

五一劳动节,讲讲NEO智能合约的调试

倒退后观测计算栈,valuetool 会帮助你显示这个数据可能是什么

  1. 是多条虚拟机指令对应一条cs源码,并且有些是对应不到的。

记住这一点,而不能只盯着源码,左边最重要,左边要选到关键的代码。

你要搞清楚那些最关键的指令,比如syscall appcall equal

这并不会有多复杂,知道找关键指令就会快很多。

  1. 一定要熟悉syscall

最重要的storage.put 就是一个syscall