message AddressStatus {
    Header header = 1;
    string address = 2;
    repeated TokenDetail bcs = 3;
}

message TokenDetail {
    string bcname = 1;
    string balance = 2;
    XChainErrorEnum error = 3;
}

message Header {
    string logid = 1;
    string from_node = 2;
    XChainErrorEnum error = 3;
}

opts := make([]grpc.DialOption, 0)
opts = append(opts, grpc.WithInsecure())
opts = append(opts, grpc.WithMaxMsgSize(64<<20-1))
conn,  := grpc.Dial(“127.0.0.1:37101”, opts…)
cli := pb.NewXchainClient(conn)
bc := &pb.TokenDetail{
    Bcname: “xuper”,
}
in := &pb.AddressStatus{
    Header: utils.GenLogId(),
    Address: “dpzuVdosQrF2kmzumhVeFQZa1aYcdgFpN”,
    Bcs: []*pb.TokenDetail{bc},
}
out,  := cli.GetBalance(context.Background(), in)

message AddressBalanceStatus {
    Header header = 1;
    string address = 2;
    repeated TokenFrozenDetails tfds = 3;
}

opts := make([]grpc.DialOption, 0)
opts = append(opts, grpc.WithInsecure())
opts = append(opts, grpc.WithMaxMsgSize(64<<20-1))
conn,  := grpc.Dial(“127.0.0.1:37101”, opts…)
cli := pb.NewXchainClient(conn)
tfd := &pb.TokenFrozenDetails{
    Bcname: “xuper”,
}
in := &pb.AddressBalanceStatus{
    Header: utils.GenLogId(),
    Address: “dpzuVdosQrF2kmzumhVeFQZa1aYcdgFpN”,
    Tfds: []*pb.TokenFrozenDetails{bc},
}
out,  := cli.GetBalanceDetail(context.Background(), in)

message BlockID {
    Header header = 4;
    string bcname = 1;
    bytes blockid = 2;
    bool need_content = 3;  //是否需要内容
}

opts := make([]grpc.DialOption, 0)
opts = append(opts, grpc.WithInsecure())
opts = append(opts, grpc.WithMaxMsgSize(64<<20-1))
conn,  := grpc.Dial(“127.0.0.1:37101”, opts…)
cli := pb.NewXchainClient(conn)
id,  := hex.DecodeString(“ee0d6fd34df4a7e1540df309d47441af4fda6fdd9d841046f18e7680fe0cea8c”)
in := &pb.BlockID{
    Header: utils.GenLogId(),
    Bcname: “xuper”,
    Blockid: id,
    NeedContent: true,
}
out, _ := cli.GetBlock(context.Background(), in)

message BlockHeight {
    Header header = 3;
    string bcname = 1;
    int64 height = 2;
}

message BCStatus {
    Header header = 1;
    string bcname = 2;
    LedgerMeta meta = 3;
    InternalBlock block = 4;
    UtxoMeta utxoMeta = 5;
    repeated string branchBlockid = 6;
}

opts := make([]grpc.DialOption, 0)
opts = append(opts, grpc.WithInsecure())
opts = append(opts, grpc.WithMaxMsgSize(64<<20-1))
conn,  := grpc.Dial(“127.0.0.1:37101”, opts…)
cli := pb.NewXchainClient(conn)
in := &pb.BCStatus{
    Header: utils.GenLogId(),
    Bcname: “xuper”,
}
out,  := cli.GetBlockChainStatus(context.Background(), in)

opts := make([]grpc.DialOption, 0)
opts = append(opts, grpc.WithInsecure())
opts = append(opts, grpc.WithMaxMsgSize(64<<20-1))
conn,  := grpc.Dial(“127.0.0.1:37101”, opts…)
cli := pb.NewXchainClient(conn)
in := &pb.CommonIn{
    Header: utils.GenLogId(),
}
out,  := cli.GetBlockChains(context.Background(), in)

message AclStatus {
    Header header = 1;
    string bcname = 2;
    string accountName = 3;
    string contractName = 4;
    string methodName = 5;
    bool confirmed = 6;
    Acl acl = 7;
}

in := &pb.AclStatus{
    Header: utils.GenLogId(),
    Bcname: “xuper”,
    AccountName: “XC1111111111111111@xuper”,
}
out, _ := cli.QueryACL(context.Background(), in)

message TxStatus {
    Header header = 1;
    string bcname = 2;
    bytes txid = 3;
    TransactionStatus status = 4;  //当前状态
    int64 distance = 5;  //离主干末端的距离（如果在主干上)
    Transaction tx = 7;
}

id,  := hex.DecodeString(“763ac8212c80b8789cefd049f1529eafe292f4d64eaffbc2d5fe19c79062a484”)
in := &pb.AclStatus{
    Header: utils.GenLogId(),
    Bcname: “xuper”,
    Txid: id,
}
out,  := cli.QueryTx(context.Background(), in)

message UtxoInput {
    Header header = 1;
    // which bcname to select
    string bcname = 2;
    // address to select
    string address = 3;
    // publickey of the address
    string publickey = 4;
    // totalNeed refer the total need utxos to select
    string totalNeed = 5;
    // userSign of input
    bytes userSign = 7;
    // need lock
    bool needLock = 8;
}

in := &pb.UtxoInput{
    Header: utils.GenLogId(),
    Bcname: “xuper”,
    Address: “dpzuVdosQrF2kmzumhVeFQZa1aYcdgFpN”,
    TotalNeed: “50”,
    NeedLock: true,
}
out, _ := cli.SelectUTXO(context.Background(), in)

message InvokeRPCRequest {
    Header header = 1;
    string bcname = 2;
    repeated InvokeRequest requests = 3;
    string initiator = 4;
    repeated string auth_require = 5;
}

message InvokeRequest {
    string module_name = 1;
    string contract_name = 2;
    string method_name = 3;
    map<string, bytes> args = 4;
    repeated ResourceLimit resource_limits = 5;
    string amount = 6;
}

message PreExecWithSelectUTXORequest {
    Header header = 1;
    string bcname = 2;
    string address = 3;
    int64 totalAmount = 4;
    SignatureInfo signInfo = 6;
    bool needLock = 7;
    InvokeRPCRequest request = 5;
}

message Transaction {
    // txid is the id of this transaction
    bytes txid = 1;
    // the blockid the transaction belong to
    bytes blockid = 2;
    // Transaction input list
    repeated TxInput tx_inputs = 3;
    // Transaction output list
    repeated TxOutput tx_outputs = 4;
    // Transaction description or system contract
    bytes desc = 6;
    // Mining rewards
    bool coinbase = 7;
    // Random number used to avoid replay attacks
    string nonce = 8;
    // Timestamp to launch the transaction
    int64 timestamp = 9;
    // tx format version; tx格式版本号
    int32 version = 10;
    // auto generated tx
    bool autogen = 11;
    repeated TxInputExt tx_inputs_ext = 23;
    repeated TxOutputExt tx_outputs_ext = 24;
    repeated InvokeRequest contract_requests = 25;
    // 权限系统新增字段
    // 交易发起者, 可以是一个Address或者一个Account
    string initiator = 26;
    // 交易发起需要被收集签名的AddressURL集合信息，包括用于utxo转账和用于合约调用
    repeated string auth_require = 27;
    // 交易发起者对交易元数据签名，签名的内容包括auth_require字段
    repeated SignatureInfo initiator_signs = 28;
    // 收集到的签名
    repeated SignatureInfo auth_require_signs = 29;
    // 节点收到tx的时间戳，不参与签名
    int64 received_timestamp = 30;
    // 统一签名(支持多重签名/环签名等，与initiator_signs/auth_require_signs不同时使用)
    XuperSignature xuper_sign = 31;
    // 可修改区块链标记
     ModifyBlock modify_block = 32;
    // HD加解密相关信息
    HDInfo HD_info = 33;
}

// 获取Alice的utxo
utxoreq := &pb.UtxoInput{
    Header: utils.GenLogId(),
    Bcname: “xuper”,
    Address: addralice,
    TotalNeed: “10”,
    NeedLock: true,
}
utxorsp,  := cli.SelectUTXO(context.Background(), utxoreq)
// 声明一个交易，发起者为Alice地址，因为是转账，所以Desc字段什么都不填
// 如果是提案等操作，将客户端的 —desc 参数写进去即可
tx := &pb.Transaction{
    Version: 1,
    Coinbase: false,
    Desc: []byte(“”),
    Nonce: global.GenNonce(),
    Timestamp: time.Now().UnixNano(),
    Initiator: addralice,
}
// 填充交易的输入，即Select出来的Alice的utxo
for , utxo := range utxorsp.UtxoList {
    txin := &pb.TxInput{
        RefTxid: utxo.RefTxid,
        RefOffset: utxo.RefOffset,
        FromAddr: utxo.ToAddr,
        Amount: utxo.Amount,
    }
    tx.TxInputs = append(tx.TxInputs, txin)
}
// 填充交易的输出，即给Bob的utxo，注意Amount字段的类型
amount,  := big.NewInt(0).SetString(“10”, 10)
txout := &pb.TxOutput{
    ToAddr: []byte(addr_bob),
    Amount: amount.Bytes(),
}
tx.TxOutputs = append(tx.TxOutputs, txout)
// 如果Select出来的Alice的utxo多于10，需要构造一个给Alice的找零
total,  := big.NewInt(0).SetString(utxorsp.TotalSelected, 10)
if total.Cmp(amount) > 0 {
    delta := total.Sub(total, amount)
    charge := &pb.TxOutput{
        ToAddr: []byte(addralice),
        Amount: delta.Bytes(),
    }
    tx.TxOutputs = append(tx.TxOutputs, charge)
}
// 接下来用Alice的私钥对交易进行签名，在此交易中，我们只需Alice签名确认即可
tx.AuthRequire = append(tx.AuthRequire, addr_alice)
// 签名需要的库在 github.com/xuperchain/xuperchain/core/crypto/client
// 和 github.com/xuperchain/xuperchain/core/crypto/hash
cryptoCli,  := client.CreateCryptoClient(“default”)
sign,  := txhash.ProcessSignTx(cryptoCli, tx, []byte(pri_alice))
signInfo := &pb.SignatureInfo{
    PublicKey: pub_alice,
    Sign: sign,
}
// 将签名填充进交易
tx.InitiatorSigns = append(tx.InitiatorSigns, signInfo)
tx.AuthRequireSigns = append(tx.AuthRequireSigns, signInfo)
// 生成交易ID
tx.Txid,  = txhash.MakeTransactionID(tx)
// 构造最终要Post的TxStatus
txs := &pb.TxStatus{
    Bcname: “xuper”,
    Status: pb.TransactionStatus_UNCONFIRM,
    Tx: tx,
    Txid: tx.Txid,
}
// 最后一步，执行PostTx
rsp, err := cli.PostTx(context.Background(), txs)
// 这里的rsp即CommonReply，包含logid等内容
// 交易id我们已经生成在tx.Txid中，不过是bytes，输出可能需要hex.EncodeToString一下

{
    “pm”: {
        “rule”: 1,
        “acceptValue”: 1.0
    },
    “aksWeight”: {
        “XXXaddress-aliceXXX” : 0.6,
        “XXXXaddress-bobXXXX” : 0.4
    }
}

// 构造创建合约账号的请求
args := make(map[string][]byte)
args[“accountname”] = []byte(1234567812345678)
args[“acl”] = []byte(acct_acl)
invokereq := &pb.InvokeRequest{
    ModuleName: “xkernel”,
    MethodName: “NewAccount”,
    Args: args,
}
invokereqs := []*pb.InvokeRequest{invokereq}
// 构造合约预执行的请求
authrequire := []string{addr_alice}
rpcreq := &pb.InvokeRPCRequest{
    Header: utils.GenLogId(),
    Bcname: “xuper”,
    Requests: invokereqs,
    Initiator: addr_alice,
    AuthRequire: authrequire,
}
// 花手续费需要出资的账号确认，填充一个验证的签名，才能正确的拿出utxo来
// 签名需要的库在 github.com/xuperchain/xuperchain/core/crypto/client
// 和 github.com/xuperchain/xuperchain/core/crypto/hash
content := hash.DoubleSha256([]byte(“xuper” + addr_alice + “0” + “true”))
cryptoCli,  := client.CreateCryptoClient(“default”)
prikey,  := cryptoCli.GetEcdsaPrivateKeyFromJSON([]byte(pri_alice))
sign,  := cryptoCli.SignECDSA(prikey, content)
signInfo := &pb.SignatureInfo{
    PublicKey: pubalice,
    Sign: sign,
}
// 组合一个PreExecWithSelectUTXORequest用来预执行同时拿出需要支付的Alice的utxo
prereq := &pb.PreExecWithSelectUTXORequest{
    Header: utils.GenLogId(),
    Bcname: “xuper”,
    Address: addr_alice,
    TotalAmount: 0,
    SignInfo: signInfo,
    NeedLock: true,
    Request: rpcreq,
}
prersp := cli.PreExecWithSelectUTXO(context.Background(), prereq)
// 构造一个Alice发起的交易
tx := &pb.Transaction{
    Version: 1,
    Coinbase: false,
    Desc: []byte(“”),
    Nonce: global.GenNonce(),
    Timestamp: time.Now().UnixNano(),
    Initiator: addr_alice,
}
// 填充支付的手续费，手续费需要“转账”给地址“$”
amount := big.NewInt(prersp.Response.GasUsed)
fee := &pb.TxOutput{
    ToAddr: []byte(“$”),
    Amount: amount.Bytes(),
}
tx.TxOutputs = append(tx.TxOutputs, fee)
// 填充select出来的Alice的utxo
for , utxo := range prersp.UtxoOutput.UtxoList {
    txin := &pb.TxInput{
        RefTxid: utxo.RefTxid,
        RefOffset: utxo.RefOffset,
        FromAddr: utxo.ToAddr,
        Amount: utxo.Amount,
    }
    tx.TxInputs = append(tx.TxInputs, txin)
}
// 处理找零的逻辑
total,  := big.NewInt(0).SetString(prersp.UtxoOutput.TotalSelected, 10)
if total.Cmp(amount) > 0 {
    delta := total.Sub(total, amount)
    charge := &pb.TxOutput{
        ToAddr: []byte(addr_alice),
        Amount: delta,
    }
}
// 填充预执行的结果
tx.ContractRequests = prersp.GetResponse().GetRequests()
tx.TxInputsExt = prersp.GetResponse().GetInputs()
tx.TxOutputsExt = prersp.GetResponse().GetOutputs()
// 给交易签名
tx.AuthRequire = append(tx.AuthRequire, addr_alice)
txsign,  := txhash.ProcessSignTx(cryptoCli, tx, []byte(prialice))
txsignInfo := &pb.SignatureInfo{
    PublicKey: pub_alice,
    Sign: txsign,
}
tx.InitiatorSigns = append(tx.InitiatorSigns, txsignInfo)
tx.AuthRequireSigns = append(tx.AuthRequireSigns, txsignInfo)
// 生成交易ID
tx.Txid,  = txhash.MakeTransactionID(tx)
// 构造最终要Post的TxStatus
txs := &pb.TxStatus{
    Bcname: “xuper”,
    Status: pb.TransactionStatus_UNCONFIRM,
    Tx: tx,
    Txid: tx.Txid,
}
// 最后一步，执行PostTx
rsp, err := cli.PostTx(context.Background(), txs)

{
    “pm”: {
        “rule”: 1,
        “acceptValue”: 1.0
    },
    “aksWeight”: {
        “XXXaddress-aliceXXX” : 1.0,
        “XXXXaddress-bobXXXX” : 1.0
    }
}

// 构造修改ACL的请求
args := make(map[string][]byte)
args[“accountname”] = []byte(1234567812345678)
args[“acl”] = []byte(new_acl)
invokereq := &pb.InvokeRequest{
    ModuleName: “xkernel”,
    MethodName: “SetAccountAcl”,
    Args: args,
}
invokereqs := []*pb.InvokeRequest{invokereq}
// 构造合约预执行的请求，和上一节一样，此处省略
///////////////////////////////////////////////
// 花手续费需要出资的账号确认，填充验证的签名，和上一节一样，此处省略
/////////////////////////////////////////////////////////////////////
// 按上一节逻辑一样，填充花费、找零，然后填充预执行的结果
tx.ContractRequests = prersp.GetResponse().GetRequests()
tx.TxInputsExt = prersp.GetResponse().GetInputs()
tx.TxOutputsExt = prersp.GetResponse().GetOutputs()
// 给交易签名需要原ACL里的多个账号了
tx.AuthRequire = append(tx.AuthRequire, addr_alice)
tx.AuthRequire = append(tx.AuthRequire, addr_bob)
alicesign,  := txhash.ProcessSignTx(cryptoCli, tx, []byte(prialice))
alicesignInfo := &pb.SignatureInfo{
    PublicKey: pub_alice,
    Sign: alicesign,
}
bobsign,  := txhash.ProcessSignTx(cryptoCli, tx, []byte(pribob))
bobsignInfo := &pb.SignatureInfo{
    PublicKey: pub_bob,
    Sign: bobsign,
}
tx.InitiatorSigns = append(tx.InitiatorSigns, alicesignInfo)
tx.AuthRequireSigns = append(tx.AuthRequireSigns, alicesignInfo)
tx.AuthRequireSigns = append(tx.AuthRequireSigns, bobsignInfo)
// 然后和上一节一致了，生成交易ID
tx.Txid,  = txhash.MakeTransactionID(tx)
// 构造最终要Post的TxStatus
txs := &pb.TxStatus{
    Bcname: “xuper”,
    Status: pb.TransactionStatus_UNCONFIRM,
    Tx: tx,
    Txid: tx.Txid,
}
// 最后一步，执行PostTx
rsp, err := cli.PostTx(context.Background(), txs)

// 构造部署合约的请求，关注args的内容，基本上和使用xchain-cli一致
args := make(map[string][]byte)
args[“accountname”] = []byte(“XC1234567812345678@xuper”)
args[“contract_name”] = []byte(“counter”)
// github.com/golang/protobuf/proto
codedesc := desc := &pb.WasmCodeDesc{
    Runtime: “c”,
}
desc,  := proto.Marshal(codedesc)
args[“contractdesc”] = desc
args[“contract_code”] = contract_code
initarg := {"creator":" + base64.StdEncoding.EncodeToString([]byte(“xchain”)) + "}
args[“init_args”] = []byte(initarg)
invokereq := &pb.InvokeRequest{
    ModuleName: “xkernel”,
    MethodName: “Deploy”,
    Args: args,
}
invokereqs := []*pb.InvokeRequest{invokereq}
// 这里预执行的authrequire格式为 XC1234567812345678@xuper/dpzuVdosQrF2kmzumhVeFQZa1aYcdgFpN，
// 表示是“某个合约账号的股东”，与直接写账号地址含义是不同的，ACL需求多个签名的时候即多个“股东”
authrequires := []string{“XC1234567812345678@xuper/XXXaddress-aliceXXX”}
rpcreq := &pb.InvokeRPCRequest{
    Header: utils.GenLogId(),
    Bcname: “xuper”,
    Requests: invokereqs,
    Initiator: addr_alice,
    AuthRequire: authrequires,
}
// SelectUTXO的目标是合约账号中的余额，出资账号签名中的地址变成了合约账号，与“创建账号”小节有区别
content := hash.DoubleSha256([]byte(“xuper” + “XC1234567812345678@xuper” + “0” + “true”))
prikey,  := cryptoCli.GetEcdsaPrivateKeyFromJSON([]byte(prialice))
sign,  := cryptoCli.SignECDSA(prikey, content)
signInfo := &pb.SignatureInfo{
    PublicKey: pubalice,
    Sign: sign,
}
// 组合一个PreExecWithSelectUTXORequest用来预执行同时拿出需要支付的合约账号的utxo
prereq := &pb.PreExecWithSelectUTXORequest{
    Header: utils.GenLogId(),
    Bcname: “xuper”,
    Address: “XC1234567812345678@xuper”,
    TotalAmount: 0,
    SignInfo: signInfo,
    NeedLock: true,
    Request: rpcreq,
}
prersp,  := cli.PreExecWithSelectUTXO(context.Background(), prereq)
// 构造一个Alice发起的交易
tx := &pb.Transaction{
    Version: 1,
    Coinbase: false,
    Desc: []byte(“”),
    Nonce: global.GenNonce(),
    Timestamp: time.Now().UnixNano(),
    Initiator: addralice,
}
// 填充支付的手续费，手续费需要“转账”给地址“$”
amount := big.NewInt(prersp.Response.GasUsed)
fee := &pb.TxOutput{
    ToAddr: []byte(“$”),
    Amount: amount.Bytes(),
}
tx.TxOutputs = append(tx.TxOutputs, fee)
// 填充select出来的Alice的utxo
for , utxo := range prersp.UtxoOutput.UtxoList {
    txin := &pb.TxInput{
        RefTxid: utxo.RefTxid,
        RefOffset: utxo.RefOffset,
        FromAddr: utxo.ToAddr,
        Amount: utxo.Amount,
    }
    tx.TxInputs = append(tx.TxInputs, txin)
}
// 处理找零的逻辑
total,  := big.NewInt(0).SetString(prersp.UtxoOutput.TotalSelected, 10)
if total.Cmp(amount) > 0 {
    delta := total.Sub(total, amount)
    charge := &pb.TxOutput{
        ToAddr: []byte(“XC1234567812345678@xuper”),
        Amount: delta,
    }
}
// 填充预执行的结果
tx.ContractRequests = prersp.GetResponse().GetRequests()
tx.TxInputsExt = prersp.GetResponse().GetInputs()
tx.TxOutputsExt = prersp.GetResponse().GetOutputs()
// 给交易签名，此处也是以“股东”身份签名
tx.AuthRequire = append(tx.AuthRequire, “XC1234567812345678@xuper/XXXaddress-aliceXXX”)
txsign,  := txhash.ProcessSignTx(cryptoCli, tx, []byte(prialice))
txsignInfo := &pb.SignatureInfo{
    PublicKey: pub_alice,
    Sign: txsign,
}
// 虽然Alice和“股东Alice”含义不同，但签名的私钥是一样的
tx.InitiatorSigns = append(tx.InitiatorSigns, signInfo)
tx.AuthRequireSigns = append(tx.AuthRequireSigns, signInfo)
tx.Txid,  = txhash.MakeTransactionID(tx)
// 构造最终要Post的TxStatus
txs := &pb.TxStatus{
    Bcname: “xuper”,
    Status: pb.TransactionStatus_UNCONFIRM,
    Tx: tx,
    Txid: tx.Txid,
}
// 最后一步，执行PostTx
rsp, err := cli.PostTx(context.Background(), txs)

// 构造执行合约的请求
args := make(map[string][]byte)
args[“key”] = []byte(“example”)
invokereq := &pb.InvokeRequest{
    ModuleName: “wasm”,
    MethodName: “increase”,
    ContractName: “counter”,
    Args: args,
}
invokereqs := []*pb.InvokeRequest{invokereq}
// 其他内容和“创建合约账号”一节完全一致