关于区块链:PoS-RPC

141次阅读

共计 10138 个字符,预计需要花费 26 分钟才能阅读完成。

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"

基本概念

epoch

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

round

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

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

block.number

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

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

pivotDecision

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

PoS Address

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

0x046ca462890f25ed9394ca9f92c979ff48e1738a81822ecab96d83813c1a433c

PoS Model

AccountStatus

一个账户注册参加 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 – 账户历史累计解锁的总票数

Decision

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

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

VotesInQueue

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

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

RPCs

pos_getStatus

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

Parameters

Empty

Returns

Object – PoS status object.

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

Example

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_getAccount

获取 PoS 的账户信息

Parameters

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

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

Returns

Object – 账户对象,或者 null(如果地址对应的账户不存在)

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

Example

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_getCommittee

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

Parameters

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

Returns

  • 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 名用户

Example

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
}

pos_getBlockByHash

依据 hash 获取区块信息

Parameters

  1. HASH: 区块 hash
params: ["0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b"]

Returns

  • 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 – 签名账户的票数

Example

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
}

pos_getBlockByNumber

依据区块号获取区块信息

Parameters

  1. QUANTITY|TAG: 区块编号或者区块 TAG(latest_committed, latest_voted

Returns

跟 pos_getBlockByHash 雷同

Example

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_getRewardsByEpoch

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

Parameters

  1. QUANTITY: 纪元编号
params: ["0x4a"]

Returns

  • 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
}

pos_getTransactionByNumber

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

Parameters

  1. QUANTITY: 交易编号
params: ["0x4a"]

Returns

交易详情

  • 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):

Register: 注册

  • 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

正文完
 0