@receiz/sdk 93.2.0 → 95.0.0

package/docs/proof-memory-and-projections.md

@@ -8,6 +8,8 @@ verify proof object -> project immediately -> admit into durable proof memory ->
 
 The SDK is convenience. It is not authority. The authority remains the sealed artifact, proof bundle, verified append, ownership append, and settlement ledger record.
 
+Kai Klok is the proof object state machine. `kaiPulseEternal` is the pulse unit carried by that state machine. A complete Receiz proof object carries Kai; without its Kai coordinate it is not complete Receiz proof truth.
+
 ## Install
 
 ```bash
@@ -72,6 +74,14 @@ const knownTruth = memory.entries();
 
 Then ask Receiz for verified additions after your known head. Do not ask whether known proof is still true.
 
+## Receiz Account Restore Boundary
+
+Receiz Key, Identity Record, and Identity Seal restore use the same law inside Receiz itself. Current restore artifacts carry `receiz.account.state.v3`, which includes profile/account state, action ledger, calendar events, wallet settlement rows and notes, Sports vault cards, pack purchases, card appends, event proofs, entries, competitions, and tournament state.
+
+That private identity artifact is stronger than a later API response. Restore projects the carried account proof memory first; server/database sync may only mirror missing rows or append verified additions the artifact does not possess. It must not rediscover old truth before use.
+
+Developer apps should apply the same pattern with SDK proof memory: store admitted proof objects locally, paint from that known prefix immediately, then request additions after the known head. The SDK does not mint private Receiz login images or keys; it gives external apps the same admit-once, append-forever operating model.
+
 ## Duplicate Transport Is Safe
 
 If the same proof object arrives again through another transport, the register keeps the first admitted payload and only fills missing fields. This prevents a weaker partial response from dropping known truth.
@@ -114,6 +124,7 @@ Use this order in every integration:
 3. Project display-ready rows from the verified object.
 4. Admit the object into proof memory.
 5. Persist the proof memory snapshot.
-6. Append later verified additions without rediscovering known truth.
+6. Resume from the known Kai/proof head.
+7. Append later verified additions without rediscovering known truth.
 
 This gives users truthful first paint and gives developers a simple integration that stays aligned with Receiz primitives.

package/fixtures/receiz-asset-manifest.example.json

@@ -4,15 +4,18 @@
   "assetType": "proof_object",
   "proof": {
     "kind": "receiz.proof_bundle",
-    "payloadVersion": 1,
+    "payloadVersion": "v2",
     "createdAtMs": 1782400000000,
     "ts": "2026-06-25T00:00:00.000Z",
     "code": "EXAMPLE",
     "slug": "developer-example",
     "verifyPath": "/v/developer-example/EXAMPLE/123456",
     "verifyUrl": "https://receiz.com/v/developer-example/EXAMPLE/123456",
-    "kaiPulseEternal": 123456,
-    "artifactSha256Basis": "sha256:example-artifact-basis"
+    "kaiPulseEternal": "123456",
+    "kaiKlok": "kai:123456",
+    "receizClaimId": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+    "sigilClaimSeed": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+    "artifactSha256Basis": "cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc"
   },
   "owner": {
     "receizSubject": "sub_example_receiz_subject",

package/fixtures/receiz-webhook-event.example.json

@@ -9,9 +9,18 @@
     "appendHash": "sha256:example-append",
     "proofBundle": {
       "kind": "receiz.proof_bundle",
+      "payloadVersion": "v2",
+      "createdAtMs": 1782400000000,
+      "ts": "2026-06-25T00:00:00.000Z",
+      "code": "EXAMPLE",
+      "slug": "developer-example",
       "verifyPath": "/v/developer-example/EXAMPLE/123456",
       "verifyUrl": "https://receiz.com/v/developer-example/EXAMPLE/123456",
-      "kaiPulseEternal": 123456
+      "kaiPulseEternal": "123456",
+      "kaiKlok": "kai:123456",
+      "receizClaimId": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+      "sigilClaimSeed": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+      "artifactSha256Basis": "cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc"
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@receiz/sdk",
-  "version": "93.2.0",
+  "version": "95.0.0",
   "description": "TypeScript SDK for Receiz proof-native artifact, public proof, wallet, sports, and Connect integrations.",
   "type": "module",
   "main": "dist/index.js",