이력관리 목록 조회

GET /traces

프로젝트에 배포된 이력관리 컨트랙트 목록을 조회합니다.

쿼리 파라미터

파라미터	타입	기본값	설명
`page`	number	1	페이지 번호
`limit`	number	20	페이지당 항목 수

응답 예시

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "7de123ab-0000-4cde-8fgh-000000000001",
        "projectId": "550e8400-e29b-41d4-a716-446655440000",
        "name": "농산물 이력관리",
        "symbol": "AGRI",
        "description": "농산물 유통 추적 시스템",
        "contractAddress": "0xAbCd1234567890AbCd1234567890AbCd12345678",
        "status": "active",
        "fieldNames": ["생산지", "담당업체", "유통단계", "보관온도"],
        "fieldTypes": ["STRING", "STRING", "ENUM", "NUMBER"],
        "fieldRequireds": [true, true, true, false],
        "fieldOptions": [[], [], ["생산", "운송", "판매"], []],
        "itemCount": 15,
        "recordCount": 87,
        "createdAt": "2026-04-01T00:00:00.000Z"
      }
    ],
    "total": 1,
    "page": 1,
    "limit": 20,
    "totalPages": 1
  }
}

응답 필드

필드	설명
`status`	`deploying` (배포 중) / `active` (활성)
`fieldNames`	추적 필드 이름 목록
`fieldTypes`	필드 타입 (`STRING` / `NUMBER` / `BOOLEAN` / `DATE` / `ADDRESS` / `ENUM`)
`fieldRequireds`	필드별 필수 여부
`fieldOptions`	ENUM 타입 필드의 선택 옵션 목록
`itemCount`	등록된 아이템 수
`recordCount`	누적 이력 기록 수