Method: projects.locations.endpoints.submitTransaction

트랜잭션을 네트워크에 제출합니다. 요청이 먼저 기본적인 정확성에 대해 검증됩니다. 유효성 검사에 실패하면 요청이 즉시 실패합니다. 유효성 검사에 성공하면 이 메서드는 트랜잭션이 네트워크의 대부분의 검사기에 복제된 후에만 반환되거나 요청이 실패할 때까지 반환되지 않습니다.

HTTP 요청


POST https://universalledger.googleapis.com/v1/{endpoint=projects/*/locations/*/endpoints/*}:submitTransaction

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
endpoint

string

필수 항목입니다. 거래를 제출할 엔드포인트입니다. 형식: projects/{project}/locations/{location}/endpoints/{endpoint} 위치는 리전입니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "serializedSignedTransaction": string
}
필드
serializedSignedTransaction

string (bytes format)

필수 항목입니다. 원장에 제출할 protobuf 직렬화된 SignedTransaction입니다. 직렬화된 형식을 사용하면 모든 유효성 검사기가 직렬화된 바이트의 SHA-256 다이제스트와 동일한 트랜잭션 ID를 계산합니다.

base64 인코딩 문자열입니다.

응답 본문

endpoints.submitTransaction의 응답 메시지입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "transactionDigestHex": string
}
필드
transactionDigestHex

string

제출된 거래를 고유하게 나타내는 식별자입니다. serializedSignedTransaction의 SHA-256 다이제스트의 16진수 표현입니다. 이 거래 ID는 클라이언트가 해싱 로직을 직접 구현하지 않고도 거래를 추적할 수 있도록 제공됩니다. 식별자는 후속 API 호출에서 직접 사용할 수 있습니다(예: 거래 상태를 쿼리하는 경우).

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참고하세요.