HarvestChain
Field-level harvest and delivery attestation
HarvestChain
Field-level harvest and delivery attestation. Contract farming disputes often turn on whether crop quantity, quality, and delivery milestones were actually met.
HarvestChain is strongest when treated as a governed state machine, not a static token. The object must carry enough identity to be trusted at mint, enough mutable state to reflect the real workflow, and enough audit history for a third party to decide whether the current state is reliable.
Strategic thesis
Why this wedge exists
Field and delivery events update a shared crop obligation object for traders, growers, and insurers.
The first buyer is Agricultural traders, insurers, and contract farming networks. They don't need a generic blockchain story; they need a way to reduce disputes, speed approval, and make the current status of a workflow independently checkable.
State Dual manages
Field pledge, growth stage, harvest proof, quality inspection, delivery, payment, and exception state.
The important point is not the number of states. It's that each transition has an actor, an allowed action, evidence, and a durable audit record. That turns operational workflow into an inspectable object.
Token architecture
| Immutable identity | asset_id, issuer_id, serialization_standard, origin_proof_hash, created_at |
| Mutable state | custody_holder, location_status, verification_status, exception_status, last_handoff_at |
| Compliance rules | Only approved roles can accept or release custody. Exceptions create quarantine state before downstream transfer. Recall, dispute, and retirement states remain queryable after close. |
| Event sources | ERP or WMS shipment events, scanner/NFC/serial verification, inspection or authenticator attestation, regulator or marketplace query |
Example object schema
{
"template": "harvestchain",
"category": "Custody state",
"immutable": {
"asset_id": "set_at_mint",
"issuer_id": "set_at_mint",
"serialization_standard": "set_at_mint",
"origin_proof_hash": "set_at_mint",
"created_at": "set_at_mint"
},
"mutable": {
"custody_holder": "updated_by_event",
"location_status": "updated_by_event",
"verification_status": "updated_by_event",
"exception_status": "updated_by_event",
"last_handoff_at": "updated_by_event"
},
"rules": {
"allowed_states": ["Pledged","Growing","Harvest Ready","Harvested","Delivered","Accepted","Paid"],
"first_buyer": "Agricultural traders, insurers, and contract farming networks",
"audit_required": true
}
}This schema is intentionally scoped. A credible first product should prove one object type, one core state machine, and a small number of high-value integrations before expanding into a platform.
User journey
- 1
Issuer: Pledged
The HarvestChain object is created with immutable identity, owner, and rule metadata.
- 2
Operator: Growing
An event moves the object into "Growing", preserving the previous state and the actor that triggered the change.
- 3
Verifier: Harvest Ready
An event moves the object into "Harvest Ready", preserving the previous state and the actor that triggered the change.
- 4
Counterparty: Harvested
An event moves the object into "Harvested", preserving the previous state and the actor that triggered the change.
- 5
Auditor: Delivered
An event moves the object into "Delivered", preserving the previous state and the actor that triggered the change.
- 6
Automation: Accepted
An event moves the object into "Accepted", preserving the previous state and the actor that triggered the change.
- 7
Administrator: Paid
An event moves the object into "Paid", preserving the previous state and the actor that triggered the change.
Event model
Dual becomes useful when outside systems stop being passive records and start becoming evidence sources for state transitions.
- ERP or WMS shipment events
- scanner/NFC/serial verification
- inspection or authenticator attestation
- regulator or marketplace query
Each event should answer four questions: who produced it, which object it affects, which transition it requests, and which proof should be retained for audit.
Why not just a database?
Traditional system
A buyer database does not provide shared proof for farmer, trader, insurer, and financier.
That's acceptable when one organization owns the full workflow. It breaks down when multiple parties need to trust the same current state without relying on a single application owner.
Dual stateful object
Dual separates immutable identity, mutable lifecycle state, compliance checks, and event history. Participants can inspect the current object state, verify the transition path, and use the same state as input to payment, access, reporting, or downstream automation.
90-day MVP
One crop, one field, one delivery, one quality exception, and one payment release.
- Define the template and allowed state transitions.
- Mint test objects with realistic identity and ownership data.
- Wire one external event source into the Event Bus.
- Trigger one successful transition and one rejected transition.
- Expose a query view that proves current state and transition history.
Proof assets required
- Field schema
- Harvest proof
- Quality exception
- Delivery event
These assets are the difference between a concept note and a buildable wedge. Without them, the page is only a narrative; with them, it becomes a product specification.
Operating metrics
- handoff latency
- exception rate
- audit response time
- percentage of objects with complete provenance
These are the metrics that should be visible in the pilot dashboard. They also give sales, implementation, and investor conversations a concrete way to judge whether Dual is improving the workflow.
Commercial wedge
The first commercial motion should sell a narrow operational outcome, not broad tokenization. For HarvestChain, the wedge is: attest harvest. Price around the workflow value: fewer disputes, faster settlement, cleaner audit, lower fraud, or lower manual reconciliation.
Expansion should follow the state graph. Once the first transition is trusted, add the next actor, then the next integration, then the next reporting surface. That keeps the product grounded in workflow proof rather than speculative asset creation.
Risks and controls
- bad upstream data at mint. Control: define the trusted source, log every mutation, and keep manual override paths explicit.
- participants resisting shared custody proof. Control: define the trusted source, log every mutation, and keep manual override paths explicit.
- physical/digital mismatch if scanning controls are weak. Control: define the trusted source, log every mutation, and keep manual override paths explicit.
Implementation playbook
- Map the workflow: identify the actor responsible for each state and the evidence required for each transition.
- Create the template: split data into immutable identity, mutable state, and compliance rule fields.
- Mint sample objects: use realistic IDs, timestamps, owners, and source-system references.
- Connect one event: choose the event that makes the state change economically valuable.
- Reject one bad action: demonstrate that Dual blocks invalid transitions before downstream settlement.
- Expose audit: show current state, previous state, actor, timestamp, evidence hash, and rule result.
Build prompt
Create a Dual template for HarvestChain. Model immutable identity fields, mutable lifecycle state, compliance checks, and event inputs. Then emit one test object and move it through: Pledged → Growing → Harvest Ready → Harvested → Delivered.
Include:
- object schema
- transition rules
- event payload examples
- one rejected transition
- audit query output
- MVP dashboard fieldsUse this as a scoped wedge: prove one governed state transition, one external event, and one audit query before expanding the workflow.
Start with the Dual quickstart →