Référence de déploiement de jeton de dépôt

Les informations suivantes incluent des descriptions des objets de base de données créés par le script ORDS et des conseils de résolution des incidents.

Le script ORDS crée les vues opérationnelles suivantes à l'aide du paramètre VIEW_PREFIX configuré.

<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

Si vous sélectionnez des analyses, les vues d'analyse suivantes sont créées et ciblées sur le déploiement.

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

Le script crée ou configure également le module ORDS, les routes, l'alias de schéma, le rôle, le privilège, le client OAuth et l'association client-rôle à l'aide des valeurs configurées.

Afficher la logique de catalogue et de requête

Les vues suivantes sont des vues Oracle ordinaires du schéma sélectionné. Elles ne modifient pas les tables d'extraction.

Voir	Source primaire	Objectif/Logique
<VIEW_PREFIX>_ACCOUNTS_V	_more, _store_state	Crée le répertoire de compte actuel à partir des appels createAccount et de l'état de compte/jeton. Il résout les identités de compte, d'utilisateur et d'organisation, les soldes, les soldes de blocage, le statut, les limites quotidiennes, les métadonnées de jeton et les métadonnées de transaction de création.
<VIEW_PREFIX>_TRANSFER_EVENTS_V	_more	Normalise les journaux de réception de jeton dans les lignes d'événement de transfert. Il extrait les métadonnées d'expéditeur, de destinataire, de montant, de fonction, de bloc/transaction et le contexte ~OBPRPCTX~.value.category facultatif.
<VIEW_PREFIX>_HOLDS_V	_store_hist, _more, _store_state	Reconstruit les enregistrements de menthe, de brûlure et de transfert. Il extrait l'ID opération/de retenue, les comptes, le notaire, le montant, l'expiration, le jeton, la catégorie, la description et le dernier statut du cycle de vie. Il fournit également des lignes de secours lorsqu'une ligne d'état en cours ne peut pas être résolue.
<VIEW_PREFIX>_ACTIVE_ROLES_V	_more	Applique l'historique d'ajout/de suppression de rôle et renvoie la dernière affectation de rôle active par compte et rôle.
<VIEW_PREFIX>_ACCOUNT_TX_HISTORY_V	Les vues opérationnelles précédentes	Génère des lignes d'historique des transactions orientées compte, y compris les deux côtés des transferts et les résultats normalisés du cycle de vie ment/brûlure/bloqué. Il enrichit les identités à partir de/vers la vue _ACCOUNTS_V.
<VIEW_PREFIX>_ACCOUNT_HISTORY_V	_more, _ACCOUNTS_V	Génère l'historique de configuration des comptes à partir des mutations des contrats de compte, y compris les révisions quotidiennes des limites, les horodatages, les numéros de bloc et les ID de transaction.
<VIEW_PREFIX>_ACCOUNTS_MOD (analyse facultative)	_ACCOUNTS_V	Affiche les métadonnées de compte dans la forme de compte compatible avec les analyses.
<VIEW_PREFIX>_TRANSACTION_MOD (analyse facultative)	_TRANSFER_EVENTS_V, _HOLDS_V, _store_hist	Présente les transactions commerciales normalisées, notamment les soldes de transfert, de menthe, d'épuisement, de demande, de blocage, de déblocage et les soldes résultants, le cas échéant.
<VIEW_PREFIX>_ACCOUNTS_TRANSACTION_MOD (analyse facultative)	_TRANSACTION_MOD, _ACCOUNTS_V	Ajoute le contexte de l'organisation source et de destination aux enregistrements de transaction d'analyse.

Itinéraires ORDS

Toutes les routes sont des routes GET sous <BASE_PATH>/ et nécessitent un jeton de support OAuth. ORDS renvoie une enveloppe de collection ; un tableau items vide avec HTTP 200 signifie que la demande était valide mais ne comportait aucun enregistrement indexé correspondant.

Itinéraire	Utilisation et comportement des réponses	Entrées obligatoires	Entrées facultatives et comportement par défaut
getDepositTokenTransactionById	Renvoie un enregistrement de détail de transaction de livre normalisé.	token_id identifie le jeton ; transaction_id identifie la transaction Besu.	Aucun. Aucune correspondance ne renvoie une collection vide.
getDepositTokenAccountTransactionHistory	Renvoie l'historique du compte résolu par l'identité professionnelle.	token_id, org_id et user_id identifient le compte.	startTime et endTime limitent la période ; omettez l'une ou l'autre pour ne pas définir de limite. La valeur par défaut de bookmark est 0. pageSize utilise la valeur par défaut du gestionnaire.
getAllDepositTokenAccountTransactionHistory	Renvoie l'historique des transactions de compte à l'échelle du jeton.	token_id identifie le jeton.	startTime, endTime, bookmark et pageSize se comportent comme pour le routage d'historique propre au compte.
getDepositTokenAccountStatusHistory	Renvoie les lignes d'historique de statut indexées pour un compte professionnel.	token_id, org_id et user_id identifient le compte.	Aucun.
getDepositTokenApproverActionHistory	Renvoie les décisions du responsable/de l'approbateur et les actions finales de blocage du transfert.	token_id identifie le jeton.	caller_account_id est le portefeuille d'acteur ; omettez-le pour tous les acteurs ou indiquez-le dans la portée d'un portefeuille.
getDepositTokenHistory	Renvoie l'historique au niveau du jeton et les informations relatives à l'approvisionnement.	token_id identifie le jeton.	Aucun.
getDepositTokenAccountsByRole	Renvoie les comptes associés à un rôle.	role est le nom du rôle à mettre en correspondance.	Aucun.
getDepositTokenUsersByRole	Renvoie les affectations de rôle utilisateur/compte pour un rôle.	role est le nom du rôle à mettre en correspondance.	Aucun.
getDepositTokenOrganizationAccountsByRole	Renvoie les comptes d'organisation ayant un rôle	org_id identifie l'organisation ; role est le nom du rôle.	Aucun.
getAllDepositTokenAccounts	Renvoie tous les comptes indexés pour un jeton.	token_id identifie le jeton.	Aucun.
getAllActiveDepositTokenAccounts	Renvoie les comptes dont le statut indexé actuel est actif.	token_id identifie le jeton.	Aucun.
getAllSuspendedDepositTokenAccounts	Renvoie les comptes dont le statut indexé actuel est suspendu.	token_id identifie le jeton.	Aucun.
getDepositTokenOrganizationAccounts	Renvoie tous les comptes indexés dans une organisation.	org_id identifie l'organisation.	Aucun.
getPendingDepositTokenIssuance	Renvoie les opérations de blocage de transfert en attente uniquement.	token_id identifie le jeton.	caller_account_id est le portefeuille notaire/gestionnaire. Omettre pour la file d'attente complète ; fournir la portée de ce portefeuille. Les opérations terminales sont exclues.
getPendingDepositTokenRequest	Renvoie uniquement les demandes de transfert/brûlure/mint en attente.	token_id identifie le jeton. request_type sélectionne le type de demande pris en charge.	Aucun. Seules les opérations dont le dernier événement de cycle de vie reste en attente sont renvoyées.
getPendingRequest	Routage de demande en attente de compatibilité.	token_id et request_type ont la même signification que getPendingDepositTokenRequest	Aucun.
getDepositTokenAccountsByUser	Renvoie les enregistrements de compte pour une combinaison organisation/utilisateur/jeton.	token_id, org_id et user_id identifient le propriétaire et le jeton du compte.	Aucun.
getDepositTokenAccountHistory	Renvoie la configuration du compte/les révisions de l'historique.	account_address est l'adresse du portefeuille/du compte de chaîne de blocs.	offset est un décalage basé sur zéro ; limit limite les lignes. Omettez l'un ou l'autre pour le gestionnaire par défaut.
getDepositTokenAccountStatus	Renvoie le statut actuel du compte indexé.	token_id, org_id et user_id identifient le compte.	Aucun.
getDepositTokenRolesByAccount	Renvoie les rôles d'un compte résolu.	token_id est toujours requis. Fournissez account_address ou org_id et user_id.	Si account_address est fourni, il s'agit de la recherche directe ; sinon, la recherche d'organisation/d'utilisateur est utilisée.
getAllDepositTokenOrganizations	Renvoie les organisations représentées par des comptes indexés pour un jeton.	token_id identifie le jeton.	Aucun.
getDepositTokenMetadata	Renvoie les métadonnées de jeton non mutables indexées.	token_id identifie le jeton.	Aucun.
getDepositTokenRetiredQuantity	Renvoie les informations sur la quantité sortie/brûlée pour un jeton.	token_id identifie le jeton.	Aucun.
getDepositTokenAccountPolicies	Renvoie les enregistrements de stratégie de compte en cours.	Aucun.	account_policy_id sélectionne une stratégie ; account_address filtre par compte. Omettez les deux pour répertorier tous les éléments. bookmark est défini par défaut sur 0 ; pageSize est défini par défaut sur 20.
getDepositTokenAccountPolicyHistory	Renvoie les révisions de la politique du compte.	Aucun.	Les révisions de filtre account_policy_id et account_address ; omettez les deux pour répertorier tous les éléments. bookmark est défini par défaut sur 0 ; pageSize est défini par défaut sur 20.
getDepositTokenApprovalPolicies	Renvoie les enregistrements de stratégie d'approbation en cours.	Aucun.	approval_policy_id sélectionne une stratégie ; ignorez-la pour répertorier toutes les stratégies. bookmark prend par défaut la valeur 0 ; pageSize prend par défaut la valeur 20.
getDepositTokenApprovalPolicyHistory	Renvoie les révisions de la politique d'approbation.	Aucun.	approval_policy_id filtre les révisions ; omettez-les pour répertorier toutes les révisions. bookmark prend par défaut la valeur 0 ; pageSize prend par défaut la valeur 20.
getPendingDepositTokenApprovalOperations	Renvoie les opérations en cours en attente d'approbation.	Aucun.	token_id et operation_id sont des filtres facultatifs. Omettez operation_id pour répertorier toutes les opérations en attente en cours. bookmark prend par défaut la valeur 0 ; pageSize prend par défaut la valeur 20.
getDepositTokenApprovalsByApprover	Renvoie les décisions d'approbation/de rejet par un approbateur.	approver_address est l'adresse du portefeuille de l'approbateur.	operation_id réduit les résultats à une opération ; omet toutes les décisions de cet approbateur. bookmark prend par défaut la valeur 0 ; pageSize prend par défaut la valeur 20.
getDepositTokenApprovalsByOperationId	Renvoie les événements d'approbation/de rejet pour une opération.	operation_id identifie l'opération d'approbation.	bookmark est défini par défaut sur 0 ; pageSize est défini par défaut sur 20.
getDepositTokenApprovalStatusByOperationId	Renvoie le statut de workflow stocké plus la résolution active-stratégie actuelle.	token_id et operation_id identifient le workflow/le blocage.	Aucun. Il ne génère pas de statuts BLOCKED ou AWAITING_MANAGER_COMPLETION synthétiques.

Pagination et horodatages : le paramètre bookmark est un décalage de ligne basé sur zéro et le paramètre pageSize est sensible à la casse. Pour les routages d'historique, startTime et endTime utilisent le texte d'horodatage ISO-8601 au format YYYY-MM-DDTHH:MI:SS+/-HH:MI.

Inventaire des adresses : l'inventaire exact des routages appartient à la version de script packagée pour le déploiement. Après l'exécution, utilisez le catalogue OpenAPI ORDS ou la sortie d'adresse générée comme liste faisant autorité pour l'application client.

Dépannage

Message ou condition	Résolution
NJS-516: no configuration directory set	Un alias TNS a été utilisé sans répertoire de portefeuille/configuration accessible. Extrayez le portefeuille et configurez le client Oracle de sorte que le fichier tnsnames.ora soit disponible.
NJS-511 ou ORA-12506	Problème de configuration de processus d'écoute, d'adresse, de nom de service, de liste d'autorisation réseau ou de portefeuille. Validez la connexion Oracle en dehors du script avec le DBA.
La demande de jeton OAuth renvoie 404	Vérifiez l'alias exact dans /ords/<ALIAS_NAME>/oauth/token. L'alias n'est pas nécessairement le nom utilisateur Oracle.
L'adresse renvoie 401	Obtenez un nouveau jeton et vérifiez que le client OAuth dispose du rôle/privilège associé au chemin de base du module configuré.
L'adresse renvoie 404	Vérifiez l'hôte, l'alias, le chemin de base, le nom de la route et que le module est publié.
ORDS-25001	L'adresse a atteint ORDS mais son instruction SQL a échoué. Vérifiez le préfixe de table, les adresses de contrat, la forme des données source et les paramètres de demande requis.
ORA-20049: Cannot alter the URL mapping while the schema is enabled	Le paramètre ALIAS_NAME choisi est en conflit avec un mapping de schéma activé. Réutilisez l'alias existant du schéma ou demandez à l'administrateur ORDS de terminer la procédure de désactivation/réparation/activation approuvée avant d'exécuter à nouveau le script.
Les vues ne contiennent aucune ligne	Vérifiez que le profil d'historique enrichi correct a été sélectionné lors de la création de l'instance, que le préfixe de table est exact, que les adresses de contrat correspondent aux proxies déployés et que les transactions ont été indexées.
Les objets sont en conflit avec un autre déploiement	Utilisez un élément VIEW_PREFIX, un nom de module, un chemin de base, un rôle, un privilège, un nom de client OAuth et un alias distincts.