# TSS Cross-chain API

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

* [getChainTxHeight](#getChainTxHeight)
* [getOrderSetByChainHeight](#getOrderSetByChainHeight)
* [getRecordByOrderId](#getRecordByOrderId)
* [getRecordByTxHash](#getRecordByTxHash)
* [getChainPendingTxs](#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**:

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

  ```json
  {
    "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**:

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

  ```json
  {
    "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**:

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

  ```json
  {
    "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](#CrossSignel)

### Example

* **Request**:

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

  ```json
  {
    "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**:

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

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mapprotocol.io/api-and-sdk/tss-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.