본문으로 건너뛰기

Block

defaultBlock


caver.klay.defaultBlock

기본 블록은 특정 메서드에 사용됩니다. 기본 블록을 재정의하려면 마지막 매개변수로 을 마지막 매개변수로 전달하여 재정의할 수 있습니다. 기본값은 latest입니다.

속성

기본 블록 매개변수는 다음 중 하나일 수 있습니다:

  • 번호: 블록 번호
  • "genesis" - String: 제네시스 블록
  • "latest" - String: 최신 블록(블록체인의 현재 헤드)

기본값은 latest입니다.

예시


> caver.klay.defaultBlock;
"latest"
// set the default block
> caver.klay.defaultBlock = 1000;

getBlockNumber


caver.klay.getBlockNumber([callback])

현재 블록 번호를 반환합니다.

매개변수

이름유형설명
callbackFunction(선택 사항) 선택적 콜백으로, 첫 번째 매개변수로 오류 객체를 반환하고 두 번째 매개변수로 결과를 반환합니다.

리턴 값

Promisenumber - 가장 최근 블록의 숫자를 반환합니다.

예시


> caver.klay.getBlockNumber().then(console.log);
2744

getBlock


caver.klay.getBlock(blockHashOrBlockNumber [, returnTransactionObjects] [, callback])

블록 해시 또는 블록 번호와 일치하는 블록을 반환합니다.

매개변수

이름유형설명
blockHashOrBlockNumberString | Number블록 해시 또는 블록 번호입니다. 또는 문자열 genesis 또는 latest입니다.
returnTransactionObjectsBoolean(선택 사항, 기본값 false) true이면 반환된 블록에 모든 트랜잭션이 오브젝트로 포함되고, false이면 트랜잭션 해시만 포함됩니다.
callbackFunction(선택 사항) 선택적 콜백으로, 첫 번째 매개변수로 오류 객체를 반환하고 두 번째 매개변수로 결과를 반환합니다.

리턴 값

Promise는 블록 객체인 Object를 반환합니다:

이름유형설명
blockScoreQUANTITY이전 난이도 BFT 합의 엔진에서는 항상 1입니다.
extraDataString이 블록의 "추가 데이터" 필드입니다.
gasUsedNumber이 블록의 모든 트랜잭션이 사용한 총 가스 사용량입니다.
governanceDataDATARLP로 인코딩된 거버넌스 구성
hash32-byte String블록의 해시. 보류 중인 블록인 경우 null.
logsBloom256-byte String블록의 로그에 대한 블룸 필터입니다. 보류 중인 블록인 경우 null입니다.
numberNumber블록 번호입니다. 보류 중인 블록인 경우 null입니다.
parentHash32-byte String부모 블록의 해시.
receiptsRoot32-byte DATA블록의 영수증 트라이의 루트입니다.
reward20-byte DATA블록 보상을 받은 수혜자의 주소입니다.
sizeNumber이 블록의 크기(바이트)를 정수로 나타냅니다.
stateRoot32-byte String블록의 최종 상태 증명 시도 루트입니다.
timestampNumber블록이 콜레이션된 시점의 유닉스 타임스탬프입니다.
timestampFoSQUANTITY블록이 콜레이트된 시점에 대한 타임스탬프의 1초 단위입니다.
totalBlockScoreQUANTITY이 블록까지 체인의 총 블록스코어의 정수입니다.
transactionsArray트랜잭션 객체의 배열, 또는 returnTransactionObjects 매개변수에 따라 32바이트 트랜잭션 해시입니다.
transactionsRoot32-byte String블록의 트랜잭션 트라이의 루트입니다.
voteDataDATA제안자의 RLP 인코딩된 거버넌스 투표

예시


> caver.klay.getBlock(19097).then(console.log);
{
blockscore: '0x1',
extraData: '0xd7820a01846b6c617988676f312e31312e32856c696e75780000000000000000f8b3ea94715dd3ce7a285f21111715a2ba5537414d40506b9471959675eeb7c7ec1e0c74f206a9c488d7f178d4b8418e55cfb464eed804671bbee503f2dcacae9349f23aa3c42fc43349f96ef08bb07c1039541a3b768af32384c8e29ec7e673356a6b0ea4c6d88604ae8abae4303201f843b841386a3fbd09cd3a7c82c0b8fdc9ae8c3e624be5f12553dde42bed456093e40c113aa36fb7015b578611e2cd2ee979e6017b15be7d3cc645f455b32e8607c85d7100',
gasUsed: '0x5208',
governanceData: '0x',
hash: '0x6ccef34eb59fab927705d344f080f449b576c0626e4aa3e20f569feb8df6e283',
logsBloom: '0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000',
number: '0x4a99',
parentHash: '0x3b56b598828368d86b175a78ba21845125372851154840c6b1b318da910849c2',
receiptsRoot: '0xe38e5532717f12f769b07ea016014bd39b74fb72def4de8442114cc2728609f2',
reward: '0x59e6931f46b091f4ecbc39e8626fc0be7d3fcdeb',
size: '0x314',
stateRoot: '0xc65b3e3f1c32c33c095507d6d37e2a8a5589b178b5b03a1365295908ac92c40c',
timestamp: '0x5d11f951',
timestampFoS: '0x0',
totalBlockScore: '0x4a9a',
transactions: [ '0xac418c96f7386a3343d149eeb29e48e28905525dda2e5afe55b0661f9ab01aca' ],
transactionsRoot: '0xac418c96f7386a3343d149eeb29e48e28905525dda2e5afe55b0661f9ab01aca',
voteData: '0x'
}

getBlockReceipts


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

주어진 블록 해시로 식별된 블록에 포함된 트랜잭션 영수증 목록을 반환합니다.

매개변수

이름유형설명
blockHashString블록의 해시.
callbackFunction(선택 사항) 선택적 콜백으로, 첫 번째 매개변수로 오류 객체를 반환하고 두 번째 매개변수로 결과를 반환합니다.

리턴 값

Promise는 블록에 포함된 영수증인 Array를 반환합니다. 대상 블록에 트랜잭션이 없는 경우 빈 배열 []이 반환됩니다.

예시


> caver.klay.getBlockReceipts('0x6ccef34eb59fab927705d344f080f449b576c0626e4aa3e20f569feb8df6e283').then(console.log);
[
{
blockHash: '0x6ccef34eb59fab927705d344f080f449b576c0626e4aa3e20f569feb8df6e283',
blockNumber: '0x4a99',
contractAddress: null,
from: '0x71959675eeb7c7ec1e0c74f206a9c488d7f178d4',
gas: '0x493e0',
gasPrice: '0x5d21dba00',
gasUsed: '0x5208',
logs: [],
logsBloom: '0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000',
nonce: '0x2',
senderTxHash: '0xac418c96f7386a3343d149eeb29e48e28905525dda2e5afe55b0661f9ab01aca',
signatures: [
{
V: '0x4e43',
R: '0xa857ef0676d7e65697cadeaf1654b2facd71d0b9f942d695f3972a1f7c34c25c',
S: '0x43fba9e5c2c16511f951e27957f1279ea3c1f913b27f9fbb2a8dcb5884e37e3d'
}
],
status: '0x1',
to: '0xef5cd886c7f8d85fbe8023291761341acbb4da01',
transactionHash: '0xac418c96f7386a3343d149eeb29e48e28905525dda2e5afe55b0661f9ab01aca',
transactionIndex: '0x0',
type: 'TxTypeValueTransfer',
typeInt: 8,
value: '0xde0b6b3a7640000'
}
]
> caver.klay.getBlockReceipts('0x6275712cd6ec769603f1560819ad226ea29216881c495c778ca68f0c1cd6e550').then(console.log);
[]

getBlockTransactionCount


caver.klay.getBlockTransactionCount(blockHashOrBlockNumber [, callback])

주어진 블록의 트랜잭션 수를 반환합니다.

매개변수

이름유형설명
blockHashOrBlockNumberString | Numberblock number or hash입니다. 또는 문자열 genesis 또는 latest입니다.
callbackFunction(선택 사항) 선택적 콜백으로, 첫 번째 매개변수로 오류 객체를 반환하고 두 번째 매개변수로 결과를 반환합니다.

리턴 값

Promisenumber를 반환합니다 - 주어진 블록의 트랜잭션 수입니다.

예시


> caver.klay.getBlockTransactionCount("0x407d73d8a49eeb85d32cf465507dd71d507100c1").then(console.log);
1

getBlockWithConsensusInfo


caver.klay.getBlockWithConsensusInfo(blockHashOrBlockNumber [, callback])

주어진 블록 해시 또는 블록 번호와 일치하는 합의 정보가 포함된 블록을 반환합니다.

매개변수

이름유형설명
blockHashOrBlockNumberString | Number블록 해시 또는 블록 번호입니다. 또는 문자열 "genesis" 또는 "latest"입니다.
callbackFunction(선택 사항) 선택적 콜백으로, 첫 번째 파라미터로 오류 객체를 반환하고 두 번째 파라미터로 결과를 반환합니다.

리턴 값

PromiseObject를 반환합니다 - 합의 정보(제안자 및 위원회 멤버 목록)가 포함된 블록 오브젝트입니다.

이름유형설명
blockScoreQUANTITY이전 난이도 BFT 합의 엔진에서는 항상 1입니다.
committeeArray이 블록의 위원회 멤버 주소 배열입니다. 위원회는 이 블록의 합의 프로토콜에 참여한 검증자의 하위 집합입니다.
extraDataString이 블록의 "추가 데이터" 필드입니다.
gasUsedQUANTITY이 블록의 모든 트랜잭션에서 사용한 총 가스 사용량입니다.
governanceDataDATARLP 인코딩된 거버넌스 구성
hash32-byte DATA블록의 해시. 보류 중인 블록인 경우 null.
logsBloom256-byte String블록의 로그에 대한 블룸 필터. 보류 중인 블록인 경우 null입니다.
numberQUANTITY블록 번호입니다. 보류 중인 블록인 경우 null.
parentHash32-byte DATA상위 블록의 해시입니다.
proposer20-byte DATA블록 제안자의 주소입니다.
receiptsRoot32-byte DATA블록의 영수증 트라이의 루트입니다.
reward20-byte DATA블록 보상을 받은 수혜자의 주소입니다.
sizeQUANTITY이 블록의 크기(바이트)를 정수로 나타냅니다.
stateRoot32-byte DATA블록의 최종 상태 증명 시도 루트입니다.
timestampQUANTITY블록이 콜레이션된 시점의 유닉스 타임스탬프입니다.
timestampFoSQUANTITY블록이 콜레이트된 시점에 대한 타임스탬프의 1초 단위입니다.
totalBlockScoreQUANTITY이 블록까지 체인의 총 블록스코어의 정수입니다.
transactionsArray트랜잭션 개체의 배열입니다.
transactionsRoot32-byte DATA블록의 트랜잭션 트라이의 루트입니다.
voteDataDATA제안자의 RLP 인코딩된 거버넌스 투표

예제


> caver.klay.getBlockWithConsensusInfo(19097).then(console.log);
{
blockscore: '0x1',
committee: [
'0x715dd3ce7a285f21111715a2ba5537414d40506b',
'0x71959675eeb7c7ec1e0c74f206a9c488d7f178d4'
],
extraData: '0xd7820a01846b6c617988676f312e31312e32856c696e75780000000000000000f8b3ea94715dd3ce7a285f21111715a2ba5537414d40506b9471959675eeb7c7ec1e0c74f206a9c488d7f178d4b8418e55cfb464eed804671bbee503f2dcacae9349f23aa3c42fc43349f96ef08bb07c1039541a3b768af32384c8e29ec7e673356a6b0ea4c6d88604ae8abae4303201f843b841386a3fbd09cd3a7c82c0b8fdc9ae8c3e624be5f12553dde42bed456093e40c113aa36fb7015b578611e2cd2ee979e6017b15be7d3cc645f455b32e8607c85d7100',
gasUsed: '0x5208',
governanceData: '0x',
hash: '0x6ccef34eb59fab927705d344f080f449b576c0626e4aa3e20f569feb8df6e283',
logsBloom: '0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000',
number: '0x4a99',
parentHash: '0x3b56b598828368d86b175a78ba21845125372851154840c6b1b318da910849c2',
proposer: '0x715dd3ce7a285f21111715a2ba5537414d40506b',
receiptsRoot: '0xe38e5532717f12f769b07ea016014bd39b74fb72def4de8442114cc2728609f2',
reward: '0x59e6931f46b091f4ecbc39e8626fc0be7d3fcdeb',
size: '0x314',
stateRoot: '0xc65b3e3f1c32c33c095507d6d37e2a8a5589b178b5b03a1365295908ac92c40c',
timestamp: '0x5d11f951',
timestampFoS: '0x0',
totalBlockScore: '0x4a9a',
transactions: [
{
blockHash: '0x6ccef34eb59fab927705d344f080f449b576c0626e4aa3e20f569feb8df6e283',
blockNumber: '0x4a99',
contractAddress: null,
from: '0x71959675eeb7c7ec1e0c74f206a9c488d7f178d4',
gas: '0x493e0',
gasPrice: '0x5d21dba00',
gasUsed: '0x5208',
logs: [],
logsBloom: '0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000',
nonce: '0x2',
senderTxHash: '0xac418c96f7386a3343d149eeb29e48e28905525dda2e5afe55b0661f9ab01aca',
signatures: [
{
V: '0x4e43',
R: '0xa857ef0676d7e65697cadeaf1654b2facd71d0b9f942d695f3972a1f7c34c25c',
S: '0x43fba9e5c2c16511f951e27957f1279ea3c1f913b27f9fbb2a8dcb5884e37e3d'
}
],
status: '0x1',
to: '0xef5cd886c7f8d85fbe8023291761341acbb4da01',
transactionHash: '0xac418c96f7386a3343d149eeb29e48e28905525dda2e5afe55b0661f9ab01aca',
transactionIndex: '0x0',
type: 'TxTypeValueTransfer',
typeInt: 8,
value: '0xde0b6b3a7640000'
}
],
transactionsRoot: '0xac418c96f7386a3343d149eeb29e48e28905525dda2e5afe55b0661f9ab01aca',
voteData: '0x'
}

getCommittee


caver.klay.getCommittee([defaultBlock] [, callback])

지정된 블록에 있는 위원회의 모든 유효성 검사기 목록을 반환합니다. 매개 변수가 설정되지 않은 경우 최신 블록에 있는 위원회의 모든 유효성 검사기 목록을 반환합니다.

매개변수

이름유형설명
defaultBlockNumber | String(선택 사항) 이 매개변수를 전달하면 caver.klay.defaultBlock으로 설정된 기본 블록을 사용하지 않습니다.
callbackFunction(선택 사항) 선택적 콜백으로, 첫 번째 매개변수로 오류 객체를 반환하고 두 번째 매개변수로 결과를 반환합니다.

리턴 값

Promise는 위원회에 있는 모든 검증자의 주소인 Array를 반환합니다.

예시


> caver.klay.getCommittee().then(console.log);
[
"0x207e38864b45a538733741dc1ff92eff9d1a6159",
"0x6d64bc82b93368a7f963d6c34483ca3893f405f6",
"0xbc9c19f91878369776812039e4ebcdfa3c646716",
"0xe3ed6fa287752b992f936b42360770c59731d9eb"
]

getCommitteeSize


caver.klay.getCommitteeSize([defaultBlock] [, callback])

지정된 블록에서 위원회의 크기를 반환합니다. 매개 변수가 설정되지 않은 경우 가장 최근 블록의 위원회 크기를 반환합니다.

매개변수

이름유형설명
defaultBlockNumber | String(선택 사항) 이 매개변수를 전달하면 caver.klay.defaultBlock으로 설정된 기본 블록을 사용하지 않습니다.
callbackFunction(선택 사항) 선택적 콜백으로, 첫 번째 매개변수로 오류 객체를 반환하고 두 번째 매개변수로 결과를 반환합니다.

리턴 값

Promisenumber - 위원회의 규모를 반환합니다.

예시


> caver.klay.getCommitteeSize().then(console.log);
4

getCouncil

참고: getValidators는 이 메서드로 대체되었으며 더 이상 지원되지 않습니다.


caver.klay.getCouncil([defaultBlock] [, callback])

지정된 블록에 있는 카운슬의 모든 검증자 목록을 반환합니다. 매개 변수가 설정되지 않은 경우 최신 블록에 있는 카운슬의 모든 검증자 목록을 반환합니다.

매개변수

이름유형설명
defaultBlockNumber | String(선택 사항) 이 매개변수를 전달하면 caver.klay.defaultBlock으로 설정된 기본 블록을 사용하지 않습니다.
callbackFunction(선택 사항) 선택적 콜백으로, 첫 번째 매개변수로 오류 객체를 반환하고 두 번째 매개변수로 결과를 반환합니다.

리턴 값

Promise는 카운슬의 모든 검증자의 주소인 Array를 반환합니다.

예시


> caver.klay.getCouncil().then(console.log);
[
"0x207e38864b45a538733741dc1ff92eff9d1a6159",
"0x6d64bc82b93368a7f963d6c34483ca3893f405f6",
"0xbc9c19f91878369776812039e4ebcdfa3c646716",
"0xe3ed6fa287752b992f936b42360770c59731d9eb"
]

getCouncilSize


caver.klay.getCouncilSize([defaultBlock] [, callback])

지정된 블록에서 카운슬의 크기를 반환합니다. 매개 변수가 설정되지 않은 경우 가장 최근 블록에서 카운슬의 크기를 반환합니다.

매개변수

이름유형설명
defaultBlockNumber | String(선택 사항) 이 매개변수를 전달하면 caver.klay.defaultBlock으로 설정된 기본 블록을 사용하지 않습니다.
callbackFunction(선택 사항) 선택적 콜백으로, 첫 번째 매개변수로 오류 객체를 반환하고 두 번째 매개변수로 결과를 반환합니다.

리턴 값

Promisenumber - 카운슬의 규모를 반환합니다.

예시


> caver.klay.getCouncilSize().then(console.log);
4

getStorageAt


caver.klay.getStorageAt(address, position [, defaultBlock] [, callback])

주소의 특정 위치에 있는 스토리지를 가져옵니다.

매개변수

이름유형설명
addressString저장소를 가져올 주소입니다.
locationNumber스토리지의 인덱스 위치입니다.
defaultBlockNumber | String(선택 사항) 이 매개변수를 전달하면 caver.klay.defaultBlock으로 설정된 기본 블록이 사용되지 않습니다.
callbackFunction(선택 사항) 선택적 콜백으로, 첫 번째 매개변수로 오류 객체를 반환하고 두 번째 매개변수로 결과를 반환합니다.

리턴 값

Promise는 주어진 위치에 저장된 값인 String을 반환합니다.

예시


> caver.klay.getStorageAt("0x407d73d8a49eeb85d32cf465507dd71d507100c1", 0).then(console.log);
"0x033456732123ffff2342342dd12342434324234234fd234fd23fd4f23d4234"

isMining


caver.klay.isMining([callback])

클라이언트가 새 블록을 활발하게 채굴하고 있으면 true를 반환합니다.

매개변수

이름유형설명
callbackFunction(선택 사항) 선택적 콜백으로, 첫 번째 매개변수로 오류 객체를 반환하고 두 번째 매개변수로 결과를 반환합니다.

리턴 값

Promise는 클라이언트가 채굴 중이면 boolean - true을 반환하고, 그렇지 않으면 false을 반환합니다.

예시


> caver.klay.isMining().then(console.log);
true

isSyncing


caver.klay.isSyncing([callback])

노드가 현재 동기화 중인지 확인하고 동기화 객체 또는 false를 반환합니다.

매개변수

이름유형설명
callbackFunction(선택 사항) 선택적 콜백으로, 첫 번째 매개변수로 오류 객체를 반환하고 두 번째 매개변수로 결과를 반환합니다.

리턴 값

Promise는 노드가 현재 동기화 중이거나 false일 때 동기화 오브젝트인 Object|Boolean을 반환합니다:

이름유형설명
startingBlockNumber동기화가 시작된 블록 번호입니다.
currentBlockNumber노드가 현재 동기화된 블록의 블록 번호입니다.
highestBlockNumber동기화할 예상 블록 번호입니다.
knownStatesNumber다운로드할 것으로 예상되는 상태입니다.
pulledStatesNumber이미 다운로드한 상태입니다.

예시


> caver.klay.isSyncing().then(console.log);
{
startingBlock: 100,
currentBlock: 312,
highestBlock: 512,
knownStates: 234566,
pulledStates: 123455
}

Make this page better