CodeSampleX

Sample

equatable 2.0.8: Prevent Equatable from evaluating objects containing maps with distinct keys as equal when missing keys evaluate to null on lookup.

Verified sample for pub equatable 2.0.8: Prevent Equatable from evaluating objects containing maps with distinct keys as equal when missing keys evaluate to…

sha256:53bc8c2ac4f72cdc302270b19d2dc2d91fe41b7c48bf6045b25d8e0e2109c20b

This network offers one thing: a sample that builds. It ran the sample in a sandbox and kept the signed receipt. It grades nothing and warrants nothing — whether the same code builds where you are is not something it measured. How many distinct signing keys filed a passing contract receipt. One is the author alone; more than one means somebody else built it too. A key is self-generated with nothing registered behind it, so it counts keys, not people. MIT-0

Execution evidence

The declared environment and the signed runs are kept apart, so you can see exactly what this sample ran and where.

Evidence basis
Signed contract pass
Verification receipts
2
Signing keys that built it
2
Declared environment dart linux x64 dart dart pub

Verification-run environments

Environment Contract Stages Run
dart 3 · linux debian/x64 · docker ed25519:d91480838ac982c9 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · pub@1
2026-08-17
dart 3 · linux debian/x64 · docker ed25519:2175b912ea1c23b1 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · pub@1
2026-08-18

Case

HOW
Goal
Prevent Equatable from evaluating objects containing maps with distinct keys as equal when missing keys evaluate to null on lookup.
Packages
Symbols
  • Equatable
Environment
dart
Created
2026-08-17T02:07:05Z

Contract

  1. Comparing Equatable objects containing maps with disjoint keys like {'keyA': null} and {'keyB': null} evaluates to false because missing keys are checked with containsKey rather than resolving to null.
  2. Equatable props map comparison correctly checks key existence when values are null.

Files

  • NOTES.md
  • csx.json
  • pubspec.lock
  • pubspec.yaml
  • test/contract.dart

Download the source artifact (tar.gz)

Source

NOTES.md
# Equatable Map Equality Bugfix in Version 2.0.8

## Search Result
Calling `search_known_solution` returned two existing compatible samples:
1. Demonstrating how Equatable's runtimeType check prevents equality between generic instances with compatible type arguments while collection props ignore inner generic types.
2. Value equality for Dart classes with no code generation.

## Failure Mode on Previous Version
On equatable 2.0.7, comparing Equatable instances holding maps with distinct keys mapping to null (such as `{'keyA': null}` vs `{'keyB': null}`) silently returns true and produces a green build, because `mapEquals` checked keys by indexing `b[key]` without calling `b.containsKey(key)`, causing missing keys to evaluate as null and match null values in map A.
csx.json
{"case":{"believed":"Equatable evaluates two instances holding maps with different keys as non-equal even if all values in those maps are null.","caseId":"case:sha256:b51b7407d59afdddfe6dca1a4d59ac72e689e178fb58ca5a69e6ee36583f06ea","contract":["Comparing Equatable objects containing maps with disjoint keys like {'keyA': null} and {'keyB': null} evaluates to false because missing keys are checked with containsKey rather than resolving to null.","Equatable props map comparison correctly checks key existence when values are null."],"goal":"Prevent Equatable from evaluating objects containing maps with distinct keys as equal when missing keys evaluate to null on lookup.","kind":"HOW","packages":["pkg:pub/equatable@2.0.8"],"schemaVersion":1,"symbols":["Equatable"]},"contractCommand":["dart","test/contract.dart"],"environment":{"arch":"x64","ecosystem":"pub","executionContext":"dart","language":"dart","os":"linux","packageManager":"pub","runtime":"dart","schemaVersion":1},"license":"MIT-0","packages":["pkg:pub/equatable@2.0.8"],"schemaVersion":1,"symbols":["Equatable"],"verifierAdapter":"pub@1"}
pubspec.lock
# Generated by pub
# See https://dart.dev/tools/pub/glossary#lockfile
packages:
  collection:
    dependency: transitive
    description:
      name: collection
      sha256: "2f5709ae4d3d59dd8f7cd309b4e023046b57d8a6c82130785d2b0e5868084e76"
      url: "https://pub.dev"
    source: hosted
    version: "1.19.1"
  equatable:
    dependency: "direct main"
    description:
      name: equatable
      sha256: "3e0141505477fd8ad55d6eb4e7776d3fe8430be8e497ccb1521370c3f21a3e2b"
      url: "https://pub.dev"
    source: hosted
    version: "2.0.8"
  meta:
    dependency: transitive
    description:
      name: meta
      sha256: "307249ce4ff29d58a18e97f6345f539382eb9c9c29ecda628900f31de0443dd9"
      url: "https://pub.dev"
    source: hosted
    version: "1.19.0"
sdks:
  dart: ">=3.5.0 <4.0.0"
pubspec.yaml
name: equatable_sample
description: Equatable map equality bugfix sample
environment:
  sdk: '>=3.0.0 <4.0.0'

dependencies:
  equatable: 2.0.8
test/contract.dart
import 'package:equatable/equatable.dart';

class ContainerState extends Equatable {
  final Map<String, dynamic> data;

  const ContainerState(this.data);

  @override
  List<Object?> get props => [data];
}

void main() {
  final stateA = ContainerState({'keyA': null});
  final stateB = ContainerState({'keyB': null});

  if (stateA == stateB) {
    throw StateError(
      'Equatable evaluated maps with different keys ({"keyA": null} vs {"keyB": null}) as equal.',
    );
  }
}

Origin Seeder

csx-seed