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

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將在以太坊合并前2小時暫停ETH和ERC-20代幣充提服務:9月15日消息，據官方公告，Bitfinex將在以太坊合并前兩個小時（區塊高度15540293）暫停ETH和ERC-20代幣的充提服務。Bitfinex ETH、ERC-20指數、衍生品和現貨市場的交易將不受影響。

UTC時間9月14日21:00，ETHW和ETHS市場將暫停。ETHW和ETHS CST交易對的所有訂單將被取消。Bitfinex還將暫停ETHW和ETHS的Chain Split Token（CST）轉換工具。合并后，CST轉換頁面將停用。[2022/9/15 6:56:39]

#已經根據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?

納斯達克上市加密交易所EQONEX推出交叉抵押品功能:8月30日消息，納斯達克上市的加密貨幣交易所EQONEX宣布在其平臺上推出交叉抵押品功能，使交易者能夠在交易衍生產品時更有效地管理他們的抵押品。借助該功能，交易者將能夠使用USD、USDC和BTC作為衍生品交易的保證金。（prnewswire）[2021/8/30 22:47:04]

·主作者為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()

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

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

9、staticload(path)

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

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

返回值：編譯器實例

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

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

?證券型代幣交易所Dusk Network獲Bitfinex母公司iFinex百萬美元投資:9月1日消息，Bitfinex母公司iFinex宣布對即將上線的證券型代幣交易所Dusk Network投資超過100萬美元。Dusk Network是一家位于荷蘭阿姆斯特丹的金融科技初創公司，他們希望打造一個受監管的證券型代幣交易所，旨在對股票、債券和商品等資產進行代幣化，預計將在2021年一季度啟動。Dusk Network業務主管Jelle Pol稱，該交易所將在歐盟MiFID II框架下運作，因為在這種框架下可以靈活選擇多邊貿易工具（MTF）許可或受監管市場（RM）許可。（The Block）[2020/9/1]

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

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

Bitfinex首席技術官：Bitfinex官方熱錢包USDT僅占總供應量的11%:8月28日，Tether和Bitfinex首席技術官Paolo Ardoino發推稱，剛剛注意到EOS鏈上的USDT開始在上升。Bitfinex官方熱錢包USDT僅占總供應量的11%，其余的被不同的項目或由社區成員持有。這要求進行鏈上代幣轉移。[2020/8/28]

調用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屬性中。

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

分析 | Bitfinex現大量賣單 價格從234.22美元瞬間跌落至44.77美元:據TokenGazer數據分析顯示，今日美國時間8點02分06秒至19秒的短短13秒時間里，Bitfinex交易所突現總數為21730.97個BSV的密集拋盤，在此期間，買單僅為兩單，累計成交量3200筆，BSV的價格從$234.22瞬間跌落至$44.77，在價格斷崖式下跌過程中，成交量大致接近均勻分布狀態；此后BSV價格迅速回升至$232時，又有一筆總量為707個BSV的試探性砸盤，但很快被市場消化。TokenGazer判斷這是發生在Bitfinex交易所里的市價單直接砸盤行為，也是一次短暫的BSV多空方對決，在目前交戰較為激烈的情況下，散戶交易存在較大風險，詳細分析請關注TokenGazer官網動態。[2019/5/30]

>>>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：LOADLOACOMETHUPLOAD價格LOAD價格COMP價格ethereal有什么特殊的含義

火必