UBC Settlement v1¶
Source schema: doc/schemas/ubc-settlement.v1.schema.json
Machine-readable schema for periodic settlement records of Universal Basic Compute funding, allocation, and optional FIP bridge usage.
Governing Basis¶
doc/normative/40-constitution/CONSTITUTION.mddoc/normative/50-constitutional-ops/UNIVERSAL-BASIC-COMPUTE.mddoc/normative/50-constitutional-ops/SWARM-ECONOMY-SUFFICIENCY.md
Fields¶
| Field | Required | Shape | Description |
|---|---|---|---|
schema/v |
yes |
const: 1 |
Schema version. |
settlement_id |
yes |
string | Stable identifier of this settlement record. |
federation_id |
yes |
string | Federation whose funding floor and usage are being settled. |
period_start |
yes |
string | |
period_end |
yes |
string | |
compute_unit |
yes |
string | Unit of account used for compute funding and usage in this settlement window. |
beneficiary_count |
yes |
integer | Number of persons whose UBC floor was funded in the settlement period. |
total_allocated_compute |
yes |
number | Total compute budget allocated to the UBC floor in the settlement period. |
funding_sources |
yes |
array | |
emergency_usage |
yes |
number | |
communication_usage |
yes |
number | |
care_usage |
yes |
number | |
bridge_usage |
no |
array | |
policy_ref |
yes |
string | Reference to the governing funding or sufficiency policy used for this settlement. |
created_at |
yes |
string | |
policy_annotations |
no |
object |
Definitions¶
| Definition | Shape | Description |
|---|---|---|
fundingSource |
object | |
bridgeUsage |
object | |
| ## Field Semantics |
schema/v¶
- Required:
yes - Shape: const:
1
Schema version.
settlement_id¶
- Required:
yes - Shape: string
Stable identifier of this settlement record.
federation_id¶
- Required:
yes - Shape: string
Federation whose funding floor and usage are being settled.
period_start¶
- Required:
yes - Shape: string
period_end¶
- Required:
yes - Shape: string
compute_unit¶
- Required:
yes - Shape: string
Unit of account used for compute funding and usage in this settlement window.
beneficiary_count¶
- Required:
yes - Shape: integer
Number of persons whose UBC floor was funded in the settlement period.
total_allocated_compute¶
- Required:
yes - Shape: number
Total compute budget allocated to the UBC floor in the settlement period.
funding_sources¶
- Required:
yes - Shape: array
emergency_usage¶
- Required:
yes - Shape: number
communication_usage¶
- Required:
yes - Shape: number
care_usage¶
- Required:
yes - Shape: number
bridge_usage¶
- Required:
no - Shape: array
policy_ref¶
- Required:
yes - Shape: string
Reference to the governing funding or sufficiency policy used for this settlement.
created_at¶
- Required:
yes - Shape: string
policy_annotations¶
- Required:
no - Shape: object
Definition Semantics¶
$defs.fundingSource¶
- Shape: object
$defs.bridgeUsage¶
- Shape: object