shell-sdk 0.7.1 → 0.8.1

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## [0.8.1] — 2026-05-10
+
+### Changed
+- Version bump for the next coordinated ShellDAO release cut.
+
+## [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/signer.js

@@ -127,7 +127,7 @@ export class ShellSigner {
             signature,
             signatureType: this.signatureType,
             senderPubkey: options.includePublicKey ? this.getPublicKey() : undefined,
-            aaBbundle: options.aaBundle,
+            aaBundle: options.aaBundle,
         });
     }
 }

package/dist/transactions.d.ts

@@ -51,6 +51,8 @@ export interface BuildSignedTransactionOptions {
     /** Optional public key bytes to embed as `sender_pubkey`. */
     senderPubkey?: Uint8Array | number[];
     /** AA bundle to attach when `tx.tx_type === AA_BUNDLE_TX_TYPE`. */
+    aaBundle?: AaBundle;
+    /** @deprecated Use {@link aaBundle} (typo alias kept for backward compatibility). */
     aaBbundle?: AaBundle;
 }
 /**
@@ -266,7 +268,7 @@ export declare const DEFAULT_AA_GAS_LIMIT = 200000;
  * const { tx, aa_bundle } = buildBatchTransaction({
  *   chainId: 424242,
  *   nonce: 0,
- *   innerCalls: [{ to: "pq1recipient…", value: "0x3e8", data: "0x", gas_limit: 21_000 }],
+ *   innerCalls: [{ to: "pq1recipient…", value: "0x3e8", data: "0x", gas_limit: "0x5208" }],
  * });
  * const signingHash = hashBatchTransaction(tx, aa_bundle);
  * const signed = await signer.buildSignedTransaction({ tx, txHash: signingHash, aaBundle: aa_bundle });

package/dist/transactions.js

@@ -210,7 +210,7 @@ export function buildSignedTransaction(options) {
         tx: options.tx,
         signature: buildSignature(options.signatureType, options.signature),
         sender_pubkey: options.senderPubkey ? toByteArray(options.senderPubkey) : null,
-        aa_bundle: options.aaBbundle ?? null,
+        aa_bundle: options.aaBundle ?? options.aaBbundle ?? null,
     };
 }
 /**
@@ -291,7 +291,7 @@ export const DEFAULT_AA_GAS_LIMIT = 200_000;
  * const { tx, aa_bundle } = buildBatchTransaction({
  *   chainId: 424242,
  *   nonce: 0,
- *   innerCalls: [{ to: "pq1recipient…", value: "0x3e8", data: "0x", gas_limit: 21_000 }],
+ *   innerCalls: [{ to: "pq1recipient…", value: "0x3e8", data: "0x", gas_limit: "0x5208" }],
  * });
  * const signingHash = hashBatchTransaction(tx, aa_bundle);
  * const signed = await signer.buildSignedTransaction({ tx, txHash: signingHash, aaBundle: aa_bundle });
@@ -406,6 +406,16 @@ export function hashBatchTransaction(tx, bundle) {
     combined.set(bundleRlp, domainBuf.length + txRlp.length);
     return hexToBytes(keccak256(bytesToHex(combined)));
 }
+/**
+ * Validate and encode a gas limit as a JSON-RPC hex quantity.
+ * Throws if `gasLimit` is not a non-negative safe integer.
+ */
+function toHexGasLimit(gasLimit) {
+    if (!Number.isSafeInteger(gasLimit) || gasLimit < 0) {
+        throw new RangeError(`gasLimit must be a non-negative safe integer, got: ${gasLimit}`);
+    }
+    return ("0x" + gasLimit.toString(16));
+}
 /**
  * Convenience helper: build a minimal `AaInnerCall` for a SHELL token transfer.
  *
@@ -415,7 +425,7 @@ export function hashBatchTransaction(tx, bundle) {
  * @returns An `AaInnerCall` ready for use in {@link buildBatchTransaction}.
  */
 export function buildInnerTransfer(to, value, gasLimit = 21_000) {
-    return { to, value: ("0x" + value.toString(16)), data: "0x", gas_limit: gasLimit };
+    return { to, value: ("0x" + value.toString(16)), data: "0x", gas_limit: toHexGasLimit(gasLimit) };
 }
 /**
  * Convenience helper: build a contract-call `AaInnerCall`.
@@ -427,7 +437,7 @@ export function buildInnerTransfer(to, value, gasLimit = 21_000) {
  * @returns An `AaInnerCall` ready for use in {@link buildBatchTransaction}.
  */
 export function buildInnerCall(to, data, gasLimit, value = 0n) {
-    return { to, value: ("0x" + value.toString(16)), data, gas_limit: gasLimit };
+    return { to, value: ("0x" + value.toString(16)), data, gas_limit: toHexGasLimit(gasLimit) };
 }
 /**
  * Build an AA batch transaction using a **contract paymaster** (Phase 2).

package/dist/types.d.ts

@@ -1,5 +1,12 @@
 /** A `0x`-prefixed hex string, e.g. `"0xdeadbeef"`. */
 export type HexString = `0x${string}`;
+/**
+ * A `0x`-prefixed hex-encoded unsigned integer quantity (JSON-RPC "QUANTITY"
+ * type), e.g. `"0x0"`, `"0x5208"`. No leading zeros (except `"0x0"` itself).
+ * Assignable to `HexString`; use where the value is always a non-negative
+ * integer (gas limits, values, nonces).
+ */
+export type HexQuantity = HexString;
 /** A `pq1…` bech32m address string (Shell Chain canonical address format). */
 export type AddressLike = string;
 /** A single entry in an EIP-2930 access list. */
@@ -82,8 +89,8 @@ export interface AaInnerCall {
     value: HexString;
     /** ABI-encoded calldata. */
     data: HexString;
-    /** Gas limit for this inner call. */
-    gas_limit: number;
+    /** Gas limit for this inner call as a hex-quantity string (e.g. `"0x5208"` for 21 000). Must be a non-negative integer encoded per JSON-RPC QUANTITY rules. */
+    gas_limit: HexQuantity;
 }
 /**
  * The AA bundle payload attached to a `tx_type = 0x7E` transaction.
@@ -244,6 +251,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 +298,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.1",
   "description": "TypeScript SDK for Shell Chain — build quantum-safe dApps before Q-Day.",
   "license": "MIT",
   "type": "module",