TxController.java

package org.cardanofoundation.explorer.api.controller;

import java.util.List;

import jakarta.validation.Valid;

import lombok.RequiredArgsConstructor;

import org.springframework.data.domain.Sort;

import org.springframework.http.ResponseEntity;

import org.springframework.validation.annotation.Validated;

import org.springframework.web.bind.annotation.GetMapping;

import org.springframework.web.bind.annotation.PathVariable;

import org.springframework.web.bind.annotation.RequestMapping;

import org.springframework.web.bind.annotation.RestController;

import io.swagger.v3.oas.annotations.Operation;

import io.swagger.v3.oas.annotations.Parameter;

import io.swagger.v3.oas.annotations.tags.Tag;

import org.springdoc.core.annotations.ParameterObject;

import org.cardanofoundation.explorer.api.common.constant.CommonConstant;

import org.cardanofoundation.explorer.api.common.enumeration.TxChartRange;

import org.cardanofoundation.explorer.api.config.LogMessage;

import org.cardanofoundation.explorer.api.model.metadatastandard.bolnisi.CertDetailsData;

import org.cardanofoundation.explorer.api.model.metadatastandard.bolnisi.WineryData;

import org.cardanofoundation.explorer.api.model.response.BaseFilterResponse;

import org.cardanofoundation.explorer.api.model.response.TxFilterResponse;

import org.cardanofoundation.explorer.api.model.response.dashboard.TxGraph;

import org.cardanofoundation.explorer.api.model.response.dashboard.TxSummary;

import org.cardanofoundation.explorer.api.model.response.tx.TxResponse;

import org.cardanofoundation.explorer.api.service.BolnisiMetadataService;

import org.cardanofoundation.explorer.api.service.TxService;

import org.cardanofoundation.explorer.common.validation.length.LengthValid;

import org.cardanofoundation.explorer.common.validation.pagination.Pagination;

import org.cardanofoundation.explorer.common.validation.pagination.PaginationDefault;

import org.cardanofoundation.explorer.common.validation.pagination.PaginationValid;

@RestController

@RequestMapping("/api/v1/txs")

@Validated

@Tag(name = "transaction", description = "The transaction APIs")

public class TxController {

  private final TxService txService;

  private final BolnisiMetadataService bolnisiMetadataService;

  @GetMapping

  @LogMessage

  @Operation(summary = "Filter transaction")

  public ResponseEntity<BaseFilterResponse<TxFilterResponse>> filter(

      @ParameterObject

          @PaginationValid

          @PaginationDefault(

              size = 20,

              sort = {"blockId", "blockIndex"},

              direction = Sort.Direction.DESC)

          @Valid

          Pagination pagination) {

  }

  @GetMapping("/{hash}")

  @LogMessage

  @Operation(summary = "Get transaction detail by hash")

  public ResponseEntity<TxResponse> getTransactionDetail(

      @PathVariable

          @Parameter(description = "The hash identifier of the transaction.")

          @LengthValid(CommonConstant.TX_HASH_LENGTH)

          String hash) {

  }

  @GetMapping("/{hash}/{wineryId}")

  @LogMessage

  @Operation(summary = "Get winery data by tx hash detail")

  public ResponseEntity<WineryData> getWineryDataByTxHash(

      @PathVariable

          @Parameter(description = "The hash identifier of the transaction.")

          @LengthValid(CommonConstant.TX_HASH_LENGTH)

          String hash,

      @PathVariable @Parameter(description = "The winery id") String wineryId) {

  }

  @GetMapping("/{hash}/certData/{certNo}")

  @LogMessage

  @Operation(summary = "Get certificate data by tx hash detail")

  public ResponseEntity<CertDetailsData> getCertDataByTxHash(

      @PathVariable

          @Parameter(description = "The hash identifier of the transaction.")

          @LengthValid(CommonConstant.TX_HASH_LENGTH)

          String hash,

      @PathVariable @Parameter(description = "The certificate number") String certNo) {

  }

  @GetMapping("/current")

  @LogMessage

  @Operation(summary = "Get current transactions")

  public ResponseEntity<List<TxSummary>> findCurrentTransaction() {

  }

  @GetMapping("/graph/{range}")

  @LogMessage

  @Operation(summary = "Get transaction chart (1M, 3M, 1Y, 3Y, MAX)")

  public ResponseEntity<List<TxGraph>> getTransactionChart(

      @PathVariable("range") @Parameter(description = "Type for chart") TxChartRange range) {

  }

}

Mutations