foundation.protocols.eudr.*

EUDR Context

The EU Deforestation Regulation requires commodity exports to prove deforestation-free sourcing. Seven regulated commodities: cattle, cocoa, coffee, oil palm, rubber, soya, wood. Operators must submit a Due Diligence Statement (DDS) to the EU TRACES NT system before import.

Chain-of-Custody Flow

A directed acyclic graph (DAG) from farm plot to EU border.

Events

{
  "type": "foundation.protocols.eudr.actor_registration",
  "state_key": "@frm-gh-0042:coop.averdine.net",
  "content": {
    "actor_id": "@frm-gh-0042:coop.averdine.net",
    "role": "farmer",
    "organization": "Kumasi Organic Cocoa Cooperative",
    "country": "GH",
    "commodities": ["cocoa"],
    "registration_number": "GH-COC-2024-0042"
  }
}

{
  "type": "foundation.protocols.eudr.plot_geolocation",
  "content": {
    "plot_id": "PLT-GH-0042-A",
    "farmer_id": "@frm-gh-0042:coop.averdine.net",
    "geojson": {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [-1.6221, 6.6885]
      },
      "properties": { "crs": "EPSG:4326" }
    },
    "area_hectares": 2.3,
    "commodity": "cocoa",
    "recorded_at": "2026-01-15T09:30:00Z"
  }
}

{
  "type": "foundation.protocols.eudr.deforestation_check",
  "content": {
    "plot_id": "PLT-GH-0042-A",
    "result": "deforestation_free",
    "confidence": 0.94,
    "satellite_source": "Sentinel-2",
    "analysis_date": "2026-02-10",
    "cutoff_date": "2020-12-31",
    "verified_by": "ai_service",
    "reference_images": [
      {
        "date": "2020-06-15",
        "source": "Sentinel-2",
        "mxc_uri": "mxc://averdine.net/sat-img-pre-2020"
      },
      {
        "date": "2026-02-01",
        "source": "Sentinel-2",
        "mxc_uri": "mxc://averdine.net/sat-img-current"
      }
    ]
  }
}

{
  "type": "foundation.protocols.eudr.harvest_record",
  "content": {
    "harvest_id": "HRV-GH-0042-2026-Q1",
    "plot_id": "PLT-GH-0042-A",
    "farmer_id": "@frm-gh-0042:coop.averdine.net",
    "commodity": "cocoa",
    "quantity_kg": 320,
    "harvest_date": "2026-03-01",
    "deforestation_check_ref": "$deforestation_check_event_id"
  }
}

{
  "type": "foundation.protocols.eudr.chain_of_custody",
  "content": {
    "transfer_id": "COC-GH-2026-0099",
    "from_actor": "@frm-gh-0042:coop.averdine.net",
    "to_actor": "@trd-gh-0099:trade.averdine.net",
    "commodity": "cocoa",
    "quantity_kg": 320,
    "source_refs": ["$harvest_record_event_id"],
    "transfer_date": "2026-03-05",
    "transport_method": "road"
  }
}

{
  "type": "foundation.protocols.eudr.processing_event",
  "content": {
    "processing_id": "PRC-GH-2026-0050",
    "processor_id": "@prc-gh-0099:proc.averdine.net",
    "process_type": "drying",
    "input_refs": ["$chain_of_custody_event_id"],
    "input_quantity_kg": 320,
    "output_quantity_kg": 256,
    "processing_date": "2026-03-10"
  }
}

{
  "type": "foundation.protocols.eudr.legal_compliance",
  "content": {
    "compliance_id": "LCM-GH-0042-LT",
    "actor_id": "@frm-gh-0042:coop.averdine.net",
    "document_type": "land_title",
    "document_ref": "GH-LANDS-2019-4521",
    "issuing_authority": "Ghana Lands Commission",
    "valid_from": "2019-06-01",
    "valid_until": "2029-05-31",
    "mxc_uri": "mxc://averdine.net/land-title-doc"
  }
}

{
  "type": "foundation.protocols.eudr.risk_assessment",
  "content": {
    "assessment_id": "RSK-GH-2026-0042",
    "target_type": "shipment",
    "target_ref": "$chain_of_custody_event_id",
    "risk_level": "low",
    "risk_factors": [
      { "factor": "country_benchmark", "level": "standard", "source": "EU Commission" },
      { "factor": "deforestation_check", "level": "low", "confidence": 0.94 },
      { "factor": "actor_history", "level": "low", "note": "3 years clean record" }
    ],
    "assessed_by": "ai_service",
    "assessment_date": "2026-03-12"
  }
}

{
  "type": "foundation.protocols.eudr.dds_draft",
  "content": {
    "dds_id": "DDS-DE-2026-0001",
    "operator_id": "@op-de-aver-001:eu.averdine.net",
    "commodity": "cocoa",
    "country_of_origin": "GH",
    "plot_refs": ["$plot_geolocation_event_id"],
    "deforestation_refs": ["$deforestation_check_event_id"],
    "chain_of_custody_refs": [
      "$coc_farmer_to_trader",
      "$coc_trader_to_processor",
      "$coc_processor_to_exporter",
      "$coc_exporter_to_operator"
    ],
    "risk_assessment_ref": "$risk_assessment_event_id",
    "total_quantity_kg": 256,
    "status": "under_review"
  }
}

{
  "type": "foundation.protocols.eudr.dds_submitted",
  "content": {
    "dds_id": "DDS-DE-2026-0001",
    "traces_reference": "TRACES-NT-2026-DE-COCOA-00421",
    "submitted_by": "@op-de-aver-001:eu.averdine.net",
    "submitted_at": "2026-03-15T14:30:00Z",
    "status": "submitted"
  }
}

{
  "type": "foundation.protocols.eudr.country_benchmark",
  "state_key": "GH",
  "content": {
    "country": "GH",
    "risk_category": "standard",
    "assessment_date": "2025-12-30",
    "source": "EU Commission EUDR Country Benchmarking, Dec 2025",
    "notes": "Ghana classified as standard risk for cocoa and wood"
  }
}

Supply Chain Actor Roles

EUDR rooms use Matrix power levels to enforce supply chain hierarchy.

AI Governance Integration

AI-driven EUDR operations (deforestation checks, risk assessments) are wrapped in the general ai.* governance flow:

DDS Workflow

7-stage pipeline from data submission to regulatory confirmation: