Riferimento distribuzione token deposito

Di seguito sono riportate le descrizioni degli oggetti di database creati dallo script ORDS e i suggerimenti per la risoluzione dei problemi.

Lo script ORDS crea le viste operative riportate di seguito utilizzando il parametro VIEW_PREFIX configurato.

<VIEW_PREFIX>_ACCOUNTS_V
<VIEW_PREFIX>_TRANSFER_EVENTS_V
<VIEW_PREFIX>_HOLDS_V
<VIEW_PREFIX>_ACTIVE_ROLES_V
<VIEW_PREFIX>_ACCOUNT_TX_HISTORY_V
<VIEW_PREFIX>_ACCOUNT_HISTORY_V

Se si seleziona Analytics, vengono create le viste di analitica riportate di seguito, con ambito per la distribuzione.

<VIEW_PREFIX>_ACCOUNTS_MOD
<VIEW_PREFIX>_TRANSACTION_MOD
<VIEW_PREFIX>_ACCOUNTS_TRANSACTION_MOD

Lo script inoltre crea o configura l'associazione modulo, instradamenti, alias di schema, ruolo, privilegio, client OAuth e ruolo client ORDS utilizzando i valori configurati.

Visualizza logica catalogo e query

Le viste seguenti sono viste Oracle ordinarie nello schema selezionato e non modificano le tabelle di estrazione.

Visualizza	Origine primaria	Scopo/logica
<VIEW_PREFIX>_ACCOUNTS_V	_more, _store_state	Genera la directory dell'account corrente dalle chiamate createAccount e dallo stato account/token. Risolve l'identità dell'account, dell'utente e dell'organizzazione, i saldi, i saldi di blocco, lo stato, i limiti giornalieri, i metadati dei token e i metadati delle transazioni di creazione.
<VIEW_PREFIX>_TRANSFER_EVENTS_V	_more	Normalizza i log delle ricevute dei token nelle righe degli eventi di trasferimento. Estrae i metadati di mittente, destinatario, importo, funzione, blocco/transazione e contesto ~OBPRPCTX~.value.category facoltativo.
<VIEW_PREFIX>_HOLDS_V	_store_hist, _more, _store_state	Ricostruisce i record di menta, masterizzazione e trasferimento. Estrae l'ID operazione/contenuta, i conti, il notaio, l'importo, la scadenza, il token, la categoria, la descrizione e lo stato del ciclo di vita più recente. Fornisce inoltre righe di fallback quando una riga dello stato corrente non è risolvibile.
<VIEW_PREFIX>_ACTIVE_ROLES_V	_more	Applica la cronologia di aggiunta/rimozione dei ruoli e restituisce l'assegnazione dei ruoli attivi più recente per account e ruolo.
<VIEW_PREFIX>_ACCOUNT_TX_HISTORY_V	Le viste operative precedenti	Produce righe relative alla cronologia delle transazioni per conto, inclusi entrambi i lati dei trasferimenti e risultati del ciclo di vita mint/burn/hold normalizzati. Arricchisce le identità da/a dalla vista _ACCOUNTS_V.
<VIEW_PREFIX>_ACCOUNT_HISTORY_V	_more, _ACCOUNTS_V	Genera la cronologia della configurazione dell'account dalle mutazioni dei contratti account, incluse le revisioni dei limiti giornalieri, gli indicatori orari, i numeri di blocco e gli ID transazione.
<VIEW_PREFIX>_ACCOUNTS_MOD (analitica facoltativa)	_ACCOUNTS_V	Mostra i metadati del conto nella forma del conto compatibile con l'analitica.
<VIEW_PREFIX>_TRANSACTION_MOD (analitica facoltativa)	_TRANSFER_EVENTS_V, _HOLDS_V, _store_hist	Espone transazioni aziendali normalizzate, tra cui trasferimento, menta, masterizzazione, richiesta, blocco, rilascio e saldi risultanti, ove disponibili.
<VIEW_PREFIX>_ACCOUNTS_TRANSACTION_MOD (analitica facoltativa)	_TRANSACTION_MOD, _ACCOUNTS_V	Aggiunge il contesto dell'organizzazione di origine e di destinazione ai record delle transazioni di analitica.

Instradamenti ORDS

Tutti gli instradamenti sono GET in <BASE_PATH>/ e richiedono un token OAuth bearer. ORDS restituisce un involucro di raccolta. Un array items vuoto con HTTP 200 indica che la richiesta era valida ma non disponeva di record indicizzati corrispondenti.

Instradamento	Funzionamento uso e risposta	Input richiesti	Input facoltativi e comportamento predefinito
getDepositTokenTransactionById	Restituisce un record dettagli libro contabile-transazione normalizzato.	token_id identifica il token; transaction_id identifica la transazione Besu.	Nessuna. Nessuna corrispondenza restituisce una raccolta vuota.
getDepositTokenAccountTransactionHistory	Restituisce la cronologia dell'account risolto dall'identità aziendale.	token_id, org_id e user_id identificano l'account.	startTime e endTime limitano l'intervallo di tempo; omettere per nessun limite. Il valore predefinito di bookmark è 0. Il valore predefinito dell'handler è pageSize.
getAllDepositTokenAccountTransactionHistory	Restituisce la cronologia delle transazioni del conto a livello di token.	token_id identifica il token.	startTime, endTime, bookmark e pageSize si comportano come per l'instradamento cronologia specifico dell'account.
getDepositTokenAccountStatusHistory	Restituisce le righe stato-cronologia indicizzate per un conto aziendale.	token_id, org_id e user_id identificano l'account.	Nessuna.
getDepositTokenApproverActionHistory	Restituisce le decisioni di manager/approvatore e le azioni finali dei blocchi di trasferimento.	token_id identifica il token.	caller_account_id è il wallet dell'attore; omettere per tutti gli attori o fornire l'ambito a un wallet.
getDepositTokenHistory	Restituisce la cronologia a livello di token e le informazioni relative alla fornitura.	token_id identifica il token.	Nessuna.
getDepositTokenAccountsByRole	Restituisce i conti associati a un ruolo.	role è il nome del ruolo che deve corrispondere.	Nessuna.
getDepositTokenUsersByRole	Restituisce le assegnazioni di ruoli utente/account per un ruolo.	role è il nome del ruolo che deve corrispondere.	Nessuna.
getDepositTokenOrganizationAccountsByRole	Restituisce i conti organizzazione con ruolo	org_id identifica l'organizzazione; role è il nome del ruolo.	Nessuna.
getAllDepositTokenAccounts	Restituisce tutti i conti indicizzati per un token.	token_id identifica il token.	Nessuna.
getAllActiveDepositTokenAccounts	Restituisce i conti il cui stato indicizzato corrente è attivo.	token_id identifica il token.	Nessuna.
getAllSuspendedDepositTokenAccounts	Restituisce i conti il cui stato indicizzato corrente è sospeso.	token_id identifica il token.	Nessuna.
getDepositTokenOrganizationAccounts	Restituisce tutti i conti indicizzati in un'organizzazione.	org_id identifica l'organizzazione.	Nessuna.
getPendingDepositTokenIssuance	Restituisce solo le operazioni di trasferimento in sospeso correnti.	token_id identifica il token.	caller_account_id è il wallet notary/manager. Ometti per la coda completa; fornisci l'ambito a quel wallet. Le operazioni terminali sono escluse.
getPendingDepositTokenRequest	Restituisce solo le richieste mint/burn/transfer in sospeso.	token_id identifica il token; request_type seleziona il tipo di richiesta supportato.	Nessuna. Vengono restituite solo le operazioni il cui ultimo evento del ciclo di vita rimane in sospeso.
getPendingRequest	Percorso compatibilità richiesta in sospeso.	token_id e request_type hanno lo stesso significato di getPendingDepositTokenRequest	Nessuna.
getDepositTokenAccountsByUser	Restituisce i record di conto per una combinazione organizzazione/utente/token.	token_id, org_id e user_id identificano il proprietario e il token dell'account.	Nessuna.
getDepositTokenAccountHistory	Restituisce le revisioni di configurazione/cronologia del conto.	account_address è l'indirizzo dell'account/wallet blockchain.	offset è un offset basato su zero; limit limita le righe. Ometti per il valore predefinito dell'handler.
getDepositTokenAccountStatus	Restituisce lo stato del conto indicizzato corrente.	token_id, org_id e user_id identificano l'account.	Nessuna.
getDepositTokenRolesByAccount	Restituisce i ruoli per un conto risolto.	token_id è sempre obbligatorio. Fornire account_address o org_id e user_id.	Se viene fornito account_address, si tratta della ricerca diretta, altrimenti viene utilizzata la ricerca dell'organizzazione o dell'utente.
getAllDepositTokenOrganizations	Restituisce le organizzazioni rappresentate da conti indicizzati per un token.	token_id identifica il token.	Nessuna.
getDepositTokenMetadata	Restituisce i metadati di token immutabili indicizzati.	token_id identifica il token.	Nessuna.
getDepositTokenRetiredQuantity	Restituisce le informazioni sulla quantità ritirata/bruciata per un token.	token_id identifica il token.	Nessuna.
getDepositTokenAccountPolicies	Restituisce i record correnti di criteri conto.	Nessuna.	account_policy_id seleziona un criterio. account_address filtra per account. Omettere entrambi per elencare tutti. Il valore predefinito bookmark è 0; il valore predefinito pageSize è 20.
getDepositTokenAccountPolicyHistory	Restituisce le revisioni dei criteri conto.	Nessuna.	Revisioni filtro account_policy_id e account_address; omettere entrambe per elencare tutto. Il valore predefinito di bookmark è 0; il valore predefinito di pageSize è 20.
getDepositTokenApprovalPolicies	Restituisce i record correnti dei criteri di approvazione.	Nessuna.	approval_policy_id seleziona un criterio e lo omette per elencare tutti. Il valore predefinito bookmark è 0; il valore predefinito pageSize è 20.
getDepositTokenApprovalPolicyHistory	Restituisce le revisioni dei criteri di approvazione.	Nessuna.	approval_policy_id filtra le revisioni, omette di elencarle tutte. Il valore predefinito di bookmark è 0; il valore predefinito di pageSize è 20.
getPendingDepositTokenApprovalOperations	Restituisce le operazioni correnti in attesa di approvazione.	Nessuna.	token_id e operation_id sono filtri facoltativi. Omettere operation_id per elencare tutte le operazioni in sospeso correnti. Il valore predefinito di bookmark è 0; il valore predefinito di pageSize è 20.
getDepositTokenApprovalsByApprover	Restituisce le decisioni di approvazione/rifiuto di un approvatore.	approver_address è l'indirizzo del wallet dell'approvatore.	operation_id limita i risultati a un'unica operazione; omettere per tutte le decisioni dell'approvatore. Il valore predefinito di bookmark è 0; il valore predefinito di pageSize è 20.
getDepositTokenApprovalsByOperationId	Restituisce gli eventi di approvazione/rifiuto per un'operazione.	operation_id identifica l'operazione di approvazione.	Il valore predefinito di bookmark è 0; il valore predefinito di pageSize è 20.
getDepositTokenApprovalStatusByOperationId	Restituisce lo stato del flusso di lavoro memorizzato e la risoluzione corrente dei criteri attivi.	token_id e operation_id identificano il flusso di lavoro.	Nessuna. Non genera stati sintetici BLOCKED o AWAITING_MANAGER_COMPLETION.

Impaginazione e indicatori orari: il parametro bookmark è un offset di riga basato su zero e il parametro pageSize fa distinzione tra maiuscole e minuscole. Per i percorsi della cronologia, startTime e endTime utilizzano il testo dell'indicatore orario ISO-8601 nel formato YYYY-MM-DDTHH:MI:SS+/-HH:MI.

Inventario degli endpoint: l'inventario di instradamento esatto appartiene alla versione dello script inclusa nel package per la distribuzione. Dopo l'esecuzione, utilizzare il catalogo ORDS OpenAPI o l'output dell'endpoint generato come lista affidabile per l'applicazione client.

Risoluzione dei problemi

Messaggio o condizione	Risoluzione
NJS-516: no configuration directory set	È stato utilizzato un alias TNS senza una directory di wallet/configurazione accessibile. Estrarre il wallet e configurare il client Oracle in modo che il file tnsnames.ora sia disponibile.
NJS-511 o ORA-12506	Problema di configurazione del listener, dell'endpoint, del nome del servizio, della lista di inclusione di rete o del wallet. Convalidare la connessione Oracle al di fuori dello script con il DBA.
La richiesta di token OAuth restituisce 404	Verificare l'alias esatto in /ords/<ALIAS_NAME>/oauth/token. L'alias non è necessariamente il nome utente Oracle.
L'endpoint restituisce 401	Ottenere un nuovo token e verificare che al client OAuth sia associato il ruolo o il privilegio con il percorso di base del modulo configurato.
L'endpoint restituisce 404	Verificare host, alias, percorso di base, nome instradamento e che il modulo sia pubblicato.
ORDS-25001	L'endpoint ha raggiunto ORDS, ma l'istruzione SQL relativa non è riuscita. Verificare il prefisso della tabella, gli indirizzi del contratto, la forma dei dati di origine e i parametri di richiesta obbligatori.
ORA-20049: Cannot alter the URL mapping while the schema is enabled	Il file ALIAS_NAME scelto è in conflitto con un mapping di schema abilitato. Riutilizzare l'alias esistente dello schema oppure chiedere all'amministratore ORDS di completare la procedura di disabilitazione/rimappatura/abilitazione approvata prima di eseguire di nuovo lo script.
Le viste non contengono righe	Verificare che durante la creazione dell'istanza sia stato selezionato il profilo rich history corretto, che il prefisso della tabella sia esatto, che gli indirizzi del contratto corrispondano ai proxy distribuiti e che le transazioni siano state indicizzate.
Oggetti in conflitto con un'altra distribuzione	Utilizzare un VIEW_PREFIX distinto, nome del modulo, percorso di base, ruolo, privilegio, nome client OAuth e alias.