93 lines
2.2 KiB
Markdown
93 lines
2.2 KiB
Markdown
|
# 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
|
|||
|
|
```http
|
|||
|
|
POST /api/v1/udfo/initialize
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Get All Definitions
|
|||
|
|
```http
|
|||
|
|
GET /api/v1/udfo/definitions
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Get Assets
|
|||
|
|
```http
|
|||
|
|
GET /api/v1/udfo/assets
|
|||
|
|
GET /api/v1/udfo/assets/:code
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Get Entities
|
|||
|
|
```http
|
|||
|
|
GET /api/v1/udfo/entities
|
|||
|
|
GET /api/v1/udfo/entities/:identifier
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Get Processes
|
|||
|
|
```http
|
|||
|
|
GET /api/v1/udfo/processes
|
|||
|
|
GET /api/v1/udfo/processes/:code
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Validate Ontology
|
|||
|
|
```http
|
|||
|
|
POST /api/v1/udfo/validate
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Usage Example
|
|||
|
|
|
|||
|
|
```typescript
|
|||
|
|
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
|
|||
|
|
|