caver.rpc.klay
caver.rpc.klayklay 네임 스페이스를 가진 JSON-RPC API를 호출합니다.

caver.rpc.klay.accountCreated

1
caver.rpc.klay.accountCreated(address [, blockNumber] [, callback])
Copied!
입력된 주소의 계정이 Klaytn 블록체인 플랫폼(Klaytn)에 존재하는 경우 true를 반환합니다. 해당 주소의 계정이 존재하지 않으면 false를 반환합니다.
매개변수
이름
타입
설명
address
string
네트워크에 존재하는지 확인하고 싶은 계정 주소입니다.
blockNumber
number | string
(선택 사항) 블록 넘버, 또는 latest, earliest, pending 문자열 중 하나입니다. 이 값을 생략하면 latest가 기본값으로 사용됩니다.
callback
function
(선택 사항) 선택적 콜백(callback)은 오류 객체를 첫 번째 매개 변수로, 결과를 두 번째 매개 변수로 반환합니다.
리턴값
Promiseboolean을 반환합니다.
타입
설명
boolean
입력으로 받은 주소가 Klaytn에 존재하는지 여부를 반환합니다.
예시
1
> caver.rpc.klay.accountCreated('0x{address in hex}').then(console.log)
2
true
Copied!

caver.rpc.klay.getAccount

1
caver.rpc.klay.getAccount(address [, blockNumber] [, callback])
Copied!
입력으로 받은 Klaytn 계정 주소의 계정 정보를 반환합니다. Klaytn 계정 타입에 관한 자세한 내용은 Klaytn Account Types를 확인하십시오.
참고 caver.rpc.klay.getAccount 는 계정이 Klaytn에 있는 경우에만 계정을 반환하므로 주소와 일치하는 계정이 Klaytn 상에 존재하지 않으면 null 이 반환됩니다.
매개변수
이름
타입
설명
address
string
계정 정보를 알고 싶은 계정 주소입니다.
blockNumber
number | stringnumber | string
(선택 사항) 블록 넘버, 또는 latest, earliest, pending 문자열 중 하나입니다. 이 값을 생략하면 latest가 기본값으로 사용됩니다.
callback
function
(선택 사항) 선택적 콜백(callback)은 오류 객체를 첫 번째 매개 변수로, 결과를 두 번째 매개 변수로 반환합니다.
리턴값
Promiseobject를 반환합니다.
타입
설명
object
계정 정보를 담고 있는 객체입니다. 계정 유형에 따라 다른 속성을 반환합니다.
예시
1
// Get account with EOA
2
> caver.rpc.klay.getAccount('0x{address in hex}').then(console.log)
3
{
4
accType: 1,
5
account: {
6
nonce: 0,
7
balance: '0x',
8
humanReadable: false,
9
key: { keyType: 1, key: {} }
10
}
11
}
12
13
// Get account with SCA
14
> caver.rpc.klay.getAccount('0x{address in hex}').then(console.log)
15
{
16
accType: 2,
17
account: {
18
nonce: 1,
19
balance: '0x0',
20
humanReadable: false,
21
key: { keyType: 3, key: {} },
22
storageRoot: '0xd0ce6b9ba63cf727d48833bcaf69f398bb353e9a5b6235ac5bb3a8e95ff90ecf',
23
codeHash: '7pemrmP8fcguH/ut/SYHJoUSecfUIcUyeCpMf0sBYVI=',
24
codeFormat: 0
25
}
26
}
Copied!

caver.rpc.klay.getAccountKey

1
caver.rpc.klay.getAccountKey(address [, blockNumber] [, callback])
Copied!
주어진 주소의 AccountKey를 반환합니다. 입력으로 받은 주소 계정이 AccountKeyLegacy를 AccountKey로 갖고 있거나 계정이 스마트 컨트랙트 계정이면 빈 키 값을 반환합니다. 더 자세한 내용은 Account Key를 확인하십시오.
참고 caver.rpc.klay.getAccountKey는 각 AccountKey 타입에 따라 다른 객체를 반환합니다. 주어진 주소를 가진 계정이 Klaytn에 존재하지 않는다면 null을 반환합니다.
매개변수
이름
타입
설명
address
string
Klaytn 계정 주소입니다. 이 메서드를 실행하면 이 계정 주소의 AccountKey 정보가 담긴 객체를 얻습니다.
blockNumber
number | string
(선택 사항) 블록 넘버, 또는 latest, earliest, pending 문자열 중 하나입니다. 이 값을 생략하면 latest가 기본값으로 사용됩니다.
callback
function
(선택 사항) 선택적 콜백(callback)은 오류 객체를 첫 번째 매개 변수로, 결과를 두 번째 매개 변수로 반환합니다.
리턴값
Promiseobject를 반환합니다.
타입
설명
object
AccountKey 정보를 담고 있는 객체입니다. AccountKey 유형에 따라 다른 속성을 반환합니다.
예시
1
// AccountKey type: AccountKeyLegacy
2
> caver.rpc.klay.getAccountKey('0x{address in hex}').then(console.log)
3
{ keyType: 1, key: {} }
4
5
// AccountKey type: AccountKeyPublic
6
> caver.rpc.klay.getAccountKey('0x{address in hex}').then(console.log)
7
{
8
keyType: 2,
9
key: { x:'0xb9a4b...', y:'0x7a285...' }
10
}
11
12
// AccountKey type: AccountKeyFail
13
> caver.rpc.klay.getAccountKey('0x{address in hex}').then(console.log)
14
{ keyType: 3, key:{} }
15
16
// AccountKey type: AccountKeyWeightedMultiSig
17
> caver.rpc.klay.getAccountKey('0x{address in hex}').then(console.log)
18
{
19
keyType: 4,
20
key: {
21
threshold: 2,
22
keys: [
23
{
24
weight: 1,
25
key: { x: '0xae6b7...', y: '0x79ddf...' }
26
},
27
{
28
weight: 1,
29
key: { x: '0xd4256...', y: '0xfc5e7...' }
30
},
31
{
32
weight: 1,
33
key: { x: '0xd653e...', y: '0xe974e...' }
34
}
35
]
36
}
37
}
38
39
// AccountKey type: AccountKeyRoleBased
40
> caver.rpc.klay.getAccountKey('0x{address in hex}').then(console.log)
41
{
42
keyType: 5,
43
key: [
44
{
45
key: { x: '0x81965...', y: '0x18242...' },
46
keyType: 2
47
},
48
{
49
key: { x: '0x73363...', y: '0xfc3e3...' },
50
keyType: 2
51
},
52
{
53
key: { x: '0x95c92...', y: '0xef783...' },
54
keyType: 2
55
}
56
]
57
}
Copied!

caver.rpc.klay.encodeAccountKey

1
caver.rpc.klay.encodeAccountKey(accountKey [, callback])
Copied!
AccountKey 정보를 담고 있는 객체를 RLP(Recursive Length Prefix)로 인코딩합니다. account.getRLPEncodingAccountKey를 사용해도 RLP 인코딩된 AccountKey를 얻습니다.
매개변수
이름
타입
설명
accountKey
object
객체는 keyTypekey, 또는 AccountKey (AccountKeyLegacy, AccountKeyPublic, AccountKeyFail, AccountKeyWeightedMultiSig or AccountKeyRoleBased)의 인스턴스를 정의합니다.
callback
function
(선택 사항) 선택적 콜백(callback)은 오류 객체를 첫 번째 매개 변수로, 결과를 두 번째 매개 변수로 반환합니다.
리턴값
Promisestring을 반환합니다.
타입
설명
string
RLP로 인코딩된 AccountKey.
예시
1
// AccountKey type: AccountKeyLegacy
2
> caver.rpc.klay.encodeAccountKey({ keyType: 1, key: {} }).then(console.log)
3
0x01c0
4
5
// AccountKey type: AccountKeyPublic
6
> caver.rpc.klay.encodeAccountKey({
7
keyType: 2,
8
key: {
9
x: '0xdbac81e8486d68eac4e6ef9db617f7fbd79a04a3b323c982a09cdfc61f0ae0e8',
10
y: '0x906d7170ba349c86879fb8006134cbf57bda9db9214a90b607b6b4ab57fc026e',
11
},
12
}).then(console.log)
13
0x02a102dbac81e8486d68eac4e6ef9db617f7fbd79a04a3b323c982a09cdfc61f0ae0e8
14
15
// AccountKey type: AccountKeyFail
16
> caver.rpc.klay.encodeAccountKey({ keyType: 3, key: {} }).then(console.log)
17
0x03c0
18
19
// AccountKey type: AccountKeyWeightedMultiSig
20
> caver.rpc.klay.encodeAccountKey({
21
keyType: 4,
22
key: {
23
threshold: 2,
24
keys: [
25
{
26
weight: 1,
27
key: {
28
x: '0xc734b50ddb229be5e929fc4aa8080ae8240a802d23d3290e5e6156ce029b110e',
29
y: '0x61a443ac3ffff164d1fb3617875f07641014cf17af6b7dc38e429fe838763712',
30
},
31
},
32
{
33
weight: 1,
34
key: {
35
x: '0x12d45f1cc56fbd6cd8fc877ab63b5092ac77db907a8a42c41dad3e98d7c64dfb',
36
y: '0x8ef355a8d524eb444eba507f236309ce08370debaa136cb91b2f445774bff842',
37
},
38
},
39
],
40
},
41
}).then(console.log)
42
0x04f84b02f848e301a102c734b50ddb229be5e929fc4aa8080ae8240a802d23d3290e5e6156ce029b110ee301a10212d45f1cc56fbd6cd8fc877ab63b5092ac77db907a8a42c41dad3e98d7c64dfb
43
44
// AccountKey type: AccountKeyRoleBased
45
> caver.rpc.klay.encodeAccountKey({
46
keyType: 5,
47
key: [
48
{
49
keyType: 2,
50
key: {
51
x: '0xe4a01407460c1c03ac0c82fd84f303a699b210c0b054f4aff72ff7dcdf01512d',
52
y: '0xa5735a23ce1654b14680054a993441eae7c261983a56f8e0da61280758b5919',
53
},
54
},
55
{
56
keyType: 4,
57
key: {
58
threshold: 2,
59
keys: [
60
{
61
weight: 1,
62
key: {
63
x: '0xe4a01407460c1c03ac0c82fd84f303a699b210c0b054f4aff72ff7dcdf01512d',
64
y: '0xa5735a23ce1654b14680054a993441eae7c261983a56f8e0da61280758b5919',
65
},
66
},
67
{
68
weight: 1,
69
key: {
70
x: '0x36f6355f5b532c3c1606f18fa2be7a16ae200c5159c8031dd25bfa389a4c9c06',
71
y: '0x6fdf9fc87a16ac359e66d9761445d5ccbb417fb7757a3f5209d713824596a50d',
72
},
73
},
74
],
75
},
76
},
77
{
78
keyType: 2,
79
key: {
80
x: '0xc8785266510368d9372badd4c7f4a94b692e82ba74e0b5e26b34558b0f081447',
81
y: '0x94c27901465af0a703859ab47f8ae17e54aaba453b7cde5a6a9e4a32d45d72b2',
82
},
83
},
84
],
85
}).then(console.log)
86
0x05f898a302a103e4a01407460c1c03ac0c82fd84f303a699b210c0b054f4aff72ff7dcdf01512db84e04f84b02f848e301a103e4a01407460c1c03ac0c82fd84f303a699b210c0b054f4aff72ff7dcdf01512de301a10336f6355f5b532c3c160
87
88
// Use an AccountKey instance
89
> const accountKey = caver.account.create('0x{address in hex}', '0xf1d2e...').accountKey
90
> caver.rpc.klay.encodeAccountKey(accountKey).then(console.log)
91
0x02a102f1d2e558cfa07151534cd406b1ac5c25d99e9c1cf925328d14fd15c6fe50df27
Copied!

caver.rpc.klay.decodeAccountKey

1
caver.rpc.klay.decodeAccountKey(encodedKey [, callback])
Copied!
RLP 인코딩된 AccountKey를 디코딩 합니다. caver.account.accountKey.decode를 사용해도 RLP 인코딩된 AccountKey를 디코딩합니다.
매개변수
이름
타입
설명
encodedKey
string
RLP로 인코딩된 AccountKey.
callback
function
(선택 사항) 선택적 콜백(callback)은 오류 객체를 첫 번째 매개 변수로, 결과를 두 번째 매개 변수로 반환합니다.
리턴값
Promiseobject를 반환합니다.
타입
설명
object
내부에 keyTypekey가 정의된 객체입니다.
예시
1
// AccountKey type: AccountKeyLegacy
2
> caver.rpc.klay.decodeAccountKey('0x01c0').then(console.log)
3
{ keyType: 1, key: {} }
4
5
// AccountKey type: AccountKeyPublic
6
> caver.rpc.klay.decodeAccountKey('0x02a102dbac81e8486d68eac4e6ef9db617f7fbd79a04a3b323c982a09cdfc61f0ae0e8').then(console.log)
7
{
8
keyType: 2,
9
key: {
10
x: '0xdbac81e8486d68eac4e6ef9db617f7fbd79a04a3b323c982a09cdfc61f0ae0e8',
11
y: '0x906d7170ba349c86879fb8006134cbf57bda9db9214a90b607b6b4ab57fc026e',
12
},
13
}
14
15
// AccountKey type: AccountKeyFail
16
> caver.rpc.klay.decodeAccountKey('0x03c0').then(console.log)
17
{ keyType: 3, key: {} }
18
19
// AccountKey type: AccountKeyWeightedMultiSig
20
> caver.rpc.klay.decodeAccountKey('0x04f84b02f848e301a102c734b50ddb229be5e929fc4aa8080ae8240a802d23d3290e5e6156ce029b110ee301a10212d45f1cc56fbd6cd8fc877ab63b5092ac77db907a8a42c41dad3e98d7c64dfb').then(console.log)
21
{
22
keyType: 4,
23
key: {
24
threshold: 2,
25
keys: [
26
{
27
weight: 1,
28
key: {
29
x: '0xc734b50ddb229be5e929fc4aa8080ae8240a802d23d3290e5e6156ce029b110e',
30
y: '0x61a443ac3ffff164d1fb3617875f07641014cf17af6b7dc38e429fe838763712',
31
},
32
},
33
{
34
weight: 1,
35
key: {
36
x: '0x12d45f1cc56fbd6cd8fc877ab63b5092ac77db907a8a42c41dad3e98d7c64dfb',
37
y: '0x8ef355a8d524eb444eba507f236309ce08370debaa136cb91b2f445774bff842',
38
},
39
},
40
],
41
},
42
}
43
44
45
// AccountKey type: AccountKeyRoleBased
46
> caver.rpc.klay.decodeAccountKey('0x05f898a302a103e4a01407460c1c03ac0c82fd84f303a699b210c0b054f4aff72ff7dcdf01512db84e04f84b02f848e301a103e4a01407460c1c03ac0c82fd84f303a699b210c0b054f4aff72ff7dcdf01512de301a10336f6355f5b532c3c160').then(console.log)
47
{
48
keyType: 5,
49
key: [
50
{
51
keyType: 2,
52
key: {
53
x: '0xe4a01407460c1c03ac0c82fd84f303a699b210c0b054f4aff72ff7dcdf01512d',
54
y: '0xa5735a23ce1654b14680054a993441eae7c261983a56f8e0da61280758b5919',
55
},
56
},
57
{
58
keyType: 4,
59
key: {
60
threshold: 2,
61
keys: [
62
{
63
weight: 1,
64
key: {
65
x: '0xe4a01407460c1c03ac0c82fd84f303a699b210c0b054f4aff72ff7dcdf01512d',
66
y: '0xa5735a23ce1654b14680054a993441eae7c261983a56f8e0da61280758b5919',
67
},
68
},
69
{
70
weight: 1,
71
key: {
72
x: '0x36f6355f5b532c3c1606f18fa2be7a16ae200c5159c8031dd25bfa389a4c9c06',
73
y: '0x6fdf9fc87a16ac359e66d9761445d5ccbb417fb7757a3f5209d713824596a50d',
74
},
75
},
76
],
77
},
78
},
79
{
80
keyType: 2,
81
key: {
82
x: '0xc8785266510368d9372badd4c7f4a94b692e82ba74e0b5e26b34558b0f081447',
83
y: '0x94c27901465af0a703859ab47f8ae17e54aaba453b7cde5a6a9e4a32d45d72b2',
84
},
85
},
86
],
87
}
Copied!

caver.rpc.klay.getBalance

1
caver.rpc.klay.getBalance(address [, blockNumber] [, callback])
Copied!
입력으로 받은 Klaytn 계정 주소의 잔액을 반환합니다.
매개변수
이름
타입
설명
address
string
잔액을 알고 싶은 계정 주소입니다.
blockNumber
number | string
(선택 사항) 블록 넘버, 또는 latest, earliest, pending 문자열 중 하나입니다. 이 값을 생략하면 latest가 기본값으로 사용됩니다.
callback
function
(선택 사항) 선택적 콜백(callback)은 오류 객체를 첫 번째 매개 변수로, 결과를 두 번째 매개 변수로 반환합니다.
리턴값
Promisestring을 반환합니다.
타입
설명
string
주어진 주소의 peb 단위 현재 잔액입니다.
예시
1
> caver.rpc.klay.getBalance('0x{address in hex}').then(console.log)
2
0xde0b6b3a7640000
Copied!

caver.rpc.klay.getCode

1
caver.rpc.klay.getCode(address [, blockNumber] [, callback])
Copied!
입력으로 받은 주소의 코드를 반환합니다.
매개변수
이름
타입
설명
address
string
코드를 알고 싶은 주소입니다.
blockNumber
number | string
(선택 사항) 블록 넘버, 또는 latest, earliest, pending 문자열 중 하나입니다. 이 값을 생략하면 latest가 기본값으로 사용됩니다.
callback
function
(선택 사항) 선택적 콜백(callback)은 오류 객체를 첫 번째 매개 변수로, 결과를 두 번째 매개 변수로 반환합니다.
리턴값
Promisestring을 반환합니다.
타입
설명
string
입력으로 받은 주소의 코드입니다.
예시
1
> caver.rpc.klay.getCode('0x{address in hex}').then(console.log)
2
0x60806...
Copied!

caver.rpc.klay.getTransactionCount

1
caver.rpc.klay.getTransactionCount(address [, blockNumber] [, callback])
Copied!
어떤 주소의 계정에서 발신된 트랜잭션의 총 개수를 반환합니다.
매개변수
이름
타입
설명
address
string
발신한 트랜잭션 개수를 확인할 주소입니다.
blockNumber
number | string
(선택 사항) 블록 번호, 보류 중인 논스의 경우 pending 문자열, 또는 default block parameter에 정의된 바와 같은 earliest, latest 같은 문자열입니다. 이 값을 생략하면 latest가 기본값으로 사용됩니다.
callback
function
(선택 사항) 선택적 콜백(callback)은 오류 객체를 첫 번째 매개 변수로, 결과를 두 번째 매개 변수로 반환합니다.
리턴값
Promisestring을 반환합니다.
타입
설명
string
주어진 주소에서 발신된 트랜잭션의 개수입니다. 이 값은 16진수 값입니다.
예시
1
> caver.rpc.klay.getTransactionCount('0x{address in hex}').then(console.log)
2
0x5f
Copied!

caver.rpc.klay.isContractAccount

1
caver.rpc.klay.isContractAccount(address [, blockNumber] [, callback])
Copied!
특정 번호의 블록 시간에서 입력으로 받은 계정의 codeHash가 비어 있지 않은 경우 true를 반환합니다. 해당 계정이 EOA이거나 codeHash가 비어 있는 스마트 컨트랙트 계정이면 false를 반환합니다. 더 자세한 내용은 Smart Contract Account를 확인하십시오.
매개변수
이름
타입
설명
address
string
isContractAccount로 확인할 주소입니다.
blockNumber
number | string
(선택 사항) 블록 넘버, 또는 latest, earliest, pending 문자열 중 하나입니다. 이 값을 생략하면 latest가 기본값으로 사용됩니다.
callback
function
(선택 사항) 선택적 콜백(callback)은 오류 객체를 첫 번째 매개 변수로, 결과를 두 번째 매개 변수로 반환합니다.
리턴값
Promiseboolean을 반환합니다.
타입
설명
boolean
true이면 매개변수가 스마트 컨트랙트 계정의 주소입니다.
예시
1
> caver.rpc.klay.isContractAccount('0x{address in hex}').then(console.log)
2
false
3
4
> caver.rpc.klay.isContractAccount('0x{address in hex}').then(console.log)
5
true
Copied!

caver.rpc.klay.sign

1
caver.rpc.klay.sign(address, message [, blockNumber] [, callback])
Copied!
Klaytn에서 사용하는 서명된 데이터를 생성합니다. Klaytn Platform API - klay_sign을 참고해 서명이 생성되는 방법을 확인하십시오.
참고: 이 API는 당신의 Klaytn 노드에 가져온 계정으로 메시지에 서명하는 기능을 제공합니다. 메시지에 서명하려면 노드에 불러온 당신의 계정은 반드시 unlocked 상태이어야 합니다. 당신의 Klaytn 노드에 불러온 계정으로 트랜잭션에 서명하려면 caver.rpc.klay.signTransaction을 사용하십시오.
매개변수
이름
타입
설명
address
String
메시지에 서명할 불러온 계정 주소입니다.
메시지
String
서명하려는 메시지입니다.
blockNumber
number | string
(선택 사항) 블록 넘버, 또는 latest, earliest, pending 문자열 중 하나입니다. 이 값을 생략하면 latest가 기본값으로 사용됩니다.
callback
function
(선택 사항) 선택적 콜백(callback)은 오류 객체를 첫 번째 매개 변수로, 결과를 두 번째 매개 변수로 반환합니다.
리턴값
Promisestring을 반환합니다.
타입
설명
string
노드에 불러온 계정이 만든 서명입니다.
예시
1
> caver.rpc.klay.sign('0x{address in hex}', '0xdeadbeaf').then(console.log)
2
0x1066e052c4be821daa4d0a0cd1e9e75ccb200bb4001c2e38853ba41b712a5a226da2acd67c86a13b266e0d75d0a6e7d1551c8924af413267615a5948617c746c1c
Copied!

caver.rpc.klay.getAccounts

1
caver.rpc.klay.getAccounts([callback])
Copied!
Klaytn 노드가 가진 주소 목록을 반환합니다.
매개변수
이름
타입
설명
callback
function
(선택 사항) 선택적 콜백(callback)은 오류 객체를 첫 번째 매개 변수로, 결과를 두 번째 매개 변수로 반환합니다.
리턴값
Promisearray를 반환합니다.
타입
설명
배열
Klaytn 노드가 가진 주소 목록입니다.
예시
1
> caver.rpc.klay.getAccounts().then(console.log)
2
[
3
'0xe1531e916857d1b3a7db92f9187b96a7b43813bf',
4
'0x75331c25535052157ff5110ba7d0cf940d3a9ca6'
5
]
Copied!

caver.rpc.klay.getBlockNumber

1
caver.rpc.klay.getBlockNumber([callback])
Copied!
가장 최근의 블록 번호를 반환합니다.
매개변수
이름
타입
설명
callback
function
(선택 사항) 선택적 콜백(callback)은 오류 객체를 첫 번째 매개 변수로, 결과를 두 번째 매개 변수로 반환합니다.
리턴값
Promisestring을 반환합니다.
타입
설명
string
가장 최근의 블록 번호입니다. 이 값은 16진수 값입니다.
예시
1
> caver.rpc.klay.getBlockNumber().then(console.log)
2
0x5d39
Copied!

caver.rpc.klay.getBlockByNumber

1
caver.rpc.klay.getBlockByNumber(blockNumber [, returnTransactionObjects] [, callback])
Copied!
블록 번호로 조회한 블록의 정보를 반환합니다. This API works only on RPC call, not on JavaScript console.
매개변수
이름
타입
설명
blockNumber
number | string
블록 번호, 또는 "genesis", "latest" 또는 "pending" 문자열로 태깅된 블록.
returnTransactionObjects
boolean
(선택 사항, 기본값은 false) true이면, 반환된 블록은 모든 트랜잭션 객체를 가집니다. false이면, 반환된 블록은 트랜잭션 해시만을 가집니다.
callback
function
(선택 사항) 선택적 콜백(callback)은 오류 객체를 첫 번째 매개 변수로, 결과를 두 번째 매개 변수로 반환합니다.
리턴값
Promiseobject를 반환합니다.
타입
설명
string
블록 객체입니다. 리턴값에 대한 자세한 설명은 caver.rpc.klay.getBlockByHash를 참조하세요.
예시
1
> caver.rpc.klay.getBlockByNumber(1).then(console.log)
2
{
3
blockscore: '0x1',
4
extraData: '0xd8830...',
5
gasUsed: '0x0',
6
governanceData: '0x',
7
hash: '0x58482921af951cf42a069436ac9338de50fd963bdbea40e396f416f9ac96a08b',
8
logsBloom: '0x00000...',
9
number: '0x1',
10
parentHash: '0x6b7c0a49f445d39b6d7dc9ba5b593b326f3a953e75ff1fcf64b9a5fa51c2725b',
11
receiptsRoot: '0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470',
12
reward: '0xddc2002b729676dfd906484d35bb02a8634d7040',
13
size: '0x285',
14
stateRoot: '0xb88b6110e6f73b732714bb346e6ff24beb480c0dc901a55be24e38ad1c6d5fa9',
15
timestamp: '0x5ee7fe9f',
16
timestampFoS: '0xd',
17
totalBlockScore: '0x2',
18
transactions: [],
19
transactionsRoot: '0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470',
20
voteData: '0x'
21
}
Copied!

caver.rpc.klay.getBlockByHash

1
caver.rpc.klay.getBlockByHash(blockHash [, returnTransactionObjects] [, callback])
Copied!
blockHash를 사용해 가장 최근의 블록 번호를 반환합니다.
매개변수
이름
타입
설명
blockHash
string
블록 해시입니다.
returnTransactionObjects
boolean
(선택 사항, 기본값은 false) true이면, 반환된 블록은 모든 트랜잭션 객체를 가집니다. false이면, 반환된 블록은 트랜잭션 해시만을 가집니다.
callback
function
(선택 사항) 선택적 콜백(callback)은 오류 객체를 첫 번째 매개 변수로, 결과를 두 번째 매개 변수로 반환합니다.
리턴값
Promiseobject를 반환 - 블록을 포함하는 객체입니다.
이름
타입
설명
blockScore
string
블록체인 네트워크의 채굴 난이도입니다. blockScore 사용은 네트워크 합의에 따라 다릅니다. BFT 합의 엔진에서는 항상 1입니다.
extraData
string
블록의 "추가 데이터"를 위한 필드입니다.
gasUsed
string
이 블록에 있는 모든 트랜잭션에서 사용된 가스양의 총합입니다.
governanceData
string
RLP 인코딩된 거버넌스 설정입니다.
해시
string
블록의 해시입니다. 아직 보류 중인 블록이면 null입니다.
logsBloom
string
블록의 로그를 위한 블룸필터입니다. 아직 보류 중인 블록이면 null입니다.
number
string
블록 번호입니다. 아직 보류 중인 블록이면 null입니다.
parentHash
string
이전 블록의 해시입니다.
receiptsRoot
string
블록의 영수증 트라이의 루트 해시입니다.
reward
string
블록 보상을 받을 수혜자의 주소입니다.
size
string
블록의 바이트 크기의 정수 형태입니다.
stateRoot
string
블록의 상태 트라이의 루트 해시입니다.
timestamp
string
블록이 생성되었을 때의 Unix 타임스탬프입니다.
timestampFoS
string
블록이 생성되었을 때의 타임스탬프 중 초 단위 부분입니다.
totalBlockScore
string
본 블록까지 체인 내 모든 블록의 blockScore 값의 합입니다.
transactions
배열
트랜잭션 객체의 배열이거나 또는 returnTransactionObjects 매개변수에 따라 32바이트 크기의 트랜잭션 해시입니다.
transactionsRoot
string
블록의 트랜잭션 트라이의 루트 해시입니다.
voteData
string
제안자의 RLP 인코딩된 거버넌스 투표입니다.
예시
1
> caver.rpc.klay.getBlockByHash('0x58482921af951cf42a069436ac9338de50fd963bdbea40e396f416f9ac96a08b').then(console.log)
2
{
3
blockscore: '0x1',
4
extraData: '0xd8830...',
5
gasUsed: '0x0',
6
governanceData: '0x',
7
hash: '0x58482921af951cf42a069436ac9338de50fd963bdbea40e396f416f9ac96a08b',
8
logsBloom: '0x00000...',
9
number: '0x1',
10
parentHash: '0x6b7c0a49f445d39b6d7dc9ba5b593b326f3a953e75ff1fcf64b9a5fa51c2725b',
11
receiptsRoot: '0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470',
12
reward: '0xddc2002b729676dfd906484d35bb02a8634d7040',
13
size: '0x285',
14
stateRoot: '0xb88b6110e6f73b732714bb346e6ff24beb480c0dc901a55be24e38ad1c6d5fa9',
15
timestamp: '0x5ee7fe9f',
16
timestampFoS: '0xd',
17
totalBlockScore: '0x2',
18
transactions: [],
19
transactionsRoot: '0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470',
20
voteData: '0x'
21
}
Copied!

caver.rpc.klay.getBlockReceipts

1
caver.rpc.klay.getBlockReceipts(blockHash [, callback])
Copied!
블록 해시로 조회한 블록에 포함된 영수증을 반환합니다.
매개변수
이름
타입
설명
blockHash
string
블록 해시입니다.
callback
function
(선택 사항) 선택적 콜백(callback)은 오류 객체를 첫 번째 매개 변수로, 결과를 두 번째 매개 변수로 반환합니다.
리턴값
Promisearray를 반환합니다.
타입
설명
배열
조회한 블록에 포함된 트랜잭션 영수증들입니다. 조회하고자 하는 블록이 트랜잭션을 담고 있지 않으면 빈 배열 []이 반환됩니다. 트랜잭션 영수증에 대한 자세한 설명은 caver.rpc.klay.getTransactionReceipt를 참조하세요.
예시
1
> caver.rpc.klay.getBlockReceipts('0x4584bea6b8b2abe7f024d1e63dd0571cfd28cd5157b4f6cb2ac4160a7b0057e0').then(console.log)
2
[
3
{
4
blockHash: '0x4584bea6b8b2abe7f024d1e63dd0571cfd28cd5157b4f6cb2ac4160a7b0057e0',
5
blockNumber: '0x5301',
6
contractAddress: null,
7
from: '0xddc2002b729676dfd906484d35bb02a8634d7040',
8
gas: '0x61a8',
9
gasPrice: '0x5d21dba00',
10
gasUsed: '0x5208',
11
logs: [],
12
logsBloom: '0x00000...',
13
nonce: '0x5e',
14
senderTxHash: '0x413f080a498ae3973490c2f80e75e6a492cfcdac8be8051220bb7a964768d28c',
15
signatures: [
16
{
17
V: '0x4e44',
18
R: '0x98583ffa8d9a6d5f9e60e4daebb33f18e8ad4d32653c4a2fa7f12ce025af763d',
19
S: '0x9b9e5257293e3b986842b6a203dd16ce46f16ed42dd3e9592fcaab9ea2696cb'
20
}
21
],
22
status: '0x1',
23
to: '0xc0aabc441129991dd3a9363a9a43b745527ea4e7',
24
transactionHash: '0x413f080a498ae3973490c2f80e75e6a492cfcdac8be8051220bb7a964768d28c',
25
transactionIndex: '0x0',
26
type: 'TxTypeValueTransfer',
27
typeInt: 8,
28
value: '0xde0b6b3a7640000'
29
}
30
]
Copied!

caver.rpc.klay.getBlockTransactionCountByNumber

1
caver.rpc.klay.getBlockTransactionCountByNumber(blockNumber [, callback])
Copied!
블록 번호로 조회한 블록에 담긴 트랜잭션의 개수를 반환합니다.
매개변수
이름
타입
설명
blockNumber
number | string
블록 번호, 또는 블록 태그 문자열("genesis"", "latest" 또는 "pending")입니다.
callback
function
(선택 사항) 선택적 콜백(callback)은 오류 객체를 첫 번째 매개 변수로, 결과를 두 번째 매개 변수로 반환합니다.
리턴값
Promisestring을 반환합니다.
타입
설명
string
주어진 블록에 기록된 트랜잭션의 개수입니다. 이 값은 16진수 값입니다.
예시
1
> caver.rpc.klay.getBlockTransactionCountByNumber(21249).then(console.log)
2
0x1
Copied!

caver.rpc.klay.getBlockTransactionCountByHash

1
caver.rpc.klay.getBlockTransactionCountByHash(blockHash [, callback])
Copied!
블록 해시로 조회한 블록에 담긴 트랜잭션의 개수를 반환합니다.
매개변수
이름
타입
설명
blockHash
string
블록 해시입니다.
callback
function
(선택 사항) 선택적 콜백(callback)은 오류 객체를 첫 번째 매개 변수로, 결과를 두 번째 매개 변수로 반환합니다.
리턴값
Promisestring을 반환합니다.
타입
설명
string
주어진 블록에 기록된 트랜잭션의 개수입니다. 이 값은 16진수 값입니다.
예시
1
> caver.rpc.klay.getBlockTransactionCountByHash('0x4584bea6b8b2abe7f024d1e63dd0571cfd28cd5157b4f6cb2ac4160a7b0057e0').then(console.log)
2
0x1
Copied!

caver.rpc.klay.getBlockWithConsensusInfoByNumber

1
caver.rpc.klay.getBlockWithConsensusInfoByNumber(blockNumber [, callback])
Copied!
블록 번호로 조회한 블록을 합의에 대한 정보와 함께 반환합니다.
매개변수
이름
타입
설명
blockNumber
number | string
블록 번호, 또는 블록 태그 문자열("genesis"", "latest" 또는 "pending")입니다.
callback
function
(선택 사항) 선택적 콜백(callback)은 오류 객체를 첫 번째 매개 변수로, 결과를 두 번째 매개 변수로 반환합니다.
리턴값
Promiseobject를 반환합니다.
타입
설명
string
컨센서스 정보를 포함해 블록 정보를 담고 있는 객체입니다. 리턴값에 대한 자세한 설명은 caver.rpc.klay.getBlockWithConsensusInfoByHash를 참조하세요.
예시
1
> caver.rpc.klay.getBlockWithConsensusInfoByNumber(21249).then(console.log)
2
{
3
blockscore: '0x1',
4
committee: ['0xddc2002b729676dfd906484d35bb02a8634d7040', '0xa1d2665c4c9f77410844dd4c22ed11aabbd4033e'],
5
extraData: '0xd8830...',
6
gasUsed: '0x5208',
7
governanceData: '0x',
8
hash: '0x4584bea6b8b2abe7f024d1e63dd0571cfd28cd5157b4f6cb2ac4160a7b0057e0',
9
logsBloom: '0x00000...',
10
number: '0x5301',
11
parentHash: '0x024f05c0e7428e33331104bedbfc453d481ce6a2f5e57f7fd68a4391ba6c2619',
12
proposer: '0xa1d2665c4c9f77410844dd4c22ed11aabbd4033e',
13
receiptsRoot: '0xe38e5532717f12f769b07ea016014bd39b74fb72def4de8442114cc2728609f2',
14
reward: '0xb74837f495060f3f794dcae8fa3e0c5d3cf99d9f',
15
size: '0x313',
16
stateRoot: '0x9964b2d8f23da7383a32ec33c9700a76ebf4a36315c9067c2fef7568d97e1d55',
17
timestamp: '0x5ee851dd',
18
timestampFoS: '0x0',
19
totalBlockScore: '0x5302',
20
transactions: [
21
{
22
blockHash: '0x4584bea6b8b2abe7f024d1e63dd0571cfd28cd5157b4f6cb2ac4160a7b0057e0',
23
blockNumber: '0x5301',
24
contractAddress: null,
25
from: '0xddc2002b729676dfd906484d35bb02a8634d7040',
26
gas: '0x61a8',
27
gasPrice: '0x5d21dba00',
28
gasUsed: '0x5208',
29
logs: [],
30
logsBloom: '0x00000...',
31
nonce: '0x5e',
32
senderTxHash: '0x413f080a498ae3973490c2f80e75e6a492cfcdac8be8051220bb7a964768d28c',
33
signatures: {
34
V: '0x4e44',
35
R: '0x98583ffa8d9a6d5f9e60e4daebb33f18e8ad4d32653c4a2fa7f12ce025af763d',
36
S: '0x9b9e5257293e3b986842b6a203dd16ce46f16ed42dd3e9592fcaab9ea2696cb'
37
},
38
status: '0x1',
39
to: '0xc0aabc441129991dd3a9363a9a43b745527ea4e7',
40
transactionHash: '0x413f080a498ae3973490c2f80e75e6a492cfcdac8be8051220bb7a964768d28c',
41
transactionIndex: '0x0',
42
type: 'TxTypeValueTransfer',
43
typeInt: 8,
44
value: '0xde0b6b3a7640000',
45
},
46
],
47
transactionsRoot: '0x413f080a498ae3973490c2f80e75e6a492cfcdac8be8051220bb7a964768d28c',
48
voteData: '0x',
49
}
Copied!

caver.rpc.klay.getBlockWithConsensusInfoByHash

1
caver.rpc.klay.getBlockWithConsensusInfoByHash(blockHash [, callback])
Copied!
블록 해시로 조회한 블록을 합의에 대한 정보와 함께 반환합니다.
매개변수
이름
타입
설명
blockHash
string
블록 해시입니다.
callback
function
(선택 사항) 선택적 콜백(callback)은 오류 객체를 첫 번째 매개 변수로, 결과를 두 번째 매개 변수로 반환합니다.
리턴값
Promiseobject를 반환 - 합의 정보(제안자와 위원회 멤버 목록)와 블록 객체입니다. 블록을 찾지 못했다면 null을 반환합니다.
이름
타입
설명
blockScore
string
이전 난이도입니다. BFT 합의 엔진에서는 항상 1입니다.
committee
배열
블록 생성에 관여한 위원회 멤버들의 주소의 배열입니다. 위원회란 블록 생성을 위한 합의 프로토콜에 참여한 검증자 중 일부입니다.
extraData
string
블록의 "추가 데이터"를 위한 필드입니다.
gasUsed
string
이 블록에 있는 모든 트랜잭션에서 사용된 가스양의 총합입니다.
governanceData
string
RLP 인코딩된 거버넌스 설정입니다.
해시
string
블록의 해시입니다. 아직 보류 중인 블록이면 null입니다.
logsBloom
string
블록의 로그를 위한 블룸필터입니다. 아직 보류 중인 블록이면 null입니다.
number
string
블록 번호입니다. 아직 보류 중인 블록이면 null입니다.
originProposer
string
The proposal of 0 round at the same block number.
parentHash
string
이전 블록의 해시입니다.
proposer
string
블록 제안자의 주소입니다.
receiptsRoot
string
블록의 영수증 트라이의 루트 해시입니다.
reward
string
블록 보상을 받을 수혜자의 주소입니다.
round
number
The round number.
size
string
블록의 바이트 크기의 정수 형태입니다.
stateRoot
string
블록의 상태 트라이의 루트 해시입니다.
timestamp
string
블록이 생성되었을 때의 Unix 타임스탬프입니다.
timestampFoS
string
블록이 생성되었을 때의 타임스탬프 중 초 단위 부분입니다.
totalBlockScore
string
본 블록까지 체인 내 모든 블록의 blockScore 값의 합입니다.
transactions
배열
트랜잭션 객체의 배열입니다.
transactionsRoot
string
블록의 트랜잭션 트라이의 루트 해시입니다.
voteData
string
제안자의 RLP 인코딩된 거버넌스 투표입니다.
예시
1
> caver.rpc.klay.getBlockWithConsensusInfoByHash('0x4584bea6b8b2abe7f024d1e63dd0571cfd28cd5157b4f6cb2ac4160a7b0057e0').then(