关于区块链:PoS-RPC

id	title	custom_edit_url	keywords
pos_rpc	PoS JSON RPC	https://github.com/Conflux-Ch…	conflux pos-rpc sdk

conflux-rust 从 v2.0.0 开始引入 PoS finality 机制，用于放慢区块的最终性，从而避免 51% 攻打。PoS finality 机制会引入一条独立的 PoS 链，用于实现 PoS 共识，并对 PoW 区块进行 finalize。绝对应的 PoS 也有本人专门的 RPC 办法，用于获取 PoS 链的数据。

目前只有 conflux-rust 的 archive node 能够对外提供 PoS RPC 服务，RPC 须要配置 public_rpc_apis 选项能力关上。

能够在以后关上的 RPC 办法组中，减少 pos 组。

public_rpc_apis = "safe,pos"

或者间接将 public_rpc_apis 设置为 all，关上所有 RPC 办法。

public_rpc_apis = "all"

PoS 中也有 epoch 的概念，能够了解为纪元。但跟 PoW 的 epoch 概念不太一样。一个 epoch 代表一届委员的任期，从 1 开始递增，每个 epoch 均匀对应 一个小时, 每过一个 epoch，委员会中的局部委员会被替换。参加 PoS 共识取得的处分也是按 epoch 来发放的。

round 中文翻译为 轮，PoS 链均匀会 每分钟 进行一轮共识，即尝试产生一个 PoS 块。亦即每个 epoch 会有 60 个 round，且每个 新的 epoch，round 会从新从 1 开始。

留神：并不是每个 round 都会产生一个区块，有可能会因为网络或共识失败导致无奈出块。

block.number 也就是区块的 height，每产生一个新的区块，number 会加一。

PoS 区块被某个委员会成员提议之后，会发送到网络中进行投票，当区块收集到足够多的票数之后即为投票胜利 voted，但此时区块还没被 commit，当三个 round 间断的区块被产生后，最后的 round 对应的区块会被提交，状态变为 committed。

pivotDecision 是 PoS 链对 PoW 链区块的最终决定（final decision）. 一旦 PoW 的某个区块被 PoS 所援用，则代表该 PoW 区块曾经被 finalized，不会再产生 revert。PoS 链的区块会蕴含 PivotDecision 信息，示意该 PoS 区块对 PoW 主轴链的某个区块进行了 finalize。pivotDecision 信息是 PoW 主轴链的某个区块的 number 或者 hash。

PoS 账户地址跟 PoW 地址格局不同是一个 256 位 hash 值，例如：

0x046ca462890f25ed9394ca9f92c979ff48e1738a81822ecab96d83813c1a433c

一个账户注册参加 PoS 共识，或者减少质押的投票之后，票数首先会进入 inQueue 状态，通过 七天 工夫变为 locked 状态。
当用户发动解锁操作之后，待解锁的票券会先进入 outQueue 状态，同样须要通过 七天 工夫变为 unlocked 状态。

availableVotes: QUANTITY – 账户以后可用的票数, 等于 sum inQueue + locked
forfeited: QUANTITY – 账户被检测到作恶时，staked 票数会被锁死，无奈提取的数量
forceRetired: [QUANTITY] – 账户被强制退休时的区块数
inQueue: Array of VotesInQueue – 以后正在期待锁定的队列
locked: QUANTITY – 账户以后被锁定的票数
outQueue: Array of VotesInQueue – 以后正在期待解锁的队列
unlocked: QUANTITY – 账户历史累计解锁的总票数

PoS 链对 PoW 主轴链的高度的决定, 被决定的 PoW 的区块，即为 Finialized 的区块

height: QUANTITY – 主轴区块高度
blockHash: HASH – 主轴区块哈希

用户正在期待锁定或期待解锁票权信息。

endBlockNumber: QUANTITY – 状态完结的区块号
power: QUANTITY – 以后状态票的数量

返回 PoS 链以后的状态信息。

Empty

Object – PoS status object.

epoch: QUANTITY – PoS 链以后的纪元号
latestCommitted: QUANTITY – 最新被 commit 的区块号，commit 的区块不会再产生 revert
latestVoted: [QUANTITY] – 最近被胜利投票的区块号。如果以后没有实现投票的区块为 null
pivotDecision: Decision – 以后 PoS 链所 finalize 的最新 PoW 链的 决定

Request

curl --location --request POST 'http://localhost:12537' \
--header 'Content-Type: application/json' \
--data-raw '{"id": 1,"jsonrpc":"2.0","method":"pos_getStatus","params": []
}'

Result

{
    "jsonrpc": "2.0",
    "result": {
        "epoch": "0x56",
        "latestCommitted": "0x140c",
        "latestVoted": "0x140e",
        "pivotDecision": {
          "height": "0x113af0",
          "blockHash": "0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b"
        }
    },
    "id": 1
}

获取 PoS 的账户信息

1.ADDRESS: 32 Bytes – PoS 账户地址
2.[QUANTITY]: 可选的 block number，用于查问账户在某个区块高度时的状态

params: [
  "0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b",
  "0x100"
]

Object – 账户对象，或者 null（如果地址对应的账户不存在）

address: ADDRESS – 账户地址
blockNumber: QUANTITY – 状态所对应的区块号
status: OBJECT – 用户以后的状态信息对象，参看 Account Status

Request

curl --location --request POST 'http://localhost:12537' \
--header 'Content-Type: application/json' \
--data-raw '{"id": 1,"jsonrpc":"2.0","method":"pos_getAccount","params": ["0x046ca462890f25ed9394ca9f92c979ff48e1738a81822ecab96d83813c1a433c"]
}'

Response

{
    "jsonrpc": "2.0",
    "result": {
        "address": "0x046ca462890f25ed9394ca9f92c979ff48e1738a81822ecab96d83813c1a433c",
        "blockNumber": "0x14a7",
        "status": {
            "availableVotes": "0x513",
            "forfeited": "0x0",
            "forceRetired": null,
            "inQueue": [],
            "locked": "0x513",
            "outQueue": [],
            "unlocked": "0x0"
        }
    },
    "id": 1
}

默认获取以后的 PoS 委员会信息，也能够通过指定 blockNumber 获取历史某个区块时的委员会信息。

1.[QUANTITY]: 可选的 block number，用于查问某个区块高度时的委员会信息

currentCommittee: OBJECT – 以后委员会成员, 参看 CurrentCommittee
elections: Array – 正在参选中的人员

CurrentCommittee

以后委员会信息

epochNumber: QUANTITY – 委员会任期的 epoch 编号
nodes: Array of CommitteNode – 委员会成员列表
quorumVotingPower: QUANTITY – 区块投票达到共识所需最低票数
totalVotingPower: QUANTITY – 本届委员总共的票数

CommitteNode

委员信息

address: ADDRESS – 账户地址
votingPower: QUANTITY – 票数

Election

isFinalized: BOOLEAN – 本轮选举是否被确定
startBlockNumber: QUANTITY – 开始的区块编号
topElectingNodes: Array of CommitteNode – 参选排名最靠前的 50 名用户

Request

curl --location --request POST 'http://localhost:12537' \
--header 'Content-Type: application/json' \
--data-raw '{"id": 1,"jsonrpc":"2.0","method":"pos_getCommittee","params": []
}'

Response

{
    "jsonrpc": "2.0",
    "result": {
        "currentCommittee": {
            "epochNumber": "0x5a",
            "nodes": [
                {
                    "address": "0x046ca462890f25ed9394ca9f92c979ff48e1738a81822ecab96d83813c1a433c",
                    "votingPower": "0xc8"
                },
                {
                    "address": "0x459b19e745eb410c3696ff1ed15f9de9bb46aa5fefc27b0b6e8b8d7aaadfe8c0",
                    "votingPower": "0x32"
                }
            ],
            "quorumVotingPower": "0xa7",
            "totalVotingPower": "0xfa"
        },
        "elections": [
            {
                "isFinalized": false,
                "startBlockNumber": "0x1518",
                "topElectingNodes": [
                    {
                        "address": "0x046ca462890f25ed9394ca9f92c979ff48e1738a81822ecab96d83813c1a433c",
                        "votingPower": "0x2a"
                    },
                    {
                        "address": "0x459b19e745eb410c3696ff1ed15f9de9bb46aa5fefc27b0b6e8b8d7aaadfe8c0",
                        "votingPower": "0x8"
                    }
                ]
            },
            {
                "isFinalized": false,
                "startBlockNumber": "0x1554",
                "topElectingNodes": []}
        ]
    },
    "id": 1
}

依据 hash 获取区块信息

HASH: 区块 hash

params: ["0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b"]

epoch: QUANTITY – 区块所在的纪元
hash: HASH – 区块 hash
height: QUANTITY – 区块高度
miner: [ADDRESS] – 区块的创建者，可能为 null
nextTxNumber: QUANTITY – 下一区块交易的其实编号
parentHash: HASH – 父区块 hash
pivotDecision: Decision – 对 PoW 主轴链的决定
round: QUANTITY – 以后的轮次
signatures: Array of Signature – 区块的签名信息
timestamp: QUANTITY – 工夫戳

Signature

区块签名信息

account: ADDRESS – 签名的账户地址
votes: QUANTITY – 签名账户的票数

Request

curl --location --request POST 'http://localhost:12537' \
--header 'Content-Type: application/json' \
--data-raw '{"id": 1,"jsonrpc":"2.0","method":"pos_getBlockByHash","params": ["0x2b8b9d33e79e1735817a1278a9c8c5be828101b281bd4190531686153bee317b"]
}'

Response

{
    "jsonrpc": "2.0",
    "result": {
        "epoch": "0x5a",
        "hash": "0x2b8b9d33e79e1735817a1278a9c8c5be828101b281bd4190531686153bee317b",
        "height": "0x14ef",
        "miner": "0x046ca462890f25ed9394ca9f92c979ff48e1738a81822ecab96d83813c1a433c",
        "nextTxNumber": "0x1da7",
        "parentHash": "0x89cf3089296679dfef822d3dca037decab2a301de6f047e56c69cb34ae0b79e2",
        "pivotDecision": {
          "height": "0x113af0",
          "blockHash": "0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b"
        },
        "round": "0x13",
        "signatures": [
            {
                "account": "0x046ca462890f25ed9394ca9f92c979ff48e1738a81822ecab96d83813c1a433c",
                "votes": "0xc8"
            },
            {
                "account": "0x459b19e745eb410c3696ff1ed15f9de9bb46aa5fefc27b0b6e8b8d7aaadfe8c0",
                "votes": "0x32"
            }
        ],
        "timestamp": "0x5cce0e869522a"
    },
    "id": 1
}

依据区块号获取区块信息

QUANTITY|TAG: 区块编号或者区块 TAG（latest_committed, latest_voted）

跟 pos_getBlockByHash 雷同

Request

curl --location --request POST 'http://localhost:12537' \
--header 'Content-Type: application/json' \
--data-raw '{"id": 1,"jsonrpc":"2.0","method":"pos_getBlockByNumber","params": ["0x14ef"]
}'

返回某个 PoS epoch 发放处分的具体信息

QUANTITY: 纪元编号

params: ["0x4a"]

accountRewards: Array of AccountReward
powEpochHash: HASH – 处分发放时 PoW 链主轴区块的 hash

AccountReward

posAddress: ADDRESS – PoS 账户地址
powAddress: BASE32 – PoW 账户地址
reward: QUANTITY – 取得的处分数量，单位为 Drip

Example

Request

curl --location --request POST 'http://localhost:12537' \
--header 'Content-Type: application/json' \
--data-raw '{"id": 1,"jsonrpc":"2.0","method":"pos_getRewardsByEpoch","params": ["0x4a"]
}'

Response

{
    "jsonrpc": "2.0",
    "result": {
        "accountRewards": [
            {
                "posAddress": "0x459b19e745eb410c3696ff1ed15f9de9bb46aa5fefc27b0b6e8b8d7aaadfe8c0",
                "powAddress": "NET8888:TYPE.USER:AAKSNR7XKKFFAM17MNESKAGU076T8FAG3YJ6PTHN16",
                "reward": "0x14931d20aa21eae3e6f"
            },
            {
                "posAddress": "0x046ca462890f25ed9394ca9f92c979ff48e1738a81822ecab96d83813c1a433c",
                "powAddress": "NET8888:TYPE.USER:AAPXUPNXG96GZ4077DAV0151K7P8498N9A6DMAWK1N",
                "reward": "0x2d49549e023888cd390"
            }
        ],
        "powEpochHash": "0x361cb0f19fd13c30da467d20a84ef01aabcd55e9812c5e2fd0721ea11a52e9f1"
    },
    "id": 1
}

依据交易编号获取交易信息

QUANTITY: 交易编号

params: ["0x4a"]

交易详情

hash: HASH – 交易 hash
from: ADDRESS – 发送方地址
number: QUANTITY – 交易号
blockHash: [HASH] – 交易所属区块 hash
blockNumber: [QUANTITY] – 交易所属区块编码
payload: [OBJECT] – 交易次要数据，payload 内容依据交易类型不同而不同
status: [ENUM] – 交易的状态，可能值：Executed, Failed, Discard
timestamp: [QUANTITY] – 交易工夫戳
type: ENUM 交易的类型，可能值：BlockMetadata, Election, Retire, Register, UpdateVotingPower, PivoteDecision, Dispute, Other

payload 一共有六种（BlockMetadata 类型的交易 payload 为 null）:

vrfPublicKey: STRING – VRF 公钥
publicKey: STRING – 公钥

{
  "publicKey": "0x90901cc921cd86c6a67bdb7652a3dc4e03e069c6ef6d8294eb4e856e396bb10e2191996a914eaaa9dfdaa75f2a3d70a3",
  "vrfPublicKey": "0x02a0c4e36a2e9a3a2804486b7c849d0eb6f30094e3fe91a9015e9c16f9279fbff8"
}

Election: 选举

publicKey: STRING – 公钥
targetTerm: QUANTITY – 打算参选的委员会编号（epoch）
vrfProof: STRING – VRF 证实
vrfPublicKey: STRING – VRF 公钥

{
  "publicKey": "0x8abc04b696da9699601c595cf3a9539e657262d42eef6b63fb324bb5b987418bf5491b04ed21edce4296174cb6d95fcc",
  "targetTerm": "0x7",
  "vrfProof": "0x03c09bec671c32ca143f67f3f965cf913993a53cc268f12954649d54548afe70e75c87fda23fbd01cd9e4af184aa06af01adfa0fce92697e811635190935cecf48aca9804a12e604df6f19455d1ca59f4f",
  "vrfPublicKey": "0x03862bbe4b6591457ebf5d410ab12fe8e9bebe80171a8d2f73db45c5933a8173a4"
}

UpdateVotingPower: 减少投票交易

address: HASH – PoS 账号地址
votingPower: QUANTITY – 减少的票数

{
  "address": "0x52893f0ecd91f68b7db8a6eb04eb888b5ca1b208009eb9dfb434ad5da372f6f2",
  "votingPower": "0xb"
}

Retire: 退休投票

address: HASH – PoS 账号地址
votingPower: QUANTITY – 退休的票数

{
  "address": "c70a93136ddff3023c4c5244c2be9141d242cdcb11d7ed15c053728c959b87bc",
  "votingPower": "0xa"
}

PivotDecision: 主轴区块决定

height: QUANTITY – PoS 对 PoW 主轴决定的高度
blockHash: HASH – PoS 对 PoW 主轴决定的哈希

{
  "blockHash": "0x0abf7b384d8bb02a98f21d1582e6d465b1e2382978d5473cbceb473039b0eef3",
  "height": "0x2900"
}

Dispute: 争议

address: HASH – 账户地址
blsPublicKey: STRING – BLS 公钥
vrfPublicKey: STRING – VRF 公钥
conflictingVotes: ConflictingVotes – 有争议的投票信息

其中 ConflictingVotes 构造如下:

conflictVoteType: STRING – 争议类型可能值为 proposal, vote
first: STRING – 第一个投票
second: STRING – 第二个投票

Example

Request

curl --location --request POST 'http://localhost:12537' \
--header 'Content-Type: application/json' \
--data-raw '{"id": 1,"jsonrpc":"2.0","method":"pos_getTransactionByNumber","params": ["0x71"]
}'

Response

{
    "jsonrpc": "2.0",
    "result": {
        "blockHash": "0x355497700fc4c530c4eefa47c90deb052baaba4950934dfa6143f3c7321f3df1",
        "blockNumber": "0x3a",
        "from": "0x6f2e774cb8b83957d29e6a0b06551c11e632e1a0f46bee0d82b2fdc2b82fe4f9",
        "hash": "0x5505191e2f783e141fb8c84193829e494a27f197840987821514a12a0e04a10c",
        "number": "0x71",
        "payload": {
            "blockHash": "0xd66e1d6050d7070cab189a524782381e211508fa204a0674ea35fa1523cfba90",
            "height": "0x129"
        },
        "status": "Executed",
        "timestamp": "0x5cd05bea6a9b0",
        "type": "PivotDecision"
    },
    "id": 1
}

相干文章：

Conflux 开发材料包
conflux-chain github
conflux-fans github

基本概念

epoch

round

block.number

pivotDecision

PoS Address

PoS Model

AccountStatus

Decision

VotesInQueue

RPCs

pos_getStatus

Parameters

Returns

Example

pos_getAccount

Parameters

Returns

Example

pos_getCommittee

Parameters

Returns

CurrentCommittee

CommitteNode

Election

Example

pos_getBlockByHash

Parameters

Returns

Signature

Example

pos_getBlockByNumber

Parameters

Returns

Example

pos_getRewardsByEpoch

Parameters

Returns

AccountReward

Example

pos_getTransactionByNumber

Parameters

Returns

Example