@flop-labs/contracts 0.1.1 → 0.1.2

package/CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.2] - 2026-11-08
+
+### Added
+
+- Generated exact-ID credential receipt, request ID and lookup error contracts,
+  preserving unknown values and exact terminal allocations in raw FLOP units.
+
 ## [0.1.1] - 2026-10-26
 
 ### Added

package/README.md

@@ -3,6 +3,7 @@
 Structural types, JSON Schema exports, and assertion validators for the FLOP
 public HTTP API. Version 0.1.0 covers `listModels`, `getModel`, and JSON
 `createChatCompletion` payloads and streaming frames from `services/rest-gateway/openapi.yaml`.
+The unreleased surface also includes exact-ID credential receipt lookup.
 
 ```sh
 npm install @flop-labs/contracts
@@ -23,6 +24,15 @@ Exports: `Model`, `ModelList` (also `ModelListResponse`), `ModelResponse`,
 and `*Schema` objects. Invalid data throws `ContractValidationError`; its message
 contains the contract name, never the submitted values.
 
+`CredentialReceipt`, `CredentialReceiptError` and `CredentialReceiptRequestId` also
+export `assert*` functions and `*Schema` objects, generated from
+`GET /keys/me/receipts/{request_id}`. A receipt is a current scoped ledger observation;
+it does not rewrite the original completion checkpoint. Exact terminal allocations
+use `settled_spend_raw` decimal strings in raw FLOP units (10^18 raw = 1 FLOP).
+Unavailable values remain null. A pooled channel event is not a separate payment
+or burn transaction for each request. See the client's recovery example for authority,
+state, retention and manual replay rules.
+
 Validation checks structure without coercion, default insertion, or removal of
 fields. Responses allow extensions, including receipt evidence, exactly as the
 source schemas allow. Validating an envelope does not authenticate its evidence,