SUPPLY CHAIN TRACEABILITY

Farm to Fork in One Graph

Every ingredient, every step, every handler — linked by content-addressed FoodBlocks that can't be faked, forged, or forgotten.

The Problem

The global food supply chain is one of the most complex systems on earth — and one of the most opaque. An average product passes through 7 to 12 handlers before reaching a consumer, yet traceability is still largely paper-based, siloed across proprietary systems, and impossible to audit in real time. When contamination strikes, recalls take days or weeks. By the time affected products are identified, they have been consumed, discarded, or lost in the system. The 2013 horsemeat scandal took months to unravel. The 2018 romaine lettuce E. coli outbreak cost $350 million because no one could identify the source farm for five weeks. Every year, foodborne illness affects 600 million people globally, and much of it is traceable to broken links in the supply chain that nobody could see.

How FoodBlock Solves It

Every step in the supply chain is a FoodBlock. Each block references the ones before it, forming an immutable, content-addressed provenance graph.

actor.producerGreen Acres Farm
a1b2c3d4e5f6...7890
{
  "type": "actor.producer",
  "state": {
    "name": "Green Acres Farm",
    "location": "Hampshire, UK",
    "established": 2003,
    "hectares": 200,
    "methods": ["organic", "no-till"]
  },
  "refs": {}
}
substance.productHeritage Wheat
b2c3d4e5f6a1...8901
{
  "type": "substance.product",
  "state": {
    "name": "Heritage Wheat",
    "variety": "Maris Otter",
    "harvest_date": "2025-08-15",
    "weight_kg": 2400,
    "organic": true
  },
  "refs": {
    "grower": "a1b2c3d4..."
  }
}
transformStone Milling
c3d4e5f6a1b2...9012
{
  "type": "transform",
  "state": {
    "process": "Stone Milling",
    "facility": "Wessex Mill",
    "date": "2025-09-02",
    "input_kg": 2400,
    "output_kg": 2160,
    "extraction_rate": 0.90
  },
  "refs": {
    "input": "b2c3d4e5...",
    "facility": "d4e5f6a1..."
  }
}
actor.venueBread & Butter Bakery
d4e5f6a1b2c3...0123
{
  "type": "actor.venue",
  "state": {
    "name": "Bread & Butter Bakery",
    "address": "Borough Market, London",
    "cuisine": "Artisan Bakery",
    "established": 2018
  },
  "refs": {}
}
transformBaking
e5f6a1b2c3d4...1234
{
  "type": "transform",
  "state": {
    "process": "Sourdough Baking",
    "method": "Long fermentation (18h)",
    "temperature_c": 230,
    "duration_min": 35,
    "batch_size": 48
  },
  "refs": {
    "flour": "c3d4e5f6...",
    "baker": "d4e5f6a1..."
  }
}
substance.productSourdough Loaf
f6a1b2c3d4e5...2345
{
  "type": "substance.product",
  "state": {
    "name": "Sourdough Loaf",
    "weight_g": 500,
    "price": 4.50,
    "organic": true,
    "allergens": ["gluten"],
    "shelf_life_days": 5
  },
  "refs": {
    "baking": "e5f6a1b2...",
    "bakery": "d4e5f6a1...",
    "flour": "c3d4e5f6...",
    "wheat": "b2c3d4e5...",
    "farm": "a1b2c3d4..."
  }
}
6 blocks. 5 actors. 1 graph. Every step content-addressed, every ref verifiable, every claim auditable.

Key Benefits

Properties that emerge when the supply chain becomes a connected graph.

!

Instant Recalls

Traverse the block graph to find every affected product in seconds. When contamination is detected at a processor, an agent traces all downstream blocks — every shipment, every store, every consumer scan — and notifies affected parties within minutes.

O

Verified Claims

Organic, free-range, local — every claim is linked to a certification block. No more PDFs in filing cabinets. The observe.certification block references the certifier, the subject, and the expiry date. Consumers verify with one scan.

R

Regulatory Compliance

HACCP, EU food safety, FDA FSMA — the block graph IS the audit trail. Continuous monitoring agents create observation blocks at every critical control point. Inspection-ready reports generated on demand.

T

Consumer Trust

Scan any product and see the full story — who grew it, who processed it, how it travelled, and every certification along the way. Each step links to the one before it. Nobody had to manually tag any of it.

Example: Provenance Query via MCP
// "Trace this sourdough back to the farm"

> foodblock_tree({ hash: "f6a1b2c3d4e5...2345" })

substance.product  "Sourdough Loaf"  (f6a1b2c3...)
  |-- transform    "Sourdough Baking" (e5f6a1b2...)
  |     |-- actor.venue  "Bread & Butter Bakery" (d4e5f6a1...)
  |     |-- transform    "Stone Milling" (c3d4e5f6...)
  |           |-- substance.product "Heritage Wheat" (b2c3d4e5...)
  |                 |-- actor.producer "Green Acres Farm" (a1b2c3d4...)

// 6 blocks. Full provenance. One API call.
// Every hash verifiable. Every claim auditable.

Build Traceability Today

The sandbox is live, the provenance API is free to query, and the SDKs are open source. Start tracing food in minutes.

Developer PlaygroundView Pricing