dbis_core/docs/volume-vi/udfo.md

Unified DBIS Financial Ontology (UDFO)

Overview

UDFO is the global financial language of DBIS, used by all smart contracts, CBDC ledgers, regulatory engines, risk models, and cross-chain protocols. It creates universal definitions for multi-asset terms.

Architecture

UDFO consists of three ontology domains:

Domain 1 – Assets

• FIAT: Traditional government-issued currency
• CBDC: Central Bank Digital Currency
• SSU: Synthetic Settlement Unit
• COMMODITY: Physical or digital commodity token
• SECURITY: Tokenized security or financial instrument

Domain 2 – Entities

• SCB: Sovereign Central Bank
• BANK: Private commercial or investment bank
• INDIVIDUAL: Individual person or wallet holder
• INSTITUTION: Corporate or institutional entity
• CONTRACT: Deterministic smart contract

Domain 3 – Processes

• SETTLEMENT: Dual-ledger posting resulting in finality
• ISSUANCE: Creation of new asset units by authorized issuer
• CONVERSION: Exchange of one asset type for another
• REDEMPTION: Return of asset to issuer for underlying value
• COLLATERALIZATION: Use of asset as collateral for obligation

API Endpoints

Initialize UDFO

POST /api/v1/udfo/initialize

Get All Definitions

GET /api/v1/udfo/definitions

Get Assets

GET /api/v1/udfo/assets
GET /api/v1/udfo/assets/:code

Get Entities

GET /api/v1/udfo/entities
GET /api/v1/udfo/entities/:identifier

Get Processes

GET /api/v1/udfo/processes
GET /api/v1/udfo/processes/:code

Validate Ontology

POST /api/v1/udfo/validate

Usage Example

import { udfoService } from '@/core/ontology/udfo';

// Initialize UDFO
await udfoService.initialize();

// Get asset definition
const asset = await udfoService.getAssetService().getAssetByCode('SSU');

// Validate smart contract against ontology
const validation = await udfoService.getValidatorService().validate({
  assetId: 'SSU',
  processId: 'SETTLEMENT',
  contractCode: contractCode,
});

Database Models

• UDFOAsset: Asset definitions
• UDFOEntity: Entity definitions
• UDFOProcess: Process definitions
• OntologyMapping: Cross-domain mappings