# DoD Settlement
Supported protocols:
JSON-RPC 2.0 | Websocket | IPC | Publish–subscribe |
---|---|---|---|
✓ | ✓ | ✓ | TBD |
# DoDSettlement Scenario
Create Products Interface Calling Flow:
DoDSettlement_getCreateOrderBlock(as createBlock) By Buyer
DoDSettlement_getPendingRequest By Seller
DoDSettlement_getCreateOrderRewardBlock By Seller
Pass createBlock's previous hash as external ID to sonata API and Call sonata API to create products
DoDSettlement_getUpdateOrderInfoBlock By Buyer
DoDSettlement_GetPendingResourceCheck By Seller
DoDSettlement_getUpdateProductInfoBlock By Seller (update product id and product status)
can update product id and product status in one block or update product id first and then update product status
DoDSettlement_getUpdateOrderInfoRewardBlock By Seller
Change Products Interface Calling Flow:
DoDSettlement_getChangeOrderBlock(as changeBlock) By Buyer
DoDSettlement_getPendingRequest By Seller
DoDSettlement_getChangeOrderRewardBlock By Seller
Pass changeBlock's previous hash as external ID to sonata API and Call sonata API to change products
DoDSettlement_getUpdateOrderInfoBlock By Buyer
DoDSettlement_getUpdateProductInfoBlock By Seller (update product id and product status)
can update product id and product status in one block or update product id first and then update product status
DoDSettlement_getUpdateOrderInfoRewardBlock By Seller
Terminate Products Interface Calling Flow:
DoDSettlement_getTerminateOrderBlock(as terminateBlock) By Buyer
DoDSettlement_getPendingRequest By Seller
DoDSettlement_getTerminateOrderRewardBlock By Seller
Pass terminateBlock's previous hash as external ID to sonata API and Call sonata API to terminate products
DoDSettlement_getUpdateOrderInfoBlock By Buyer
DoDSettlement_GetPendingResourceCheck By Seller
DoDSettlement_getUpdateProductInfoBlock By Seller (update product id and product status)
can update product id and product status in one block or update product id first and then update product status
DoDSettlement_getUpdateOrderInfoRewardBlock By Seller
# DoDSettlement_getCreateOrderBlock
Generate a block to create a request for creating a connection or other product.
Parameters:
privateFrom
: sender's ptm key, if this is a private transactionprivateFor
: receiver's ptm key, if this is a private transactionprivateGroupID
: ptm group key, if this is a private transactionbuyer
: buyer infoaddress
: buyer's qlc addressname
: buyer's name
seller
: seller infoaddress
: seller's qlc addressname
: seller's name
connections
: array of connection paramsitemId
: item id of this connection (required)buyerProductId
: buyer product id, unique in this order at leastproductOfferingId
: productOffering id (required)quoteId
: id of the quotation (required)quoteItemId
: item id of the quotation (required)connectionName
:srcCompanyName
:srcRegion
:srcCity
:srcDataCenter
:srcPort
:dstCompanyName
:dstRegion
:dstCity
:dstDataCenter
:dstPort
:paymentType
: invoice/stablecoinbillingType
: PAYG/DODcurrency
:bandwidth
:billingUnit
: year/month/week/day/hour/minute/second, only for PAYGprice
:startTime
: need to be set when billingType is DODendTime
: need to be set when billingType is DODserviceClass
: gold/silver/bronze
Returns:
block
: a block
Example:
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getCreateOrderBlock",
"params": [
{
"buyer": {
"address": "qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"name": "CBC"
},
"seller": {
"address": "qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"name": "PCCWG"
},
"connections": [
{
"itemId": "item001",
"buyerProductId": "buyProductId001",
"productOfferingId": "productOfferingId001",
"quoteId": "quote001",
"quoteItemId": "quoteItemId001",
"connectionName": "connection665737529435949039",
"srcCompanyName": "CBC",
"srcRegion": "CHN",
"srcCity": "HK",
"srcDataCenter": "DCX",
"srcPort": "port1",
"dstCompanyName": "CBC",
"dstRegion": "USA",
"dstCity": "NYC",
"dstDataCenter": "DCY",
"dstPort": "port2",
"paymentType": "invoice",
"billingType": "PAYG",
"currency": "USD",
"bandwidth": "100 Mbps",
"billingUnit": "second",
"price": 1,
"startTime": 0,
"endTime": 0,
"serviceClass": "gold"
}
]
}
]
}
{
"jsonrpc": "2.0",
"id": 3,
"result": {
"type": "ContractSend",
"token": "89066d747a3c74ff1dec8ea6a7011bde010dd404aec454880f23d58cbf9280e4",
"address": "qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"balance": "10000000000000",
"vote": "0",
"network": "0",
"storage": "0",
"oracle": "0",
"previous": "01a88fc4afc87b866d3d0e7b15bed6e36ba9bd7ec5b4c02e1970189415f96901",
"link": "000000000000000000000000000000000000000000000000000000000000001d",
"message": "0000000000000000000000000000000000000000000000000000000000000000",
"data": "HS0P1IOhYoKhYccgYyeR1aFpfUVESPnuq6KjNuUi1XZ+VwsyYnj1UyGU9kLIoW6jQ0JDoXOCoWHHIGO7jRycrK4yZidr7UfxgtyqCbBtiROLWZ7bL3WpgVjhuKFupVBDQ1dHoWORgr5Eb0RTZXR0bGVDb25uZWN0aW9uU3RhdGljUGFyYW2LonBpoKNzY26jQ0JDonNyo0NITqJzY6JIS6NzZGOjRENYonNwpXBvcnQxo2RjbqNDQkOiZHKjVVNBomRjo05ZQ6NkZGOjRENZomRwpXBvcnQyv0RvRFNldHRsZUNvbm5lY3Rpb25EeW5hbWljUGFyYW2KomNuvGNvbm5lY3Rpb242NjU3Mzc1Mjk0MzU5NDkwMzmicHQBomJ0AaJjcqNVU0Sjc2NzAaJid6gxMDAgTWJwc6JidQehcMs/8AAAAAAAAKJzdACiZXQA",
"povHeight": 0,
"timestamp": 1589376428,
"extra": "2406ce1851f0487e575216af2ebd49f8ec574375aa7944b052ffaaddc3eb27eb",
"representative": "qlc_3hw8s1zubhxsykfsq5x7kh6eyibas9j3ga86ixd7pnqwes1cmt9mqqrngap4",
"work": "0000000000000000",
"signature": "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"
}
}
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getCreateOrderBlock",
"params": [
{
"buyer": {
"address": "qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"name": "CBC"
},
"seller": {
"address": "qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"name": "PCCWG"
},
"connections": [
{
"itemId": "item001",
"buyerProductId": "buyProductId001",
"productOfferingId": "productOfferingId001",
"quoteId": "quote001",
"quoteItemId": "quoteItemId001",
"connectionName": "connection665737529435949039",
"srcCompanyName": "CBC",
"srcRegion": "CHN",
"srcCity": "HK",
"srcDataCenter": "DCX",
"srcPort": "port1",
"dstCompanyName": "CBC",
"dstRegion": "USA",
"dstCity": "NYC",
"dstDataCenter": "DCY",
"dstPort": "port2",
"paymentType": "invoice",
"billingType": "PAYG",
"currency": "USD",
"bandwidth": "100 Mbps",
"billingUnit": "second",
"price": 1,
"startTime": 0,
"endTime": 0,
"serviceClass": "gold"
}
]
}
]
}
# DoDSettlement_getCreateOrderRewardBlock
Generate a block to confirm or reject a creating request.
Parameters:
privateFrom
: sender's ptm key, if this is a private transactionprivateFor
: receiver's ptm key, if this is a private transactionprivateGroupID
: ptm group key, if this is a private transactionrequestHash
: request block hashaction
: confirm/reject this request
Returns:
block
: a blockExample:
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getCreateOrderRewardBlock",
"params": [
{
"requestHash": "a2b736d91b4ff5b2a93287f20f5f5c67f271367a3015adc5e39cb427bcd37266",
"action": "confirm"
}
]
}
{
"jsonrpc": "2.0",
"id": 3,
"result": {
"type": "ContractReward",
"token": "89066d747a3c74ff1dec8ea6a7011bde010dd404aec454880f23d58cbf9280e4",
"address": "qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"balance": "10000000000000",
"vote": "0",
"network": "0",
"storage": "0",
"oracle": "0",
"previous": "95ba0b85d6458739fff02d34152cba61f7d01ea1ae85eea1b6bac58931153e51",
"link": "a2b736d91b4ff5b2a93287f20f5f5c67f271367a3015adc5e39cb427bcd37266",
"message": "0000000000000000000000000000000000000000000000000000000000000000",
"data": "gaFjAQ==",
"povHeight": 0,
"timestamp": 1589377020,
"extra": "121259be61fd87612a1e8bcb89264d00ab93d77cca07c57291a55d3b144be182",
"representative": "qlc_3hw8s1zubhxsykfsq5x7kh6eyibas9j3ga86ixd7pnqwes1cmt9mqqrngap4",
"work": "0000000000000000",
"signature": "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"
}
}
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getCreateOrderRewardBlock",
"params": [
{
"requestHash": "a2b736d91b4ff5b2a93287f20f5f5c67f271367a3015adc5e39cb427bcd37266",
"action": "confirm"
}
]
}
# DoDSettlement_getUpdateOrderInfoBlock
Generate a block to update order id and product id to chain.
Parameters:
privateFrom
: sender's ptm key, if this is a private transactionprivateFor
: receiver's ptm key, if this is a private transactionprivateGroupID
: ptm group key, if this is a private transactionbuyer
: buyer's qlc addressinternalId
: order's internal id in qlcchainorderId
: order's id from sonata apiorderItemId
: array of order item id from sonata apiitemId
: externalId of this productorderItemId
: order item id
status
: success/fail, result of sonata apifailReason
: fail reason of sonata api
Returns:
block
: a blockExample:
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getUpdateOrderInfoBlock",
"params": [
{
"buyer": "qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"internalId": "01a88fc4afc87b866d3d0e7b15bed6e36ba9bd7ec5b4c02e1970189415f96901",
"orderId": "order000001",
"orderItemId": [
{"itemId": "item001", "orderItemId": "orderItemId001"},
{"itemId": "item002", "orderItemId": "orderItemId002"}
],
"status": "success",
"failReason": ""
}
]
}
{
"jsonrpc": "2.0",
"id": 3,
"result": {
"type": "ContractSend",
"token": "89066d747a3c74ff1dec8ea6a7011bde010dd404aec454880f23d58cbf9280e4",
"address": "qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"balance": "10000000000000",
"vote": "0",
"network": "0",
"storage": "0",
"oracle": "0",
"previous": "a2b736d91b4ff5b2a93287f20f5f5c67f271367a3015adc5e39cb427bcd37266",
"link": "000000000000000000000000000000000000000000000000000000000000001d",
"message": "0000000000000000000000000000000000000000000000000000000000000000",
"data": "KXBN84WhaccgZQGoj8SvyHuGbT0OexW+1uNrqb1+xbTALhlwGJQV+WkBom9pq29yZGVyMDAwMDAxonBpkqpwcm9kdWN0MDAxqnByb2R1Y3QwMDGhcwCiZnKg",
"povHeight": 0,
"timestamp": 1589377380,
"extra": "92a6cad90ecc9b8e1ebd0ab7f27c76de62c9bfe16fa6dc8a3bf0293cc7bff3ed",
"representative": "qlc_3hw8s1zubhxsykfsq5x7kh6eyibas9j3ga86ixd7pnqwes1cmt9mqqrngap4",
"work": "0000000000000000",
"signature": "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"
}
}
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getUpdateOrderInfoBlock",
"params": [
{
"buyer": "qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"internalId": "01a88fc4afc87b866d3d0e7b15bed6e36ba9bd7ec5b4c02e1970189415f96901",
"orderId": "order000001",
"orderItemId": [
{"itemId": "item001", "orderItemId": "orderItemId001"},
{"itemId": "item002", "orderItemId": "orderItemId002"}
],
"status": "success",
"failReason": ""
}
]
}
# DoDSettlement_getUpdateOrderInfoRewardBlock
Generate a block to update order state to complete when all products in this order can be used normally.
Parameters:
privateFrom
: sender's ptm key, if this is a private transactionprivateFor
: receiver's ptm key, if this is a private transactionprivateGroupID
: ptm group key, if this is a private transactionrequestHash
: request block hash
Returns:
block
: a block
Example:
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getUpdateOrderInfoRewardBlock",
"params": [
{
"requestHash": "c06cae752f78029da5c861d3d87e35c0492f201a8a4550ce57eb9d91d476f7cb"
}
]
}
{
"jsonrpc": "2.0",
"id": 3,
"result": {
"type": "ContractReward",
"token": "89066d747a3c74ff1dec8ea6a7011bde010dd404aec454880f23d58cbf9280e4",
"address": "qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"balance": "10000000000000",
"vote": "0",
"network": "0",
"storage": "0",
"oracle": "0",
"previous": "b8d51bdfd178f6f7a6207fc134c612d0d90e7baf808b5464627ac6c2c8515d53",
"link": "c06cae752f78029da5c861d3d87e35c0492f201a8a4550ce57eb9d91d476f7cb",
"message": "0000000000000000000000000000000000000000000000000000000000000000",
"data": "gaFjAA==",
"povHeight": 0,
"timestamp": 1589378113,
"extra": "c07ba5be46f85dc12a9098673c85d5ccbe6e8bcdbe9870b4d14a9f3c851c6f87",
"representative": "qlc_3hw8s1zubhxsykfsq5x7kh6eyibas9j3ga86ixd7pnqwes1cmt9mqqrngap4",
"work": "0000000000000000",
"signature": "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"
}
}
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getUpdateOrderInfoRewardBlock",
"params": [
{
"requestHash": "c06cae752f78029da5c861d3d87e35c0492f201a8a4550ce57eb9d91d476f7cb"
}
]
}
# DoDSettlement_getChangeOrderBlock
Generate a block to create a request for changing a connection or other product.
Parameters:
privateFrom
: sender's ptm key, if this is a private transactionprivateFor
: receiver's ptm key, if this is a private transactionprivateGroupID
: ptm group key, if this is a private transactionbuyer
: buyer infoaddress
: buyer's qlc addressname
: buyer's name
seller
: seller infoaddress
: seller's qlc addressname
: seller's name
connections
: array of connection paramsproductId
: product's id from sonata api (required)itemId
: item id of this connection (required)connectionName
:quoteId
: id of the quotationquoteItemId
: item id of the quotationpaymentType
: invoice/stablecoinbillingType
: PAYG/DODcurrency
:bandwidth
:billingUnit
: year/month/week/day/hour/minute/second, only for PAYGprice
:startTime
: need to be set when billingType is DODendTime
: need to be set when billingType is DODserviceClass
: gold/silver/bronze
Returns:
block
: a blockExample:
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getChangeOrderBlock",
"params": [
{
"buyer": {
"address": "qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"name": "CBC"
},
"seller": {
"address": "qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"name": "PCCWG"
},
"connections": [
{
"itemId": "item001",
"productId": "product9104893720245486982",
"bandwidth": "200 Mbps",
"price": 2,
"quoteId": "quote001",
"quoteItemId": "quote001"
}
]
}
]
}
{
"jsonrpc": "2.0",
"id": 3,
"result": {
"type": "ContractSend",
"token": "89066d747a3c74ff1dec8ea6a7011bde010dd404aec454880f23d58cbf9280e4",
"address": "qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"balance": "10000000000000",
"vote": "0",
"network": "0",
"storage": "0",
"oracle": "0",
"previous": "c06cae752f78029da5c861d3d87e35c0492f201a8a4550ce57eb9d91d476f7cb",
"link": "000000000000000000000000000000000000000000000000000000000000001d",
"message": "0000000000000000000000000000000000000000000000000000000000000000",
"data": "4Srd7oOhYoKhYccgYyeR1aFpfUVESPnuq6KjNuUi1XZ+VwsyYnj1UyGU9kLIoW6jQ0JDoXOCoWHHIGO7jRycrK4yZidr7UfxgtyqCbBtiROLWZ7bL3WpgVjhuKFupVBDQ1dHoWORgqFvunByb2R1Y3Q5MTA0ODkzNzIwMjQ1NDg2OTgyv0RvRFNldHRsZUNvbm5lY3Rpb25EeW5hbWljUGFyYW2KomNuoKJwdACiYnQAomNyoKNzY3MAomJ3qDIwMCBNYnBzomJ1AKFwy0AAAAAAAAAAonN0AKJldAA=",
"povHeight": 0,
"timestamp": 1589378796,
"extra": "d88fbe052f2b76b8c5f6009ff95a4f03bcdbbbd1e7be03e5ffa57d44e70b3bf8",
"representative": "qlc_3hw8s1zubhxsykfsq5x7kh6eyibas9j3ga86ixd7pnqwes1cmt9mqqrngap4",
"work": "0000000000000000",
"signature": "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"
}
}
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getChangeOrderBlock",
"params": [
{
"buyer": {
"address": "qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"name": "CBC"
},
"seller": {
"address": "qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"name": "PCCWG"
},
"connections": [
{
"itemId": "item001",
"productId": "product9104893720245486982",
"bandwidth": "200 Mbps",
"price": 2,
"quoteId": "quote001",
"quoteItemId": "quote001"
}
]
}
]
}
# DoDSettlement_getChangeOrderRewardBlock
Generate a block to confirm or reject a changing request.
Parameters:
privateFrom
: sender's ptm key, if this is a private transactionprivateFor
: receiver's ptm key, if this is a private transactionprivateGroupID
: ptm group key, if this is a private transactionrequestHash
: request block hashaction
: confirm/reject this request
Returns:
block
: a blockExample:
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getChangeOrderRewardBlock",
"params": [
{
"requestHash": "a2b736d91b4ff5b2a93287f20f5f5c67f271367a3015adc5e39cb427bcd37266",
"action": "confirm"
}
]
}
{
"jsonrpc": "2.0",
"id": 3,
"result": {
"type": "ContractReward",
"token": "89066d747a3c74ff1dec8ea6a7011bde010dd404aec454880f23d58cbf9280e4",
"address": "qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"balance": "10000000000000",
"vote": "0",
"network": "0",
"storage": "0",
"oracle": "0",
"previous": "95ba0b85d6458739fff02d34152cba61f7d01ea1ae85eea1b6bac58931153e51",
"link": "a2b736d91b4ff5b2a93287f20f5f5c67f271367a3015adc5e39cb427bcd37266",
"message": "0000000000000000000000000000000000000000000000000000000000000000",
"data": "gaFjAQ==",
"povHeight": 0,
"timestamp": 1589377020,
"extra": "121259be61fd87612a1e8bcb89264d00ab93d77cca07c57291a55d3b144be182",
"representative": "qlc_3hw8s1zubhxsykfsq5x7kh6eyibas9j3ga86ixd7pnqwes1cmt9mqqrngap4",
"work": "0000000000000000",
"signature": "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"
}
}
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getChangeOrderRewardBlock",
"params": [
{
"requestHash": "a2b736d91b4ff5b2a93287f20f5f5c67f271367a3015adc5e39cb427bcd37266",
"action": "confirm"
}
]
}
# DoDSettlement_getTerminateOrderBlock
Generate a block to create a request for terminating a connection or other product.
Parameters:
privateFrom
: sender's ptm key, if this is a private transactionprivateFor
: receiver's ptm key, if this is a private transactionprivateGroupID
: ptm group key, if this is a private transactionbuyer
: buyer infoaddress
: buyer's qlc addressname
: buyer's name
seller
: seller infoaddress
: seller's qlc addressname
: seller's name
connections
: array of product id that will be terminatedproductId
: id of product to be terminateditemId
: item id of this connection (required)quoteId
: quote id for this productquoteItemId
: quote item id for this productprice
: price of this quote
Returns:
block
: a blockExample:
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getTerminateOrderBlock",
"params": [
{
"buyer": {
"address": "qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"name": "CBC"
},
"seller": {
"address": "qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"name": "PCCWG"
},
"connections": [
{
"itemId": "itemId001",
"productId": "product9104893720245486982",
"price": 2,
"quoteId": "quote001",
"quoteItemId": "quote001"
}
]
}
]
}
{
"jsonrpc": "2.0",
"id": 3,
"result": {
"type": "ContractSend",
"token": "89066d747a3c74ff1dec8ea6a7011bde010dd404aec454880f23d58cbf9280e4",
"address": "qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"balance": "10000000000000",
"vote": "0",
"network": "0",
"storage": "0",
"oracle": "0",
"previous": "c06cae752f78029da5c861d3d87e35c0492f201a8a4550ce57eb9d91d476f7cb",
"link": "000000000000000000000000000000000000000000000000000000000000001d",
"message": "0000000000000000000000000000000000000000000000000000000000000000",
"data": "17DF1YOhYoKhYccgYyeR1aFpfUVESPnuq6KjNuUi1XZ+VwsyYnj1UyGU9kLIoW6jQ0JDoXOCoWHHIGO7jRycrK4yZidr7UfxgtyqCbBtiROLWZ7bL3WpgVjhuKFupVBDQ1dHoXCRunByb2R1Y3Q5MTA0ODkzNzIwMjQ1NDg2OTgy",
"povHeight": 0,
"timestamp": 1589379191,
"extra": "3804142c0fa22403d1e9bcfd8b43bb9b72310a42b5ba6842c488578673394969",
"representative": "qlc_3hw8s1zubhxsykfsq5x7kh6eyibas9j3ga86ixd7pnqwes1cmt9mqqrngap4",
"work": "0000000000000000",
"signature": "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"
}
}
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getTerminateOrderBlock",
"params": [
{
"buyer": {
"address": "qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"name": "CBC"
},
"seller": {
"address": "qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"name": "PCCWG"
},
"connections": [
{
"itemId": "itemId001",
"productId": "product9104893720245486982",
"price": 2,
"quoteId": "quote001",
"quoteItemId": "quote001"
}
]
}
]
}
# DoDSettlement_getTerminateOrderRewardBlock
Generate a block to confirm or reject a terminating request.
Parameters:
privateFrom
: sender's ptm key, if this is a private transactionprivateFor
: receiver's ptm key, if this is a private transactionprivateGroupID
: ptm group key, if this is a private transactionrequestHash
: request block hashaction
: confirm/reject this request
Returns:
block
: a blockExample:
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getTerminateOrderRewardBlock",
"params": [
{
"requestHash": "a2b736d91b4ff5b2a93287f20f5f5c67f271367a3015adc5e39cb427bcd37266",
"action": "confirm"
}
]
}
{
"jsonrpc": "2.0",
"id": 3,
"result": {
"type": "ContractReward",
"token": "89066d747a3c74ff1dec8ea6a7011bde010dd404aec454880f23d58cbf9280e4",
"address": "qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"balance": "10000000000000",
"vote": "0",
"network": "0",
"storage": "0",
"oracle": "0",
"previous": "95ba0b85d6458739fff02d34152cba61f7d01ea1ae85eea1b6bac58931153e51",
"link": "a2b736d91b4ff5b2a93287f20f5f5c67f271367a3015adc5e39cb427bcd37266",
"message": "0000000000000000000000000000000000000000000000000000000000000000",
"data": "gaFjAQ==",
"povHeight": 0,
"timestamp": 1589377020,
"extra": "121259be61fd87612a1e8bcb89264d00ab93d77cca07c57291a55d3b144be182",
"representative": "qlc_3hw8s1zubhxsykfsq5x7kh6eyibas9j3ga86ixd7pnqwes1cmt9mqqrngap4",
"work": "0000000000000000",
"signature": "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"
}
}
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getTerminateOrderRewardBlock",
"params": [
{
"requestHash": "a2b736d91b4ff5b2a93287f20f5f5c67f271367a3015adc5e39cb427bcd37266",
"action": "confirm"
}
]
}
# DoDSettlement_getUpdateProductInfoBlock
Generate a block to update product id and product status.
Parameters:
privateFrom
: sender's ptm key, if this is a private transactionprivateFor
: receiver's ptm key, if this is a private transactionprivateGroupID
: ptm group key, if this is a private transactionaddress
: operator's qlc addressorderId
: order id of this orderproductInfo
: array of product info from sonata apiorderItemId
: order item id of this productproductId
: id of this productactive
: if product is active
Returns:
block
: a block
Example:
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getUpdateProductInfoBlock",
"params": [
{
"address": "qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"orderId": "order001",
"productInfo": [
{
"orderItemId": "orderItem001",
"productId": "product001",
"active": false
}
]
}
]
}
{
"jsonrpc": "2.0",
"id": 3,
"result": {
"type": "ContractSend",
"token": "89066d747a3c74ff1dec8ea6a7011bde010dd404aec454880f23d58cbf9280e4",
"address": "qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"balance": "10000000000000",
"vote": "0",
"network": "0",
"storage": "0",
"oracle": "0",
"previous": "a2b736d91b4ff5b2a93287f20f5f5c67f271367a3015adc5e39cb427bcd37266",
"link": "000000000000000000000000000000000000000000000000000000000000001d",
"message": "0000000000000000000000000000000000000000000000000000000000000000",
"data": "KXBN84WhaccgZQGoj8SvyHuGbT0OexW+1uNrqb1+xbTALhlwGJQV+WkBom9pq29yZGVyMDAwMDAxonBpkqpwcm9kdWN0MDAxqnByb2R1Y3QwMDGhcwCiZnKg",
"povHeight": 0,
"timestamp": 1589377380,
"extra": "92a6cad90ecc9b8e1ebd0ab7f27c76de62c9bfe16fa6dc8a3bf0293cc7bff3ed",
"representative": "qlc_3hw8s1zubhxsykfsq5x7kh6eyibas9j3ga86ixd7pnqwes1cmt9mqqrngap4",
"work": "0000000000000000",
"signature": "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"
}
}
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getUpdateProductInfoBlock",
"params": [
{
"address": "qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"orderId": "order001",
"productInfo": [
{
"orderItemId": "orderItem001",
"productId": "product001",
"active": false
}
]
}
]
}
# DoDSettlement_getOrderInfoBySellerAndOrderId
get order info by seller address and order id.
Parameters:
- seller's qlc address
- order id from sonata api
Returns:
- order's detail info
track
: the contract's life track, from this we can know the time of request/confirmed/rejected/complete, and which block do the actions(record the block's previous hash).
Example:
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getOrderInfoBySellerAndOrderId",
"params": [
"qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"order001"
]
}
{
"jsonrpc": "2.0",
"id": 3,
"result": {
"buyer": {
"address": "qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"name": "CBC"
},
"seller": {
"address": "qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"name": "PCCWG"
},
"orderId": "order001",
"orderType": "create",
"orderState": "success",
"contractState": "confirmed",
"connections": [
{
"itemId": "item496704013227867488",
"buyerProductId": "buyerProduct1917910293729382797",
"productOfferingId": "productOfferingId001",
"productId": "product8859633503872504239",
"srcCompanyName": "CBC",
"srcRegion": "CHN",
"srcCity": "HK",
"srcDataCenter": "DCX",
"srcPort": "port1",
"dstCompanyName": "CBC",
"dstRegion": "USA",
"dstCity": "NYC",
"dstDataCenter": "DCY",
"dstPort": "port2",
"connectionName": "connection7766481457385609998",
"paymentType": "invoice",
"billingType": "PAYG",
"currency": "USD",
"serviceClass": "gold",
"bandwidth": "100 Mbps",
"billingUnit": "second",
"price": 1,
"startTime": 0,
"endTime": 0
},
{
"itemId": "item496704013227867489",
"buyerProductId": "buyerProduct1917910293729382792",
"productOfferingId": "productOfferingId001",
"productId": "product2301480569929582637",
"srcCompanyName": "CBC",
"srcRegion": "CHN",
"srcCity": "HK",
"srcDataCenter": "DCX",
"srcPort": "port1",
"dstCompanyName": "CBC",
"dstRegion": "USA",
"dstCity": "NYC",
"dstDataCenter": "DCY",
"dstPort": "port2",
"connectionName": "connection7998373670406906764",
"paymentType": "invoice",
"billingType": "PAYG",
"currency": "USD",
"serviceClass": "gold",
"bandwidth": "100 Mbps",
"billingUnit": "second",
"price": 1,
"startTime": 0,
"endTime": 0
}
],
"track": [
{
"contractState": "request",
"orderState": "null",
"reason": "",
"time": 1589371307,
"hash": "d792df87b66a59f78550d29a8fb2867b4d68a2fe14156ba9c5ab78828d72a2b0"
},
{
"contractState": "confirmed",
"orderState": "null",
"reason": "",
"time": 1589371465,
"hash": "b1240a35a5daf52200be588339fcd3384fef959814e038cd1c72e03d4854e51c"
},
{
"contractState": "confirmed",
"orderState": "success",
"reason": "",
"time": 1589371551,
"hash": "002d82bbf0f0a2906276ead5ad33af3f2c8f5c9e7ae1f0188cd1b43df1bc6c94"
}
]
}
}
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getOrderInfoBySellerAndOrderId",
"params": [
"qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"order001"
]
}
# DoDSettlement_getOrderInfoByInternalId
get order info by internal id.
Parameters:
- Internal id from chain
Returns:
- order's detail info
track
: the contract's life track, from this we can know the time of request/confirmed/rejected/complete, and which block do the actions(record the block's previous hash).
Example:
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getOrderInfoByInternalId",
"params": [
"10f24ebd14aa86bab26757b4db16ba313b2cdcb363d8540ee0184aae087e7edc"
]
}
{
"jsonrpc": "2.0",
"id": 3,
"result": {
"buyer": {
"address": "qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"name": "CBC"
},
"seller": {
"address": "qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"name": "PCCWG"
},
"orderId": "order001",
"orderType": "create",
"orderState": "success",
"contractState": "confirmed",
"connections": [
{
"itemId": "item496704013227867488",
"buyerProductId": "buyerProduct1917910293729382797",
"productOfferingId": "productOfferingId001",
"productId": "product8859633503872504239",
"srcCompanyName": "CBC",
"srcRegion": "CHN",
"srcCity": "HK",
"srcDataCenter": "DCX",
"srcPort": "port1",
"dstCompanyName": "CBC",
"dstRegion": "USA",
"dstCity": "NYC",
"dstDataCenter": "DCY",
"dstPort": "port2",
"connectionName": "connection7766481457385609998",
"paymentType": "invoice",
"billingType": "PAYG",
"currency": "USD",
"serviceClass": "gold",
"bandwidth": "100 Mbps",
"billingUnit": "second",
"price": 1,
"startTime": 0,
"endTime": 0
},
{
"itemId": "item496704013227867482",
"buyerProductId": "buyerProduct1917910293729382792",
"productOfferingId": "productOfferingId001",
"productId": "product2301480569929582637",
"srcCompanyName": "CBC",
"srcRegion": "CHN",
"srcCity": "HK",
"srcDataCenter": "DCX",
"srcPort": "port1",
"dstCompanyName": "CBC",
"dstRegion": "USA",
"dstCity": "NYC",
"dstDataCenter": "DCY",
"dstPort": "port2",
"connectionName": "connection7998373670406906764",
"paymentType": "invoice",
"billingType": "PAYG",
"currency": "USD",
"serviceClass": "gold",
"bandwidth": "100 Mbps",
"billingUnit": "second",
"price": 1,
"startTime": 0,
"endTime": 0
}
],
"track": [
{
"contractState": "request",
"orderState": "null",
"reason": "",
"time": 1589371307,
"hash": "d792df87b66a59f78550d29a8fb2867b4d68a2fe14156ba9c5ab78828d72a2b0"
},
{
"contractState": "confirmed",
"orderState": "null",
"reason": "",
"time": 1589371465,
"hash": "b1240a35a5daf52200be588339fcd3384fef959814e038cd1c72e03d4854e51c"
},
{
"contractState": "confirmed",
"orderState": "success",
"reason": "",
"time": 1589371551,
"hash": "002d82bbf0f0a2906276ead5ad33af3f2c8f5c9e7ae1f0188cd1b43df1bc6c94"
}
]
}
}
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getOrderInfoByInternalId",
"params": [
"10f24ebd14aa86bab26757b4db16ba313b2cdcb363d8540ee0184aae087e7edc"
]
}
# DoDSettlement_getProductInfoBySellerAndProductId
get product info by seller address and product id.
Parameters:
- seller's qlc address
- product id from sonata api
Returns:
- product's detail info
active
: current product ruledone
: finished billing sectionstrack
: the product's life track, from this we can know when the product was created/changed/terminated, and detai info of every action.
Example:
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getProductInfoBySellerAndProductId",
"params": [
"qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"product8770789891961219555"
]
}
{
"jsonrpc": "2.0",
"id": 3,
"result": {
"itemId": "item496704013227867488",
"buyerProductId": "buyerProduct1917910293729382797",
"productOfferingId": "productOfferingId001",
"productId": "product8770789891961219555",
"srcCompanyName": "CBC",
"srcRegion": "CHN",
"srcCity": "HK",
"srcDataCenter": "DCX",
"srcPort": "port1",
"dstCompanyName": "CBC",
"dstRegion": "USA",
"dstCity": "NYC",
"dstDataCenter": "DCY",
"dstPort": "port2",
"active": null,
"done": [
{
"connectionName": "connection6262024276067780718",
"paymentType": "invoice",
"billingType": "PAYG",
"currency": "USD",
"serviceClass": "gold",
"bandwidth": "100 Mbps",
"billingUnit": "second",
"price": 1,
"startTime": 1589374485,
"endTime": 1589374605
},
{
"connectionName": "connection6262024276067780718",
"paymentType": "invoice",
"billingType": "PAYG",
"currency": "USD",
"serviceClass": "gold",
"bandwidth": "200 Mbps",
"billingUnit": "second",
"price": 2,
"startTime": 1589374605,
"endTime": 1589374690
}
],
"track": [
{
"orderType": "create",
"orderId": "order001",
"time": 1589374485,
"changed": {
"connectionName": "connection6262024276067780718",
"paymentType": "invoice",
"billingType": "PAYG",
"currency": "USD",
"serviceClass": "gold",
"bandwidth": "100 Mbps",
"billingUnit": "second",
"price": 1,
"startTime": 0,
"endTime": 0
}
},
{
"orderType": "change",
"orderId": "order002",
"time": 1589374605,
"changed": {
"connectionName": "",
"paymentType": "null",
"billingType": "null",
"currency": "",
"serviceClass": "null",
"bandwidth": "200 Mbps",
"billingUnit": "second",
"price": 2,
"startTime": 0,
"endTime": 0
}
},
{
"orderType": "terminate",
"orderId": "order003",
"time": 1589374690,
"changed": null
}
]
}
}
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getProductInfoBySellerAndProductId",
"params": [
"qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"product8770789891961219555"
]
}
# DoDSettlement_getInternalIdByOrderId
get internal id by seller address and order id.
Parameters:
- seller's qlc address
- order id
Returns:
- Internal id
Example:
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getInternalIdByOrderId",
"params": [
"qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"order009"
]
}
{
"jsonrpc": "2.0",
"id": 3,
"result": "4ffe1343875f9beb403d1f10a57866dad517a59517b96c6f2ff3d44c337f6f8c"
}
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getInternalIdByOrderId",
"params": [
"qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"order009"
]
}
# DoDSettlement_getPendingRequest
Get all pending requests for seller.
Parameters:
- seller's qlc address
Returns:
hash
: request block's hashorder
:order's detai info
Example:
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getPendingRequest",
"params": [
"qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3"
]
}
{
"jsonrpc": "2.0",
"id": 3,
"result": [
{
"hash": "45f39c6907586af092efc7750674d8bf8f56e003a1ce482530194c253c6c749a",
"order": {
"buyer": {
"address": "qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"name": "CBC"
},
"seller": {
"address": "qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"name": "PCCWG"
},
"orderId": "",
"orderType": "create",
"orderState": "null",
"contractState": "request",
"connections": [
{
"itemId": "item496704013227867488",
"buyerProductId": "buyerProduct1917910293729382797",
"productOfferingId": "productOfferingId001",
"productId": "",
"srcCompanyName": "CBC",
"srcRegion": "CHN",
"srcCity": "HK",
"srcDataCenter": "DCX",
"srcPort": "port1",
"dstCompanyName": "CBC",
"dstRegion": "USA",
"dstCity": "NYC",
"dstDataCenter": "DCY",
"dstPort": "port2",
"connectionName": "connection1897620432303744180",
"paymentType": "invoice",
"billingType": "PAYG",
"currency": "USD",
"serviceClass": "gold",
"bandwidth": "100 Mbps",
"billingUnit": "second",
"price": 1,
"startTime": 0,
"endTime": 0
}
],
"track": [
{
"contractState": "request",
"orderState": "null",
"reason": "",
"time": 1589382707,
"hash": "d792df87b66a59f78550d29a8fb2867b4d68a2fe14156ba9c5ab78828d72a2b0"
}
]
}
}
]
}
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getPendingRequest",
"params": [
"qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3"
]
}
# DoDSettlement_getPendingResourceCheck
Get all pending orders for seller to check. Seller need to check every product's status in each order.
Parameters:
- seller's qlc address
Returns:
Array of pending info.
sendHash
: hash of send blockorderId
: id of order that needs to checkinternalId
: internal id of order that needs to checkproducts
: product inoorderItemId
: order item id of this productproductId
: product idactive
: if this product is active
Example:
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getPendingResourceCheck",
"params": [
"qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3"
]
}
{
"jsonrpc": "2.0",
"id": 3,
"result": [
{
"sendHash": "45f39c6907586af092efc7750674d8bf8f56e003a1ce482530194c253c6c749a",
"orderId": "order002",
"internalId": "d792df87b66a59f78550d29a8fb2867b4d68a2fe14156ba9c5ab78828d72a2b0",
"products": [
{
"productId": "product2397676495791057537",
"active": false
}
]
},
{
"sendHash": "45f39c6907586af092efc7750674d8bf8f56e003a1ce482530194c253c6c749a",
"orderId": "order001",
"internalId": "d792df87b66a59f78550d29a8fb2867b4d68a2fe14156ba9c5ab78828d72a2b2",
"products": [
{
"productId": "product7507455791188971715",
"active": true
}
]
}
]
}
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getPendingResourceCheck",
"params": [
"qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3"
]
}
# DoDSettlement_getPlacingOrder
Get all placing orders (contractState = confirmed && orderState == null)
Parameters:
- buyer's qlc address
- seller's qlc address
- count
- offset
Returns:
totalOrders
: total placing order countorderList
: Array of placing order list.internalId
: internal id of the orderorderInfo
: detail info the order
Example:
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getPlacingOrder",
"params": [
"qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3"
1,
1
]
}
{
"jsonrpc": "2.0",
"id": 3,
"result": {
"totalOrders": 2,
"orderList": [
{
"internalId": "6b07c3e08449ed82b154eef3befacb0c590787fccd4a701789d7d0ca493b209e",
"orderInfo": {
"buyer": {
"address": "qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"name": "CBC"
},
"seller": {
"address": "qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"name": "PCCWG"
},
"orderType": "create",
"orderState": "null",
"contractState": "confirmed",
"connections": [
{
"itemId": "item916717806947573250",
"buyerProductId": "buyerProduct1132820389241880867",
"productOfferingId": "productOfferingId001",
"srcCompanyName": "CBC",
"srcRegion": "CHN",
"srcCity": "HK",
"srcDataCenter": "DCX",
"srcPort": "port1",
"dstCompanyName": "CBC",
"dstRegion": "USA",
"dstCity": "NYC",
"dstDataCenter": "DCY",
"dstPort": "port2",
"quoteId": "quote2719901657945912755",
"quoteItemId": "quoteItem8946258944903715135",
"connectionName": "connection5940817643077128079",
"paymentType": "invoice",
"billingType": "PAYG",
"currency": "USD",
"serviceClass": "gold",
"bandwidth": "100 Mbps",
"billingUnit": "second",
"price": 1,
"addition": 0,
"startTime": 0,
"endTime": 0
}
],
"track": [
{
"contractState": "request",
"orderState": "null",
"time": 1591274271,
"hash": "6b07c3e08449ed82b154eef3befacb0c590787fccd4a701789d7d0ca493b209e"
},
{
"contractState": "confirmed",
"orderState": "null",
"time": 1591274280,
"hash": "8a1d9ef3be92c84b6078b63b875c3b01c9f424703340804368732a33480c8232"
}
]
}
}
]
}
}
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getPlacingOrder",
"params": [
"qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
1,
1
]
}
# DoDSettlement_getProductIdListByAddress
Get buyer's all product ids.
Parameters:
- buyer's qlc address
Returns:
Array of product id.
productId
: id of productseller
: seller's qlc address
Example:
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getProductIdListByAddress",
"params": [
"qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe"
]
}
{
"jsonrpc": "2.0",
"id": 3,
"result": [
{
"seller": "qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"productId": "product8770789891961219555"
},
{
"seller": "qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"productId": "product8762813907531150227"
}
]
}
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getProductIdListByAddress",
"params": [
"qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe"
]
}
# DoDSettlement_getOrderIdListByAddress
Get buyer's all order ids.
Parameters:
- buyer's qlc address
Returns:
Array of order id.
orderId
: id of orderseller
: seller's qlc address
Example:
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getOrderIdListByAddress",
"params": [
"qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe"
]
}
{
"jsonrpc": "2.0",
"id": 3,
"result": [
{
"seller": "qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"orderId": "order001"
},
{
"seller": "qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"orderId": "order002"
},
{
"seller": "qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"orderId": "order003"
}
]
}
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getOrderIdListByAddress",
"params": [
"qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe"
]
}
# DoDSettlement_getProductIdListByAddressAndSeller
Get buyer's all product ids with specified seller.
Parameters:
- buyer's qlc address
- seller's qlc address
Returns:
Array of product id.
productId
: id of productseller
: seller's qlc address
Example:
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getProductIdListByAddressAndSeller",
"params": [
"qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3"
]
}
{
"jsonrpc": "2.0",
"id": 3,
"result": [
{
"seller": "qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"productId": "product8770789891961219555"
},
{
"seller": "qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"productId": "product8762813907531150227"
}
]
}
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getProductIdListByAddressAndSeller",
"params": [
"qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3"
]
}
# DoDSettlement_getOrderIdListByAddressAndSeller
Get buyer's all order ids with specified seller.
Parameters:
- buyer's qlc address
- seller's qlc address
Returns:
Array of order id.
orderId
: id of orderseller
: seller's qlc address
Example:
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getOrderIdListByAddressAndSeller",
"params": [
"qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3"
]
}
{
"jsonrpc": "2.0",
"id": 3,
"result": [
{
"seller": "qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"orderId": "order001"
},
{
"seller": "qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"orderId": "order002"
},
{
"seller": "qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"orderId": "order003"
}
]
}
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getOrderIdListByAddressAndSeller",
"params": [
"qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3"
]
}
# DoDSettlement_generateInvoiceByOrderId
Generate invoice by order id.
Parameters:
- seller's qlc address
- order id
- startTime
- endTime
- inFlight order allowed (true: in-flight order will be included)
- split order allowed (true: cacl completed duration false: calc whole duration or exclueded, depends on if the startTime of the order was in the invoice duration)
Returns:
- Invoice info
Example:
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_generateInvoiceByOrderId",
"params": [
"qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"order003",
1590063500,
1590063550,
true,
true
]
}
{
"jsonrpc": "2.0",
"id": 3,
"result": {
"invoiceId": "a9d212581a36f89dd1caa77809d25bd220b0b620b71258541521e05ba9147c5a",
"totalConnectionCount": 2,
"totalAmount": 200,
"currency": "USD",
"startTime": 1590063500,
"endTime": 1590063550,
"buyer": {
"address": "qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"name": "CBC"
},
"seller": {
"address": "qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"name": "PCCWG"
},
"order": {
"orderId": "order003",
"internalId": "d792df87b66a59f78550d29a8fb2867b4d68a2fe14156ba9c5ab78828d72a2b0",
"connectionCount": 2,
"orderAmount": 200,
"connections": [
{
"connectionAmount": 100,
"productId": "product003",
"srcCompanyName": "CBC",
"srcRegion": "CHN",
"srcCity": "HK",
"srcDataCenter": "DCX",
"srcPort": "port1",
"dstCompanyName": "CBC",
"dstRegion": "USA",
"dstCity": "NYC",
"dstDataCenter": "DCY",
"dstPort": "port2",
"usage": [
{
"connectionName": "connection5251568543453672711",
"paymentType": "invoice",
"billingType": "DOD",
"currency": "USD",
"serviceClass": "gold",
"bandwidth": "100 Mbps",
"price": 100,
"startTime": 1590063500,
"endTime": 1590063550,
"invoiceStartTime": 0,
"invoiceEndTime": 0,
"invoiceUnitCount": 0,
"amount": 100
}
]
},
{
"connectionAmount": 100,
"productId": "product004",
"srcCompanyName": "CBC",
"srcRegion": "CHN",
"srcCity": "HK",
"srcDataCenter": "DCX",
"srcPort": "port1",
"dstCompanyName": "CBC",
"dstRegion": "USA",
"dstCity": "NYC",
"dstDataCenter": "DCY",
"dstPort": "port2",
"usage": [
{
"connectionName": "connection2486610007254462746",
"paymentType": "invoice",
"billingType": "DOD",
"currency": "USD",
"serviceClass": "gold",
"bandwidth": "100 Mbps",
"price": 100,
"startTime": 1590063500,
"endTime": 1590063550,
"invoiceStartTime": 0,
"invoiceEndTime": 0,
"invoiceUnitCount": 0,
"amount": 100
}
]
}
]
}
}
}
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_generateInvoiceByOrderId",
"params": [
"qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"order003",
1590063500,
1590063550,
true,
true
]
}
# DoDSettlement_generateInvoiceByBuyer
Generate invoice by buyer's qlc address.
Parameters:
- seller's qlc address
- buyer's qlc address
- startTime
- endTime
- inFlight order allowed (true: in-flight order will be included)
- split order allowed (true: cacl completed duration false: calc whole duration or exclueded, depends on if the startTime of the order was in the invoice duration)
Returns:
- invoice info
Example:
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_generateInvoiceByBuyer",
"params": [
"qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
1590063500,
1590063550,
false,
false
]
}
{
"jsonrpc": "2.0",
"id": 3,
"result": {
"invoiceId": "098bb4342d1026fadac01c85022a1e0b6aa8a0d0c80e94a20beb8f8f24293fe2",
"orderCount": 4,
"totalConnectionCount": 5,
"totalAmount": 500,
"currency": "USD",
"startTime": 1590063500,
"endTime": 1590063550,
"buyer": {
"address": "qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"name": "CBC"
},
"seller": {
"address": "qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"name": "PCCWG"
},
"orders": [
{
"orderId": "order001",
"internalId": "d792df87b66a59f78550d29a8fb2867b4d68a2fe14156ba9c5ab78828d72a2b0",
"connectionCount": 1,
"orderAmount": 0,
"connections": [
{
"connectionAmount": 0,
"itemId": "",
"productId": "product001",
"srcCompanyName": "CBC",
"srcRegion": "CHN",
"srcCity": "HK",
"srcDataCenter": "DCX",
"srcPort": "port1",
"dstCompanyName": "CBC",
"dstRegion": "USA",
"dstCity": "NYC",
"dstDataCenter": "DCY",
"dstPort": "port2",
"usage": []
}
]
},
{
"orderId": "order002",
"internalId": "d792df87b66a59f78550d29a8fb2867b4d68a2fe14156ba9c5ab78828d72a2b1",
"connectionCount": 1,
"orderAmount": 100,
"connections": [
{
"connectionAmount": 100,
"itemId": "",
"productId": "product001",
"srcCompanyName": "CBC",
"srcRegion": "CHN",
"srcCity": "HK",
"srcDataCenter": "DCX",
"srcPort": "port1",
"dstCompanyName": "CBC",
"dstRegion": "USA",
"dstCity": "NYC",
"dstDataCenter": "DCY",
"dstPort": "port2",
"usage": [
{
"connectionName": "connection4117279165879118174",
"paymentType": "invoice",
"billingType": "PAYG",
"currency": "USD",
"serviceClass": "gold",
"bandwidth": "200 Mbps",
"billingUnit": "second",
"price": 2,
"startTime": 1590061933,
"endTime": 0,
"invoiceStartTime": 1590063500,
"invoiceEndTime": 1590063550,
"invoiceUnitCount": 50,
"amount": 100
}
]
}
]
},
{
"orderId": "order003",
"internalId": "d792df87b66a59f78550d29a8fb2867b4d68a2fe14156ba9c5ab78828d72a2b2",
"connectionCount": 2,
"orderAmount": 200,
"connections": [
{
"connectionAmount": 100,
"itemId": "",
"productId": "product003",
"srcCompanyName": "CBC",
"srcRegion": "CHN",
"srcCity": "HK",
"srcDataCenter": "DCX",
"srcPort": "port1",
"dstCompanyName": "CBC",
"dstRegion": "USA",
"dstCity": "NYC",
"dstDataCenter": "DCY",
"dstPort": "port2",
"usage": [
{
"connectionName": "connection5251568543453672711",
"paymentType": "invoice",
"billingType": "DOD",
"currency": "USD",
"serviceClass": "gold",
"bandwidth": "100 Mbps",
"billingUnit": "null",
"price": 100,
"startTime": 1590063500,
"endTime": 1590063550,
"invoiceStartTime": 0,
"invoiceEndTime": 0,
"invoiceUnitCount": 0,
"amount": 100
}
]
},
{
"connectionAmount": 100,
"itemId": "",
"productId": "product004",
"srcCompanyName": "CBC",
"srcRegion": "CHN",
"srcCity": "HK",
"srcDataCenter": "DCX",
"srcPort": "port1",
"dstCompanyName": "CBC",
"dstRegion": "USA",
"dstCity": "NYC",
"dstDataCenter": "DCY",
"dstPort": "port2",
"usage": [
{
"connectionName": "connection2486610007254462746",
"paymentType": "invoice",
"billingType": "DOD",
"currency": "USD",
"serviceClass": "gold",
"bandwidth": "100 Mbps",
"billingUnit": "null",
"price": 100,
"startTime": 1590063500,
"endTime": 1590063550,
"invoiceStartTime": 0,
"invoiceEndTime": 0,
"invoiceUnitCount": 0,
"amount": 100
}
]
}
]
},
{
"orderId": "order004",
"internalId": "d792df87b66a59f78550d29a8fb2867b4d68a2fe14156ba9c5ab78828d72a2b4",
"connectionCount": 1,
"orderAmount": 200,
"connections": [
{
"connectionAmount": 200,
"itemId": "",
"productId": "product003",
"srcCompanyName": "CBC",
"srcRegion": "CHN",
"srcCity": "HK",
"srcDataCenter": "DCX",
"srcPort": "port1",
"dstCompanyName": "CBC",
"dstRegion": "USA",
"dstCity": "NYC",
"dstDataCenter": "DCY",
"dstPort": "port2",
"usage": [
{
"connectionName": "connection5251568543453672711",
"paymentType": "invoice",
"billingType": "DOD",
"currency": "USD",
"serviceClass": "gold",
"bandwidth": "200 Mbps",
"billingUnit": "null",
"price": 200,
"startTime": 1590063510,
"endTime": 1590063530,
"invoiceStartTime": 0,
"invoiceEndTime": 0,
"invoiceUnitCount": 0,
"amount": 200
}
]
}
]
}
]
}
}
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_generateInvoiceByBuyer",
"params": [
"qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
1590063500,
1590063550,
false,
false
]
}
# DoDSettlement_generateInvoiceByProductId
Generate invoice by product id.
Parameters:
- seller's qlc address
- product id
- startTime
- endTime
- inFlight order allowed (true: in-flight order will be included)
- split order allowed (true: cacl completed duration false: calc whole duration or exclueded, depends on if the startTime of the order was in the invoice duration)
Returns:
- invoice info
Example:
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_generateInvoiceByProductId",
"params": [
"qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"product003",
1590063500,
1590063550,
true,
false
]
}
{
"jsonrpc": "2.0",
"id": 3,
"result": {
"totalAmount": 300,
"currency": "USD",
"startTime": 1590063500,
"endTime": 1590063550,
"buyer": {
"address": "qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"name": "CBC"
},
"seller": {
"address": "qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"name": "PCCWG"
},
"connection": {
"invoiceId": "4468df37277c4ab350c7fa2893d11f44804af62b5631f90f159fea24554c200e",
"connectionAmount": 300,
"itemId": "",
"productId": "product003",
"srcCompanyName": "CBC",
"srcRegion": "CHN",
"srcCity": "HK",
"srcDataCenter": "DCX",
"srcPort": "port1",
"dstCompanyName": "CBC",
"dstRegion": "USA",
"dstCity": "NYC",
"dstDataCenter": "DCY",
"dstPort": "port2",
"usage": [
{
"orderId": "order004",
"internalId": "d792df87b66a59f78550d29a8fb2867b4d68a2fe14156ba9c5ab78828d72a2b0",
"connectionName": "connection5251568543453672711",
"paymentType": "invoice",
"billingType": "DOD",
"currency": "USD",
"serviceClass": "gold",
"bandwidth": "200 Mbps",
"billingUnit": "null",
"price": 200,
"startTime": 1590063510,
"endTime": 1590063530,
"invoiceStartTime": 0,
"invoiceEndTime": 0,
"invoiceUnitCount": 0,
"amount": 200
},
{
"orderId": "order003",
"internalId": "d792df87b66a59f78550d29a8fb2867b4d68a2fe14156ba9c5ab78828d72a2b3",
"connectionName": "connection5251568543453672711",
"paymentType": "invoice",
"billingType": "DOD",
"currency": "USD",
"serviceClass": "gold",
"bandwidth": "100 Mbps",
"billingUnit": "null",
"price": 100,
"startTime": 1590063500,
"endTime": 1590063550,
"invoiceStartTime": 0,
"invoiceEndTime": 0,
"invoiceUnitCount": 0,
"amount": 100
}
]
}
}
}
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_generateInvoiceByProductId",
"params": [
"qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"product003",
1590063500,
1590063550,
true,
false
]
}
# DoDSettlement_getOrderCountByAddress
Get order count by buyer's address.
Parameters:
- buyer's qlc address
Returns:
- order count
Example:
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getOrderCountByAddress",
"params": [
"qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe"
]
}
{
"jsonrpc": "2.0",
"id": 3,
"result": 3
}
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getOrderCountByAddress",
"params": [
"qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe"
]
}
# DoDSettlement_getOrderInfoByAddress
Get order info by buyer's address.
Parameters:
- buyer's qlc address
- count
- offset
Returns:
orderInfo
: order array (ordered by create time desc)totalOrders
: total order count
Example:
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getOrderInfoByAddress",
"params": [
"qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
5,
0
]
}
{
"jsonrpc": "2.0",
"id": 3,
"result": {
"orderInfo": [
{
"buyer": {
"address": "qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"name": "CBC"
},
"seller": {
"address": "qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"name": "PCCWG"
},
"orderId": "order003",
"orderType": "terminate",
"orderState": "complete",
"contractState": "confirmed",
"connections": [
{
"itemId": "item496704013227867488",
"buyerProductId": "buyerProduct1917910293729382797",
"productOfferingId": "productOfferingId001",
"productId": "product001",
"srcCompanyName": "CBC",
"srcRegion": "CHN",
"srcCity": "HK",
"srcDataCenter": "DCX",
"srcPort": "port1",
"dstCompanyName": "CBC",
"dstRegion": "USA",
"dstCity": "NYC",
"dstDataCenter": "DCY",
"dstPort": "port2",
"quoteId": "quote7270827408837322169",
"quoteItemId": "quoteItem9147229863603776145",
"connectionName": "connection4030270824757057501",
"paymentType": "invoice",
"billingType": "PAYG",
"currency": "USD",
"serviceClass": "gold",
"bandwidth": "200 Mbps",
"billingUnit": "second",
"price": 20,
"addition": 0,
"startTime": 0,
"endTime": 0
}
],
"track": [
{
"contractState": "request",
"orderState": "null",
"time": 1591095653,
"hash": "ded8f414c9e042ee0116f0a46e37b4574710e800d23ef50d598aa84af49c70c0"
},
{
"contractState": "confirmed",
"orderState": "null",
"time": 1591095669,
"hash": "38f63d7706641019606fdede4fce5f68a85d741d30f69946ae886a6103b9dd54"
},
{
"contractState": "confirmed",
"orderState": "success",
"time": 1591095809,
"hash": "ebf4ff89bc11707b6973e7d4d7e8efbb51bf8755bcb29d1161143ed0bbfdbef1"
},
{
"contractState": "confirmed",
"orderState": "complete",
"time": 1591095818,
"hash": "c2fdea6ed8ecd2808019cb27413fcb96318cc413a94c6c59cbfb2c9d07c0b248"
}
]
},
{
"buyer": {
"address": "qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"name": "CBC"
},
"seller": {
"address": "qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"name": "PCCWG"
},
"orderId": "order002",
"orderType": "change",
"orderState": "complete",
"contractState": "confirmed",
"connections": [
{
"itemId": "item496704013227867488",
"buyerProductId": "buyerProduct1917910293729382797",
"productOfferingId": "productOfferingId001",
"productId": "product001",
"srcCompanyName": "CBC",
"srcRegion": "CHN",
"srcCity": "HK",
"srcDataCenter": "DCX",
"srcPort": "port1",
"dstCompanyName": "CBC",
"dstRegion": "USA",
"dstCity": "NYC",
"dstDataCenter": "DCY",
"dstPort": "port2",
"quoteId": "quote6031908666772364622",
"quoteItemId": "quoteItem5467873725997985832",
"connectionName": "connection4030270824757057501",
"paymentType": "invoice",
"billingType": "PAYG",
"currency": "USD",
"serviceClass": "gold",
"bandwidth": "200 Mbps",
"billingUnit": "second",
"price": 2,
"addition": 0,
"startTime": 0,
"endTime": 0
}
],
"track": [
{
"contractState": "request",
"orderState": "null",
"time": 1591095499,
"hash": "ad1bcded1f32385d3e92f0dee29cb0f9452dae3da5500a5e36ec37717ab2ff7c"
},
{
"contractState": "confirmed",
"orderState": "null",
"time": 1591095512,
"hash": "fe3d9be943c547460a1eb3a45b1f6baa5985c99e4656794943cb79f4960db816"
},
{
"contractState": "confirmed",
"orderState": "success",
"time": 1591095572,
"hash": "a1e14557945861e02b13413cfe06374896b41526a11844fd637b591d0c0b0f1c"
},
{
"contractState": "confirmed",
"orderState": "complete",
"time": 1591095580,
"hash": "4159bef23c29cdb51fa4c7726529382760c6b6fb17b6ac563713c1c5a0da0214"
}
]
},
{
"buyer": {
"address": "qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"name": "CBC"
},
"seller": {
"address": "qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"name": "PCCWG"
},
"orderId": "order001",
"orderType": "create",
"orderState": "complete",
"contractState": "confirmed",
"connections": [
{
"itemId": "item496704013227867488",
"buyerProductId": "buyerProduct1917910293729382797",
"productOfferingId": "productOfferingId001",
"productId": "product001",
"srcCompanyName": "CBC",
"srcRegion": "CHN",
"srcCity": "HK",
"srcDataCenter": "DCX",
"srcPort": "port1",
"dstCompanyName": "CBC",
"dstRegion": "USA",
"dstCity": "NYC",
"dstDataCenter": "DCY",
"dstPort": "port2",
"quoteId": "quote4647401443521770947",
"quoteItemId": "quoteItem4919214398518384874",
"connectionName": "connection4030270824757057501",
"paymentType": "invoice",
"billingType": "PAYG",
"currency": "USD",
"serviceClass": "gold",
"bandwidth": "100 Mbps",
"billingUnit": "second",
"price": 1,
"addition": 0,
"startTime": 0,
"endTime": 0
}
],
"track": [
{
"contractState": "request",
"orderState": "null",
"time": 1591095353,
"hash": "d792df87b66a59f78550d29a8fb2867b4d68a2fe14156ba9c5ab78828d72a2b0"
},
{
"contractState": "confirmed",
"orderState": "null",
"time": 1591095363,
"hash": "37524bad540da71c60cda801f0f9025401a2f9da8e33d7ea9003318774d8d057"
},
{
"contractState": "confirmed",
"orderState": "success",
"time": 1591095406,
"hash": "e531dfcc38f0aa760487d4deb91573285e7f889cb564c53c9189497e6cf66297"
},
{
"contractState": "confirmed",
"orderState": "complete",
"time": 1591095416,
"hash": "8d27d72a5b2ba82498958c6a0413ac031bf1b54085adcf11eee403d827a34c15"
}
]
}
],
"totalOrders": 3
}
}
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getOrderInfoByAddress",
"params": [
"qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
5,
0
]
}
# DoDSettlement_getOrderCountByAddressAndSeller
Get order count by buyer's address and seller's address.
Parameters:
- buyer's qlc address
- seller's qlc address
Returns:
- order count
Example:
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getOrderCountByAddressAndSeller",
"params": [
"qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3"
]
}
{
"jsonrpc": "2.0",
"id": 3,
"result": 3
}
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getOrderCountByAddressAndSeller",
"params": [
"qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3"
]
}
# DoDSettlement_getOrderInfoByAddressAndSeller
Get order info by buyer's address and seller's address.
Parameters:
- buyer's qlc address
- seller's qlc address
- count
- offset
Returns:
orderinfo
: order arraytotalOrders
: total order count
Example:
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getOrderInfoByAddressAndSeller",
"params": [
"qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
3,
2
]
}
{
"jsonrpc": "2.0",
"id": 3,
"result": {
"orderInfo": [
{
"buyer": {
"address": "qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"name": "CBC"
},
"seller": {
"address": "qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"name": "PCCWG"
},
"orderId": "order003",
"orderType": "terminate",
"orderState": "complete",
"contractState": "confirmed",
"connections": [
{
"itemId": "item496704013227867488",
"buyerProductId": "buyerProduct1917910293729382797",
"productOfferingId": "productOfferingId001",
"productId": "product001",
"srcCompanyName": "CBC",
"srcRegion": "CHN",
"srcCity": "HK",
"srcDataCenter": "DCX",
"srcPort": "port1",
"dstCompanyName": "CBC",
"dstRegion": "USA",
"dstCity": "NYC",
"dstDataCenter": "DCY",
"dstPort": "port2",
"quoteId": "quote7270827408837322169",
"quoteItemId": "quoteItem9147229863603776145",
"connectionName": "connection4030270824757057501",
"paymentType": "invoice",
"billingType": "PAYG",
"currency": "USD",
"serviceClass": "gold",
"bandwidth": "200 Mbps",
"billingUnit": "second",
"price": 20,
"addition": 0,
"startTime": 0,
"endTime": 0
}
],
"track": [
{
"contractState": "request",
"orderState": "null",
"time": 1591095653,
"hash": "ded8f414c9e042ee0116f0a46e37b4574710e800d23ef50d598aa84af49c70c0"
},
{
"contractState": "confirmed",
"orderState": "null",
"time": 1591095669,
"hash": "38f63d7706641019606fdede4fce5f68a85d741d30f69946ae886a6103b9dd54"
},
{
"contractState": "confirmed",
"orderState": "success",
"time": 1591095809,
"hash": "ebf4ff89bc11707b6973e7d4d7e8efbb51bf8755bcb29d1161143ed0bbfdbef1"
},
{
"contractState": "confirmed",
"orderState": "complete",
"time": 1591095818,
"hash": "c2fdea6ed8ecd2808019cb27413fcb96318cc413a94c6c59cbfb2c9d07c0b248"
}
]
},
{
"buyer": {
"address": "qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"name": "CBC"
},
"seller": {
"address": "qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"name": "PCCWG"
},
"orderId": "order002",
"orderType": "change",
"orderState": "complete",
"contractState": "confirmed",
"connections": [
{
"itemId": "item496704013227867488",
"buyerProductId": "buyerProduct1917910293729382797",
"productOfferingId": "productOfferingId001",
"productId": "product001",
"srcCompanyName": "CBC",
"srcRegion": "CHN",
"srcCity": "HK",
"srcDataCenter": "DCX",
"srcPort": "port1",
"dstCompanyName": "CBC",
"dstRegion": "USA",
"dstCity": "NYC",
"dstDataCenter": "DCY",
"dstPort": "port2",
"quoteId": "quote6031908666772364622",
"quoteItemId": "quoteItem5467873725997985832",
"connectionName": "connection4030270824757057501",
"paymentType": "invoice",
"billingType": "PAYG",
"currency": "USD",
"serviceClass": "gold",
"bandwidth": "200 Mbps",
"billingUnit": "second",
"price": 2,
"addition": 0,
"startTime": 0,
"endTime": 0
}
],
"track": [
{
"contractState": "request",
"orderState": "null",
"time": 1591095499,
"hash": "ad1bcded1f32385d3e92f0dee29cb0f9452dae3da5500a5e36ec37717ab2ff7c"
},
{
"contractState": "confirmed",
"orderState": "null",
"time": 1591095512,
"hash": "fe3d9be943c547460a1eb3a45b1f6baa5985c99e4656794943cb79f4960db816"
},
{
"contractState": "confirmed",
"orderState": "success",
"time": 1591095572,
"hash": "a1e14557945861e02b13413cfe06374896b41526a11844fd637b591d0c0b0f1c"
},
{
"contractState": "confirmed",
"orderState": "complete",
"time": 1591095580,
"hash": "4159bef23c29cdb51fa4c7726529382760c6b6fb17b6ac563713c1c5a0da0214"
}
]
},
{
"buyer": {
"address": "qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"name": "CBC"
},
"seller": {
"address": "qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
"name": "PCCWG"
},
"orderId": "order001",
"orderType": "create",
"orderState": "complete",
"contractState": "confirmed",
"connections": [
{
"itemId": "item496704013227867488",
"buyerProductId": "buyerProduct1917910293729382797",
"productOfferingId": "productOfferingId001",
"productId": "product001",
"srcCompanyName": "CBC",
"srcRegion": "CHN",
"srcCity": "HK",
"srcDataCenter": "DCX",
"srcPort": "port1",
"dstCompanyName": "CBC",
"dstRegion": "USA",
"dstCity": "NYC",
"dstDataCenter": "DCY",
"dstPort": "port2",
"quoteId": "quote4647401443521770947",
"quoteItemId": "quoteItem4919214398518384874",
"connectionName": "connection4030270824757057501",
"paymentType": "invoice",
"billingType": "PAYG",
"currency": "USD",
"serviceClass": "gold",
"bandwidth": "100 Mbps",
"billingUnit": "second",
"price": 1,
"addition": 0,
"startTime": 0,
"endTime": 0
}
],
"track": [
{
"contractState": "request",
"orderState": "null",
"time": 1591095353,
"hash": "d792df87b66a59f78550d29a8fb2867b4d68a2fe14156ba9c5ab78828d72a2b0"
},
{
"contractState": "confirmed",
"orderState": "null",
"time": 1591095363,
"hash": "37524bad540da71c60cda801f0f9025401a2f9da8e33d7ea9003318774d8d057"
},
{
"contractState": "confirmed",
"orderState": "success",
"time": 1591095406,
"hash": "e531dfcc38f0aa760487d4deb91573285e7f889cb564c53c9189497e6cf66297"
},
{
"contractState": "confirmed",
"orderState": "complete",
"time": 1591095416,
"hash": "8d27d72a5b2ba82498958c6a0413ac031bf1b54085adcf11eee403d827a34c15"
}
]
}
],
"totalOrders": 3
}
}
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getOrderInfoByAddressAndSeller",
"params": [
"qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3",
3,
2
]
}
# DoDSettlement_getProductCountByAddress
Get product count by buyer's address.
Parameters:
- buyer's qlc address
Returns:
- product count
Example:
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getProductCountByAddress",
"params": [
"qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe"
]
}
{
"jsonrpc": "2.0",
"id": 3,
"result": 3
}
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getProductCountByAddress",
"params": [
"qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe"
]
}
# DoDSettlement_getProductInfoByAddress
Get product info by buyer's address.
Parameters:
- buyer's qlc address
- count
- offset
Returns:
productInfo
: product info array (order by create time desc)totalProducts
: total product count
Example:
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getProductInfoByAddress",
"params": [
"qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
5,
0
]
}
{
"jsonrpc": "2.0",
"id": 3,
"result": {
"productInfo": [
{
"itemId": "item3683248281921503753",
"buyerProductId": "buyerProduct774847696419776906",
"productOfferingId": "productOfferingId001",
"productId": "product001",
"srcCompanyName": "CBC",
"srcRegion": "CHN",
"srcCity": "HK",
"srcDataCenter": "DCX",
"srcPort": "port1",
"dstCompanyName": "CBC",
"dstRegion": "USA",
"dstCity": "NYC",
"dstDataCenter": "DCY",
"dstPort": "port2",
"active": {
"orderId": "order003",
"connectionName": "connection8634530631046857655",
"paymentType": "invoice",
"billingType": "DOD",
"currency": "USD",
"serviceClass": "gold",
"bandwidth": "30 Mbps",
"price": 330,
"addition": 150,
"startTime": 1590076800,
"endTime": 1591372800
},
"done": [
{
"orderId": "order001",
"connectionName": "connection8634530631046857655",
"paymentType": "invoice",
"billingType": "DOD",
"currency": "USD",
"serviceClass": "gold",
"bandwidth": "10 Mbps",
"price": 300,
"addition": 300,
"startTime": 1589472000,
"endTime": 1592064000
},
{
"orderId": "order002",
"connectionName": "connection8634530631046857655",
"paymentType": "invoice",
"billingType": "DOD",
"currency": "USD",
"serviceClass": "gold",
"bandwidth": "20 Mbps",
"price": 100,
"addition": 50,
"startTime": 1589904000,
"endTime": 1590336000
}
],
"disconnect": null,
"track": [
{
"orderType": "create",
"orderId": "order001",
"time": 1590717146,
"changed": {
"connectionName": "connection8634530631046857655",
"paymentType": "invoice",
"billingType": "DOD",
"currency": "USD",
"serviceClass": "gold",
"bandwidth": "10 Mbps",
"price": 300,
"addition": 0,
"startTime": 1589472000,
"endTime": 1592064000
}
},
{
"orderType": "change",
"orderId": "order002",
"time": 1590717423,
"changed": {
"currency": "USD",
"bandwidth": "20 Mbps",
"price": 100,
"addition": 0,
"startTime": 1589904000,
"endTime": 1590336000
}
},
{
"orderType": "change",
"orderId": "order003",
"time": 1590717503,
"changed": {
"currency": "USD",
"bandwidth": "30 Mbps",
"price": 330,
"addition": 0,
"startTime": 1590076800,
"endTime": 1591372800
}
}
]
}
],
"totalProducts": 1
}
}
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getProductInfoByAddress",
"params": [
"qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
5,
0
]
}
# DoDSettlement_getProductCountByAddressAndSeller
Get product count by buyer's address and seller's address.
Parameters:
- buyer's qlc address
- seller's qlc address
Returns:
- product count
Example:
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getProductCountByAddressAndSeller",
"params": [
"qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3"
]
}
{
"jsonrpc": "2.0",
"id": 3,
"result": 3
}
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_getProductCountByAddressAndSeller",
"params": [
"qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3"
]
}
# DoDSettlement_GetProductInfoByAddressAndSeller
Get product info by buyer's address and seller's address.
Parameters:
- buyer's qlc address
- seller's qlc address
- count
- offset
Returns:
productInfo
: prdocut info arraytotalProducts
: total product count
Example:
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_GetProductInfoByAddressAndSeller",
"params": [
"qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3"
]
}
{
"jsonrpc": "2.0",
"id": 3,
"result": {
"productInfo": [
{
"itemId": "item3683248281921503753",
"buyerProductId": "buyerProduct774847696419776906",
"productOfferingId": "productOfferingId001",
"productId": "product001",
"srcCompanyName": "CBC",
"srcRegion": "CHN",
"srcCity": "HK",
"srcDataCenter": "DCX",
"srcPort": "port1",
"dstCompanyName": "CBC",
"dstRegion": "USA",
"dstCity": "NYC",
"dstDataCenter": "DCY",
"dstPort": "port2",
"active": {
"orderId": "order003",
"connectionName": "connection8634530631046857655",
"paymentType": "invoice",
"billingType": "DOD",
"currency": "USD",
"serviceClass": "gold",
"bandwidth": "30 Mbps",
"price": 330,
"addition": 150,
"startTime": 1590076800,
"endTime": 1591372800
},
"done": [
{
"orderId": "order001",
"connectionName": "connection8634530631046857655",
"paymentType": "invoice",
"billingType": "DOD",
"currency": "USD",
"serviceClass": "gold",
"bandwidth": "10 Mbps",
"price": 300,
"addition": 300,
"startTime": 1589472000,
"endTime": 1592064000
},
{
"orderId": "order002",
"connectionName": "connection8634530631046857655",
"paymentType": "invoice",
"billingType": "DOD",
"currency": "USD",
"serviceClass": "gold",
"bandwidth": "20 Mbps",
"price": 100,
"addition": 50,
"startTime": 1589904000,
"endTime": 1590336000
}
],
"disconnect": null,
"track": [
{
"orderType": "create",
"orderId": "order001",
"time": 1590717146,
"changed": {
"connectionName": "connection8634530631046857655",
"paymentType": "invoice",
"billingType": "DOD",
"currency": "USD",
"serviceClass": "gold",
"bandwidth": "10 Mbps",
"price": 300,
"addition": 0,
"startTime": 1589472000,
"endTime": 1592064000
}
},
{
"orderType": "change",
"orderId": "order002",
"time": 1590717423,
"changed": {
"currency": "USD",
"bandwidth": "20 Mbps",
"price": 100,
"addition": 0,
"startTime": 1589904000,
"endTime": 1590336000
}
},
{
"orderType": "change",
"orderId": "order003",
"time": 1590717503,
"changed": {
"currency": "USD",
"bandwidth": "30 Mbps",
"price": 330,
"addition": 0,
"startTime": 1590076800,
"endTime": 1591372800
}
}
]
}
],
"totalProducts": 1
}
}
{
"jsonrpc": "2.0",
"id": 3,
"method": "DoDSettlement_GetProductInfoByAddressAndSeller",
"params": [
"qlc_1bwjtpipkzc7aj6hmuodncjmfsb4tou9word8bj9jxcm68cheipad54q66xe",
"qlc_3gwf5kgcsdjkermpquc9y83fscibp3prk6wdd8hfpduoo81ojrfrfp7zoko3"
]
}