2. 指令介绍(API)¶
2.1. 节点rpc接口¶
详细见：pb/xchain.proto
API |
功能 |
|---|---|
rpc createAccount(AccountInput) returns (AccountOutput) |
创建公私钥对 |
rpc GenerateTx(TxData) returns (TxStatus) |
生成交易 |
rpc PostTx(TxStatus) returns (CommonReply) |
对一个交易进行验证并转发给附近网络节点 |
rpc BatchPostTx(BatchTxs) returns (CommonReply) |
对一批交易进行验证并转发给附近网络节点 |
rpc QueryAcl(AclStatus) returns (AclStatus) |
查询合约账号/合约方法的Acl |
rpc QueryTx(TxStatus) returns (TxStatus) |
查询一个交易 |
rpc GetBalance(AddressStatus) returns (AddressStatus) |
查询可用余额 |
rpc GetFrozenBalance(AddressStatus) returns (AddressStatus) |
查询被冻结的余额 |
rpc SendBlock(Block) returns (CommonReply) |
将当前区块为止的所有区块上账本 |
rpc GetBlock(BlockID) returns (Block) |
从当前账本获取特定区块 |
rpc GetBlockChainStatus(BCStatus) returns (BCStatus) |
获取账本的最新区块数据 |
rpc ConfirmBlockChainStatus(BCStatus) returns (BCTipStatus) |
判断某个区块是否为账本主干最新区块 |
rpc GetBlockChains(CommonIn) returns (BlockChains) |
获取所有的链名 |
rpc GetSystemStatus(CommonIn) returns (SystemsStatusReply) |
获取系统状态 |
rpc GetNetUrl(CommonIn) returns (RawUrl) |
获取区块链网络中某个节点的url |
rpc GenerateAccountByMnemonic(GenerateAccountByMnemonicInput) returns (AccountMnemonicInfo) |
创建一个带助记词的账号 |
rpc CreateNewAccountWithMnemonic(CreateNewAccountWithMnemonicInput) returns (AccountMnemonicInfo) |
通过助记词恢复账号 |
rpc MergeUTXO (TxData) returns (CommonReply) |
将同一个地址的多个余额项合并 |
rpc SelectUTXOV2 (UtxoInput) returns(UtxoOutput) |
查询一个地址/合约账户对应的余额是否足够 |
rpc QueryContract(QueryContractRequest) returns (QueryContractResponse) |
查询合约数据 |
2.2. 开发者接口¶
详细见：contractsdk/pb/contract.proto
API |
功能 |
|---|---|
rpc PutObject(PutRequest) returns (PutResponse) |
产生一个读加一个写 |
rpc GetObject(GetRequest) returns (GetResponse) |
生成一个读请求 |
rpc DeleteObject(DeleteRequest) returns (DeleteResponse) |
产生一个读加一个特殊的写 |
rpc NewIterator(IteratorRequest) returns (IteratorResponse) |
对迭代的key产生读 |
rpc QueryTx(QueryTxRequest) returns (QueryTxResponse) |
查询交易 |
rpc QueryBlock(QueryBlockRequest) returns (QueryBlockResponse) |
查询区块 |
rpc ContractCall(ContractCallRequest) returns (ContractCallResponse) |
合约调用 |
rpc Ping(PingRequest) returns (PingResponse) |
探测是否存活 |