BOLD Carbon (CH₄) Integration Guide v1.0.0
Integration guide for BOLD Carbon (CH₄) Application (MvA) v1.0.0 — expected events, required fields, and validation requirements.
This guide explains how to submit MassID documents that satisfy BOLD Carbon (CH₄) rules. BOLD Carbon shares most rules with BOLD Recycling and adds two Carbon-exclusive rules for geographic boundary and emissions calculation.
For the base API flow, see Submitting a MassID. For the complete rules catalog, see BOLD Carbon (CH₄) Rules.
Prerequisites
- Completed the Quick Start flow.
- Familiar with Core Concepts (document model, event ordering, idempotency).
- All participants (Waste Generator, Hauler, Processor, Recycler) have valid accreditation documents.
- Recycler accreditation includes the exceeding emission coefficient required for emissions calculation.
Shared rules with BOLD Recycling
BOLD Carbon rules 1–19 are identical to BOLD Recycling. The document creation, event sequence, and field requirements for these rules are the same. See the BOLD Recycling Integration Guide for the full event-by-event breakdown covering:
- Document creation (category, type, subtype, measurement unit)
- ACTOR events for all participants (with accreditation)
- PICK_UP, TRANSPORT_MANIFEST, WEIGHING, DROP_OFF, SORTING, RECYCLED, and RECYCLING_MANIFEST events
- Geolocation, uniqueness, composting timeframe, and Ibama code validations (see Supported waste codes for accepted values)
Everything in that guide applies here. This page covers only the two Carbon-exclusive additions.
Event and rule mapping
CUSTOM event names
| Event Name | Purpose | Validated by |
|---|---|---|
| PICK_UP | Waste collection from generator site | — |
| TRANSPORT_MANIFEST | Transport documentation attachment | — |
| WEIGHING | Weight capture at a calibrated scale | — |
| DROP_OFF | Delivery to the recycling/processing facility | — |
| SORTING | Waste sorting with contamination deduction | — |
| RECYCLED | Confirms composting or recycling completion | — |
| RECYCLING_MANIFEST | Final recycling documentation attachment | — |
ACTOR label vocabulary
| Label | Description | Validated by |
|---|---|---|
| WASTE_GENERATOR | Source of the waste material | — |
| HAULER | Transports waste from origin to facility | — |
| RECYCLER | Operates the recycling or composting facility | — |
| PROCESSOR | Processes sorted material | — |
Carbon-exclusive rules
Rule 20 — Project Boundary
Validates the geographic distance between the first PICK_UP event address and the last DROP_OFF event address. This ensures the waste transport occurred within an acceptable geographic boundary.
What your integration must provide:
- Accurate addresses on both PICK_UP and DROP_OFF events (latitude/longitude).
- The distance between these addresses is calculated and validated by the rule.
Rule 21 — Prevented Emissions
Calculates prevented CO₂-equivalent emissions based on the UNFCCC AMS-III.F methodology. The calculation uses:
| Input | Source |
|---|---|
| Exceeding emission coefficient | Recycler accreditation document. |
| Waste generator baseline | Waste generator accreditation data. |
| Waste subtype | MassID document subtype field. |
| MassID value | MassID document value field (weight in kg). |
What your integration must ensure:
- The recycler's accreditation document includes a valid exceeding emission coefficient.
- The waste generator's accreditation includes baseline data.
- The MassID document's subtype and value are correctly set.
The rule outputs the calculated prevented emissions in CO₂e.
Post-validation
When all 21 rules pass, the platform:
- Issues a GasID certificate linked to the MassID (instead of a RecycledID).
- Runs GasID rules (rewards distribution for supply chain participants).
- Generates C-CARB.CH4 (Tokenized Carbon Credits (TCC)) credit tokens upon credit order settlement.
Differences from BOLD Recycling
| Aspect | BOLD Recycling | BOLD Carbon (CH₄) |
|---|---|---|
| Rules count | 19 MassID rules | 21 MassID rules (19 shared + 2 exclusive) |
| Certificate type | RecycledID | GasID |
| Credit token | C-BIOW (TRC) | C-CARB.CH4 (TCC) |
| Emissions calculation | Not applicable | Prevented CO₂e via UNFCCC AMS-III.F (rule 21) |
| Geographic boundary | Not validated | PICK_UP → DROP_OFF distance validated (rule 20) |
| Accreditation data | Standard accreditation fields | Must include exceeding emission coefficient for recycler |
Common issues
All BOLD Recycling common issues apply, plus:
- Missing emission coefficient — The recycler's accreditation must include the exceeding emission coefficient. Without it, rule 21 cannot calculate prevented emissions.
- Project boundary failure — The PICK_UP and DROP_OFF addresses must be geographically reasonable. Ensure GPS coordinates are accurate on both events.
- Waste generator baseline — The waste generator's accreditation must include baseline data for the emissions calculation.
View rules catalog · View app reference · BOLD Recycling integration guide