之前我们说过NEO智能合约的调试问题,过去了一段时间,有很多东西都发生了比较大的变化。让我们重新再来探讨一下这个话题。
先说日期,2018年4月27日,马上迎来劳动节。
以后可能还会再次谈论这个话题。
然后明确几个问题,把一些经常纠结的地方先说清楚
-
如果你连neo同步区块还没搞明白,先不要凑智能合约开发这个热闹。
-
我们只讨论C#开发智能合约的调试问题,其它的暂无工具开发计划。
-
NEO官方没有智能合约调试工具,所以我们的工具是有很多定制的成分。
-
为什么要调试
-
一次编码,按下f5,一切正常,挥一挥衣袖就潇洒的离开,那是传说。
当代码执行不符合预期时,我们需要深入分析问题,需要更精细的观测手段。
而NEO官方并没有提供这样的工具,于是我们开发了一揽子工具用于解决调试问题
他们是:
-
NeonDebug 替换的c#智能合约编译器
-
NeoGUI-NEL 定制版NeoGUI 或者 NeoCli-NEl 定制版的NeoCli
-
NeonDebugGUI,智能合约执行情况观测工具
为了3的正常运行,1 2 都是必须的,如果你想知道为什么,源码可以告诉你答案
https://github.com/NewEconoLab/neondebug
https://github.com/NewEconoLab/neo-gui-nel
-
合约的编译
你可曾听过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
注意红框部分,有Debug字样
这个替换的编译器,就专门解决那个缺失的PDB问题,这个编译器和官方编译器代码随时同步更新,你直接使用这个替换的编译器就行,任何更新都会同步,不需要切换回官方编译器。
重启VS2017之后,来编译一个智能合约试试
注意红框部分,已经使用了我们的替换版本编译 有(debug)字样
下一行告诉你,在c:\neo\smartcontracts输出了些什么,让我们来看看。
首先原来的avm照样输出,这些是另外多输出的
文件名全部替换为了合约hash,avm还是那个avm
Abi.json还是那个abi
Cs是把智能合约源码copy 过来的,只支持一个智能合约项目有一个代码文件,所以不要分文件。
Map就是替代PDB的那个了,他记录字节码地址和源代码地址的映射关系
生成在这个路径也是有意义的,调试查看工具会直接来这个路径找合约,以前需要用调试查看工具再打开一次合约,现在不用了,直接用同一个路径。
-
合约的调用
A,用neogui 测试执行合约
用neogui-nel,测试执行一个合约,只有nel定制版支持。
试运行固定产生一个0x00 的log文件,看这个log就可以调试了,这个下一节再说,我们这里之说产生log文件的办法。
产生这个log是调试的唯一办法。
B 、用NEOCLI 测试执行合约
调用NEOCLI -NEL的 rpc invokescript 接口,会在返回值多返回一个fulllog字段,将其保存为文件,就是这个llvmhex文件,可以用来调试。
只有nel定制版支持
C、用NEOGUI发交易
用NEL定制版NEOGUI发起交易,只有nel定制版支持
发起交易,
会得到交易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里面
NEOGUI-nel的设置为true,表示只生成这个GUI自己发起的交易的LOG
打开这个同步就会变得非常慢,调试的时候再用。
NEOGUI-nel不修改这个config 也可以打开生成任何人发起的交易的开关
这里按一下让他显示为=false,然后之后同步的每一笔交易都会生成调试LOG了
这个只在内存修改,每次打开neo-gui都要看一眼。
-
合约的调试
编译,启动NeonDebugGUI
略,他也在NeonDebug仓库中
使用Load 打开对应的llvmhex.txt文件即可调试
这两个load,一个是打开一个对话框,一个是输入txid自己去找,结果都一样。
功能介绍
打开调试LOG以后
图中红黄蓝部分先注意一下
红色部分最重要,首先观察合约执行状态 halt break 为vm正常停机,程序正常走到结束。
Fault break为vm异常停机,你可以直接反着从最下边看看到底怎么了。
红色部分为整个VM内Dump下来的执行流程,也就是整个智能合约的过程到底干了什么,从红色部分选择最上面一项,然后用键盘的方向键下,往下挪,先完整的看几个合约,可以建立一些基本的感觉。
黄色部分为智能合约源码,当红色部分选中条目变化时,如果能找到对应的源码,黄色部分就会跳转高亮。
通常最主要的调试观测方法就是选红色、看黄色。
然后蓝色部分收集了所有syscall,因为neoVM的虚拟机自身是纯计算,所有对链产生影响或者和链互访的功能都是通过syscall进行的,看一个合约有哪些syscall就能快速了解这个合约的行为,当然这需要建立在熟悉的基础上,只要多看,就能熟悉。
调试小提示
-
红色部分最重要
-
选中条目时,执行栈显示的这条指令执行之后的状态。
比如
Equal指令是==表达式,他显示的false只能告诉你是不想等,要看是谁和谁比较,往前倒退一条指令
倒退后观测计算栈,valuetool 会帮助你显示这个数据可能是什么
-
是多条虚拟机指令对应一条cs源码,并且有些是对应不到的。
记住这一点,而不能只盯着源码,左边最重要,左边要选到关键的代码。
你要搞清楚那些最关键的指令,比如syscall appcall equal
这并不会有多复杂,知道找关键指令就会快很多。
-
一定要熟悉syscall
最重要的storage.put 就是一个syscall