Package google.cloud.universalledger.v1

Indeks

UniversalLedger

Layanan untuk berinteraksi dengan Google Cloud Universal Ledger. Endpoint dibuat sebelumnya dan dikelola oleh Google serta tidak dapat diubah oleh pengguna. Nama endpoint yang tersedia akan diberikan dalam dokumentasi publik. Endpoint adalah resource regional dalam jaringan Universal Ledger. Permintaan yang dikirim ke endpoint dapat dirutekan ke validator yang berbeda dalam jaringan tertentu di wilayah tertentu.

GetEndpoint

rpc GetEndpoint(GetEndpointRequest) returns (Endpoint)

Mendapatkan detail endpoint tertentu.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
ListEndpoints

rpc ListEndpoints(ListEndpointsRequest) returns (ListEndpointsResponse)

Mencantumkan semua endpoint untuk project dan lokasi tertentu.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
QueryAccount

rpc QueryAccount(QueryAccountRequest) returns (QueryAccountResponse)

Mengirim kueri semua informasi yang disimpan tentang akun di jaringan. Detail akun yang ditampilkan dapat bervariasi di antara panggilan, karena endpoint dapat merutekan permintaan ke validator yang berbeda dalam jaringan dan wilayah, dan validator mungkin tidak berada pada ID putaran yang sama pada waktu tertentu.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
QueryData

rpc QueryData(QueryDataRequest) returns (QueryDataResponse)

Mengirim kueri ke jaringan untuk mendapatkan informasi yang disimpan di buku besar, seperti akun dan transaksi.

Akses ke kolom sensitif tertentu, seperti saldo akun, dapat dibatasi berdasarkan identitas pengirim yang berasal dari tanda tangan dalam permintaan. Jika pengirim tidak memiliki izin, kolom sensitif akan disamarkan dari respons dan dilaporkan di kolom redacted_fields.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
QueryTransactionState

rpc QueryTransactionState(QueryTransactionStateRequest) returns (QueryTransactionStateResponse)

Membuat kueri status transaksi. Metode ini dapat dipanggil untuk transaksi apa pun yang dikirimkan ke jaringan. Detail transaksi yang ditampilkan dapat bervariasi di antara panggilan, karena endpoint dapat merutekan permintaan ke validator yang berbeda dalam jaringan dan region, dan validator mungkin tidak berada di ID putaran yang sama pada waktu tertentu.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
SubmitOperationalTransaction

rpc SubmitOperationalTransaction(SubmitOperationalTransactionRequest) returns (SubmitOperationalTransactionResponse)

Mengirimkan transaksi operasional ke jaringan. Metode ini hanya ditampilkan setelah transaksi direplikasi di sebagian besar validator dalam jaringan, atau jika transaksi gagal.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
SubmitTransaction

rpc SubmitTransaction(SubmitTransactionRequest) returns (SubmitTransactionResponse)

Mengirimkan transaksi ke jaringan. Permintaan 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.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

Akun

Merepresentasikan status akun di buku besar.

Kolom
sequence_number

int64

Hanya output. Nomor urut akun ini. Nomor ini bertambah dengan setiap transaksi yang dikirim oleh akun ini.
public_key

bytes

Hanya output. Kunci publik utama yang terkait dengan akun ini, yang digunakan untuk verifikasi tanda tangan.
round_id

int64

Hanya output. ID putaran eksekusi (mirip dengan "tinggi" blok) saat informasi akun yang diberikan akurat.
comment

string

Hanya output. Komentar akun yang disimpan saat akun ini dibuat.
Kolom union account_details. Detail spesifik berdasarkan jenis akun. account_details hanya ada berupa salah satu diantara berikut:
user_details

UserDetails

Hanya output. Detail untuk akun pengguna standar.
account_manager_details

AccountManagerDetails

Hanya output. Detail untuk akun pengelola akun.
token_manager_details

TokenManagerDetails

Hanya output. Detail untuk akun pengelola token.
contract_token_manager_details

ContractTokenManagerDetails

Hanya output. Detail untuk akun pengelola token kontrak.
contract_details

ContractDetails

Hanya output. Detail untuk akun smart contract.
clearinghouse_details

ClearingHouseDetails

Hanya output. Detail untuk akun lembaga kliring.
currency_operator_details

CurrencyOperatorDetails

Hanya output. Detail untuk akun operator mata uang.
platform_operator_details

PlatformOperatorDetails

Hanya output. Detail untuk akun operator platform.

AccountIdList

Daftar ID akun.

Kolom
values[]

string

Opsional. Nilai ID akun.

AccountManagerDetails

Detail khusus untuk Account Manager.

Kolom
token_manager
(deprecated)

Entity

Hanya output. Tidak digunakan lagi: Gunakan token_manager_id sebagai gantinya. Pengelola token default untuk akun yang dibuat oleh pengelola akun ini.
num_accounts

int32

Hanya output. Jumlah akun yang dibuat oleh pengelola akun ini.
token_manager_id

string

Hanya output. ID pengelola token default untuk akun yang dibuat oleh pengelola akun ini.

AccountStatus

Status akun.

Enum
ACCOUNT_STATUS_UNSPECIFIED Status tidak valid.
ACCOUNT_STATUS_ACTIVE Status aktif saat akun dapat melakukan operasi yang diizinkan oleh perannya.
ACCOUNT_STATUS_INACTIVE Status tidak aktif saat semua transaksi di akun dilarang. Pengelola akun masih dapat mengirim transaksi pengelolaan akun.

ActivateAccount

Menandai akun sebagai ACCOUNT_STATUS_ACTIVE. Pengirim harus berupa account manager dari akun yang akan diaktifkan.

Pemilik akun dapat melanjutkan operasi normal yang diizinkan oleh peran di akun.

Kolom
account
(deprecated)

Entity

Opsional. Tidak digunakan lagi: Gunakan account_id sebagai gantinya. ID akun yang akan diaktifkan.
account_id

string

Opsional. ID akun yang akan diaktifkan. Salah satu dari account atau account_id harus ditentukan. Nilai dibatasi hingga 60 karakter.

AddRoles

Menambahkan peran yang ditentukan ke akun. Pengirim harus berupa pengelola akun yang akan diubah.

Kolom
account
(deprecated)

Entity

Opsional. Tidak digunakan lagi: Gunakan account_id sebagai gantinya. ID akun yang akan diubah.
account_id

string

Opsional. ID akun yang akan diubah. Salah satu dari account atau account_id harus ditentukan. Nilai dibatasi hingga 60 karakter.
roles[]

Role

Wajib. Peran yang akan ditambahkan.

AmountValue

Mewakili jumlah yang dinyatakan dalam mata uang.

Kolom
currency

QualifiedCurrencyValue

Wajib. Mata uang jumlah.
amount_value

int64

Wajib. Jumlah unit kecil mata uang.

BalanceToSettle

Saldo yang harus diselesaikan antara dua pengelola token.

Kolom
balance_payer
(deprecated)

Entity

Hanya output. Tidak digunakan lagi: Gunakan balance_payer_id sebagai gantinya. Akun yang memiliki saldo yang harus diselesaikan.
balance_payer_id

string

Hanya output. ID akun yang memiliki saldo yang harus diselesaikan.
balance_receiver
(deprecated)

Entity

Hanya output. Tidak digunakan lagi: Gunakan balance_receiver_id sebagai gantinya. Akun yang berhak menerima saldo yang akan diselesaikan.
balance_receiver_id

string

Hanya output. ID akun yang berhak menerima saldo yang akan diselesaikan.
balance

CurrencyValue

Hanya output. Saldo yang harus diselesaikan. Harus positif.

BoolList

Daftar boolean.

Kolom
values[]

bool

Opsional. Nilai boolean.

Luka Bakar

Membakar token mata uang. Pengirim harus berupa pengelola token dan akun yang menyediakan token untuk dibakar juga harus menandatangani transaksi.

Alur yang diharapkan adalah pengelola token akan memiliki akun pembakaran yang ditetapkan, tempat pelanggan akan mentransfer token sebelum dibakar. Atau, pelanggan dapat menandatangani transaksi secara langsung, yang dalam hal ini akan bertindak sebagai transaksi "transfer-and-burn" atomik.

Kolom
burn_amount

CurrencyValue

Wajib. Jumlah yang akan dibakar.
payer
(deprecated)

Entity

Opsional. Tidak digunakan lagi: Gunakan payer_id sebagai gantinya. Akun yang menyediakan token untuk dibakar. Akun harus mengaktifkan ROLE_PAYER.
payer_id

string

Opsional. ID akun yang menyediakan token untuk dibakar. Akun pembayar harus mengaktifkan ROLE_PAYER. Salah satu dari payer atau payer_id harus ditentukan.

ChangeAccountManager

Mentransfer tanggung jawab pengelolaan akun tertentu ke pengelola lain. Pengirim harus menjadi pengelola akun saat ini dan, untuk memberikan izin, pengelola baru juga harus menandatangani transaksi ini.

Kolom
account
(deprecated)

Entity

Opsional. Tidak digunakan lagi: Gunakan account_id sebagai gantinya. ID akun yang pengelolanya akan diubah.
account_id

string

Opsional. ID akun yang pengelolanya akan diubah. Salah satu dari account atau account_id harus ditentukan. Nilai dibatasi hingga 60 karakter.
next_manager
(deprecated)

Entity

Opsional. Tidak digunakan lagi: Gunakan next_manager_id sebagai gantinya. ID pengelola akun baru yang diusulkan. Validasi mengharuskan pengelola baru juga menandatangani transaksi ini.
next_manager_id

string

Opsional. ID pengelola akun baru yang diusulkan. Validasi mengharuskan pengelola baru juga menandatangani transaksi ini. Salah satu dari next_manager atau next_manager_id harus ditentukan. Nilai dibatasi hingga 60 karakter.

ClearingHouseDetails

Detail khusus untuk Pusat Informasi.

Kolom
account_status

AccountStatus

Hanya output. Status akun ini.
balances[]

BalanceToSettle

Hanya output. Saldo yang saat ini dilacak oleh lembaga kliring ini untuk penyelesaian.
settlement_mode

SettlementMode

Hanya output. Mode penyelesaian lembaga kliring ini.

ClientTransaction

Mewakili transaksi yang dimulai oleh klien.

Kolom
source
(deprecated)

Entity

Opsional. Pengirim transaksi. Tidak digunakan lagi: Gunakan sender_id sebagai gantinya.
sender_id

string

Opsional. ID akun yang mengirim transaksi ini. Salah satu dari source atau sender_id harus ditetapkan.
signatories[]
(deprecated)

Entity

Opsional. Akun yang, selain pengirim, telah menandatangani transaksi ini. Tidak digunakan lagi: Gunakan other_signatory_ids sebagai gantinya.
other_signatory_ids[]

string

Opsional. ID akun yang, selain pengirim, telah menandatangani transaksi ini.
sequence_number

int64

Wajib. Angka unik yang meningkat secara monoton, dimulai dari 0.

Nomor ini harus bertambah satu untuk setiap transaksi yang sebelumnya dikirimkan ke jaringan oleh pengirim transaksi yang sama.

Perhatikan bahwa hal ini tidak mencakup unit transaksi yang mungkin telah dikirimkan sebagai bagian dari rantai, yang tidak boleh menetapkan nomor urut. Namun, transaksi ini mencakup pengirim dari rantai transaksi itu sendiri.
chained_unit

bool

Harus disetel ke benar (true) jika transaksi klien ini adalah bagian dari rangkaian transaksi. Jika tidak, nilai ini harus ditetapkan ke salah (false).

Hal ini diperlukan untuk mencegah transaksi bertanda tangan yang dimaksudkan sebagai bagian dari rantai dikirimkan sendiri.
Kolom union kind. Pesan khusus transaksi klien. kind hanya ada berupa salah satu diantara berikut:
app
(deprecated)

Any

Opsional. Tidak digunakan lagi: Gunakan salah satu kolom khusus pesan sebagai gantinya. Pesan khusus transaksi klien. Harus salah satu dari:
operational

Any

Opsional. Pesan transaksi operasional. Perhatikan bahwa email ini hanya dapat dikirim oleh operator platform. Harus salah satu dari:
transfer_platform_operator_transaction

TransferPlatformOperator

Opsional. Pesan untuk mentransfer peran operator platform ke akun baru.
create_currency_operator_transaction

CreateCurrencyOperator

Opsional. Pesan untuk membuat operator mata uang baru.
transfer_currency_operator_transaction

TransferCurrencyOperator

Opsional. Pesan untuk mentransfer peran operator mata uang ke akun baru.
create_clearinghouse_transaction

CreateClearinghouse

Opsional. Pesan untuk membuat pusat informasi baru.
create_account_manager_transaction

CreateAccountManager

Opsional. Pesan untuk membuat pengelola akun baru.
create_token_manager_transaction

CreateTokenManager

Opsional. Pesan untuk membuat pengelola token baru yang terkait dengan mata uang operator yang mengirim permintaan.
increase_token_issuance_limit_transaction

IncreaseTokenIssuanceLimit

Opsional. Memberi tahu jaringan bahwa akun target telah menyetor dana cadangan dan meningkatkan batas penerbitan tokennya.
decrease_token_issuance_limit_transaction

DecreaseTokenIssuanceLimit

Opsional. Memberi tahu jaringan bahwa akun target ingin menarik dana cadangan dan mengurangi batas penerbitan tokennya.
settlement_request_transaction

SettlementRequest

Opsional. Pesan untuk memulai operasi penyelesaian.
mint_transaction

Mint

Opsional. Pesan untuk mencetak token mata uang dan mentransfernya ke akun.
burn_transaction

Burn

Opsional. Pesan untuk membakar token mata uang dari akun.
create_account_transaction

CreateAccount

Opsional. Pesan untuk membuat akun pengguna baru.
deactivate_account_transaction

DeactivateAccount

Opsional. Pesan untuk menonaktifkan akun pengguna.
activate_account_transaction

ActivateAccount

Opsional. Pesan untuk mengaktifkan akun pengguna.
add_roles_transaction

AddRoles

Opsional. Pesan untuk menambahkan peran ke akun.
remove_roles_transaction

RemoveRoles

Opsional. Pesan untuk menghapus peran dari akun.
change_account_manager_transaction

ChangeAccountManager

Opsional. Pesan untuk mengubah pengelola akun.
transfer_transaction

Transfer

Opsional. Pesan untuk mentransfer token dari satu akun pengguna ke akun pengguna lain.
create_contract_transaction

CreateContract

Opsional. Pesan untuk membuat kontrak baru di buku besar.
grant_contract_permissions_transaction

GrantContractPermissions

Opsional. Pesan untuk memberikan izin pada kontrak.
invoke_contract_method_transaction

InvokeContractMethod

Opsional. Pesan untuk memanggil eksekusi metode kontrak.
create_contract_token_manager_transaction

CreateContractTokenManager

Opsional. Pesan untuk membuat pengelola token baru yang terkait dengan mata uang operator yang mengirim permintaan.
transfer_contract_token_manager_transaction

TransferContractTokenManager

Opsional. Pesan untuk mentransfer peran pengelola token untuk mata uang dari satu akun ke akun lain.
remove_signing_public_key_transaction

RemoveSigningPublicKey

Opsional. Pesan untuk menghapus kunci penandatanganan akun.
replace_signing_public_key_transaction

ReplaceSigningPublicKey

Opsional. Pesan untuk mengganti kunci penandatanganan akun.
chain

TransactionChain

Opsional. Pesan untuk rangkaian transaksi yang mencakup beberapa unit transaksi untuk dieksekusi secara berurutan.

ContractDetails

Detail khusus untuk Smart Contract.

Kolom
owner
(deprecated)

Entity

Hanya output. Tidak digunakan lagi: Gunakan owner_id sebagai gantinya. Pemilik kontrak.
owner_id

string

Hanya output. ID pemilik kontrak.
code

bytes

Hanya output. Kode kontrak yang diserialisasi.
contract_fields

Fields

Hanya output. Kolom kontrak (nama kolom -> nilai) untuk kontrak ini.
currency_balances

map<string, CurrencyValue>

Hanya output. Saldo mata uang yang dimiliki oleh kontrak (operator mata uang -> saldo).

ContractPermission

Kumpulan izin yang dapat diberikan ke kontrak. Nilai lainnya diharapkan akan ditambahkan pada masa mendatang.

Enum
CONTRACT_PERMISSION_UNSPECIFIED Izin tidak valid.
CONTRACT_PERMISSION_STORAGE

Mengizinkan kontrak untuk membaca dan menulis ke penyimpanan yang dimiliki oleh akun yang memberikan izin. Kontrak hanya dapat membaca dan menulis properti yang sebelumnya telah ditulisnya.

Perhatikan bahwa hal ini tidak mengizinkan kontrak untuk membaca atau menulis data yang dikelola oleh kontrak lain; juga tidak mengizinkan kontrak untuk memperbarui properti akun lain secara langsung (misalnya, saldo akun dalam mata uang aslinya).

ContractTokenManagerDetails

Detail khusus untuk Pengelola Token Kontrak.

Kolom
issuance_limit

CurrencyValue

Hanya output. Jumlah token yang diizinkan oleh pengelola token kontrak ini untuk memberikan dukungan.

Karena pengelola token kontrak tidak dapat menaikkan atau menurunkan batas penerbitannya, batas ini harus sama dengan issued_tokens.
issued_tokens

CurrencyValue

Hanya output. Jumlah token yang didukung oleh pengelola token kontrak ini (yaitu, total kewajibannya).

Nilai ini sama dengan jumlah semua saldo yang disimpan dalam kontrak untuk mata uangnya, ditambah posisi bersihnya dalam matriks penyelesaian.
previous_contract_token_manager_id

string

Hanya output. ID akun pengelola token kontrak sebelumnya untuk mata uang ini. Hal ini membentuk jejak audit yang dapat dilalui untuk menemukan semua pengelola sebelumnya. Jika ini adalah pengelola token kontrak pertama untuk mata uang, kolom ini akan kosong.
account_status

AccountStatus

Hanya output. Status akun ini.

CreateAccount

Membuat akun pengguna baru. Pengirim harus berupa pengelola akun.

Jika transaksi berhasil, ID akun yang baru dibuat akan ditampilkan sebagai peristiwa di TransactionCertificate transaksi yang diselesaikan.

Kolom
public_key

bytes

Wajib. Kunci publik pemilik akun. Perhatikan bahwa ini bukan kunci publik pengirim. Ini adalah kunci publik pemilik akun baru dan akan disimpan di buku besar. Kunci ini akan digunakan untuk memvalidasi tanda tangan transaksi yang berasal dari akun yang dibuat.

Format kunci publik ditentukan oleh kolom key_format. Dianggap sebagai informasi publik.
key_format

KeyFormat

Opsional. Tidak dapat diubah. Format kunci dari kunci publik. Jika tidak ditentukan, defaultnya adalah keyset yang diserialisasi biner dalam format kabel Tink. Dianggap sebagai informasi publik.
roles[]

Role

Opsional. Daftar peran yang akan diberikan ke akun ini.
account_status

AccountStatus

Opsional. Status akun yang akan dibuat. Secara default, status akun yang baru dibuat adalah ACCOUNT_STATUS_ACTIVE.
account_comment

string

Opsional. Tidak dapat diubah. Kolom komentar buram yang tidak ditafsirkan oleh sistem, tetapi disimpan di buku besar dalam akun. Dianggap sebagai informasi publik. Panjang maksimum adalah 128 karakter. Dapat dibiarkan kosong. Setelah dibuat, kolom tidak dapat diubah.
token_manager
(deprecated)

Entity

Opsional. Tidak digunakan lagi: Gunakan token_manager_id sebagai gantinya. Pengelola token untuk akun ini. Kolom ini bersifat opsional dan jika tidak diberikan, pengelola token default yang terkait dengan pengelola akun (yaitu, pengirim transaksi ini) akan digunakan.
token_manager_id

string

Opsional. ID pengelola token untuk akun ini. Kolom ini bersifat opsional dan jika tidak diberikan, pengelola token default yang terkait dengan pengelola akun (yaitu, pengirim transaksi ini) akan digunakan. Nilai dibatasi hingga 60 karakter.

CreateAccountManager

Membuat pengelola akun baru. Pengirim harus merupakan operator mata uang.

Jika transaksi berhasil, ID akun yang baru dibuat akan ditampilkan sebagai peristiwa di TransactionCertificate transaksi yang diselesaikan.

Kolom
public_key

bytes

Wajib. Kunci publik pengelola akun baru. Perhatikan bahwa ini bukan kunci publik operator. Kunci publik ini akan dikaitkan dengan pengelola akun dan disimpan di buku besar. Kunci ini akan digunakan untuk memvalidasi tanda tangan transaksi yang berasal dari akun pengelola akun.

Format kunci publik ditentukan oleh kolom key_format. Dianggap sebagai informasi publik.
key_format

KeyFormat

Opsional. Tidak dapat diubah. Format kunci dari kunci publik. Jika tidak ditentukan, defaultnya adalah keyset yang diserialisasi biner dalam format kabel Tink. Dianggap sebagai informasi publik.
default_token_manager
(deprecated)

Entity

Opsional. Tidak digunakan lagi: Gunakan default_token_manager_id sebagai gantinya. Pengelola token default untuk akun yang akan dibuat oleh pengelola ini.
default_token_manager_id

string

Opsional. ID pengelola token default untuk akun yang akan dibuat oleh pengelola ini. Nilai dibatasi hingga 60 karakter.
account_comment

string

Opsional. Tidak dapat diubah. Kolom komentar buram yang tidak ditafsirkan oleh sistem, tetapi disimpan di buku besar dalam akun. Dianggap sebagai informasi publik. Panjang maksimum adalah 128 karakter. Dapat dibiarkan kosong. Setelah dibuat, kolom tidak dapat diubah.

CreateClearinghouse

Membuat pusat informasi baru. Pengirim harus merupakan operator mata uang.

Jika transaksi berhasil, ID akun yang baru dibuat akan ditampilkan sebagai peristiwa di TransactionCertificate transaksi yang diselesaikan.

Kolom
public_key

bytes

Wajib. Kunci publik pusat informasi baru. Perhatikan bahwa ini bukan kunci publik operator. Kunci publik ini akan dikaitkan dengan lembaga kliring dan disimpan di buku besar. Kunci ini akan digunakan untuk memvalidasi tanda tangan transaksi yang berasal dari akun lembaga kliring.

Format kunci publik ditentukan oleh kolom key_format. Dianggap sebagai informasi publik.
key_format

KeyFormat

Opsional. Tidak dapat diubah. Format kunci dari kunci publik. Jika tidak ditentukan, defaultnya adalah keyset yang diserialisasi biner dalam format kabel Tink. Dianggap sebagai informasi publik.
account_comment

string

Opsional. Tidak dapat diubah. Kolom komentar buram yang tidak ditafsirkan oleh sistem, tetapi disimpan di buku besar dalam akun. Dianggap sebagai informasi publik. Panjang maksimum adalah 128 karakter. Dapat dibiarkan kosong. Setelah dibuat, kolom tidak dapat diubah.
settlement_mode

SettlementMode

Wajib. Mode penyelesaian transaksi untuk lembaga kliring ini. Wajib. Dianggap sebagai informasi publik.

CreateContract

Menyimpan kontrak di buku besar.

Kolom
contract_bytes

bytes

Byte kontrak yang diserialisasi.
arguments
(deprecated)

map<string, Value>

Opsional. Tidak dapat diubah. Tidak digunakan lagi: Gunakan init_arguments sebagai gantinya. Argumen untuk metode __init__.
init_arguments

map<string, Value>

Opsional. Tidak dapat diubah. Berisi argumen untuk metode __init__.
contract_comment

string

Opsional. Tidak dapat diubah. Kolom komentar buram yang tidak ditafsirkan oleh sistem, tetapi disimpan di buku besar dalam kontrak. Dianggap sebagai informasi publik. Panjang maksimum adalah 128 karakter. Dapat dibiarkan kosong. Setelah dibuat, kolom tidak dapat diubah.

CreateContractTokenManager

Membuat pengelola token kontrak baru yang terkait dengan mata uang operator yang mengirim permintaan. Pengirim harus merupakan operator mata uang. Pengelola token kontrak yang baru dibuat aktif secara default. Jika pengelola token kontrak harus diganti, transaksi TransferContractTokenManager harus dikirim. Jika ada pengelola token kontrak lain yang terkait dengan mata uang yang sama, transaksi ini akan gagal.

Tidak seperti pengelola token biasa, pengelola token kontrak tidak diizinkan untuk menjalankan transaksi seperti mencetak atau menghapus. Namun, mereka dapat berpartisipasi dalam operasi penyelesaian.

Jika transaksi berhasil, ID akun yang baru dibuat akan ditampilkan sebagai peristiwa di TransactionCertificate transaksi yang diselesaikan.

Kolom
public_key

bytes

Wajib. Kunci publik pengelola token kontrak baru. Perhatikan bahwa ini bukan kunci publik operator. Kunci publik ini akan dikaitkan dengan pengelola token kontrak dan disimpan di buku besar. Akun ini akan digunakan untuk memvalidasi tanda tangan transaksi yang berasal dari akun pengelola token kontrak.

Format kunci publik ditentukan oleh kolom key_format. Dianggap sebagai informasi publik.
account_comment

string

Opsional. Tidak dapat diubah. Kolom komentar buram yang tidak ditafsirkan oleh sistem, tetapi disimpan di buku besar dalam akun. Dianggap sebagai informasi publik. Panjang maksimum adalah 128 karakter. Dapat dibiarkan kosong. Setelah dibuat, kolom tidak dapat diubah.
key_format

KeyFormat

Opsional. Tidak dapat diubah. Format kunci dari kunci publik. Jika tidak ditentukan, defaultnya adalah keyset yang diserialisasi biner dalam format kabel Tink. Dianggap sebagai informasi publik.

CreateCurrencyOperator

Membuat operator mata uang baru. Pengirim harus berupa operator platform.

Jika transaksi berhasil, ID akun yang baru dibuat akan ditampilkan sebagai peristiwa di TransactionCertificate transaksi yang diselesaikan.

Transaksi ini harus memperkenalkan mata uang baru ke dalam sistem. Jika mata uang yang ditentukan sudah ada, transaksi ini akan gagal. Jika operator mata uang harus diganti, transaksi TransferCurrencyOperator harus dikirim.

Kolom
public_key

bytes

Wajib. Kunci publik operator mata uang baru. Kunci publik ini akan dikaitkan dengan operator mata uang dan disimpan di buku besar. Kunci ini akan digunakan untuk memvalidasi tanda tangan transaksi yang berasal dari akun operator.

Format kunci publik ditentukan oleh kolom key_format. Dianggap sebagai informasi publik.
key_format

KeyFormat

Opsional. Tidak dapat diubah. Format kunci dari kunci publik. Jika tidak ditentukan, defaultnya adalah keyset yang diserialisasi biner dalam format kabel Tink. Dianggap sebagai informasi publik.
account_comment

string

Opsional. Tidak dapat diubah. Kolom komentar buram yang tidak ditafsirkan oleh sistem, tetapi disimpan di buku besar dalam akun. Dianggap sebagai informasi publik. Panjang maksimum adalah 128 karakter. Dapat dibiarkan kosong. Setelah dibuat, kolom tidak dapat diubah.
currency
(deprecated)

string

Opsional. Tidak digunakan lagi: Gunakan currency_code sebagai gantinya. Mata uang fiat yang terkait dengan operator ini, yang ditampilkan sebagai kode ISO 4217 3 huruf kapital. Dianggap sebagai informasi publik.
currency_code

string

Opsional. Mata uang fiat yang terkait dengan operator ini, yang ditampilkan sebagai kode ISO 4217 3 huruf kapital. Dianggap sebagai informasi publik.

CreateSnapshot

Jenis ini tidak memiliki kolom.

Memicu pembuatan snapshot jaringan. Pengirim harus berupa operator platform.

CreateTokenManager

Membuat pengelola token baru yang terkait dengan mata uang operator yang mengirim permintaan. Pengirim harus merupakan operator mata uang.

Jika transaksi berhasil, ID akun yang baru dibuat akan ditampilkan sebagai peristiwa di TransactionCertificate transaksi yang diselesaikan.

Kolom
public_key

bytes

Wajib. Kunci publik pengelola token baru. Perhatikan bahwa ini bukan kunci publik operator. Kunci publik ini akan dikaitkan dengan pengelola token dan disimpan di buku besar. Kunci ini akan digunakan untuk memvalidasi tanda tangan transaksi yang berasal dari akun pengelola token.

Format kunci publik ditentukan oleh kolom key_format. Dianggap sebagai informasi publik.
key_format

KeyFormat

Opsional. Tidak dapat diubah. Format kunci dari kunci publik. Jika tidak ditentukan, defaultnya adalah keyset yang diserialisasi biner dalam format kabel Tink. Dianggap sebagai informasi publik.
account_comment

string

Opsional. Tidak dapat diubah. Kolom komentar buram yang tidak ditafsirkan oleh sistem, tetapi disimpan di buku besar dalam akun. Dianggap sebagai informasi publik. Panjang maksimum adalah 128 karakter. Dapat dibiarkan kosong. Setelah dibuat, kolom tidak dapat diubah.

CurrencyOperatorDetails

Detail khusus untuk Operator Mata Uang.

Kolom
currency
(deprecated)

string

Hanya output. Tidak digunakan lagi: Gunakan currency_code sebagai gantinya. Mata uang yang terkait dengan akun ini, yang diwakili oleh kode ISO 4217 3 huruf.
currency_code

string

Hanya output. ID mata uang yang terkait dengan akun ini, yang diwakili oleh kode ISO 4217 3 huruf.
account_status

AccountStatus

Hanya output. Status akun ini.
previous_entity_id
(deprecated)

Entity

Hanya output. Tidak digunakan lagi: Gunakan previous_currency_operator_id sebagai gantinya. Operator mata uang sebelumnya yang mentransfer kepemilikan peran operator mata uang ke akun ini. Jika ini adalah operator mata uang pertama untuk mata uang, kolom ini akan kosong.
previous_currency_operator_id

string

Hanya output. ID operator mata uang sebelumnya yang mentransfer kepemilikan peran operator mata uang ke akun ini. Jika ini adalah operator mata uang pertama untuk mata uang, kolom ini akan kosong.
platform_operator_entity_id
(deprecated)

Entity

Hanya output. Tidak digunakan lagi: Gunakan platform_operator_id sebagai gantinya. Operator platform yang membuat operator mata uang ini.
platform_operator_id

string

Hanya output. ID operator platform yang membuat operator mata uang ini.
contract_token_manager
(deprecated)

Entity

Hanya output. Tidak digunakan lagi: Gunakan contract_token_manager_id sebagai gantinya. Pengelola token kontrak yang terkait dengan operator mata uang ini.
contract_token_manager_id

string

Hanya output. ID pengelola token kontrak yang terkait dengan operator mata uang ini.
clearinghouse_id

string

Hanya output. ID lembaga kliring yang terkait dengan operator mata uang ini.

CurrencyValue

Mewakili jumlah mata uang (yaitu uang). Perhatikan bahwa mata uang yang dinyatakan tidak disertakan dalam pesan ini. Mata uang yang relevan ditentukan oleh akun yang mengirim transaksi. Setiap akun memiliki mata uang unik yang tidak dapat diubah dan terkait dengannya.

Kolom
value

int64

Wajib. Jumlah unit kecil mata uang.

Denominasi valid terkecil ini disebut sebagai "unit kecil" dan ditentukan dalam ISO 4217. Sebagai contoh, untuk USD, nilainya adalah jumlah sen dan untuk GBP, nilainya adalah jumlah pence. Untuk Yen Jepang yang tidak memiliki unit kecil, nilainya adalah jumlah Yen.

DeactivateAccount

Menandai akun sebagai ACCOUNT_STATUS_INACTIVE. Pengirim harus berupa pengelola akun yang akan dinonaktifkan.

Hal ini berarti pemilik akun tidak akan dapat melakukan transaksi apa pun di akun tersebut, terlepas dari perannya.

Kolom
account
(deprecated)

Entity

Opsional. Tidak digunakan lagi: Gunakan account_id sebagai gantinya. ID akun yang akan dinonaktifkan.
account_id

string

Opsional. ID akun yang akan dinonaktifkan. Salah satu dari account atau account_id harus ditentukan. Nilai dibatasi hingga 60 karakter.

DecreaseTokenIssuanceLimit

Memberi tahu jaringan bahwa akun target ingin menarik dana cadangan dan mengurangi batas penerbitan tokennya. Pengirim harus berupa akun lembaga penayangan.

Perhatikan bahwa transaksi ini harus berhasil diselesaikan sebelum dana cadangan dapat ditarik. Hal ini diperlukan karena transaksi dapat gagal (misalnya, jika jumlah yang dicetak sudah di atas batas yang diminta).

Kolom
token_manager
(deprecated)

Entity

Opsional. Tidak digunakan lagi: Gunakan token_manager_id sebagai gantinya. ID akun institusional yang batas pencetakannya akan diturunkan. Akun ini harus berupa pengelola token agar transaksi valid.
token_manager_id

string

Opsional. ID akun institusional yang batas pencetakannya akan diturunkan. Akun ini harus berupa pengelola token agar transaksi valid. Salah satu dari token_manager_id (pilihan) atau token_manager (tidak digunakan lagi) harus ditentukan.
amount

CurrencyValue

Wajib. Jumlah yang digunakan untuk menurunkan batas. Jumlah harus positif. Transaksi akan gagal jika batas yang dikurangi akan berada di bawah token yang saat ini dikeluarkan.

DictList

Daftar kamus.

Kolom
values[]

DictValue

Opsional. Nilai DictValue. Semua dict bertingkat harus memiliki jenis konkret yang sama.

DictValue

Indeks memetakan kunci ke nilai. Misalnya, tombol keys[0] dipetakan ke values[0].

Kolom
Kolom union keys. Setiap kunci dapat berupa tepat satu jenis. keys hanya ada berupa salah satu diantara berikut:
bool_keys

BoolList

Opsional. Daftar kunci boolean.
string_keys

StringList

Opsional. Daftar kunci string.
int64_keys

Int64List

Opsional. Daftar kunci int64.
account_id_keys

AccountIdList

Opsional. Daftar kunci ID akun.
Kolom union values. Setiap nilai dapat berupa tepat satu jenis. values hanya ada berupa salah satu diantara berikut:
bool_values

BoolList

Opsional. Daftar nilai boolean.
string_values

StringList

Opsional. Daftar nilai string.
int64_values

Int64List

Opsional. Daftar nilai int64.
dict_values

DictList

Opsional. Nilai adalah daftar kamus bertingkat.

Endpoint

Mewakili endpoint Universal Ledger.

Kolom
name

string

ID. Nama resource endpoint. Format: projects/{project}/locations/{location}/endpoints/{endpoint}

Entity

Entitas dalam jaringan Universal Ledger. Semua akun dilampirkan ke entitas. ID entitas, yang juga sering disebut sebagai ID akun, bersifat unik dan tidak dapat diubah di seluruh jaringan.

Kolom
id

string

Hanya output. ID yang ditetapkan ke entitas. ID ini ditetapkan oleh jaringan saat pembuatan akun.

EventDetails

Mewakili detail tambahan dari peristiwa status.

Kolom
Kolom union event_details. Detail acara. event_details hanya ada berupa salah satu diantara berikut:
execution_details

ExecutionDetails

Hanya output. Detail tambahan untuk peristiwa eksekusi.

EventType

Mewakili jenis peristiwa dalam pemrosesan transaksi, sebagaimana diamati oleh validator yang menerima permintaan tersebut.

Enum
EVENT_TYPE_UNSPECIFIED Acara tidak diketahui atau tidak ditentukan.
EVENT_TYPE_RECEIVED Transaksi diterima oleh validator ini langsung dari klien.
EVENT_TYPE_BROADCASTED Transaksi disiarkan oleh validator ini ke validator lain.
EVENT_TYPE_ORDERED Transaksi dipesan dan dijadwalkan untuk dieksekusi oleh validator ini.
EVENT_TYPE_EXECUTION_STARTED Eksekusi transaksi telah dimulai.
EVENT_TYPE_EXECUTION_COMPLETED Eksekusi transaksi telah selesai.
EVENT_TYPE_FINALIZED Transaksi telah diselesaikan oleh validator ini.

ExecutionDetails

Detail tambahan untuk peristiwa eksekusi.

Kolom
round_id

int64

Hanya output. ID putaran saat peristiwa eksekusi terjadi.

Kolom

Peta kolom (nama kolom -> nilai) dari kontrak yang digunakan untuk merepresentasikan kolom kontrak atau kolom akun.

Kolom
fields

map<string, Value>

Hanya output. Peta nama kolom ke nilainya.

GetEndpointRequest

Pesan permintaan untuk GetEndpoint.

Kolom
name

string

Wajib. Nama endpoint yang akan diambil. Format: projects/{project}/locations/{location}/endpoints/{endpoint}

GrantContractPermissions

Memberikan izin ke kontrak oleh pengirim transaksi. Jika delegate_contract_id ditentukan, izin dan penyimpanan yang sesuai diberikan secara eksklusif untuk kontrak delegate_contract_id, bukan pengirim.

Perhatikan bahwa tidak ada dukungan untuk mencabut izin.

Kolom
contract
(deprecated)

Entity

Opsional. Tidak digunakan lagi: Gunakan contract_id sebagai gantinya. ID kontrak yang izinnya diberikan.
contract_id

string

Opsional. ID kontrak yang diberikan izinnya. Salah satu dari contract atau contract_id harus ditentukan.
permissions[]

ContractPermission

Izin yang akan diberikan.
delegate_contract_id

string

Opsional. ID kontrak yang izinnya diberikan. Pengirim transaksi harus merupakan pemilik kontrak ini.

IncreaseTokenIssuanceLimit

Transaksi untuk penerbitan dan pencetakan token. Memberi tahu jaringan bahwa akun target telah menyetor dana cadangan dan meningkatkan batas penerbitan tokennya. Pengirim harus berupa akun lembaga penayangan.

Kolom
token_manager
(deprecated)

Entity

Opsional. Tidak digunakan lagi: Gunakan token_manager_id sebagai gantinya. ID akun institusional yang batas pencetakannya akan dinaikkan. Akun ini harus berupa pengelola token agar transaksi valid.
token_manager_id

string

Opsional. ID akun institusional yang batas pencetakannya akan dinaikkan. Akun ini harus berupa pengelola token agar transaksi valid. Salah satu dari token_manager atau token_manager_id harus ditentukan.
amount

CurrencyValue

Wajib. Jumlah yang digunakan untuk menaikkan batas. Jumlah harus positif.

Int64List

Daftar int64.

Kolom
values[]

int64

Opsional. Nilai int64.

InvokeContractMethod

Memanggil eksekusi metode kontrak.

Kolom
contract
(deprecated)

Entity

Opsional. Tidak digunakan lagi: Gunakan contract_id sebagai gantinya. ID kontrak yang akan dijalankan.
contract_id

string

Opsional. ID kontrak yang akan dijalankan. Salah satu dari contract atau contract_id harus ditentukan.
method_name

string

Nama metode yang akan dijalankan.
arguments
(deprecated)

map<string, Value>

Opsional. Tidak dapat diubah. Tidak digunakan lagi: Gunakan method_arguments sebagai gantinya. Argumen untuk metode.
method_arguments

map<string, Value>

Opsional. Tidak dapat diubah. Berisi argumen yang akan diteruskan ke metode.
payment

CurrencyValue

Jumlah yang harus dibayar. Harus lebih besar dari nol saat memanggil metode yang dapat dibayar; dan nol untuk metode yang tidak dapat dibayar.

KeyFormat

Menentukan format kunci publik yang diberikan. Nilai baru dapat ditambahkan ke enum ini pada masa mendatang.

Enum
KEY_FORMAT_UNSPECIFIED Format kunci tidak ditentukan. Nilai ini tidak valid dan tidak boleh digunakan.
KEY_FORMAT_TINK_WIRE_FORMAT Kumpulan kunci yang diserialisasi biner dalam format melalui kabel Tink.
KEY_FORMAT_PEM_EC_P256_SHA256 Kunci penandatanganan kurva elips berenkode PEM menggunakan kurva P-256 dengan digest SHA256. Tanda tangan harus diberikan dalam format DER.

KeySlot

ID slot yang dapat menyimpan kunci di akun.

Enum
KEY_SLOT_UNSPECIFIED Slot kunci tidak ditentukan.
KEY_SLOT_PRIMARY Slot kunci utama.
KEY_SLOT_ALTERNATE Slot kunci alternatif.

ListEndpointsRequest

Pesan permintaan untuk ListEndpoints.

Kolom
parent

string

Wajib. Induk, yang memiliki kumpulan endpoint ini. Format: projects/{project}/locations/{location}
page_size

int32

Opsional. Jumlah maksimum endpoint yang akan ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini. Jika tidak ditentukan, paling banyak 50 endpoint akan ditampilkan. Nilai maksimum adalah 1.000; nilai di atas 1.000 akan dikonversi menjadi 1.000.
page_token

string

Opsional. Token halaman, yang diterima dari panggilan ListEndpoints sebelumnya. Berikan ini untuk mengambil halaman selanjutnya.

ListEndpointsResponse

Pesan respons untuk ListEndpoints.

Kolom
endpoints[]

Endpoint

Endpoint untuk project dan lokasi tertentu.
next_page_token

string

Token yang dapat dikirim sebagai page_token untuk mengambil halaman berikutnya. Jika kolom ini dihilangkan, tidak akan ada halaman berikutnya.

MerkleTree

Pohon Merkle dengan ringkasan kriptografi dari node root.

Kolom
root_hash_hex
(deprecated)

string

Hanya output. Ringkasan kriptografi dari node root. Tidak digunakan lagi: Gunakan root_digest_hex sebagai gantinya.
root_digest_hex

string

Hanya output. Representasi heksadesimal dari ringkasan node root. Format: String heksadesimal 64 karakter.
num_transactions

int64

Hanya output. Jumlah transaksi dalam hierarki.

Mint

Mencetak token mata uang dan mentransfernya ke akun tertentu. Pengirim harus berupa pengelola token.

Kolom
mint_amount

CurrencyValue

Wajib. Jumlah yang akan di-mint. Jumlahnya harus sedemikian rupa sehingga total token yang di-mint oleh pengelola token tidak melebihi batas mint. Jika jumlahnya lebih tinggi dari itu, transaksi harus ditolak
beneficiary
(deprecated)

Entity

Opsional. Tidak digunakan lagi: Gunakan beneficiary_id sebagai gantinya. Akun tujuan transfer jumlah yang dicetak. Akun penerima harus mengaktifkan ROLE_RECEIVER.
beneficiary_id

string

Opsional. ID akun yang akan menerima transfer jumlah yang dicetak. Akun penerima harus mengaktifkan ROLE_RECEIVER. Salah satu dari beneficiary atau beneficiary_id harus ditentukan.

NoneValue

Enumerasi singleton untuk merepresentasikan nilai None.

Enum
NONE_VALUE_UNSPECIFIED Nilai None.

PlatformOperatorDetails

Detail khusus untuk Operator Platform.

Kolom
account_status

AccountStatus

Hanya output. Status akun ini.
previous_entity_id
(deprecated)

Entity

Hanya output. Tidak digunakan lagi: Gunakan previous_platform_operator_id sebagai gantinya. Operator platform sebelumnya yang mentransfer kepemilikan peran operator platform ke akun ini. Jika ini adalah operator platform pertama, kolom ini akan kosong.
previous_platform_operator_id

string

Hanya output. ID operator platform sebelumnya yang mentransfer kepemilikan peran operator platform ke akun ini. Jika ini adalah operator platform pertama, kolom ini akan kosong.

ProofOfInclusion

Sertifikat penyertaan efek transaksi dalam status dunia.

Kolom
transaction_certificate

TransactionCertificate

Hanya output. Sertifikat pencantuman efek transaksi dalam putaran tertentu.
round_certificate

RoundCertificate

Hanya output. Sertifikat eksekusi putaran.
path_to_round_root[]

MerkleTreeNode

Hanya output. Bukti kriptografi penyertaan efek transaksi dalam putaran eksekusi.

Diberikan sebagai jalur dari leaf tertentu (ringkasan transaksi) ke root putaran eksekusi. Jalur ditampilkan sebagai daftar pasangan (turunan kiri, turunan kanan), dan pasangan pertama adalah turunan kiri dan kanan dari node induk daun yang diberikan. Misalnya, dengan asumsi pohon Merkle dibangun dengan delapan ringkasan leaf [t0, t1, t2, t3, t4, t5, t6, t7], yang memiliki struktur berikut:

       _____root_digest____
      |                    |
   __ h20__             __h21__
  |        |           |       |
 h10     h11          h12     h13
 | |     | |          | |     | |
t0 t1   t2 t3        t4 t5   t6 t7

Di sini, path_to_round_root untuk t0 akan berisi: [(t0, t1), (h10, h11), (h20, h21)].

Orang dapat menghitung digest SHA-256 dari setiap node jalur secara berurutan untuk memverifikasi bahwa digest jalur menghasilkan nilai yang sama dengan round_certificate.merkle_tree.root_digest_hex. Dengan demikian, memverifikasi bahwa leaf disertakan dalam pohon Merkle putaran.

MerkleTreeNode

Mewakili node dalam jalur pohon Merkle.

Kolom
left_child_hash_hex
(deprecated)

string

Hanya output. Representasi heksadesimal dari ringkasan turunan kiri node. Tidak digunakan lagi: Gunakan left_child_digest_hex sebagai gantinya.
right_child_hash_hex
(deprecated)

string

Hanya output. Representasi heksadesimal dari ringkasan turunan kanan node. Tidak digunakan lagi: Gunakan right_child_digest_hex sebagai gantinya.
left_child_digest_hex

string

Hanya output. Representasi heksadesimal dari ringkasan turunan kiri node. Format: String heksadesimal 64 karakter.
right_child_digest_hex

string

Hanya output. Representasi heksadesimal dari ringkasan turunan kanan node. Format: String heksadesimal 64 karakter.

QualifiedCurrencyValue

Mewakili mata uang di buku besar, yang memenuhi syarat oleh Operator Mata Uangnya.

Kolom
operator_id

string

Wajib. ID Operator Mata Uang yang mengelola mata uang.

QueryAccountRequest

Pesan permintaan untuk QueryAccount.

Kolom
endpoint

string

Wajib. Endpoint untuk melayani permintaan. Format: projects/{project}/locations/{location}/endpoints/{endpoint} Lokasinya adalah wilayah.
account_id

string

Wajib. ID akun untuk mendapatkan informasi tentangnya. Nilai dibatasi hingga 60 karakter.
round_id

int64

Opsional. ID putaran eksekusi (mirip dengan "tinggi" blok) tempat data akan diminta. Informasi akun yang ditampilkan akan akurat untuk status dunia pada putaran eksekusi ini. Jika tidak ditentukan, menggunakan putaran terakhir yang diselesaikan seperti yang diketahui oleh validator penayangan. Status pada ID putaran tertentu selalu konsisten dan kanonis.

QueryAccountResponse

Pesan respons untuk QueryAccount.

Kolom
account

Account

Informasi akun, beserta ketinggian saat informasi tersebut diperoleh.

QueryDataRequest

Pesan permintaan untuk QueryData.

Kolom
endpoint

string

Wajib. Endpoint untuk melayani permintaan. Format: projects/{project}/locations/{location}/endpoints/{endpoint} Lokasinya adalah wilayah.
serialized_signed_query_request

bytes

Wajib. SignedQueryRequest yang diserialisasi protobuf untuk mengkueri jaringan Universal Ledger.

QueryDataResponse

Pesan respons untuk QueryData.

Kolom
redacted_fields[]

RedactedField

Menunjukkan kolom mana yang telah disamarkan dari respons karena batasan izin.
Kolom union kind. Hasil khusus kueri. kind hanya ada berupa salah satu diantara berikut:
account

Account

Informasi akun, jika kueri ditujukan untuk akun.
transaction_state

TransactionState

Status transaksi, jika kueri adalah untuk transaksi.

QueryTransactionStateRequest

Pesan permintaan untuk QueryTransactionState.

Kolom
endpoint

string

Wajib. Endpoint untuk melayani permintaan. Format: projects/{project}/locations/{location}/endpoints/{endpoint} Lokasinya adalah wilayah.
transaction_digest_hex

string

Wajib. ID transaksi untuk mendapatkan status.

QueryTransactionStateResponse

Pesan respons untuk QueryTransactionState.

Kolom
transaction_attempts[]

TransactionAttempt

Satu entri per setiap pengiriman transaksi yang diketahui ke validator yang menangani permintaan.

RedactedField

Informasi tentang kolom yang disamarkan dalam respons.

Kolom
redacted_path

FieldMask

Hanya output. Jalur kolom yang sepenuhnya memenuhi syarat yang disamarkan dari payload.
reason

string

Hanya output. Penjelasan yang dapat dibaca manusia tentang alasan kolom disamarkan.
reason_code

Code

Hanya output. Kode yang dapat dibaca mesin untuk alasan kolom disamarkan.

RemoveRoles

Menghapus peran yang ditentukan dari akun. Pengirim harus berupa pengelola akun yang akan diubah.

Kolom
account
(deprecated)

Entity

Opsional. Tidak digunakan lagi: Gunakan account_id sebagai gantinya. ID akun yang akan diubah.
account_id

string

Opsional. ID akun yang akan diubah. Salah satu dari account atau account_id harus ditentukan. Nilai dibatasi hingga 60 karakter.
roles[]

Role

Wajib. Peran yang akan dihapus.

RemoveSigningPublicKey

Menghapus kunci penandatanganan akun dari slot yang ditentukan. Slot lainnya tidak boleh kosong, dan harus menyimpan kunci yang digunakan untuk menandatangani ClientTransaction.

Kolom
key_slot

KeySlot

Wajib. Slot kunci tempat kita menghapus kunci. Jika sudah kosong, transaksi akan gagal.

ReplaceSigningPublicKey

Mengganti kunci penandatanganan akun di slot yang ditentukan. Slot lainnya tidak boleh kosong, dan harus menyimpan kunci yang digunakan untuk menandatangani ClientTransaction.

Kolom
key_slot

KeySlot

Wajib. Slot kunci tempat kita mengganti kunci.
new_public_key

bytes

Wajib. Kunci publik baru, yang akan menggantikan kunci publik di slot yang ditentukan.

Format kunci publik ditentukan oleh kolom new_key_format. Dianggap sebagai informasi publik.
new_key_format

KeyFormat

Wajib. Format kunci dari kunci publik baru. Lihat definisi KeyFormat untuk mengetahui daftar format yang didukung. Dianggap sebagai informasi publik.

Peran

Kumpulan peran reguler.

Enum
ROLE_UNSPECIFIED Peran tidak valid.
ROLE_PAYER Peran yang memungkinkan akun memulai transaksi pembayaran.
ROLE_RECEIVER Peran yang memungkinkan akun menerima pembayaran.
ROLE_CONTRACT_CREATOR Peran yang memungkinkan akun men-deploy kontrak.
ROLE_CONTRACT_PARTICIPANT Peran yang memungkinkan akun berinteraksi dengan kontrak yang di-deploy.

RoundCertificate

Sertifikat eksekusi putaran oleh validator tertentu.

Kolom
round_id

int64

Hanya output. ID putaran yang sertifikatnya ditujukan.
validator_id

string

Hanya output. ID validator yang dapat dibaca manusia. Ini digunakan untuk mencari kunci publik yang akan digunakan untuk memverifikasi validator_signatures.
round_state_checksum_hex

string

Hanya output. Representasi heksadesimal dari ringkasan homomorfik atas status dunia setelah efek putaran ini diterapkan.
round_delta_checksum_hex

string

Hanya output. Representasi hex dari ringkasan homomorfik atas efek transaksi gabungan dari putaran ini.
merkle_tree

MerkleTree

Hanya output. Pohon Merkle yang memiliki putaran ini sebagai node root dan batch transaksi (dieksekusi dalam putaran) sebagai daun.
validator_signatures[]

bytes

Opsional. Tanda tangan validator. Ditandatangani melalui ringkasan payload sebelumnya dari catatan ini.
is_finalized

bool

Hanya output. Boolean untuk menunjukkan apakah putaran sudah selesai, yaitu apakah kuorum validator yang memadai telah mensertifikasi putaran ini dengan sertifikat yang sama.

SettlementMode

Mode penyelesaian transaksi untuk lembaga kliring.

Enum
SETTLEMENT_MODE_UNSPECIFIED Mode penyelesaian tidak ditentukan. Nilai ini tidak valid dan tidak boleh digunakan.
SETTLEMENT_MODE_DEFERRED Lembaga kliring bertanggung jawab untuk melacak kepemilikan dana di luar buku besar, dan secara berkala mengeluarkan transaksi SettlementRequest untuk menjaga agar saldo yang sesuai di buku besar tetap sinkron.
SETTLEMENT_MODE_INSTANT Lembaga kliring mengelola satu kumpulan dana dan buku besar bertindak sebagai sumber tepercaya untuk alokasi dana tersebut di antara pengelola token. Mode penyelesaian ini juga dapat dijelaskan sebagai "penyelesaian kotor instan".

SettlementRequest

Memulai operasi penyelesaian antara dua pengelola token. Pengirim harus berupa akun lembaga penayangan.

Dalam SettlementMode yang ditangguhkan, tempat lembaga kliring memiliki hak asuh atas dana pengelola token, ini adalah satu-satunya transaksi yang perlu dikirim untuk mengeksekusi penyelesaian antara dua pengelola token.

Kolom
payer
(deprecated)

Entity

Opsional. Tidak dapat diubah. Tidak digunakan lagi: Gunakan payer_id sebagai gantinya. ID akun pihak yang perlu melakukan transfer dana.
payer_id

string

Opsional. Tidak dapat diubah. ID akun pihak yang perlu melakukan transfer dana. Salah satu dari payer atau payer_id harus ditentukan.
beneficiary
(deprecated)

Entity

Opsional. Tidak dapat diubah. Tidak digunakan lagi: Gunakan beneficiary_id sebagai gantinya. ID akun pihak yang perlu dibayar.
beneficiary_id

string

Opsional. Tidak dapat diubah. ID akun pihak yang akan menerima dana. Salah satu dari beneficiary atau beneficiary_id harus ditentukan.
balance

CurrencyValue

Wajib. Tidak dapat diubah. Saldo token yang diterbitkan yang perlu ditransfer oleh akun payer ke akun beneficiary di buku besar.
round_id

int64

Wajib. Tidak dapat diubah. ID putaran saat jumlah penyelesaian ini dihitung.

SignedTransaction

Transaksi dengan tanda tangan terlampir. Untuk mengirimkan transaksi, pesan ini harus diserialisasi dan disertakan dalam SubmitTransactionRequest.

Kolom
serialized_client_transaction

bytes

Wajib. ClientTransaction yang diserialisasi dengan detail transaksi.
sender_signature

bytes

Wajib. Tanda tangan pengirim transaksi.

Tanda tangan harus dihitung dengan menandatangani byte serialized_client_transaction menggunakan kunci pribadinya sendiri.

Untuk rantai transaksi, byte yang akan ditandatangani dihitung sebagai penyambungan dari: - Ringkasan transaksi klien yang diserialisasi dari seluruh rantai. - Ringkasan transaksi bertanda tangan berserial dari setiap unit dalam rantai, dalam urutan kemunculannya dalam rantai. Ringkasan dihitung menggunakan SHA-256.
sender_signing_key_slot

KeySlot

Opsional. Slot kunci pengirim yang digunakan untuk menandatangani transaksi. Menggunakan slot utama akun pengirim jika tidak ditentukan.
other_signatures[]

bytes

Opsional. Tanda tangan akun yang tercantum sebagai penandatangan transaksi tambahan. Jumlah dan urutan tanda tangan ini harus sesuai dengan kolom signatories di ClientTransaction.

Byte yang akan ditandatangani sama dengan byte untuk sender_signature, yang harus ditandatangani oleh setiap penanda tangan dengan kunci pribadinya sendiri.

Jumlah dan identitas penandatangan tambahan bergantung pada jenis transaksi tertentu. Untuk rantai transaksi, satu tanda tangan diperlukan untuk setiap akun yang muncul sebagai pengirim atau penandatangan unit dalam rantai.
other_signing_key_slots[]

KeySlot

Opsional. Slot kunci akun yang tercantum sebagai penandatangan transaksi tambahan. Jika disetel, jumlah dan urutan slot kunci ini harus cocok dengan kolom other_signatures di SignedTransaction. Jika tidak ditentukan, defaultnya adalah slot utama setiap akun.

StatusEvent

Mewakili peristiwa dalam pemrosesan transaksi sebagaimana diamati oleh satu validator.

Semua nilai yang dilaporkan berasal dari perspektif validator yang menangani permintaan dan mungkin berbeda dari tampilan validator lainnya.

Kolom
event_time

Timestamp

Hanya output. Waktu saat peristiwa direkam oleh validator ini.
event_type

EventType

Hanya output. Jenis peristiwa.
event_details

EventDetails

Hanya output. Detail tambahan yang terkait dengan acara.

StringList

Daftar string.

Kolom
values[]

string

Opsional. Nilai string.

SubmitOperationalTransactionRequest

Pesan permintaan untuk SubmitOperationalTransaction.

Kolom
endpoint

string

Wajib. Endpoint untuk melayani permintaan. Format: projects/{project}/locations/{location}/endpoints/{endpoint} Lokasinya adalah wilayah.
serialized_signed_operational_transaction

bytes

Wajib. SignedTransaction yang diserialisasi protobuf untuk dikirimkan ke buku besar. Transaksi klien yang disertakan harus berupa transaksi operasional, dan pengirimnya harus berupa operator platform. Menggunakan format berserial memastikan bahwa semua validator menghitung ID transaksi yang sama sebagai ringkasan SHA-256 dari byte berserial.

SubmitOperationalTransactionResponse

Pesan respons untuk SubmitOperationalTransaction.

Kolom
transaction_digest_hex

string

ID yang secara unik merepresentasikan transaksi operasional yang dikirimkan. Nilai ini adalah representasi heksadesimal ringkasan SHA-256 dari serialized_signed_operational_transaction. ID transaksi ini diberikan 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.

SubmitTransactionRequest

Pesan permintaan untuk SubmitTransaction.

Kolom
endpoint

string

Wajib. Endpoint untuk mengirimkan transaksi. Format: projects/{project}/locations/{location}/endpoints/{endpoint} Lokasinya adalah wilayah.
serialized_signed_transaction

bytes

Wajib. SignedTransaction yang diserialisasi protobuf untuk dikirimkan ke buku besar. Menggunakan format berserial memastikan bahwa semua validator menghitung ID transaksi yang sama sebagai ringkasan SHA-256 dari byte berserial.

SubmitTransactionResponse

Pesan respons untuk SubmitTransaction.

Kolom
transaction_digest_hex

string

ID yang secara unik merepresentasikan transaksi yang dikirimkan. Nilai ini adalah representasi heksadesimal ringkasan SHA-256 dari serialized_signed_transaction. ID transaksi ini diberikan 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.

TokenManagerDetails

Detail khusus untuk Pengelola Token.

Kolom
issuance_limit

CurrencyValue

Hanya output. Jumlah token yang diizinkan untuk dibuat oleh pengelola token ini.
issued_tokens

CurrencyValue

Hanya output. Jumlah token yang dibuat oleh pengelola token ini. Jumlah ini akan bertambah saat mencetak dan berkurang saat menghapus.

TransactionAttempt

Status pengiriman transaksi yang dicoba.

Kolom
status

TransactionStatus

Hanya output. Status upaya transaksi saat ini.
proof_of_inclusion

ProofOfInclusion

Hanya output. Sertifikat penyertaan efek transaksi dalam status dunia. Hanya diberikan jika statusnya FINALIZED.
status_events[]

StatusEvent

Hanya output. Peristiwa status yang diurutkan dan dicatat untuk upaya transaksi.

TransactionStatus

Status upaya transaksi.

Enum
TRANSACTION_STATUS_UNSPECIFIED Status tidak diketahui atau belum diinisialisasi.
PENDING Transaksi diketahui oleh validator ini, tetapi belum diselesaikan.
FINALIZED Transaksi telah selesai. Efeknya telah dipertahankan di blockchain dan tidak dapat dibatalkan.

TransactionCertificate

Sertifikat pelaksanaan transaksi tertentu dalam putaran.

Kolom
transaction_digest_hex

string

Hanya output. ID transaksi yang menggunakan sertifikat ini.
round_id

int64

Hanya output. ID putaran eksekusi saat transaksi ini dieksekusi.
transaction_effects

TransactionEffects

Hanya output. Efek dari eksekusi transaksi.
events[]

TransactionEvent

Hanya output. Peristiwa yang dihasilkan oleh transaksi.
transaction_effects_state_checksum_hex

string

Hanya output. Checksum homomorfik efek. Nilai 2048 byte yang dienkode sebagai string heksadesimal.
certification_results_digest_hex

string

Hanya output. Ringkasan kriptografi dari semua kolom sebelumnya secara berurutan. Digunakan untuk membuat pohon Merkle untuk bukti penyertaan.

TransactionChain

Rantai transaksi yang mencakup beberapa unit transaksi untuk dieksekusi secara berurutan.

Unit akan dieksekusi secara berurutan, sesuai urutan yang tercantum. Jika semua unit berhasil, efek kumulatifnya akan diterapkan secara atomik ke status dunia. Jika salah satu di antaranya gagal, seluruh rangkaian akan gagal dan tidak ada efeknya yang akan diterapkan.

Kolom
units[]

bytes

Unit individual dalam jaringan. Setiap unit harus berupa SignedTransaction berseri.

Perhatikan bahwa byte berserial diperlukan untuk menentukan byte yang akan ditandatangani untuk rantai itu sendiri.

TransactionEffect

Mewakili pembaruan oleh beberapa transaksi ke status dunia.

Jika memiliki delta_val, nilai tersebut dianggap sebagai delta (offset bilangan bulat) yang diterapkan ke nilai yang disimpan sebelumnya pada kunci tertentu. Dalam hal ini, new_val dan old_val harus kosong.

Jika tidak, diasumsikan memiliki setidaknya salah satu dari old_val atau new_val (atau keduanya). old_val kosong menunjukkan bahwa nilai telah disisipkan. new_val kosong menunjukkan bahwa nilai telah dihapus.

Kolom
key

bytes

Hanya output. Kunci dalam status dunia yang diperbarui.
old_val

bytes

Hanya output. Nilai kunci sebelum transaksi dieksekusi.
new_val

bytes

Hanya output. Nilai kunci setelah transaksi dieksekusi.
delta_val

int64

Hanya output. Offset bilangan bulat yang diterapkan ke nilai yang disimpan sebelumnya.

TransactionEffects

Efek pelaksanaan transaksi.

Kolom
status

TransactionStatus

Hanya output. Status eksekusi transaksi yang dihasilkan.
effects[]
(deprecated)

TransactionEffect

Hanya output. Tidak digunakan lagi: Kueri status jaringan untuk menentukan perubahan apa pun pada status dunia. Efek transaksi dalam status dunia.

TransactionEvent

Peristiwa yang dihasilkan oleh transaksi.

Kolom
type

string

Hanya output. Jenis peristiwa. Acara khusus berjenis transaction_output berisi output yang dihasilkan oleh transaksi—misalnya, ID akun dari akun yang baru dibuat.
attributes[]

EventAttribute

Hanya output. Atribut peristiwa sebagai pasangan nilai kunci arbitrer.

EventAttribute

Atribut individual sebagai pasangan nilai kunci.

Kolom
key

string

Hanya output. Kunci atribut.
value

string

Hanya output. Nilai atribut.

TransactionState

Status transaksi.

Kolom
transaction_attempts[]

TransactionAttempt

Satu entri per setiap pengiriman transaksi yang diketahui ke validator yang menangani permintaan.

TransactionStatus

Menampilkan status eksekusi transaksi.

Kolom
code

int32

Hanya output. Kode status, nilai numerik yang artinya ditentukan oleh kode status gRPC yang sesuai.
message

bytes

Hanya output. Pesan error, jika ada. Ditetapkan hanya jika kode bukan OK. Ini adalah string yang dienkode sebagai byte UTF-8. Disimpan sebagai byte untuk mencegah masalah apa pun terkait determinisme encoding.

Transfer

Mentransfer token dari satu akun pengguna ke akun pengguna lain. Pengirim harus berupa akun pengguna biasa, bukan akun istimewa seperti pengelola token atau pengelola akun.

Selain itu, pengirim transaksi harus mengaktifkan ROLE_PAYER, sedangkan penerima harus mengaktifkan ROLE_RECEIVER.

Kolom
beneficiary
(deprecated)

Entity

Opsional. Tidak digunakan lagi: Gunakan beneficiary_id sebagai gantinya. Akun yang menerima token.
beneficiary_id

string

Opsional. ID akun yang menerima token. Salah satu dari beneficiary atau beneficiary_id harus ditentukan.
amount

CurrencyValue

Wajib. Jumlah yang akan ditransfer. Jumlah harus positif.

TransferContractTokenManager

Mentransfer kepemilikan pengelola token kontrak ke akun baru. Pengirim harus merupakan operator mata uang saat ini untuk mata uang tersebut.

Jika transaksi berhasil, akan menonaktifkan pengelola token kontrak saat ini untuk mata uang, dan ID akun yang baru dibuat akan ditampilkan sebagai peristiwa dalam TransactionCertificate transaksi yang telah diselesaikan.

Kolom
public_key

bytes

Wajib. Kunci publik pengelola token kontrak baru. Perhatikan bahwa ini bukan kunci publik operator. Ini adalah kunci publik pengelola token kontrak baru dan akan disimpan di buku besar. Akun ini akan digunakan untuk memvalidasi tanda tangan transaksi yang berasal dari akun pengelola token kontrak.

Format kunci publik ditentukan oleh kolom key_format. Dianggap sebagai informasi publik.
account_comment

string

Opsional. Tidak dapat diubah. Kolom komentar buram yang tidak ditafsirkan oleh sistem, tetapi disimpan di buku besar dalam akun. Dianggap sebagai informasi publik. Panjang maksimum adalah 128 karakter. Dapat dibiarkan kosong. Setelah dibuat, kolom tidak dapat diubah.
key_format

KeyFormat

Opsional. Tidak dapat diubah. Format kunci dari kunci publik. Jika tidak ditentukan, defaultnya adalah keyset yang diserialisasi biner dalam format kabel Tink. Dianggap sebagai informasi publik.

TransferCurrencyOperator

Mentransfer kepemilikan operator mata uang tertentu ke akun baru. Pengirim harus berupa operator platform.

Jika transaksi berhasil, operator mata uang yang diberikan akan dinonaktifkan, dan ID akun yang baru dibuat akan ditampilkan sebagai peristiwa dalam TransactionCertificate transaksi yang telah diselesaikan.

Kolom
public_key

bytes

Wajib. Kunci publik operator mata uang baru. Kunci publik ini akan dikaitkan dengan operator mata uang dan disimpan di buku besar. Kunci ini akan digunakan untuk memvalidasi tanda tangan transaksi yang berasal dari akun operator mata uang.

Format kunci publik ditentukan oleh kolom key_format. Dianggap sebagai informasi publik.
key_format

KeyFormat

Opsional. Tidak dapat diubah. Format kunci dari kunci publik. Jika tidak ditentukan, defaultnya adalah keyset yang diserialisasi biner dalam format kabel Tink. Dianggap sebagai informasi publik.
account_comment

string

Opsional. Tidak dapat diubah. Kolom komentar buram yang tidak ditafsirkan oleh sistem, tetapi disimpan di buku besar dalam akun. Dianggap sebagai informasi publik. Panjang maksimum adalah 128 karakter. Dapat dibiarkan kosong. Setelah dibuat, kolom tidak dapat diubah.
currency_operator
(deprecated)

Entity

Opsional. Tidak digunakan lagi: Gunakan currency_operator_id sebagai gantinya. Operator mata uang yang akan diganti. Harus aktif.
currency_operator_id

string

Opsional. ID operator mata uang yang akan diganti. Harus aktif. Salah satu dari currency_operator atau currency_operator_id harus ditentukan. Nilai dibatasi hingga 60 karakter.

TransferPlatformOperator

Mentransfer kepemilikan operator platform ke akun baru. Pengirim harus merupakan operator platform saat ini.

Jika transaksi berhasil, operator platform saat ini akan dinonaktifkan, dan ID akun yang baru dibuat akan ditampilkan sebagai peristiwa dalam TransactionCertificate transaksi yang telah diselesaikan.

Kolom
public_key

bytes

Wajib. Kunci publik operator platform baru. Kunci publik ini akan dikaitkan dengan operator platform dan disimpan di buku besar. Kunci ini akan digunakan untuk memvalidasi tanda tangan transaksi yang berasal dari akun operator platform.

Format kunci publik ditentukan oleh kolom key_format. Dianggap sebagai informasi publik.
key_format

KeyFormat

Opsional. Tidak dapat diubah. Format kunci dari kunci publik. Jika tidak ditentukan, defaultnya adalah keyset yang diserialisasi biner dalam format kabel Tink. Dianggap sebagai informasi publik.
account_comment

string

Opsional. Tidak dapat diubah. Kolom komentar buram yang tidak ditafsirkan oleh sistem, tetapi disimpan di buku besar dalam akun. Dianggap sebagai informasi publik. Panjang maksimum adalah 128 karakter. Dapat dibiarkan kosong. Setelah dibuat, kolom tidak dapat diubah.

UserDetails

Detail khusus untuk Akun pengguna.

Kolom
account_manager
(deprecated)

Entity

Hanya output. Tidak digunakan lagi: Gunakan account_manager_id sebagai gantinya. Pengelola akun untuk pengguna ini.
account_manager_id

string

Hanya output. ID pengelola akun untuk pengguna ini.
token_manager
(deprecated)

Entity

Hanya output. Tidak digunakan lagi: Gunakan token_manager_id sebagai gantinya. Pengelola token untuk pengguna ini.
token_manager_id

string

Hanya output. ID pengelola token untuk pengguna ini.
roles[]

Role

Hanya output. Daftar peran yang diberikan ke akun ini.
account_status

AccountStatus

Hanya output. Status akun ini.
balance

CurrencyValue

Hanya output. Saldo token akun pengguna ini.
account_fields
(deprecated)

map<string, Fields>

Hanya output. Tidak digunakan lagi: Gunakan contract_account_fields sebagai gantinya. Kolom akun kontrak (ID kontrak -> kolom) untuk pengguna ini.
contract_account_fields

map<string, Fields>

Hanya output. Kolom akun kontrak (ID kontrak -> kolom) untuk pengguna ini.

Nilai

Nilai konkret dari beberapa jenis.

Kolom
Kolom union value. Nilai sebenarnya. value hanya ada berupa salah satu diantara berikut:
none_value

NoneValue

Opsional. Mewakili nilai None.
bool_value

bool

Opsional. Nilai boolean.
int64_value

int64

Opsional. Nilai int64.
string_value

string

Opsional. Nilai string.
account_id

string

Opsional. ID akun.
dict_value

DictValue

Opsional. Nilai kamus.
qualified_currency_value

QualifiedCurrencyValue

Opsional. Nilai mata uang yang memenuhi syarat.
amount_value

AmountValue

Opsional. Nilai jumlah.