NEO-Python SeedList

介紹

關於 SeedList

SeedList 是一個 URL 列表，是 NEO-Python 在啟動時嘗試連線的節點。在 NEO-Python 目錄下 (/neo/data) 的 protcol.*.json 檔案中可以找到 SeedList。有三個常用 protocol.*.json 檔案：

protocol.mainnet.json
protocol.testnet.json
protocol.privnet.json
複製程式碼

本文指的是 protocol.mainnet.json ，但這些資訊是通用的。

json
{
    "ProtocolConfiguration": {
    "Magic": ...,
    "AddressVersion": ...,
    "SecondsPerBlock": ...,
    "StandbyValidators": [
    ...
    ],
    "SeedList": [
      "seed1.neo.org:10333",
      "seed2.neo.org:10333",
      "seed3.neo.org:10333",
      "seed4.neo.org:10333",
      "seed5.neo.org:10333"
    ],
    "RPCList":[
    ...
    ],
    "SystemFee": {
    ...
    }
  }
}複製程式碼

在上面的檔案中，NEO-Python 配置為通過PORT:10333 連線 seed1.neo.org, seed2.neo.org 等節點 。

潛在問題

假如以上列表中的每個節點故障，NEO-Python 會嘗試連線相鄰節點。但是這種方法存在很多未知因素，例如相鄰節點出問題了，可能導致等待時間相當漫長。

更新 SeedList

通過使用我們確定的活躍節點更新 SeedList，可以避免上述潛在問題中提到的漫長等待風險。

更新 Windows WSL (Ubuntu) 上的 NEO-Python 節點列表

如果是在 Ubuntu 上執行 neo-python ，你應該使用了 venv。你需要修改 venv 目錄裡 lib/python3.6/site-packages/neo/data 路徑下的 protocol.mainnet.json 檔案。如果該路徑不存在，說明你尚未在當前 venv 中使用該檔案，那麼你可以到 neo/data 路徑下的 neo-python 資料夾中修改此檔案。或者你也可以刪除 venv 資料夾，修改父檔案，新建一個 venv 資料夾（python -m venv venv）並啟用 venv，然後使用 pip install e . 重新安裝。

更新 SeedList

活躍節點

要尋找活躍節點，使用 NEO 網路狀態監測網。要檢視更詳細的資訊，檢視該監測網 Github 上的 儲存庫。

如上圖所示，列表中顯示了可用節點。最新節點顯示在最上方。 圖中

標識的地方表示節點是否響應。通常，綠色並顯示 yes 的節點為活躍節點。

我們會根據以下埠的標準協議進行選擇，比如我們會選擇上圖中的節點 1 而不選節點3，因為節點 1符合標準而節點 3 不符合。

	Main Net	Test Net
JSON-RPC via HTTPS	10331	20331
JSON-RPC via HTTP	10332	20332
P2P via TCP	10333	20333
P2P via WebSocket	10334	20334

以下是選出的活躍節點地址：

seed3.aphelion-neo.com
seed4.aphelion-neo.com
node2.ams2.bridgeprotocol.io
pyrpc1.nodeneo.ch
node2.nyc3.bridgeprotocol.io
複製程式碼

編輯 protocol 檔案

為了告知 NEO-Python 新的節點列表，需要將前面幾個地址貼上到 protocol.mainnet.json，如下所示：

json
{
    "ProtocolConfiguration": {
    "Magic": ...,
    "AddressVersion": ...,
    "SecondsPerBlock": ...,
    "StandbyValidators": [
    ...
    ],
    "SeedList": [
      "seed1.neo.org:10333",
      "seed2.neo.org:10333",
      "seed3.neo.org:10333",
      "seed4.neo.org:10333",
      "seed5.neo.org:10333",
      "seed4.aphelion-neo.com:10333",
      "node2.sgp1.bridgeprotocol.io:10333",
      "seed2.aphelion-neo.com:10333",
      "seed3.aphelion-neo.com:10333",
      "node2.ams2.bridgeprotocol.io:10333",
      "pyrpc1.narrative.network:10333",
      "node2.nyc3.bridgeprotocol.io:10333",
      "pyrpc4.narrative.network:10333",
      "pyrpc2.narrative.network:10333",
      "pyrpc3.narrative.network:10333",
      "seed1.aphelion-neo.com:10333",
      "seed1.switcheo.network:10333",
      "seed2.switcheo.network:10333",
      "seed5.cityofzion.io:10333",
      "seed3.cityofzion.io:10333",
      "seed3.switcheo.network:10333",
      "seed1.o3node.org:10333",
      "seed3.travala.com:10333",
      "seed4.cityofzion.io:10333",
      "seed2.cityofzion.io:10333",
      "seed2.o3node.org:10333",
      "seed3.o3node.org:10333",
      "node1.sgp1.bridgeprotocol.io:10333",
      "seed2.travala.com:10333",
      "seed4.switcheo.network:10333",
      "seed1.spotcoin.com:10333",
      "node1.nyc3.bridgeprotocol.io:10333"
    ],
    "RPCList":[
    ...
    ],
    "SystemFee": {
    ...
    }
  }
}
複製程式碼

請注意，上例中的每個地址後加上了 :10333 以便告知 NEO-Python 使用 P2P 協議連線。

現在就可以像往常一樣啟動 neo-python 了。

JSON 和 REST API 伺服器

建議你在啟動任意 API 伺服器之前先更新節點列表以保證最大連線數。有關更多API伺服器資訊，請檢視 這裡。

基本用法

使用 neo-python 主要有兩種方式：執行 np-prompt 和執行自定義程式碼的節點。

np-prompt

在測試網執行 np-prompt :

$ np-prompt
複製程式碼

顯示 help 的所有可用引數：

$ np-prompt -h
usage: np-prompt [-h] [-m | -p [host] | --coznet | -c CONFIG]
                 [-t {dark,light}] [-v] [--datadir DATADIR] [--version]

optional arguments:
  -h, --help            show this help message and exit
  -m, --mainnet         Use MainNet instead of the default TestNet
  -p [host], --privnet [host]
                        Use a private net instead of the default TestNet,
                        optionally using a custom host (default: 127.0.0.1)
  --coznet              Use the CoZ network instead of the default TestNet
  -c CONFIG, --config CONFIG
                        Use a specific config file
  -t {dark,light}, --set-default-theme {dark,light}
                        Set the default theme to be loaded from the config
                        file. Default: 'dark'
  -v, --verbose         Show smart-contract events by default
  --datadir DATADIR     Absolute path to use for database directories
  --version             show program's version number and exit
複製程式碼

自定義程式碼節點

檢視 /examples 目錄下的示例：github.com/CityOfZion/…

另外可參考 “Settings and Logging” and “Interacting with Smart Contracts”.

API 伺服器 (JSON / REST)

在主網啟動 JSON 和 REST API 伺服器：

$ np-api-server --mainnet --port-rpc 10332 --port-rest 80
複製程式碼

示例通知和 help 下的所有可用引數：

$ np-api-server --testnet --port-rpc 8080 --port-rest 8088
[I 180315 09:27:09 NotificationDB:44] Created Notification DB At /Users/thomassaunders/.neopython/Chains/Test_Notif
[I 180315 09:27:09 threading:864] [TestNet] Block 5644 / 53999
[I 180315 09:27:09 np-api-server:11] Starting json-rpc api server on http://0.0.0.0:8080
[I 180315 09:27:09 _observer:131] Site starting on 8080
[I 180315 09:27:09 _observer:131] Starting factory <twisted.web.server.Site object at 0x110619828>
[I 180315 09:27:09 np-api-server:11] Starting REST api server on http://0.0.0.0:8088

# view help
$ np-api-server -h
usage: np-api-server [-h]
                   (--mainnet | --testnet | --privnet | --coznet | --config CONFIG)
                   [--port-rpc PORT_RPC] [--port-rest PORT_REST]
                   [--logfile LOGFILE] [--syslog] [--syslog-local [0-7]]
                   [--disable-stderr] [--datadir DATADIR]
                   [--maxpeers MAXPEERS] [--wallet WALLET] [--host HOST]

  optional arguments:
  -h, --help            show this help message and exit
  --datadir DATADIR     Absolute path to use for database directories
  --maxpeers MAXPEERS   Max peers to use for P2P Joining
  --wallet WALLET       Open wallet. Will allow you to use methods that
                        require an open wallet
  --host HOST           Hostname ( for example 127.0.0.1)

  Network options:
  --mainnet             Use MainNet
  --testnet             Use TestNet
  --privnet             Use PrivNet
  --coznet              Use CozNet
  --config CONFIG       Use a specific config file

  Mode(s):
  --port-rpc PORT_RPC     port to use for the json-rpc api (eg. 10332)
  --port-rest PORT_REST   port to use for the rest api (eg. 80)

  Logging options:
  --logfile LOGFILE     Logfile
  --syslog              Log to syslog instead of to log file ('user' is the
                        default facility)
  --syslog-local [0-7]  Log to a local syslog facility instead of 'user'.
                        Value must be between 0 and 7 (e.g. 0 for 'local0').
  --disable-stderr      Disable stderr logger
複製程式碼

埠描述

要使外部程式能訪問你的 API 伺服器，需要開啟防火牆埠。下表顯示的埠可以設定為全部開啟或按需開啟。

	Main Net	Test Net
JSON-RPC via HTTPS	10331	20331
JSON-RPC via HTTP	10332	20332

使用 Windows WSL (Ubuntu) 執行 API 伺服器

如果在 Windows WSL (Ubuntu) 上執行 neo-python, 除了開啟路由器上的相應埠，還需要參考 這裡 為你的 Windows 防火牆新增一個入站策略。

使用命令列與 NEO 區塊鏈互動

Prompt 是用於執行和與 NEO 區塊鏈互動的預設介面。

如下所示：

$ np-prompt
NEO cli. Type 'help' to get started

neo>
複製程式碼

錢包操作

下表列出了所有可用的錢包命令。

命令	描述
create wallet <wallet_path>	建立錢包檔案
open wallet <wallet_path>	開啟錢包檔案
wallet	檢查錢包
wallet <verbose> < rebuild> <rebuild block_height>	重建錢包索引
wallet migrated	遷移你的錢包
export wif <address>	匯出私鑰
export nep2 <address>	將地址匯出為NEP2加密私鑰
import wif <WIF>	匯入私鑰
import nep2 <address>	將地址匯入為NEP2加密私鑰
import watch_addr <address>	匯入 watch only 地址
import contract_addr <script_hash> <pubkey>	匯入智慧合約地址
send <asset_ID> <address> <amount> [from_address]	將資產傳送到指定的地址
wallet delete_addr <address>	刪除地址

解釋與示例

建立錢包

neo> create wallet path/to/walletfile
[Password 1]> **********
[Password 2]> **********
Wallet {
    "addresses": [
        "AayaivCAcYnM8q79JCrfpRGXrCEHJRN5bV"
    ],
    "claims": {
        "available": 0.0,
        "unavailable": 0.0
    },
    "tokens": [],
    "height": 0,
    "synced_balances": [],
    "path": "Wallets/blahblah.db3",
    "public_keys": [
        {
            "Address": "AayaivCAcYnM8q79JCrfpRGXrCEHJRN5bV",
            "Public Key": "027973267230b7cba0724589653e667ddea7aa8479c01a82bf8dd398cec93508ef"
        }
    ],
    "percent_synced": 0
}
neo>
複製程式碼

開啟錢包

neo> open wallet path/to/walletfile
[Password]> ***********
Opened wallet at path/to/walletfile
neo>
複製程式碼

檢查錢包

neo> wallet
Wallet {
    "addresses": [
        "AayaivCAcYnM8q79JCrfpRGXrCEHJRN5bV"
    ],
    "claims": {
        "available": 0.0,
        "unavailable": 0.0
    },
    "tokens": [],
    "height": 75500,
    "synced_balances": [],
    "path": "Wallets/blahblah.db3",
    "public_keys": [
        {
            "Address": "AayaivCAcYnM8q79JCrfpRGXrCEHJRN5bV",
            "Public Key": "027973267230b7cba0724589653e667ddea7aa8479c01a82bf8dd398cec93508ef"
        }
    ],
    "percent_synced": 9
}
複製程式碼

重建錢包索引

如果您的錢包出現異常，或者您已將新地址匯入錢包，則可能需要重建錢包索引，從區塊頭同步錢包。也可以指定一個區塊號開始重新同步，如下所示：

neo> wallet rebuild 700000
restarting at 700000
neo>
複製程式碼

遷移錢包

如果錢包資料模型發生更改，則可能需要遷移錢包，如下所示：

neo> wallet migrated
migrated wallet
neo>
複製程式碼

重新加密錢包

如果你開啟錢包時收到如下資訊，則必須重新加密以防止之前的錢包漏洞。

Could not open wallet: This wallet is currently vulnerable. Please execute the "reencrypt_wallet.py" script on this wallet before continuing
複製程式碼

要修復此問題，先使用命令 exit 退出 neo prompt，然後執行重新加密指令碼：

python reencrypt_wallet.py path/to/mywallet.db3
複製程式碼

你需要輸入密碼並使用新名稱path/to/new_mywallet.db3儲存重新加密的錢包。

匯入私鑰

您可能需要匯入一個WIF私鑰來新增地址到您的錢包，如下所示：

neo> import wif KxP97gujib35PBEnTq78e5NmYVbeaosU4AdguDzZ4tyf6a7W32UM
Imported key KxP97gujib35PBEnTq78e5NmYVbeaosU4AdguDzZ4tyf6a7W32UM
Pubkey: 303263383231666338336465373331313039633435653034346136353863386631313337623730303461396232323237613335653262353566613061313630323731
neo>
複製程式碼

匯出私鑰

您可能需要從錢包匯出 WIF 私鑰用於另一個程式。指定要匯出的 WIF 地址，如下所示：

neo> export wif AXjaFSP23Jkbe6Pk9pPGT6NBDs1HVdqaXK
[Wallet Password]> ***********
WIF key export: KxP97gujib35PBEnTq78e5NmYVbeaosU4AdguDzZ4tyf6a7W32UM
neo>
複製程式碼

匯出 NEP2 密碼保護的私鑰

您可以將地址匯出為 NEP2 加密私鑰，如下所示：

neo> export nep2 AStZHy8E6StCqYQbzMqi4poH7YNDHQKxvt
[Wallet Password]> ***********
[Key Password 1]> ******************
[Key Password 2]> ******************
NEP2 key export: 6PYVPVe1fQznphjbUxXP9KZJqPMVnVwCx5s5pr5axRJ8uHkMtZg97eT5kL
neo>
複製程式碼

匯入NEP2密碼保護的私鑰

您可以將地址匯入為 NEP2 加密私鑰，如下所示：

neo> import nep2 6PYVPVe1fQznphjbUxXP9KZJqPMVnVwCx5s5pr5axRJ8uHkMtZg97eT5kL
[Key Password]> ******************
Imported nep2 key: 6PYVPVe1fQznphjbUxXP9KZJqPMVnVwCx5s5pr5axRJ8uHkMtZg97eT5kL
Pubkey: 303236323431653765323662333862623731353462386164343934353862393766623163343739373434336463393231633563613537373466353131613262626663
複製程式碼

匯入 watch only 地址

watch only 是一種您沒有公鑰但想觀察的地址。watch only 地址可以像普通地址一樣刪除。

neo> import watch_addr AStZHy8E6StCqYQbzMqi4poH7YNDHQKxvt
neo>
複製程式碼

匯入智慧合約地址

您可能想要使用已部署的智慧合約中的資金。根據合約程式設計，如果其允許您像使用自己的資金一樣使用合約中的資金，則您可以通過指定合約的script_hash，以及您希望與合約關聯的錢包中地址的公鑰來匯入合約地址。合約地址可以像錢包中的普通地址一樣刪除。

# import contract_addr {script_hash} {pubkey}
neo> import contract_addr 3c62006802d895974069a1d96398a04b4703f0f8 027973267230b7cba0724589653e667ddea7aa8479c01a82bf8dd398cec93508ef
Added contract addres AeU8kTJxynwkT3q9ao8aDFuaRJBkU3AfFG to wallet
neo>
複製程式碼

刪除地址

neo> wallet delete_addr AStZHy8E6StCqYQbzMqi4poH7YNDHQKxvt
Deleted address AStZHy8E6StCqYQbzMqi4poH7YNDHQKxvt
neo>
複製程式碼

傳送資產

從錢包傳送

使用以下命令可以從你的錢包傳送資產。使用此命令，傳送的資產來自於你的某個地址或者多個地址。 change_address 是你錢包的中的某個地址。

# syntax send {asset_name} {address to} {amount} ( optional: --from-addr={from_addr})
neo> send gas AeU8kTJxynwkT3q9ao8aDFuaRJBkU3AfFG 11
[Password]> ***********
Relayed Tx: 468e294b11a9f65cc5e2c372124877472eebf121befb77ceed23a84862a606d3
neo>
複製程式碼

從指定地址傳送

也可以指定一個特定的地址來傳送資產，如從合約地址傳送資產。

# syntax send {asset_name} {address to} {amount} ( optional: --from-addr={from_addr})
neo> send gas AeU8kTJxynwkT3q9ao8aDFuaRJBkU3AfFG 11 --from-addr=AXjaFSP23Jkbe6Pk9pPGT6NBDs1HVdqaXK
[Password]> ***********
Relayed Tx: a43dfb30af63bd0e5a510b05f02b3d40932af26d4564e040e3812ce78e76ce71
neo>
複製程式碼

NEP5 Tokens

匯入 NEP5 代幣

您可以使用錢包觀察 NEP5 代幣並與之互動，為此，您需要首先註冊錢包以觀察代幣，如下所示：

neo> import token f8d448b227991cf07cb96a6f9c0322437f1599b9
added token {
    "name": "NEP5 Standard",
    "script_hash": "f8d448b227991cf07cb96a6f9c0322437f1599b9",
    "decimals": 8,
    "symbol": "NEP5",
    "contract address": "AYhE3Svuqdfh1RtzvE8hUhNR7HSpaSDFQg"
}
neo> wallet
Wallet {
    # truncated ...

    "percent_synced": 100,
    "addresses": [
        "AayaivCAcYnM8q79JCrfpRGXrCEHJRN5bV",
        {
            "balances": {
                "c56f33fc6ecfcd0c225c4ab356fee59390af8560be0e930faebe74a6daff7c9b": "4051.0",
                "602c79718b16e442de58778e148d0b1084e3b2dffd5de6b7b16cee7969282de7": "897.48372409"
            },
            "script_hash": "AXjaFSP23Jkbe6Pk9pPGT6NBDs1HVdqaXK",
            "votes": [],
            "version": 0,
            "is_watch_only": false,
            "tokens": [
                "[f8d448b227991cf07cb96a6f9c0322437f1599b9] NEP5 : 4519175.65580000"
            ],
            "frozen": false
        },
        {
    }
}
複製程式碼

在 prompt 中與智慧合約互動

檢視在 prompt 中與智慧合約互動的完整說明: Smart Contracts within the Prompt

獲取 NEO 測試網資產

本節介紹如何通過 NEO 官方申請表 獲取測試網資產。

獲取測試網資產需要兩步：

1. 在錢包中新增多方簽名地址。
2. 將資產轉移到你的地址。

新增多方簽名地址

你需要準備好以下資訊：

1. 你從 NEO 收到的電子郵件中提示的公鑰
2. 你自己錢包裡的公鑰。 開啟錢包並在提示符下輸入 wallet 獲取所需資訊。

neo> wallet
Wallet {
    ...
    "public_keys": [
        {
            "Address": "ANFLgwKG8Eni9gJmKfM7yFXEaWwoGkSUid",
            "Public Key": "037b8992e8384212f82e05c8836816c0f14dff9528397138731638b17d6357021e" <--- take this
        }
    ],
    ...
}
複製程式碼

然後使用如下命令建立多方簽名地址：

neo> import multisig_addr
please specify multisig contract like such: 'import multisig {pubkey in wallet} {minimum # of signatures required} {signing pubkey 1} {signing pubkey 2}...'

neo> import multisig_addr 037b8992e8384212f82e05c8836816c0f14dff9528397138731638b17d6357021e 1 037b8992e8384212f82e05c8836816c0f14dff9528397138731638b17d6357021e 02883118351f8f47107c83ab634dc7e4
ffe29d274e7d3dcf70159c8935ff769beb
[I 180310 16:49:19 UserWallet:191] contract does not exist yet
Added multi-sig contract address ALXEKioZntX73QawcnfcHUDvTVm8qXjAxf to wallet
複製程式碼

再次檢查你的錢包，應該能檢視到餘額（特別是檢視 synced_balances ）。如果沒有看到新增餘額，請執行wallet rebuild 並等待它完全同步後再次嘗試。

neo> wallet
Wallet {
    "path": "test",
    "addresses": [
        {
            "address": "ANFLgwKG8Eni9gJmKfM7yFXEaWwoGkSUid",
            "script_hash": "47028f2a3d33466f29fba10e65c90fd8f3d01e1f",
            "tokens": null
        },
        {
            "version": 0,
            "script_hash": "ALXEKioZntX73QawcnfcHUDvTVm8qXjAxf",
            "frozen": false,
            "votes": [],
            "balances": {
                "0xc56f33fc6ecfcd0c225c4ab356fee59390af8560be0e930faebe74a6daff7c9b": "50.0",
                "0x602c79718b16e442de58778e148d0b1084e3b2dffd5de6b7b16cee7969282de7": "50.0"
            },
            "is_watch_only": false
        }
    ],
    ...
    "synced_balances": [
        "[NEO]: 50.0 ",
        "[NEOGas]: 50.0 "
    ],
    "public_keys": [
        {
            "Address": "ANFLgwKG8Eni9gJmKfM7yFXEaWwoGkSUid",
            "Public Key": "037b8992e8384212f82e05c8836816c0f14dff9528397138731638b17d6357021e"
        },
        {
            "Address": "ALXEKioZntX73QawcnfcHUDvTVm8qXjAxf",
            "Public Key": "037b8992e8384212f82e05c8836816c0f14dff9528397138731638b17d6357021e"
        }
    ],
    ...
}
複製程式碼

將資產轉賬到你自己的地址

現在就可以安裝以下操作將資產轉移到你自己的地址：

neo> send NEO ANFLgwKG8Eni9gJmKfM7yFXEaWwoGkSUid 5 --from-addr=ALXEKioZntX73QawcnfcHUDvTVm8qXjAxf
[Password]> **********
[I 180310 17:02:42 Transaction:611] Verifying transaction: b'c32b0e3d9adbef6720abfad5106dcd2dacb17b31d4f9d32cbcf8ed6e7f566ef3'
Relayed Tx: c32b0e3d9adbef6720abfad5106dcd2dacb17b31d4f9d32cbcf8ed6e7f566ef3
複製程式碼

注意引數 --from-addr 指定的是提取資產的多方簽名合約地址。

設定和日誌

neo-python提供一個設定模組，可以用來配置以下事情：

• 網路：主網、測試網、私網或自定義配置

• 日誌：

  • 智慧合約事件日誌
  • 日誌檔案（可切換）
  • Loglevel

要更改設定，匯入設定示例：

from neo.Settings import settings
複製程式碼

設定網路

您可以使用以下設定方法配置網路：

settings.setup_mainnet()
settings.setup_testnet()
settings.setup_privnet()
settings.setup(config_file)
複製程式碼

neo-python 預設使用測試網。

資料儲存路徑

預設情況下， neo-python 將鏈資料儲存在 ~/.neopython/Chains。如果想指定 Chains 目錄放置的路徑，可以將 --datadir 標誌傳遞給以下任意命令：np-prompt, np-api-server, 或 np-bootstrap。也可以使用 settings 模組手動設定：

settings.set_data_dir('your/path')
複製程式碼

日誌

neo-python 使用以下預設方式：

• 來自所有智慧合約的事件都使用loglevel INFO進行記錄
• loglevel 設定為 INFO
• 記錄到 logfile 被取消啟用 (prompt.py 記錄到 prompt.log)

智慧合約事件

要禁用所有智慧合約事件的記錄，參照以下示例：

settings.set_log_smart_contract_events(False)
複製程式碼

更改日誌級別

要更改日誌級別，如也顯示DEBUG日誌或只顯示錯誤日誌，參照以下示例：

import logging

# Show everything, including debug logs:
settings.set_loglevel(logging.DEBUG)

# Only show errors:
settings.set_loglevel(logging.ERROR)
複製程式碼

在 prompt 中更改

要在 prompt 中更改 log 級別，使用以下命令：

neo> config sc-events on
neo> config sc-events off
複製程式碼

配置日誌檔案

要啟動日誌檔案的記錄功能，參照以下示例：

# Just a single logfile, with no limits or rotation:
settings.set_logfile(your_logfile_path)

# To enable rotation with a maximum of 10MB per file and 3 rotations:
settings.set_logfile(your_logfile_path, 1e7, 3)
複製程式碼

記錄自定義程式碼

neo-python 使用 logzero 進行記錄。要在現有的 neo 日誌記錄配置中使用 logger，只需從logzero 匯入 logger，如下所示：

from logzero import logger

# These log messages are sent to the console
logger.debug("hello")
logger.info("info")
logger.warn("warn")
logger.error("error")

# This is how you'd log an exception
try:
    raise Exception("this is a demo exception")
except Exception as e:
    logger.exception(e)複製程式碼

neo.Core.TX.Transaction

本文將詳細介紹 neo.Core.TX.Transaction 模組。

描述：

交易基本類

用法：

從 neo.Core.Transaction 匯入交易

class neo.Core.TX.Transaction.ContractTransaction(*args, **kwargs) [source]

class neo.Core.TX.Transaction.Transaction(inputs=[], outputs=[], attributes=[], scripts=[])[source]

Deserialize(reader) [source]

反序列化完整的物件。

引數：reader (

) –

static DeserializeFrom(reader) [source]

反序列化完整的物件。

引數: reader (

) –

返回值：

返回型別：Transaction

static DeserializeFromBufer (buffer, offset=0) [source]

從指定的緩衝區反序列化物件例項。

引數：

buffer (

) – （可選）用於建立資料流的資料。

offset – 不使用

返回值：

返回型別：Transaction

DeserializeUnsigned(reader) [source]

反序列化物件。

引數：reader (

) –

丟擲： Exception – 如果交易型別錯誤。

DeserializeUnsignedWithoutType(

) [source]

不讀取交易型別資料的反序列化物件。

引數：reader (

) –

GetHashData() [source]

獲取用於雜湊的資料。

返回值：

返回型別：bytes

GetMessage() [source]

獲取用於雜湊的資料。

返回值：

返回型別：bytes

GetScriptHashesForVerifying() [source]

獲取用於驗證交易的指令碼雜湊。

丟擲：Exception – 如果交易中沒有有效資產。

返回值：UInt160 型別指令碼雜湊。

返回型別：list

GetTransactionResults() [source]

獲取交易的執行結果。

返回值：如果交易沒有引用 list: TransactionResult 物件。

返回型別：無

Hash

獲取交易的雜湊值。

返回值：

返回型別：UInt256

NetworkFee() [source]

獲取網路手續費

返回值：

返回型別：Fixed8

References

獲取所有引用

返回值：Key (UInt256): input PrevHash Value (TransactionOutput): object.

返回型別：dict

ResetHashData() [source]

復位本地儲存的雜湊資料

ResetReferences() [source]

復位本地儲存的引用

Scripts

獲取指令碼

返回值：

返回型別：list

Serialize(

) [source]

序列化物件

引數：writer (

) –

SerializeUnsigned(

) [source]

序列化物件

引數：writer (

) –

Size() [source]

獲取物件的總大小（以位元組為單位）。

返回值：大小

返回型別：int

SystemFee() [source]

獲取系統手續費。

返回值：目前為 0。

返回型別：Fixed8

ToArray() [source]

獲取 self 的位元組資料。

返回值：

返回型別：byte

ToJson() [source]

將物件成員轉換為可以解析為JSON的字典編碼。

返回值：

返回型別：dict

Verify(

) [source]

驗證交易。

引數：mempool –

返回值：驗證通過返回 True，否則返回 False。

返回型別：bool

getAllInputs() [source]

獲取輸入

返回值：

返回型別：list

withdraw_hold

交易的 docstring

class neo.Core.TX.Transaction.TransactionInput(prevHash=None, prevIndex=None) [source]

TransactionInput 的 docstring

Deserialize(

) [source]

反序列化全物件

引數：reader (

) –

Serialize(

) [source]

序列化物件

引數：writer (

) –

ToJson() [source]

將物件成員轉換為可以解析為JSON的字典編碼。

返回值：

返回型別：dict

ToString() [source]

獲取物件的字串表示形式。

返回：PrevHash:PrevIndexReturn type:str

class neo.Core.TX.Transaction.TransactionOutput (AssetId=None, Value=None, script_hash=None)[source]

Address

獲取交易的公共地址。

返回值：代表地址的 base58 編碼字串。

返回型別：str

AddressBytes

獲取交易的公共地址。

返回值：base58 編碼的字串。

返回型別：bytes

AssetId

docstring for TransactionOutput

Deserialize(

) [source]

反序列化完整物件

引數：reader (

) –

Serialize(

) [source]

序列化物件

引數：writer (

) –

ToJson(

) [source]

將物件成員轉換為可以解析為JSON的字典編碼。 :param index: 交易輸出的索引 :type index: int

返回值：

返回型別：dict

與智慧合約互動

neo-python 的一個常見用例是與智慧合約進行互動。典型的智慧合約事件包括 Runtime.Notify, Runtime.Log, 執行成功或失敗，以及 Storage.GET/PUT/DELETE。

事件型別

以下列出了當前 NEO-Python 可以處理的智慧合約事件型別：

RUNTIME_NOTIFY = "SmartContract.Runtime.Notify"
RUNTIME_LOG = "SmartContract.Runtime.Log"

EXECUTION = "SmartContract.Execution.*"
EXECUTION_INVOKE = "SmartContract.Execution.Invoke"
EXECUTION_SUCCESS = "SmartContract.Execution.Success"
EXECUTION_FAIL = "SmartContract.Execution.Fail"

VERIFICATION = "SmartContract.Verification.*"
VERIFICATION_SUCCESS = "SmartContract.Verification.Success"
VERIFICATION_FAIL = "SmartContract.Verification.Fail"

STORAGE = "SmartContract.Storage.*"
STORAGE_GET = "SmartContract.Storage.Get"
STORAGE_PUT = "SmartContract.Storage.Put"
STORAGE_DELETE = "SmartContract.Storage.Delete"

CONTRACT = "SmartContract.Contract.*"
CONTRACT_CREATED = "SmartContract.Contract.Create"
CONTRACT_MIGRATED = "SmartContract.Contract.Migrate"
CONTRACT_DESTROY = "SmartContract.Contract.Destroy"
複製程式碼

當這些事件發生在接收區塊時，由neo.EventHub排程一個 SmartContractEvent例項。

SmartContractEvent

事件處理程式總是收到引數 neo.EventHub.SmartContractEvent 的一個例項，其包含有關當前事件的所有資訊。SmartContractEvent 具有以下屬性：

屬性	資料型別	描述
event_type	str	neo.EventHub.SmartContractEvent中的一個事件型別
contract_hash	UInt160	合約雜湊值
tx_hash	UInt256	交易雜湊值
block_number	int	收到此事件的區塊號
event_payload	object[]	物件列表，取決於智慧合約發出的資料型別（例如，使用Runtime.Notify）。
execution_success	bool	方法呼叫是否成功
test_mode	bool	這個事件是否由本地TestInvoke排程，而不是從區塊連結收

neo.contrib.smartcontract.SmartContract

開發人員可以使用neo.contrib.smartcontract.SmartContract 輕鬆訂閱這些事件。以下是一個使用雜湊6537b4bd100e514119e3a7ab49d520d20ef2c2a4監聽 Runtime.Notify智慧合約事件的示例：

from neo.contrib.smartcontract import SmartContract

smart_contract = SmartContract("6537b4bd100e514119e3a7ab49d520d20ef2c2a4")

@smart_contract.on_notify
def sc_notify(event):
    print("SmartContract Runtime.Notify event:", event)

    # Make sure that the event payload list has at least one element.
    if not len(event.event_payload):
        return

    # The event payload list has at least one element. As developer of the smart contract
    # you should know what data-type is in the bytes, and how to decode it. In this example,
    # it's just a string, so we decode it with utf-8:
    print("- payload part 1:", event.event_payload[0].decode("utf-8"))
複製程式碼

目前可用的裝飾器如下：

裝飾器	智慧合約事件
@on_any	所有事件
@on_notify	Runtime.Notify
@on_log	Runtime.Log
@on_storage	儲存 PUT, GET 和 DELETE
@on_execution	方法呼叫，成功或失敗

以下示例顯示如何監聽所有事件並區分程式碼中的事件型別：

from neo.contrib.smartcontract import SmartContract
from neo.EventHub import SmartContractEvent

smart_contract = SmartContract("6537b4bd100e514119e3a7ab49d520d20ef2c2a4")

@smart_contract.on_all
def handle_sc_event(event):
    print("SmartContract Runtime.Notify event:", event)

    # Check if it is a Runtime.Notify event
    if event.event_type == SmartContractEvent.RUNTIME_NOTIFY:
        # Exit if an empty payload list
        if not len(event.event_payload):
            return

        # Decode the first payload item and print it
        print("- payload part 1:", event.event_payload[0].decode("utf-8"))
複製程式碼

Prompt 中的智慧合約互動

neo-python 最令人欣喜的功能之一是能夠在 NEO 平臺上快速構建、測試、匯入以及呼叫智慧合約。本節將提供在 Prompt 裡操作智慧合約的基本指南。

建立合約

首先，你需要在 prompt 裡建立一個智慧合約。該方法使用 neo-boa 編譯器編譯智慧合約並將其儲存為 .avm 格式。

在 prompt 裡建立或匯入智慧合約時，最好使用相對路徑 （相對於 neo-python 安裝目錄），儘管絕對路徑可能也有效。

以下是一個示例： sample1.py

def Main():
  print("Hello World")
  return True
neo> build docs/source/example/sample1.py
Saved output to docs/source/example/sample1.avm
複製程式碼

以上命令只是簡單地編譯檔案，之後你就可以在 Prompt 或者 NEO-GUI 中匯入已編譯的 .avm 檔案。

建立並測試合約

建立並測試命令更加常用，它可以在編譯檔案後執行和檢測結果，只是其語法要複雜些。

檢視 ContractParameterType 列表：ContractParameterTypes

該命令語法為:

build path/to/file.py test {input_params} {return_type} {needs_storage} {needs_dynamic_invoke} param1 param2 etc..where {input_params} and {return_type}

• {input_params} ：輸入一個或一系列 ContractParameterType，例如 0710 表示智慧合約接收一個字串和列表。
• {return_type}：輸入一個 ContractParameterType, 例如 02 表示智慧合約返回一個整數。
• {needs_storage} ：輸入布林值 True 或 False 指示智慧合約是否使用 Storage.Get/Put/Delete 互操作 API。
• {needs_dynamic_invoke} ：輸入布林值True 或 False ，用於指示智慧合約是否呼叫另一個執行時才知道地址的合約，通常為 False。
• params1 params2 etc... ：輸入你用來測試的引數。

因此要建立並測試 sample1.py，命令格式為 build docs/source/example/sample1.py test '' 01 False False，其中 '' 表示不接收引數，01 表示返回一個布林值。在 Prompt 中輸入如下：

neo> build docs/source/example/sample1.py test '' 01 False false
Saved output to docs/source/example/sample1.avm
please open a wallet to test built contract
neo>
複製程式碼

現在我們可以開啟錢包來測試之前建立的合約了。注意，開啟錢包後，你可以使用向上箭頭鍵選擇之前輸入過的命令。

neo> open wallet Wallets/awesome
[password]> ***********
Opened wallet at Wallets/awesome
neo> build docs/source/example/sample1.py test '' 01 False false
Saved output to docs/source/example/sample1.avm
[I 180302 22:22:58 Invoke:482] Used 0.016 Gas

-----------------------------------------------------------
Calling docs/source/example/sample1.py with arguments []
Test deploy invoke successful
Used total of 11 operations
Result [{'type': 'Boolean', 'value': True}]
Invoke TX gas cost: 0.0001
-------------------------------------------------------------

neo>
複製程式碼

到此我們就完成了第一個智慧合約的建立和測試。如果想要檢視該智慧合約作為整數時的結果，可以更改 return_type ，你會得到如下所示的輸出：

neo> build docs/source/example/sample1.py test '' 02 False False
Saved output to docs/source/example/sample1.avm
[I 180302 22:25:09 Invoke:482] Used 0.016 Gas

-----------------------------------------------------------
Calling docs/source/example/sample1.py with arguments []
Test deploy invoke successful
Used total of 11 operations
Result [{'type': 'Integer', 'value': 1}]
Invoke TX gas cost: 0.0001
-------------------------------------------------------------

neo>
複製程式碼

在上例中你會發現，儘管合約中包含了 print 命令，卻並沒有列印輸出任何字元。要解決這個問題，讓我們開啟智慧合約事件並再次執行一遍。

neo>
neo> config sc-events on
Smart contract event logging is now enabled
neo> build docs/source/example/sample1.py test '' 01 False False
Saved output to docs/source/example/sample1.avm
[I 180302 22:56:19 EventHub:71] [test_mode][SmartContract.Contract.Create] [09a129673c61917593cb4b57dce066688f539d15] ['{\n    "version": 0,\n    "code": {\n        "hash": "0x09a129673c61917593cb4b57dce066688f539d15",\n        "script": "54c56b0b48656c6c6f20576f726c64680f4e656f2e52756e74696d652e4c6f67516c7566",\n        "parameters": "",\n        "returntype": 1\n    },\n    "name": "test",\n    "code_version": "test",\n    "author": "test",\n    "email": "test",\n    "description": "test",\n    "properties": {\n        "storage": false,\n        "dynamic_invoke": false\n    }\n}']
[I 180302 22:56:19 EventHub:71] [test_mode][SmartContract.Runtime.Log] [09a129673c61917593cb4b57dce066688f539d15] [b'Hello World']
[I 180302 22:56:19 EventHub:71] [test_mode][SmartContract.Execution.Success] [09a129673c61917593cb4b57dce066688f539d15] [1]
[I 180302 22:56:20 Invoke:482] Used 0.016 Gas

-----------------------------------------------------------
Calling docs/source/example/sample1.py with arguments []
Test deploy invoke successful
Used total of 11 operations
Result [{'type': 'Boolean', 'value': True}]
Invoke TX gas cost: 0.0001
-------------------------------------------------------------

neo>
複製程式碼

當我們在 prompt 裡使用 config sc-events on命令開啟 SmartContractEvent 日誌功能後，再次執行相同的命令會發現這次輸出結果中多出了三行。

• SmartContract.Contract.Create 是在 VM 中建立了你的智慧合約事件的事件
• SmartContract.Runtime.Log 是輸出 Hello World 的事件
• SmartContract.Execution.Success 表示智慧合約成功執行完成

下面讓我們嘗試一個複雜點的合約，sample2.py：

def Main(operation, a, b):

    if operation == 'add':
        return a + b

    elif operation == 'sub':
        return a - b

    elif operation == 'mul':
        return a * b

    elif operation == 'div':
        return a / b

    else:
        return -1
複製程式碼

建立並指定幾個引數執行該合約：

neo> build docs/source/example/sample2.py test 070202 02 False False
Saved output to docs/source/example/sample2.avm
[E 180302 22:30:01 ExecutionEngine:825] COULD NOT EXECUTE OP: Invalid list operation b'z' ROLL
[E 180302 22:30:01 ExecutionEngine:826] Invalid list operation
Traceback (most recent call last):
  File "/Users/thomassaunders/Workshop/neo-python/neo/VM/ExecutionEngine.py", line 823, in StepInto
    self.ExecuteOp(op, self.CurrentContext)
  File "/Users/thomassaunders/Workshop/neo-python/neo/VM/ExecutionEngine.py", line 276, in ExecuteOp
    estack.PushT(estack.Remove(n))
  File "/Users/thomassaunders/Workshop/neo-python/neo/VM/RandomAccessStack.py", line 57, in Remove
    raise Exception("Invalid list operation")
Exception: Invalid list operation
[I 180302 22:30:01 InteropService:93] Trying to get big integer Array: ['None', 'None', 'None', 'None', 'None', 'None', 'None', 'None', 'None', 'None', 'None', 'None', 'None', 'None']
複製程式碼

出現以上結果的原因是，我們測試的合約要求提供更多的引數。如果你在建立並測試合約時遇到相似的錯誤資訊，很有可能是相同的原因。讓我們輸入一些引數再嘗試一次：

neo> build docs/source/example/sample2.py test 070202 02 False False add 1 2
Saved output to docs/source/example/sample2.avm
[I 180302 22:32:06 Invoke:482] Used 0.033 Gas

-----------------------------------------------------------
Calling docs/source/example/sample2.py with arguments ['add', '1', '2']
Test deploy invoke successful
Used total of 39 operations
Result [{'type': 'Integer', 'value': 3}]
Invoke TX gas cost: 0.0001
-------------------------------------------------------------

neo>
neo> build docs/source/example/sample2.py test 070202 02 False False mul -1 20000
Saved output to docs/source/example/sample2.avm
[I 180302 22:33:36 Invoke:482] Used 0.041 Gas

-----------------------------------------------------------
Calling docs/source/example/sample2.py with arguments ['mul', '-1', '20000']
Test deploy invoke successful
Used total of 53 operations
Result [{'type': 'Integer', 'value': -20000}]
Invoke TX gas cost: 0.0001
-------------------------------------------------------------

neo>
複製程式碼

這次好多了。接下來讓我們做些更有用的嘗試，我們將做一個簡單的地址餘額跟蹤器。

from boa.interop.Neo.Storage import Get,Put,Delete,GetContext

def Main(operation, addr, value):


    if not is_valid_addr(addr):
        return False

    ctx = GetContext()

    if operation == 'add':
        balance = Get(ctx, addr)
        new_balance = balance + value
        Put(ctx, addr, new_balance)
        return new_balance

    elif operation == 'remove':
        balance = Get(ctx, addr)
        Put(ctx, addr, balance - value)
        return balance - value

    elif operation == 'balance':
        return Get(ctx, addr)

    return False

def is_valid_addr(addr):

    if len(addr) == 20:
        return True
    return False
複製程式碼

我們將使用 add 進行一個測試，給錢包裡的一個地址新增一些值。你會注意到，當你在錢包裡輸入任意地址時會自動完成輸入，這可能會產生誤導。當通過 prompt 將地址傳送到 SC 時，它會自動轉換為 ByteArray 以便使用。 因此方法簽名看起來像 070502 或 String，ByteArray，Integer。

我們使用 True 來表示使用智慧合約的 Storage API。

neo> build docs/source/example/sample3.py test 070502 02 True False add AG4GfwjnvydAZodm4xEDivguCtjCFzLcJy 3
Saved output to docs/source/example/sample3.avm
[I 180302 23:04:33 Invoke:482] Used 1.174 Gas

-----------------------------------------------------------
Calling docs/source/example/sample3.py with arguments ['add', 'AG4GfwjnvydAZodm4xEDivguCtjCFzLcJy', '3']
Test deploy invoke successful
Used total of 106 operations
Result [{'type': 'Integer', 'value': 3}]
Invoke TX gas cost: 0.0001
-------------------------------------------------------------

neo>
複製程式碼

再次呼叫，將看到我們的測試呼叫保留了儲存庫中的值。

neo> build docs/source/example/sample3.py test 070502 02 True False add AG4GfwjnvydAZodm4xEDivguCtjCFzLcJy 3
Saved output to docs/source/example/sample3.avm
[I 180302 23:04:33 Invoke:482] Used 1.174 Gas

-----------------------------------------------------------
Calling docs/source/example/sample3.py with arguments ['add', 'AG4GfwjnvydAZodm4xEDivguCtjCFzLcJy', '3']
Test deploy invoke successful
Used total of 106 operations
Result [{'type': 'Integer', 'value': 6}]
Invoke TX gas cost: 0.0001
-------------------------------------------------------------

neo>
複製程式碼

現在除去一些值：

neo> build docs/source/example/sample3.py test 070502 02 True False remove AG4GfwjnvydAZodm4xEDivguCtjCFzLcJy 2
Saved output to docs/source/example/sample3.avm
[I 180302 23:09:21 Invoke:482] Used 1.176 Gas

-----------------------------------------------------------
Calling docs/source/example/sample3.py with arguments ['remove', 'AG4GfwjnvydAZodm4xEDivguCtjCFzLcJy', '2']
Test deploy invoke successful
Used total of 109 operations
Result [{'type': 'Integer', 'value': 4}]
Invoke TX gas cost: 0.0001
-------------------------------------------------------------

neo>
複製程式碼

你也可以為地址傳入一個 ByteArray 物件，並測試是否 is_valid_addr 在任何事情發生前返回 False，這會被解析為 0：

neo> build docs/source/example/sample3.py test 070502 02 True False add bytearray(b'\x00\x01\x02\x03') 4
Saved output to docs/source/example/sample3.avm
[I 180302 23:12:43 Invoke:482] Used 0.041 Gas

-----------------------------------------------------------
Calling docs/source/example/sample3.py with arguments ['add', "bytearray(b'\\x00\\x01\\x02\\x03')", '4']
Test deploy invoke successful
Used total of 52 operations
Result [{'type': 'Integer', 'value': 0}]
Invoke TX gas cost: 0.0001
-------------------------------------------------------------

neo>
複製程式碼

請注意，以可讀格式 (

) 傳送地址與傳送地址的指令碼雜湊是一樣的。我們將通過獲取餘額進行嘗試。由於智慧合約期望第三個引數，我在最後新增了一個額外的 0 作為最後一個引數：

neo> build docs/source/example/sample3.py test 070502 02 True False balance bytearray(b'\x03\x19\xe0)\xb9%\x85w\x90\xe4\x17\x85\xbe\x9c\xce\xc6\xca\xb1\x98\x96') 0
Saved output to docs/source/example/sample3.avm
[I 180302 23:16:23 Invoke:482] Used 0.162 Gas

-----------------------------------------------------------
Calling docs/source/example/sample3.py with arguments ['balance', "bytearray(b'\\x03\\x19\\xe0)\\xb9%\\x85w\\x90\\xe4\\x17\\x85\\xbe\\x9c\\xce\\xc6\\xca\\xb1\\x98\\x96')", '0']
Test deploy invoke successful
Used total of 87 operations
Result [{'type': 'Integer', 'value': 4}]
Invoke TX gas cost: 0.0001
-------------------------------------------------------------

neo>
複製程式碼

匯入智慧合約

匯入智慧合約有點類似 build .. test 命令，但你不需要傳送任何引數。命令格式為：

import contract path/to/sample2.avm {input_params} {return_type} {needs_storage} {needs_dynamic_invoke}

執行該命令後，如果一切正常系統會提示你新增合約相關的後設資料。完成後你就可以選擇在網路中實際部署將該合約。請注意部署合約將花費 GAS。

neo>
neo> import contract docs/source/example/sample2.avm 070202 02 False False
Please fill out the following contract details:
[Contract Name] > Sample Calculator
[Contract Version] > .01
[Contract Author] > Thomas Saunders
[Contract Email] > tom@cityofzion.io
[Contract Description] > A test calculator contract
Creating smart contract....
               Name: A test calculator contract
            Version: .01
             Author: tom@cityofzion.io
              Email: tom@cityofzion.io
        Description: A test calculator contract
      Needs Storage: False
Needs Dynamic Invoke: False
{
  "hash": "0x86d58778c8d29e03182f38369f0d97782d303cc0",
  "script": "5ec56b6a00527ac46a51527ac46a52527ac46a00c3036164649c640d006a51c36a52c3936c7566616a00c3037375629c640d006a51c36a52c3946c7566616a00c3036d756c9c640d006a51c36a52c3956c7566616a00c3036469769c640d006a51c36a52c3966c7566614f6c7566006c7566",
  "parameters": "070202",
  "returntype": "02"
}
Used 100.0 Gas

-------------------------------------------------------------------------------------------------------------------------------------
Test deploy invoke successful
Total operations executed: 11
Results:
[<neo.Core.State.ContractState.ContractState object at 0x11435d2e8>]
Deploy Invoke TX GAS cost: 90.0
Deploy Invoke TX Fee: 0.0
-------------------------------------------------------------------------------------------------------------------------------------

Enter your password to continue and deploy this contract
[password]>
複製程式碼

從這裡開始，如果你確定要花費 GAS 來部署合約，輸入密碼：

Enter your password to continue and deploy this contract
[password]> ***********
[I 180302 23:46:23 Transaction:611] Verifying transaction: b'f8ad261d28bf4bc5544e47f9bc3fff85f85ee674f14162dac81dd56bf73cf0a3'
Relayed Tx: f8ad261d28bf4bc5544e47f9bc3fff85f85ee674f14162dac81dd56bf73cf0a3
neo>
複製程式碼

現在你已將合約部署到網路。 如果一切順利，將很快部署。 要確定何時部署完成，在區塊鏈中搜尋 txid 或合約雜湊。

neo> tx f8ad261d28bf4bc5544e47f9bc3fff85f85ee674f14162dac81dd56bf73cf0a3
{
  "txid": "0xf8ad261d28bf4bc5544e47f9bc3fff85f85ee674f14162dac81dd56bf73cf0a3",
  "type": "InvocationTransaction",
  "version": 1,
  "attributes": [],
  [ MORE Output Omitted ]

neo> contract 0x86d58778c8d29e03182f38369f0d97782d303cc0
{
    "version": 0,
    "code": {
        "hash": "0x86d58778c8d29e03182f38369f0d97782d303cc0",
        "script": "5ec56b6a00527ac46a51527ac46a52527ac46a00c3036164649c640d006a51c36a52c3936c7566616a00c3037375629c640d006a51c36a52c3946c7566616a00c3036d756c9c640d006a51c36a52c3956c7566616a00c3036469769c640d006a51c36a52c3966c7566614f6c7566006c7566",
        "parameters": "070202",
        "returntype": 2
    },
    "name": "A test calculator contract",
    "code_version": ".01",
    "author": "tom@cityofzion.io",
    "email": "tom@cityofzion.io",
    "description": "A test calculator contract",
    "properties": {
        "storage": false,
        "dynamic_invoke": false
    }
}

neo>
複製程式碼

現在你已經在網路上部署了合同，可以使用真正的 InvocationTransactions 與它進行互動。

測試呼叫合約

一旦部署了合約，你就無法再像使用 build .. test 命令那樣進行互動，更改和構建，但最好是使用 testinvoke 來確定鏈上的工作。

現在我們已經部署了

，只要知道它的指令碼雜湊，就可以使用 testinvoke 命令與它進行互動。命令格式是 testinvoke {contract_hash} param1 param2 ..

neo> testinvoke 0x86d58778c8d29e03182f38369f0d97782d303cc0 add 1 2
Used 0.033 Gas

-------------------------------------------------------------------------------------------------------------------------------------
Test invoke successful
Total operations: 39
Results ['Integer: 3 ']
Invoke TX GAS cost: 0.0
Invoke TX fee: 0.0001
-------------------------------------------------------------------------------------------------------------------------------------

Enter your password to continue and invoke on the network

[password]>
複製程式碼

這個呼叫只在本地完成，只有在你輸入密碼後才能執行。如果你不希望在網路中呼叫，只需輸入錯誤密碼即可取消。這裡我們取消呼叫，然後設定 config sc-events on 以確切地檢視測試呼叫時發生的情況，然後將其傳送到網路：

Enter your password to continue and invoke on the network

[password]> **
Incorrect password
neo>
neo> config sc-events on
Smart contract event logging is now enabled
neo>
neo> testinvoke 0x86d58778c8d29e03182f38369f0d97782d303cc0 add 1 2
[I 180303 07:38:58 EventHub:71] [test_mode][SmartContract.Execution.Success] [86d58778c8d29e03182f38369f0d97782d303cc0] [3]
Used 0.033 Gas

-------------------------------------------------------------------------------------------------------------------------------------
Test invoke successful
Total operations: 39
Results ['Integer: 3 ']
Invoke TX GAS cost: 0.0
Invoke TX fee: 0.0001
-------------------------------------------------------------------------------------------------------------------------------------

Enter your password to continue and invoke on the network

[password]> ***********
[I 180303 07:39:04 Transaction:611] Verifying transaction: b'e0f4251a83f7081fb6fd94ce884d12b0bb597c1c1b3f1a89f07db68e114f4fa2'
[I 180303 07:39:04 EventHub:89] [SmartContract.Verification.Success][433121] [4c896601a99d58e22c32dcadd24974ca24c10587] [tx e0f4251a83f7081fb6fd94ce884d12b0bb597c1c1b3f1a89f07db68e114f4fa2] [True]
Relayed Tx: e0f4251a83f7081fb6fd94ce884d12b0bb597c1c1b3f1a89f07db68e114f4fa2
neo>
neo> [I 180303 07:39:31 EventHub:89] [SmartContract.Execution.Success][433122] [86d58778c8d29e03182f38369f0d97782d303cc0] [tx e0f4251a83f7081fb6fd94ce884d12b0bb597c1c1b3f1a89f07db68e114f4fa2] [3]
neo>
複製程式碼

在這裡請注意以下幾點：

1. 當使用 sc-events on 測試呼叫時，將看到
   SmartContract.Execution.Success
   事件，並且將看到該事件顯示已在 test_mode 完成測試。
2. 現在你將看到 SmartContract.Verification.Success 事件。 這說明 TX 已正確簽名並將通過驗證，因為它被傳遞到其他節點並最終將達成一致。
3. 將 InvocationTransaction 傳送到網路後，你將獲得一個TX ID，可以用來查詢呼叫。
4. 在網路處理完 TX 之後，本地 VM 會執行你的呼叫，這次不在 test_mode 中，你將再次看到SmartContract.Execution.Success 事件。