---
title: "platform.link-capabilities@1 · OpenVibe.Services"
canonical: "https://openvibe.services/docs/contracts/platform.link-capabilities"
updated: null
---

# platform.link-capabilities@1 · OpenVibe.Services

HTML: [platform.link-capabilities@1 · OpenVibe.Services](https://openvibe.services/docs/contracts/platform.link-capabilities)

# LinkCapabilities `platform.link-capabilities@1`

Generated at 2026-11-13 06:25:48 UTC from [`openvibe-contracts v0.419.0`](https://github.com/OpenVibers/OpenVibe.Contracts/tree/v0.419.0) and [`openvibe-sdk v0.161.0`](https://github.com/OpenVibers/OpenVibe.SDK/tree/v0.161.0).

- Version: 1.0.0
- Owner: network
- Visibility: public
- Status: active
- Compatibility: backward
- Decision: [ADR-034](/docs/adr/ADR-034)
- Schema: [`https://openvibe.network/contracts/platform/link-capabilities.v1.json`](/docs/contracts/platform.link-capabilities.json)

Link machine hardware, placement regions, tags, and operating costs (T1 Universal Fabric; ADR-034 proposed).

## Fields

| Field | Type | Required | Description | Constraints |
| --- | --- | --- | --- | --- |
| `node_id` | string | yes |  |  |
| `cpu` | object | yes |  | - `no other fields` |
| `cpu.cores` | number | yes |  | - `minimum 0` |
| `cpu.threads` | integer |  |  | - `minimum 0` |
| `arch` | string | yes | CPU architecture |  |
| `memory_mb` | integer | yes |  | - `minimum 0` |
| `gpu` | object |  |  | - `no other fields` |
| `gpu.model` | string | yes |  |  |
| `gpu.count` | integer | yes |  | - `minimum 0` |
| `gpu.vram_mb` | integer |  |  | - `minimum 0` |
| `storage` | object | yes |  | - `no other fields` |
| `storage.capacity_gb` | number | yes |  | - `minimum 0` |
| `storage.available_gb` | number |  |  | - `minimum 0` |
| `storage.kind` | string |  |  |  |
| `network` | object | yes |  | - `no other fields` |
| `network.ingress_mbps` | number | yes |  | - `minimum 0` |
| `network.egress_mbps` | number | yes |  | - `minimum 0` |
| `regions` | array of string | yes |  | - `minItems 1` |
| `tags` | array of string | yes |  |  |
| `costs` | object | yes |  | - `no other fields` |
| `costs.per_hour_usd` | number | yes | Estimated USD | - `minimum 0` |
| `costs.egress_per_gb_usd` | number |  | Estimated USD | - `minimum 0` |
| `capabilities` | array of string |  | What the machine offers, in the platform.resource-offer@1 capability form (e.g. node:http, worker:ffmpeg). | - `items: pattern ^[a-z][a-z0-9-]*:[a-z0-9.-]+$` |
| `agent_version` | string |  | Version of the node agent that reported. | - `maxLength 40` |
| `updated_at` | string |  |  | - `format date-time` |

## Examples

From the contract's own test fixtures: valid ones validate, rejected ones must fail.

 Valid: agent-report

~~~~
{
  "node_id": "node-1",
  "cpu": {
    "cores": 8,
    "threads": 16
  },
  "arch": "x86_64",
  "memory_mb": 16384,
  "gpu": {
    "model": "L4",
    "count": 1,
    "vram_mb": 24576
  },
  "storage": {
    "capacity_gb": 500,
    "available_gb": 300,
    "kind": "ssd"
  },
  "network": {
    "ingress_mbps": 1000,
    "egress_mbps": 1000
  },
  "regions": [
    "us-west"
  ],
  "tags": [
    "gpu",
    "edge"
  ],
  "costs": {
    "per_hour_usd": 0.2,
    "egress_per_gb_usd": 0.01
  },
  "capabilities": [
    "node:http",
    "worker:ffmpeg"
  ],
  "agent_version": "0.9.0",
  "updated_at": "2026-10-02T00:00:00Z"
}
~~~~

Valid: example

~~~~
{
  "node_id": "node-1",
  "cpu": {
    "cores": 8,
    "threads": 16
  },
  "arch": "x86_64",
  "memory_mb": 16384,
  "gpu": {
    "model": "L4",
    "count": 1,
    "vram_mb": 24576
  },
  "storage": {
    "capacity_gb": 500,
    "available_gb": 300,
    "kind": "ssd"
  },
  "network": {
    "ingress_mbps": 1000,
    "egress_mbps": 1000
  },
  "regions": [
    "us-west"
  ],
  "tags": [
    "gpu",
    "edge"
  ],
  "costs": {
    "per_hour_usd": 0.2,
    "egress_per_gb_usd": 0.01
  }
}
~~~~

Rejected: bad-capability

~~~~
{
  "node_id": "node-1",
  "cpu": {
    "cores": 8,
    "threads": 16
  },
  "arch": "x86_64",
  "memory_mb": 16384,
  "gpu": {
    "model": "L4",
    "count": 1,
    "vram_mb": 24576
  },
  "storage": {
    "capacity_gb": 500,
    "available_gb": 300,
    "kind": "ssd"
  },
  "network": {
    "ingress_mbps": 1000,
    "egress_mbps": 1000
  },
  "regions": [
    "us-west"
  ],
  "tags": [
    "gpu",
    "edge"
  ],
  "costs": {
    "per_hour_usd": 0.2,
    "egress_per_gb_usd": 0.01
  },
  "capabilities": [
    "ffmpeg"
  ]
}
~~~~

Rejected: missing-node\_id

~~~~
{
  "cpu": {
    "cores": 8,
    "threads": 16
  },
  "arch": "x86_64",
  "memory_mb": 16384,
  "gpu": {
    "model": "L4",
    "count": 1,
    "vram_mb": 24576
  },
  "storage": {
    "capacity_gb": 500,
    "available_gb": 300,
    "kind": "ssd"
  },
  "network": {
    "ingress_mbps": 1000,
    "egress_mbps": 1000
  },
  "regions": [
    "us-west"
  ],
  "tags": [
    "gpu",
    "edge"
  ],
  "costs": {
    "per_hour_usd": 0.2,
    "egress_per_gb_usd": 0.01
  }
}
~~~~

## Validate

~~~~
const contracts = require('openvibe-contracts');
contracts.validate('platform.link-capabilities@1', value);   // { valid, errors: [{ path, message }] }
~~~~