Ontology CLI와 스마트 컨트랙트의 상호작용
Ontology CLI와 체인의 상호작용
이 튜토리얼에서 사용된 Ontology CLI은 0.9버전이며，Ontology CLI버전은 ./ontology --help명령으로 확인할 수 있습니다.
$./ontology --help
VERSION:
0.9
Ontology CLI개요
- Ontology CLI시작
$./ontology
- 도움 받기
$./ontology --help
계정 관리
노드 실행시엔 지갑 파일 .dat이 필요합니다. 처음으로 Ontology CLI를 시작할 때 지갑 파일을 만들어야 하며 그렇지 않을 경우 다음과 같은 프롬프트가 표시됩니다：
$ ./ontology
[INFO ] GID 1, Config init success
[ERROR] GID 1, initWallet error:Cannot find wallet file:./wallet.dat. Please create wallet first
지갑 파일.dat의 내용은 다음과 같습니다：
{
"name":"MyWallet",
"version":"1.1",
"scrypt":{
"p":8,
"n":16384,
"r":8,
"dkLen":64
},
"accounts":[
{
"address":"AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs",
"enc-alg":"aes-256-gcm",
"key":"94SPzRl5PHi8qJayofpGvpioS9zSDCnIZBfpyWI4GXedSgTFpFFAnpyqmPM38Q+z",
"algorithm":"ECDSA",
"salt":"HkBRKvpiONzICBFCFrUuHw==",
"parameters":{
"curve":"P-256"
},
"label":"",
"publicKey":"032cf2191a24c6bee28abbee0c4b5265dc841394f2794c1fb18e52ffb2c9d7c9c6",
"signatureScheme":"SHA256withECDSA",
"isDefault":true,
"lock":false
}
]
}
명령개요
아래에서 볼 수 있듯이 ontology account명령은 추가, 보기, 수정, 삭제, 가져오기 등의 작업을하고 여러개의 서명 주소를 생성합니다.
$ ./ontology account --help
NAME:
ontology account - Wallet management commands can be used to add, view, modify, delete, import account, and so on.
USAGE:
ontology account command [command options] [arguments...]
COMMANDS:
add Add a new account
list List existing accounts
set Modify an account
del Delete an account
import Import accounts of wallet to another
export Export accounts to a specified wallet file
multisigaddr Gen multi-signature address
OPTIONS:
--help, -h show help
계정 추가
./ontology account add`명령으로 계정을 추가할 수 있습니다. 명령으로 지원되는 매개변수는 다음과 같습니다.
$ ./ontology account add --help
USAGE:
ontology account add [command options] [sub-command options]
DESCRIPTION:
Add a new account to wallet.
ACCOUNT OPTIONS:
--number <quantity>, -n <quantity>
Specifies the <quantity> of account to create. (default: 1)
--type <key-type>, -t <key-type>
Specifies the <key-type> by signature algorithm.
--bit-length <bit-length>, -b <bit-length>
Specifies the <bit-length> of key
--signature-scheme <scheme>, -s <scheme>
Specifies the signature scheme <scheme>
--default, -d
Use default settings to create a new account (equal to '-t ecdsa -b 256 -s SHA256withECDSA')
--label <label>, -l <label>
Use <label> for newly created accounts for easy and fast use of accounts.
Note that duplicate label names cannot appear in the same wallet file.
An account with no label is an empty string.
--wallet <filename>, -w <filename>
Use <filename> as the wallet (default: "./wallet.dat")
- 계정 만들기
$ ./ontology account add
Select a signature algorithm from the following:
1 ECDSA
2 SM2
3 Ed25519
[default is 1]: 1
ecdsa is selected.
Select a curve from the following:
| NAME | KEY LENGTH (bits)
---|-------|------------------
1 | P-224 | 224
2 | P-256 | 256
3 | P-384 | 384
4 | P-521 | 521
This determines the length of the private key [default is 2]: 2
scheme P-256 is selected.
Select a signature scheme from the following:
1 SHA224withECDSA
2 SHA256withECDSA
3 SHA384withECDSA
4 SHA512withECDSA
5 SHA3-224withECDSA
6 SHA3-256withECDSA
7 SHA3-384withECDSA
8 SHA3-512withECDSA
9 RIPEMD160withECDSA
This can be changed later [default is 2]: 2
scheme SHA256withECDSA is selected.
Password:
Re-enter Password:
Index: 3
Label:
Address: AQZ7siPVMSK2wmPrcFuaH5moCK9CcnSamW
Public key: 0267711482fe11a3313db449982b383c1cf2637636f1096625d20fb40568b5aaec
Signature scheme: SHA256withECDSA
Create account successfully.
- 기본 설정으로 계정 생성
$ ./ontology account add -d
Use default setting '-t ecdsa -b 256 -s SHA256withECDSA'
signature algorithm: ecdsa
curve: P-256
signature scheme: SHA256withECDSA
Password:
Re-enter Password:
Index: 2
Label:
Address: AXqduY2hhW8DbDphFz6nTiBA5SUaDHqndB
Public key: 033d172e68b20ef34c602af415cc3f4e77d8c6d0f5ac2223c3c8cd7ce85036bbec
Signature scheme: SHA256withECDSA
Create account successfully.
- 대량 계정 생성
$ ./ontology account add -n 3 -d -w wallet.dat
Use default setting '-t ecdsa -b 256 -s SHA256withECDSA'
signature algorithm: ecdsa
curve: P-256
signature scheme: SHA256withECDSA
Password:
Re-enter Password:
Index: 1
Label:
Address: AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs
Public key: 032cf2191a24c6bee28abbee0c4b5265dc841394f2794c1fb18e52ffb2c9d7c9c6
Signature scheme: SHA256withECDSA
Index: 2
Label:
Address: AZk95PorAAUFGZUUQbozUHgVADQ5LFj1WJ
Public key: 02dca3145b351386aba4464862a470b97a8b64ef077dbe370831b74791d02efe50
Signature scheme: SHA256withECDSA
Index: 3
Label:
Address: AGrHMXjj14iiyGzHfmz2nrCKveHSeEzs2E
Public key: 033ec2635d84d0b0c5e932bbb9c5aa61b0d79b32e42979d5694c1efb54dcd86293
Signature scheme: SHA256withECDSA
Create account successfully.
계정 표시
./ontology account list명령은 현재 지갑파일에 저장된 계정을 표히하는데 사용되며, 그 예는 아래에 나와있습니다.
$ ./ontology account list
Index:1 Address:AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs Label: (default)
Index:2 Address:AaG9jUSBTWXjeUzR3LBDiPBUPrGUbSKu3g Label:
정보 수집
명령 개요
$ ./ontology info
USAGE:
ontology info command [command options] [arguments...]
Description:
Query information command can query information such as blocks, transactions, and transaction executions.
COMMANDS:
tx Display transaction information
block Display block information
status Display transaction status
curblockheight Display the current block height
OPTIONS:
--help, -h show help
블록 정보 수집
블록 높이 별 블록 정보 쿼리
$ ./ontology info block 1
{
"Hash": "312fcb5739620956999c138a6d4b60682c9e9c9cff1ca37776ed77257c1ca86c",
"Header": {
"Version": 0,
"PrevBlockHash": "1a9a9f5ab90dd537fb53e8f74b7519b14cea05cde95b1da33a0971a630b4040a",
"TransactionsRoot": "0000000000000000000000000000000000000000000000000000000000000000",
"BlockRoot": "8e927cf85381ad80ca8b267070939fd57695b4ef9b9fc5ea63e73dc716d9e45d",
"Timestamp": 1529908576,
"Height": 1,
"ConsensusData": 11154013587666973726,
"ConsensusPayload": "",
"NextBookkeeper": "AJmM4TYyBxiQqsKZfvfCg5z66TjGx9x29P",
"Bookkeepers": [
"0315a692b695bc9e08dbede48ff61f52d98ad3b4cb13eb31ba2d32bf1da8e570b9"
],
"SigData": [
"43f4e406558ff79f4fd1beac9a2cb0e50f6bf839a59ada1c98ee4fcfa9ad26d4109f2f9d8c414551fc582470273bf18bf820f773520fa6083ded5ba84f36f936"
],
"Hash": "312fcb5739620956999c138a6d4b60682c9e9c9cff1ca37776ed77257c1ca86c"
},
"Transactions": []
}
블록 해시로 블록 정보 조회
$ ./ontology info block 312fcb5739620956999c138a6d4b60682c9e9c9cff1ca37776ed77257c1ca86c
{
"Hash": "312fcb5739620956999c138a6d4b60682c9e9c9cff1ca37776ed77257c1ca86c",
"Header": {
"Version": 0,
"PrevBlockHash": "1a9a9f5ab90dd537fb53e8f74b7519b14cea05cde95b1da33a0971a630b4040a",
"TransactionsRoot": "0000000000000000000000000000000000000000000000000000000000000000",
"BlockRoot": "8e927cf85381ad80ca8b267070939fd57695b4ef9b9fc5ea63e73dc716d9e45d",
"Timestamp": 1529908576,
"Height": 1,
"ConsensusData": 11154013587666973726,
"ConsensusPayload": "",
"NextBookkeeper": "AJmM4TYyBxiQqsKZfvfCg5z66TjGx9x29P",
"Bookkeepers": [
"0315a692b695bc9e08dbede48ff61f52d98ad3b4cb13eb31ba2d32bf1da8e570b9"
],
"SigData": [
"43f4e406558ff79f4fd1beac9a2cb0e50f6bf839a59ada1c98ee4fcfa9ad26d4109f2f9d8c414551fc582470273bf18bf820f773520fa6083ded5ba84f36f936"
],
"Hash": "312fcb5739620956999c138a6d4b60682c9e9c9cff1ca37776ed77257c1ca86c"
},
"Transactions": []
}
트랜잭션 정보 얻기
$ ./ontology info status 93768ba53a6e55fe9d228163e39d85f3b7992feab2346053e5012ebba48b48f9
Transaction states:
{
"TxHash": "93768ba53a6e55fe9d228163e39d85f3b7992feab2346053e5012ebba48b48f9",
"State": 1,
"GasConsumed": 0,
"Notify": [
{
"ContractAddress": "0100000000000000000000000000000000000000",
"States": [
"transfer",
"AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs",
"AaG9jUSBTWXjeUzR3LBDiPBUPrGUbSKu3g",
10
]
}
]
}
현재 블록 높이로 획득
$ ./ontology info curblockheight
CurrentBlockHeight:5467
자산 관리
본 수업에서 사용된 샘플 계정은 다음과 같습니다.
$ ontology account list
Index:1 Address:AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs Label: (default)
Index:2 Address:AaG9jUSBTWXjeUzR3LBDiPBUPrGUbSKu3g Label:
명령개요
$ ./ontology asset help
Description:
ontology asset - Handle assets
USAGE:
ontology asset [options] command [command options] [arguments...]
VERSION:
0.9
COMMANDS:
transfer Transfer ont or ong to another account
approve Approve another user can transfer asset
transferfrom Using to transfer asset after approve
balance Show balance of ont and ong of specified account
allowance Show approve balance of ont or ong of specified account
unboundong Show the balance of unbound ONG
withdrawong Withdraw ONG
help, h Shows a list of commands or help for one command
MISC OPTIONS:
--help, -h show help
ONG얻기
- 계정 잔액 확인
$ ./ontology asset balance AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs
BalanceOf:AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs
ONT:1000000000
ONG:0
- 아직 얻지 못한 ONG확인
./ontology asset unboundong AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs
Unbound ONG:
Account:AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs
ONG:7914590
$ ./ontology asset unboundong AaG9jUSBTWXjeUzR3LBDiPBUPrGUbSKu3g
Unbound ONG:
Account:AaG9jUSBTWXjeUzR3LBDiPBUPrGUbSKu3g
ONG:0
- ONG얻기
$ ./ontology asset withdrawong AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs
Password:
Withdraw ONG:
Account:AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs
Amount:7914590
TxHash:0ca17f47ebb4127b26cafeadabd21d96353c5c00e0392f44a573d6b7d3c0fcdd
Tip:
Using './ontology info status 0ca17f47ebb4127b26cafeadabd21d96353c5c00e0392f44a573d6b7d3c0fcdd' to query transaction status
- 트랜잭션 상태 확인
$ ./ontology info status 0ca17f47ebb4127b26cafeadabd21d96353c5c00e0392f44a573d6b7d3c0fcdd
Transaction states:
{
"TxHash": "0ca17f47ebb4127b26cafeadabd21d96353c5c00e0392f44a573d6b7d3c0fcdd",
"State": 1,
"GasConsumed": 0,
"Notify": [
{
"ContractAddress": "0200000000000000000000000000000000000000",
"States": [
"transfer",
"AFmseVrdL9f9oyCzZefL9tG6UbvhUMqNMV",
"AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs",
7914590000000000
]
}
]
}
- 트랜잭션 잔액 확인
$ ./ontology asset balance AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs
BalanceOf:AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs
ONT:1000000000
ONG:7914590
이체 내역
명령개요
USAGE:
ontology asset transfer [command options]
DESCRIPTION:
Transfer ont or ong to another account. If from address does not specified, using default account
ACCOUNT OPTIONS:
--wallet <filename>, -w <filename>
Use <filename> as the wallet (default: "./wallet.dat")
TXPOOL OPTIONS:
--gasprice value
Using to specifies the gas price of transaction.
The gas price of the transaction cannot be less than the lowest gas price set by node's transaction pool, otherwise the transaction will be rejected.
When there are transactions that are queued for packing into the block in the transaction pool, the transaction pool will deal with transactions according to the gas price and transactions with high gas prices will be prioritized (default: 0)
--gaslimit value
Using to specifies the gas limit of the transaction.
The gas limit of the transaction cannot be less than the minimum gas limit set by the node's transaction pool, otherwise the transaction will be rejected.
Gasprice * gaslimit is actual ONG costs. (default: 20000)
RPC OPTIONS:
--rpcport value Json rpc server listening port (default: 20336)
TRANSACTION OPTIONS:
--asset <ont|ong> Using to specifies the transfer asset <ont|ong> (default: "ont")
--from <address|label|index> Using to specifies the transfer-out account <address|label|index>
--to <address|label|index> Using to specifies the transfer-in account <address|label|index>
--amount value Using to specifies the transfer amount
ONT이체
- 계정 잔액 확인
$ ./ontology asset balance AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs
BalanceOf:AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs
ONT:1000000000
ONG:7914590
$ ./ontology asset balance AaG9jUSBTWXjeUzR3LBDiPBUPrGUbSKu3g
BalanceOf:AaG9jUSBTWXjeUzR3LBDiPBUPrGUbSKu3g
ONT:0
ONG:0
- 이체 진행
$ ./ontology asset transfer --asset ONT --from AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs --to AaG9jUSBTWXjeUzR3LBDiPBUPrGUbSKu3g --amount 10 --gaslimit 20000
Password:
Transfer ONT
From:AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs
To:AaG9jUSBTWXjeUzR3LBDiPBUPrGUbSKu3g
Amount:10
TxHash:93768ba53a6e55fe9d228163e39d85f3b7992feab2346053e5012ebba48b48f9
Tip:
Using './ontology info status 93768ba53a6e55fe9d228163e39d85f3b7992feab2346053e5012ebba48b48f9' to query transaction status
- 트랜잭션 결과 확인
$ ./ontology info status 93768ba53a6e55fe9d228163e39d85f3b7992feab2346053e5012ebba48b48f9
Transaction states:
{
"TxHash": "93768ba53a6e55fe9d228163e39d85f3b7992feab2346053e5012ebba48b48f9",
"State": 1,
"GasConsumed": 0,
"Notify": [
{
"ContractAddress": "0100000000000000000000000000000000000000",
"States": [
"transfer",
"AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs",
"AaG9jUSBTWXjeUzR3LBDiPBUPrGUbSKu3g",
10
]
}
]
}
- 트랜잭션 잔액 확인
$ ./ontology asset balance AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs
BalanceOf:AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs
ONT:999999990
ONG:7914590
$ ./ontology asset balance AaG9jUSBTWXjeUzR3LBDiPBUPrGUbSKu3g
BalanceOf:AaG9jUSBTWXjeUzR3LBDiPBUPrGUbSKu3g
ONT:10
ONG:0
ONG이체
- 계정 잔액 확인
$ ./ontology asset balance AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs
BalanceOf:AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs
ONT:999999990
ONG:7914590
$ ./ontology asset balance AaG9jUSBTWXjeUzR3LBDiPBUPrGUbSKu3g
BalanceOf:AaG9jUSBTWXjeUzR3LBDiPBUPrGUbSKu3g
ONT:10
ONG:0
- 이체 진행
$ ./ontology asset transfer --asset ONG --from AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs --to AaG9jUSBTWXjeUzR3LBDiPBUPrGUbSKu3g --amount 10 --gaslimit 20000
Password:
Transfer ONG
From:AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs
To:AaG9jUSBTWXjeUzR3LBDiPBUPrGUbSKu3g
Amount:10
TxHash:84d7e8c98d224212f260e0034e36735ec935021818dca1b654522196be0eb624
Tip:
Using './ontology info status 84d7e8c98d224212f260e0034e36735ec935021818dca1b654522196be0eb624' to query transaction status
- 트랜잭션 결과 확인
$ ./ontology info status 84d7e8c98d224212f260e0034e36735ec935021818dca1b654522196be0eb624
Transaction states:
{
"TxHash": "84d7e8c98d224212f260e0034e36735ec935021818dca1b654522196be0eb624",
"State": 1,
"GasConsumed": 0,
"Notify": [
{
"ContractAddress": "0200000000000000000000000000000000000000",
"States": [
"transfer",
"AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs",
"AaG9jUSBTWXjeUzR3LBDiPBUPrGUbSKu3g",
10000000000
]
}
]
}
- 계정 잔액 확인
$ ./ontology asset balance AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs
BalanceOf:AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs
ONT:999999990
ONG:7914580
$ ./ontology asset balance AaG9jUSBTWXjeUzR3LBDiPBUPrGUbSKu3g
BalanceOf:AaG9jUSBTWXjeUzR3LBDiPBUPrGUbSKu3g
ONT:10
ONG:10
승인 이전
- 계정 잔액 확인
$ ./ontology asset balance AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs
BalanceOf:AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs
ONT:999999990
ONG:7914580
$ ./ontology asset balance AaG9jUSBTWXjeUzR3LBDiPBUPrGUbSKu3g
BalanceOf:AaG9jUSBTWXjeUzR3LBDiPBUPrGUbSKu3g
ONT:10
ONG:10
- 권한 이전
$ ./ontology asset approve --from AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs --to AaG9jUSBTWXjeUzR3LBDiPBUPrGUbSKu3g --amount 1.000000002 --asset ONG
Password:
Approve:
Asset:ONG
From:AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs
To:AaG9jUSBTWXjeUzR3LBDiPBUPrGUbSKu3g
Amount:1.000000002
TxHash:219d2d3473ca0e2b9c96b938121e36e74c5fc55496142f64eb4cac9f75d3231a
Tip:
Using './ontology info status 219d2d3473ca0e2b9c96b938121e36e74c5fc55496142f64eb4cac9f75d3231a' to query transaction status
- 트랜잭션 결과 확인
$ ./ontology info status 219d2d3473ca0e2b9c96b938121e36e74c5fc55496142f64eb4cac9f75d3231a
Transaction states:
{
"TxHash": "219d2d3473ca0e2b9c96b938121e36e74c5fc55496142f64eb4cac9f75d3231a",
"State": 1,
"GasConsumed": 0,
"Notify": []
}
- 권한 이전 잔액 확인
$ ./ontology asset allowance --from AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs --to AaG9jUSBTWXjeUzR3LBDiPBUPrGUbSKu3g --asset ONG
Allowance:ONG
From:AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs
To:AaG9jUSBTWXjeUzR3LBDiPBUPrGUbSKu3g
Balance:1.000000002
- 권한 계정에서 이체
$ ./ontology asset transferfrom -from AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs --to AaG9jUSBTWXjeUzR3LBDiPBUPrGUbSKu3g --sender AaG9jUSBTWXjeUzR3LBDiPBUPrGUbSKu3g --amount 1.000000001 --asset ONG
Password:
Transfer from:
Asset:ONG
Sender:AaG9jUSBTWXjeUzR3LBDiPBUPrGUbSKu3g
From:AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs
To:AaG9jUSBTWXjeUzR3LBDiPBUPrGUbSKu3g
Amount:1.000000001
TxHash:6dad38a2961d012ca235aa2e6b6f52157bc8710b0df60a8e6d56f9d8a83b1e68
Tip:
Using './ontology info status 6dad38a2961d012ca235aa2e6b6f52157bc8710b0df60a8e6d56f9d8a83b1e68' to query transaction status
- 트랜잭션 결과 확인
$ ./ontology info status 6dad38a2961d012ca235aa2e6b6f52157bc8710b0df60a8e6d56f9d8a83b1e68
Transaction states:
{
"TxHash": "6dad38a2961d012ca235aa2e6b6f52157bc8710b0df60a8e6d56f9d8a83b1e68",
"State": 1,
"GasConsumed": 0,
"Notify": [
{
"ContractAddress": "0200000000000000000000000000000000000000",
"States": [
"transfer",
"AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs",
"AaG9jUSBTWXjeUzR3LBDiPBUPrGUbSKu3g",
1000000001
]
}
]
}
- 권한 잔액 확인
$ ./ontology asset allowance --from AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs --to AaG9jUSBTWXjeUzR3LBDiPBUPrGUbSKu3g --asset ONG
Allowance:ONG
From:AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs
To:AaG9jUSBTWXjeUzR3LBDiPBUPrGUbSKu3g
Balance:0.000000001
- 계정 잔액 확인
$ ./ontology asset balance AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs
BalanceOf:AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs
ONT:999999990
ONG:7914578.999999999
$ ./ontology asset balance AaG9jUSBTWXjeUzR3LBDiPBUPrGUbSKu3g
BalanceOf:AaG9jUSBTWXjeUzR3LBDiPBUPrGUbSKu3g
ONT:10
ONG:11.000000001
스마트 컨트랙트
스마트 컨트랙트 예제：
using Neo.SmartContract.Framework.Services.Neo;
using Neo.SmartContract.Framework;
using System;
using System.ComponentModel;
namespace Neo.SmartContract
{
public class HelloWorld : Framework.SmartContract
{
public static object Main(string operation, params object[] args)
{
switch (operation)
{
case "Hello":
Hello((string)args[0]);
return true;
default:
return false;
}
}
public static void Hello(string msg)
{
Runtime.Log(msg);
}
}
}
명령 개요
$ ./ontology contract help
NAME:
ontology contract - Deploy or invoke smart contract
Ontology CLI is an Ontology node command line Client for starting and managing Ontology nodes,
managing user wallets, sending transactions, deploying and invoking contract, and so on.
USAGE:
ontology contract [options] command [command options]
VERSION:
v0.9.4-17-g4c96
COMMANDS:
deploy Deploy a smart contract to ontolgoy
invoke Invoke smart contract
invokeCode Invoke smart contract by code
help, h Shows a list of commands or help for one command
MISC OPTIONS:
--help, -h show help
스마트 컨트랙트 배포
- 배포 매개 변수 개요
$ ./ontology contract deploy help
USAGE:
ontology contract deploy [command options]
ACCOUNT OPTIONS:
--wallet <filename>, -w <filename>
Use <filename> as the wallet (default: "./wallet.dat")
--account <address|label|index>, -a <address|label|index>
Using to specify the account <address|label|index> when the Ontology node starts. If the account is null, it uses the wallet default account
TXPOOL OPTIONS:
--gasprice value
Using to specifies the gas price of transaction. The gas price of the transaction cannot be less than the lowest gas price set by node's transaction pool, otherwise the transaction will be rejected. When there are transactions that are queued for packing into the block in the transaction pool, the transaction pool will deal with transactions according to the gas price and transactions with high gas prices will be prioritized (default: 0)
--gaslimit value
Using to specifies the gas limit of the transaction. The gas limit of the transaction cannot be less than the minimum gas limit set by the node's transaction pool, otherwise the transaction will be rejected. Gasprice * gaslimit is actual ONG costs. (default: 20000)
RPC OPTIONS:
--rpcport value
Json rpc server listening port (default: 20336)
CONTRACT OPTIONS:
--needstore Is need use storage in contract
--code <path> File path of contract code <path>
--name <name> Specifies contract name to <name>
--version <ver> Specifies contract version to <ver>
--author <address> Set <address> as the contract owner
--email <email> Set <email> owner's email address
--desc <text> Set <text> as the description of the contract
--prepare, -p Prepare deploy contract without commit to ledger
-
배포 보기
-
SmartX에서 편집 후 NVM字节码
54c56b6c766b00527ac46c766b51527ac4616c766b00c36c766b52527ac46c766b52c30548656c6c6f87630600621a006c766b51c300c36165230061516c766b53527ac4620e00006c766b53527ac46203006c766b53c3616c756651c56b6c766b00527ac4616c766b00c361681253797374656d2e52756e74696d652e4c6f6761616c7566
-
将
MVN字节码保存到本地 -
利用
--code参数指定保存到本地的MVN바이트 코드경로
$ ./ontology contract deploy --name=Hello --code=/home/user/Desktop/Hello.avm --author=AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs --desc=example --email=hello@ontology.com --needstore --gaslimit=100000000
Password:
Deploy contract:
Contract Address:79102ef95cf75cab8e7f9a583c9d2b2b16fbce70
TxHash:ae76366e743be69b546a3552c30152024f1b5d539b74aa1f12e06bbff98e8bc8
Tip:
Using './ontology info status ae76366e743be69b546a3552c30152024f1b5d539b74aa1f12e06bbff98e8bc8' to query transaction status
- 트랜잭션 해시값으로 컨트랙트 배포 상태 확인
$ ./ontology info status ae76366e743be69b546a3552c30152024f1b5d539b74aa1f12e06bbff98e8bc8
Transaction states:
{
"TxHash": "ae76366e743be69b546a3552c30152024f1b5d539b74aa1f12e06bbff98e8bc8",
"State": 1,
"GasConsumed": 0,
"Notify": []
}
"State"이 1이라는 컨트랙트 배포 성공을 의미한다.
- 컨트랙트 상세 정보 확인
$ ./ontology info tx ae76366e743be69b546a3552c30152024f1b5d539b74aa1f12e06bbff98e8bc8
{
"Version": 0,
"Nonce": 1530326262,
"GasPrice": 0,
"GasLimit": 100000000,
"Payer": "AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs",
"TxType": 208,
"Payload": {
"Code": "54c56b6c766b00527ac46c766b51527ac4616c766b00c36c766b52527ac46c766b52c30548656c6c6f87630600621a006c766b51c300c36165230061516c766b53527ac4620e00006c766b53527ac46203006c766b53c3616c756651c56b6c766b00527ac4616c766b00c361681253797374656d2e52756e74696d652e4c6f6761616c7566",
"NeedStorage": true,
"Name": "Hello",
"CodeVersion": "",
"Author": "AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs",
"Email": "hello@ontology.com",
"Description": "example"
},
"Attributes": [],
"Sigs": [
{
"PubKeys": [
"032cf2191a24c6bee28abbee0c4b5265dc841394f2794c1fb18e52ffb2c9d7c9c6"
],
"M": 1,
"SigData": [
"98fbef0e3e2c4433b13fd255df7a96c473ad75d0ed202bc980ae987688324ac4d8728dc1f4d5c273fbac6a3bb84e1e1ed803fc01d9bfe981fb256704c39f2307"
]
}
],
"Hash": "ae76366e743be69b546a3552c30152024f1b5d539b74aa1f12e06bbff98e8bc8"
}
스마트 컨트랙트 실행
컨트랙트 주소로 실행
- 명령 개요
USAGE:
ontology contract invokeCode [command options]
ACCOUNT OPTIONS:
--wallet <filename>, -w <filename>
Use <filename> as the wallet (default: "./wallet.dat")
--account <address|label|index>, -a <address|label|index>
Using to specify the account <address|label|index> when the Ontology node starts.
If the account is null, it uses the wallet default account
TXPOOL OPTIONS:
--gasprice value
Using to specifies the gas price of transaction.
The gas price of the transaction cannot be less than the lowest gas price set by node's transaction pool, otherwise the transaction will be rejected.
When there are transactions that are queued for packing into the block in the transaction pool, the transaction pool will deal with transactions according to the gas price and transactions with high gas prices will be prioritized (default: 0)
--gaslimit value
Using to specifies the gas limit of the transaction.
The gas limit of the transaction cannot be less than the minimum gas limit set by the node's transaction pool, otherwise the transaction will be rejected. Gasprice * gaslimit is actual ONG costs. (default: 20000)
RPC OPTIONS:
--rpcport value
Json rpc server listening port (default: 20336)
CONTRACT OPTIONS:
--code <path>
File path of contract code <path>
--prepare, -p
Prepare invoke contract without commit to ledger
- 사전 스마트 컨트랙트 실행
ㅡ스마트 컨트랙트 사전 실행을 통해 현재의 계약 이행에 필요한 Gaslimit를 얻을 수 있으므로, Gaslimit설정을 위한 스마트 컨트랙트 실제 실행에 대한 참조를 제공하여 불충분한 ONG잔액으로 인해 실행 실패를 피할 수 있습니다.
$ ./ontology contract invoke --address 79102ef95cf75cab8e7f9a583c9d2b2b16fbce70 --params string:Hello,[string:Hello] --prepare --return bool
Invoke:70cefb162b2b9d3c589a7f8eab5cf75cf92e1079 Params:["Hello",["Hello"]]
Contract invoke successfully
Gaslimit:20000
Return:true
- 스마트 컨트랙트 진행
$ ./ontology contract invoke --address 79102ef95cf75cab8e7f9a583c9d2b2b16fbce70 --params string:Hello,[string:Hello] --gaslimit 20000
Invoke:70cefb162b2b9d3c589a7f8eab5cf75cf92e1079 Params:["Hello",["Hello"]]
Password:
TxHash:1d033ebeec3a833c0cc31ce9d78876d3464d60d8816be6d143582cb5d7409610
Tip:
Using './ontology info status 1d033ebeec3a833c0cc31ce9d78876d3464d60d8816be6d143582cb5d7409610' to query transaction status
- 컨트랙트 해시 값으로 트랜잭션 상황 확인
$ ./ontology info status 1d033ebeec3a833c0cc31ce9d78876d3464d60d8816be6d143582cb5d7409610
Transaction states:
{
"TxHash": "1d033ebeec3a833c0cc31ce9d78876d3464d60d8816be6d143582cb5d7409610",
"State": 1,
"GasConsumed": 0,
"Notify": []
}
바이트 코드로 실행
using Neo.SmartContract.Framework.Services.Neo;
using Neo.SmartContract.Framework;
using System;
using System.ComponentModel;
namespace Neo.SmartContract
{
public class HelloWorld : Framework.SmartContract
{
public static object Main()
{
string operation = "Hello";
Hello(operation);
return true;
}
public static void Hello(string msg)
{
Runtime.Log(msg);
}
}
}
- 사전 스마트 컨트랙트 실행
$ ./ontology contract invokeCode --code "/home/wdx7266/Desktop/Hello World.avm" --prepare
Contract pre-invoke successfully
Gas consumed:20000
Return:01 (raw value)
- 스마트 컨트랙트 배포
$ ./ontology contract deploy --name="Hello World" --code="/home/wdx7266/Desktop/Hello World.avm" --author=AKFMnJT1u5pyPhzGRuauD1KkyUvqjQsmGs --desc=example --email=hello@ontology.com --needstore --gaslimit=20000
Password:
Deploy contract:
Contract Address:72f52a2202b63891f92f9f5c756d9b7b63dd04aa
TxHash:cf1a628e74a190d9471cde8571e607348af43c17557759f9e109bd72b83a9d1e
Tip:
Using './ontology info status cf1a628e74a190d9471cde8571e607348af43c17557759f9e109bd72b83a9d1e' to query transaction status
- 컨트랙트 배포 상황 확인
$ ./ontology info status 23d8f080b4cca62c9966503c1696b6709f626fd89c5ee2106ec251e18c03abbb
Transaction states:
{
"TxHash": "23d8f080b4cca62c9966503c1696b6709f626fd89c5ee2106ec251e18c03abbb",
"State": 1,
"GasConsumed": 0,
"Notify": []
}
- 스마트 컨트랙트 실행
$ ./ontology contract invokeCode --code "/home/wdx7266/Desktop/Hello World.avm" --gaslimit 20000
Password:
TxHash:7a457e0a9856d8b9c3c69a5098820299a21d70f33acc3d08c8ec1c9790f20025
Tip:
Using './ontology info status 7a457e0a9856d8b9c3c69a5098820299a21d70f33acc3d08c8ec1c9790f20025' to query transaction status
- 컨트랙트 실행 상황 확인
$ ./ontology info status 7a457e0a9856d8b9c3c69a5098820299a21d70f33acc3d08c8ec1c9790f20025
Transaction states:
{
"TxHash": "7a457e0a9856d8b9c3c69a5098820299a21d70f33acc3d08c8ec1c9790f20025",
"State": 1,
"GasConsumed": 0,
"Notify": []
}
블록의 내보내기 및 가져오기
명령개요
USAGE:
ontology export [command options] [arguments...]
RPC OPTIONS:
--rpcport value
Json rpc server listening port (default: 20336)
EXPORT OPTIONS:
--file value
Path of export file (default: "./blocks.dat")
--height value
Using to specifies the height of the exported block.
When height of the local node's current block is greater than the height required for export, the greater part will not be exported.
Height is equal to 0, which means exporting all the blocks of the current node. (default: 0)
--speed <h|m|l>
Export block speed, <h|m|l> h for high speed, m for middle speed and l for low speed (default: "m")
블록 내보내기
$ ./ontology export
Start export.
Block(362/362) [====================================================================] 100% 1s
Export blocks successfully.
Total blocks:363
Export file:./blocks.dat
블록 가져오기
$ ./ontology import
[INFO ] GID 1, Config init success
[INFO ] GID 1, deploy contract address:0239dcf9b4a46f15c5f23f20d52fac916a0bac0d
[INFO ] GID 1, deploy contract address:08b6dcfed2aace9190a44ae34a320e42c04b46ac
[INFO ] GID 1, deploy contract address:7a2f84e3b94d20da1a8592116c0103c28c5e457e
[INFO ] GID 1, deploy contract address:6815cbe7b4dbad4d2d09ae035141b5254a002f79
[INFO ] GID 1, deploy contract address:24a15c6aed092dfaa711c4974caf1e9d307bf4b5
[INFO ] GID 1, deploy contract address:4d6934f0a524a084bb20cff4cdbea236760bb4a3
[INFO ] GID 1, GenesisBlock init success. GenesisBlock hash:b5380192526717ecc7bb8086d8754444f6e8e423fecf4ea1f39e55a779d7bef7
[INFO ] GID 1, Ledger init success
[INFO ] GID 1, getGasPriceLimitConfig: gasPrice 0, configure 0
[INFO ] GID 1, TxPool init success
[INFO ] GID 1, init peer ID to 4161297767523662910
……