Ana içeriğe geç

Web3 Kullanarak İşlem Gönderme

işlemler
web3.js
alchemy
Acemi
Elan Halpern
4 Kasım 2020
8 dakikalık okuma

Bu, Web3 kullanarak Ethereum işlemleri göndermek için başlangıç dostu bir rehberdir. Ethereum blokzincirine bir işlem göndermek için üç ana adım vardır: oluşturma, imzalama ve yayımlama. Üçünü de gözden geçirerek aklınızdaki soruları cevaplamayı umuyoruz! Bu öğreticide, işlemlerimizi Ethereum zincirine göndermek için Alchemy (opens in a new tab) kullanacağız. Buradan ücretsiz bir Alchemy hesabı oluşturabilirsiniz (opens in a new tab).

NOT: Bu rehber, uygulamanızın backend tarafında işlemlerinizi imzalamak içindir. İşlemlerinizi imzalamayı frontend'e entegre etmek istiyorsanız, Web3'ü bir tarayıcı sağlayıcısıyla entegre etme (opens in a new tab) konusuna göz atın.

Temel Bilgiler

Çoğu blokzincir geliştiricisi gibi, işe ilk başladığınızda, (oldukça basit olması gereken) bir işlemin nasıl gönderileceği üzerine araştırma yapmış ve her biri farklı şeyler söyleyen, sizi biraz bunaltıp kafanızı karıştıran çok sayıda rehberle karşılaşmış olabilirsiniz. Bu durumdaysanız merak etmeyin; hepimiz o yollardan geçtik! O zaman başlamadan önce birkaç şeyi açıklığa kavuşturalım:

1. Alchemy özel anahtarlarınızı saklamaz

  • Bu, Alchemy'nin sizin adınıza işlemleri imzalayamayacağı ve gönderemeyeceği anlamına gelir. Bunun nedeni güvenlik amaçlıdır. Alchemy asla özel anahtarınızı paylaşmanızı istemez ve özel anahtarınızı barındırılan bir düğümle (veya bu konuda herhangi biriyle) asla paylaşmamalısınız.
  • Alchemy'nin çekirdek API'sini kullanarak blokzincirden okuma yapabilirsiniz, ancak blokzincire yazmak için işlemlerinizi Alchemy aracılığıyla göndermeden önce imzalamak için başka bir araç kullanmanız gerekir (bu durum diğer tüm düğüm hizmetleri için de geçerlidir).

2. “İmzalayıcı” nedir?

  • İmzalayıcılar, özel anahtarınızı kullanarak işlemleri sizin için imzalar. Bu öğreticide, işlemimizi imzalamak için Alchemy web3 (opens in a new tab) kullanacağız, ancak başka bir web3 kütüphanesi de kullanabilirsiniz.
  • Frontend'de iyi bir imzalayıcı örneği, sizin adınıza işlemleri imzalayıp gönderecek olan MetaMask (opens in a new tab)'tır.

3. İşlemlerimi neden imzalamam gerekiyor?

  • Ethereum ağında bir işlem göndermek isteyen her kullanıcı, işlemin kaynağının iddia ettiği kişi olduğunu doğrulamak için işlemi (özel anahtarını kullanarak) imzalamalıdır.
  • Bu özel anahtarı korumak çok önemlidir, çünkü erişime sahip olmak Ethereum hesabınız üzerinde tam kontrol sağlayarak sizin (veya erişimi olan herhangi birinin) sizin adınıza işlem gerçekleştirmesine izin verir.

4. Özel anahtarımı nasıl korurum?

  • Özel anahtarınızı korumanın ve işlemleri göndermek için kullanmanın birçok yolu vardır. Bu öğreticide bir .env dosyası kullanacağız. Ancak özel anahtarları saklayan ayrı bir sağlayıcı, bir keystore dosyası veya başka seçenekler de kullanabilirsiniz.

5. eth_sendTransaction ve eth_sendRawTransaction arasındaki fark nedir?

eth_sendTransaction ve eth_sendRawTransaction, gelecekteki bir bloğa eklenmesi için Ethereum ağına bir işlem yayınlayan Ethereum API fonksiyonlarıdır. İşlemlerin imzalanmasını ele alma biçimlerinde farklılık gösterirler.

web3 kullanırken eth_sendRawTransaction'a web3.eth.sendSignedTransaction (opens in a new tab) fonksiyonu çağrılarak erişilir.

Bu öğreticide bunu kullanacağız.

6. Web3 kütüphanesi nedir?

Pekala, şimdi bu sorulardan birkaçını aradan çıkardığımıza göre, öğreticiye geçelim. Alchemy discord (opens in a new tab) kanalında dilediğiniz zaman soru sormaktan çekinmeyin!

7. Güvenli, gaz optimizasyonlu ve özel işlemler nasıl gönderilir?

NOT: Bu rehber için bir Alchemy hesabı, bir Ethereum adresi veya MetaMask cüzdanı, Node.js ve npm'in kurulu olması gerekir. Kurulu değilse şu adımları takip edin:

  1. Ücretsiz bir Alchemy hesabı oluşturun (opens in a new tab)
  2. MetaMask hesabı oluşturun (opens in a new tab) (veya bir Ethereum adresi alın)
  3. Node.js ve NPM'i yüklemek için bu adımları izleyin (opens in a new tab)

İşleminizi Gönderme Adımları

1. Sepolia test ağında bir Alchemy uygulaması oluşturun

Alchemy Pano'nuza (opens in a new tab) gidin ve ağınız için Sepolia'yı (veya başka bir test ağını) seçerek yeni bir uygulama oluşturun.

2. Sepolia musluğundan ETH talep edin

ETH almak için Alchemy Sepolia musluğundaki (opens in a new tab) talimatları izleyin. Başka bir ağınkini değil, Sepolia Ethereum adresinizi (MetaMask'ten) girdiğinizden emin olun. Talimatları izledikten sonra cüzdanınıza ETH'nin geldiğini tekrar kontrol edin.

3. Yeni bir proje dizini oluşturun ve içine cd ile girin

Komut satırından (mac'ler için terminal) yeni bir proje dizini oluşturun ve içine gidin:

1mkdir sendtx-example
2cd sendtx-example

4. Alchemy Web3'ü (veya herhangi bir web3 kütüphanesini) yükleyin

Alchemy Web3 (opens in a new tab) yüklemek için proje dizininizde aşağıdaki komutu çalıştırın:

Not, ethers.js kütüphanesini kullanmak isterseniz, buradaki talimatları izleyin (opens in a new tab).

1npm install @alch/alchemy-web3

5. dotenv'i yükleyin

API anahtarımızı ve özel anahtarımızı güvenli bir şekilde saklamak için bir .env dosyası kullanacağız.

1npm install dotenv --save

6. .env dosyasını oluşturun

Proje dizininizde bir .env dosyası oluşturun ve aşağıdakileri ekleyin ("your-api-url" ve "your-private-key" kısımlarını değiştirerek)

  • Alchemy API URL'nizi bulmak için, panonuzda yeni oluşturduğunuz uygulamanın uygulama ayrıntıları sayfasına gidin, sağ üst köşedeki “View Key”'e tıklayın ve HTTP URL'sini alın.
  • MetaMask kullanarak özel anahtarınızı bulmak için bu rehbere (opens in a new tab) göz atın.
1API_URL = "your-api-url"
2PRIVATE_KEY = "your-private-key"

7. sendTx.js dosyasını oluşturun

Harika, artık hassas verilerimizi bir .env dosyasında koruduğumuza göre kodlamaya başlayalım. İşlem gönderme örneğimiz için ETH'yi Sepolia musluğuna geri göndereceğiz.

Örnek işlemimizi yapılandırıp göndereceğimiz bir sendTx.js dosyası oluşturun ve buna aşağıdaki kod satırlarını ekleyin:

1async function main() {
2    require('dotenv').config();
3    const { API_URL, PRIVATE_KEY } = process.env;
4    const { createAlchemyWeb3 } = require("@alch/alchemy-web3");
5    const web3 = createAlchemyWeb3(API_URL);
6    const myAddress = '0x610Ae88399fc1687FA7530Aac28eC2539c7d6d63' //TODO: bu adresi kendi genel adresinizle değiştirin
7
8    const nonce = await web3.eth.getTransactionCount(myAddress, 'latest'); // nonce 0'dan saymaya başlar
9
10    const transaction = {
11     'to': '0x31B98D14007bDEe637298086988A0bBd31184523', // eth'yi iade etmek için musluk adresi
12     'value': 1000000000000000000, // 1 ETH
13     'gas': 30000,
14     'nonce': nonce,
15     // mesaj göndermek veya akıllı sözleşme yürütmek için isteğe bağlı veri alanı
16    };
17
18    const signedTx = await web3.eth.accounts.signTransaction(transaction, PRIVATE_KEY);
19
20    web3.eth.sendSignedTransaction(signedTx.rawTransaction, function(error, hash) {
21    if (!error) {
22      console.log("🎉 İşleminizin hash'i: ", hash, "\n İşleminizin durumunu görüntülemek için Alchemy'nin Mempool'unu kontrol edin!");
23    } else {
24      console.log("❗İşleminizi gönderirken bir şeyler ters gitti:", error)
25    }
26   });
27}
28
29main();
Tümünü göster

6. satırdaki adresi kendi genel adresinizle değiştirdiğinizden emin olun.

Şimdi, bu kodu çalıştırmaya geçmeden önce, burada bazı bileşenlerden bahsedelim.

  • nonce : Nonce özelliği, adresinizden gönderilen işlem sayısını takip etmek için kullanılır. Buna güvenlik amacıyla ve tekrar saldırılarını (opens in a new tab) önlemek için ihtiyacımız var. Adresinizden gönderilen işlem sayısını almak için getTransactionCount (opens in a new tab) kullanırız.
  • transaction: İşlem nesnesinin belirtmemiz gereken birkaç özelliği vardır
    • to: ETH göndermek istediğimiz adrestir. Bu durumda ETH'yi, başlangıçta talep ettiğimiz Sepolia musluğuna (opens in a new tab) geri gönderiyoruz.
    • value: Göndermek istediğimiz miktardır. Wei cinsinden belirtilir ve 10^18 Wei = 1 ETH'dir.
    • gas: İşleminize dahil edilecek doğru gaz miktarını belirlemenin birçok yolu vardır. Hatta Alchemy'nin, gaz fiyatı belirli bir eşiğin altına düştüğünde sizi bilgilendiren bir gaz fiyatı webhook'u (opens in a new tab) bile vardır. Ana Ağ işlemleri için, eklenecek doğru gaz miktarını belirlemek amacıyla ETH Gas Station (opens in a new tab) gibi bir gaz tahmin ediciyi kontrol etmek iyi bir uygulamadır. 21000, Ethereum'da bir işlemin kullanacağı minimum gaz miktarıdır, bu nedenle işlemimizin gerçekleştirilmesini sağlamak için buraya 30000 koyduk.
    • nonce: yukarıdaki nonce tanımına bakın. Nonce değeri, saymaya sıfırdan başlar.
    • [İSTEĞE BAĞLI] data: Aktarımınızla ek bilgi göndermek veya bir akıllı sözleşme çağırmak için kullanılır. Bakiye aktarımları için gerekli değildir, aşağıdaki nota göz atın.
  • signedTx: İşlem nesnemizi imzalamak için PRIVATE_KEYimiz ile signTransaction metodunu kullanacağız.
  • sendSignedTransaction: İmzalanmış bir işlemimiz olduğunda, sendSignedTransaction kullanarak sonraki bir bloğa dahil edilmesi için gönderebiliriz.

Veri Üzerine Bir Not Ethereum'da gönderilebilecek iki ana işlem türü vardır.

  • Bakiye aktarımı: Bir adresten diğerine ETH gönderin. Veri alanı gerekli değildir, ancak işleminizle birlikte ek bilgi göndermek isterseniz, bu bilgiyi bu alana HEX formatında ekleyebilirsiniz.
    • Örneğin, değişmez bir zaman damgası vermek için bir IPFS belgesinin hash değerini ethereum zincirine yazmak istediğimizi varsayalım. Veri alanımız bu durumda şöyle görünmelidir: data: web3.utils.toHex('IPFS hash'). Artık herkes zinciri sorgulayabilir ve bu belgenin ne zaman eklendiğini görebilir.
  • Akıllı sözleşme işlemi: Zincir üzerinde akıllı sözleşme kodu yürütün. Bu durumda, veri alanı, yürütmek istediğiniz akıllı fonksiyonu ve tüm parametreleri içermelidir.

8. Kodu node sendTx.js kullanarak çalıştırın

Terminalinize veya komut satırınıza geri dönün ve şunu çalıştırın:

1node sendTx.js

9. İşleminizi Mempool'da görün

Alchemy panonuzdaki Mempool sayfasını (opens in a new tab) açın ve işleminizi bulmak için oluşturduğunuz uygulamaya göre filtreleyin. İşleminizin bekleme durumundan kazılmış duruma (başarılıysa) veya düşürülmüş duruma (başarısızsa) geçişini buradan izleyebilirsiniz. “kazılmış”, “beklemede” ve “düşürülmüş” işlemleri yakalamak için “Tümü” (All) seçeneğinde kaldığından emin olun. 0x31b98d14007bdee637298086988a0bbd31184523 adresine gönderilen işlemleri arayarak da işleminizi bulabilirsiniz.

İşleminizi bulduktan sonra ayrıntılarını görüntülemek için, sizi aşağıdaki gibi bir görünüme götürecek olan tx hash'ini seçin:

Mempool izleyici ekran görüntüsü

Buradan, kırmızı daire içine alınmış simgeye tıklayarak işleminizi Etherscan'de görüntüleyebilirsiniz!

Oley! Alchemy kullanarak ilk Ethereum işleminizi gönderdiniz 🎉**

Bu rehber hakkındaki geri bildirim ve önerileriniz için lütfen Alchemy'nin Discord (opens in a new tab) kanalından Elan'a mesaj gönderin!

Orijinal olarak https://docs.alchemyapi.io/tutorials/sending-transactions-using-web3-and-alchemy (opens in a new tab) adresinde yayımlandı

Sayfanın son güncellenmesi: 18 Aralık 2025

litvintechl (opens in a new tab)
JoeChenJJ (opens in a new tab)
pettinaripp (opens in a new tab)
+16

Bu rehber yararlı oldu mu?