shell-sdk 0.7.1 → 0.8.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.8.0] — 2026-05-06
+
+### Added
+- `ShellDecodedProofInput` type: structured proof amendment payload decoded
+  from `starkReward` settlement transactions (requires `shell-chain v0.22+`).
+  Fields: `layer`, `blockNumber`, `startBlock`, `endBlock`, `nSigs`,
+  `compressedSize`, `originalSize`, `settlementTxHash`.
+- `ShellRpcTransaction.decodedInput?: ShellDecodedProofInput | null` — filled
+  by the node for `starkReward` system transactions; `null`/absent otherwise.
+- `ShellDecodedProofInput` exported from the package root.
+
+### Changed
+- Aligned with `shell-chain v0.22.0` RPC surface.
+
 ## [0.7.1] — 2026-05-06
 
 ### Added

package/dist/index.d.ts

@@ -7,4 +7,4 @@ export { adapterFromKeyPair, generateAdapter, generateMlDsa65KeyPair, generateSl
 export { buildShellSignature, publicKeyFromHex, ShellSigner, signatureTypeFromKeyType, type SignerAdapter, } from "./signer.js";
 export { AA_MAX_PAYMASTER_CONTEXT, AA_SESSION_KEY_GAS_SURCHARGE } from "./types.js";
 export { formatShellRpcTxType } from "./types.js";
-export type { AaBundle, AaInnerCall, AddressLike, GuardianConfig, HexString, RecoveryProposal, SessionAuth, ShellAccessListItem, ShellBatchInnerCallRequest, ShellBatchInnerGas, ShellCipherParams, ShellEncryptedKey, ShellEstimateBatchRequest, ShellEstimateBatchResult, ShellKnownRpcTxType, ShellIsSponsoredResult, ShellKdfParams, ShellNodeInfo, ShellPaymasterPolicy, ShellReadableTxType, ShellRewardKind, ShellRpcReceipt, ShellRpcTransaction, ShellRpcTransactionSummary, ShellRpcTxType, ShellSendTransactionParams, ShellSignature, ShellStorageProfile, ShellTransactionRequest, ShellTxByAddressPage, ShellTxWitness, ShellWitnessBundle, ShellWitnessRootResult, SignedShellTransaction, SignatureTypeName, } from "./types.js";
+export type { AaBundle, AaInnerCall, AddressLike, GuardianConfig, HexString, RecoveryProposal, SessionAuth, ShellAccessListItem, ShellBatchInnerCallRequest, ShellBatchInnerGas, ShellCipherParams, ShellEncryptedKey, ShellEstimateBatchRequest, ShellEstimateBatchResult, ShellKnownRpcTxType, ShellIsSponsoredResult, ShellKdfParams, ShellNodeInfo, ShellPaymasterPolicy, ShellReadableTxType, ShellRewardKind, ShellRpcReceipt, ShellRpcTransaction, ShellRpcTransactionSummary, ShellRpcTxType, ShellDecodedProofInput, ShellSendTransactionParams, ShellSignature, ShellStorageProfile, ShellTransactionRequest, ShellTxByAddressPage, ShellTxWitness, ShellWitnessBundle, ShellWitnessRootResult, SignedShellTransaction, SignatureTypeName, } from "./types.js";

package/dist/types.d.ts

@@ -244,6 +244,30 @@ export type ShellRpcTxType = ShellKnownRpcTxType | (string & {});
 export type ShellRewardKind = "blockGasReward" | "starkReward";
 /** Human-readable transaction label for wallets, explorers, and apps. */
 export type ShellReadableTxType = "Transfer" | "Contract Create" | "Contract Call" | "AA Batch" | "Block Reward" | "STARK Reward" | "System" | "Transaction";
+/**
+ * Decoded proof amendment payload for `starkReward` settlement transactions.
+ *
+ * Populated by the node when `system_tx_to_rpc` decodes the `StarkReward`
+ * proof payload; `null` for non-settlement or non-StarkReward transactions.
+ */
+export interface ShellDecodedProofInput {
+    /** STARK compression layer (1 = L1, 2 = L2, …). */
+    layer: number;
+    /** Terminal block number of the proof range. */
+    blockNumber: number;
+    /** First block number in the proof range. */
+    startBlock: number;
+    /** Last block number in the proof range (= blockNumber). */
+    endBlock: number;
+    /** Number of transaction entries (signatures) compressed. */
+    nSigs: number;
+    /** Size of the stored proof in bytes. */
+    compressedSize: number;
+    /** Original (pre-compression) witness size in bytes. */
+    originalSize: number;
+    /** Hash of the settlement transaction that carried this proof, if finalized. */
+    settlementTxHash?: HexString | null;
+}
 /** Shell Chain `eth_getTransactionByHash` transaction shape. */
 export interface ShellRpcTransaction {
     hash: HexString;
@@ -267,6 +291,8 @@ export interface ShellRpcTransaction {
     rewardSourceHash?: HexString | null;
     originalSize?: HexString | null;
     compressedSize?: HexString | null;
+    /** Decoded proof payload for `starkReward` settlement transactions (v0.22+). */
+    decodedInput?: ShellDecodedProofInput | null;
 }
 /** Shell Chain transaction summary returned in block/address transaction lists. */
 export interface ShellRpcTransactionSummary {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shell-sdk",
-  "version": "0.7.1",
+  "version": "0.8.0",
   "description": "TypeScript SDK for Shell Chain — build quantum-safe dApps before Q-Day.",
   "license": "MIT",
   "type": "module",