BillingMoneyReason billing.money-reason@1

Generated at 2026-11-13 06:25:48 UTC from openvibe-contracts v0.419.0 and openvibe-sdk v0.161.0.

Version

1.0.0

Owner

billing

Visibility

public

Status

active

Compatibility

backward

Schema

https://openvibe.network/contracts/billing/money-reason.v1.json

billing.money-reason@1: why a movement of OpenCoins, Vibes or Balance happened, in the words a person reads. `key` is the raw ledger reason (OpenCoins reason, or Billing's type:metadata); `text` is the phrase without the amount ("for the quest Publish a video"), so a page writes "+15 OpenCoins" before it; `subject` is the thing it was for and where to read it, when there is one. A key nobody declared reads "for something on <site>", has known: false, and is never shown as its key. Same reason kinds, one list: openvibe-contracts/lib/money-reasons.js.

Fields

Examples

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

{
  "key": "account_merge",
  "text": "for merging your accounts",
  "subject": null,
  "site": "OpenVibe.Network",
  "known": true
}

{
  "key": "quest:publish-a-video",
  "text": "for the quest Publish a video",
  "subject": {
    "name": "Publish a video",
    "url": "https://openvibe.quest/quests/publish-a-video"
  },
  "site": "OpenVibe.Quest",
  "known": true
}

{
  "key": "donation",
  "text": "for a tip to @alice",
  "subject": {
    "name": "@alice",
    "url": "https://openvibe.live/@alice"
  },
  "site": "OpenVibe",
  "known": true
}

{
  "key": "nobody:declared-this",
  "text": "for something on OpenVibe.Live",
  "subject": null,
  "site": "OpenVibe.Live",
  "known": false
}

{
  "key": "quest:go-live",
  "text": "for the quest Go live",
  "amount": 15
}

{
  "key": null,
  "text": "for the quest Go live"
}

{
  "key": "quest:go-live"
}

Validate

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