Deployment-Referenz für Einzahlungstoken

Die folgenden Informationen enthalten Beschreibungen der Datenbankobjekte, die vom ORDS-Skript erstellt werden, sowie Tipps zur Fehlerbehebung.

Das ORDS-Skript erstellt die folgenden Betriebsansichten mit dem konfigurierten Parameter VIEW_PREFIX.

<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

Wenn Sie "Analysen" auswählen, werden die folgenden Analyseansichten für das Deployment erstellt.

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

Das Skript erstellt oder konfiguriert außerdem die ORDS-Modul-, Routen-, Schemaalias-, Rollen-, Berechtigungs-, OAuth-Client- und Clientrollenzuordnung mit den konfigurierten Werten.

Katalog- und Abfragelogik anzeigen

Die folgenden Views sind normale Oracle-Views im ausgewählten Schema. Sie ändern die Extrakttabellen nicht.

Anzeigen	Primäre Quelle	Zweck/Logik
<VIEW_PREFIX>_ACCOUNTS_V	_more, _store_state	Erstellt das aktuelle Accountverzeichnis aus createAccount-Aufrufen und Account-/Tokenstatus. Es löst Konto-, Benutzer- und Organisationsidentität, Salden, Salden, Status, Tageslimits, Token-Metadaten und Metadaten für Erstellungstransaktionen auf.
<VIEW_PREFIX>_TRANSFER_EVENTS_V	_more	Normalisiert Token-Empfangslogs in Übertragungsereigniszeilen. Es extrahiert Absender-, Empfänger-, Betrags-, Funktions-, Block-/Transaktionsmetadaten und optionalen ~OBPRPCTX~.value.category-Kontext.
<VIEW_PREFIX>_HOLDS_V	_store_hist, _more, _store_state	Rekonstruiert Minz-, Brand- und Transfer-Hold-Datensätze. Es extrahiert Vorgangs-/Einbehaltungs-ID, Konten, Notar, Betrag, Ablauf, Token, Kategorie, Beschreibung und den letzten Lebenszyklusstatus. Außerdem werden Fallback-Zeilen bereitgestellt, wenn eine aktuelle Statuszeile nicht aufgelöst werden kann.
<VIEW_PREFIX>_ACTIVE_ROLES_V	_more	Wendet die Historie zum Hinzufügen/Entfernen von Rollen an und gibt die letzte aktive Rollenzuweisung pro Firma und Rolle zurück.
<VIEW_PREFIX>_ACCOUNT_TX_HISTORY_V	Die vorhergehenden Betriebsansichten	Erstellt kontobasierte Transaktionshistorienzeilen, einschließlich beider Seiten von Transfers und normalisierter mint/burn/hold-Lebenszyklusresultate. Sie bereichert aus/zu Identitäten aus der Ansicht _ACCOUNTS_V.
<VIEW_PREFIX>_ACCOUNT_HISTORY_V	_more, _ACCOUNTS_V	Erstellt die Kontokonfigurationshistorie aus Kontokontraktmutationen, einschließlich täglicher Limitrevisionen, Zeitstempeln, Blocknummern und Transaktions-IDs.
<VIEW_PREFIX>_ACCOUNTS_MOD (optionale Analysen)	_ACCOUNTS_V	Zeigt Accountmetadaten in der mit Analysen kompatiblen Accountausprägung an.
<VIEW_PREFIX>_TRANSACTION_MOD (optionale Analysen)	_TRANSFER_EVENTS_V, _HOLDS_V, _store_hist	Stellt normalisierte Geschäftstransaktionen bereit, einschließlich Transfer-, Mint-, Burn-, Request-, Hold-, Freigabe- und resultierenden Salden, sofern verfügbar.
<VIEW_PREFIX>_ACCOUNTS_TRANSACTION_MOD (optionale Analysen)	_TRANSACTION_MOD, _ACCOUNTS_V	Fügt Quell- und Zielorganisationskontext zu Analysetransaktionsdatensätzen hinzu.

ORDS-Routen

Alle Routen sind GET-Routen unter <BASE_PATH>/ und erfordern ein OAuth-Bearer-Token. ORDS gibt einen Collection-Envelope zurück. Ein leeres items-Array mit HTTP 200 bedeutet, dass die Anforderung gültig war, aber keine übereinstimmenden indizierten Datensätze hatte.

Route	Nutzungs- und Antwortverhalten	Erforderliche Eingaben	Optionale Eingaben und Standardverhalten
getDepositTokenTransactionById	Gibt einen normalisierten Detaildatensatz für die Buchtransaktion zurück.	token_id gibt das Token an. transaction_id gibt die Besu-Transaktion an.	Keine. Keine Übereinstimmung gibt eine leere Sammlung zurück.
getDepositTokenAccountTransactionHistory	Gibt die Historie für den Account zurück, der nach Geschäftsidentität aufgelöst wurde.	token_id, org_id und user_id geben den Account an.	startTime und endTime schränken den Zeitraum ein. Lassen Sie entweder keinen Grenzwert aus. bookmark ist standardmäßig 0. pageSize verwendet den Handlerstandard.
getAllDepositTokenAccountTransactionHistory	Gibt die tokenweite Kontotransaktionshistorie zurück.	token_id identifiziert das Token.	startTime, endTime, bookmark und pageSize verhalten sich wie für die kontospezifische Historienroute.
getDepositTokenAccountStatusHistory	Gibt indizierte Statushistorienzeilen für ein Geschäftskonto zurück.	token_id, org_id und user_id geben den Account an.	Keine.
getDepositTokenApproverActionHistory	Gibt Manager/Genehmiger-Entscheidungen und endgültige Zurückstellungsaktionen zurück.	token_id identifiziert das Token.	caller_account_id ist das Akteur-Wallet. Lassen Sie es für alle Akteure weg, oder geben Sie es für ein Wallet an.
getDepositTokenHistory	Gibt die Historie auf Tokenebene und lieferantenbezogene Informationen zurück.	token_id identifiziert das Token.	Keine.
getDepositTokenAccountsByRole	Gibt Accounts zurück, die einer Rolle zugeordnet sind.	role ist der zuzuordnende Rollenname.	Keine.
getDepositTokenUsersByRole	Gibt Benutzer-/Accountrollenzuweisungen für eine Rolle zurück.	role ist der zuzuordnende Rollenname.	Keine.
getDepositTokenOrganizationAccountsByRole	Gibt Organisationskonten mit einer Rolle zurück	org_id gibt die Organisation an; role ist der Rollenname.	Keine.
getAllDepositTokenAccounts	Gibt alle indexierten Konten für ein Token zurück.	token_id identifiziert das Token.	Keine.
getAllActiveDepositTokenAccounts	Gibt Konten mit dem aktuellen indizierten Status "Aktiv" zurück.	token_id identifiziert das Token.	Keine.
getAllSuspendedDepositTokenAccounts	Gibt Konten zurück, deren aktueller indizierter Status ausgesetzt ist.	token_id identifiziert das Token.	Keine.
getDepositTokenOrganizationAccounts	Gibt alle indexierten Konten in einer Organisation zurück.	org_id gibt die Organisation an.	Keine.
getPendingDepositTokenIssuance	Gibt nur aktuelle ausstehende Transfersperrenvorgänge zurück.	token_id identifiziert das Token.	caller_account_id ist das Notar-/Manager-Wallet. Für die vollständige Warteschlange auslassen. Geben Sie den Geltungsbereich für dieses Wallet an. Terminalvorgänge sind ausgeschlossen.
getPendingDepositTokenRequest	Gibt nur ausstehende Anforderungen für Mint/Verbrennung/Transfer zurück.	token_id identifiziert das Token. request_type wählt den unterstützten Anforderungstyp aus.	Keine. Es werden nur Vorgänge zurückgegeben, deren letztes Lebenszyklusereignis ausstehend bleibt.
getPendingRequest	Weiterleitung der ausstehenden Anforderung für Kompatibilität.	token_id und request_type haben dieselbe Bedeutung wie getPendingDepositTokenRequest	Keine.
getDepositTokenAccountsByUser	Gibt Firmendatensätze für eine Kombination aus Organisation/Benutzer/Token zurück.	token_id, org_id und user_id geben den Accounteigentümer und das Token an.	Keine.
getDepositTokenAccountHistory	Gibt Kontokonfigurations-/Historienrevisionen zurück.	account_address ist die Blockchain-Konto-/Walletadresse.	offset ist ein nullbasierter Offset. limit begrenzt Zeilen. Lassen Sie eine der beiden Optionen für den Handler-Standardwert aus.
getDepositTokenAccountStatus	Gibt den aktuellen indizierten Kontostatus zurück.	token_id, org_id und user_id geben den Account an.	Keine.
getDepositTokenRolesByAccount	Gibt Rollen für einen gelösten Account zurück.	token_id ist immer erforderlich. Geben Sie entweder account_address oder org_id und user_id an.	Wenn account_address angegeben wird, handelt es sich um den direkten Lookup. Andernfalls wird der Organisations-/Benutzersuche verwendet.
getAllDepositTokenOrganizations	Gibt Organisationen zurück, die durch indexierte Accounts für ein Token dargestellt werden.	token_id identifiziert das Token.	Keine.
getDepositTokenMetadata	Gibt indizierte unveränderliche Tokenmetadaten zurück.	token_id identifiziert das Token.	Keine.
getDepositTokenRetiredQuantity	Gibt Informationen zur stillgelegten/verbrannten Menge für ein Token zurück.	token_id identifiziert das Token.	Keine.
getDepositTokenAccountPolicies	Gibt aktuelle Account-Policy-Datensätze zurück.	Keine.	account_policy_id wählt eine Policy aus. account_address filtert nach Account. Lassen Sie beide aus, um alle aufzulisten. bookmark ist standardmäßig 0. pageSize ist standardmäßig 20.
getDepositTokenAccountPolicyHistory	Gibt Revisionen der Kontopolitik zurück.	Keine.	account_policy_id- und account_address-Filterrevisionen. Lassen Sie beide aus, um alle aufzulisten. bookmark ist standardmäßig 0, pageSize ist standardmäßig 20.
getDepositTokenApprovalPolicies	Gibt aktuelle Genehmigungs-Policy-Datensätze zurück.	Keine.	approval_policy_id wählt eine Policy aus. Weglassen Sie sie, um alle aufzulisten. bookmark ist standardmäßig 0, pageSize ist standardmäßig 20.
getDepositTokenApprovalPolicyHistory	Gibt Revisionen der Genehmigungs-Policy zurück.	Keine.	approval_policy_id filtert Revisionen. Weglassen Sie sie, um alle aufzulisten. bookmark ist standardmäßig 0, pageSize ist standardmäßig 20.
getPendingDepositTokenApprovalOperations	Gibt aktuelle Vorgänge zurück, die auf Genehmigung warten.	Keine.	token_id und operation_id sind optionale Filter. Lassen Sie operation_id aus, um alle aktuellen ausstehenden Vorgänge aufzulisten. bookmark ist standardmäßig 0, pageSize ist standardmäßig 20.
getDepositTokenApprovalsByApprover	Gibt Genehmigungs-/Ablehnungsentscheidungen eines Genehmigers zurück.	approver_address ist die Wallet-Adresse des Genehmigers.	operation_id schränkt die Ergebnisse auf einen Vorgang ein. Weglassen Sie alle Entscheidungen dieses Genehmigers. bookmark ist standardmäßig 0, pageSize ist standardmäßig 20.
getDepositTokenApprovalsByOperationId	Gibt Genehmigungs-/Ablehnungsereignisse für einen Vorgang zurück.	operation_id gibt den Genehmigungsvorgang an.	bookmark ist standardmäßig 0; pageSize ist standardmäßig 20.
getDepositTokenApprovalStatusByOperationId	Gibt den gespeicherten Workflowstatus plus die aktuelle Auflösung der aktiven Policy zurück.	token_id und operation_id geben den Workflow/die Sperre an.	Keine. Es werden keine synthetischen BLOCKED- oder AWAITING_MANAGER_COMPLETION-Status generiert.

Paginierung und Zeitstempel: Der Parameter bookmark ist ein nullbasierter Zeilenoffset, und der Parameter pageSize beachtet die Groß-/Kleinschreibung. Für Historienrouten verwenden startTime und endTime den Zeitstempeltext ISO-8601 im Format YYYY-MM-DDTHH:MI:SS+/-HH:MI.

Endpunktbestand: Der genaue Routenbestand gehört zur Skriptversion, die für das Deployment verpackt ist. Verwenden Sie nach der Ausführung den ORDS OpenAPI-Katalog oder die generierte Endpunktausgabe als autoritative Liste für die Clientanwendung.

Fehlerbehebung

Meldung oder Bedingung	Lösung
NJS-516: no configuration directory set	Ein TNS-Alias wurde ohne zugängliches Wallet-/Konfigurationsverzeichnis verwendet. Extrahieren Sie das Wallet, und konfigurieren Sie den Oracle-Client so, dass die Datei tnsnames.ora verfügbar ist.
NJS-511 oder ORA-12506	Listener, Endpunkt, Servicename, Netzwerkausnahmeliste oder Wallet-Konfigurationsproblem. Validieren Sie die Oracle-Verbindung außerhalb des Skripts mit dem DBA.
OAuth-Tokenanforderung gibt 404 zurück	Prüfen Sie den genauen Alias in /ords/<ALIAS_NAME>/oauth/token. Der Alias ist nicht unbedingt der Oracle-Benutzername.
Endpunkt gibt 401 zurück	Rufen Sie ein neues Token ab, und prüfen Sie, ob dem OAuth-Client die Rolle/Berechtigung zugewiesen ist, die mit dem konfigurierten Modulbasispfad verknüpft ist.
Endpunkt gibt 404 zurück	Prüfen Sie Host, Alias, Basispfad, Routenname und die Veröffentlichung des Moduls.
ORDS-25001	Der Endpunkt hat ORDS erreicht, seine SQL ist jedoch nicht erfolgreich. Prüfen Sie das Tabellenpräfix, die Vertragsadressen, die Quelldatenausprägung und die erforderlichen Anforderungsparameter.
ORA-20049: Cannot alter the URL mapping while the schema is enabled	Die ausgewählte ALIAS_NAME steht in Konflikt mit einer aktivierten Schemazuordnung. Verwenden Sie den vorhandenen Alias des Schemas erneut, oder lassen Sie den ORDS-Administrator die genehmigte Prozedur zum Deaktivieren/Entfernen/Aktivieren abschließen, bevor Sie das Skript erneut ausführen.
Ansichten enthalten keine Zeilen	Bestätigen Sie, dass während der Instanzerstellung das richtige Rich-History-Profil ausgewählt wurde, das Tabellenpräfix genau ist, Vertragsadressen mit den bereitgestellten Proxys übereinstimmen und Transaktionen indiziert wurden.
Objekte stehen in Konflikt mit einem anderen Deployment	Verwenden Sie eine eindeutige VIEW_PREFIX, einen Modulnamen, einen Basispfad, eine Rolle, eine Berechtigung, einen OAuth-Clientnamen und einen Alias.