存款令牌部署参考
以下信息包括对 ORDS 脚本创建的数据库对象的描述以及故障排除提示。
ORDS 脚本使用配置的 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如果选择“Analytics（分析）”，将创建以下分析视图，并限定为部署。
<VIEW_PREFIX>_ACCOUNTS_MOD
<VIEW_PREFIX>_TRANSACTION_MOD
<VIEW_PREFIX>_ACCOUNTS_TRANSACTION_MOD该脚本还使用配置的值创建或配置 ORDS 模块、路由、方案别名、角色、权限、OAuth 客户端和客户端 - 角色关联。
查看目录和查询逻辑
以下视图是所选方案中的普通 Oracle 视图；它们不修改提取器表。
| 查看 | 主资源 | 目的/逻辑 |
|---|---|---|
<VIEW_PREFIX>_ACCOUNTS_V |
_more, _store_state |
基于 createAccount 调用和帐户/令牌状态构建当前帐户目录。它解析账户、用户和组织身份、余额、暂挂余额、状态、每日限额、令牌元数据和创建事务处理元数据。
|
<VIEW_PREFIX>_TRANSFER_EVENTS_V |
_more |
将令牌接收日志规范化为传输事件行。它提取发送者、接收者、金额、函数、块/事务处理元数据以及可选的 ~OBPRPCTX~.value.category 上下文。
|
<VIEW_PREFIX>_HOLDS_V |
_store_hist, _more, _store_state |
重新构建薄荷、燃烧和转移暂挂记录。它提取操作/持有 ID、账户、公证人、金额、到期、令牌、类别、说明和最新生命周期状态。当当前状态行不可解析时，它还会提供回退行。 |
<VIEW_PREFIX>_ACTIVE_ROLES_V |
_more |
应用角色添加/删除历史记录，并返回每个客户和角色的最新有效角色分配。 |
<VIEW_PREFIX>_ACCOUNT_TX_HISTORY_V |
前面的操作视图 | 生成面向账户的交易历史记录行，包括传输双方以及规范化的薄荷/消耗/暂挂生命周期结果。它从 _ACCOUNTS_V 视图扩充起始/终止身份。
|
<VIEW_PREFIX>_ACCOUNT_HISTORY_V |
_more, _ACCOUNTS_V |
从账户合同变化生成账户配置历史记录，包括每日限额修订、时间戳、块号和事务处理 ID。 |
<VIEW_PREFIX>_ACCOUNTS_MOD（可选分析）
|
_ACCOUNTS_V |
在与分析兼容的账户配置中公开账户元数据。 |
<VIEW_PREFIX>_TRANSACTION_MOD（可选分析）
|
_TRANSFER_EVENTS_V, _HOLDS_V, _store_hist |
公开规范化的业务事务处理，包括转移、铸币、消耗、请求、暂挂、释放和产生的余额（如果可用）。 |
<VIEW_PREFIX>_ACCOUNTS_TRANSACTION_MOD（可选分析）
|
_TRANSACTION_MOD, _ACCOUNTS_V |
将来源和目标组织上下文添加到分析事务处理记录。 |
ORDS 路线
所有路由都是 <BASE_PATH>/ 下的 GET 路由，需要 OAuth 持有人令牌。ORDS 返回集合信封；具有 HTTP 200 的空 items 数组表示请求有效，但没有匹配的索引记录。
| 路由 | 使用和响应行为 | 必需输入 | 可选输入和默认行为 |
|---|---|---|---|
getDepositTokenTransactionById |
返回一个规范化的分类账事务处理详细信息记录。 | token_id 标识令牌；transaction_id 标识 Besu 事务处理。
|
无。没有匹配项返回空集合。 |
getDepositTokenAccountTransactionHistory |
返回按业务标识解析的帐户的历史记录。 | token_id、org_id 和 user_id 标识帐户。
|
startTime 和 endTime 限制时间范围；对于无边界，省略其中之一。bookmark 缺省为 0。pageSize 使用处理程序缺省值。
|
getAllDepositTokenAccountTransactionHistory |
返回令牌范围的账户事务处理历史记录。 | token_id 标识标记。
|
startTime、endTime、bookmark 和 pageSize 的行为与特定于账户的历史记录路由相同。
|
getDepositTokenAccountStatusHistory |
返回业务帐户的索引状态历史记录行。 | token_id、org_id 和 user_id 标识帐户。
|
无。 |
getDepositTokenApproverActionHistory |
返回经理/审批人决策和最终抵免操作。 | token_id 标识标记。
|
caller_account_id 是角色 wallet；忽略所有角色或将其提供给一个 wallet 的范围。
|
getDepositTokenHistory |
返回令牌级历史记录和供应相关信息。 | token_id 标识标记。
|
无。 |
getDepositTokenAccountsByRole |
返回与角色关联的客户。 | role 是要匹配的角色名称。
|
无。 |
getDepositTokenUsersByRole |
返回角色的用户/账户角色分配。 | role 是要匹配的角色名称。
|
无。 |
getDepositTokenOrganizationAccountsByRole |
返回具有角色的组织帐户 | org_id 标识组织；role 是角色名称。
|
无。 |
getAllDepositTokenAccounts |
返回一个令牌的所有索引帐户。 | token_id 标识标记。
|
无。 |
getAllActiveDepositTokenAccounts |
返回当前索引状态为“有效”的帐户。 | token_id 标识标记。
|
无。 |
getAllSuspendedDepositTokenAccounts |
返回其当前索引状态为挂起的帐户。 | token_id 标识标记。
|
无。 |
getDepositTokenOrganizationAccounts |
返回一个组织中的所有索引帐户。 | org_id 标识组织。
|
无。 |
getPendingDepositTokenIssuance |
仅返回当前待定转移暂挂操作。 | token_id 标识标记。
|
caller_account_id 是公证人/经理 wallet。省略整个队列；提供该 wallet 的范围。终端操作被排除。
|
getPendingDepositTokenRequest |
仅返回待处理的 mint/burn/transfer 请求。 | token_id 标识标记；request_type 选择支持的请求类型。
|
无。仅返回其最新生命周期事件保持待定状态的操作。 |
getPendingRequest |
兼容性暂挂请求路由。 | token_id 和 request_type 具有与 getPendingDepositTokenRequest 相同的含义 |
无。 |
getDepositTokenAccountsByUser |
返回一个组织/用户/令牌组合的账户记录。 | token_id、org_id 和 user_id 标识帐户所有者和令牌。
|
无。 |
getDepositTokenAccountHistory |
返回帐户配置/历史记录修订。 | account_address 是区块链账户/钱包地址。
|
offset 是基于零的偏移量；limit 为行设置上限。对于处理程序缺省值，省略其中任何一个。
|
getDepositTokenAccountStatus |
返回当前索引帐户状态。 | token_id、org_id 和 user_id 标识帐户。
|
无。 |
getDepositTokenRolesByAccount |
返回已解析帐户的角色。 | token_id 始终是必需的。提供 account_address 或 org_id 和 user_id。
|
如果提供了 account_address，则它是直接查找；否则将使用组织/用户查找。
|
getAllDepositTokenOrganizations |
返回由令牌的索引帐户表示的组织。 | token_id 标识标记。
|
无。 |
getDepositTokenMetadata |
返回索引不可变标记元数据。 | token_id 标识标记。
|
无。 |
getDepositTokenRetiredQuantity |
返回令牌的报废/消耗数量信息。 | token_id 标识标记。
|
无。 |
getDepositTokenAccountPolicies |
返回当前账户策略记录。 | 无。 | account_policy_id 选择一个策略；account_address 按帐户筛选。同时省略以列出所有项。bookmark 默认为 0；pageSize 默认为 20。
|
getDepositTokenAccountPolicyHistory |
返回帐户策略修订。 | 无。 | account_policy_id 和 account_address 过滤器修订；省略这两个选项以列出全部内容。bookmark 缺省为 0；pageSize 缺省为 20。
|
getDepositTokenApprovalPolicies |
返回当前审批策略记录。 | 无。 | approval_policy_id 选择一个策略；省略它以列出所有策略。bookmark 默认为 0；pageSize 默认为 20。
|
getDepositTokenApprovalPolicyHistory |
返回审批策略修订。 | 无。 | approval_policy_id 过滤修订；省略它以列出所有修订。bookmark 默认为 0；pageSize 默认为 20。
|
getPendingDepositTokenApprovalOperations |
返回等待审批的当前操作。 | 无。 | token_id 和 operation_id 是可选过滤器。省略 operation_id 以列出所有当前暂挂操作。bookmark 默认为 0；pageSize 默认为 20。
|
getDepositTokenApprovalsByApprover |
返回审批人的审批/拒绝决定。 | approver_address 是审批者 wallet 地址。
|
operation_id 将结果缩小为一项操作；该审批人忽略所有决策。bookmark 默认为 0；pageSize 默认为 20。
|
getDepositTokenApprovalsByOperationId |
返回一个操作的审批/拒绝事件。 | operation_id 标识审批操作。
|
bookmark 默认为 0；pageSize 默认为 20。
|
getDepositTokenApprovalStatusByOperationId |
返回存储的工作流状态加上当前有效策略解析。 | token_id 和 operation_id 标识工作流/暂挂。
|
无。它不生成合成 BLOCKED 或 AWAITING_MANAGER_COMPLETION 状态。
|
分页和时间戳：bookmark 参数是基于零的行偏移量，pageSize 参数区分大小写。对于历史记录路由，startTime 和 endTime 使用格式为 YYYY-MM-DDTHH:MI:SS+/-HH:MI 的 ISO-8601 时间戳文本。
端点清单：确切的路由清单属于为部署打包的脚本版本。运行后，使用 ORDS OpenAPI 目录或生成的端点输出作为客户机应用程序的授权列表。
故障排除
| 消息或条件 | 解决方法 |
|---|---|
NJS-516: no configuration directory set |
使用的 TNS 别名没有可访问的 wallet/configuration 目录。提取 wallet 并配置 Oracle 客户机，以便 tnsnames.ora 文件可用。
|
NJS-511 或 ORA-12506 |
监听程序、端点、服务名称、网络允许列表或 wallet 配置问题。验证与 DBA 的脚本外部的 Oracle 连接。 |
| OAuth 令牌请求返回 404 | 验证 /ords/<ALIAS_NAME>/oauth/token 中的确切别名。别名不一定是 Oracle 用户名。
|
| 端点返回 401 | 获取新令牌并验证 OAuth 客户端是否具有与配置的模块基本路径关联的角色/权限。 |
| 端点返回 404 | 验证主机、别名、基本路径、路由名称以及模块是否已发布。 |
ORDS-25001 |
端点已到达 ORDS，但其 SQL 失败。验证表前缀、合同地址、源数据配置和所需的请求参数。 |
ORA-20049: Cannot alter the URL mapping while the schema is enabled |
所选 ALIAS_NAME 与启用的方案映射冲突。重用方案的现有别名，或者让 ORDS 管理员在再次运行脚本之前完成批准的禁用/重新映射/启用过程。
|
| 视图不包含行 | 确认在实例创建期间选择了正确的多信息历史记录概要信息，表前缀完全正确，合同地址与部署的代理匹配，并且已为事务处理编制索引。 |
| 对象与其他部署冲突 | 使用不同的 VIEW_PREFIX、模块名称、基本路径、角色、权限、OAuth 客户端名称和别名。
|