JSON-RPC API
Bir yazılım uygulamasının Ethereum blok zinciriyle etkileşimde bulunabilmesi - blok zincir verilerini okuma ya da ağa işlemler gönderme yoluyla - bir Ethereum düğümüne bağlanmasını gerektirmektedir.
Bu amaçla, her Ethereum müşterisi, belirli bir düğüm veya istemci uygulamasından bağımsız olarak uygulamaların güvendikleri bir yöntem seti olması için bir JSON-RPC özellikleri uygular.
JSON-RPC durumsuz, hafifliği özel bir uzaktan prosedür çağrısı (RPC) protokolüdür. Birkaç veri yapısını ve bunların işlenmesiyle ilgili kuralları tanımlar. Kavramların aynı süreç içinde, soketler üzerinden, HTTP üzerinden veya birçok farklı mesaj geçiş ortamında kullanılabilir olması açısından aktarımdan bağımsızdır. Veri formatı olarak JSON (RFC 4627) kullanır.
İstemci uygulamaları
Ethereum istemcilerinin her biri, JSON-RPC şartnamesini uygularken farklı programlama dilleri kullanabilir. Belirli programlama dilleriyle ilgili daha fazla ayrıntı için istemci belgelerine bakın. En güncel API destek bilgileri için her istemcinin belgelerini kontrol etmenizi öneririz.
Kolaylık Kütüphaneleri
JSON-RPC API aracılığıyla Ethereum istemcileriyle doğrudan etkileşim kurmayı seçebilseniz de, dapp geliştiricileri için genellikle daha kolay seçenekler vardır. JSON-RPC API'sinin üzerinde paketleyiciler sağlamak için birçok JavaScript ve arka uç API'si kütüphanesi bulunur. Bu kütüphanelerle geliştiriciler, Ethereum ile etkileşime giren JSON RPC taleplerini (arka planda) başlatmak için tercih ettikleri programlama dilinde sezgisel ve tek satırlı yöntemler yazabilirler.
Fikir birliği istemci API'ları
Bu sayfa, özellikle Ethereum yürütüm istemcileri tarafından kullanılan JSON-RPC API'sı ile ilgilidir. Ancak, fikir birliği istemcileri de kullanıcıların bir düğümden bilgi sorgulamasına, İşaret bloklarını, İşaret durumunu ve mutabakat ile ilgili diğer bilgileri direkt talep etmesine olanak veren bir RPC API'sına sahiptir. Bu API, Beacon API web sayfasında belgelenmiştir.
Bir düğüm içinde müşteri veya istemci arası iletişim için dahili bir API da kullanılır; - yani, bu fikir birliği istemcisinin ve yürütüm istemcisinin veri takas etmesini sağlar. Buna "Motor API'sı" denir ve özellikler GitHub'da mevcuttur.
Yürütüm istemcisi özellikleri
GitHub'da tam JSON-RPC API özelliklerini okuyun. Bu API, Yürütme API'si web sayfasında belgelenmiştir ve mevcut tüm yöntemleri denemek için bir Denetçi içerir.
Konvansiyonlar
Onaltılık değer kodlaması
JSON üzerinden iki temel veri türü geçirilir: biçimlendirilmemiş bayt dizileri ve miktarlar. Her ikisi de bir on altılı kodlamayla geçirilir, ancak biçimlendirme için farklı gereksinimler vardır.
Miktarlar
Miktarları (tamsayılar, sayılar) kodlarken: on altılı olarak kodlayın, önek "0x", en kompakt gösterim (küçük istisna: sıfır "0x0" olarak gösterilmelidir).
İşte bazı örnekler:
- 0x41 (ondalık olarak 65)
- 0x400 (ondalık olarak 1024)
- YANLIŞ: 0x (her zaman en az bir rakama sahip olmalıdır - sıfır "0x0" dır)
- YANLIŞ: 0x0400 (baştaki sıfırlara izin verilmez)
- YANLIŞ: ff (0x ön eki olmalıdır)
Formatlanmamış bilgi
Biçimlendirilmemiş verileri kodlarken (bayt dizileri, hesap adresleri, karmalar, bayt kodu dizileri): ön ek "0x" ile, bayt başına iki on altılık basamak ve on altılı olarak kodlayın.
İşte bazı örnekler:
- 0x41 (size 1, "A")
- 0x004200 (boyut 3, "0B0")
- 0x (size 0, "")
- YANLIŞ: 0xf0f0f (hane sayısı çift olmalıdır)
- YANLIŞ: 004200 (0x ön eki olmalıdır)
Varsayılan blok parametresi
Aşağıdaki yöntemlerde fazladan bir varsayılan blok parametresi bulunur:
Ethereum durumuna göre hareket eden istekler yapıldığında, son varsayılan blok parametresi blokun yüksekliğini belirler.
DefaultBlock parametresi için aşağıdaki seçenekler mümkündür:
HEX String- bir tamsayı blok numarasıString "earliest"en erken/genesis bloğu içinString "latest"- önerilen son blok için"Güvenli" dizesi- en son güvenli baş blok için"Kesinleşmiş" dizesi- kesinleşmiş en son blok için"Bekleyen" dizesi- bekleyen durum/işlemler için
Örnekler
Bu sayfada, komut satırı aracı curl kullanılarak ayrı ayrı JSON_RPC API uç noktalarının nasıl kullanılacağına ilişkin örnekler sunuyoruz. Bu ayrı uç nokta örnekleri, aşağıda Kıvrılma örnekleri bölümünde bulunur. Sayfanın ilerleyen kısımlarında, Geth düğümü, JSON_RPC API ve kıvrılma kullanarak akıllı bir sözleşme derlemek ve dağıtmak için uçtan uca bir örnek de sağlıyoruz.
Kıvrılma örnekleri
Bir Ethereum düğümüne curl istekleri yaparak JSON_RPC API'sını kullanma örnekleri aşağıda verilmiştir. Her örnek belirli uç noktanın bir tanımını, parametrelerini, dönüş türünü ve nasıl kullanılması gerektiğine dair çalışılmış bir örneği içerir.
Kıvrılma istekleri, içerik türüyle ilgili bir hata mesajı döndürebilir. Bunun nedeni, --data seçeneğinin içerik türünü application/x-www-form-urlencoded olarak ayarlamasıdır. Düğümünüz bundan şikâyet ederse, aramanın başına -H "Content-Type: application/json" koyarak başlığı manuel olarak ayarlayın. Örnekler ayrıca kıvrılma için verilen son argüman olması gereken URL/IP ve bağlantı noktası kombinasyonunu içermez. (ör. 127.0.0.1:8545). Bu ek verileri içeren eksiksiz bir kıvrılma isteği aşağıdaki formu alır:
1curl -H "Content-Type: application/json" -X POST --data '{"jsonrpc":"2.0","method":"web3_clientVersion","params":[],"id":67}' 127.0.0.1:8545
Dedikodu, Durum, Geçiş
Bir avuç temel JSON-RPC yöntemi, Ethereum ağından veri gerektirir ve düzgün bir şekilde üç ana kategoriye ayrılır: Dedikodu, Durum ve Geçmiş. Her bir yönteme atlamak için bu bölümlerdeki bağlantıları kullanın veya tüm yöntemler listesini keşfetmek için içindekiler tablosunu kullanın.
Dedikodu Yöntemleri
Bu yöntemler zincirin başını izler. Bu, işlemlerin ağ etrafında nasıl dolaştığını, blokların içinde nasıl yer bulduğunu ve istemcilerin yeni bloklar hakkında nasıl bilgi sahibi olduğunu gösterir.
Durum Yöntemleri
Depolanan tüm verinin mevcut durumunu raporlayan yöntemlerdir. "Durum" RAM'nin paylaşımlı, büyük tek bir parçası gibidir ve hesap bakiyelerini, sözleşme verilerini ve gaz tahminlerini içerir.
Geçmiş Yöntemleri
Başlangıça kadar her blokun geçmiş kayıtlarını alır. Bu tek büyük sadece ekleme yapılabilen bir dosya gibidir ve tüm blok başlıklarını, blok gövdelerini, amca bloklarını ve işlem makbuzlarını içerir.
- eth_getBlockTransactionCountByHash
- eth_getBlockTransactionCountByNumber
- eth_getUncleCountByBlockHash
- eth_getUncleCountByBlockNumber
- eth_getBlockByHash
- eth_getBlockByNumber
- eth_getTransactionByHash
- eth_getTransactionByBlockHashAndIndex
- eth_getTransactionByBlockNumberAndIndex
- eth_getTransactionReceipt
- eth_getUncleByBlockHashAndIndex
- eth_getUncleByBlockNumberAndIndex
JSON-RPC API Deneme Alanı
API yöntemlerini denemek ve yeni yöntemler keşfetmek için deneme alanı aracını kullanabilirsiniz. Ayrıca, çeşitli düğüm sağlayıcıları tarafından hangi yöntemlerin ve ağların desteklendiğini de gösterir.
JSON-RPC API Yöntemleri
web3_clientVersion
Geçerli istemci sürümünü döndürür.
Parametreler
Hiçbiri
Dönüşler
String - Geçerli istemci sürümü
Örnek
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"web3_clientVersion","params":[],"id":67}'3// Result4{5 "id":67,6 "jsonrpc":"2.0",7 "result": "Geth/v1.12.1-stable/linux-amd64/go1.19.1"8}Kopyala
web3_sha3
Verilen verilerin Keccak-256'sını (standartlaştırılmış SHA3-256 olmayan) döndürür.
Parametreler
DATA- SHA3 karmasına dönüştürülecek veriler
1params: ["0x68656c6c6f20776f726c64"]Kopyala
Dönüşler
DATA - Verilen dizenin SHA3 sonucu.
Örnek
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"web3_sha3","params":["0x68656c6c6f20776f726c64"],"id":64}'3// Result4{5 "id":64,6 "jsonrpc": "2.0",7 "result": "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad"8}Kopyala
net_version
Geçerli ağ kimliğini döndürür.
Parametreler
Hiçbiri
Dönüşler
String - Geçerli ağ kimliği.
Mevcut ağ kimliklerinin tam listesi chainlist.org adresinde bulunabilir. Bazı yaygın olanları:
1: Ethereum Ana Ağı11155111: Sepolia test ağı17000: Hoodi test ağı
Örnek
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"net_version","params":[],"id":67}'3// Result4{5 "id":67,6 "jsonrpc": "2.0",7 "result": "3"8}Kopyala
net_listening
İstemci aktif olarak ağ bağlantılarını dinliyorsa true değerini döndürür.
Parametreler
Hiçbiri
Dönüşler
Boolean - Dinlerken true, aksi takdirde false.
Örnek
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"net_listening","params":[],"id":67}'3// Result4{5 "id":67,6 "jsonrpc":"2.0",7 "result":true8}Kopyala
net_peerCount
Şu anda istemciye bağlı olan eşlerin sayısını döndürür.
Parametreler
Hiçbiri
Dönüşler
QUANTITY - bağlı eşlerin sayısının tam sayısı.
Örnek
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"net_peerCount","params":[],"id":74}'3// Result4{5 "id":74,6 "jsonrpc": "2.0",7 "result": "0x2" // 28}Kopyala
eth_protocolVersion
Geçerli Ethereum protokol sürümünü döndürür. Bu yöntemin Geth'de mevcut olmadığını aklınızda tutun.
Parametreler
Hiçbiri
Dönüşler
String - Geçerli Ethereum protokolü sürümü
Örnek
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_protocolVersion","params":[],"id":67}'3// Result4{5 "id":67,6 "jsonrpc": "2.0",7 "result": "54"8}Kopyala
eth_syncing
Senkronizasyon durumu veya false ile ilgili verileri içeren bir nesne döndürür.
Parametreler
Hiçbiri
Dönüşler
Kesin dönüş verileri, istemci uygulamaları arasında farklılık gösterir. Tüm istemciler düğüm eşitlenmediğinde False değerini döndürür aynı zamanda da tüm istemciler aşağıdaki alanları döndürür.
Nesne|Boolean, Senkronizasyon durumu verisi olan veya senkronize edilmediğinde FALSE olan bir nesne:
startingBlock:QUANTITY- İçe aktarmanın başladığı blok (yalnızca senkronizasyon kafasına ulaştıktan sonra sıfırlanır)currentBlock:QUANTITY- Geçerli blok, eth_blockNumber ile aynıhighestBlock:QUANTITY- Tahmini en yüksek blok
Ancak, bireysel istemciler ek veriler de sağlayabilir. Örneğin Geth aşağıdakileri döndürür:
1{2 "jsonrpc": "2.0",3 "id": 1,4 "result": {5 "currentBlock": "0x3cf522",6 "healedBytecodeBytes": "0x0",7 "healedBytecodes": "0x0",8 "healedTrienodes": "0x0",9 "healingBytecode": "0x0",10 "healingTrienodes": "0x0",11 "highestBlock": "0x3e0e41",12 "startingBlock": "0x3cbed5",13 "syncedAccountBytes": "0x0",14 "syncedAccounts": "0x0",15 "syncedBytecodeBytes": "0x0",16 "syncedBytecodes": "0x0",17 "syncedStorage": "0x0",18 "syncedStorageBytes": "0x0"19 }20}Tümünü gösterKopyala
Oysa Besu bunları döndürür:
1{2 "jsonrpc": "2.0",3 "id": 51,4 "result": {5 "startingBlock": "0x0",6 "currentBlock": "0x1518",7 "highestBlock": "0x9567a3",8 "pulledStates": "0x203ca",9 "knownStates": "0x200636"10 }11}Tümünü gösterKopyala
Daha fazla ayrıntı için bakmak istediğiniz spesifik istemcinin dokümanlarına göz atın.
Örnek
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_syncing","params":[],"id":1}'3// Result4{5 "id":1,6 "jsonrpc": "2.0",7 "result": {8 startingBlock: '0x384',9 currentBlock: '0x386',10 highestBlock: '0x454'11 }12}13// Or when not syncing14{15 "id":1,16 "jsonrpc": "2.0",17 "result": false18}Tümünü gösterKopyala
eth_coinbase
İstemci para tabanı adresini döndürür.
Parametreler
Hiçbiri
Dönüşler
DATA, 20 bayt - mevcut para tabanı adresi.
Örnek
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_coinbase","params":[],"id":64}'3// Result4{5 "id":64,6 "jsonrpc": "2.0",7 "result": "0x407d73d8a49eeb85d32cf465507dd71d507100c1"8}Kopyala
eth_chainId
Tekrardan korumalı işlemleri imzalamak için kullanılan zincir kimliğini döndürür.
Parametreler
Hiçbiri
Dönüşler
chainId, mevcut zincir kimliğinin sayısal değerini temsil eden metin olarak on altılı değer.
Örnek
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":67}'3// Result4{5 "id":67,6 "jsonrpc": "2.0",7 "result": "0x1"8}Kopyala
eth_mining
İstemci aktif olarak yeni bloklar basıyorsa true değerini döndürür. Bu, yalnızca iş ispatı kullanan ağlar için true değerini döndürebilir ancak Birleşim gerçekleştiğinden beri bazı istemcilerde kullanılamıyor olabilir.
Parametreler
Hiçbiri
Dönüşler
Boolean - istemcinin madencilik yaptığı true değerini, aksi takdirde false değerini döndürür.
Örnek
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_mining","params":[],"id":71}'3//4{5 "id":71,6 "jsonrpc": "2.0",7 "result": true8}Kopyala
eth_hashrate
Düğümün madencilik yaptığı saniye başına karma sayısını döndürür. Bu, yalnızca iş ispatı kullanan ağlar için true değerini döndürebilir ancak Birleşim gerçekleştiğinden beri bazı istemcilerde kullanılamıyor olabilir.
Parametreler
Hiçbiri
Dönüşler
QUANTITY - saniyedeki karma sayısı.
Örnek
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_hashrate","params":[],"id":71}'3// Result4{5 "id":71,6 "jsonrpc": "2.0",7 "result": "0x38a"8}Kopyala
eth_gasPrice
Wei cinsinden gaz başına mevcut fiyatın bir tahminini döndürür. Örneğin, Besu istemcisi son 100 bloğu inceler ve varsayılan medyan gaz birim fiyatını döndürür.
Parametreler
Hiçbiri
Dönüşler
QUANTITY - wei cinsinden mevcut gaz fiyatının tam sayısıdır.
Örnek
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_gasPrice","params":[],"id":73}'3// Result4{5 "id":73,6 "jsonrpc": "2.0",7 "result": "0x1dfd14000" // 8049999872 Wei8}Kopyala
eth_accounts
İstemcinin sahip olduğu adreslerin listesini döndürür.
Parametreler
Hiçbiri
Dönüşler
Array of DATA, 20 Bayt, istemciye ait adresler.
Örnek
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_accounts","params":[],"id":1}'3// Result4{5 "id":1,6 "jsonrpc": "2.0",7 "result": ["0x407d73d8a49eeb85d32cf465507dd71d507100c1"]8}Kopyala
eth_blockNumber
En son bloğun numarasını döndürür.
Parametreler
Hiçbiri
Dönüşler
QUANTITY - istemcinin açık olduğu mevcut blok numarasının tam sayısıdır.
Örnek
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":83}'3// Result4{5 "id":83,6 "jsonrpc": "2.0",7 "result": "0x4b7" // 12078}Kopyala
eth_getBalance
Verilen adresin hesabının bakiyesini döndürür.
Parametreler
DATA, 20 Bayt - bakiye için bakılması gereken adres.QUANTITY|TAG- tamsayı blok numarası veya"latest","earliest","pending","safe"veya"finalized"dizesi, default block parameter kısmına göz atabilirsiniz
1params: ["0x407d73d8a49eeb85d32cf465507dd71d507100c1", "latest"]Kopyala
Dönüşler
QUANTITY - mevcut bakiyenin wei cinsinden tam sayısıdır.
Örnek
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBalance","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1", "latest"],"id":1}'3// Result4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0x0234c8a3397aab58" // 1589724902343750008}Kopyala
eth_getStorageAt
Belirli bir adresteki bir depolama konumundan değeri döndürür.
Parametreler
DATA, 20 Bayt - depolamanın adresi.QUANTITY- depolamadaki pozisyonun sayısı.QUANTITY|TAG- tamsayı blok numarası veya"latest","earliest","pending","safe"veya"finalized"dizesi, default block parameter kısmına göz atabilirsiniz
Dönüşler
DATA - bu depolama konumundaki değerdir.
Örnek Doğru konumun hesaplanması, alınacak depolamaya bağlıdır. 0x295a70b2de5e3953354a6a8344e616ed314d7251, 0x391694e7e0b0cce554cb130d723a9d27458f9298 adresinde dağıtılan aşağıdaki sözleşmeyi dikkate alın.
1contract Storage {2 uint pos0;3 mapping(address => uint) pos1;4 function Storage() {5 pos0 = 1234;6 pos1[msg.sender] = 5678;7 }8}
Pos0 değerini almak basittir:
1curl -X POST --data '{"jsonrpc":"2.0", "method": "eth_getStorageAt", "params": ["0x295a70b2de5e3953354a6a8344e616ed314d7251", "0x0", "latest"], "id": 1}' localhost:85452{"jsonrpc":"2.0","id":1,"result":"0x00000000000000000000000000000000000000000000000000000000000004d2"}Kopyala
Haritanın bir öğesini almak daha zordur. Bir elemanın haritadaki konumu şu şekilde hesaplanır:
1keccak(LeftPad32(key, 0), LeftPad32(map position, 0))Kopyala
Bu, pos1["0x391694e7e0b0cce554cb130d723a9d27458f9298"] üzerindeki depolamayı almak için konumu şu şekilde hesaplamamız gerektiği anlamına gelir:
1keccak(2 decodeHex(3 "000000000000000000000000391694e7e0b0cce554cb130d723a9d27458f9298" +4 "0000000000000000000000000000000000000000000000000000000000000001"5 )6)Kopyala
Web3 kütüphanesi ile birlikte gelen geth konsolu, hesaplama yapmak için kullanılabilir:
1> var key = "000000000000000000000000391694e7e0b0cce554cb130d723a9d27458f9298" + "0000000000000000000000000000000000000000000000000000000000000001"2undefined3> web3.sha3(key, {"encoding": "hex"})4"0x6661e9d6d8b923d5bbaab1b96e1dd51ff6ea2a93520fdc9eb75d059238b8c5e9"Kopyala
Şimdi depolamayı almak için:
1curl -X POST --data '{"jsonrpc":"2.0", "method": "eth_getStorageAt", "params": ["0x295a70b2de5e3953354a6a8344e616ed314d7251", "0x6661e9d6d8b923d5bbaab1b96e1dd51ff6ea2a93520fdc9eb75d059238b8c5e9", "latest"], "id": 1}' localhost:85452{"jsonrpc":"2.0","id":1,"result":"0x000000000000000000000000000000000000000000000000000000000000162e"}Kopyala
eth_getTransactionCount
Bir adresten gönderilen işlem sayısını döndürür.
Parametreler
DATA, 20 Bayt - adres.QUANTITY|TAG- tamsayı blok numarası veya"latest",earliest","pending","safe"veya"finalized"dizesi, default block parameter kısmına göz atabilirsiniz
1params: [2 "0x407d73d8a49eeb85d32cf465507dd71d507100c1",3 "latest", // state at the latest block4]Kopyala
Dönüşler
QUANTITY - bu adresten gönderilen işlem sayısının tamsayısıdır.
Örnek
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionCount","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1","latest"],"id":1}'3// Result4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0x1" // 18}Kopyala
eth_getBlockTransactionCountByHash
Verilen blok karması ile eşleşen bir bloktaki işlem sayısını döndürür.
Parametreler
DATA, 32 Bayt - bir blokun karması
1params: ["0xd03ededb7415d22ae8bac30f96b2d1de83119632693b963642318d87d1bece5b"]Kopyala
Dönüşler
QUANTITY - bu bloktaki işlem sayısının tamsayısıdır.
Örnek
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockTransactionCountByHash","params":["0xd03ededb7415d22ae8bac30f96b2d1de83119632693b963642318d87d1bece5b"],"id":1}'3// Result4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0x8b" // 1398}Kopyala
eth_getBlockTransactionCountByNumber
Verilen blok numarasıyla eşleşen bloktaki işlem sayısını döndürür.
Parametreler
QUANTITY|TAG- tamsayı blok numarası veya"latest",earliest","pending","safe"veya"finalized"dizesi, default block parameter kısmına göz atabilirsiniz.
1params: [2 "0x13738ca", // 203962343]Kopyala
Dönüşler
QUANTITY - bu bloktaki işlem sayısının tamsayısıdır.
Örnek
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockTransactionCountByNumber","params":["0x13738ca"],"id":1}'3// Result4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0x8b" // 1398}Kopyala
eth_getUncleCountByBlockHash
Verilen blok karması ile eşleşen bir bloktaki amcaların sayısını döndürür.
Parametreler
VERİ, 32 Bayt - bir bloğun karması
1params: ["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2"]Kopyala
Dönüşler
QUANTITY - bu bloktaki amcaların sayısının tamsayısıdır.
Örnek
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleCountByBlockHash","params":["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2"],"id":1}'3// Result4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0x1" // 18}Kopyala
eth_getUncleCountByBlockNumber
Verilen blok numarası ile eşleşen bir bloktan olan bir bloktaki amcaların sayısını döndürür.
Parametreler
QUANTITY|TAG- tamsayı blok numarası veya"latest",earliest","pending","safe"veya"finalized"dizesi, default block parameter kısmına göz atabilirsiniz
1params: [2 "0xe8", // 2323]Kopyala
Dönüşler
QUANTITY - bu bloktaki amcaların sayısının tamsayısıdır.
Örnek
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleCountByBlockNumber","params":["0xe8"],"id":1}'3// Result4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0x0" // 08}Kopyala
eth_getCode
Belirli bir adreste kod döndürür.
Parametreler
DATA, 20 Bayt - adresQUANTITY|TAG- tamsayı blok numarası veya"latest",earliest","pending","safe"veya"finalized"dizesi, default block parameter kısmına göz atabilirsiniz
1params: [2 "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",3 "0x5daf3b", // 61397074]Kopyala
Dönüşler
DATA - verilen adresten gelen kod.
Örnek
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getCode","params":["0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "0x5daf3b"],"id":1}'3// Result4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0x6060604052600436106100af576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff16806306fdde03146100b9578063095ea7b31461014757806318160ddd146101a157806323b872dd146101ca5780632e1a7d4d14610243578063313ce5671461026657806370a082311461029557806395d89b41146102e2578063a9059cbb14610370578063d0e30db0146103ca578063dd62ed3e146103d4575b6100b7610440565b005b34156100c457600080fd5b6100cc6104dd565b6040518080602001828103825283818151815260200191508051906020019080838360005b8381101561010c5780820151818401526020810190506100f1565b50505050905090810190601f1680156101395780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b341561015257600080fd5b610187600480803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803590602001909190505061057b565b604051808215151515815260200191505060405180910390f35b34156101ac57600080fd5b6101b461066d565b6040518082815260200191505060405180910390f35b34156101d557600080fd5b610229600480803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803590602001909190505061068c565b604051808215151515815260200191505060405180910390f35b341561024e57600080fd5b61026460048080359060200190919050506109d9565b005b341561027157600080fd5b610279610b05565b604051808260ff1660ff16815260200191505060405180910390f35b34156102a057600080fd5b6102cc600480803573ffffffffffffffffffffffffffffffffffffffff16906020019091905050610b18565b6040518082815260200191505060405180910390f35b34156102ed57600080fd5b6102f5610b30565b6040518080602001828103825283818151815260200191508051906020019080838360005b8381101561033557808201518184015260208101905061031a565b50505050905090810190601f1680156103625780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b341561037b57600080fd5b6103b0600480803573ffffffffffffffffffffffffffffffffffffffff16906020019091908035906020019091905050610bce565b604051808215151515815260200191505060405180910390f35b6103d2610440565b005b34156103df57600080fd5b61042a600480803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803573ffffffffffffffffffffffffffffffffffffffff16906020019091905050610be3565b6040518082815260200191505060405180910390f35b34600360003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825401925050819055503373ffffffffffffffffffffffffffffffffffffffff167fe1fffcc4923d04b559f4d29a8bfc6cda04eb5b0d3c460751c2402c5c5cc9109c346040518082815260200191505060405180910390a2565b60008054600181600116156101000203166002900480601f0160208091040260200160405190810160405280929190818152602001828054600181600116156101000203166002900480156105735780601f1061054857610100808354040283529160200191610573565b820191906000526020600020905b81548152906001019060200180831161055657829003601f168201915b505050505081565b600081600460003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060008573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020819055508273ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925846040518082815260200191505060405180910390a36001905092915050565b60003073ffffffffffffffffffffffffffffffffffffffff1631905090565b600081600360008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002054101515156106dc57600080fd5b3373ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff16141580156107b457507fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff600460008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000205414155b156108cf5781600460008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020541015151561084457600080fd5b81600460008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825403925050819055505b81600360008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000206000828254039250508190555081600360008573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825401925050819055508273ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef846040518082815260200191505060405180910390a3600190509392505050565b80600360003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000205410151515610a2757600080fd5b80600360003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825403925050819055503373ffffffffffffffffffffffffffffffffffffffff166108fc829081150290604051600060405180830381858888f193505050501515610ab457600080fd5b3373ffffffffffffffffffffffffffffffffffffffff167f7fcf532c15f0a6db0bd6d0e038bea71d30d808c7d98cb3bf7268a95bf5081b65826040518082815260200191505060405180910390a250565b600260009054906101000a900460ff1681565b60036020528060005260406000206000915090505481565b60018054600181600116156101000203166002900480601f016020809104026020016040519081016040528092919081815260200182805460018160011615610100020316600290048015610bc65780601f10610b9b57610100808354040283529160200191610bc6565b820191906000526020600020905b815481529060010190602001808311610ba957829003601f168201915b505050505081565b6000610bdb33848461068c565b905092915050565b60046020528160005260406000206020528060005260406000206000915091505054815600a165627a7a72305820deb4c2ccab3c2fdca32ab3f46728389c2fe2c165d5fafa07661e4e004f6c344a0029"8}Kopyala
eth_sign
İmza yöntemi, Ethereum'a özel bir imzayı şu şekilde hesaplar: sign(keccak256("\x19Ethereum Signed Message:\n" + len(message) + message))).
Mesaja bir önek ekleyerek hesaplanan imzanın Ethereum'a özel bir imza olarak tanınmasını sağlar. Bu, kötü niyetli bir merkeziyetsiz uygulamanın keyfi verileri imzalayabildiği (ör. işlem) ve imzayı kurbanın kimliğine bürünmek için kullandığı durumlarda kötüye kullanımı önler.
Not: İmzalanacak adresin kilidi açık olmalıdır.
Parametreler
VERİ, 20 Bayt - adresDATA, N Bayt - imzalanacak mesaj
Dönüşler
DATA: İmza
Örnek
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sign","params":["0x9b2055d370f73ec7d8a03e965129118dc8f5bf83", "0xdeadbeaf"],"id":1}'3// Result4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0xa3f20717a250c2b0b729b7e5becbff67fdaef7e0699da4de7ca5895b02a170a12d887fd3b17bfdce3481f10bea41f45ba9f709d39ce8325427b57afcfc994cee1b"8}Kopyala
eth_signTransaction
eth_sendRawTransaction ile kullanılarak daha sonra ağa gönderilebilecek bir işlemi imzalar.
Parametreler
Object- İşlem nesnesi
type:from:DATA, 20 Bayt - İşlemin gönderildiği adres.to:DATA, 20 Bayt - (yeni sözleşme oluştururken isteğe bağlı) İşlemin yönlendirildiği adres.gas:QUANTITY- (isteğe bağlı, varsayılan: 90000) İşlemin yürütülmesi için sağlanan gazın tam sayısı. Kullanılmayan gazı geri verecektir.gasPrice:QUANTITY- (isteğe bağlı, varsayılan: Belirlenecek) Wei'de her ücretli gaz için kullanılan gasPrice'ın tamsayısıdır.value:QUANTITY- (isteğe bağlı) Wei cinsinden bu işlemle gönderilen değerin tamsayısıdır.data:DATA- Bir sözleşmenin derlenmiş kodu VEYA çağrılan yöntem imzasının ve kodlanmış parametrelerin karması.nonce:QUANTITY- (isteğe bağlı) nonce tam sayısı. Bu, aynı nonce'yi kullanan kendi bekleyen işlemlerinizin üzerine yazmanıza izin verir.
Dönüşler
DATA, Belirtilen hesap tarafından imzalanan RLP kodlu işlem nesnesidir.
Örnek
1// Request2curl -X POST --data '{"id": 1,"jsonrpc": "2.0","method": "eth_signTransaction","params": [{"data":"0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675","from": "0xb60e8dd61c5d32be8058bb8eb970870f07233155","gas": "0x76c0","gasPrice": "0x9184e72a000","to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567","value": "0x9184e72a"}]}'3// Result4{5 "id": 1,6 "jsonrpc": "2.0",7 "result": "0xa3f20717a250c2b0b729b7e5becbff67fdaef7e0699da4de7ca5895b02a170a12d887fd3b17bfdce3481f10bea41f45ba9f709d39ce8325427b57afcfc994cee1b"8}Kopyala
eth_sendTransaction
Veri alanı kod içeriyorsa, yeni bir mesaj çağrı işlemi veya sözleşme oluşturma işlemi oluşturur ve from alanında belirtilen hesabı kullanarak imzalar.
Parametreler
Object- İşlem nesnesi
from:DATA, 20 Bayt - İşlemin gönderildiği adres.to:DATA, 20 Bayt - (yeni sözleşme oluştururken isteğe bağlı) İşlemin yönlendirildiği adres.gas:QUANTITY- (isteğe bağlı, varsayılan: 90000) İşlemin yürütülmesi için sağlanan gazın tam sayısı. Kullanılmayan gazı geri verecektir.gasPrice:QUANTITY- (isteğe bağlı, varsayılan: Belirlenecek) Ücretli her gaz için kullanılan gasPrice'ın tam sayısı.değer:QUANTITY- (isteğe bağlı) Bu işlemle gönderilen değerin tam sayısı.input:DATA- Bir sözleşmenin derlenmiş kodu VEYA çağrılan yöntem imzasının ve kodlanmış parametrelerin karmasıdır.nonce:QUANTITY- (isteğe bağlı) nonce tam sayısı. Bu, aynı nonce'yi kullanan kendi bekleyen işlemlerinizin üzerine yazmanıza izin verir.
1params: [2 {3 from: "0xb60e8dd61c5d32be8058bb8eb970870f07233155",4 to: "0xd46e8dd67c5d32be8058bb8eb970870f07244567",5 gas: "0x76c0", // 304006 gasPrice: "0x9184e72a000", // 100000000000007 value: "0x9184e72a", // 24414062508 input:9 "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675",10 },11]Tümünü gösterKopyala
Dönüşler
DATA, 32 Bayt - işlem karması veya işlem henüz mevcut değilse sıfır karma.
Bir sözleşme oluşturduğunuzda, işlem bir blokta önerildikten sonra sözleşme adresini almak için eth_getTransactionReceipt öğesini kullanın.
Örnek
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sendTransaction","params":[{see above}],"id":1}'3// Result4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"8}Kopyala
eth_sendRawTransaction
İmzalı işlemler için yeni mesaj arama işlemi veya sözleşme oluşturma gerçekleşir.
Parametreler
DATA, İmzalanmış işlem verisi.
1params: [2 "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675",3]Kopyala
Dönüşler
DATA, 32 Bayt - işlem karması veya işlem henüz mevcut değilse sıfır karma.
Bir sözleşme oluşturduğunuzda, işlem bir blokta önerildikten sonra sözleşme adresini almak için eth_getTransactionReceipt öğesini kullanın.
Örnek
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sendRawTransaction","params":[{see above}],"id":1}'3// Result4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"8}Kopyala
eth_call
Blokzincirde bir işlem oluşturmadan hemen yeni bir mesaj çağrısı yürütür. Genellikle yalnızca okuma işlemi yapan akıllı sözleşme fonksiyonlarını çalıştırmak için kullanılır, örneğin bir ERC-20 sözleşmesi için balanceOf fonksiyonu.
Parametreler
Object- İşlem çağrısı nesnesi
from:DATA, 20 Bayt - (isteğe bağlı) İşlemin gönderildiği adres.to:DATA, 20 Bayt - İşlemin yönlendirildiği adres.gas:QUANTITY- (isteğe bağlı) İşlemin yürütülmesi için sağlanan gazın tam sayısı. eth_call sıfır gaz tüketir, ancak bazı uygulamalarda bu parametreye ihtiyaç duyulabilir.gasPrice:QUANTITY- (isteğe bağlı) Ücretli her gaz için kullanılan gasPrice'ın tam sayısıdeğer:QUANTITY- (isteğe bağlı) Bu işlemle gönderilen değerin tam sayısıinput:DATA- (isteğe bağlı) Yöntem imzasının ve kodlanmış parametrelerin karmasıdır. Ayrıntılar için Solidity dokümanlarındaki Ethereum Sözleşmesi ABI'sine bakın.
QUANTITY|TAG- tamsayı blok numarası veya"latest",earliest","pending","safe"veya"finalized"dizesi, default block parameter kısmına göz atabilirsiniz
Dönüşler
DATA - yürütülen sözleşmenin dönüş değeridir.
Örnek
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_call","params":[{see above}],"id":1}'3// Result4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0x"8}Kopyala
eth_estimateGas
İşlemin tamamlanmasına izin vermek için ne kadar gazın gerekli olduğuna dair bir tahmin oluşturur ve döndürür. İşlem, blokzincire eklenmez. Tahminin, ESM mekaniği ve düğüm performansı dahil olmak üzere çeşitli nedenlerle işlem tarafından fiilen kullanılan gaz miktarından önemli ölçüde daha fazla olabileceğini unutmayın.
Parametreler
eth_call parametrelerine bakın, tüm seçeneklerin isteğe bağlı olması hariç. Gaz limiti belirtilmemişse geth, bekleyen bloktan gelen blok gaz limitini üst sınır olarak kullanır. Sonuç olarak, gaz miktarı bekleyen blok gaz limitinden daha yüksek olduğunda, döndürülen tahmin çağrıyı/işlemi gerçekleştirmek için yeterli olmayabilir.
Dönüşler
QUANTITY - kullanılan gaz miktarıdır.
Örnek
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_estimateGas","params":[{see above}],"id":1}'3// Result4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0x5208" // 210008}Kopyala
eth_getBlockByHash
Karma ile bir blok hakkında bilgi döndürür.
Parametreler
DATA, 32 Bayt - bir blokun şifresi.Boolean-trueise tam işlem nesnelerini döndürür,falseise yalnızca işlemlerin karmalarını döndürür.
1params: [2 "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae",3 false,4]Kopyala
Dönüşler
Object - Bir blok nesnesi veya blok bulunamadığında null:
number:QUANTITY- blok numarası.nullBekleyen blok olduğunda.hash:DATA, 32 Bayt - blokun özeti.nullBekleyen blok olduğunda.parentHash:DATA, 32 Bayt - ana blokun karması.nonce:DATA, 8 Bayt - oluşturulan iş ispatının karması.nullBekleyen blok olduğunda.sha3Uncles:DATA, 32 Bayt - bloktaki amca verilerinin SHA3'ü.logsBloom:DATA, 256 Bayt - blokun günlükleri için çiçek filtresi.nullBekleyen blok olduğunda.transactionsRoot:DATA, 32 Bayt - blokun işlem denemesinin kökü.stateRoot:DATA, 32 Bayt - blokun son durum denemesinin kökü.receiptsRoot:DATA, 32 Bayt - blokun makbuz denemesinin kökü.madenci:DATA, 20 Bayt - madencilik ödüllerinin verildiği yararlanıcının adresi.difficulty:QUANTITY- bu blok için zorluğun tam sayısı.totalDifficulty:QUANTITY- bu bloka kadar zincirin toplam zorluğunun tam sayısı.extraData:DATA- bu blokun "ekstra veri" alanı.size:QUANTITY- bu blokun bayt cinsinden boyutunun tam sayısı.gasLimit:QUANTITY- bu blokta izin verilen maksimum gaz.GasUsed:QUANTITY- bu bloktaki tüm işlemler tarafından kullanılan toplam gaz.timestamp:QUANTITY- blokun harmanlandığı zamana ilişkin unix zaman damgası.transactions:Array- Son verilen parametreye bağlı olarak işlem nesneleri dizisi veya 32 Bayt işlem karmaları.uncles:Array- Amca karmaları dizisi.
Örnek
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockByHash","params":["0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae", false],"id":1}'3// Result4{5{6"jsonrpc": "2.0",7"id": 1,8"result": {9 "difficulty": "0x4ea3f27bc",10 "extraData": "0x476574682f4c5649562f76312e302e302f6c696e75782f676f312e342e32",11 "gasLimit": "0x1388",12 "gasUsed": "0x0",13 "hash": "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae",14 "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",15 "miner": "0xbb7b8287f3f0a933474a79eae42cbca977791171",16 "mixHash": "0x4fffe9ae21f1c9e15207b1f472d5bbdd68c9595d461666602f2be20daf5e7843",17 "nonce": "0x689056015818adbe",18 "number": "0x1b4",19 "parentHash": "0xe99e022112df268087ea7eafaf4790497fd21dbeeb6bd7a1721df161a6657a54",20 "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",21 "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",22 "size": "0x220",23 "stateRoot": "0xddc8b0234c2e0cad087c8b389aa7ef01f7d79b2570bccb77ce48648aa61c904d",24 "timestamp": "0x55ba467c",25 "totalDifficulty": "0x78ed983323d",26 "transactions": [27 ],28 "transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",29 "uncles": [30 ]31}32}Tümünü gösterKopyala
eth_getBlockByNumber
Blok numarasına göre bir blok hakkında bilgi döndürür.
Parametreler
QUANTITY|TAG- tamsayı blok numarası veya"latest",earliest","pending","safe"veya"finalized"dizesi, default block parameter kısmına göz atabilirsiniz.Boolean-trueise tam işlem nesnelerini döndürür,falseise yalnızca işlemlerin karmalarını döndürür.
1params: [2 "0x1b4", // 4363 true,4]Kopyala
İadeler Bkz. eth_getBlockByHash
Örnek
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockByNumber","params":["0x1b4", true],"id":1}'Kopyala
Sonuç bkz. eth_getBlockByHash
eth_getTransactionByHash
İşlem karması tarafından istenen bir işlem hakkındaki bilgileri döndürür.
Parametreler
DATA, 32 Bayt - bir işlemin özeti
1params: ["0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b"]Kopyala
Dönüşler
Object - Bir işlem nesnesi veya işlem bulunamadığında null:
blockHash:DATA, 32 Bayt - bu işlemin yapıldığı blokun karması.nullbeklediğinde.blockNumber:QUANTITY- bu işlemin yapıldığı blok numarası.nullbeklediğinde.from:DATA, 20 Bayt - gönderenin adresi.gas:QUANTITY- gönderen tarafından sağlanan gaz.gasPrice:QUANTITY- Wei'de gönderen tarafından sağlanan gaz fiyatı.hash:DATA, 32 Bayt - işlemin özeti.input:DATA- işlemle birlikte gönderilen veriler.nonce:QUANTITY- göndericinin bundan önce yaptığı işlem sayısı.to:DATA, 20 Bayt - alıcının adresi.nullbir sözleşme oluşturma işlemi olduğunda.transactionIndex:QUANTITY- bloktaki işlem endeksi pozisyonunun tam sayısı.nullbeklediğinde.value:QUANTITY- Wei'de aktarılan değer.v:QUANTITY- ECDSA kurtarma kimliğir:QUANTITY- ECDSA imzası rr:QUANTITY- ECDSA imzası s
Örnek
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByHash","params":["0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b"],"id":1}'3// Result4{5 "jsonrpc":"2.0",6 "id":1,7 "result":{8 "blockHash":"0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2",9 "blockNumber":"0x5daf3b", // 613970710 "from":"0xa7d9ddbe1f17865597fbd27ec712455208b6b76d",11 "gas":"0xc350", // 5000012 "gasPrice":"0x4a817c800", // 2000000000013 "hash":"0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b",14 "input":"0x68656c6c6f21",15 "nonce":"0x15", // 2116 "to":"0xf02c1c8e6114b1dbe8937a39260b5b0a374432bb",17 "transactionIndex":"0x41", // 6518 "value":"0xf3dbb76162000", // 429000000000000019 "v":"0x25", // 3720 "r":"0x1b5e176d927f8e9ab405058b2d2457392da3e20f328b16ddabcebc33eaac5fea",21 "s":"0x4ba69724e8f69de52f0125ad8b3c5c2cef33019bac3249e2c0a2192766d1721c"22 }23}Tümünü gösterKopyala
eth_getTransactionByBlockHashAndIndex
Blok karması ve işlem dizini konumuna göre bir işlem hakkındaki bilgileri döndürür.
Parametreler
DATA, 32 Bayt - bir blokun karması.QUANTITY- işlem endeks pozisyonunun sayısı.
1params: [2 "0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2",3 "0x0", // 04]Kopyala
Dönüşler Bkz. eth_getTransactionByHash
Örnek
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByBlockHashAndIndex","params":["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2", "0x0"],"id":1}'Kopyala
Sonuç bkz. eth_getTransactionByHash
eth_getTransactionByBlockNumberAndIndex
Blok numarasına ve işlem dizini konumuna göre bir işlem hakkında bilgi döndürür.
Parametreler
QUANTITY|TAG- tamsayı blok numarası veya"earliest","latest"","pending","safe"veya"finalized"dizesi, default block parameter kısmına göz atabilirsiniz.QUANTITY- işlem endeks pozisyonu.
1params: [2 "0x9c47cf", // 102419993 "0x24", // 364]Kopyala
Dönüşler Bkz. eth_getTransactionByHash
Örnek
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByBlockNumberAndIndex","params":["0x9c47cf", "0x24"],"id":1}'Kopyala
Sonuç bkz. eth_getTransactionByHash
eth_getTransactionReceipt
İşlem karmasına göre bir işlemin makbuzunu döndürür.
Not Makbuzun bekleyen işlemler için mevcut olmadığına dikkat edin.
Parametreler
VERİ, 32 Bayt - bir işlemin özeti
1params: ["0x85d995eba9763907fdf35cd2034144dd9d53ce32cbec21349d4b12823c6860c5"]Kopyala
Dönüşler Object - Bir işlem makbuzu nesnesi veya makbuz bulunamadığında null:
transactionHash:DATA, 32 Bayt - işlemin özeti.transactionIndex:QUANTITY- bloktaki işlem endeksi pozisyonunun tam sayısı.blockHash:DATA, 32 Bayt - bu işlemin yapıldığı blokun karması.blockNumber:QUANTITY- bu işlemin yapıldığı blok numarası.from:DATA, 20 Bayt - gönderenin adresi.to:DATA, 20 Bayt - alıcının adresi. bir sözleşme oluşturma işlemi olduğunda null.cumulativeGasUsed:QUANTITY- Bu işlem blokta yürütüldüğünde kullanılan toplam gaz miktarı.effectiveGasPrice:QUANTITY- Ana ücretin ve gaz birimi başına ödenen bahşişin toplamı.GasUsed:QUANTITY- Yalnızca bu özel işlem tarafından kullanılan gaz miktarı.contractAddress:DATA, 20 Bayt - İşlem bir sözleşme oluşturma ise, oluşturulan sözleşme adresi, aksi takdirdenull.logs:Array- Bu işlemin oluşturduğu günlük nesneleri dizisi.logsBloom:DATA, 256 Bayt - Hafif istemcilerin ilgili günlükleri hızlı bir şekilde alması için çiçek filtresi.type:QUANTITY- işlem türünün tam sayısı, eski tarz işlemler için0x0, erişim listesi türleri için0x1, değişken ücretler için0x2.
Ayrıca her ikisinden birini döndürür:
root:DATA32 bayt işlem sonrası durum kökü (Bizans öncesi)status:QUANTITYya1(başarılı) veya0(başarısız)
Örnek
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionReceipt","params":["0x85d995eba9763907fdf35cd2034144dd9d53ce32cbec21349d4b12823c6860c5"],"id":1}'3// Result4{5 "jsonrpc": "2.0",6 "id": 1,7 "result": {8 "blockHash":9 "0xa957d47df264a31badc3ae823e10ac1d444b098d9b73d204c40426e57f47e8c3",10 "blockNumber": "0xeff35f",11 "contractAddress": null, // string of the address if it was created12 "cumulativeGasUsed": "0xa12515",13 "effectiveGasPrice": "0x5a9c688d4",14 "from": "0x6221a9c005f6e47eb398fd867784cacfdcfff4e7",15 "gasUsed": "0xb4c8",16 "logs": [{17 // logs as returned by getFilterLogs, etc.18 }],19 "logsBloom": "0x00...0", // 256 byte bloom filter20 "status": "0x1",21 "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",22 "transactionHash":23 "0x85d995eba9763907fdf35cd2034144dd9d53ce32cbec21349d4b12823c6860c5",24 "transactionIndex": "0x66",25 "type": "0x2"26 }27}Tümünü gösterKopyala
eth_getUncleByBlockHashAndIndex
Karma ve amca dizin konumuna göre bir bloğun amcası hakkında bilgi verir.
Parametreler
DATA, 32 Bayt - Bir blokun şifresi.QUANTITY- Amcanın endeks pozisyonu.
1params: [2 "0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2",3 "0x0", // 04]Kopyala
İadeler Bkz. eth_getBlockByHash
Örnek
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleByBlockHashAndIndex","params":["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2", "0x0"],"id":1}'Kopyala
Sonuç bkz. eth_getBlockByHash
Not: Bir amca, bireysel işlemler içermez.
eth_getUncleByBlockNumberAndIndex
Sayıya ve amca dizin konumuna göre bir bloğun amcası hakkında bilgi verir.
Parametreler
QUANTITY|TAG- tamsayı blok numarası veya"earliest","latest"","pending","safe","finalized"dizesi, default block parameter kısmına göz atabilirsiniz.QUANTITY- amcanın endeks pozisyonu.
1params: [2 "0x29c", // 6683 "0x0", // 04]Kopyala
İadeler Bkz. eth_getBlockByHash
Not: Bir amca, bireysel işlemler içermez.
Örnek
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleByBlockNumberAndIndex","params":["0x29c", "0x0"],"id":1}'Kopyala
Sonuç bkz. eth_getBlockByHash
eth_newFilter
Durum değiştiğinde (günlükler) bildirimde bulunmak için filtre seçeneklerine dayalı olarak bir filtre nesnesi oluşturur. Durumun değişip değişmediğini kontrol etmek için eth_getFilterChanges'i arayın.
Konu filtrelerinin belirlenmesiyle ilgili bir not: Konular sıraya bağlıdır. [A, B] konularına sahip günlük içeren bir işlem, aşağıdaki konu filtreleriyle eşleştirilecektir:
[]"herhangi bir şey"[A]"A birinci konumda (ve sonraki herhangi bir şey)"[null, B]"birinci konumdaki herhangi bir şey VE ikinci konumdaki B (ve sonraki herhangi bir şey)"[A, B]"A birinci konumda VE B ikinci konumda (ve sonraki herhangi bir şey)"[[A, B], [A, B]]"(A VEYA B) birinci konumda VE (A VEYA B) ikinci konumda (ve sonraki herhangi bir şey)"- Parametreler
Object- Filtre seçenekleri:
fromBlock:QUANTITY|TAG- (isteğe bağlı, default:"latest") Tamsayı blok numarası veya son önerilen blok için"latest", en son güvenli blok için"safe", en son sonlandırılmış blok için"finalized", henüz bir blokta olmayan işlemler için"pending"ve"earliest".toBlock:QUANTITY|TAG- (isteğe bağlı, default:"latest") Tamsayı blok numarası veya son önerilen blok için"latest", en son güvenli blok için"safe", en son sonlandırılmış blok için"finalized", henüz bir blokta olmayan işlemler için"pending"ve"earliest".address:DATA|Array, 20 Bayt - (isteğe bağlı) Sözleşme adresi veya günlüklerin kaynaklanması gereken adreslerin listesi.topics:Array of DATA, - (isteğe bağlı) 32 Baytlık diziDATAkonu. Konular sıraya bağlıdır. Her konu, "veya" seçenekleriyle birlikte bir VERİ dizisi de olabilir.
1params: [2 {3 fromBlock: "0x1",4 toBlock: "0x2",5 address: "0x8888f1f195afa192cfee860698584c030f4c9db1",6 topics: [7 "0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",8 null,9 [10 "0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",11 "0x0000000000000000000000000aff3454fce5edbc8cca8697c15331677e6ebccc",12 ],13 ],14 },15]Tümünü gösterKopyala
Dönüşler QUANTITY - Bir filtre kimliğidir.
Örnek
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newFilter","params":[{"topics":["0x12341234"]}],"id":73}'3// Result4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0x1" // 18}Kopyala
eth_newBlockFilter
Yeni bir blok geldiğinde bildirimde bulunmak için düğümde bir filtre oluşturur. Durumun değişip değişmediğini kontrol etmek için eth_getFilterChanges'i arayın.
Parametreler Hiçbiri
Dönüşler QUANTITY - Bir filtre kimliğidir.
Örnek
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newBlockFilter","params":[],"id":73}'3// Result4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0x1" // 18}Kopyala
eth_newPendingTransactionFilter
Yeni bekleyen işlemler geldiğinde bildirimde bulunmak için düğümde bir filtre oluşturur. Durumun değişip değişmediğini kontrol etmek için eth_getFilterChanges'i arayın.
Parametreler Hiçbiri
Dönüşler QUANTITY - Bir filtre kimliğidir.
Örnek
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newPendingTransactionFilter","params":[],"id":73}'3// Result4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0x1" // 18}Kopyala
eth_uninstallFilter
Verilen kimliğe sahip bir filtreyi kaldırır. Saate artık ihtiyaç duyulmadığında daima çağrılmalıdır. Ek olarak Filtreler, belirli bir süre için eth_getFilterChanges ile istenmediğinde zaman aşımına uğrar.
Parametreler
QUANTITY- Filtre kimliğidir.
1params: [2 "0xb", // 113]Kopyala
Dönüşler Boolean - Filtre başarıyla kaldırıldıysa true, aksi takdirde false.
Örnek
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_uninstallFilter","params":["0xb"],"id":73}'3// Result4{5 "id":1,6 "jsonrpc": "2.0",7 "result": true8}Kopyala
eth_getFilterChanges
Son yoklamadan bu yana oluşan günlüklerin bir dizisini döndüren bir filtre için yoklama yöntemidir.
Parametreler
QUANTITY- filtre kimliğidir.
1params: [2 "0x16", // 223]Kopyala
Dönüşler Array - Günlük nesneleri dizisi veya son anketten bu yana hiçbir şey değişmediyse boş bir dizi.
eth_newBlockFilterile oluşturulan filtreler için dönüş, blok karmalarıdır (DATA, 32 Bayt), ör.["0x345464563453..."].eth_newPendingTransactionFilterile oluşturulan filtreler için dönüş, işlem karmalarıdır (DATA, 32 Bayt), ör.["0x6345343454645..."].eth_newFiltergünlükleriyle oluşturulan filtreler için aşağıdaki parametrelere sahip nesnelerdir:removed:TAG- Zincirin yeniden düzenlenmesi nedeniyle günlük kaldırıldığındatrue. Geçerli bir günlüksefalse.logIndex:QUANTITY- bloktaki günlük dizini konumunun tam sayısı.nullBekleyen kayıt defteri olduğunda.transactionIndex:QUANTITY- işlem dizini pozisyon günlüğünün oluşturulduğu tam sayı.nullBekleyen kayıt defteri olduğunda.transactionHash:DATA, 32 Bayt - bu günlüğün oluşturulduğu işlemlerin karması.nullBekleyen kayıt defteri olduğunda.blockHash:DATA, 32 Bayt - bu günlüğün bulunduğu blokun karması.nullbeklediğinde.nullBekleyen kayıt defteri olduğunda.blockNumber:QUANTITY- bu günlüğün bulunduğu blok numarası.nullbeklediğinde.nullBekleyen kayıt defteri olduğunda.address:DATA, 20 Bayt - bu günlüğün kaynaklandığı adres.data:DATA- günlüğün sıfır veya daha fazla sayıda 32 Baytlık dizine eklenmemiş bağımsız değişkenlerini içerir.topics:Array of DATA- 0 ila 4 arası dizi 32 BaytDATAdizine alınmış günlük bağımsız değişkenleri. (solidity'de: İlk konu, olayın imzasının karma değeridir (ör.Deposit(address,bytes32,uint256)), ancak olayıanonymousbelirteci ile bildirmeniz dışında.)
- Örnek
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getFilterChanges","params":["0x16"],"id":73}'3// Result4{5 "id":1,6 "jsonrpc":"2.0",7 "result": [{8 "logIndex": "0x1", // 19 "blockNumber":"0x1b4", // 43610 "blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",11 "transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",12 "transactionIndex": "0x0", // 013 "address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",14 "data":"0x0000000000000000000000000000000000000000000000000000000000000000",15 "topics": ["0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"]16 },{17 ...18 }]19}Tümünü gösterKopyala
eth_getFilterLogs
Verilen kimliğe sahip filtreyle eşleşen tüm günlüklerin bir dizisini döndürür.
Parametreler
QUANTITY- Filtre kimliğidir.
1params: [2 "0x16", // 223]Kopyala
Dönüşler Bkz. eth_getFilterChanges
Örnek
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getFilterLogs","params":["0x16"],"id":74}'Kopyala
Sonuç, bkz. eth_getFilterChanges
eth_getLogs
Belirli bir filtre nesnesiyle eşleşen tüm günlüklerin bir dizisini döndürür.
Parametreler
Object- Filtre seçenekleri:
fromBlock:QUANTITY|TAG- (isteğe bağlı, default:"latest") Tamsayı blok numarası veya son önerilen blok için"latest", en son güvenli blok için"safe", en son sonlandırılmış blok için"finalized", henüz bir blokta olmayan işlemler için"pending"ve"earliest".toBlock:QUANTITY|TAG- (isteğe bağlı, default:"latest") Tamsayı blok numarası veya son önerilen blok için"latest", en son güvenli blok için"safe", en son sonlandırılmış blok için"finalized", henüz bir blokta olmayan işlemler için"pending"ve"earliest".address:DATA|Array, 20 Bayt - (isteğe bağlı) Sözleşme adresi veya günlüklerin kaynaklanması gereken adreslerin listesi.topics:Array of DATA, - (isteğe bağlı) 32 Baytlık diziDATAkonu. Konular sıraya bağlıdır. Her konu, "veya" seçenekleriyle birlikte bir VERİ dizisi de olabilir.blockhash:DATA, 32 Bayt - (isteğe bağlı, gelecek) EIP-234 eklenmesiyle,blockHash, 32 baytlıkblockHashile tek bloka döndürülen günlükleri kısıtlayan yeni bir filtre seçeneği olacaktır.blockHashkullanımı,fromBlockile eş değerdir =toBlock=blockHashkarmalı blok numarası. Filtre ölçütlerindeblockHashvarsa, nefromBlockne detoBlock'a izin verilmez.
1params: [2 {3 topics: [4 "0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",5 ],6 },7]Kopyala
Dönüşler Bkz. eth_getFilterChanges
Örnek
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getLogs","params":[{"topics":["0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b"]}],"id":74}'Kopyala
Sonuç, bkz. eth_getFilterChanges
Kullanım Örneği
JSON_RPC kullanarak bir sözleşmeyi dağıtma
Bu bölüm, yalnızca RPC arayüzünü kullanarak bir sözleşmenin nasıl dağıtılacağının gösterimini içerir. Bu karmaşıklığın ortadan kaldırıldığı sözleşmeleri dağıtmanın alternatif yolları vardır; örneğin, web3.js ve web3.py gibi RPC arayüzünün üzerine kurulmuş kitaplıkları kullanmak gibi. Bu soyutlamaların anlaşılması genellikle daha kolaydır ve hataya karşı daha korumalıdır, ancak kaputun altında neler oldup bittiğini anlamak yine de yardımcı olur.
JSON-RPC arabirimi kullanılarak bir Ethereum düğümüne dağıtılacak olan Multiply7 adlı basit bir akıllı sözleşmeyi aşağıda görebilirsiniz. Bu öğretici, okuyucunun zaten bir Geth düğümü çalıştırdığını varsayar. Düğümler ve istemciler hakkında daha fazla bilgiyi burada bulabilirsiniz. Geth olmayan istemciler için HTTP JSON-RPC'nin nasıl başlatılacağını görmek için lütfen bireysel istemci dokümanlarına bakın. Çoğu istemci, varsayılan olarak localhost:8545 üzerinde hizmet verir.
1contract Multiply7 {2 event Print(uint);3 function multiply(uint input) returns (uint) {4 Print(input * 7);5 return input * 7;6 }7}
Yapılacak ilk şey, HTTP RPC arayüzünün etkinleştirilmesini sağlamaktır. Bu, Geth'e başlangıçta --http bayrağını sağladığımız anlamına gelir. Bu örnekte, özel bir geliştirme zincirinde Geth düğümünü kullanıyoruz. Bu yaklaşımı kullandığımızda gerçek ağda ether'e ihtiyacımız olmaz.
geth --http --dev console 2>>geth.log
Bu, http://localhost:8545 üzerinde HTTP RPC arayüzünü başlatır.
curl kullanarak Coinbase adresini ve bakiyeyi alarak arayüzün çalıştığını doğrulayabiliriz. Lütfen bu örneklerdeki verilerin yerel düğümünüzde farklılık göstereceğini unutmayın. Bu komutları denemek istiyorsanız, ikinci kıvrılma isteğindeki istek paragraflarını ilkinden döndürülen sonuçla değiştirin.
curl --data '{"jsonrpc":"2.0","method":"eth_coinbase", "id":1}' -H "Content-Type: application/json" localhost:8545{"id":1,"jsonrpc":"2.0","result":["0x9b1d35635cc34752ca54713bb99d38614f63c955"]}curl --data '{"jsonrpc":"2.0","method":"eth_getBalance", "params": ["0x9b1d35635cc34752ca54713bb99d38614f63c955", "latest"], "id":2}' -H "Content-Type: application/json" localhost:8545{"id":2,"jsonrpc":"2.0","result":"0x1639e49bba16280000"}
Sayılar on altılık kodlandığından, bakiye wei'de on altılılık bir dize olarak döndürülür. Ether'de bir sayı olarak bakiyeye sahip olmak istiyorsak, Geth konsolundan web3'ü kullanabiliriz.
1web3.fromWei("0x1639e49bba16280000", "ether")2// "410"
Artık özel geliştirme zincirimizde bir miktar ether olduğuna göre sözleşmeyi dağıtabiliriz. İlk adım, Multiply7 sözleşmesini EVM'ye gönderilebilecek bayt kodunu derlemektir. Solidity derleyicisi olan solc'yi kurmak için Solidity dokümanlarını izleyin. (Örneğimizde kullanılan derleyici sürümüyle eşleşmesi için daha eski bir solc sürümü kullanmak isteyebilirsiniz.)
Bir sonraki adım, Multiply7 sözleşmesini EVM'ye gönderilebilecek bayt kodunu derlemektir.
echo 'pragma solidity ^0.4.16; contract Multiply7 { event Print(uint); function multiply(uint input) public returns (uint) { Print(input * 7); return input * 7; } }' | solc --bin======= <stdin>:Multiply7 =======Binary:6060604052341561000f57600080fd5b60eb8061001d6000396000f300606060405260043610603f576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff168063c6888fa1146044575b600080fd5b3415604e57600080fd5b606260048080359060200190919050506078565b6040518082815260200191505060405180910390f35b60007f24abdb5865df5079dcc5ac590ff6f01d5c16edbc5fab4e195d9febd1114503da600783026040518082815260200191505060405180910390a16007820290509190505600a165627a7a7230582040383f19d9f65246752244189b02f56e8d0980ed44e7a56c0b200458caad20bb0029
Artık derlenmiş koda sahip olduğumuza göre, onu dağıtmanın ne kadar gaza mal olacağını belirlememiz gerekiyor. RPC arayüzünde bize bir tahmin verecek bir eth_estimateGas yöntemi mevcuttur.
curl --data '{"jsonrpc":"2.0","method": "eth_estimateGas", "params": [{"from": "0x9b1d35635cc34752ca54713bb99d38614f63c955", "data": "0x6060604052341561000f57600080fd5b60eb8061001d6000396000f300606060405260043610603f576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff168063c6888fa1146044575b600080fd5b3415604e57600080fd5b606260048080359060200190919050506078565b6040518082815260200191505060405180910390f35b60007f24abdb5865df5079dcc5ac590ff6f01d5c16edbc5fab4e195d9febd1114503da600783026040518082815260200191505060405180910390a16007820290509190505600a165627a7a7230582040383f19d9f65246752244189b02f56e8d0980ed44e7a56c0b200458caad20bb0029"}], "id": 5}' -H "Content-Type: application/json" localhost:8545{"jsonrpc":"2.0","id":5,"result":"0x1c31e"}
Ve son olarak sözleşmeyi dağıtın.
curl --data '{"jsonrpc":"2.0","method": "eth_sendTransaction", "params": [{"from": "0x9b1d35635cc34752ca54713bb99d38614f63c955", "gas": "0x1c31e", "data": "0x6060604052341561000f57600080fd5b60eb8061001d6000396000f300606060405260043610603f576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff168063c6888fa1146044575b600080fd5b3415604e57600080fd5b606260048080359060200190919050506078565b6040518082815260200191505060405180910390f35b60007f24abdb5865df5079dcc5ac590ff6f01d5c16edbc5fab4e195d9febd1114503da600783026040518082815260200191505060405180910390a16007820290509190505600a165627a7a7230582040383f19d9f65246752244189b02f56e8d0980ed44e7a56c0b200458caad20bb0029"}], "id": 6}' -H "Content-Type: application/json" localhost:8545{"id":6,"jsonrpc":"2.0","result":"0xe1f3095770633ab2b18081658bad475439f6a08c902d0915903bafff06e6febf"}
İşlem, düğüm tarafından kabul edilir ve bir işlem karması döndürülür. Bu karma, işlemi takip etmek için kullanılabilir. Bir sonraki adım, sözleşmemizin dağıtıldığı adresi belirlemektir. Gerçekleştirilen her işlemi bir makbuz oluşturacaktır. Bu makbuz, işlemin hangi bloğa dahil olduğu ve ESM tarafından ne kadar gaz kullanıldığı gibi işlemle ilgili çeşitli bilgileri içerir. Bir işlem bir sözleşme oluşturuyorsa, sözleşme adresini de içerecektir. eth_getTransactionReceipt RPC yöntemiyle makbuzu alabiliriz.
curl --data '{"jsonrpc":"2.0","method": "eth_getTransactionReceipt", "params": ["0xe1f3095770633ab2b18081658bad475439f6a08c902d0915903bafff06e6febf"], "id": 7}' -H "Content-Type: application/json" localhost:8545{"jsonrpc":"2.0","id":7,"result":{"blockHash":"0x77b1a4f6872b9066312de3744f60020cbd8102af68b1f6512a05b7619d527a4f","blockNumber":"0x1","contractAddress":"0x4d03d617d700cf81935d7f797f4e2ae719648262","cumulativeGasUsed":"0x1c31e","from":"0x9b1d35635cc34752ca54713bb99d38614f63c955","gasUsed":"0x1c31e","logs":[],"logsBloom":"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000","status":"0x1","to":null,"transactionHash":"0xe1f3095770633ab2b18081658bad475439f6a08c902d0915903bafff06e6febf","transactionIndex":"0x0"}}
Sözleşmemiz 0x4d03d617d700cf81935d7f797f4e2ae719648262 üzerinde oluşturuldu. Makbuz yerine boş bir sonuç, işlemin henüz bir bloğa dahil edilmediği anlamına gelir. Bir dakika bekleyin ve fikir birliği istemcinizin çalışıp çalışmadığını kontrol edip tekrar deneyin.
Akıllı sözleşmelerle etkileşim
Bu örnekte, sözleşmenin multiply yöntemine, eth_sendTransaction kullanarak bir işlem göndereceğiz.
eth_sendTransaction, özellikle from, to ve data olmak üzere birkaç bağımsız değişken gerektirir. From hesabımızın genel adresidir ve to da sözleşme adresidir. Data bağımsız değişkeni, hangi yöntemin hangi bağımsız değişkenlerle çağrılması gerektiğini tanımlayan bir yük içerir. Burada ABI (uygulama ikili arayüzü) devreye girer. ABI, EVM için verilerin nasıl tanımlanacağını ve kodlanacağını tanımlayan bir JSON dosyasıdır.
Yükün baytları, sözleşmedeki hangi yöntemin çağrılacağını tanımlar. Bu, fonksiyon adı ve argüman türleri üzerindeki Keccak karma değerinin ilk 4 baytıdır ve on altılık şekilde kodlanmıştır. Çarpma fonksiyonu, uint256 için bir takma ad olan uint'i kabul eder. Bu, bize şunu bırakır:
1web3.sha3("multiply(uint256)").substring(0, 10)2// "0xc6888fa1"
Bir sonraki adım, argümanları kodlamaktır. Yalnızca bir uint256 var, diyelim ki değeri 6. ABI, uint256 türlerinin nasıl kodlanacağını belirten bir bölüme sahiptir.
int<M>: enc(X), yüksek dereceden (sol) tarafta negatif X için 0xff ve sıfır > Uzunluk 32 baytın katı olacak şekilde pozitif X için baytlardan oluşan X'in büyük endian ikinin tümleyeni kodlamasıdır.
Bu, 0000000000000000000000000000000000000000000000000000000000000006 olarak kodlar.
Fonksiyon seçiciyi ve kodlanmış argümanı birleştirdiğimizde verilerimiz 0xc6888fa1000000000000000000000000000000000000000000000000000000000000000 olur.
Bu, artık düğüme gönderilebilir:
curl --data '{"jsonrpc":"2.0","method": "eth_sendTransaction", "params": [{"from": "0xeb85a5557e5bdc18ee1934a89d8bb402398ee26a", "to": "0x6ff93b4b46b41c0c3c9baee01c255d3b4675963d", "data": "0xc6888fa10000000000000000000000000000000000000000000000000000000000000006"}], "id": 8}' -H "Content-Type: application/json" localhost:8545{"id":8,"jsonrpc":"2.0","result":"0x759cf065cbc22e9d779748dc53763854e5376eea07409e590c990eafc0869d74"}
Bir işlem gönderildiğinden, bir işlem karması döndürülmüştür. Makbuzun alınması şunları sağlar:
1{2 blockHash: "0xbf0a347307b8c63dd8c1d3d7cbdc0b463e6e7c9bf0a35be40393588242f01d55",3 blockNumber: 268,4 contractAddress: null,5 cumulativeGasUsed: 22631,6 gasUsed: 22631,7 logs: [{8 address: "0x6ff93b4b46b41c0c3c9baee01c255d3b4675963d",9 blockHash: "0xbf0a347307b8c63dd8c1d3d7cbdc0b463e6e7c9bf0a35be40393588242f01d55",10 blockNumber: 268,11 data: "0x000000000000000000000000000000000000000000000000000000000000002a",12 logIndex: 0,13 topics: ["0x24abdb5865df5079dcc5ac590ff6f01d5c16edbc5fab4e195d9febd1114503da"],14 transactionHash: "0x759cf065cbc22e9d779748dc53763854e5376eea07409e590c990eafc0869d74",15 transactionIndex: 016 }],17 transactionHash: "0x759cf065cbc22e9d779748dc53763854e5376eea07409e590c990eafc0869d74",18 transactionIndex: 019}Tümünü göster
Makbuz, bir günlük içerir. Bu günlük, işlem yürütülürken EVM tarafından oluşturulur ve makbuza dahil edilir. multiply işlevi, Print olayının 7 giriş değeriyle tetiklendiğini gösterir. Print olayının argümanı uint256 olduğundan, bunu ABI kurallarına göre çözebiliriz ve bu da bize beklenen ondalık sayı 42'yi bırakır. Verilerin yanı sıra, günlüğü hangi olayın oluşturduğunu belirlemek için konuların kullanılabileceğini belirtmekte fayda vardır:
1web3.sha3("Print(uint256)")2// "24abdb5865df5079dcc5ac590ff6f01d5c16edbc5fab4e195d9febd1114503da"
Bu, JSON-RPC'nin doğrudan kullanımını gösteren en yaygın görevlerden bazılarına kısa bir giriş niteliğindeydi.