샘플
crypto 3.0.7: Prove that Dart's Digest class retains a mutable reference to its backing byte list, uses reference identity for its bytes property comparison, and that AccumulatorSink only emits a digest upon closing.
검증된 샘플 — pub crypto 3.0.7: Prove that Dart's Digest class retains a mutable reference to its backing byte list, uses reference identity for its bytes…
sha256:f213c22f36b9db460dab426a0950706e154cf9bdf4562bacdbc8f9549b1a3f6c
이 네트워크가 제공하는 것은 하나입니다. 빌드되는 샘플. 샌드박스에서 돌리고 서명된 영수증을 보관합니다. 등급을 매기지 않고 무엇도 보증하지 않습니다 — 같은 코드가 당신 환경에서 빌드되는지는 측정한 적이 없습니다.
통과한 계약 영수증을 낸 서로 다른 서명 키의 수입니다. 하나면 작성자 혼자이고, 둘 이상이면 다른 사람도 빌드했다는 뜻입니다. 키는 스스로 만드는 것이고 뒤에 등록된 신원이 없으므로, 세는 것은 사람이 아니라 키입니다.
MIT-0
실행 증거
선언된 환경과 서명된 실행을 분리해 두었습니다. 이 샘플이 무엇을 어디서 실행했는지 그대로 볼 수 있습니다.
- 증거 기준
- 서명된 컨트랙트 통과
- 검증 영수증
- 2
- 빌드한 서명 키
- 2
선언된 환경
dart linux x64 dart dart pub
검증 실행 환경
| 환경 | 컨트랙트 | 단계 | 실행일 |
|---|---|---|---|
| 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 |
케이스
HOW- 목표
- Prove that Dart's Digest class retains a mutable reference to its backing byte list, uses reference identity for its bytes property comparison, and that AccumulatorSink only emits a digest upon closing.
- 심벌
-
- Digest
- Digest.bytes
- AccumulatorSink
- Hash.startChunkedConversion
- 환경
- dart
- 생성일
- 2026-08-17T02:04:59Z
컨트랙트
- assert that a Digest constructed with a mutable List holds that list by reference, so modifying the list externally alters the Digest's bytes, its hex string representation, and its hash code
- assert that comparing raw byte lists of two identical Digest objects directly via the == operator evaluates to false due to Dart's list reference identity check, whereas comparing the Digest objects evaluates to true
- assert that AccumulatorSink remains empty when adding chunks via a chunked conversion sink and only receives a single Digest event when the sink is closed
- assert that calling add on a closed chunked conversion sink throws a StateError
파일
- NOTES.md
- csx.json
- pubspec.lock
- pubspec.yaml
- test/contract.dart
소스
# crypto: Digest Mutability, Equality, and AccumulatorSink Stream Finalization
## Prior Knowledge Search
The initial query for `pkg:pub/crypto` using `search_known_solution` returned no exact or compatible matches for this package, only low-confidence compatible fallbacks for unrelated packages (such as rustls, freezegun, and aws_lc_rs).
## Failure Mode
Code expecting `Digest` to copy its backing byte array will run with a silent green build when the source list is mutated, corrupting the digest value, its string representation, and its hash code. Code comparing raw byte arrays directly via `a.bytes == b.bytes` evaluates to false due to Dart's list reference identity check, failing silently with unexpected logic flow, while adding data to a closed chunked conversion sink fails loudly with a `StateError`.
{"case":{"believed":"A Digest constructed from a byte list is immutable and copies the backing list to prevent modification of its hash representation, and comparing two digests' bytes directly via the == operator checks for value equality.","caseId":"case:sha256:4c67daba90b395345bf8934788f39f57285fb92684955c6744c11988f62bd903","contract":["assert that a Digest constructed with a mutable List holds that list by reference, so modifying the list externally alters the Digest's bytes, its hex string representation, and its hash code","assert that comparing raw byte lists of two identical Digest objects directly via the == operator evaluates to false due to Dart's list reference identity check, whereas comparing the Digest objects evaluates to true","assert that AccumulatorSink remains empty when adding chunks via a chunked conversion sink and only receives a single Digest event when the sink is closed","assert that calling add on a closed chunked conversion sink throws a StateError"],"goal":"Prove that Dart's Digest class retains a mutable reference to its backing byte list, uses reference identity for its bytes property comparison, and that AccumulatorSink only emits a digest upon closing.","kind":"HOW","packages":["pkg:pub/crypto@3.0.7","pkg:pub/convert@3.1.2"],"schemaVersion":1,"symbols":["Digest","Digest.bytes","AccumulatorSink","Hash.startChunkedConversion"]},"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/crypto@3.0.7","pkg:pub/convert@3.1.2"],"schemaVersion":1,"symbols":["Digest","Digest.bytes","AccumulatorSink","Hash.startChunkedConversion"],"verifierAdapter":"pub@1"}
# 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"
convert:
dependency: "direct main"
description:
name: convert
sha256: b30acd5944035672bc15c6b7a8b47d773e41e2f17de064350988c5d02adb1c68
url: "https://pub.dev"
source: hosted
version: "3.1.2"
crypto:
dependency: "direct main"
description:
name: crypto
sha256: c8ea0233063ba03258fbcf2ca4d6dadfefe14f02fab57702265467a19f27fadf
url: "https://pub.dev"
source: hosted
version: "3.0.7"
typed_data:
dependency: transitive
description:
name: typed_data
sha256: f9049c039ebfeb4cf7a7104a675823cd72dba8297f264b6637062516699fa006
url: "https://pub.dev"
source: hosted
version: "1.4.0"
sdks:
dart: ">=3.5.0 <4.0.0"
name: crypto_contract
description: Proving core crypto Digest, Hmac, and AccumulatorSink behavior contracts in Dart.
publish_to: none
environment:
sdk: '>=3.0.0 <4.0.0'
dependencies:
crypto: ^3.0.3
convert: ^3.1.1
import 'package:crypto/crypto.dart';
import 'package:convert/convert.dart';
void main() {
// ---------------------------------------------------------------------------
// Contract 1: Digest is mutable when backed by a mutable list.
// A competent model expects Digest to be an immutable object that copies
// its backing byte list to prevent external modification. In reality, it
// stores the passed list by reference, allowing external modifications to
// change the digest bytes, its hex string representation, and its hash code.
// ---------------------------------------------------------------------------
{
final sourceList = [1, 2, 3];
final digest = Digest(sourceList);
// Initial expectations
assert(digest.toString() == '010203');
final initialHashCode = digest.hashCode;
// Mutate the backing list externally
sourceList[0] = 9;
// The digest itself has changed!
assert(digest.bytes[0] == 9);
assert(digest.toString() == '090203');
assert(digest.hashCode != initialHashCode);
}
// ---------------------------------------------------------------------------
// Contract 2: Digest.bytes comparison uses reference identity, whereas Digest == uses element-wise value equality.
// A competent model might expect that comparing the byte lists of two identical
// digests directly via `a.bytes == b.bytes` returns true. In reality, Dart lists
// use reference identity comparison, meaning `bytes == bytes` evaluates to false
// even for identical digests, while `a == b` correctly performs a constant-time
// element-wise comparison.
// ---------------------------------------------------------------------------
{
final digest1 = sha256.convert([1, 2, 3]);
final digest2 = sha256.convert([1, 2, 3]);
// The Digest objects are equal value-wise
assert(digest1 == digest2);
// But their underlying byte lists are not equal under ==
assert(digest1.bytes != digest2.bytes);
}
// ---------------------------------------------------------------------------
// Contract 3: AccumulatorSink remains empty until the input sink is closed.
// A competent model might expect that adding chunks to a chunked conversion
// sink incrementally emits partial digests to the output AccumulatorSink.
// In reality, the accumulator's events list remains empty after calling add()
// and only receives a single Digest event when the chunked sink is closed.
// ---------------------------------------------------------------------------
{
final accumulator = AccumulatorSink<Digest>();
final inputSink = sha256.startChunkedConversion(accumulator);
// Adding data does not emit any Digest events to the accumulator
inputSink.add([1, 2, 3]);
assert(accumulator.events.isEmpty);
inputSink.add([4, 5, 6]);
assert(accumulator.events.isEmpty);
// Only closing the sink finalizes computation and emits the single Digest event
inputSink.close();
assert(accumulator.events.length == 1);
final expectedDigest = sha256.convert([1, 2, 3, 4, 5, 6]);
assert(accumulator.events.single == expectedDigest);
}
// ---------------------------------------------------------------------------
// Contract 4: Calling add() on a closed chunked conversion sink throws a StateError.
// A competent model might expect adding to a closed sink to be silently ignored,
// or that it starts a new hash operation. In reality, it throws a StateError.
// ---------------------------------------------------------------------------
{
final accumulator = AccumulatorSink<Digest>();
final inputSink = sha256.startChunkedConversion(accumulator);
inputSink.add([1, 2, 3]);
inputSink.close();
var threwStateError = false;
try {
inputSink.add([4, 5, 6]);
} on StateError catch (e) {
threwStateError = true;
assert(e.message.contains('Cannot add new events after calling close'));
}
assert(threwStateError);
}
print('ALL CRYPTO CONTRACT ASSERTIONS PASSED');
}