Block
defaultBlock
caver.klay.defaultBlock
기본 블록은 특정 메서드에 사용됩니다. 기본 블록을 재정의하려면 마지막 매개변수로
을 마지막 매개변수로 전달하여 재정의할 수 있습니다. 기본값은 latest
입니다.
- caver.klay.getBalance()
- caver.klay.getCode()
- caver.klay.getTransactionCount()
- caver.klay.getStorageAt()
- caver.klay.call()
- new caver.klay.Contract() -> myContract.methods.myMethod().call()
속성
기본 블록 매개변수는 다음 중 하나일 수 있습니다:
- 번호: 블록 번호
"genesis"
- String: 제네시스 블록"latest"
- String: 최신 블록(블록체인의 현재 헤 드)
기본값은 latest
입니다.
예시
> caver.klay.defaultBlock;"latest"// set the default block> caver.klay.defaultBlock = 1000;
getBlockNumber
caver.klay.getBlockNumber([callback])
현재 블록 번호를 반환합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
callback | Function | (선택 사항) 선택적 콜백으로, 첫 번째 매개변수로 오류 객체를 반환하고 두 번째 매개변수로 결과를 반환합니다. |
리턴 값
Promise
는 number
- 가장 최근 블록의 숫자를 반환합니다.
예시
> caver.klay.getBlockNumber().then(console.log);2744
getBlock
caver.klay.getBlock(blockHashOrBlockNumber [, returnTransactionObjects] [, callback])
블록 해시 또는 블록 번호와 일치하는 블록을 반환합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
blockHashOrBlockNumber | String | Number | 블록 해시 또는 블록 번호입니다. 또는 문자열 genesis 또는 latest 입니다. |
returnTransactionObjects | Boolean | (선택 사항, 기본값 false ) true 이면 반환된 블록에 모든 트랜잭션이 오브젝트로 포함되고, false 이면 트랜잭션 해시만 포함됩니다. |
callback | Function | (선택 사항) 선택적 콜백으로, 첫 번째 매개변수로 오류 객체를 반환하고 두 번째 매개변수로 결과를 반환합니다. |
리턴 값
Promise
는 블록 객체인 Object
를 반환합니다:
이름 | 유형 | 설명 |
---|---|---|
blockScore | QUANTITY | 이전 난이도 BFT 합의 엔진에서는 항상 1입니다. |
extraData | String | 이 블록의 "추가 데이터" 필드입니다. |
gasUsed | Number | 이 블록의 모든 트랜잭션이 사용한 총 가스 사용량입니다. |
governanceData | DATA | RLP로 인코딩된 거버넌스 구성 |
hash | 32-byte String | 블록의 해시. 보류 중인 블록인 경우 null . |
logsBloom | 256-byte String | 블록의 로그에 대한 블룸 필터입니다. 보류 중인 블록인 경우 null 입니다. |
number | Number | 블록 번호입니다. 보류 중인 블록인 경우 null 입니다. |
parentHash | 32-byte String | 부모 블록의 해시. |
receiptsRoot | 32-byte DATA | 블록의 영수증 트라이의 루트입니다. |
reward | 20-byte DATA | 블록 보상을 받은 수혜자의 주소입니다. |
size | Number | 이 블록의 크기(바이트)를 정수로 나타냅니다. |
stateRoot | 32-byte String | 블록의 최종 상태 증명 시도 루트입니다. |
timestamp | Number | 블록이 콜레이션된 시점의 유닉스 타임스탬프입니다. |
timestampFoS | QUANTITY | 블록이 콜레이트된 시점에 대한 타임스탬프의 1초 단위입니다. |
totalBlockScore | QUANTITY | 이 블록까지 체인의 총 블록스코어의 정수입니다. |
transactions | Array | 트랜잭션 객체의 배열, 또는 returnTransactionObjects 매개변수에 따라 32바이트 트랜잭션 해시입니다. |
transactionsRoot | 32-byte String | 블록의 트랜잭션 트라이의 루트입니다. |
voteData | DATA | 제안자의 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])
주어진 블록 해시로 식별된 블록에 포함된 트랜잭션 영수증 목록을 반환합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
blockHash | String | 블록의 해시. |
callback | Function | (선택 사항) 선택적 콜백으로, 첫 번째 매개변수로 오류 객체를 반환하고 두 번째 매개변수로 결과를 반환합니다. |
리턴 값
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])
주어진 블록의 트랜잭션 수를 반환합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
blockHashOrBlockNumber | String | Number | block number or hash입니다. 또는 문자열 genesis 또는 latest 입니다. |
callback | Function | (선택 사항) 선택적 콜백으로, 첫 번째 매개변수로 오류 객체를 반환하고 두 번째 매개변수로 결과를 반환합니다. |
리턴 값
Promise
는 number
를 반환합니다 - 주어진 블록의 트랜잭션 수입니다.
예시
> caver.klay.getBlockTransactionCount("0x407d73d8a49eeb85d32cf465507dd71d507100c1").then(console.log);1
getBlockWithConsensusInfo
caver.klay.getBlockWithConsensusInfo(blockHashOrBlockNumber [, callback])
주어진 블록 해시 또는 블록 번호와 일치하는 합의 정보가 포함된 블록을 반환합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
blockHashOrBlockNumber | String | Number | 블록 해시 또는 블록 번호입니다. 또는 문자열 "genesis" 또는 "latest" 입니다. |
callback | Function | (선택 사항) 선택적 콜백으로, 첫 번째 파라미터로 오류 객체를 반환하고 두 번째 파라미터로 결과를 반환합니다. |
리턴 값
Promise
는 Object
를 반환합니다 - 합의 정보(제안자 및 위원회 멤버 목록)가 포함된 블록 오브젝트입니다.
이름 | 유형 | 설명 |
---|---|---|
blockScore | QUANTITY | 이전 난이도 BFT 합의 엔진에서는 항상 1입니다. |
committee | Array | 이 블록의 위원회 멤버 주소 배열입니다. 위원회는 이 블록의 합의 프로토콜에 참여한 검증자의 하위 집합입니다. |
extraData | String | 이 블록의 "추가 데이터" 필드입니다. |
gasUsed | QUANTITY | 이 블록의 모든 트랜잭션에서 사용한 총 가스 사용량입니다. |
governanceData | DATA | RLP 인코딩된 거버넌스 구성 |
hash | 32-byte DATA | 블록의 해시. 보류 중인 블록인 경우 null . |
logsBloom | 256-byte String | 블록의 로그에 대한 블룸 필터. 보류 중인 블록인 경우 null 입니다. |
number | QUANTITY | 블록 번호입니다. 보류 중인 블록인 경우 null . |
parentHash | 32-byte DATA | 상위 블록의 해시입니다. |
proposer | 20-byte DATA | 블록 제안자의 주소입니다. |
receiptsRoot | 32-byte DATA | 블록의 영수증 트라이의 루트입니다. |
reward | 20-byte DATA | 블록 보상을 받은 수혜자의 주소입니다. |
size | QUANTITY | 이 블록의 크기(바이트)를 정수로 나타냅니다. |
stateRoot | 32-byte DATA | 블록의 최종 상태 증명 시도 루트입니다. |
timestamp | QUANTITY | 블록이 콜레이션된 시점의 유닉스 타임스탬프입니다. |
timestampFoS | QUANTITY | 블록이 콜레이트된 시점에 대한 타임스탬프의 1초 단위입니다. |
totalBlockScore | QUANTITY | 이 블록까지 체인의 총 블록스코어의 정수입니다. |
transactions | Array | 트랜잭션 개체의 배열입니다. |
transactionsRoot | 32-byte DATA | 블록의 트랜잭션 트라이의 루트입니다. |
voteData | DATA | 제안자의 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])
지정된 블록에 있는 위원회의 모든 유효성 검사기 목록을 반환합니다. 매개 변수가 설정되지 않은 경우 최신 블록에 있는 위원회의 모든 유효성 검사기 목록을 반환합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
defaultBlock | Number | String | (선택 사항) 이 매개변수를 전달하면 caver.klay.defaultBlock으로 설정된 기본 블록을 사용하지 않습니다. |
callback | Function | (선택 사항) 선택적 콜백으로, 첫 번째 매개변수로 오류 객체를 반환하고 두 번째 매개변수로 결과를 반환합니다. |
리턴 값
Promise
는 위원회에 있는 모든 검증자의 주소인 Array
를 반환합니다.
예시
> caver.klay.getCommittee().then(console.log);[ "0x207e38864b45a538733741dc1ff92eff9d1a6159", "0x6d64bc82b93368a7f963d6c34483ca3893f405f6", "0xbc9c19f91878369776812039e4ebcdfa3c646716", "0xe3ed6fa287752b992f936b42360770c59731d9eb"]
getCommitteeSize
caver.klay.getCommitteeSize([defaultBlock] [, callback])
지정된 블록에서 위원회의 크기를 반환합니다. 매개 변수가 설정되지 않은 경우 가장 최근 블록의 위원회 크기를 반환합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
defaultBlock | Number | String | (선택 사항) 이 매개변수를 전달하면 caver.klay.defaultBlock으로 설정된 기본 블록을 사용하지 않습니다. |
callback | Function | (선택 사항) 선택적 콜백으로, 첫 번째 매개변수로 오류 객체를 반환하고 두 번째 매개변수로 결과를 반환합니다. |
리턴 값
Promise
는 number
- 위원회의 규모를 반환합니다.
예시
> caver.klay.getCommitteeSize().then(console.log);4
getCouncil
참고: getValidators
는 이 메서드로 대체되었으며 더 이상 지원되지 않습니다.
caver.klay.getCouncil([defaultBlock] [, callback])
지정된 블록에 있는 카운슬의 모든 검증자 목록을 반환합니다. 매개 변수가 설정되지 않은 경우 최신 블록에 있는 카운슬의 모든 검증자 목록을 반환합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
defaultBlock | Number | String | (선택 사항) 이 매개변수를 전달하면 caver.klay.defaultBlock으로 설정된 기본 블록을 사용하지 않습니다. |
callback | Function | (선택 사항) 선택적 콜백으로, 첫 번째 매개변수로 오류 객체를 반환하고 두 번째 매개변수로 결과를 반환합니다. |
리턴 값
Promise
는 카운슬의 모든 검증자의 주소인 Array
를 반환합니다.
예시
> caver.klay.getCouncil().then(console.log);[ "0x207e38864b45a538733741dc1ff92eff9d1a6159", "0x6d64bc82b93368a7f963d6c34483ca3893f405f6", "0xbc9c19f91878369776812039e4ebcdfa3c646716", "0xe3ed6fa287752b992f936b42360770c59731d9eb"]
getCouncilSize
caver.klay.getCouncilSize([defaultBlock] [, callback])
지정된 블록에서 카운슬의 크기를 반환합니다. 매개 변수가 설정되지 않은 경우 가장 최근 블록에서 카운슬의 크기를 반환합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
defaultBlock | Number | String | (선택 사항) 이 매개변수를 전달하면 caver.klay.defaultBlock으로 설정된 기본 블록을 사용하지 않습니다. |
callback | Function | (선택 사항) 선택적 콜백으로, 첫 번째 매개변수로 오류 객체를 반환하고 두 번째 매개변수로 결과를 반환합니다. |
리턴 값
Promise
는 number
- 카운슬의 규모를 반환합니다.
예시
> caver.klay.getCouncilSize().then(console.log);4
getStorageAt
caver.klay.getStorageAt(address, position [, defaultBlock] [, callback])
주소의 특정 위치에 있는 스토리지를 가져옵니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
address | String | 저장소를 가져올 주소입니다. |
location | Number | 스토리지의 인덱스 위치입니다. |
defaultBlock | Number | String | (선택 사항) 이 매개변수를 전달하면 caver.klay.defaultBlock으로 설정된 기본 블록이 사용되지 않습니다. |
callback | Function | (선택 사항) 선택적 콜백으로, 첫 번째 매개변수로 오류 객체를 반환하고 두 번째 매개변수로 결과를 반환합니다. |
리턴 값
Promise
는 주어진 위치에 저장된 값인 String
을 반환합니다.
예시
> caver.klay.getStorageAt("0x407d73d8a49eeb85d32cf465507dd71d507100c1", 0).then(console.log);"0x033456732123ffff2342342dd12342434324234234fd234fd23fd4f23d4234"
isMining
caver.klay.isMining([callback])
클라이언트가 새 블록을 활발하게 채굴하고 있으면 true
를 반환합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
callback | Function | (선택 사항) 선택적 콜백으로, 첫 번째 매개변수로 오류 객체를 반환하고 두 번째 매개변수로 결과를 반환합니다. |
리턴 값
Promise
는 클라이언트가 채굴 중이면 boolean
- true
을 반환하고, 그렇지 않으면 false
을 반환합니다.
예시
> caver.klay.isMining().then(console.log);true
isSyncing
caver.klay.isSyncing([callback])
노드가 현재 동기화 중인지 확인하고 동기화 객체 또는 false
를 반 환합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
callback | Function | (선택 사항) 선택적 콜백으로, 첫 번째 매개변수로 오류 객체를 반환하고 두 번째 매개변수로 결과를 반환합니다. |
리턴 값
Promise
는 노드가 현재 동기화 중이거나 false
일 때 동기화 오브젝트인 Object|Boolean
을 반환합니다:
이름 | 유형 | 설명 |
---|---|---|
startingBlock | Number | 동기화가 시작된 블록 번호입니다. |
currentBlock | Number | 노드가 현재 동기화된 블록의 블록 번호입니다. |
highestBlock | Number | 동기화할 예상 블록 번호입니다. |
knownStates | Number | 다운로드할 것으로 예상되는 상태입니다. |
pulledStates | Number | 이미 다운로드한 상태입니다. |
예시
> caver.klay.isSyncing().then(console.log);{ startingBlock: 100, currentBlock: 312, highestBlock: 512, knownStates: 234566, pulledStates: 123455}