caver.rpc.klay

caver.rpc.klay cung cấp lệnh gọi JSON-RPC với không gian tên klay.

caver.rpc.klay.tài khoảnCreated

caver.rpc.klay.tài khoảnCreated(address [, blockNumber] [, callback])

Trả về true nếu tài khoản được liên kết với địa chỉ được tạo trong nền tảng chuỗi khối Klaytn. Nếu không sẽ trả về false.

Tham số

TêntypeMô tả

address

chuỗi

Địa chỉ của tài khoản mà bạn muốn truy vấn nếu tài khoản đã được tạo trong mạng.

blockNumber

số \

chuỗi

callback

hàm

(tùy chọn) Hàm callback tùy chọn trả về một đối tượng lỗi làm tham số thứ nhất và kết quả làm tham số thứ hai.

Giá trị trả về

Promise trả về boolean

typeMô tả

boolean

Có địa chỉ đầu vào trong Klaytn.

Ví dụ

> caver.rpc.klay.tài khoảnCreated('0x{address in hex}').then(console.log)
true

caver.rpc.klay.getAccount

caver.rpc.klay.getAccount(address [, blockNumber] [, callback])

Trả về thông tin tài khoản của một địa chỉ nhất định trong Klaytn. Để biết thêm chi tiết về các loại tài khoản trong Klaytn, vui lòng tham khảo [Các loại tài khoản Klaytn](../../../../../klaytn/design/tài khoảns.md#klaytn-tài khoản-types).

LƯU Ý caver.rpc.klay.getAccount trả về tài khoản tồn tại trên mạng, nếu tài khoản khớp với địa chỉ không tồn tại trên mạng chuỗi khối thực tế, hàm sẽ trả về null.

Tham số

TêntypeMô tả

address

chuỗi

Địa chỉ của tài khoản mà bạn muốn có thông tin tài khoản.

blockNumber

số \

chuỗi

callback

hàm

(tùy chọn) Hàm callback tùy chọn trả về một đối tượng lỗi làm tham số thứ nhất và kết quả làm tham số thứ hai.

Giá trị trả về

Promise trả về đối tượng

LoạiMô tả

đối tượng

Một đối tượng chứa thông tin tài khoản. Mỗi loại tài khoản sẽ có các thuộc tính khác nhau.

Ví dụ

// Nhận tài khoản với EOA
> caver.rpc.klay.getAccount('0x{address in hex}').then(console.log)
{
    accType: 1,
    tài khoản: {
        nonce: 0,
        balance: '0x',
        humanReadable: false,
        key: { keyType: 1, key: {} }
    }
}

// Nhận tài khoản với SCA
> caver.rpc.klay.getAccount('0x{address in hex}').then(console.log)
{
    accType: 2,
    tài khoản: {
        nonce: 1,
        balance: '0x0',
        humanReadable: false,
        key: { keyType: 3, key: {} },
        storageRoot: '0xd0ce6b9ba63cf727d48833bcaf69f398bb353e9a5b6235ac5bb3a8e95ff90ecf',
        codeHash: '7pemrmP8fcguH/ut/SYHJoUSecfUIcUyeCpMf0sBYVI=',
        codeFormat: 0
    }
}

caver.rpc.klay.getAccountKey

caver.rpc.klay.getAccountKey(address [, blockNumber] [, callback])

Trả về AccountKey của một địa chỉ đã cho. Nếu tài khoản có [AccountKeyLegacy](../../../../../klaytn/design/tài khoảns.md#tài khoảnkeylegacy) hoặc tài khoản của địa chỉ đã cho là [Tài khoản hợp đồng thông minh](../../../../../klaytn/design/tài khoảns.md#smart-contract-tài khoảns-scas), tài khoản đó sẽ trả về một giá trị khóa trống. Vui lòng tham khảo [Khóa tài khoản](../../../../../klaytn/design/tài khoảns.md#tài khoản-key) để biết thêm thông tin chi tiết.

LƯU Ý caver.rpc.klay.getAccountKey trả về một đối tượng khác nhau theo từng loại AccountKey. Nếu tài khoản Klaytn khớp với địa chỉ đã cho không tồn tại trong mạng thì sẽ trả về null.

Tham số

TênLoạiMô tả

address

chuỗi

Địa chỉ của tài khoản Klaytn mà bạn muốn lấy một đối tượng của thông tin AccountKey.

blockNumber

số \

chuỗi

callback

hàm

(tùy chọn) Hàm callback tùy chọn trả về một đối tượng lỗi làm tham số thứ nhất và kết quả làm tham số thứ hai.

Giá trị trả về

Promise trả về đối tượng

LoạiMô tả

đối tượng

Một đối tượng chứa thông tin AccountKey. Mỗi loại AccountKey sẽ có các thuộc tính khác nhau.

Ví dụ

// Loại AccountKey: AccountKeyLegacy
> caver.rpc.klay.getAccountKey('0x{address in hex}').then(console.log)
{ keyType: 1, key: {} }

// Loại AccountKey: AccountKeyPublic
> caver.rpc.klay.getAccountKey('0x{address in hex}').then(console.log)
{
    keyType: 2,
    key: { x:'0xb9a4b...', y:'0x7a285...' }
}

// Loại AccountKey: AccountKeyFail
> caver.rpc.klay.getAccountKey('0x{address in hex}').then(console.log)
{ keyType: 3, key:{} }

// Loại AccountKey: AccountKeyWeightedMultiSig
> caver.rpc.klay.getAccountKey('0x{address in hex}').then(console.log)
{
    keyType: 4,
    key: {
        threshold: 2,
        keys: [
            {
                weight: 1,
                key: { x: '0xae6b7...', y: '0x79ddf...' }
            },
            {
                weight: 1,
                key: { x: '0xd4256...', y: '0xfc5e7...' }
            },
            {
                weight: 1,
                key: { x: '0xd653e...', y: '0xe974e...' }
            }
        ]
    }
}

// Loại AccountKey: AccountKeyRoleBased
> caver.rpc.klay.getAccountKey('0x{address in hex}').then(console.log)
{
    keyType: 5,
    key: [
            {
                key: { x: '0x81965...', y: '0x18242...' },
                keyType: 2
            },
            {
                key: { x: '0x73363...', y: '0xfc3e3...' },
                keyType: 2
            },
            {
                key: { x: '0x95c92...', y: '0xef783...' },
                keyType: 2
            }
    ]
}

caver.rpc.klay.encodeAccountKey

caver.rpc.klay.encodeAccountKey(tài khoảnKey [, callback])

Mã hóa một đối tượng chứa thông tin AccountKey bằng sơ đồ mã hóa Tiền tố độ dài đệ quy (RLP). Ngoài ra, bạn có thể sử dụng [tài khoản.getRLPEncodingAccountKey](../caver.tài khoản.md#tài khoản-getrlpencodingtài khoảnkey) để lấy AccountKey được mã hóa bằng RLP.

Tham số

TênLoạiMô tả

tài khoảnKey

đối tượng

Một đối tượng xác định keyType và khóa bên trong hoặc một phiên bản của AccountKey ([AccountKeyLegacy](../caver.tài khoản.md#tài khoảnkeylegacy), [AccountKeyPublic](../caver.tài khoản.md#tài khoảnkeypublic), [AccountKeyFail](../caver.tài khoản.md#tài khoảnkeyfail), [AccountKeyWeightedMultiSig](../caver.tài khoản.md#tài khoảnkeyweightedmultisig) hoặc [AccountKeyRoleBased](../caver.tài khoản.md#tài khoảnkeyrolebased)).

callback

hàm

(tùy chọn) Hàm callback tùy chọn trả về một đối tượng lỗi làm tham số thứ nhất và kết quả làm tham số thứ hai.

Giá trị trả về

Promise trả về chuỗi

LoạiMô tả

chuỗi

AccountKey được mã hóa RLP.

Ví dụ

// Loại AccountKey: AccountKeyLegacy
> caver.rpc.klay.encodeAccountKey({ keyType: 1, key: {} }).then(console.log)
0x01c0

// Loại AccountKey: AccountKeyPublic
> caver.rpc.klay.encodeAccountKey({
        keyType: 2,
        key: {
            x: '0xdbac81e8486d68eac4e6ef9db617f7fbd79a04a3b323c982a09cdfc61f0ae0e8',
            y: '0x906d7170ba349c86879fb8006134cbf57bda9db9214a90b607b6b4ab57fc026e',
        },
    }).then(console.log)
0x02a102dbac81e8486d68eac4e6ef9db617f7fbd79a04a3b323c982a09cdfc61f0ae0e8

// Loại AccountKey: AccountKeyFail
> caver.rpc.klay.encodeAccountKey({ keyType: 3, key: {} }).then(console.log)
0x03c0

// Loại AccountKey: AccountKeyWeightedMultiSig
> caver.rpc.klay.encodeAccountKey({
        keyType: 4,
        key: {
            threshold: 2,
            keys: [
                {
                    weight: 1,
                    key: {
                        x: '0xc734b50ddb229be5e929fc4aa8080ae8240a802d23d3290e5e6156ce029b110e',
                        y: '0x61a443ac3ffff164d1fb3617875f07641014cf17af6b7dc38e429fe838763712',
                    },
                },
                {
                    weight: 1,
                    key: {
                        x: '0x12d45f1cc56fbd6cd8fc877ab63b5092ac77db907a8a42c41dad3e98d7c64dfb',
                        y: '0x8ef355a8d524eb444eba507f236309ce08370debaa136cb91b2f445774bff842',
                    },
                },
            ],
        },
    }).then(console.log)
0x04f84b02f848e301a102c734b50ddb229be5e929fc4aa8080ae8240a802d23d3290e5e6156ce029b110ee301a10212d45f1cc56fbd6cd8fc877ab63b5092ac77db907a8a42c41dad3e98d7c64dfb

// Loại AccountKey: AccountKeyRoleBased
> caver.rpc.klay.encodeAccountKey({
        keyType: 5,
        key: [
            {
                keyType: 2,
                key: {
                    x: '0xe4a01407460c1c03ac0c82fd84f303a699b210c0b054f4aff72ff7dcdf01512d',
                    y: '0xa5735a23ce1654b14680054a993441eae7c261983a56f8e0da61280758b5919',
                },
            },
            {
                keyType: 4,
                key: {
                    threshold: 2,
                    keys: [
                        {
                            weight: 1,
                            key: {
                                x: '0xe4a01407460c1c03ac0c82fd84f303a699b210c0b054f4aff72ff7dcdf01512d',
                                y: '0xa5735a23ce1654b14680054a993441eae7c261983a56f8e0da61280758b5919',
                            },
                        },
                        {
                            weight: 1,
                            key: {
                                x: '0x36f6355f5b532c3c1606f18fa2be7a16ae200c5159c8031dd25bfa389a4c9c06',
                                y: '0x6fdf9fc87a16ac359e66d9761445d5ccbb417fb7757a3f5209d713824596a50d',
                            },
                        },
                    ],
                },
            },
            {
                keyType: 2,
                key: {
                    x: '0xc8785266510368d9372badd4c7f4a94b692e82ba74e0b5e26b34558b0f081447',
                    y: '0x94c27901465af0a703859ab47f8ae17e54aaba453b7cde5a6a9e4a32d45d72b2',
                },
            },
        ],
    }).then(console.log)
0x05f898a302a103e4a01407460c1c03ac0c82fd84f303a699b210c0b054f4aff72ff7dcdf01512db84e04f84b02f848e301a103e4a01407460c1c03ac0c82fd84f303a699b210c0b054f4aff72ff7dcdf01512de301a10336f6355f5b532c3c160

// Sử dụng một phiên bản AccountKey
> const tài khoảnKey = caver.tài khoản.create('0x{address in hex}', '0xf1d2e...').tài khoảnKey
> caver.rpc.klay.encodeAccountKey(tài khoảnKey).then(console.log)
0x02a102f1d2e558cfa07151534cd406b1ac5c25d99e9c1cf925328d14fd15c6fe50df27

caver.rpc.klay.decodeAccountKey

caver.rpc.klay.decodeAccountKey(encodedKey [, callback])

Giải mã AccountKey được mã hóa RLP. Ngoài ra, bạn có thể sử dụng [caver.tài khoản.tài khoảnKey.decode](../caver.tài khoản.md#caver-tài khoản-tài khoảnkey-decode) để giải mã AccountKey được mã hóa bằng RLP.

Tham số

TênLoạiMô tả

encodedKey

chuỗi

AccountKey được mã hóa RLP.

callback

hàm

(tùy chọn) Hàm callback tùy chọn trả về một đối tượng lỗi làm tham số thứ nhất và kết quả làm tham số thứ hai.

Giá trị trả về

Promise trả về đối tượng

LoạiMô tả

đối tượng

Một đối tượng xác định keyType và Key bên trong.

Ví dụ

// Loại AccountKey: AccountKeyLegacy
> caver.rpc.klay.decodeAccountKey('0x01c0').then(console.log)
{ keyType: 1, key: {} }

// Loại AccountKey: AccountKeyPublic
> caver.rpc.klay.decodeAccountKey('0x02a102dbac81e8486d68eac4e6ef9db617f7fbd79a04a3b323c982a09cdfc61f0ae0e8').then(console.log)
{
    keyType: 2,
    key: {
        x: '0xdbac81e8486d68eac4e6ef9db617f7fbd79a04a3b323c982a09cdfc61f0ae0e8',
        y: '0x906d7170ba349c86879fb8006134cbf57bda9db9214a90b607b6b4ab57fc026e',
    },
}

// Loại AccountKey: AccountKeyFail
> caver.rpc.klay.decodeAccountKey('0x03c0').then(console.log)
{ keyType: 3, key: {} }

// Loại AccountKey: AccountKeyWeightedMultiSig
> caver.rpc.klay.decodeAccountKey('0x04f84b02f848e301a102c734b50ddb229be5e929fc4aa8080ae8240a802d23d3290e5e6156ce029b110ee301a10212d45f1cc56fbd6cd8fc877ab63b5092ac77db907a8a42c41dad3e98d7c64dfb').then(console.log)
{
    keyType: 4,
    key: {
        threshold: 2,
        keys: [
            {
                weight: 1,
                key: {
                    x: '0xc734b50ddb229be5e929fc4aa8080ae8240a802d23d3290e5e6156ce029b110e',
                    y: '0x61a443ac3ffff164d1fb3617875f07641014cf17af6b7dc38e429fe838763712',
                },
            },
            {
                weight: 1,
                key: {
                    x: '0x12d45f1cc56fbd6cd8fc877ab63b5092ac77db907a8a42c41dad3e98d7c64dfb',
                    y: '0x8ef355a8d524eb444eba507f236309ce08370debaa136cb91b2f445774bff842',
                },
            },
        ],
    },
}


// Loại AccountKey: AccountKeyRoleBased
> caver.rpc.klay.decodeAccountKey('0x05f898a302a103e4a01407460c1c03ac0c82fd84f303a699b210c0b054f4aff72ff7dcdf01512db84e04f84b02f848e301a103e4a01407460c1c03ac0c82fd84f303a699b210c0b054f4aff72ff7dcdf01512de301a10336f6355f5b532c3c160').then(console.log)
{
    keyType: 5,
    key: [
        {
            keyType: 2,
            key: {
                x: '0xe4a01407460c1c03ac0c82fd84f303a699b210c0b054f4aff72ff7dcdf01512d',
                y: '0xa5735a23ce1654b14680054a993441eae7c261983a56f8e0da61280758b5919',
            },
        },
        {
            keyType: 4,
            key: {
                threshold: 2,
                keys: [
                    {
                        weight: 1,
                        key: {
                            x: '0xe4a01407460c1c03ac0c82fd84f303a699b210c0b054f4aff72ff7dcdf01512d',
                            y: '0xa5735a23ce1654b14680054a993441eae7c261983a56f8e0da61280758b5919',
                        },
                    },
                    {
                        weight: 1,
                        key: {
                            x: '0x36f6355f5b532c3c1606f18fa2be7a16ae200c5159c8031dd25bfa389a4c9c06',
                            y: '0x6fdf9fc87a16ac359e66d9761445d5ccbb417fb7757a3f5209d713824596a50d',
                        },
                    },
                ],
            },
        },
        {
            keyType: 2,
            key: {
                x: '0xc8785266510368d9372badd4c7f4a94b692e82ba74e0b5e26b34558b0f081447',
                y: '0x94c27901465af0a703859ab47f8ae17e54aaba453b7cde5a6a9e4a32d45d72b2',
            },
        },
    ],
}

caver.rpc.klay.getBalance

caver.rpc.klay.getBalance(address [, blockNumber] [, callback])

Trả về số dư tài khoản của địa chỉ đã cho trong Klaytn.

Tham số

TênLoạiMô tả

address

chuỗi

Địa chỉ của tài khoản mà bạn muốn lấy số dư.

blockNumber

số \

chuỗi

callback

hàm

(tùy chọn) Hàm callback tùy chọn trả về một đối tượng lỗi làm tham số thứ nhất và kết quả làm tham số thứ hai.

Giá trị trả về

Promise trả về chuỗi

LoạiMô tả

chuỗi

Số dư hiện tại cho địa chỉ đã cho bằng peb.

Ví dụ

> caver.rpc.klay.getBalance('0x{address in hex}').then(console.log)
0xde0b6b3a7640000

caver.rpc.klay.getCode

caver.rpc.klay.getCode(address [, blockNumber] [, callback])

Trả về mã ở địa chỉ đã cho.

Tham số

TênLoạiMô tả

address

chuỗi

Địa chỉ nơi để nhận mã.

blockNumber

số \

chuỗi

callback

hàm

(tùy chọn) Hàm callback tùy chọn trả về một đối tượng lỗi làm tham số thứ nhất và kết quả làm tham số thứ hai.

Giá trị trả về

Promise trả về chuỗi

LoạiMô tả

chuỗi

Mã từ địa chỉ đã cho.

Ví dụ

> caver.rpc.klay.getCode('0x{address in hex}').then(console.log)
0x60806...

caver.rpc.klay.getTransactionCount

caver.rpc.klay.getTransactionCount(address [, blockNumber] [, callback])

Trả về tổng số lượng giao dịch đã gửi từ một địa chỉ.

Tham số

TênLoạiMô tả

address

chuỗi

Địa chỉ nơi để nhận số lượng giao dịch.

blockNumber

số \

chuỗi

callback

hàm

(tùy chọn) Hàm callback tùy chọn trả về một đối tượng lỗi làm tham số thứ nhất và kết quả làm tham số thứ hai.

Giá trị trả về

Promise trả về chuỗi

LoạiMô tả

chuỗi

Số lượng giao dịch đã gửi từ địa chỉ nhất định ở dạng hex.

Ví dụ

> caver.rpc.klay.getTransactionCount('0x{address in hex}').then(console.log)
0x5f

caver.rpc.klay.isContractAccount

caver.rpc.klay.isContractAccount(address [, blockNumber] [, callback])

Trả về true nếu tài khoản đầu vào có codeHash không trống vào thời điểm có số khối cụ thể. Trả về false nếu tài khoản là EOA hoặc tài khoản hợp đồng thông minh không có codeHash. Vui lòng tham khảo [Tài khoản hợp đồng thông minh](../../../../../klaytn/design/tài khoảns.md#smart-contract-tài khoảns-scas) để biết thêm thông tin chi tiết.

Tham số

TêntypeMô tả

address

chuỗi

Địa chỉ mà bạn muốn kiểm tra isContractAccount.

blockNumber

số \

chuỗi

callback

hàm

(tùy chọn) Hàm callback tùy chọn trả về một đối tượng lỗi làm tham số thứ nhất và kết quả làm tham số thứ hai.

Giá trị trả về

Promise trả về boolean

LoạiMô tả

boolean

true có nghĩa là tham số đầu vào là một địa chỉ hợp đồng thông minh hiện có.

Ví dụ

> caver.rpc.klay.isContractAccount('0x{address in hex}').then(console.log)
false

> caver.rpc.klay.isContractAccount('0x{address in hex}').then(console.log)
true

caver.rpc.klay.sign

caver.rpc.klay.sign(address, message [, blockNumber] [, callback])

Tạo dữ liệu đã ký dành riêng cho Klaytn. Tham khảo [API Nền tảng Klaytn - klay_sign](../../../../json-rpc/api-references/klay/tài khoản.md#klay_sign) để biết cách tạo chữ ký.

LƯU Ý: API này cung cấp chức năng ký thông báo bằng cách sử dụng tài khoản đã nhập trong nút Klaytn của bạn. Tài khoản đã nhập trong nút của bạn phải được [mở khóa](../../../../json-rpc/api-references/personal.md#personal_unlocktài khoản) để ký thông báo. Để ký giao dịch bằng tài khoản đã nhập trong nút Klaytn của bạn, hãy sử dụng caver.rpc.klay.signTransaction.

Tham số

TênLoạiMô tả

address

Chuỗi

Địa chỉ của tài khoản đã nhập để ký thông báo.

thông báo

Chuỗi

Tin nhắn có thể ký.

blockNumber

số \

chuỗi

callback

hàm

(tùy chọn) Hàm callback tùy chọn trả về một đối tượng lỗi làm tham số thứ nhất và kết quả làm tham số thứ hai.

Giá trị trả về

Promise trả về chuỗi

LoạiMô tả

chuỗi

Chữ ký được thực hiện từ một tài khoản đã nhập.

Ví dụ

> caver.rpc.klay.sign('0x{address in hex}', '0xdeadbeaf').then(console.log)
0x1066e052c4be821daa4d0a0cd1e9e75ccb200bb4001c2e38853ba41b712a5a226da2acd67c86a13b266e0d75d0a6e7d1551c8924af413267615a5948617c746c1c

caver.rpc.klay.getAccounts

caver.rpc.klay.getAccounts([callback])

Trả về danh sách các địa chỉ thuộc sở hữu của Nút Klaytn.

Tham số

TênLoạiMô tả

callback

hàm

(tùy chọn) Hàm callback tùy chọn trả về một đối tượng lỗi làm tham số thứ nhất và kết quả làm tham số thứ hai.

Giá trị trả về

Promise trả về Mảng

typeMô tả

Mảng

Một mảng các địa chỉ thuộc sở hữu của Nút Klaytn.

Ví dụ

> caver.rpc.klay.getAccounts().then(console.log)
[
    '0xe1531e916857d1b3a7db92f9187b96a7b43813bf',
    '0x75331c25535052157ff5110ba7d0cf940d3a9ca6'
]

caver.rpc.klay.getBlockNumber

caver.rpc.klay.getBlockNumber([callback])

Trả về số của khối gần đây nhất.

Tham số

TênLoạiMô tả

callback

hàm

(tùy chọn) Hàm callback tùy chọn trả về một đối tượng lỗi làm tham số thứ nhất và kết quả làm tham số thứ hai.

Giá trị trả về

Promise trả về chuỗi

LoạiMô tả

chuỗi

Số của khối mới nhất ở dạng hex.

Ví dụ

> caver.rpc.klay.getBlockNumber().then(console.log)
0x5d39

caver.rpc.klay.getHeader

caver.rpc.klay.getHeader(blockNumberOrHash [, callback])

Trả về tiêu đề khối theo hàm băm khối hoặc số khối. Nếu người dùng chuyển hàm băm khối dưới dạng tham số, caver.rpc.klay.getHeaderByHash sẽ được gọi ra và nếu số khối được gọi dưới dạng tham số thì caver.rpc.klay.getHeaderByNumber sẽ được gọi ra.

Tham số

TêntypeMô tả

blockNumberOrHash

số \

chuỗi

callback

hàm

(tùy chọn) Hàm callback tùy chọn trả về một đối tượng lỗi làm tham số thứ nhất và kết quả làm tham số thứ hai.

Giá trị trả về

Promise trả về đối tượng

LoạiMô tả

đối tượng

Một đối tượng tiêu đề khối. Để biết mô tả chi tiết về giá trị trả về, vui lòng tham khảo caver.rpc.klay.getHeaderByHash.

Ví dụ

> caver.rpc.klay.getHeader(1).then(console.log)
{
  baseFeePerGas: '0x0',
  blockScore: '0x1',
  extraData: '0xd8830...',
  gasUsed: '0x0',
  governanceData: '0x',
  hash: '0x1b6582f0908add2221317288482aada596551e9f9d779a2aebc55d81d3149ba3',
  nhật kýBloom: '0x00000...',
  number: '0xbacd3',
  parentHash: '0xd6e36611a6722b94b8e4bb4d164755445409cf43aa5db0a5d4ae01e621c81ce7',
  receiptsRoot: '0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470',
  reward: '0x30be91c80566da777d30e659b6746174ecc61576',
  stateRoot: '0xe75d808889451b1dac3d209e8cfbb2159ea6b2a080ce6081be775fb426f047a8',
  timestamp: '0x62201975',
  timestampFoS: '0x0',
  transactionsRoot: '0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470'
}

caver.rpc.klay.getHeaderByNumber

caver.rpc.klay.getHeaderByNumber(blockNumber [, returnTransactionObjects] [, callback])

Trả về tiêu đề khối theo số khối.

Tham số

TênLoạiMô tả

blockNumber

số \

chuỗi

callback

hàm

(tùy chọn) Hàm callback tùy chọn trả về một đối tượng lỗi làm tham số thứ nhất và kết quả làm tham số thứ hai.

Giá trị trả về

Promise trả về đối tượng

LoạiMô tả

đối tượng

Một đối tượng tiêu đề khối. Để biết mô tả chi tiết về giá trị trả về, vui lòng tham khảo caver.rpc.klay.getHeaderByHash.

Ví dụ

> caver.rpc.klay.getHeaderByNumber(765139).then(console.log)
{
  baseFeePerGas: '0x0',
  blockScore: '0x1',
  extraData: '0xd8830...',
  gasUsed: '0x0',
  governanceData: '0x',
  hash: '0x1b6582f0908add2221317288482aada596551e9f9d779a2aebc55d81d3149ba3',
  nhật kýBloom: '0x00000...',
  number: '0xbacd3',
  parentHash: '0xd6e36611a6722b94b8e4bb4d164755445409cf43aa5db0a5d4ae01e621c81ce7',
  receiptsRoot: '0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470',
  reward: '0x30be91c80566da777d30e659b6746174ecc61576',
  stateRoot: '0xe75d808889451b1dac3d209e8cfbb2159ea6b2a080ce6081be775fb426f047a8',
  timestamp: '0x62201975',
  timestampFoS: '0x0',
  transactionsRoot: '0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470'
}

caver.rpc.klay.getHeaderByHash

caver.rpc.klay.getHeaderByHash(blockHash [, returnTransactionObjects] [, callback])

Trả về số khối của khối mới nhất bằng cách sử dụng blockHash.

Tham số

TênLoạiMô tả

blockHash

chuỗi

Hàm băm khối.

callback

hàm

(tùy chọn) Hàm callback tùy chọn trả về một đối tượng lỗi làm tham số thứ nhất và kết quả làm tham số thứ hai.

Giá trị trả về

Promise trả về đối tượng - Một đối tượng bao gồm tiêu đề khối:

TênLoạiMô tả

baseFeePerGas

chuỗi

Phí cơ bản trên mỗi đơn vị gas. Giá trị này chỉ được trả về khi EthTxTypeCompatibleBlock được kích hoạt cho số khối đó.

blockScore

chuỗi

Độ khó khai thác trong mạng blockchain. Việc sử dụng blockScore khác với cơ chế đồng thuận của mạng. Giá trị luôn là 1 trong công cụ đồng thuận BFT.

extraData

chuỗi

Trường "dữ liệu bổ sung" của khối này.

gasUsed

chuỗi

Tổng lượng gas đã được sử dụng bởi tất cả các giao dịch trong khối này.

governanceData

chuỗi

Cấu hình quản trị được mã hóa RLP

hash

chuỗi

Hàm băm của một khối. null khi đó là khối đang chờ xử lý.

nhật kýBloom

chuỗi

Bộ lọc Bloom cho các bản ghi của khối. null khi đó là khối đang chờ xử lý.

số

chuỗi

Số khối. null khi đó là khối đang chờ xử lý.

parentHash

chuỗi

Hàm băm của khối cha mẹ.

receiptsRoot

chuỗi

Gốc của trie biên lai giao dịch của khối.

phần thưởng

chuỗi

Địa chỉ của người thụ hưởng đã được trao phần thưởng khối.

stateRoot

chuỗi

Gốc của trie trạng thái cuối trong khối.

dấu thời gian

chuỗi

Dấu thời gian unix khi khối được đối chiếu.

timestampFoS

chuỗi

Phần giây của dấu thời gian khi khối được đối chiếu.

transactionsRoot

chuỗi

Gốc của trie giao dịch trong khối.

Ví dụ

> caver.rpc.klay.getHeaderByHash('0x1b6582f0908add2221317288482aada596551e9f9d779a2aebc55d81d3149ba3').then(console.log)
{
  baseFeePerGas: '0x0',
  blockScore: '0x1',
  extraData: '0xd8830...',
  gasUsed: '0x0',
  governanceData: '0x',
  hash: '0x1b6582f0908add2221317288482aada596551e9f9d779a2aebc55d81d3149ba3',
  nhật kýBloom: '0x00000...',
  number: '0xbacd3',
  parentHash: '0xd6e36611a6722b94b8e4bb4d164755445409cf43aa5db0a5d4ae01e621c81ce7',
  receiptsRoot: '0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470',
  reward: '0x30be91c80566da777d30e659b6746174ecc61576',
  stateRoot: '0xe75d808889451b1dac3d209e8cfbb2159ea6b2a080ce6081be775fb426f047a8',
  timestamp: '0x62201975',
  timestampFoS: '0x0',
  transactionsRoot: '0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470'
}

caver.rpc.klay.getBlock

caver.rpc.klay.getBlock(blockNumberOrHash [, returnTransactionObjects] [, callback])

Trả về thông tin của một khối theo hàm băm khối hoặc số khối. Nếu người dùng chuyển hàm băm khối dưới dạng tham số, caver.rpc.klay.getBlockByHash sẽ được gọi ra và nếu số khối được gọi dưới dạng tham số thì caver.rpc.klay.getBlockByNumber sẽ được gọi ra.

Tham số

TênLoạiMô tả

blockNumberOrHash

số \

chuỗi

returnTransactionObjects

boolean

(tùy chọn, mặc định false) Nếu true, khối được trả về sẽ chứa tất cả giao dịch dưới dạng đối tượng và khối sẽ chỉ chứa các hàm băm giao dịch nếu trả về false.

callback

hàm

(tùy chọn) Hàm callback tùy chọn trả về một đối tượng lỗi làm tham số thứ nhất và kết quả làm tham số thứ hai.

Giá trị trả về

Promise trả về đối tượng

LoạiMô tả

đối tượng

Một đối tượng khối. Để biết mô tả chi tiết về giá trị trả về, vui lòng tham khảo caver.rpc.klay.getBlockByHash.

Ví dụ

> caver.rpc.klay.getBlock(1).then(console.log)
{
    baseFeePerGas: '0x0',
    blockscore: '0x1',
    extraData: '0xd8830...',
    gasUsed: '0x0',
    governanceData: '0x',
    hash: '0x58482921af951cf42a069436ac9338de50fd963bdbea40e396f416f9ac96a08b',
    nhật kýBloom: '0x00000...',
    number: '0x1',
    parentHash: '0x6b7c0a49f445d39b6d7dc9ba5b593b326f3a953e75ff1fcf64b9a5fa51c2725b',
    receiptsRoot: '0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470',
    reward: '0xddc2002b729676dfd906484d35bb02a8634d7040',
    size: '0x285',
    stateRoot: '0xb88b6110e6f73b732714bb346e6ff24beb480c0dc901a55be24e38ad1c6d5fa9',
    timestamp: '0x5ee7fe9f',
    timestampFoS: '0xd',
    totalBlockScore: '0x2',
    transactions: [],
    transactionsRoot: '0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470',
    voteData: '0x',
}

caver.rpc.klay.getBlockByNumber

caver.rpc.klay.getBlockByNumber(blockNumber [, returnTransactionObjects] [, callback])

Trả về thông tin của một khối theo số khối.

Tham số

TênLoạiMô tả

blockNumber

số \

chuỗi

returnTransactionObjects

boolean

(tùy chọn, mặc định false) Nếu true, khối được trả về sẽ chứa tất cả giao dịch dưới dạng đối tượng và khối sẽ chỉ chứa các hàm băm giao dịch nếu trả về false.

callback

hàm

(tùy chọn) Hàm callback tùy chọn trả về một đối tượng lỗi làm tham số thứ nhất và kết quả làm tham số thứ hai.

Giá trị trả về

Promise trả về đối tượng

LoạiMô tả

đối tượng

Một đối tượng khối. Để biết mô tả chi tiết về giá trị trả về, hãy tham khảo caver.rpc.klay.getBlockByHash.

Ví dụ

> caver.rpc.klay.getBlockByNumber(1).then(console.log)
{
    baseFeePerGas: '0x0',
    blockscore: '0x1',
    extraData: '0xd8830...',
    gasUsed: '0x0',
    governanceData: '0x',
    hash: '0x58482921af951cf42a069436ac9338de50fd963bdbea40e396f416f9ac96a08b',
    nhật kýBloom: '0x00000...',
    number: '0x1',
    parentHash: '0x6b7c0a49f445d39b6d7dc9ba5b593b326f3a953e75ff1fcf64b9a5fa51c2725b',
    receiptsRoot: '0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470',
    reward: '0xddc2002b729676dfd906484d35bb02a8634d7040',
    size: '0x285',
    stateRoot: '0xb88b6110e6f73b732714bb346e6ff24beb480c0dc901a55be24e38ad1c6d5fa9',
    timestamp: '0x5ee7fe9f',
    timestampFoS: '0xd',
    totalBlockScore: '0x2',
    transactions: [],
    transactionsRoot: '0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470',
    voteData: '0x'
}

caver.rpc.klay.getBlockByHash

caver.rpc.klay.getBlockByHash(blockHash [, returnTransactionObjects] [, callback])

Trả về số khối của khối mới nhất bằng cách sử dụng blockHash.

Tham số

TênLoạiMô tả

blockHash

chuỗi

Hàm băm khối.

returnTransactionObjects

boolean

(tùy chọn, mặc định false) Nếu true, khối được trả về sẽ chứa tất cả giao dịch dưới dạng đối tượng và khối sẽ chỉ chứa các hàm băm giao dịch nếu trả về false.

callback

hàm

(tùy chọn) Hàm callback tùy chọn trả về một đối tượng lỗi làm tham số thứ nhất và kết quả làm tham số thứ hai.

Giá trị trả về

Promise trả về đối tượng - Một đối tượng bao gồm khối:

TênLoạiMô tả

baseFeePerGas

chuỗi

Phí cơ bản trên mỗi đơn vị gas. Giá trị này chỉ được trả về khi EthTxTypeCompatibleBlock được kích hoạt cho số khối đó.

blockScore

chuỗi

Độ khó khai thác trong mạng blockchain. Việc sử dụng blockScore khác với cơ chế đồng thuận của mạng. Giá trị luôn là 1 trong công cụ đồng thuận BFT.

extraData

chuỗi

Trường "dữ liệu bổ sung" của khối này.

gasUsed

chuỗi

Tổng lượng gas đã được sử dụng bởi tất cả các giao dịch trong khối này.

governanceData

chuỗi

Cấu hình quản trị được mã hóa RLP

hash

chuỗi

Hàm băm của một khối. null khi đó là khối đang chờ xử lý.

nhật kýBloom

chuỗi

Bộ lọc Bloom cho các bản ghi của khối. null khi đó là khối đang chờ xử lý.

số

chuỗi

Số khối. null khi đó là khối đang chờ xử lý.

parentHash

chuỗi

Hàm băm của khối cha mẹ.

receiptsRoot

chuỗi

Gốc của trie biên lai giao dịch của khối.

phần thưởng

chuỗi

Địa chỉ của người thụ hưởng đã được trao phần thưởng khối.

kích thước

chuỗi

Số nguyên chỉ kích thước của khối này theo byte.

stateRoot

chuỗi

Gốc của trie trạng thái cuối trong khối.

dấu thời gian

chuỗi

Dấu thời gian unix khi khối được đối chiếu.

timestampFoS

chuỗi

Phần giây của dấu thời gian khi khối được đối chiếu.

totalBlockScore

chuỗi

Giá trị nguyên chỉ tổng số blockScore của chuỗi cho đến khối này.

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ố returnTransactionObjects.

transactionsRoot

chuỗi

Gốc của trie giao dịch trong khối.

voteData

chuỗi

Phiếu bầu quản trị được mã hóa RLP của người đề xuất.

Ví dụ

> caver.rpc.klay.getBlockByHash('0x58482921af951cf42a069436ac9338de50fd963bdbea40e396f416f9ac96a08b').then(console.log)
{
    baseFeePerGas: '0x0',
    blockscore: '0x1',
    extraData: '0xd8830...',
    gasUsed: '0x0',
    governanceData: '0x',
    hash: '0x58482921af951cf42a069436ac9338de50fd963bdbea40e396f416f9ac96a08b',
    nhật kýBloom: '0x00000...',
    number: '0x1',
    parentHash: '0x6b7c0a49f445d39b6d7dc9ba5b593b326f3a953e75ff1fcf64b9a5fa51c2725b',
    receiptsRoot: '0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470',
    reward: '0xddc2002b729676dfd906484d35bb02a8634d7040',
    size: '0x285',
    stateRoot: '0xb88b6110e6f73b732714bb346e6ff24beb480c0dc901a55be24e38ad1c6d5fa9',
    timestamp: '0x5ee7fe9f',
    timestampFoS: '0xd',
    totalBlockScore: '0x2',
    transactions: [],
    transactionsRoot: '0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470',
    voteData: '0x'
}

caver.rpc.klay.getBlockReceipts

caver.rpc.klay.getBlockReceipts(blockHash [, callback])

Trả về các biên lai được gộp vào khối được xác định bằng hàm băm khối.

Tham số

TênLoạiMô tả

blockHash

chuỗi

Hàm băm khối.

callback

hàm

(tùy chọn) Hàm callback tùy chọn trả về một đối tượng lỗi làm tham số thứ nhất và kết quả làm tham số thứ hai.

Giá trị trả về

Promise trả về Mảng

typeMô tả

Mảng

Biên lai giao dịch được đưa vào một khối. Nếu khối mục tiêu không chứa giao dịch, thì hàm sẽ trả về một mảng trống []. Để biết mô tả chi tiết về biên lai giao dịch, hãy tham khảo caver.rpc.klay.getTransactionReceipt.

Ví dụ

> caver.rpc.klay.getBlockReceipts('0x4584bea6b8b2abe7f024d1e63dd0571cfd28cd5157b4f6cb2ac4160a7b0057e0').then(console.log)
[ 
    {
        blockHash: '0x4584bea6b8b2abe7f024d1e63dd0571cfd28cd5157b4f6cb2ac4160a7b0057e0',
        blockNumber: '0x5301',
        contractAddress: null,
        from: '0xddc2002b729676dfd906484d35bb02a8634d7040',
        gas: '0x61a8',
        gasPrice: '0x5d21dba00',
        gasUsed: '0x5208',
        nhật ký: [],
        nhật kýBloom: '0x00000...',
        nonce: '0x5e',
        senderTxHash: '0x413f080a498ae3973490c2f80e75e6a492cfcdac8be8051220bb7a964768d28c',
        signatures: [
            { 
                V: '0x4e44',
                R: '0x98583ffa8d9a6d5f9e60e4daebb33f18e8ad4d32653c4a2fa7f12ce025af763d',
                S: '0x9b9e5257293e3b986842b6a203dd16ce46f16ed42dd3e9592fcaab9ea2696cb'
            }    
        ],
        trạng thái: '0x1',
        to: '0xc0aabc441129991dd3a9363a9a43b745527ea4e7',
        transactionHash: '0x413f080a498ae3973490c2f80e75e6a492cfcdac8be8051220bb7a964768d28c',
        transactionIndex: '0x0',
        type: 'TxTypeValueTransfer',
        typeInt: 8,
        value: '0xde0b6b3a7640000'
    }
]

caver.rpc.klay.getBlockTransactionCountByNumber

caver.rpc.klay.getBlockTransactionCountByNumber(blockNumber [, callback])

Trả về số lượng giao dịch trong một khối khớp với số khối đã cho.

Tham số

TênLoạiMô tả

blockNumber

số \

chuỗi

callback

hàm

(tùy chọn) Hàm callback tùy chọn trả về một đối tượng lỗi làm tham số thứ nhất và kết quả làm tham số thứ hai.

Giá trị trả về

Promise trả về chuỗi

LoạiMô tả

chuỗi

Số lượng giao dịch trong khối nhất định ở dạng hex.

Ví dụ

> caver.rpc.klay.getBlockTransactionCountByNumber(21249).then(console.log)
0x1

caver.rpc.klay.getBlockTransactionCountByHash

caver.rpc.klay.getBlockTransactionCountByHash(blockHash [, callback])

Trả về số lượng giao dịch trong một khối khớp với hàm băm khối đã cho.

Tham số

TêntypeMô tả

blockHash

chuỗi

Hàm băm khối.

callback

hàm

(tùy chọn) Hàm callback tùy chọn trả về một đối tượng lỗi làm tham số thứ nhất và kết quả làm tham số thứ hai.

Giá trị trả về

Promise trả về chuỗi

typeMô tả

chuỗi

Số lượng giao dịch trong khối nhất định ở dạng hex.

Ví dụ

> caver.rpc.klay.getBlockTransactionCountByHash('0x4584bea6b8b2abe7f024d1e63dd0571cfd28cd5157b4f6cb2ac4160a7b0057e0').then(console.log)
0x1

caver.rpc.klay.getBlockWithConsensusInfoByNumber

caver.rpc.klay.getBlockWithConsensusInfoByNumber(blockNumber [, callback])

Trả về một khối có thông tin đồng thuận khớp với số khối đã cho.

Tham số

TênLoạiMô tả

blockNumber

số \

chuỗi

callback

hàm

(tùy chọn) Hàm callback tùy chọn trả về một đối tượng lỗi làm tham số thứ nhất và kết quả làm tham số thứ hai.

Giá trị trả về

Promise trả về đối tượng