@valve-tech/wallet-adapter 0.15.0 → 0.17.0

package/CHANGELOG.md

@@ -6,6 +6,44 @@ this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/).
 
+## [0.17.0] — 2026-05-30
+
+### Added
+
+- `TrackedTx.readOnly?: boolean` — optional, additive flag that
+  marks a tx the consumer is only observing, not authoring (e.g.
+  a relayer-submitted tx whose hash arrived from outside the wallet
+  flow). The library does not act on the field; it's a hint for
+  consumer UI logic — typically: skip wiring `onSpeedUp` /
+  `onCancel` on `<TxFlightActions>` for these entries, since the
+  consumer doesn't hold the nonce slot and can't replace.
+- Read sites SHOULD use the strict form `tx.readOnly === true` (not
+  `if (tx.readOnly)`) so the runtime check is unambiguous — pre-flag
+  persisted entries rehydrate with `undefined`, which is correctly
+  falsy under both forms, but the strict comparison makes intent
+  explicit at every call site.
+
+### Notes
+
+- Non-breaking: the field is optional, defaults to `undefined`, and
+  no existing code path reads it. Persisted entries written before
+  this release rehydrate unchanged; the field simply remains absent
+  on those records.
+- The driver use case is
+  `@valve-tech/tx-flight-react`'s `addByHash({ readOnly, submittedAt })`
+  for tracking relayer-submitted transactions. See that package's
+  v0.17.0 entry for the consumer-facing surface.
+
+## [0.16.0] — 2026-05-15
+
+### Notes
+
+- Synchronized release — no changes to this package. Republished at
+  0.16.0 alongside the rest of the toolkit; the substantive changes
+  are in `@valve-tech/chain-source` (adaptive polling + `Logger` +
+  `estimateBlockTimeMs` helper) and `@valve-tech/tx-tracker` (logger).
+  See the respective CHANGELOGs for details.
+
 ## [0.15.0] — 2026-05-14
 
 ### Notes

package/dist/tx-status.d.ts

@@ -93,6 +93,21 @@ export interface TrackedTx {
      * instead of a flat "transaction failed".
      */
     notes?: string;
+    /**
+     * Marks a tx the consumer is only observing, not authoring — e.g. a
+     * relayer-submitted tx whose hash arrived from outside the wallet
+     * flow. The library does not act on this field; it's a hint for
+     * consumer UI logic (typically: skip wiring `onSpeedUp` / `onCancel`
+     * on `<TxFlightActions>` for these, since the consumer doesn't hold
+     * the nonce slot and can't replace).
+     *
+     * Optional + additive: pre-existing persisted entries rehydrate with
+     * `undefined`, which is correctly falsy. Read sites SHOULD use
+     * `tx.readOnly === true` rather than `if (tx.readOnly)` so the
+     * runtime check is unambiguous (the static type can't promise the
+     * field is present on records written before this field existed).
+     */
+    readOnly?: boolean;
 }
 /**
  * How long a stale (older than this) tracked tx may be ignored by

package/dist/tx-status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tx-status.d.ts","sourceRoot":"","sources":["../src/tx-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AAI/B;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,SAAS;;;;;;;;CAQZ,CAAA;AAEV,MAAM,MAAM,eAAe,GAAG,OAAO,SAAS,CAAC,MAAM,OAAO,SAAS,CAAC,CAAA;AAItE;;;;;;;;;GASG;AACH,eAAO,MAAM,OAAO,IAAc,CAAA;AAElC,MAAM,MAAM,MAAM,GAAG,MAAM,CAAA;AAI3B;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAA;IACpB,oBAAoB,EAAE,MAAM,CAAA;CAC7B;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,CAAC,EAAE,GAAG,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B,aAAa,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,eAAe,CAAA;IACvB,UAAU,CAAC,EAAE,GAAG,CAAA;IAChB,QAAQ,CAAC,EAAE,GAAG,CAAA;IACd;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAID;;;;;GAKG;AACH,eAAO,MAAM,eAAe,QAAiB,CAAA;AAE7C;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,QAAS,CAAA;AAC1C,eAAO,MAAM,iBAAiB,QAAS,CAAA;AAIvC,oDAAoD;AACpD,MAAM,MAAM,mBAAmB,GAAG,CAAC,EAAE,EAAE,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA"}
+{"version":3,"file":"tx-status.d.ts","sourceRoot":"","sources":["../src/tx-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AAI/B;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,SAAS;;;;;;;;CAQZ,CAAA;AAEV,MAAM,MAAM,eAAe,GAAG,OAAO,SAAS,CAAC,MAAM,OAAO,SAAS,CAAC,CAAA;AAItE;;;;;;;;;GASG;AACH,eAAO,MAAM,OAAO,IAAc,CAAA;AAElC,MAAM,MAAM,MAAM,GAAG,MAAM,CAAA;AAI3B;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAA;IACpB,oBAAoB,EAAE,MAAM,CAAA;CAC7B;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,CAAC,EAAE,GAAG,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B,aAAa,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,eAAe,CAAA;IACvB,UAAU,CAAC,EAAE,GAAG,CAAA;IAChB,QAAQ,CAAC,EAAE,GAAG,CAAA;IACd;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAID;;;;;GAKG;AACH,eAAO,MAAM,eAAe,QAAiB,CAAA;AAE7C;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,QAAS,CAAA;AAC1C,eAAO,MAAM,iBAAiB,QAAS,CAAA;AAIvC,oDAAoD;AACpD,MAAM,MAAM,mBAAmB,GAAG,CAAC,EAAE,EAAE,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA"}

package/dist/tx-status.js.map

@@ -1 +1 @@
-{"version":3,"file":"tx-status.js","sourceRoot":"","sources":["../src/tx-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,8EAA8E;AAE9E;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,SAAS,EAAU,WAAW;IAC9B,iBAAiB,EAAE,oBAAoB;IACvC,OAAO,EAAY,SAAS;IAC5B,SAAS,EAAU,WAAW;IAC9B,MAAM,EAAa,QAAQ;IAC3B,QAAQ,EAAW,UAAU;IAC7B,OAAO,EAAY,SAAS;CACpB,CAAA;AAIV,8EAA8E;AAE9E;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,EAAW,CAAA;AAmDlC,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA,CAAC,aAAa;AAE3D;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAM,CAAA;AAC1C,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAM,CAAA"}
+{"version":3,"file":"tx-status.js","sourceRoot":"","sources":["../src/tx-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,8EAA8E;AAE9E;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,SAAS,EAAU,WAAW;IAC9B,iBAAiB,EAAE,oBAAoB;IACvC,OAAO,EAAY,SAAS;IAC5B,SAAS,EAAU,WAAW;IAC9B,MAAM,EAAa,QAAQ;IAC3B,QAAQ,EAAW,UAAU;IAC7B,OAAO,EAAY,SAAS;CACpB,CAAA;AAIV,8EAA8E;AAE9E;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,EAAW,CAAA;AAkElC,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA,CAAC,aAAa;AAE3D;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAM,CAAA;AAC1C,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAM,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@valve-tech/wallet-adapter",
-  "version": "0.15.0",
+  "version": "0.17.0",
   "description": "Framework-agnostic vocabulary + runtime helpers for EVM dapp wallet integration. WalletAdapter interface (sign + send), WriteHookParams full lifecycle with rich TxContext payloads (chainId + original request) on every event so consumers don't side-channel; six named hooks (onAwaitingSignature, onTransactionHash, onConfirmed, onFailed, onDropped, onReplaced) plus complementary onPhase(event) discriminated-union shape derived from the WritePhaseSteps phase-map; sendTransactionWithHooks + awaitReceiptWithHooks helpers that fire the hooks at real boundaries (with awaitReceiptWithHooks fetching the containing block once on behalf of all downstream consumers); typed WalletRejectedError + ContractRevertedError for instanceof-discriminated catch; plus TX_STATUS / TX_FLOW / TrackedTx for tx-state UI. Lets SDKs and dapps share one contract instead of each redefining it. Part of the valve-tech/evm-toolkit synchronized release line.",
   "license": "MIT",
   "homepage": "https://github.com/valve-tech/evm-toolkit/tree/main/packages/wallet-adapter#readme",
@@ -51,7 +51,7 @@
     "prepare": "yarn build"
   },
   "dependencies": {
-    "@valve-tech/viem-errors": "^0.15.0"
+    "@valve-tech/viem-errors": "^0.17.0"
   },
   "peerDependencies": {
     "viem": "^2.0.0"