LOAD:NEXT社區小課堂 | 第十三課：NEO Python編譯器介紹（一）

NEXT社區|小課堂

由于近期NEXT社區加入很多新的小伙伴，有在校大學生，有對區塊鏈感興趣的傳統企業從業者。為了更方便、更系統的讓NEXT社區的伙伴們了解NEO的技術知識，因此我們開設了小課堂，每周3節，向大家普及NEO相關的知識要點！

NEXT社區小課堂|第十三課

NEOPython編譯器介紹

neo-boa編譯器介紹

neo-boa編譯器可將Python文件編譯為.avm格式，在NEO虛擬機中運行。NEO虛擬機可在NEO區塊鏈上執行合約。

編譯器支持Python語言子集。

1、目前功能

·?將Python語言子集編譯成.avm格式，在NEO虛擬機上運行

·??適用于Python3.4與3.5

2、未來功能

·?編譯更廣泛的Python語言子集

·??適用于Python3.6

3、已支持的Python功能

下文為目前支持的Python功能一覽。詳細介紹請參見boa.tests.src目錄中的案例

4、流控制

If、Else、Elif、While、Break、Methodcalls、Lamdbas、forxin

5、用于整數運算的算數運算符與相等運算符

ADD、SUB、MUL、DIV、ABS、LSHIFT、RSHIFT、AND、OR、XOR、MODULO、INVERT、GT、GTE、LT、LTE、EQ、NOTEQ

6、使用自定義內置功能進行列表創建。注意列表一經創建，其長度便不可更改。

fromboa.code.builtinsimportlist

#thisworks

x=list(length=10)

x=84

#thisalsoworks

x=

#thisdoesNOTwork

x=

x.append(1)

#支持列表操作

x=

y=x

#在可能的情況下，Python的某些__builtins__

Bitfinex推出首個連接CeFi和DeFi的L2橋接:金色財經報道，加密交易所Bitfinex推出了首個連接CeFi和DeFi的Layer-2橋，以將其中心化平臺與Layer-2去中心化交易平臺及子公司DeversiFi連接起來。該橋接將為用戶提供無需許可和以隱私為中心的體驗，并結合CeFi的高流動性、可訪問特性。該公司在發布的一份新聞稿中指出，交易最初將僅限于Tether（USDT），但未來可能會對各種ERC-20代幣開放。[2021/9/24 17:02:20]

#已經根據NEO虛擬機的特點以自定義的方式實現

fromboa.code.builtinsimportrange

xrange=range(1,30)

#thisalsoworks

foriinrange(2,21):

i=i1

安裝

1、使用pip

pipinstallneo-boa

2、手動安裝

克隆存儲庫，進入項目目錄后創建Python3虛擬環境，并通過以下指令激活。

python3?-mvenvvenvsourcevenv/bin/activate

或單獨安裝Python3.5

virtualenv?-p?/usr/local/bin/python3.5venvsourcevenv/bin/activate

或單獨安裝Python3.5

virtualenv?-p?/usr/local/bin/python3.5venvsourcevenv/bin/activate

接著，通過以下指令安裝需求

pipinstall?-rrequirements.txt

3、基本用途

編譯器使用指南如下

fromboa.compiler?import?CompilerCompiler.load_and_save('path/to/your/file.py')

4、許可證

·開源MIT?

·主作者為localhuman

5、boa.compiler.Compiler

動態 | 數據顯示：1000萬枚USDT從Bitfinex轉至火幣交易所:據Whale Aler監測數據顯示，北京時間11月26日18:58，1000萬枚USDT從Bitfinex交易所（0x876eabf開頭地址）轉至火幣交易所（0xd141627開頭地址）。[2019/11/26]

下文將介紹Compiler的具體實現細則。

6、classboa.compiler.Compiler

主編譯器接口類

通過下列程序加載python文件，編譯為.avm格式，并與python文件存儲在一個地方。

fromboa.compilerimportCompilerCompiler.load_and_save(‘path/to/your/file.py’)#returnthecompilerobjectforinspectioncompiler=Compiler.load(‘path/to/your/file.py’)#retrievethedefaultmoduleforinpectiondefault_module=compiler.default#retreivethedefault/entrymethodforthesmartcontractentry_method=default_module.main

7、defaule

取回默認或“入口”模塊。

返回值：默認反回值為boa.code.Module對象，異常時無返回值

8、staticinstance()

取回當前編譯器對象的實例，否則創建一個實例

返回值：編譯器對象的單個實例

9、staticload(path)

調用load來加載需編譯但無需寫為.avm格式的Python文件

參數：path–Python文件的編譯路徑

返回值：編譯器實例

用途：通過下述程序返回編譯器對象進行檢查

fromboa.compiler?import?Compilercompiler?=?Compiler.load(‘path/to/your/file.py’)

10、staticload_and_save(path,output_path=None)

分析 | BTC 11日大跌可能受Bitfinex影響 市值占比保持平穩波動:據TokenGazer數據分析顯示：截止至7月12日17點整，BTC價格為11,608.58$，市值為205,794.10M，主流交易所24H BTC交易量約為$2,305.97M，環比昨日減少27.88%；BTC算力和鏈上活躍地址數持續下滑；市值占比方面，BTC市值占比平穩波動，目前約為65.14%；

10日晚間，鮑威爾在國會發表證詞，全球不確定性繼續增加，黃金、債券迅速拉升，美股漲至歷史高位，在外部環境有利于比特幣上漲的情況下，11日比特幣價格最多下跌14.5%，本次下跌有可能是因為受Bitfinex和Tether被指控的影響：Bitfinex上的大量賣單，導致BTC價格的下跌；交易所方面，日內BTC/USD Coinbase對BTC/USD Bitfinex由負溢價轉變為正溢價；期貨方面，BTC多單未平倉量有微幅增加，空單未平倉量增加幅度較大。[2019/7/12]

調用load_and_save來加載需編譯為.avm格式的Python文件，并保存結果。

默認情況下，最終生成的.avm文件將與源文件存儲在一個地方。

參數：

·path——Python文件的編譯路徑

·output_path——已編譯的.avm文件的可選保存路徑

返回值：返回編譯器實例

用途：通過下述代碼返回編譯器對象進行檢查

fromboa.compilerimportCompiler

Compiler.load_and_save(‘path/to/your/file.py’)

11、write()

返回值：已編譯的Python程序的字節串

12、staticwrite_file(data,path)

通過指定路徑將輸出數據存儲至文件系統

參數：

·data——待寫入磁盤的數據字節串

·path——文件寫入路徑

13、boa.code.module.Module

下文將介紹Module的具體實現細則。

14、classboa.code.module.Module(path,module_name=”,is_sys_module=False,items_to_import=None)

動態 | 9836枚比特幣從Bitfinex交易所轉出:今日下午14點42分，有9836枚比特幣從Bitfinex交易所轉出，其中2,300枚BTC轉至1Kr6Q開頭的錢包地址，7536枚BTC轉至34FMJ開頭的地址。[2019/5/14]

模塊是包含代碼對象的頂層組件。例如，在path/to/my/file.py的編譯過程中，file.py中包含的項目即為模塊。一個可執行項可包含多個模塊。上述案例中的“默認”或“入口”模塊即為file.py。

調用Compiler.load_and_save(‘path/to/file.py’)時會專門為file.py創建一個模塊。若file.py導入了其他任何功能，那些模塊也會被添加至可執行項中，并置于Module.loaded_modules屬性中。

在模塊被當做方法處理，方法被當做基本塊處理，基本塊被處理為標記后，主模塊或default模塊的write()方法即被調用，將可執行項寫為字節串，返回磁盤并存儲。

如果您想檢查模塊內容，可使用Compiler.load(‘path/to/file.py’)，該功能將返回一個編譯器實例。獲取該實例后，您便可以訪問編譯器的default模塊，從而訪問該默認模塊中裝入的其他模塊。

各模塊均包含byteplay3對象bp的引用，該對象包含可在Python解釋器中顯示的指令集。

您可對具備bp屬性的任意對象調用print(module.bp.code)，結果將輸出一段Python解釋器代碼。

fromboa.compilerimportCompiler

module=Compiler.load

(‘./boa/tests/src/AddTest1.py’).default

print(module.bp.code)

LOAD_CONST

LOAD_CONST‘Main’

MAKE_FUNCTION0

STORE_NAMEMain

LOAD_CONSTNone

RETURN_VALUE

對可執行項進行處理與標記化后，便會生成虛擬機標記集，虛擬機標記雖與byteplay3標記相類似，但仍存在顯著區別。這些標記均包含在該模塊的all_vm_tokens屬性中。

Bitfinex股東趙東：應盡快切換到ERC20版本的USDT:今日Bitfinex的股東趙東透露，Bitfinex的首席財務官Giancarlo Devasini建議使用USDT交易的交易所，應盡快切換到ERC20版本的USDT，因為更加安全。據了解，此前Tether官方推出基于以太坊網絡為載體的ERC20格式的USDT，與之前基于比特幣網絡的USDT等價，但ERC20 USDT交易確認時間將減少15-30秒。[2018/3/22]

您可調用module.to_s()來查看該程序，因為該程序已根據NEO虛擬機的特點進行了標記化。

>>>module.to_s()

LOAD_FAST?

LOAD_CONST

BINARY_MULTIPL??

STORE_FAST?

LOAD_FAST?

LOAD_CONST?

BINARY_ADD????

LOAD_FAST

LOAD_CONST

BINARY_TRUE_DIVIDE

STORE_FAST?

LOAD_FAST?

LOAD_CONST?

BINARY_SUBTRACT

STORE_FAST

b''

LOAD_FAST

LOAD_FAST

BINARY_ADD????

LOAD_FAST?

BINARY_ADD

LOAD_FAST?

BINARY_ADD

NOP

15、add_method(method)

在模塊中添加方法如下：

Parameters:?method(boa.code.method.Method)——模塊中待添加的方法對象

返回值：顯示是否已添加該方法

返回值類型：布爾值

16、build()

將bp.code對象拆分成行，并合并多行，生成不同的項目。

17、link_methods()

關聯各方法地址

18、main

返回該模塊的默認方法

返回值：該模塊的默認方法

返回值類型：boa.code.method.Method

19、method_by_name(method_name)

在模塊的methods列表中查找方法名稱:parammethod_name:

待查找的方法名稱：typemethod_name:str

返回值：方法

返回值類型：boa.code.method.Method

20、module_path

返回該模塊的文件路徑

返回值：模塊路徑

返回值類型：str

21、orderered_methods

方法序列表

返回值：該模塊中的方法序列表

返回值類型：列表

22、process_action(lineset)

處理模塊中的動作，樣本如下，其目的類似于創建下列事件：

fromboa.blockchain.vm.Neo.ActionimportRegisterAction

#Registertheaction.

onRefund=RegisterAction(‘refund’,’to_address’,’amount’)

#Dispatchanaction.

onRefund(my_address,100)

參數：lineset(list)–包含應用程序調用注冊功能的行集

23、process_import(import_item)

處理該模塊中的導入語句

Parameters:?import_item(boa.code.items.Importsubclass)–

24、process_method(lineset)

處理包含byteplay3代碼對象的行集

參數：lineset(list)–需處理與添加的行集

25、process_smart_contract_app_registration(lineset)?

在智能合約中調用另一個智能合約時處理智能合約應用程序注冊事宜：

fromboa.blockchain.vm.Neo.AppimportRegisterAppCall

#registerthecontract

otherContract=RegisterAppCall(‘contract_hash’,’param1′,’param2′)

#callthecontract

result=otherContract(a,b)

參數：lineset(list)–包含應用程序調用注冊功能的行集

26、split_lines()

將模塊中的行集拆分成可編譯的對象集

27、to_s()

該方法的目的在于以可讀/標記化的格式打印可執行項的輸出值，樣本如下：

>>>fromboa.compilerimportCompiler

>>>module=Compiler.

load('./boa/tests/src/LambdaTest.py').default

>>>module.write()

>>>module.to_s()

LOAD_CONST

STORE_FAST

LOAD_FAST

CALL_FUNCTION?Main..

q_1

STORE_FAST

b''

m??

NOP?

RETURN_VALUE??

b''?

LOAD_FAST?x?

LOAD_CONST?

BINARY_ADD??

NOP????

RETURN_VALUE?

28、tokenize()

將boa.code.pytoken.PyToken對象集轉化為boa.code.vmtoken.VMToken對象。

29、total_lines

獲取該方法的總行數

返回值：總行數

返回值類型：int

30、total_module_variables

獲取局部變量總數

返回值：該模塊中的變量總數

返回值類型：int

31、vm_tokens

返回該方法中的虛擬機標記列表

返回值：該方法中的虛擬機標記列表

返回值類型：列表

32、write()

將標記器當前的狀態寫為字節串

返回值：當前標記器的字節串

返回值類型：字節

原文鏈接：https://github.com/localhuman/neo-python

往期精彩內容

NEXT社區小課堂|第五課：NEO-共識算法dBFT源碼解析

NEXT社區小課堂|第八課：如果往錯誤的NEO地址轉賬會發生什么

NEXT社區小課堂|第十課：如何正確理解NEO平臺上的GAS

NEXT社區小課堂|第十一課：NEO中數字的表達和運算

??

聯系我們?

微博：https://weibo.com/u/6724929880

官網：https://neonext.club/

QQ群：612334080

電報：https://t.me/neonextop

twitter：https://twitter.com/NE0NEXT

關注NEONEXT官方公眾號

獲取更多一手社區資訊

Tags：LOADLOACOMMPIUpload TokenLOAD幣ComBitChampignons of Arborethia

Gate交易所