Venta al por mayor Referencia de despliegue de CBDC

La siguiente información incluye descripciones de los objetos de base de datos que crea el script ORDS y consejos para la resolución de problemas.

El script ORDS crea las siguientes vistas operativas mediante el parámetro VIEW_PREFIX configurado.

<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 selecciona análisis, se crean las siguientes vistas de análisis, dentro del ámbito del despliegue.

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

El script también crea o configura el módulo ORDS, las rutas, el alias de esquema, el rol, el privilegio, el cliente OAuth y la asociación de rol de cliente mediante los valores configurados.

Ver catálogo y lógica de consulta

Las siguientes vistas son vistas ordinarias de Oracle en el esquema seleccionado; no modifican las tablas del extractor.

Ver	Origen Primario	Finalidad/Lógica
<VIEW_PREFIX>_ACCOUNTS_V	_more, _store_state	Crea el directorio de la cuenta actual a partir de las llamadas createAccount y el estado de cuenta/token. Resuelve la identidad de la cuenta, el usuario y la organización, los saldos, los saldos de retención, el estado, los límites diarios, los metadatos de token y los metadatos de transacción de creación.
<VIEW_PREFIX>_TRANSFER_EVENTS_V	_more	Normaliza los logs de recepción de token en filas de evento de transferencia. Extrae metadatos de remitente, receptor, cantidad, función, bloque/transacción y contexto opcional ~OBPRPCTX~.value.category.
<VIEW_PREFIX>_HOLDS_V	_store_hist, _more, _store_state	Reconstruye los registros de menta, quema y transferencia. Extrae el ID de operación/retención, las cuentas, el notario, el importe, la caducidad, el token, la categoría, la descripción y el último estado del ciclo de vida. También proporciona filas de reserva cuando una fila de estado actual no se puede resolver.
<VIEW_PREFIX>_ACTIVE_ROLES_V	_more	Aplica el historial de agregación/eliminación de roles y devuelve la última asignación de roles activa por cuenta y rol.
<VIEW_PREFIX>_ACCOUNT_TX_HISTORY_V	Las vistas operativas anteriores	Produce filas de historial de transacciones orientadas a la cuenta, incluidas las dos caras de las transferencias y los resultados normalizados del ciclo de vida de la menta, la quema y la retención. Enriquece las identidades desde/hacia desde la vista _ACCOUNTS_V.
<VIEW_PREFIX>_ACCOUNT_HISTORY_V	_more, _ACCOUNTS_V	Genera el historial de configuración de cuentas a partir de las mutaciones de contratos de cuentas, incluidas las revisiones diarias de límites, los registros de hora, los números de bloque y los ID de transacción.
<VIEW_PREFIX>_ACCOUNTS_MOD (análisis opcional)	_ACCOUNTS_V	Expone los metadatos de la cuenta en la unidad de cuenta compatible con análisis.
<VIEW_PREFIX>_TRANSACTION_MOD (análisis opcional)	_TRANSFER_EVENTS_V, _HOLDS_V, _store_hist	Expone las transacciones de negocio normalizadas, incluidos los saldos de transferencia, menta, consumo, solicitud, retención, liberación y resultantes cuando están disponibles.
<VIEW_PREFIX>_ACCOUNTS_TRANSACTION_MOD (análisis opcional)	_TRANSACTION_MOD, _ACCOUNTS_V	Agrega el contexto de la organización de origen y destino a los registros de transacciones de análisis.

Rutas ORDS

Todas las rutas son rutas GET en <BASE_PATH>/ y necesitan un token de portador de OAuth. ORDS devuelve un sobre de recopilación; una matriz items vacía con HTTP 200 significa que la solicitud era válida pero no tenía registros indexados coincidentes.

Ruta	Uso y comportamiento de respuesta	Entradas necesarias	Entradas opcionales y comportamiento predeterminado
getCBDCTransactionById	Devuelve un registro de detalle de transacción-contabilidad normalizada.	token_id identifica el token WCBDC; transaction_id es el hash/identificador de transacción de Besu que se va a recuperar.	Ninguno. Ninguna transacción coincidente devuelve una recopilación vacía.
getCBDCAccountTransactionHistoryWithFilters	Devuelve el historial de la cuenta identificada por su identidad de negocio.	token_id identifica el token; org_id identifica la organización; user_id identifica el usuario de la cuenta.	startTime y endTime restringen el rango de tiempo; omitido significa que no hay límite de tiempo inferior/superior. bookmark es el desplazamiento basado en cero; omitido significa 0. pageSize es el número de filas solicitadas; omitido utiliza el valor por defecto del manejador.
getAllCBDCAccountTransactionHistoryWithFilters	Devuelve el historial de transacciones de toda la cuenta del token.	token_id identifica el token.	startTime, endTime, bookmark y pageSize se comportan como para la ruta de historial específica de la cuenta.
getCBDCAccountStatusHistory	Devuelve filas indexadas de historial de estado para una cuenta de negocio.	token_id, org_id y user_id identifican la cuenta.	Ninguno. No hay ninguna cuenta/historial coincidente que devuelva una recopilación vacía.
getApproverActionHistory	Devuelve las decisiones de menta/quema y las acciones finales de retención de transferencia. Se ejecuta executeHold; se rechaza releaseHold.	token_id limita los resultados al token.	caller_account_id es la dirección de cartera del gestor/aprobador. Omitirlo para devolver acciones de todos los actores; proporcionarlo para devolver solo las acciones de esa cartera. Es un filtro de ámbito de datos, no una autorización.
getTokenHistory	Devuelve el historial de nivel de token y la información relacionada con el suministro.	token_id identifica el token.	Ninguno.
getCBDCAccountsByRole	Devuelve las cuentas asociadas con un rol.	role es el nombre del rol que se va a confrontar.	Ninguno; el resultado no está filtrado por token por esta ruta.
getUsersByRole	Devuelve las asignaciones de rol de usuario/cuenta para un rol.	role es el nombre del rol que se va a confrontar.	Ninguno.
getOrgAccountsByRole	Devuelve las cuentas de una organización que tienen un rol	org_id identifica la organización; role es el nombre del rol.	Ninguno.
getAllCBDCAccounts	Devuelve todas las cuentas indexadas para un token.	token_id identifica el token.	Ninguno.
getAllActiveCBDCAccounts	Devuelve las cuentas indexadas cuyo estado actual es Activo.	token_id identifica el token.	Ninguno.
getAllSuspendedCBDCAccounts	Devuelve las cuentas indexadas cuyo estado actual es suspendido.	token_id identifica el token.	Ninguno.
getAllOrgAccounts	Devuelve todas las cuentas indexadas de una organización.	org_id identifica la organización.	Ninguno; el resultado no está filtrado por token por esta ruta.
getPendingCBDCIssuance	Devuelve solo las operaciones de transferencia pendientes actuales; se excluyen las operaciones de terminal, ejecutadas, rechazadas y liberadas.	token_id identifica el token.	caller_account_id es la cartera de notario/gestor. Omitirla para la cola pendiente completa; proporcionarla para devolver solo las retenciones asignadas a esa cartera.
getPendingCBDCRequest	Devuelve solo las solicitudes de menta/quemadura pendientes actuales.	token_id identifica el token; request_type selecciona el tipo de solicitud soportado, como mint o burn.	Ninguno. Se excluyen las solicitudes aprobadas o rechazadas.
getPendingRequest	Vía de compatibilidad para el mismo caso de uso de solicitud pendiente.	token_id y request_type tienen el mismo significado que getPendingCBDCRequest	Ninguno.
getCBDCAccountsByUser	Devuelve registros de cuenta para una combinación de organización/usuario/token.	token_id, org_id y user_id identifican el propietario y el token de la cuenta.	Ninguno.
getCBDCAccountHistory	Devuelve las revisiones del historial/configuración de la cuenta.	account_address es la dirección de cartera/cuenta de blockchain.	offset es el desplazamiento de fila basado en cero; omita la primera página. limit es el recuento máximo de filas; omita el uso del manejador SQL por defecto.
getCBDCAccountStatus	Devuelve el estado de la cuenta indexada actual.	token_id, org_id y user_id identifican la cuenta.	Ninguno.
getRolesByAccount	Devuelve roles para una cuenta resuelta.	token_id siempre es necesario. Proporcione account_address (la dirección de cartera/cuenta de blockchain) o la consulta de negocio combinada org_id y user_id.	Si se proporciona account_address, es el filtro de cuenta directa; de lo contrario, la ruta utiliza org_id y user_id. Si ninguna consulta resuelve una cuenta, la respuesta está vacía.
getAllRegisteredOrgs	Devuelve organizaciones representadas por cuentas indexadas para un token.	token_id identifica el token.	Ninguno.
getCBDCMetadata	Devuelve metadatos de token inmutables indexados.	token_id identifica el token.	Ninguno.
getCBDCRetiredQuantity	Devuelve información de cantidad dada de baja/quemada para un token.	token_id identifica el token.	Ninguno.

Paginación y registros de hora: para las dos rutas de historial que soportan los parámetros bookmark y pageSize, el parámetro bookmark es un desplazamiento de fila basado en cero y el parámetro pageSize es mayúsculas/minúsculas. Omita cualquiera de los valores para utilizar el valor por defecto del manejador. Los parámetros startTime y endTime, cuando se proporcionan, utilizan el texto de registro de hora ISO-8601 con el formato YYYY-MM-DDTHH:MI:SS+/-HH:MI.

Inventario de punto final: el inventario de ruta exacto pertenece a la versión de script empaquetada para el despliegue. Después de la ejecución, utilice el catálogo ORDS OpenAPI o la salida de punto final generada como lista autorizada para la aplicación cliente.

Solución de problemas

Mensaje o condición	Resolución
NJS-516: no configuration directory set	Se ha utilizado un alias TNS sin un directorio de configuración/cartera accesible. Extraiga la cartera y configure el cliente de Oracle para que el archivo tnsnames.ora esté disponible.
NJS-511 o ORA-12506	Problema de configuración de listener, punto final, nombre de servicio, lista de permitidos de red o cartera. Valide la conexión de Oracle fuera del script con el DBA.
La solicitud de token de OAuth devuelve 404	Verifique el alias exacto en /ords/<ALIAS_NAME>/oauth/token. El alias no es necesariamente el nombre de usuario de Oracle.
El punto final devuelve 401	Obtenga un token nuevo y verifique que el cliente de OAuth tenga el rol/privilegio asociado a la ruta base del módulo configurado.
El punto final devuelve 404	Verifique el host, el alias, la ruta base, el nombre de la ruta y que el módulo está publicado.
ORDS-25001	El punto final ha alcanzado ORDS, pero su SQL ha fallado. Verifique el prefijo de tabla, las direcciones de contrato, la unidad de datos de origen y los parámetros de solicitud necesarios.
ORA-20049: Cannot alter the URL mapping while the schema is enabled	El ALIAS_NAME seleccionado entra en conflicto con una asignación de esquema activada. Vuelva a utilizar el alias existente del esquema o haga que el administrador de ORDS complete el procedimiento de desactivación, reasignación y activación aprobado antes de volver a ejecutar el script.
Las vistas no contienen filas	Confirme que se ha seleccionado el perfil de historial enriquecido correcto durante la creación de la instancia, que el prefijo de tabla es exacto, que las direcciones de contrato coinciden con los proxies desplegados y que las transacciones se han indexado.
Los objetos entran en conflicto con otro despliegue	Utilice un VIEW_PREFIX distinto, un nombre de módulo, una ruta base, un rol, un privilegio, un nombre de cliente de OAuth y un alias.