JSON-RPC — eth_ Ad Alanı

QoreChain, tamamen EVM uyumlu bir JSON-RPC arayüzü uygular ve standart Ethereum araçlarının (MetaMask, Hardhat, Foundry, ethers.js, web3.js) zincirle herhangi bir değişiklik olmadan etkileşime girmesini sağlar.

Bağlantı

Taşıma	Varsayılan Adres
HTTP	http://localhost:8545
WebSocket	ws://localhost:8546

not

EVM JSON-RPC arayüzü, qorechain-vladi ana ağı (EVM zincir kimliği 9801, hex 0x2649, v3.1.85 zincir sürümünde canlı) ve qorechain-diana test ağı (EVM zincir kimliği 9800, hex 0x2648) tarafından sunulur. Yukarıdaki yerel adresler kendi çalıştırdığınız bir düğüm için geçerlidir; uzaktan erişim için sağlayıcınızın ana ağ veya test ağı uç noktasını kullanın.

Desteklenen Ad Alanları

Ad Alanı	Açıklama
eth_	Temel Ethereum JSON-RPC yöntemleri
web3_	Yardımcı yöntemler (istemci sürümü, karma alma)
net_	Ağ durumu yöntemleri
txpool_	İşlem havuzu incelemesi
qor_	QoreChain'e özgü uzantılar (bkz. qor_ Ad Alanı)

eth_ Yöntemleri

Yöntem	Parametreler	Açıklama
eth_blockNumber	yok	En son blok numarasını döndürür
eth_getBalance	address, blockNumber	Bir adresin bakiyesini wei cinsinden döndürür
eth_getTransactionCount	address, blockNumber	Bir adres için nonce'u (işlem sayısı) döndürür
eth_sendRawTransaction	signedTxData	Yayımlanmak üzere imzalı bir işlem gönderir
eth_call	callObject, blockNumber	EVM'e karşı salt okunur bir çağrı yürütür
eth_estimateGas	callObject	Bir işlem için gereken gazı tahmin eder
eth_getBlockByNumber	blockNumber, fullTx (bool)	Numaraya göre blok verisini döndürür
eth_getTransactionByHash	txHash	Karmaya göre işlem verisini döndürür
eth_getTransactionReceipt	txHash	Madenciliği yapılmış bir işlemin makbuzunu döndürür
eth_getLogs	filterObject	Bir filtreyle eşleşen günlükleri döndürür
eth_chainId	yok	Zincir kimliğini döndürür (hex kodlu)
eth_gasPrice	yok	Mevcut gaz fiyatını wei cinsinden döndürür
eth_feeHistory	blockCount, newestBlock, rewardPercentiles	Geçmiş ücret verisini döndürür (EIP-1559)

web3_ Yöntemleri

Yöntem	Parametreler	Açıklama
web3_clientVersion	yok	İstemci sürümü dizesini döndürür
web3_sha3	data (hex)	Girdinin Keccak-256 karmasını döndürür

net_ Yöntemleri

Yöntem	Parametreler	Açıklama
net_version	yok	Ağ kimliğini döndürür
net_listening	yok	Düğüm dinliyorsa true döndürür
net_peerCount	yok	Bağlı eş sayısını döndürür (hex)

Yapılandırma

JSON-RPC sunucusunu app.toml dosyasında etkinleştirin ve yapılandırın:

[json-rpc]
# Enable the JSON-RPC server
enable = true

# HTTP server address
address = "0.0.0.0:8545"

# WebSocket server address
ws-address = "0.0.0.0:8546"

# Enabled API namespaces
api = "eth,web3,net,txpool,qor"

# Maximum number of logs returned by eth_getLogs
filter-cap = 10000

# Maximum gas for eth_call and eth_estimateGas
gas-cap = 25000000

# EVM execution timeout
evm-timeout = "5s"

# Transaction fee cap (in QOR)
txfee-cap = 1

# Maximum open WebSocket connections
max-open-connections = 0

Örnekler

eth_blockNumber

İstek:

curl -X POST http://localhost:8545 \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_blockNumber",
    "params": [],
    "id": 1
  }'

Yanıt:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x53b35"
}

eth_chainId

İstek:

curl -X POST http://localhost:8545 \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_chainId",
    "params": [],
    "id": 2
  }'

Yanıt (ana ağ qorechain-vladi, zincir kimliği 9801):

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": "0x2649"
}

qorechain-diana test ağında (zincir kimliği 9800) bu yöntem "0x2648" döndürür.

eth_getBalance

İstek:

curl -X POST http://localhost:8545 \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getBalance",
    "params": ["0x742d35Cc6634C0532925a3b844Bc9e7595f2bD28", "latest"],
    "id": 3
  }'

Yanıt:

{
  "jsonrpc": "2.0",
  "id": 3,
  "result": "0x56bc75e2d63100000"
}

ethers.js ile Bağlanma

import { ethers } from "ethers";

const provider = new ethers.JsonRpcProvider("http://localhost:8545");

// Get latest block
const block = await provider.getBlockNumber();
console.log("Latest block:", block);

// Get balance
const balance = await provider.getBalance("0x742d35Cc6634C0532925a3b844Bc9e7595f2bD28");
console.log("Balance:", ethers.formatEther(balance), "QOR");

bilgi

• Zincir kimliği bir hex dizesi olarak döndürülür. Cüzdan yapılandırması için ondalığa çevirin — 0x2649, 9801'dir (ana ağ), 0x2648 ise 9800'dür (test ağı).
• Gaz fiyatlandırması EIP-1559 modelini izler. Temel ücret ve öncelik ücreti tahmini için eth_feeHistory kullanın.
• Kabul edilen blok etiketleri: "latest", "earliest", "pending" veya bir hex blok numarası.
• Filtre sınırlamaları: eth_getLogs, sorgu başına filter-cap sonuçla sınırlıdır (varsayılan 10.000). Büyük veri kümeleri için daha dar blok aralıkları kullanın.