Solidity API怎么使用

這篇文章主要講解了“Solidity API怎么使用”，文中的講解內容簡單清晰，易于學習與理解，下面請大家跟著小編的思路慢慢深入，一起來研究和學習“Solidity API怎么使用”吧！

區塊和交易的屬性（Block And Transaction Properties）

用來提供一些區塊鏈當前的信息。

• block.blockhash(uint blockNumber) returns (bytes32)：返回給定區塊號的哈希值，只支持最近256個區塊，且不包含當前區塊。

• block.coinbase (address): 當前塊礦工的地址。

• block.difficulty (uint):當前塊的難度。

• block.gaslimit (uint):當前塊的gaslimit。

• block.number (uint):當前區塊的塊號。

• block.timestamp (uint): 當前塊的Unix時間戳（從1970/1/1 00:00:00 UTC開始所經過的秒數）

• msg.data (bytes): 完整的調用數據（calldata）。

• msg.gas (uint): 當前還剩的gas。

• msg.sender (address): 當前調用發起人的地址。

• msg.sig (bytes4):調用數據(calldata)的前四個字節（例如為：函數標識符）。

• msg.value (uint): 這個消息所附帶的以太幣，單位為wei。

• now (uint): 當前塊的時間戳(block.timestamp的別名)

• tx.gasprice (uint) : 交易的gas價格。

• tx.origin (address): 交易的發送者（全調用鏈）

注意： msg的所有成員值，如msg.sender,msg.value的值可以因為每一次外部函數調用，或庫函數調用發生變化（因為msg就是和調用相關的全局變量）。

不應該依據 block.timestamp, now 和 block.blockhash來產生一個隨機數（除非你確實需要這樣做），這幾個值在一定程度上被礦工影響（比如在賭合約里，不誠實的礦工可能會重試去選擇一個對自己有利的hash）。

對于同一個鏈上連續的區塊來說，當前區塊的時間戳（timestamp）總是會大于上一個區塊的時間戳。

為了可擴展性的原因，你只能查最近256個塊，所有其它的將返回0.

錯誤處理

• assert(bool condition) 用于判斷內部錯誤，條件不滿足時拋出異常

• require(bool condition): 用于判斷輸入或外部組件錯誤，條件不滿足時拋出異常

• revert(): 終止執行并還原改變的狀態

數學及加密功能

• addmod(uint x, uint y, uint k) returns (uint): 計算(x + y) % k，加法支持任意的精度且不會在2**256處溢出，從0.5.0版本開始斷言k != 0。

• mulmod(uint x, uint y, uint k) returns (uint): 計算 (x * y) % k， 乘法支持任意的精度且不會在2**256處溢出， 從0.5.0版本開始斷言k != 0。

• keccak256(...) returns (bytes32): 使用以太坊的（Keccak-256）計算HASH值。緊密打包參數。

• sha256(...) returns (bytes32): 使用SHA-256計算hash值，緊密打包參數。

• sha3(...) returns (bytes32): keccak256的別名

• ripemd160(...) returns (bytes20): 使用RIPEMD-160計算HASH值。緊密打包參數。

• ecrecover(bytes32 hash, uint8 v, bytes32 r, bytes32 s) returns (address): 通過橢圓曲線簽名來恢復與公鑰關聯的地址，或者在錯誤時返回零。可用于簽名數據的校驗，如果返回結果是簽名者的公匙地址，那么說明數據是正確的。

ecrecover函數需要四個參數，需要被簽名數據的哈希結果值，r，s，v分別來自簽名結果串。 r = signature[0:64] s = signature[64:128] v = signature[128:130] 其中v取出來的值或者是00或01。要使用時，我們先要將其轉為整型，再加上27，所以我們將得到27或28。在調用函數時v將填入27或28。

用javascript表達如下:

    var msg = '0x8CbaC5e4d803bE2A3A5cd3DbE7174504c6DD0c1C'

    var hash = web3.sha3(msg)
    var sig = web3.eth.sign(address, h).slice(2)
    var r = `0x${sig.slice(0, 64)}`
    var s = `0x${sig.slice(64, 128)}`
    var v = web3.toDecimal(sig.slice(128, 130)) + 27

訂閱區塊鏈技術專欄可以參考到完整的使用例子。

<!-- [例子](https://ethereum.stackexchange.com/questions/1777/workflow-on-signing-a-string-with-private-key-followed-by-signature-verificatio)： -->

緊密打包參數（tightly packed）意思是說參數不會補位，是直接連接在一起的，下面幾個是相等的。

keccak256("ab", "c")
keccak256("abc")

keccak256(0x616263)  // hex
keccak256(6382179)
keccak256(97, 98, 99)   //ascii

如果需要填充，可以使用顯式類型轉換：keccak256("\x00\x12") 與keccak256(uint16(0x12))相同。

注意，常量將使用存儲它們所需的最少字節數來打包，例如keccak256(0) == keccak256(uint8(0))和keccak256(0x12345678) == keccak256(uint32(0x12345678))

在私鏈(private blockchain)上運行sha256,ripemd160或ecrecover可能會出現Out-Of-Gas報錯。因為私鏈實現了一種預編譯合約，合約要在收到第一個消息后才會真正存在（雖然他們的合約代碼是硬編碼的）。而向一個不存在的合約發送消息，所以才會導致Out-Of-Gas的問題。一種解決辦法（workaround）是每個在你真正使用它們之前先發送1 wei到這些合約上來完成初始化。在官方和測試鏈上沒有這個問題。

地址相關

• <address>.balance (uint256):

Address的余額，以wei為單位。

• <address>.transfer(uint256 amount):

發送給定數量的ether到某個地址，以wei為單位。失敗時拋出異常。

• <address>.send(uint256 amount) returns (bool):

發送給定數量的ether到某個地址，以wei為單位, 失敗時返回false。

• <address>.call(...) returns (bool):

發起底層的call調用。失敗時返回false。

• <address>.callcode(...) returns (bool):

發起底層的callcode調用，失敗時返回false。 不鼓勵使用，未來可能會移除。

• <address>.delegatecall(...) returns (bool):

發起底層的delegatecall調用，失敗時返回false

更多信息參考地址篇。

警告：send() 執行有一些風險：如果調用棧的深度超過1024或gas耗光，交易都會失敗。因此，為了保證安全，必須檢查send的返回值，如果交易失敗，會回退以太幣。如果用transfer會更好。

合約相關

• this（當前合約的類型）: 表示當前合約，可以顯式的轉換為Address

• selfdestruct(address recipient): 銷毀當前合約，并把它所有資金發送到給定的地址。

• suicide(address recipient): selfdestruct的別名

另外，當前合約里的所有函數均可支持調用，包括當前函數本身。

感謝各位的閱讀，以上就是“Solidity API怎么使用”的內容了，經過本文的學習后，相信大家對Solidity API怎么使用這一問題有了更深刻的體會，具體使用情況還需要大家實踐驗證。這里是億速云，小編將為大家推送更多相關知識點的文章，歡迎關注！