TSS Cross-chain API

TSS cross-chain API returns TSS cross-chain data, and provides the following interfaces.

• getChainTxHeight

• getOrderSetByChainHeight

• getRecordByOrderId

• getRecordByTxHash

• getChainPendingTxs

getChainTxHeight

Get the current scan height of the chain based on the specified blockchain ID.

• Method: GET

• Path: /cross/chain/height

• Describe: Query the current scan height of a specified blockchain。

Parameters

Parameter	Type	Requied	Description
chainId	string	Yes	Unique Identifier of Blockchain

Returns

return string of chain height

Example

• Request:

  curl -X GET "https://tss-api.chainservice.io/cross/chain/height?chainId=22776"

• Response:

  {
    "code": 0,
    "data": {
      "height": "22099966"
    },
    "msg": "success"
  }

getOrderSetByChainHeight

Based on the blockchain ID and block height, retrieve the set of all cross-chain transaction order IDs scanned at that height.

• Method: GET

• Path: /cross/chain/height/orders

• Describe: Query all cross-chain transaction orders that occurred at a specific block height.

Parameters

Parameter	Type	Requied	Description
chainId	string	Yes	22776
height	string	Yes	12245

Returns

`Array` - Array of string

Example

• Request:

  curl -X 'GET' \
    'https://tss-api.chainservice.io/cross/chain/height/orders?chainId=22776&height=22099953' \
    -H 'accept: application/json'

• Response:

  {
    "code": 0,
    "data": {
      "height": "22099966",
      "set": [
        "0x4acc386427ec855298c70442167cad7c51a614e1d2392c85013761296da490bd",
        "0xe2cb120be5c7c03c600e3a202a2b4a5bdf69410db5b0a67a2be4a7d2a81cb141"
      ]
    },
    "msg": "success"
  }

getRecordByOrderId

Retrieve the complete cross-chain status record of a transaction using the unique ID of the cross-chain order.

• Method: GET

• Path: /cross/order

• Describe: Query detailed transaction information across the entire chain based on cross-chain order ID.

Parameters

Parameter	Type	Requied	Description
orderId	string	Yes	Unique Identifier for Cross-Chain Orders

Returns

CrossSignel

• CrossSet A cross-chain transaction dataset describes the state of a cross-chain transaction across the entire chain.

  Field	Type	Description
  src	CrossData	src chain tx info
  dest	CrossData	dst chain tx info
  map_dest	CrossData	relay dst tx info
  relay	CrossData	relay tx info
  status	string	Cross-chain transaction status, the meaning of its numerical values can be found in the status enumeration.
  order_id	string	order id
  now	integer	Current timestamp.

• CrossData Transaction data details on a single chain.

  Field	Type	Description
  chain	string	chain id
  tx_hash	string	tx hash
  height	integer	tx on height
  log_index	integer	log in block index
  timestamp	integer	tx timestamp
  topic	string	tx topic
  order_id	string	tx orderId
  chain_and_gas_limit	string	Chain identifier and Gas limit combination information.

• status

  Number	Name
  0	StatusOfInit
  1	StatusOfPending
  2	StatusOfSend
  3	StatusOfCompleted
  4	StatusOfFailed

Example

• Request:

  curl -X 'GET' \
    'https://tss-api.chainservice.io/cross/order?orderId=0x4acc386427ec855298c70442167cad7c51a614e1d2392c85013761296da490bd' \
    -H 'accept: application/json'

• Response:

  {
    "code": 0,
    "data": {
      "data": {
        "src": {
          "tx_hash": "0x3851dfca6deef8095bce53a6b63230359d9dc3a9e944d5827ab36df387b2fea7",
          "topic": "0x2b44f5da40771b7770f8469714d202f01aa69c410bd79a5dd86f9562413c3fca",
          "height": 22099953,
          "order_id": "0x4acc386427ec855298c70442167cad7c51a614e1d2392c85013761296da490bd",
          "log_index": 6,
          "chain": "22776",
          "chain_and_gas_limit": "142967269125167041077142995715525384507308163214988674526560832",
          "timestamp": 1768802635,
          "is_memoized": false
        },
        "relay": {
          "tx_hash": "0x3851dfca6deef8095bce53a6b63230359d9dc3a9e944d5827ab36df387b2fea7",
          "topic": "0x2b44f5da40771b7770f8469714d202f01aa69c410bd79a5dd86f9562413c3fca",
          "height": 22099953,
          "order_id": "0x4acc386427ec855298c70442167cad7c51a614e1d2392c85013761296da490bd",
          "log_index": 6,
          "chain": "22776",
          "chain_and_gas_limit": "142967269125167041077142995715525384507308163214988674526560832",
          "timestamp": 1768802635,
          "is_memoized": false
        },
        "relay_signed": {
          "tx_hash": "0x3b26fe78cc8b3c336a68ece04dd08ffe1f03e0e2a69784b9e5f2fa4baf9b07cf",
          "topic": "0x0bbc5d146426ff8f68e7bcd94bd95e273fabd90609e118badb81428405e38107",
          "height": 22099955,
          "order_id": "0x4acc386427ec855298c70442167cad7c51a614e1d2392c85013761296da490bd",
          "log_index": 11,
          "chain": "22776",
          "chain_and_gas_limit": "142967269125167041077142995715525384507308163214988674526560832",
          "timestamp": 1768802645,
          "is_memoized": false
        },
        "dest": {
          "tx_hash": "0xa7186bd57ed3a5c7a7f3fc4651e33de1ab0939c6c08b9db25a1c19368335bc12",
          "topic": "0x8104943fdd0997a3240b59b381251572ac6ac81941e1af29845de70edca938a4",
          "height": 76128655,
          "order_id": "0x4acc386427ec855298c70442167cad7c51a614e1d2392c85013761296da490bd",
          "log_index": 213,
          "chain": "56",
          "chain_and_gas_limit": "142967269125167041077142995715525384507308163214988674526560832",
          "timestamp": 1768802651,
          "is_memoized": false
        },
        "map_dest": {
          "tx_hash": "0x394326d2b4a54b18f72aea913775b965b76b92a57d738a5bd989078ca3c3040b",
          "topic": "0x298a40641bd31f72c733761e0e85a6bd8a36909666ac2ed63a42c8015d025638",
          "height": 22099966,
          "order_id": "0x4acc386427ec855298c70442167cad7c51a614e1d2392c85013761296da490bd",
          "log_index": 2,
          "chain": "22776",
          "chain_and_gas_limit": "142967269125167041077142995715525384507308163214988674526560832",
          "timestamp": 1768802700,
          "is_memoized": false
        },
        "now": 0,
        "status": 3,
        "status_str": "completed",
        "order_id": ""
      }
    },
    "msg": "success"
  }

getRecordByTxHash

Retrieve the complete record of the cross-chain order to which a single transaction belongs by using its hash value.

• Method: GET

• Path: /cross/tx

• Describe: Based on the transaction hash on any chain, trace back the entire cross-chain process associated with it.。

Parameters

Parameter	Type	Requied	Description
tx	string	Yes	Transaction hash on any chain

Returns

CrossSignel

Example

• Request:

  curl -X 'GET' \
    'https://tss-api.chainservice.io/cross/tx?tx=0x3851dfca6deef8095bce53a6b63230359d9dc3a9e944d5827ab36df387b2fea7' \
    -H 'accept: application/json'

• Response:

  {
    "code": 0,
    "data": {
      "data": {
        "src": {
          "tx_hash": "0x3851dfca6deef8095bce53a6b63230359d9dc3a9e944d5827ab36df387b2fea7",
          "topic": "0x2b44f5da40771b7770f8469714d202f01aa69c410bd79a5dd86f9562413c3fca",
          "height": 22099953,
          "order_id": "0x4acc386427ec855298c70442167cad7c51a614e1d2392c85013761296da490bd",
          "log_index": 6,
          "chain": "22776",
          "chain_and_gas_limit": "142967269125167041077142995715525384507308163214988674526560832",
          "timestamp": 1768802635,
          "is_memoized": false
        },
        "relay": {
          "tx_hash": "0x3851dfca6deef8095bce53a6b63230359d9dc3a9e944d5827ab36df387b2fea7",
          "topic": "0x2b44f5da40771b7770f8469714d202f01aa69c410bd79a5dd86f9562413c3fca",
          "height": 22099953,
          "order_id": "0x4acc386427ec855298c70442167cad7c51a614e1d2392c85013761296da490bd",
          "log_index": 6,
          "chain": "22776",
          "chain_and_gas_limit": "142967269125167041077142995715525384507308163214988674526560832",
          "timestamp": 1768802635,
          "is_memoized": false
        },
        "relay_signed": {
          "tx_hash": "0x3b26fe78cc8b3c336a68ece04dd08ffe1f03e0e2a69784b9e5f2fa4baf9b07cf",
          "topic": "0x0bbc5d146426ff8f68e7bcd94bd95e273fabd90609e118badb81428405e38107",
          "height": 22099955,
          "order_id": "0x4acc386427ec855298c70442167cad7c51a614e1d2392c85013761296da490bd",
          "log_index": 11,
          "chain": "22776",
          "chain_and_gas_limit": "142967269125167041077142995715525384507308163214988674526560832",
          "timestamp": 1768802645,
          "is_memoized": false
        },
        "dest": {
          "tx_hash": "0xa7186bd57ed3a5c7a7f3fc4651e33de1ab0939c6c08b9db25a1c19368335bc12",
          "topic": "0x8104943fdd0997a3240b59b381251572ac6ac81941e1af29845de70edca938a4",
          "height": 76128655,
          "order_id": "0x4acc386427ec855298c70442167cad7c51a614e1d2392c85013761296da490bd",
          "log_index": 213,
          "chain": "56",
          "chain_and_gas_limit": "142967269125167041077142995715525384507308163214988674526560832",
          "timestamp": 1768802651,
          "is_memoized": false
        },
        "map_dest": {
          "tx_hash": "0x394326d2b4a54b18f72aea913775b965b76b92a57d738a5bd989078ca3c3040b",
          "topic": "0x298a40641bd31f72c733761e0e85a6bd8a36909666ac2ed63a42c8015d025638",
          "height": 22099966,
          "order_id": "0x4acc386427ec855298c70442167cad7c51a614e1d2392c85013761296da490bd",
          "log_index": 2,
          "chain": "22776",
          "chain_and_gas_limit": "142967269125167041077142995715525384507308163214988674526560832",
          "timestamp": 1768802700,
          "is_memoized": false
        },
        "now": 0,
        "status": 3,
        "status_str": "completed",
        "order_id": ""
      }
    },
    "msg": "success"
  }

getChainPendingTxs

Gets a list of cross-chain transaction hashes with a status of "Pending" on a specified chain.

• Method: GET

• Path: /cross/pending/tx

• Describe: Queries all cross-chain transactions on a given chain that have not yet been uploaded to the chain.

Parameters

Parameter	Type	Requied	Description
chainId	string	Yes	Transaction hash on any chain

Returns

Array of transaction hashes.

Example

• Request:

  curl -X 'GET' \
    'https://tss-api.chainservice.io/cross/pending/tx?chainId=1360095883558914' \
    -H 'accept: application/json'

• Response:

  {
    "code": 0,
    "data": {
      "txs": ["8c2d4520b91d4407c542256d46eace870b012704e10712ad220619af6b195780"]
    },
    "msg": "success"
  }