NetworkMachinePairedPayload network.machine.paired@1

Generated at from openvibe-contracts v0.419.0 and openvibe-sdk v0.161.0.

Version
1.0.0
Owner
network
Visibility
first-party
Status
active
Compatibility
backward
Schema
https://openvibe.network/contracts/events/payloads/network.machine.paired.v1.json

network.machine.paired v1 (OpenVibe.Network, plan L34: the machines hub). A machine was paired with a person's account: it redeemed the one-time code and became theirs. It holds a credential from then on; the code is spent. The machine's device id in Bot is absent until the machine checks in for the first time. Envelope: subject { type: machine, id: <lnk_…> }, visibility internal, actor service:network.

Fields

FieldTypeRequiredDescriptionConstraints
machine_idstringThe machine's device id in Bot's registry, when Bot already knows the device.
  • pattern ^dev_[0-9A-HJKMNP-TV-Z]{26}$
node_idstringThe machine's node id (platform_node_principals.node_id).
  • pattern ^n-[a-z0-9]{26}$
principal_idstringyesThe node principal the pairing created. Also the envelope subject id.
  • pattern ^lnk_[0-9A-HJKMNP-TV-Z]{26}$
ownerstringyesThe person the machine belongs to.
  • pattern ^usr_[0-9A-HJKMNP-TV-Z]{26}$
atstringyes
  • format date-time

Examples

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

Valid: paired
{
  "node_id": "n-01jab2c3d4e5f6g7h8j9k0mnps",
  "principal_id": "lnk_01JAB2C3D4E5F6G7H8J9K0MNPS",
  "owner": "usr_01JAB2C3D4E5F6G7H8J9K0MNPS",
  "at": "2026-10-31T09:00:00.000Z"
}
Rejected: missing-principal
{
  "owner": "usr_01JAB2C3D4E5F6G7H8J9K0MNPS",
  "at": "2026-10-31T09:00:00.000Z"
}

Validate

const contracts = require('openvibe-contracts');
contracts.validate('network.machine.paired@1', value);   // { valid, errors: [{ path, message }] }