Khối
Tham số khối mặc định
Khi gửi một yêu cầu API chứa không gian tên eth
, chiều cao khối do tham số defaultBlock
xác định.
Tham số defaultBlock
có thể có các tùy chọn như sau:
HEX String
- số khối là giá trị nguyênString "earliest"
cho khối sớm nhất/khởi nguyênString "latest"
- cho khối đã đào mới nhấtString "pending"
- cho trạng thái/giao dịch đang chờ xử lý
eth_blockNumber
Trả về số của khối gần đây nhất.
Tham số
Không có
Giá trị trả về
SỐ LƯỢNG
Giá trị nguyên của số khối hiện tại mà máy khách đang kết nối đến.
Ví dụ
eth_getHeaderByNumber
Trả về thông tin tiêu đề theo số.
Vui lòng xem phần Caution-Header trước khi sử dụng API này.
Tham số
SỐ LƯỢNG | THẺ
Số khối số nguyên hoặc thập lục phân hoặc chuỗi "earliest"
, "latest"
hoặc "pending"
như trong tham số khối mặc định hoặc hàm băm khối.
Giá trị trả về
Tham khảo eth_getHeaderByHash
Ví dụ
eth_getHeaderByHash
Trả về thông tin tiêu đề theo hàm băm.
Vui lòng xem phần Caution-Header trước khi sử dụng API này.
Tham số
DỮ LIỆU 32 byte
Hàm băm của một khối.
Giá trị trả về
Object
- Đối tượng tiêu đề hoặc null
khi không tìm thấy tiêu đề. Nếu không, hàm sẽ trả về lỗi.
baseFeePerGas
SỐ LƯỢNG
Phí cơ bản trên mỗi đơn vị gas.
difficulty
SỐ LƯỢNG
Giá trị nguyên chỉ độ khó của khối này.
extraData
DATA
Trường "dữ liệu bổ sung" của khối này.
gasLimit
SỐ LƯỢNG
Số đơn vị gas tối đa được phép trong khối này.
gasUsed
SỐ LƯỢNG
Tổng số gas đã được sử dụng bởi tất cả các giao dịch trong khối này.
hash
DỮ LIỆU 32 byte
Hàm băm của một khối. null
nếu đó là khối đang chờ xử lý.
nhật kýBloom
DỮ LIỆU 256 byte
Bộ lọc Bloom cho các bản ghi của khối.
miner
DỮ LIỆU 20 byte
Địa chỉ của người nhận đã được trao phần thưởng khai thác.
mixHash
DỮ LIỆU 32 byte
Hàm băm, khi kết hợp với số dùng một lần, chứng minh rằng một lượng tính toán đủ đã được thực hiện trên khối này.
số dùng một lần
DỮ LIỆU 8 byte
Hàm băm của thuật toán bằng chứng xử lý (PoW) được tạo ra.
number
SỐ LƯỢNG
Số khối. null
khi đó là khối đang chờ xử lý.
parentHash
DỮ LIỆU 32 byte
Hàm băm của khối cha mẹ.
receiptsRoot
DỮ LIỆU 32 byte
Gốc của trie biên lai giao dịch của khối.
sha3Uncles
DỮ LIỆU 32 byte
SHA3 của dữ liệu chú trong khối.
size
SỐ LƯỢNG
Giá trị nguyên chỉ kích thước của khối này theo byte.
stateRoot
DỮ LIỆU 32 byte
Gốc của trie trạng thái cuối trong khối.
dấu thời gian
SỐ LƯỢNG
Dấu thời gian Unix khi khối được đối chiếu.
totalDifficulty
SỐ LƯỢNG
Tổng khối lượng tính toán trung bình của chuỗi cho đến khối này.
transactionsRoot
DỮ LIỆU 32 byte
Gốc của trie giao dịch trong khối.
Ví dụ
eth_getBlockByNumber
Trả về thông tin của một khối theo số khối.
Vui lòng xem phần Caution-Block trước khi sử dụng API này.
Tham số
SỐ LƯỢNG | THẺ
Số khối số nguyên hoặc thập lục phân hoặc chuỗi "earliest"
, "latest"
hoặc "pending"
như trong tham số khối mặc định hoặc hàm băm khối.
Boolean
Nếu true
thì sẽ trả về toàn bộ các đối tượng giao dịch, nếu false
thì chỉ trả về hàm băm của các giao dịch.ịch.
Giá trị trả về
Tham khảo eth_getBlockByHash
Ví dụ
eth_getBlockByHash
Trả về thông tin của một khối theo hàm băm.
Vui lòng xem phần Caution-Block trước khi sử dụng API này.
Tham số
DỮ LIỆU 32 byte
Hàm băm của một khối.
Boolean
Nếu true
thì sẽ trả về toàn bộ các đối tượng giao dịch, nếu false
thì chỉ trả về hàm băm của các giao dịch.ịch.
Giá trị trả về
Object
- Đối tượng khối hoặc null
khi không tìm thấy khối. Nếu không, hàm sẽ trả về lỗi.
baseFeePerGas
SỐ LƯỢNG
Phí cơ bản trên mỗi đơn vị gas.
difficulty
SỐ LƯỢNG
Giá trị nguyên chỉ độ khó của khối này
extraData
DATA
Trường "dữ liệu bổ sung" của khối này.
gasLimit
SỐ LƯỢNG
Số đơn vị gas tối đa được phép trong khối này.
gasUsed
SỐ LƯỢNG
Tổng số gas đã được sử dụng bởi tất cả các giao dịch trong khối này.
hash
DỮ LIỆU 32 byte
Hàm băm của một khối. null
khi đó là khối đang chờ xử lý.
nhật kýBloom
DỮ LIỆU 256 byte
Bộ lọc Bloom cho các bản ghi của khối. null
khi đó là khối đang chờ xử lý.
miner
DỮ LIỆU 20 byte
Địa chỉ của người nhận đã được trao phần thưởng khai thác.
mixHash
DỮ LIỆU 32 byte
Hàm băm, khi kết hợp với số dùng một lần, chứng minh rằng một lượng tính toán đủ đã được thực hiện trên khối này.
nonce
DỮ LIỆU 8 byte
Hàm băm của thuật toán bằng chứng xử lý (PoW) được tạo ra.
number
SỐ LƯỢNG
Số khối. null
nếu đó là khối đang chờ xử lý.
parentHash
DỮ LIỆU 32 byte
Hàm băm của khối cha mẹ.
receiptsRoot
DỮ LIỆU 32 byte
Gốc của trie biên lai giao dịch của khối.
sha3Uncles
DỮ LIỆU 32 byte
SHA3 của dữ liệu chú trong khối.
size
SỐ LƯỢNG
Giá trị nguyên chỉ kích thước của khối này theo byte.
stateRoot
DỮ LIỆU 32 byte
Gốc của trie trạng thái cuối trong khối.
dấu thời gian
SỐ LƯỢNG
Dấu thời gian Unix khi khối được đối chiếu.
totalDifficulty
SỐ LƯỢNG
Tổng blockScore của chuỗi cho đến khối này
transactionsRoot
DỮ LIỆU 32 byte
Gốc của trie giao dịch trong khối.
giao dịch
Mảng
Mảng đối tượng giao dịch hoặc hàm băm giao dịch 32 byte tùy thuộc vào tham số đã cho gần nhất.
uncles
Mảng
Mảng của các hàm băm chú.
Ví dụ
eth_getUncleByBlockHashAndIndex
Trả về thông tin của một mảng chú của khối theo hàm băm và vị trí chỉ mục của mảng chú. Do Klaytn không có mảng chú, nên giá trị trả về luôn là null
.
Tham số
DỮ LIỆU 32 byte
Hàm băm của một khối.
SỐ LƯỢNG
Vị trí chỉ mục của mảng chú.
Giá trị trả về null
Ví dụ
eth_getUncleByBlockNumberAndIndex
Trả về thông tin về một khối chú theo số và vị trí chỉ mục của khối chú. Vì Klaytn không có mảng chú, nên giá trị trả về luôn là null
.
Tham số
SỐ LƯỢNG | THẺ
Số khối số nguyên hoặc thập lục phân hoặc chuỗi "earliest"
, "latest"
hoặc "pending"
như trong tham số khối mặc định hoặc hàm băm khối.
SỐ LƯỢNG
Vị trí chỉ mục của mảng chú.
Giá trị trả về null
Ví dụ
eth_getBlockTransactionCountByNumber
Trả về số lượng giao dịch trong một khối khớp với số khối đã cho.
Tham số
SỐ LƯỢNG | THẺ
Số khối số nguyên hoặc thập lục phân hoặc chuỗi "earliest"
, "latest"
hoặc "pending"
như trong tham số khối mặc định hoặc hàm băm khối.
Giá trị trả về
SỐ LƯỢNG
Giá trị nguyên chỉ số lượng giao dịch trong khối này.
Ví dụ
eth_getBlockTransactionCountByHash
Trả về số lượng giao dịch trong một khối từ một khối khớp với hàm băm đã cho.
Tham số
DỮ LIỆU 32 byte
Hàm băm của một khối
Giá trị trả về
SỐ LƯỢNG
Giá trị nguyên chỉ số lượng giao dịch trong khối này.
Ví dụ
eth_getUncleCountByBlockNumber
Trả về số lượng mảng chú trong một khối từ một khối khớp với số khối đã cho. Do Klaytn không có mảng chú, nên giá trị trả về là 0x0
. Giá trị trả về là null
nếu không có khối khớp.
Tham số
SỐ LƯỢNG | THẺ
Số khối số nguyên hoặc thập lục phân hoặc chuỗi "earliest"
, "latest"
hoặc "pending"
như trong tham số khối mặc định hoặc hàm băm khối.
Giá trị trả về
SỐ LƯỢNG
Giá trị nguyên chỉ số lượng giao dịch trong khối này. Giá trị trả về là null
nếu không có khối khớp.
Ví dụ
eth_getUncleCountByBlockHash
Trả về số lượng mảng chú trong một khối từ một khối khớp với hàm băm của khối đã cho. Do Klaytn không có mảng chú, nên giá trị trả về là 0x0
. Giá trị trả về là null
nếu không có khối khớp.
Tham số
DỮ LIỆU 32 byte
Hàm băm của một khối
Giá trị trả về
SỐ LƯỢNG
Giá trị nguyên chỉ số lượng giao dịch trong khối này. Giá trị trả về là null
nếu không có khối khớp.
Ví dụ
eth_getStorageAt
Trả về giá trị từ vị trí lưu trữ tại một địa chỉ đã cho.
Tham số
DỮ LIỆU 20 byte
Địa chỉ kho lưu trữ.
SỐ LƯỢNG
Giá trị nguyên chỉ vị trí lưu trữ.
SỐ LƯỢNG | THẺ | HÀM BĂM
Số khối số nguyên hoặc thập lục phân hoặc chuỗi "earliest"
, "latest"
hoặc "pending"
như trong tham số khối mặc định hoặc hàm băm khối.
Giá trị trả về
DATA
Giá trị tại vị trí lưu trữ này.
Ví dụ
Việc tính toán vị trí chính xác sẽ tùy thuộc vào kho lưu trữ cần truy xuất. Xem xét hợp đồng sau được triển khai tại 0x295a70b2de5e3953354a6a8344e616ed314d7251
theo địa chỉ 0x391694e7e0b0cce554cb130d723a9d27458f9298
.
Truy xuất giá trị của pos0
rất đơn giản:
Việc truy xuất thành phần của bản đồ thì khó hơn. Vị trí của một thành phần trên bản đồ được tính bằng:
Điều này có nghĩa là để truy xuất kho lưu trữ trên pos1["0x391694e7e0b0cce554cb130d723a9d27458f9298"]
, chúng ta cần tính toán vị trí bằng:
Bạn có thể sử dụng bảng điều khiển Klaytn đi kèm với thư viện klay
để tính toán
Bây giờ sẽ lấy kho lưu trữ:
eth_mining
Giá trị trả về là true
nếu máy khách đang tích cực khai thác các khối mới.
LƯU Ý: Hiện tại, mọi nút đều ở chế độ khai thác mặc định để gửi lại giao dịch. Xin lưu ý rằng việc "khai thác" thực tế chỉ do các Nút đồng thuận (CN) thực hiện.
Tham số
Không có
Giá trị trả về
Boolean
true
nếu máy khách đang đào, nếu không thì là false
.
Ví dụ
eth_syncing
Trả về đối tượng với dữ liệu về trạng thái đồng bộ hóa hoặc false
.
Tham số
Không có
Giá trị trả về
Object|Boolean
, đối tượng có dữ liệu trạng thái đồng bộ hóa hoặc false
khi không đồng bộ hóa:
startingBlock
SỐ LƯỢNG
Khối nơi bắt đầu quá trình nhập (sẽ chỉ được đặt lại sau khi quá trình đồng bộ hóa đạt đỉnh).
currentBlock
SỐ LƯỢNG
Khối hiện tại, giống với eth_blockNumber
.
highestBlock
SỐ LƯỢNG
Khối dự đoán cao nhất.
pulledStates
SỐ LƯỢNG
Số lượng mục nhập trạng thái được xử lý cho đến hiện tại. Nếu chế độ đồng bộ hóa không ở chế độ "nhanh", giá trị trả về sẽ bằng 0.
knownStates
SỐ LƯỢNG
Số lượng các mục trạng thái đã biết vẫn cần được truy xuất. Nếu chế độ đồng bộ hóa không ở chế độ "nhanh", giá trị trả về sẽ bằng 0.
Ví dụ
Last updated