Method: projects.locations.endpoints.submitTransaction

Mengirimkan transaksi ke jaringan. Permintaan akan divalidasi terlebih dahulu untuk memastikan kebenaran dasarnya. Jika validasi gagal, permintaan akan langsung gagal. Jika validasi berhasil, metode ini hanya akan ditampilkan setelah transaksi direplikasi di sebagian besar validator dalam jaringan, atau hingga permintaan gagal.

Permintaan HTTP


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

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
endpoint

string

Wajib. Endpoint untuk mengirimkan transaksi. Format: projects/{project}/locations/{location}/endpoints/{endpoint} Lokasi adalah region.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "serializedSignedTransaction": string
}
Kolom
serializedSignedTransaction

string (bytes format)

Wajib. SignedTransaction yang diserialisasi protobuf untuk dikirim ke ledger. Menggunakan format serial memastikan bahwa semua validator menghitung ID transaksi yang sama dengan ringkasan SHA-256 dari byte yang diserialisasi.

String berenkode base64.

Isi respons

Pesan respons untuk endpoints.submitTransaction.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "transactionDigestHex": string
}
Kolom
transactionDigestHex

string

ID yang secara unik mewakili transaksi yang dikirimkan. Ini adalah representasi heksadesimal dari ringkasan SHA-256 serializedSignedTransaction. ID transaksi ini disediakan agar klien dapat melacak transaksi tanpa perlu menerapkan logika hashing itu sendiri. ID dapat langsung digunakan dalam panggilan API berikutnya, misalnya untuk mengkueri status transaksi.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

Izin IAM

Memerlukan izin IAM berikut pada resource endpoint:

  • universalledger.endpoints.submit

Untuk mengetahui informasi selengkapnya, baca dokumentasi IAM.