@integraledger/lcp-binding-evm-common 0.15.1 → 0.16.0

package/CHANGELOG.md

@@ -1,5 +1,55 @@
 # @integraledger/lcp-binding-evm-common
 
+## 0.16.0
+
+### Minor Changes
+
+- 2fd5eb2: `isEasValidAsOf` now bounds the validity interval from below.
+  
+  The predicate answers "was this attestation valid AS OF the settlement". It gated on existence, revocation
+  and expiry — three facts that all bound the interval from ABOVE — and never read `att.time`, EAS's creation
+  timestamp, which was decoded and used by nothing. So an attestation minted the day after a settlement was
+  reported valid as of that settlement: backdating by omission, and the one direction an attester can exploit
+  after the fact.
+  
+  `att.time > asOfUnixSeconds` is now a refusal. The boundary is inclusive in the same sense as the other
+  two: revoked or expired AT the as-of second is invalid, attested AT the as-of second is valid.
+  
+  **This changes published behaviour** — a caller passing an attestation newer than its as-of instant now
+  gets `false` where it previously got `true`.
+- bb48020: An RPC outage is no longer reported as a forged signature.
+  
+  `verifyAcceptanceSignature` wrapped the bound verification call in `try { … } catch { return false }`. For
+  `eip191` and `eip712` that closure is pure offline recovery, so a throw genuinely is the signature. For
+  `evm:erc1271` and `evm:erc6492` it is an on-chain call, and viem has already drawn the line inside it: a
+  signature the validator rejects makes the deployless call revert, viem catches its own `VerificationError`
+  and returns `false`, and it rethrows only for an HTTP 429, a timeout, or a node that answered garbage.
+  Swallowing that rethrow turned every rate-limited RPC into `acceptance/bad-signature` — "signature did not
+  verify" — publishing a valid buyer acceptance as a forgery, a verdict the next run reverses. The package's
+  own README argued the opposite doctrine three paragraphs above the code: "'not verified' and 'verified as
+  forged' are different facts."
+  
+  The guard is now scheme-shaped: it wraps the offline recovery only, and an on-chain call's throw
+  propagates. **This changes published behaviour** — a caller of `verifyAcceptanceSignature` or of the
+  `SignatureVerifier` returned by `makeEvmAcceptanceVerifier`, on a smart-account scheme, must now handle a
+  rejection where it previously received `false`. That is the point of the change: the two facts were
+  indistinguishable and one of them was wrong. The `false` verdict for a signature the chain actually
+  rejected is unchanged.
+  
+  `authority` gains no behaviour change, only the contract in writing: `SignatureVerifier.verify` returning
+  `false` means CHECKED AND INVALID, and `verifyAcceptance` deliberately does not catch a rejection from the
+  port, because `acceptance/bad-signature` is a claim about the record and an unreachable node has made none.
+  
+  The replaced test asserted the defect outright — "an on-chain call that throws is reported as false, not
+  propagated (a verifier must not crash)".
+
+### Patch Changes
+
+- Updated dependencies [bb48020]
+  - @integraledger/lcp-authority@0.16.0
+  - @integraledger/lcp-binding-core@0.16.0
+  - @integraledger/lcp-kernel@0.16.0
+
 ## 0.15.1
 
 ### Patch Changes
@@ -100,8 +150,8 @@
   `buildEip3009TypedData` has been here since the canonical EVM binding shipped, and nothing beside it could
   answer whether a given authorization was actually signed by the account it names. So a seller surface
   holding a payer's credential had three bad options: take the signature on trust until settlement, grow a
-  viem dependency of its own, or reimplement recovery. `seller-mpp` needs exactly this for the 2026-08-24
-  audit's C-28, and `seller-x402` already reaches here for `makeEvmAcceptanceVerifier` — the commons owns EVM
+  viem dependency of its own, or reimplement recovery. A seller MPP surface needs exactly this to check a payer's
+  authorization before settlement, and `seller-x402` already reaches here for `makeEvmAcceptanceVerifier` — the commons owns EVM
   crypto, and this is the piece that was missing.
 
   ⭐ **`ecrecover`, because that is what the TOKEN does.** `FiatTokenV2.transferWithAuthorization` recovers the
@@ -188,7 +238,7 @@ and a large number of documentation claims were corrected against the host speci
 First public release.
 
 `0.9.0` is deliberate: this is a release candidate for 1.0, not a preview. The implementation is complete
-against LCP v1.38 and certified by the conformance corpus, and the remaining distance to 1.0 is the
+against the published LCP specification and certified by the conformance corpus, and the remaining distance to 1.0 is the
 specification's own — the standard is still moving through its steering committee, and this package will not
 claim a stability its protocol has not yet promised.
 

package/README.md

@@ -39,13 +39,20 @@ const ok = await verifyAcceptanceSignature(acceptance);
 const onChain = await verifyAcceptanceSignature(acceptance, smartAccountOpts);
 ```
 
-## Three outcomes, kept distinct
+## Four outcomes, kept distinct
 
 A malformed **configuration** throws — an absent chain id or a missing client is an integration error the
 caller must fix. A malformed **record** throws — an unparseable timestamp is a different fact from a
 forged signature, and letting it hide behind a bad-signature verdict would lose that. A malformed
 **signature** returns `false` — recovery over forged bytes fails deep in curve math, and a verifier that
-crashes on a forgery cannot report the forgery.
+crashes on a forgery cannot report the forgery. A chain that could not **answer** throws — an HTTP 429 or
+a timeout says nothing whatever about the signature, and reporting it as `false` publishes a valid buyer
+acceptance as a forgery, a verdict the next run reverses.
+
+The last two are told apart by the scheme, not by the error class: `eip191` and `eip712` verify by pure
+offline recovery, so a throw there is the signature; `erc1271` and `erc6492` verify on-chain, and viem
+already returns `false` for a signature its validator rejects and throws only when the node could not be
+reached.
 
 Collapsing any two of those into one another is how a verifier ends up reporting the wrong thing about
 the one case it exists for.

package/dist/eas.d.ts

@@ -84,10 +84,19 @@ export interface EasAttestation {
 /** Normalize viem's decoded tuple into an `EasAttestation` (idempotent field mapping; addresses lowercased). */
 export declare function decodeEasAttestation(raw: RawEasAttestation): EasAttestation;
 /**
- * Was this attestation valid AS OF `asOfUnixSeconds`? — it must exist, not have been revoked at/before the
- * as-of time (revocationTime 0 = never revoked), and not have expired by then (expirationTime 0 = no expiry).
- * EAS has no historical query, so a live read yields today's revocationTime; a settlement-time snapshot of the
- * uid is the authority (same as the Bitstring status-list as-of rule) — this predicate states the semantics.
+ * Was this attestation valid AS OF `asOfUnixSeconds`? — it must exist, must already have been ATTESTED by
+ * then, must not have been revoked at/before the as-of time (revocationTime 0 = never revoked), and must
+ * not have expired by then (expirationTime 0 = no expiry). EAS has no historical query, so a live read
+ * yields today's revocationTime; a settlement-time snapshot of the uid is the authority (same as the
+ * Bitstring status-list as-of rule) — this predicate states the semantics.
+ *
+ * ⛔ **The `time` gate bounds the interval from BELOW, and it was missing until 2026-09-03.** Revocation
+ * and expiry both bound it from above, so an attestation minted the day AFTER a settlement was reported
+ * "valid as of" that settlement — backdating by omission, and the one direction an attester can exploit
+ * after the fact. `time` was decoded and read by nothing.
+ *
+ * All three boundaries are inclusive in the same sense: revoked or expired AT the as-of second is invalid,
+ * attested AT the as-of second is valid. The attestation was live for exactly that instant.
  */
 export declare function isEasValidAsOf(att: EasAttestation, asOfUnixSeconds: bigint): boolean;
 /** Read + normalize an EAS attestation by uid, over the injected viem client (imperative shell). */

package/dist/eas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"eas.d.ts","sourceRoot":"","sources":["../src/eas.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAE9C,2GAA2G;AAC3G,eAAO,MAAM,uBAAuB;aAEhC,IAAI,EAAE,UAAU;aAChB,IAAI,EAAE,gBAAgB;aACtB,eAAe,EAAE,MAAM;aACvB,MAAM;iBAAK,IAAI,EAAE,KAAK;iBAAE,IAAI,EAAE,SAAS;;aACvC,OAAO;iBAEH,IAAI,EAAE,OAAO;iBACb,IAAI,EAAE,EAAE;iBACR,UAAU;qBACN,IAAI,EAAE,KAAK;qBAAE,IAAI,EAAE,SAAS;;qBAC5B,IAAI,EAAE,QAAQ;qBAAE,IAAI,EAAE,SAAS;;qBAC/B,IAAI,EAAE,MAAM;qBAAE,IAAI,EAAE,QAAQ;;qBAC5B,IAAI,EAAE,gBAAgB;qBAAE,IAAI,EAAE,QAAQ;;qBACtC,IAAI,EAAE,gBAAgB;qBAAE,IAAI,EAAE,QAAQ;;qBACtC,IAAI,EAAE,QAAQ;qBAAE,IAAI,EAAE,SAAS;;qBAC/B,IAAI,EAAE,WAAW;qBAAE,IAAI,EAAE,SAAS;;qBAClC,IAAI,EAAE,UAAU;qBAAE,IAAI,EAAE,SAAS;;qBACjC,IAAI,EAAE,WAAW;qBAAE,IAAI,EAAE,MAAM;;qBAC/B,IAAI,EAAE,MAAM;qBAAE,IAAI,EAAE,OAAO;;;EAK7B,CAAC;AAEX,8FAA8F;AAC9F,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,GAAG,CAAC;IACT,MAAM,EAAE,GAAG,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,GAAG,CAAC;IACZ,SAAS,EAAE,GAAG,CAAC;IACf,QAAQ,EAAE,GAAG,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,GAAG,CAAC;CACX;AAED,wGAAwG;AACxG,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,GAAG,CAAC;IACT,MAAM,EAAE,GAAG,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,GAAG,CAAC;IACZ,SAAS,EAAE,GAAG,CAAC;IACf,QAAQ,EAAE,GAAG,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,GAAG,CAAC;IACV,sGAAsG;IACtG,MAAM,EAAE,OAAO,CAAC;CACjB;AAKD,gHAAgH;AAChH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,iBAAiB,GAAG,cAAc,CAc3E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,cAAc,EACnB,eAAe,EAAE,MAAM,GACtB,OAAO,CAOT;AAED,oGAAoG;AACpG,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACnC,OAAO,CAAC,cAAc,CAAC,CAQzB"}
+{"version":3,"file":"eas.d.ts","sourceRoot":"","sources":["../src/eas.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAE9C,2GAA2G;AAC3G,eAAO,MAAM,uBAAuB;aAEhC,IAAI,EAAE,UAAU;aAChB,IAAI,EAAE,gBAAgB;aACtB,eAAe,EAAE,MAAM;aACvB,MAAM;iBAAK,IAAI,EAAE,KAAK;iBAAE,IAAI,EAAE,SAAS;;aACvC,OAAO;iBAEH,IAAI,EAAE,OAAO;iBACb,IAAI,EAAE,EAAE;iBACR,UAAU;qBACN,IAAI,EAAE,KAAK;qBAAE,IAAI,EAAE,SAAS;;qBAC5B,IAAI,EAAE,QAAQ;qBAAE,IAAI,EAAE,SAAS;;qBAC/B,IAAI,EAAE,MAAM;qBAAE,IAAI,EAAE,QAAQ;;qBAC5B,IAAI,EAAE,gBAAgB;qBAAE,IAAI,EAAE,QAAQ;;qBACtC,IAAI,EAAE,gBAAgB;qBAAE,IAAI,EAAE,QAAQ;;qBACtC,IAAI,EAAE,QAAQ;qBAAE,IAAI,EAAE,SAAS;;qBAC/B,IAAI,EAAE,WAAW;qBAAE,IAAI,EAAE,SAAS;;qBAClC,IAAI,EAAE,UAAU;qBAAE,IAAI,EAAE,SAAS;;qBACjC,IAAI,EAAE,WAAW;qBAAE,IAAI,EAAE,MAAM;;qBAC/B,IAAI,EAAE,MAAM;qBAAE,IAAI,EAAE,OAAO;;;EAK7B,CAAC;AAEX,8FAA8F;AAC9F,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,GAAG,CAAC;IACT,MAAM,EAAE,GAAG,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,GAAG,CAAC;IACZ,SAAS,EAAE,GAAG,CAAC;IACf,QAAQ,EAAE,GAAG,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,GAAG,CAAC;CACX;AAED,wGAAwG;AACxG,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,GAAG,CAAC;IACT,MAAM,EAAE,GAAG,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,GAAG,CAAC;IACZ,SAAS,EAAE,GAAG,CAAC;IACf,QAAQ,EAAE,GAAG,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,GAAG,CAAC;IACV,sGAAsG;IACtG,MAAM,EAAE,OAAO,CAAC;CACjB;AAKD,gHAAgH;AAChH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,iBAAiB,GAAG,cAAc,CAc3E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,cAAc,EACnB,eAAe,EAAE,MAAM,GACtB,OAAO,CAQT;AAED,oGAAoG;AACpG,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACnC,OAAO,CAAC,cAAc,CAAC,CAQzB"}

package/dist/eas.js

@@ -43,14 +43,25 @@ export function decodeEasAttestation(raw) {
     };
 }
 /**
- * Was this attestation valid AS OF `asOfUnixSeconds`? — it must exist, not have been revoked at/before the
- * as-of time (revocationTime 0 = never revoked), and not have expired by then (expirationTime 0 = no expiry).
- * EAS has no historical query, so a live read yields today's revocationTime; a settlement-time snapshot of the
- * uid is the authority (same as the Bitstring status-list as-of rule) — this predicate states the semantics.
+ * Was this attestation valid AS OF `asOfUnixSeconds`? — it must exist, must already have been ATTESTED by
+ * then, must not have been revoked at/before the as-of time (revocationTime 0 = never revoked), and must
+ * not have expired by then (expirationTime 0 = no expiry). EAS has no historical query, so a live read
+ * yields today's revocationTime; a settlement-time snapshot of the uid is the authority (same as the
+ * Bitstring status-list as-of rule) — this predicate states the semantics.
+ *
+ * ⛔ **The `time` gate bounds the interval from BELOW, and it was missing until 2026-09-03.** Revocation
+ * and expiry both bound it from above, so an attestation minted the day AFTER a settlement was reported
+ * "valid as of" that settlement — backdating by omission, and the one direction an attester can exploit
+ * after the fact. `time` was decoded and read by nothing.
+ *
+ * All three boundaries are inclusive in the same sense: revoked or expired AT the as-of second is invalid,
+ * attested AT the as-of second is valid. The attestation was live for exactly that instant.
  */
 export function isEasValidAsOf(att, asOfUnixSeconds) {
     if (!att.exists)
         return false;
+    if (att.time > asOfUnixSeconds)
+        return false;
     if (att.revocationTime !== 0n && att.revocationTime <= asOfUnixSeconds)
         return false;
     if (att.expirationTime !== 0n && att.expirationTime <= asOfUnixSeconds)

package/dist/eas.js.map

@@ -1 +1 @@
-{"version":3,"file":"eas.js","sourceRoot":"","sources":["../src/eas.ts"],"names":[],"mappings":"AAWA,2GAA2G;AAC3G,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,gBAAgB;QACtB,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC1C,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,EAAE;gBACR,UAAU,EAAE;oBACV,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE;oBAChC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;oBACnC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAChC,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC1C,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC1C,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;oBACnC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;oBACtC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE;oBACrC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE;oBACnC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE;iBAChC;aACF;SACF;KACF;CACO,CAAC;AAgCX,MAAM,QAAQ,GACZ,oEAAoE,CAAC;AAEvE,gHAAgH;AAChH,MAAM,UAAU,oBAAoB,CAAC,GAAsB;IACzD,OAAO;QACL,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,WAAW,EAAS;QACjC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,WAAW,EAAS;QACvC,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,cAAc,EAAE,GAAG,CAAC,cAAc;QAClC,cAAc,EAAE,GAAG,CAAC,cAAc;QAClC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,WAAW,EAAS;QACvC,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,WAAW,EAAS;QAC7C,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAS;QAC3C,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,WAAW,EAAS;QACnC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,QAAQ;KAC3C,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,GAAmB,EACnB,eAAuB;IAEvB,IAAI,CAAC,GAAG,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC9B,IAAI,GAAG,CAAC,cAAc,KAAK,EAAE,IAAI,GAAG,CAAC,cAAc,IAAI,eAAe;QACpE,OAAO,KAAK,CAAC;IACf,IAAI,GAAG,CAAC,cAAc,KAAK,EAAE,IAAI,GAAG,CAAC,cAAc,IAAI,eAAe;QACpE,OAAO,KAAK,CAAC;IACf,OAAO,IAAI,CAAC;AACd,CAAC;AAED,oGAAoG;AACpG,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAoB,EACpB,MAAoC;IAEpC,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC;QACrC,OAAO,EAAE,MAAM,CAAC,GAAU;QAC1B,GAAG,EAAE,uBAAuB;QAC5B,YAAY,EAAE,gBAAgB;QAC9B,IAAI,EAAE,CAAC,MAAM,CAAC,GAAU,CAAC;KAC1B,CAAC,CAAsB,CAAC;IACzB,OAAO,oBAAoB,CAAC,GAAG,CAAC,CAAC;AACnC,CAAC"}
+{"version":3,"file":"eas.js","sourceRoot":"","sources":["../src/eas.ts"],"names":[],"mappings":"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"}

package/dist/erc1271.d.ts

@@ -106,7 +106,7 @@ export interface AcceptanceVerifyOpts {
  * Verify an acceptance signature. EOA schemes recover offline; smart-account schemes verify on-chain through
  * `opts.client`. Returns a boolean (the port contract).
  *
- * THREE OUTCOMES, and keeping them distinct is the whole point:
+ * FOUR OUTCOMES, and keeping them distinct is the whole point:
  *
  *  - **A malformed CONFIGURATION throws** (absent `chainId` for the envelope, absent client for a smart
  *    account) — an integration error the caller must fix, not a fact about the record.
@@ -118,9 +118,18 @@ export interface AcceptanceVerifyOpts {
  *    curve math ("Point is not on curve"), and a verifier that crashes on a forgery cannot report the
  *    forgery — the adversarial case is exactly the one verification exists for. An unrecoverable signature
  *    is definitively not a valid signature, so the walk records an honest `failed(verification-failure)`.
+ *  - **A chain that could not ANSWER throws.** ⛔ This one used to be swallowed as `false`, and it is the
+ *    reason the guard is now scheme-shaped rather than wrapped around everything. For an EOA scheme the
+ *    bound closure is pure recovery with no I/O, so a throw there IS the signature. For `evm:erc1271` and
+ *    `evm:erc6492` it is an on-chain call, and viem has already drawn this line inside it: a signature the
+ *    validator rejects makes the deployless call revert, viem catches its own `VerificationError` and
+ *    returns `false`, and it rethrows only for an HTTP 429, a timeout, or a node that answered garbage.
+ *    Collapsing that into `false` published a valid buyer acceptance as `acceptance/bad-signature` —
+ *    "signature did not verify" — for as long as an RPC was rate-limited, a verdict that reverses on the
+ *    next run. "Not verified" and "verified as forged" are different facts.
  *
- * The guard therefore wraps ONLY the recovery/verification calls. Widening it to cover the normalization
- * above would collapse the second outcome into the third.
+ * The guard therefore wraps ONLY the OFFLINE recovery calls. Widening it over the normalization above
+ * collapses the second outcome into the third; widening it over the on-chain call collapses the fourth.
  */
 export declare function verifyAcceptanceSignature(input: AcceptanceSignatureInput, opts?: AcceptanceVerifyOpts): Promise<boolean>;
 /**

package/dist/erc1271.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"erc1271.d.ts","sourceRoot":"","sources":["../src/erc1271.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"erc1271.d.ts","sourceRoot":"","sources":["../src/erc1271.ts"],"names":[],"mappings":"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"}

package/dist/erc1271.js

@@ -63,7 +63,7 @@ export function isEvmPayloadType(v) {
  * Verify an acceptance signature. EOA schemes recover offline; smart-account schemes verify on-chain through
  * `opts.client`. Returns a boolean (the port contract).
  *
- * THREE OUTCOMES, and keeping them distinct is the whole point:
+ * FOUR OUTCOMES, and keeping them distinct is the whole point:
  *
  *  - **A malformed CONFIGURATION throws** (absent `chainId` for the envelope, absent client for a smart
  *    account) — an integration error the caller must fix, not a fact about the record.
@@ -75,15 +75,27 @@ export function isEvmPayloadType(v) {
  *    curve math ("Point is not on curve"), and a verifier that crashes on a forgery cannot report the
  *    forgery — the adversarial case is exactly the one verification exists for. An unrecoverable signature
  *    is definitively not a valid signature, so the walk records an honest `failed(verification-failure)`.
+ *  - **A chain that could not ANSWER throws.** ⛔ This one used to be swallowed as `false`, and it is the
+ *    reason the guard is now scheme-shaped rather than wrapped around everything. For an EOA scheme the
+ *    bound closure is pure recovery with no I/O, so a throw there IS the signature. For `evm:erc1271` and
+ *    `evm:erc6492` it is an on-chain call, and viem has already drawn this line inside it: a signature the
+ *    validator rejects makes the deployless call revert, viem catches its own `VerificationError` and
+ *    returns `false`, and it rethrows only for an HTTP 429, a timeout, or a node that answered garbage.
+ *    Collapsing that into `false` published a valid buyer acceptance as `acceptance/bad-signature` —
+ *    "signature did not verify" — for as long as an RPC was rate-limited, a verdict that reverses on the
+ *    next run. "Not verified" and "verified as forged" are different facts.
  *
- * The guard therefore wraps ONLY the recovery/verification calls. Widening it to cover the normalization
- * above would collapse the second outcome into the third.
+ * The guard therefore wraps ONLY the OFFLINE recovery calls. Widening it over the normalization above
+ * collapses the second outcome into the third; widening it over the on-chain call collapses the fourth.
  */
 export async function verifyAcceptanceSignature(input, opts) {
     // Normalization + configuration: OUTSIDE the guard, so both stay loud.
-    const recover = prepareRecovery(input, opts);
+    const { run, offline } = prepareRecovery(input, opts);
+    // On-chain: viem's verdict is the whole answer, and anything it throws is the chain failing to give one.
+    if (!offline)
+        return await run();
     try {
-        return await recover();
+        return await run();
     }
     catch {
         return false; // the signature itself did not recover — not a valid signature
@@ -96,6 +108,12 @@ class ConfigurationError extends Error {
  * Normalize the record's fields and bind the scheme-appropriate recovery call, returning it UNEXECUTED so
  * the caller can guard the recovery alone. Anything wrong with the configuration or the record's own fields
  * throws from here, before the guard exists.
+ *
+ * `offline` says whether the bound call does any I/O, and it is the caller's whole basis for deciding
+ * whether a throw is a fact about the signature or a fact about the network. It is derived from the scheme
+ * here — where the branch is already taken — rather than sniffed off an error class at the catch site: an
+ * allowlist of transport-error names is a subject set that goes stale silently, and getting it wrong in
+ * that direction reports a forgery.
  */
 function prepareRecovery(input, opts) {
     // A signer that is not an address is a malformed RECORD, not a forgery — thrown here, before the guard,
@@ -119,28 +137,40 @@ function prepareRecovery(input, opts) {
             // `opts` (not `opts?.`): the chainId gate above already proved it defined — an optional chain here
             // would be dead syntax guarding an impossible state, and the mutation run flags it as equivalent.
             const client = requireClient(opts.client, input.scheme);
-            return () => client.verifyTypedData({ address: signer, ...typedData, signature });
+            return {
+                offline: false,
+                run: () => client.verifyTypedData({ address: signer, ...typedData, signature }),
+            };
         }
-        return async () => {
-            const recovered = await recoverTypedDataAddress({
-                ...typedData,
-                signature,
-            });
-            return recovered.toLowerCase() === signer.toLowerCase();
+        return {
+            offline: true,
+            run: async () => {
+                const recovered = await recoverTypedDataAddress({
+                    ...typedData,
+                    signature,
+                });
+                return recovered.toLowerCase() === signer.toLowerCase();
+            },
         };
     }
     // payloadType === "atrHash": the raw 32-byte atrHash signed as a personal_sign message.
     const raw = assertBytes32(input.atrHash); // throws loud on a malformed atrHash
     if (isContract) {
         const client = requireClient(opts?.client, input.scheme);
-        return () => client.verifyMessage({ address: signer, message: { raw }, signature });
+        return {
+            offline: false,
+            run: () => client.verifyMessage({ address: signer, message: { raw }, signature }),
+        };
     }
-    return async () => {
-        const recovered = await recoverMessageAddress({
-            message: { raw },
-            signature,
-        });
-        return recovered.toLowerCase() === signer.toLowerCase();
+    return {
+        offline: true,
+        run: async () => {
+            const recovered = await recoverMessageAddress({
+                message: { raw },
+                signature,
+            });
+            return recovered.toLowerCase() === signer.toLowerCase();
+        },
     };
 }
 function requireClient(client, scheme) {

package/dist/erc1271.js.map

@@ -1 +1 @@
-{"version":3,"file":"erc1271.js","sourceRoot":"","sources":["../src/erc1271.ts"],"names":[],"mappings":"AAyBA,OAAO,EAEL,SAAS,EAET,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,MAAM,CAAC;AACd,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,aAAa,EAAqB,MAAM,cAAc,CAAC;AAEhE,8CAA8C;AAC9C,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,UAAU,EAAE;QACV,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;QACpC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE;KACtC;CACO,CAAC;AAEX,iHAAiH;AACjH,MAAM,CAAC,MAAM,sBAAsB,GAAG,gBAAgB,CAAC;AACvD;;qDAEqD;AACrD,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,CAAC;AAU7C;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAgB;IACnD,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAChC,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,+DAA+D,QAAQ,GAAG,CAC3E,CAAC;IACJ,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,wBAAwB,CAAC,CAIxC;IACC,OAAO;QACL,MAAM,EAAE;YACN,IAAI,EAAE,sBAAsB;YAC5B,OAAO,EAAE,yBAAyB;YAClC,OAAO,EAAE,CAAC,CAAC,OAAO;SACnB;QACD,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EAAE,YAAY;QACzB,OAAO,EAAE,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE;KACrE,CAAC;AACJ,CAAC;AAED,+FAA+F;AAC/F,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,YAAY;IACZ,YAAY;IACZ,aAAa;IACb,aAAa;CACL,CAAC;AAMX;uGACuG;AACvG,MAAM,UAAU,qBAAqB,CAAC,CAAS;IAC7C,OAAQ,sBAA4C,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,sEAAsE;AACtE,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,SAAS;IACT,4BAA4B;CACpB,CAAC;AAOX,iGAAiG;AACjG,MAAM,UAAU,gBAAgB,CAAC,CAAS;IACxC,OAAQ,iBAAuC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AAC9D,CAAC;AAwBD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,KAA+B,EAC/B,IAA2B;IAE3B,uEAAuE;IACvE,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC7C,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,EAAE,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC,CAAC,+DAA+D;IAC/E,CAAC;AACH,CAAC;AAED,6DAA6D;AAC7D,MAAM,kBAAmB,SAAQ,KAAK;CAAG;AAEzC;;;;GAIG;AACH,SAAS,eAAe,CACtB,KAA+B,EAC/B,IAA2B;IAE3B,wGAAwG;IACxG,wGAAwG;IACxG,wEAAwE;IACxE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CACb,oFAAoF,KAAK,CAAC,MAAM,GAAG,CACpG,CAAC;IACJ,MAAM,MAAM,GAAG,KAAK,CAAC,MAAa,CAAC;IACnC,MAAM,UAAU,GACd,KAAK,CAAC,MAAM,KAAK,aAAa,IAAI,KAAK,CAAC,MAAM,KAAK,aAAa,CAAC;IACnE,MAAM,SAAS,GAAG,KAAK,CAAC,SAAgB,CAAC;IAEzC,IAAI,KAAK,CAAC,WAAW,KAAK,4BAA4B,EAAE,CAAC;QACvD,IAAI,IAAI,EAAE,OAAO,KAAK,SAAS;YAC7B,MAAM,IAAI,kBAAkB,CAC1B,2FAA2F,CAC5F,CAAC;QACJ,qGAAqG;QACrG,MAAM,SAAS,GAAG,wBAAwB,CAAC;YACzC,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,QAAQ,EAAE,oBAAoB,CAAC,KAAK,CAAC,QAAQ,CAAC;YAC9C,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC,CAAC;QACH,IAAI,UAAU,EAAE,CAAC;YACf,mGAAmG;YACnG,kGAAkG;YAClG,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;YACxD,OAAO,GAAG,EAAE,CACV,MAAM,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC;QACzE,CAAC;QACD,OAAO,KAAK,IAAI,EAAE;YAChB,MAAM,SAAS,GAAG,MAAM,uBAAuB,CAAC;gBAC9C,GAAG,SAAS;gBACZ,SAAS;aACV,CAAC,CAAC;YACH,OAAO,SAAS,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,WAAW,EAAE,CAAC;QAC1D,CAAC,CAAC;IACJ,CAAC;IAED,wFAAwF;IACxF,MAAM,GAAG,GAAG,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,qCAAqC;IAC/E,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACzD,OAAO,GAAG,EAAE,CACV,MAAM,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,KAAK,IAAI,EAAE;QAChB,MAAM,SAAS,GAAG,MAAM,qBAAqB,CAAC;YAC5C,OAAO,EAAE,EAAE,GAAG,EAAE;YAChB,SAAS;SACV,CAAC,CAAC;QACH,OAAO,SAAS,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,WAAW,EAAE,CAAC;IAC1D,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CACpB,MAAgC,EAChC,MAAc;IAEd,IAAI,MAAM,KAAK,SAAS;QACtB,MAAM,IAAI,kBAAkB,CAC1B,GAAG,MAAM,gHAAgH,CAC1H,CAAC;IACJ,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,yBAAyB,CACvC,IAA2B;IAE3B,OAAO;QACL,iFAAiF;QACjF,8EAA8E;QAC9E,MAAM,EAAE,KAAK,EAAE,UAA4B,EAAoB,EAAE;YAC/D,IAAI,CAAC,qBAAqB,CAAC,UAAU,CAAC,MAAM,CAAC;gBAC3C,MAAM,IAAI,kBAAkB,CAC1B,WAAW,UAAU,CAAC,MAAM,sCAAsC,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,6DAA6D,CACjK,CAAC;YACJ,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,WAAW,CAAC;gBAC3C,MAAM,IAAI,kBAAkB,CAC1B,gBAAgB,UAAU,CAAC,WAAW,wCAAwC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC9G,CAAC;YACJ,OAAO,yBAAyB,CAC9B;gBACE,OAAO,EAAE,UAAU,CAAC,OAAO;gBAC3B,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,SAAS,EAAE,UAAU,CAAC,SAAS;gBAC/B,QAAQ,EAAE,UAAU,CAAC,QAAQ;gBAC7B,WAAW,EAAE,UAAU,CAAC,WAAW;aACpC,EACD,IAAI,CACL,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAe;IAChD,MAAM,OAAO,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAChD,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,aAAa,EAAE,CAAC,OAKf,EAAgB,EAAE,CACjB,OAAO,CAAC,aAAa,CACnB,OAAsD,CACvD;KACJ,CAAC;AACJ,CAAC"}
+{"version":3,"file":"erc1271.js","sourceRoot":"","sources":["../src/erc1271.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@integraledger/lcp-binding-evm-common",
-  "version": "0.15.1",
+  "version": "0.16.0",
   "description": "Shared EVM machinery for LCP rail bindings: typed-data construction and signature verification.",
   "keywords": [
     "lcp",
@@ -43,9 +43,9 @@
   },
   "homepage": "https://github.com/IntegraLedger/integra-protocol/tree/main/packages/binding-evm-common#readme",
   "dependencies": {
-    "@integraledger/lcp-authority": "0.15.1",
-    "@integraledger/lcp-binding-core": "0.15.1",
-    "@integraledger/lcp-kernel": "0.15.1",
+    "@integraledger/lcp-authority": "0.16.0",
+    "@integraledger/lcp-binding-core": "0.16.0",
+    "@integraledger/lcp-kernel": "0.16.0",
     "viem": "2.55.19"
   },
   "devDependencies": {

package/src/eas.ts

@@ -88,16 +88,26 @@ export function decodeEasAttestation(raw: RawEasAttestation): EasAttestation {
 }
 
 /**
- * Was this attestation valid AS OF `asOfUnixSeconds`? — it must exist, not have been revoked at/before the
- * as-of time (revocationTime 0 = never revoked), and not have expired by then (expirationTime 0 = no expiry).
- * EAS has no historical query, so a live read yields today's revocationTime; a settlement-time snapshot of the
- * uid is the authority (same as the Bitstring status-list as-of rule) — this predicate states the semantics.
+ * Was this attestation valid AS OF `asOfUnixSeconds`? — it must exist, must already have been ATTESTED by
+ * then, must not have been revoked at/before the as-of time (revocationTime 0 = never revoked), and must
+ * not have expired by then (expirationTime 0 = no expiry). EAS has no historical query, so a live read
+ * yields today's revocationTime; a settlement-time snapshot of the uid is the authority (same as the
+ * Bitstring status-list as-of rule) — this predicate states the semantics.
+ *
+ * ⛔ **The `time` gate bounds the interval from BELOW, and it was missing until 2026-09-03.** Revocation
+ * and expiry both bound it from above, so an attestation minted the day AFTER a settlement was reported
+ * "valid as of" that settlement — backdating by omission, and the one direction an attester can exploit
+ * after the fact. `time` was decoded and read by nothing.
+ *
+ * All three boundaries are inclusive in the same sense: revoked or expired AT the as-of second is invalid,
+ * attested AT the as-of second is valid. The attestation was live for exactly that instant.
  */
 export function isEasValidAsOf(
   att: EasAttestation,
   asOfUnixSeconds: bigint,
 ): boolean {
   if (!att.exists) return false;
+  if (att.time > asOfUnixSeconds) return false;
   if (att.revocationTime !== 0n && att.revocationTime <= asOfUnixSeconds)
     return false;
   if (att.expirationTime !== 0n && att.expirationTime <= asOfUnixSeconds)

package/src/erc1271.ts

@@ -148,7 +148,7 @@ export interface AcceptanceVerifyOpts {
  * Verify an acceptance signature. EOA schemes recover offline; smart-account schemes verify on-chain through
  * `opts.client`. Returns a boolean (the port contract).
  *
- * THREE OUTCOMES, and keeping them distinct is the whole point:
+ * FOUR OUTCOMES, and keeping them distinct is the whole point:
  *
  *  - **A malformed CONFIGURATION throws** (absent `chainId` for the envelope, absent client for a smart
  *    account) — an integration error the caller must fix, not a fact about the record.
@@ -160,18 +160,29 @@ export interface AcceptanceVerifyOpts {
  *    curve math ("Point is not on curve"), and a verifier that crashes on a forgery cannot report the
  *    forgery — the adversarial case is exactly the one verification exists for. An unrecoverable signature
  *    is definitively not a valid signature, so the walk records an honest `failed(verification-failure)`.
+ *  - **A chain that could not ANSWER throws.** ⛔ This one used to be swallowed as `false`, and it is the
+ *    reason the guard is now scheme-shaped rather than wrapped around everything. For an EOA scheme the
+ *    bound closure is pure recovery with no I/O, so a throw there IS the signature. For `evm:erc1271` and
+ *    `evm:erc6492` it is an on-chain call, and viem has already drawn this line inside it: a signature the
+ *    validator rejects makes the deployless call revert, viem catches its own `VerificationError` and
+ *    returns `false`, and it rethrows only for an HTTP 429, a timeout, or a node that answered garbage.
+ *    Collapsing that into `false` published a valid buyer acceptance as `acceptance/bad-signature` —
+ *    "signature did not verify" — for as long as an RPC was rate-limited, a verdict that reverses on the
+ *    next run. "Not verified" and "verified as forged" are different facts.
  *
- * The guard therefore wraps ONLY the recovery/verification calls. Widening it to cover the normalization
- * above would collapse the second outcome into the third.
+ * The guard therefore wraps ONLY the OFFLINE recovery calls. Widening it over the normalization above
+ * collapses the second outcome into the third; widening it over the on-chain call collapses the fourth.
  */
 export async function verifyAcceptanceSignature(
   input: AcceptanceSignatureInput,
   opts?: AcceptanceVerifyOpts,
 ): Promise<boolean> {
   // Normalization + configuration: OUTSIDE the guard, so both stay loud.
-  const recover = prepareRecovery(input, opts);
+  const { run, offline } = prepareRecovery(input, opts);
+  // On-chain: viem's verdict is the whole answer, and anything it throws is the chain failing to give one.
+  if (!offline) return await run();
   try {
-    return await recover();
+    return await run();
   } catch {
     return false; // the signature itself did not recover — not a valid signature
   }
@@ -184,11 +195,17 @@ class ConfigurationError extends Error {}
  * Normalize the record's fields and bind the scheme-appropriate recovery call, returning it UNEXECUTED so
  * the caller can guard the recovery alone. Anything wrong with the configuration or the record's own fields
  * throws from here, before the guard exists.
+ *
+ * `offline` says whether the bound call does any I/O, and it is the caller's whole basis for deciding
+ * whether a throw is a fact about the signature or a fact about the network. It is derived from the scheme
+ * here — where the branch is already taken — rather than sniffed off an error class at the catch site: an
+ * allowlist of transport-error names is a subject set that goes stale silently, and getting it wrong in
+ * that direction reports a forgery.
  */
 function prepareRecovery(
   input: AcceptanceSignatureInput,
   opts?: AcceptanceVerifyOpts,
-): () => Promise<boolean> {
+): { run: () => Promise<boolean>; offline: boolean } {
   // A signer that is not an address is a malformed RECORD, not a forgery — thrown here, before the guard,
   // for the same reason rfc3339ToUnixSeconds throws: recovery over it would fail deep in viem and read as
   // a bad-signature verdict about a signature nobody could have examined.
@@ -216,15 +233,21 @@ function prepareRecovery(
       // `opts` (not `opts?.`): the chainId gate above already proved it defined — an optional chain here
       // would be dead syntax guarding an impossible state, and the mutation run flags it as equivalent.
       const client = requireClient(opts.client, input.scheme);
-      return () =>
-        client.verifyTypedData({ address: signer, ...typedData, signature });
+      return {
+        offline: false,
+        run: () =>
+          client.verifyTypedData({ address: signer, ...typedData, signature }),
+      };
     }
-    return async () => {
-      const recovered = await recoverTypedDataAddress({
-        ...typedData,
-        signature,
-      });
-      return recovered.toLowerCase() === signer.toLowerCase();
+    return {
+      offline: true,
+      run: async () => {
+        const recovered = await recoverTypedDataAddress({
+          ...typedData,
+          signature,
+        });
+        return recovered.toLowerCase() === signer.toLowerCase();
+      },
     };
   }
 
@@ -232,15 +255,21 @@ function prepareRecovery(
   const raw = assertBytes32(input.atrHash); // throws loud on a malformed atrHash
   if (isContract) {
     const client = requireClient(opts?.client, input.scheme);
-    return () =>
-      client.verifyMessage({ address: signer, message: { raw }, signature });
+    return {
+      offline: false,
+      run: () =>
+        client.verifyMessage({ address: signer, message: { raw }, signature }),
+    };
   }
-  return async () => {
-    const recovered = await recoverMessageAddress({
-      message: { raw },
-      signature,
-    });
-    return recovered.toLowerCase() === signer.toLowerCase();
+  return {
+    offline: true,
+    run: async () => {
+      const recovered = await recoverMessageAddress({
+        message: { raw },
+        signature,
+      });
+      return recovered.toLowerCase() === signer.toLowerCase();
+    },
   };
 }