Zum Hauptinhalt springen
Change page

JavaScript-API-Bibliotheken

Letzte Aktualisierung der Seite: 25. Februar 2026

PhintisP (opens in a new tab)
MajorDom_DePINM (opens in a new tab)
KaptainBolloK (opens in a new tab)
+24

Damit eine Web-App mit der Ethereum-Blockchain interagieren kann (d. h. Blockchain-Daten lesen und/oder Transaktionen an das Netzwerk senden), muss sie sich mit einem Ethereum-Blockchain-Knoten verbinden.

Zu diesem Zweck implementiert jede Ethereum-Anwendung die JSON-RPC-Spezifikation, sodass es eine einheitliche Reihe von Methoden gibt, auf die sich Anwendungen verlassen können.

Wenn Sie JavaScript verwenden möchten, um sich mit einem Ethereum-Blockchain-Knoten zu verbinden, ist es möglich, reines JavaScript zu verwenden. Es gibt jedoch mehrere praktische Bibliotheken im Ökosystem, die dies viel einfacher machen. Mit diesen Bibliotheken können Entwickler intuitive, einzeilige Methoden schreiben, um JSON-RPC-Anfragen (im Hintergrund) zu initialisieren, die mit Ethereum interagieren.

Bitte beachten Sie, dass seit The Merge zwei verbundene Teile der Ethereum-Software – ein Ausführungs-Client und ein Konsens-Client – erforderlich sind, um einen Blockchain-Knoten auszuführen. Bitte stellen Sie sicher, dass Ihr Blockchain-Knoten sowohl einen Ausführungs- als auch einen Konsens-Client enthält. Wenn sich Ihr Blockchain-Knoten nicht auf Ihrem lokalen Computer befindet (z. B. wenn Ihr Blockchain-Knoten auf einer AWS-Instanz läuft), aktualisieren Sie die IP-Adressen im Tutorial entsprechend. Weitere Informationen finden Sie auf unserer Seite zum Ausführen eines Blockchain-Knotens.

Voraussetzungen

Neben dem Verständnis von JavaScript könnte es hilfreich sein, den Ethereum-Stack und Ethereum-Anwendungen zu verstehen.

Warum eine Bibliothek verwenden?

Diese Bibliotheken abstrahieren einen Großteil der Komplexität der direkten Interaktion mit einem Ethereum-Blockchain-Knoten. Sie bieten auch Hilfsfunktionen (z. B. die Umwandlung von ETH in Gwei), sodass Sie als Entwickler weniger Zeit mit den Feinheiten von Ethereum-Anwendungen verbringen müssen und sich mehr auf die einzigartige Funktionalität Ihrer Anwendung konzentrieren können.

Funktionen der Bibliothek

Mit Ethereum-Blockchain-Knoten verbinden

Mithilfe von Providern ermöglichen Ihnen diese Bibliotheken, sich mit Ethereum zu verbinden und dessen Daten zu lesen, sei es über JSON-RPC, INFURA, Etherscan, Alchemy oder MetaMask.

Warnung: Web3.js wurde am 4. März 2025 archiviert. Lesen Sie die Ankündigung (opens in a new tab). Erwägen Sie für neue Projekte die Verwendung alternativer Bibliotheken wie ethers.js (opens in a new tab) oder viem (opens in a new tab).

Ethers-Beispiel

1// Ein BrowserProvider kapselt einen Standard-Web3-Provider, welcher
2// das ist, was MetaMask als window.ethereum in jede Seite einfügt
3const provider = new ethers.BrowserProvider(window.ethereum)
4
5// Das MetaMask-Plugin erlaubt auch das Signieren von Transaktionen, um
6// Ether zu senden und zu bezahlen, um den Zustand innerhalb der Blockchain zu ändern.
7// Dafür benötigen wir den Account-Signer...
8const signer = provider.getSigner()

Web3js-Beispiel

1var web3 = new Web3("http://localhost:8545")
2// oder
3var web3 = new Web3(new Web3.providers.HttpProvider("http://localhost:8545"))
4
5// Provider wechseln
6web3.setProvider("ws://localhost:8546")
7// oder
8web3.setProvider(new Web3.providers.WebsocketProvider("ws://localhost:8546"))
9
10// Verwendung des IPC-Providers in node.js
11var net = require("net")
12var web3 = new Web3("/Users/myuser/Library/Ethereum/geth.ipc", net) // Mac OS Pfad
13// oder
14var web3 = new Web3(
15  new Web3.providers.IpcProvider("/Users/myuser/Library/Ethereum/geth.ipc", net)
16) // Mac OS Pfad
17// unter Windows ist der Pfad: "\\\\.\\pipe\\geth.ipc"
18// unter Linux ist der Pfad: "/users/myuser/.ethereum/geth.ipc"
Alle anzeigen

Sobald dies eingerichtet ist, können Sie die Blockchain abfragen nach:

  • Blocknummern
  • Gasschätzungen
  • Smart-Contract-Ereignissen
  • Netzwerk-ID
  • und mehr ...

Wallet-Funktionalität

Diese Bibliotheken bieten Ihnen Funktionen zum Erstellen von Wallets, Verwalten von Schlüsseln und Signieren von Transaktionen.

Hier ist ein Beispiel von Ethers

1// Erstelle eine Wallet-Instanz aus einem Mnemonic...
2mnemonic =
3  "announce room limb pattern dry unit scale effort smooth jazz weasel alcohol"
4walletMnemonic = Wallet.fromPhrase(mnemonic)
5
6// ...oder aus einem privaten Schlüssel
7walletPrivateKey = new Wallet(walletMnemonic.privateKey)
8
9walletMnemonic.address === walletPrivateKey.address
10// true
11
12// Die Adresse als Promise gemäß der Signer-API
13walletMnemonic.getAddress()
14// { Promise: '0x71CB05EE1b1F506fF321Da3dac38f25c0c9ce6E1' }
15
16// Eine Wallet-Adresse ist auch synchron verfügbar
17walletMnemonic.address
18// '0x71CB05EE1b1F506fF321Da3dac38f25c0c9ce6E1'
19
20// Die internen kryptografischen Komponenten
21walletMnemonic.privateKey
22// '0x1da6847600b0ee25e9ad9a52abbd786dd2502fa4005dd5af9310b7cc7a3b25db'
23walletMnemonic.publicKey
24// '0x04b9e72dfd423bcf95b3801ac93f4392be5ff22143f9980eb78b3a860c4843bfd04829ae61cdba4b3b1978ac5fc64f5cc2f4350e35a108a9c9a92a81200a60cd64'
25
26// Das Wallet-Mnemonic
27walletMnemonic.mnemonic
28// {
29// locale: 'en',
30// path: 'm/44\'/60\'/0\'/0/0',
31// phrase: 'announce room limb pattern dry unit scale effort smooth jazz weasel alcohol'
32// }
33
34// Hinweis: Eine mit einem privaten Schlüssel erstellte Wallet hat
35// kein Mnemonic (die Ableitung verhindert dies)
36walletPrivateKey.mnemonic
37// null
38
39// Signieren einer Nachricht
40walletMnemonic.signMessage("Hello World")
41// { Promise: '0x14280e5885a19f60e536de50097e96e3738c7acae4e9e62d67272d794b8127d31c03d9cd59781d4ee31fb4e1b893bd9b020ec67dfa65cfb51e2bdadbb1de26d91c' }
42
43tx = {
44  to: "0x8ba1f109551bD432803012645Ac136ddd64DBA72",
45  value: utils.parseEther("1.0"),
46}
47
48// Signieren einer Transaktion
49walletMnemonic.signTransaction(tx)
50// { Promise: '0xf865808080948ba1f109551bd432803012645ac136ddd64dba72880de0b6b3a7640000801ca0918e294306d177ab7bd664f5e141436563854ebe0a3e523b9690b4922bbb52b8a01181612cec9c431c4257a79b8c9f0c980a2c49bb5a0e6ac52949163eeb565dfc' }
51
52// Die connect-Methode gibt eine neue Instanz der
53// Wallet zurück, die mit einem Provider verbunden ist
54wallet = walletMnemonic.connect(provider)
55
56// Abfragen des Netzwerks
57wallet.getBalance()
58// { Promise: { BigNumber: "42" } }
59wallet.getTransactionCount()
60// { Promise: 0 }
61
62// Senden von Ether
63wallet.sendTransaction(tx)
Alle anzeigen

Lesen Sie die vollständige Dokumentation (opens in a new tab)

Sobald dies eingerichtet ist, können Sie:

  • Konten erstellen
  • Transaktionen senden
  • Transaktionen signieren
  • und mehr ...

Mit Smart-Contract-Funktionen interagieren

JavaScript-Client-Bibliotheken ermöglichen es Ihrer Anwendung, Smart-Contract-Funktionen aufzurufen, indem sie das Application Binary Interface (ABI) eines kompilierten Vertrags lesen.

Das ABI erklärt im Wesentlichen die Funktionen des Vertrags in einem JSON-Format und ermöglicht es Ihnen, ihn wie ein normales JavaScript-Objekt zu verwenden.

Der folgende Solidity-Vertrag:

1contract Test {
2    uint a;
3    address d = 0x12345678901234567890123456789012;
4
5    constructor(uint testInt)  { a = testInt;}
6
7    event Event(uint indexed b, bytes32 c);
8
9    event Event2(uint indexed b, bytes32 c);
10
11    function foo(uint b, bytes32 c) returns(address) {
12        Event(b, c);
13        return d;
14    }
15}
Alle anzeigen

Würde zu folgendem JSON führen:

1[{
2    "type":"constructor",
3    "payable":false,
4    "stateMutability":"nonpayable"
5    "inputs":[{"name":"testInt","type":"uint256"}],
6  },{
7    "type":"function",
8    "name":"foo",
9    "constant":false,
10    "payable":false,
11    "stateMutability":"nonpayable",
12    "inputs":[{"name":"b","type":"uint256"}, {"name":"c","type":"bytes32"}],
13    "outputs":[{"name":"","type":"address"}]
14  },{
15    "type":"event",
16    "name":"Event",
17    "inputs":[{"indexed":true,"name":"b","type":"uint256"}, {"indexed":false,"name":"c","type":"bytes32"}],
18    "anonymous":false
19  },{
20    "type":"event",
21    "name":"Event2",
22    "inputs":[{"indexed":true,"name":"b","type":"uint256"},{"indexed":false,"name":"c","type":"bytes32"}],
23    "anonymous":false
24}]
Alle anzeigen

Das bedeutet, Sie können:

  • Eine Transaktion an den Smart Contract senden und seine Methode ausführen
  • Einen Aufruf tätigen, um das Gas zu schätzen, das eine Methodenausführung bei der Ausführung in der Ethereum Virtual Machine benötigt
  • Einen Vertrag bereitstellen
  • Und mehr ...

Hilfsfunktionen

Hilfsfunktionen bieten Ihnen praktische Verknüpfungen, die das Entwickeln mit Ethereum etwas einfacher machen.

ETH-Werte sind standardmäßig in Wei angegeben. 1 ETH = 1.000.000.000.000.000.000 WEI – das bedeutet, Sie haben es mit vielen Zahlen zu tun! web3.utils.toWei wandelt Ether für Sie in Wei um.

Und in Ethers sieht das so aus:

1// Abrufen des Guthabens eines Accounts (über Adresse oder ENS-Namen)
2balance = await provider.getBalance("ethers.eth")
3// { BigNumber: "2337132817842795605" }
4
5// Oft müssen Sie die Ausgabe für den Benutzer formatieren,
6// der es vorzieht, Werte in Ether (anstelle von Wei) zu sehen
7ethers.utils.formatEther(balance)
8// '2.337132817842795605'

Verfügbare Bibliotheken

Web3.js – Ethereum-JavaScript-API.

Ethers.js – Vollständige Ethereum-Wallet-Implementierung und Hilfsprogramme in JavaScript und TypeScript.

The Graph – Ein Protokoll zur Indizierung von Ethereum- und IPFS-Daten und deren Abfrage mittels GraphQL.

Alchemy SDK – Wrapper um Ethers.js mit erweiterten APIs.

viem – TypeScript-Schnittstelle für Ethereum.

Codex – Echtzeit-API für angereicherte Blockchain-Daten über Dutzende von Chains hinweg.

Drift – TypeScript-Meta-Bibliothek mit integriertem Caching, Hooks und Test-Mocks.

Weiterführende Literatur

Kennen Sie eine Community-Ressource, die Ihnen geholfen hat? Bearbeiten Sie diese Seite und fügen Sie sie hinzu!

Verwandte Themen

Verwandte Tutorials

Tutorials: JavaScript-APIs & WebSockets auf Ethereum

  • WebSockets verwenden – Wie man WebSockets mit Alchemy verwendet, um Ethereum-Ereignisse zu abonnieren und JSON-RPC-Anfragen in Echtzeit zu stellen.

War dieser Artikel hilfreich?