tss-api（TSS API 文档）

Compass TSS API Skills

TSS 跨链服务 API 技能文档 Base URL: https://tss-api.chainservice.io Version: 1.0

概述

Compass TSS API 是一套跨链交易查询服务接口，提供跨链交易记录查询、链上扫描高度获取、Pending 交易列表等功能。

数据模型

CrossData

跨链交易基础数据结构。

CrossSet

跨链交易完整数据集合，描述一笔跨链交易在各链上的状态。

StatusOfCross（跨链状态枚举）

API 接口

1. 获取当前扫描最高高度

根据 chainId 获取当前扫描有交易的最高区块高度。

• Method: GET
• Path: /cross/chain/height
• Tags: 交易记录

请求参数

响应

200 OK

{
  "height": "string"
}

示例

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

2. 获取高度对应的交易集群

根据 chainId 和区块高度获取该高度下的交易 orderId 集合。

• Method: GET
• Path: /cross/chain/height/orders
• Tags: 交易记录

请求参数

响应

200 OK

{
  "height": "string",
  "set": ["orderId_1", "orderId_2"]
}

示例

curl -X GET "https://tss-api.chainservice.io/cross/chain/height/orders?chainId=1&height=12245"

3. 根据高度区间获取交易列表

根据 chainId 和起止高度查询区间内的所有跨链交易。

• Method: GET
• Path: /cross/height/range/txs
• Tags: 交易记录

请求参数

响应

200 OK

返回 CrossSet 数组：

[
  {
    "data": {
      "src": { ... },
      "relay": { ... },
      "dest": { ... },
      "order_id": "string",
      "status": 0,
      "status_str": "string",
      "now": 0
    }
  }
]

示例

curl -X GET "https://tss-api.chainservice.io/cross/height/range/txs?chainId=1&startHeight=1000&endHeight=2000"

4. 通过 orderId 获取交易记录

根据跨链订单 ID 查询完整的交易记录。

• Method: GET
• Path: /cross/order
• Tags: 交易记录

请求参数

响应

200 OK

{
  "data": {
    "src": { ... },
    "relay": { ... },
    "relay_signed": { ... },
    "dest": { ... },
    "map_dest": { ... },
    "order_id": "string",
    "status": 3,
    "status_str": "completed",
    "now": 1767097427
  }
}

示例

curl -X GET "https://tss-api.chainservice.io/cross/order?orderId=your_order_id"

5. 获取 Pending 交易列表

根据 chainId 获取当前处于 Pending 状态的交易列表。

• Method: GET
• Path: /cross/pending/tx
• Tags: 交易记录

请求参数

响应

200 OK

{
  "txs": ["tx_hash_1", "tx_hash_2"]
}

示例

curl -X GET "https://tss-api.chainservice.io/cross/pending/tx?chainId=1"

6. 通过 txHash 获取交易记录

根据交易哈希查询跨链交易记录。

• Method: GET
• Path: /cross/tx
• Tags: 交易记录

请求参数

响应

200 OK

{
  "data": {
    "src": { ... },
    "relay": { ... },
    "relay_signed": { ... },
    "dest": { ... },
    "map_dest": { ... },
    "order_id": "string",
    "status": 3,
    "status_str": "completed",
    "now": 1767097427
  }
}

示例

curl -X GET "https://tss-api.chainservice.io/cross/tx?tx=0xYourTransactionHash"

错误码

接口总览