caver.rpc.governance
caver.rpc.governance
는 governance
네임 스페이스를 가진 JSON-RPC API를 제공합니다.
caver.rpc.governance.vote
새로 투표합니다. 거버넌스 모드에 의거하여 노드가 의결권을 가지면 투표할 수 있습니다. 그렇지 않으면 오류 메시지가 반환되고 투표 행위가 무시됩니다.
Parameters
Name | Type | Description |
---|---|---|
key | string | Key : 변경하고자 하는 환경설정의 이름입니다. 키는 domain.field의 형식으로 되어 있습니다. |
value | string | number | boolean | 각 키에 대한 값의 타입들입니다. |
callback | function | (선택 사항) 선택적 콜백(callback)은 오류 객체를 첫 번째 파라미터로, 결과를 두 번째 파라미터로 반환합니다. |
caver.rpc.governance.vote
의 key
나 value
에 대한 자세한 내용은 governance_vote를 참고해주세요.
Return Value
Promise
returns string
Type | Description |
---|---|
string | 투표 제출 결과입니다. |
Example
caver.rpc.governance.showTally
현재 거버넌스 표 합계를 제공합니다. 집계된 찬성률을 백분율로 나타냅니다. 찬성률이 50%인 경우 변경이 통과됩니다.
Parameters
Name | Type | Description |
---|---|---|
callback | function | (optional) Optional callback, which returns an error object as the first parameter and the result as the second. |
Return Value
Promise
는 array
를 반환합니다.
Type | Description |
---|---|
Array | 표의 값과 찬성률을 포함한 배열입니다. |
Example
caver.rpc.governance.getTotalVotingPower
CN이 지닌 의결권의 합을 제공합니다. Each CN has 1.0 ~ 2.0 voting power. "none", "single" 거버넌스 모드에서는 totalVotingPower 속성을 통해 제공하는 정보가 없습니다.
Parameters
Name | Type | Description |
---|---|---|
callback | function | (optional) Optional callback, which returns an error object as the first parameter and the result as the second. |
Return Value
Promise
returns number
Type | Description |
---|---|
number | 의결권의 총합입니다. |
Example
caver.rpc.governance.getMyVotingPower
노드의 의결권을 반환합니다. 의결권의 값은 1.0 ~ 2.0입니다. "none", "single" 거버넌스 모드에서는 totalVotingPower 속성을 통해 제공하는 정보가 없습니다.
Parameters
Name | Type | Description |
---|---|---|
callback | function | (optional) Optional callback, which returns an error object as the first parameter and the result as the second. |
Return Value
Promise
returns number
Type | Description |
---|---|
number | 노드의 의결권입니다. |
Example
caver.rpc.governance.getMyVotes
투표 주기 내 투표 정보를 반환합니다. Each vote is stored in a block when the user's node generates a new block. After current epoch ends, this information is cleared.
Parameters
Name | Type | Description |
---|---|---|
callback | function | (optional) Optional callback, which returns an error object as the first parameter and the result as the second. |
Return Value
Promise
returns Array
Type | Description |
---|---|
Array | 투표 주기 내 노드의 투표 상태입니다. |
Example
caver.rpc.governance.getChainConfig
최초 체인 환경설정을 제공합니다. 이 속성은 초기 환경설정만 저장하기 때문에 투표에 의해 거버넌스에 변경 사항이 있다면 chainConfig의 결과는 현재 상태와 달라질 것입니다. 현재 정보를 확인하려면 itemsAt을 사용하세요.
Parameters
Name | Type | Description |
---|---|---|
callback | function | (optional) Optional callback, which returns an error object as the first parameter and the result as the second. |
Return Value
Promise
는 object
를 반환합니다.
Type | Description |
---|---|
object | 체인의 최초 환경설정입니다. |
Example
caver.rpc.governance.getNodeAddress
사용자의 노드 주소를 제공합니다. It is derived from the nodekey and used to sign consensus messages. 그리고 "governingnode"의 값은 검증자의 노드 중 하나의 주소가 되어야 합니다.
Parameters
Name | Type | Description |
---|---|---|
callback | function | (optional) Optional callback, which returns an error object as the first parameter and the result as the second. |
Return Value
Promise
returns string
Type | Description |
---|---|
string | 노드의 주소입니다. |
Example
caver.rpc.governance.getItemsAt
특정 블록에서의 거버넌스 항목을 반환합니다. It is the result of previous voting of the block and used as configuration for chain at the given block number.
Parameters
Name | Type | Description |
---|---|---|
blockNumberOrTag | number | string | (선택 사항) 블록 넘버, 또는 |
callback | function | (optional) Optional callback, which returns an error object as the first parameter and the result as the second. |
Return Value
Promise
returns object
Type | Description |
---|---|
object | 거버넌스 항목들입니다. |
Example
caver.rpc.governance.getPendingChanges
pendingChanges은 충분한 표를 받았지만, 아직 확정되지 않은 항목들의 목록을 반환합니다. At the end of the current epoch, these changes will be finalized and the result will be in effect from the epoch after next epoch.
Parameters
Name | Type | Description |
---|---|---|
callback | function | (optional) Optional callback, which returns an error object as the first parameter and the result as the second. |
Return Value
Promise
returns object
Type | Description |
---|---|
object | 현재 보류 중인 변경 항목들의 키-밸류 쌍입니다. |
Example
caver.rpc.governance.getIdxCache
메모리 캐시 내 현재 idxCache 배열을 반환합니다. idxCache contains the block numbers where governance change happened. The cache can have up to 1000 block numbers in memory by default.
Parameters
Name | Type | Description |
---|---|---|
callback | function | (optional) Optional callback, which returns an error object as the first parameter and the result as the second. |
Return Value
Promise
returns object
Type | Description |
---|---|
Array | 거버넌스 내용이 변경되었던 블록의 번호입니다. |
Example
caver.rpc.governance.getIdxCacheFromDb
거버넌스에 변화가 한번이라도 있었던 블록의 번호를 포함하는 배열을 반환합니다. idxCacheFromDb의 결과의 길이는 idxCache와 같거나 더 깁니다.
Parameters
Name | Type | Description |
---|---|---|
callback | function | (optional) Optional callback, which returns an error object as the first parameter and the result as the second. |
Return Value
Promise
returns object
Type | Description |
---|---|
Array | Block numbers where governance change happened. |
Example
caver.rpc.governance.getItemCacheFromDb
특정 블록에 저장된 거버넌스 정보를 반환합니다. 해당 블록에 변경 사항이 저장되어 있지 않다면 함수는 null을 반환합니다.
Parameters
Name | Type | Description |
---|---|---|
callback | function | (optional) Optional callback, which returns an error object as the first parameter and the result as the second. |
Parameters
Name | Type | Description |
---|---|---|
blockNumber | number | string | 거버넌스 내용 변경이 이루어졌는지 확인할 블록의 번호, 16진수 문자열입니다. |
Return Value
Promise
returns object
Type | Description |
---|---|
object | 특정 블록에 저장된 거버넌스 정보입니다. |
Example
caver.rpc.governance.getVotes
투표 주기 내 모든 노드의 투표 상태를 반환합니다. These votes are gathered from the header of each block.
Parameters
Name | Type | Description |
---|---|---|
callback | function | (optional) Optional callback, which returns an error object as the first parameter and the result as the second. |
Return Value
Promise
returns object
Type | Description |
---|---|
Array | 키, 값, 노드 주소로 구성된 현재 투표 정보입니다. |
Example
caver.rpc.governance.getStakingInfo
특정 블록에서의 스테이킹 정보를 반환합니다.
Parameters
Name | Type | Description |
---|---|---|
blockNumberOrTag | number | string | (optional) A block number, or the string |
callback | function | (optional) Optional callback, which returns an error object as the first parameter and the result as the second. |
Return Value
Promise
returns object
Type | Description |
---|---|
object | 스테이킹 정보입니다. 반환값의 대한 설명은 governance_getStakingInfo을 참고하세요. |
Example
Last updated