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

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獲得信用評分機構CCData的交易所A級評分:金色財經報道，信用評分機構CCData發布的一份報告顯示，2023年3月，根據更新的評級，71%的總交易量來自頂級交易所，而2022年10月這一比例為92%。其中，Bitfinex獲得交易所A級評分，在多個分類中被列為頂級交易所。

中心化交易所行業的透明度正在提高。在FTX崩潰后，20%的交易所采用了儲備證明或替代方案。

交易所KYC實踐正在改進。根據Ciphertrace的數據，2023年4月，報告分析的交易所中有15%被認為KYC實踐不足，相較于2022年10月的21%和2022年4月的35%有所改善。[2023/4/21 14:17:42]

#已經根據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、許可證

Nexo指責Vauld前任管理層迫使其退出收購，出于私心支持基金管理公司競標:1月6日消息，加密貨幣借貸平臺Nexo對Vauld的收購提案遭到拒絕。Nexo在周四發布的公開信中抨擊Vauld及其管理團隊，包括前首席執行官Darshan Bathija等前任管理層人員及債權人委員會（CoC），指責他們迫使Nexo退出交易，轉而支持另一方，沒有將債權人的最大利益放在心上。Nexo表示，“競爭者是一家不知名的基金管理公司，沒有業績記錄，沒有過去的業績可以證明，但卻做出了令人難以置信的高額年回報率承諾。”

Vauld似乎傾向于通過基金管理公司來進行重組，而不是與Nexo達成交易。Nexo認為，許多人投票支持該競標者，這一定是一項“秘密交易”的一部分，有利于前管理團隊和選定的少數巨鯨客戶。[2023/1/6 10:58:54]

·開源MIT?

·主作者為localhuman

5、boa.compiler.Compiler

下文將介紹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()

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

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

731枚BTC從Bitfinex交易所轉出:金色財經報道，Whale Alert數據顯示，北京時間11月25日04:29，731枚BTC從Bitfinex交易所轉入3HiKp6開頭未知錢包地址，價值約1397.35萬美元，交易哈希為：5e0160ca2fd14dc2cd5f1ff19e1374432aa75f9088cd09ca532a4a9f9885868c。[2020/11/25 22:00:41]

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)

調用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

Bitfinex將于17點55分恢復交易功能:據Bitfinex官方消息，交易平臺將于17點55分恢復交易功能。[2020/6/10]

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

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

模塊是包含代碼對象的頂層組件。例如，在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

日本MONEX證券公司發布投資者投資意向調查結果:MONEX證券有限公司在6月14日，發表了針對投資者投資意向進行調查的“第25次全球個人投資者調查報告”。本次調查報告由MONEX證券（日本），和該集團的TradeStation Securities，Inc（美國）以及Monex Boom Securities Limited（中國香港）共同實施，對各自公司進行交易的個人投資者客戶進行調查，分別收集了532份（日本），120份（美國）和353份（中國香港）報告。其中回答想要投資虛擬貨幣的比例，與2017年12月得出的調查結果相比，日本從4.9%增長到10.2%，美國從11.2%增長到16.7%。但是中國香港從14.3%減少到13.9%。[2018/6/19]

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

您可調用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：LOADCOMLOACOMPUPLOAD價格COMMUNIQUEUPLOAD幣Compound Wrapped BTC

DAI