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şlemlerini göndermek için yeni başlayanlara uygun bir rehberdir. Ethereum blok zincirine bir işlem göndermek için üç ana adım vardır: oluşturma, imzalama ve yayınlama. Üçü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 kılavuz, uygulamanızın arka yüzündeki işlemlerinizi imzalamak içindir. İşlemlerinizi imzalamayı ön yüze entegre etmek istiyorsanız Web3'ü bir tarayıcı sağlayıcısı(opens in a new tab) ile entegre etmeye göz atın.

Temel Bilgiler

Çoğu blok zinciri geliştiricisi ilk başladıklarında olduğu gibi, bir işlemin nasıl gönderileceği konusunda (oldukça basit olması gereken bir şey) biraz araştırma yapmış ve her biri farklı şeyler söyleyen ve sizi biraz bunaltıp kafanızı karıştıran çok sayıda kılavuza rastlamış 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. Simya asla özel anahtarınızı paylaşmanızı istemez ve özel anahtarınızı asla barındırılan bir düğümle (veya bu konuda herhangi biri ile) paylaşmamalısınız.
  • Alchemy'nin çekirdek API'sini kullanarak blok zincirinden okuma yapabilirsiniz, ancak blok zincirine yazmak için işlemlerinizi Alchemy aracılığıyla göndermeden önce onları imzalamak için başka bir şey kullanmanız gerekir (bu, diğer tüm düğüm hizmetleri için aynıdır).

2. Bir "imzalayı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 herhangi bir web3 kitaplığını da kullanabilirsiniz.
  • Ön yüzde, işlemleri sizin adınıza imzalayıp gönderen MetaMask(opens in a new tab) imzalayıcının iyi bir örneğidir.

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ı depolayan, bir anahtar deposu dosyası kullanan veya diğer seçenekleri kullanan ayrı bir sağlayıcı da 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ı nasıl ele aldıkları konusunda farklılık gösterirler.

Web3 kullanırken eth_sendRawTransaction erişimi, web3.eth.sendSignedTransaction(opens in a new tab) fonksiyonu çağrılarak sağlanır.

Bu öğreticide kullanacağımız şey budur.

6. Web3 kütüphanesi nedir?

Pekala, şimdi bu sorulardan birkaçını aradan çıkardığımıza göre, öğreticiye geçelim. Alchemy ile ilgili sorularınızı herhangi bir zaman discord(opens in a new tab)'umuzda sormaktan çekinmeyin!

7. Güvenli, gaz açısından optimize edilmiş ve özel işlemler nasıl gönderilir?

NOT: Bu kılavuz bir Alchemy hesabı, bir Ethereum adresi veya MetaMask cüzdanı, NodeJ'ler ve npm'nin kurulu olmasını gerektirir. 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. NodeJ'leri ve NPM'yi yüklemek için bu adımları izleyin(opens in a new tab)

İşleminizi Gönderme Adımları

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

Alchemy Dashboard'a(opens in a new tab) gidin ve ağınızı Sepolia seçerek (ya da başka bir test ağı) yeni bir uygulama yaratın.

2. Sepolia musluğundan ETH isteme

ETH almak için Alchemy Sepolia musluğundaki(opens in a new tab) talimatları izleyin. Sepolia Ethereum adresinizi (MetaMask'ten) eklediğinizden ve başka bir ağda olmadığınızdan emin olun. Talimatları uyguladıktan sonra, cüzdanınıza ETH'yi alıp almadığınızı iki kez kontrol edin.

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

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'ü kurun (veya herhangi bir web3 kütüphanesi)

Alchemy Web3(opens in a new tab) indirmek için proje klasörünüzde şu komutu çalıştırın:

Ether.js kitaplığını kullanmak istiyorsanız buradaki talimatları izleyin(opens in a new tab).

1npm install @alch/alchemy-web3

5. Dotenv kurun

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 şunu ekleyin ("api-url" ve "your-private-key yerine" ")

  • Alchemy API URL'nizi bulmak için, kontrol panelinizde az önce oluşturduğunuz uygulamanın uygulama ayrıntıları sayfasına gidin, sağ üst köşedeki "View Key"'e (Anahtarı Görüntüle) 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"
.env taahhüt etmeyin! Lütfen .env dosyanızı asla kimseyle paylaşmadığınızdan veya ifşa etmediğinizden emin olun, çünkü bunu yaparken sırlarınızı tehlikeye atıyorsunuz. Sürüm kontrolü kullanıyorsanız, .env dosyanızı bir gitignore dosyasına ekleyin.

7. sendTx.js dosyası oluşturun

Harika, artık hassas verilerimizi bir .env dosyasında koruduğumuza göre kodlamaya başlayalım. Gönderme işlemi örneğimiz içi 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: replace this address with your own public address
7
8    const nonce = await web3.eth.getTransactionCount(myAddress, 'latest'); // nonce starts counting from 0
9
10    const transaction = {
11     'to': '0x31B98D14007bDEe637298086988A0bBd31184523', // faucet address to return eth
12     'value': 1000000000000000000, // 1 ETH
13     'gas': 30000,
14     'nonce': nonce,
15     // optional data field to send message or execute smart contract
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("🎉 The hash of your transaction is: ", hash, "\n Check Alchemy's Mempool to view the status of your transaction!");
23    } else {
24      console.log("❗Something went wrong while submitting your transaction:", 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 değeri şartnamesi, adresinizden gönderilen işlemlerin sayısını takip etmek için kullanılır. Güvenlik amaçlı ve tekrar saldırılarını(opens in a new tab) önlemek için buna ihtiyacımız var. Adresinizden gönderilmiş işlem sayısını almak için getTransactionCount(opens in a new tab) kullanırız.
  • transaction: İşlem nesnesinin belirtmemiz gereken birkaç yönü var
    • to: Bu, 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: Bu, 10^18 wei = 1 ETH olmak üzere wei'de belirtilen, göndermek istediğimiz miktardır
    • gas: İşleminize dahil edilecek doğru gaz miktarını belirlemenin birçok yolu vardır. Alchemy, benzin fiyatı belirli bir eşiğe düştüğünde sizi bilgilendirmek için bir gaz fiyatı web kancasına(opens in a new tab) bile sahiptir. Ana Ağ işlemlerinde, dahil edilecek doğru gaz miktarını belirlemek için ETH Gaz İstasyonu(opens in a new tab) gibi bir gaz tahmincisine göz atmak 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.
    • [OPTIONAL] veri: Transferinizle birlikte ek bilgi göndermek veya akıllı sözleşme aramak için kullanılır, bakiye transferleri için gerekli değildir, aşağıdaki nota bakın.
  • SignedTx: İşlem nesnemizi imzalamak için PRIVATE_KEY ile signTransaction yöntemini kullanacağız
  • sendSignedTransaction: İmzalanmış bir işlemimiz olduğunda, sendSignedTransaction kullanarak sonraki bir bloğa dahil edilmesi için gönderebiliriz

Veriler hakkında bir not Ethereum'da gönderilebilecek iki ana işlem türü vardır.

  • Bakiye transferi: Eth'i bir adresten diğerine gönderin. Herhangi bir veri alanı gerekli değildir, ancak işleminizin yanında ek bilgiler göndermek isterseniz, bu bilgileri 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 daha sonra veri gibi görünmelidir: 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: Zincirde bazı akıllı sözleşme kodlarını yürütün. Bu durumda veri alanı, herhangi bir parametrenin yanında yürütmek istediğiniz akıllı fonksiyonu içermelidir.

8. node sendTx.js kullanarak kodu ç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 Bellek Havuzunda görün

Alchemy panelinizde Mempool sayfasını(opens in a new tab) (Bellek Havuzu) açın ve işleminizi bulmak için oluşturduğunuz uygulama ile filtreleyin. Bekleme durumundan kazılmış (başarılıysa) veya başarısız olursa düşmüş duruma geçişimizi buradan izleyebiliriz. "mined" (kazılmış), "beklemede" (pending) ve "düşmüş" işlemleri yakalamak için "All" (Tümü) üzerinde tuttuğunuzdan emin olun. 0x31b98d14007bdee637298086988a0bbd31184523 adresine gönderilen işlemlere bakarak da işleminizi arayabilirsiniz.

İşleminizin ayrıntılarını bulduktan sonra görüntülemek için, sizi şuna benzeyen bir görünüme götürecek tx hash değerini seçin:

Bellek Havuzu 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 rehberle ilgili geri bildirim ve öneriler için lütfen Alchemy'nin Discord(opens in a new tab)'u üzerinden Elan'a mesaj gönderin!

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

Bu rehber yararlı oldu mu?