shell-sdk 0.7.0 → 0.8.0

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # 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
+- Typed Shell RPC reward metadata for address-history and transaction-summary
+  responses, including block gas rewards, STARK rewards, reward layers,
+  source hashes, and compression accounting fields.
+
+### Changed
+- Preserve pq1-only compatibility from `0.7.0` while aligning the SDK type
+  surface with `shell-chain v0.21.1`.
+
 ## [0.7.0] — 2026-04-30 ⚠️ BREAKING
 
 ### Breaking Changes — F-PQ1-ONLY (pq1 bech32m addresses everywhere)

package/README.md

@@ -40,6 +40,7 @@
 - **Native account abstraction** — key rotation and custom validation code via system contracts
 - **viem integration** — standard Ethereum JSON-RPC methods via a typed `PublicClient`
 - **Shell-specific RPC** — `shell_getPqPubkey`, `shell_sendTransaction`, `shell_getTransactionsByAddress`, `shell_getNodeInfo`, `shell_getWitness`
+- **Reward-aware history types** — block/address transaction summaries expose readable `shellType`, `rewardKind`, and STARK reward metadata (`rewardLayer`, `rewardSourceHash`, `originalSize`, `compressedSize`)
 - **Node introspection** — `getNodeInfo()` returns version, block height, peer count, and storage profile; `getWitness()` fetches raw PQ signatures for any block
 - **Encrypted keystore** — argon2id KDF + xchacha20-poly1305 cipher; compatible with the Shell CLI
 
@@ -78,7 +79,7 @@ const signer  = new ShellSigner("MlDsa65", adapter);
 const from    = signer.getAddress(); // pq1…
 
 const provider = createShellProvider();
-const nonce    = await provider.client.getTransactionCount({ address: signer.getHexAddress() });
+const nonce    = await provider.client.getTransactionCount({ address: from });
 
 const tx       = buildTransferTransaction({ chainId: 424242, nonce, to: "pq1recipient…", value: parseEther("1") });
 const txHash   = hashTransaction(tx);
@@ -107,7 +108,7 @@ blake3( version(1) || algo_id(1) || public_key )[0..20]
 
 Algorithm IDs: `Dilithium3=0`, `MlDsa65=1`, `SphincsSha2256f=2`.
 
-Internally the chain also recognises the hex representation (`0x…`) of the same 20 bytes, so both forms are interchangeable in SDK APIs.
+Shell Chain v0.21.0+ accepts `pq1…` addresses at user-facing RPC and SDK boundaries. Legacy `0x…` address inputs are rejected.
 
 ### Native account abstraction (AA)
 
@@ -147,7 +148,9 @@ Defined in `src/types.ts`. All types are re-exported from the package root.
 | `ShellSignature` | `{ sig_type, data: number[] }` |
 | `SignedShellTransaction` | Complete signed transaction ready to broadcast |
 | `ShellAccessListItem` | EIP-2930 access list entry |
-| `ShellTxByAddressPage` | Paginated address history response |
+| `ShellKnownRpcTxType` | Literal union of known Shell RPC transaction kinds |
+| `ShellRpcTransactionSummary` | Lightweight transaction summary with Shell reward metadata |
+| `ShellTxByAddressPage` | Paginated address history response with effective `fromBlock`/`toBlock` range |
 | `ShellKdfParams` | argon2id parameters inside a keystore |
 | `ShellCipherParams` | xchacha20-poly1305 nonce inside a keystore |
 | `ShellEncryptedKey` | Full encrypted keystore file structure |
@@ -173,10 +176,7 @@ Defined in `src/types.ts`. All types are re-exported from the package root.
 | `bytesToPqAddress` | `(bytes: Uint8Array, version?) → string` | Encode 20 raw bytes as a `pq1…` bech32m address |
 | `pqAddressToBytes` | `(address: string) → Uint8Array` | Decode a `pq1…` address to its 20 raw bytes |
 | `pqAddressVersion` | `(address: string) → number` | Extract the version byte from a `pq1…` address |
-| `hexAddressToBytes` | `(address: string) → Uint8Array` | Parse a `0x…` address to 20 bytes |
-| `bytesToHexAddress` | `(bytes: Uint8Array) → HexString` | Encode 20 bytes as a `0x…` hex address |
-| `normalizePqAddress` | `(address: string) → string` | Accept either pq1 or 0x form, always return pq1 |
-| `normalizeHexAddress` | `(address: string) → HexString` | Accept either pq1 or 0x form, always return 0x |
+| `normalizePqAddress` | `(address: string) → string` | Validate and return a `pq1…` address |
 | `derivePqAddressFromPublicKey` | `(pk, algoId, version?) → string` | Derive pq1 address from a raw public key |
 | `isPqAddress` | `(address: string) → boolean` | Return `true` if the string is a valid pq1 address |
 
@@ -194,9 +194,9 @@ const address = derivePqAddressFromPublicKey(publicKey, 1 /* MlDsa65 */);
 
 console.log(isPqAddress(address)); // true
 
-// Round-trip normalisation
-normalizePqAddress("0xabcdef…"); // → "pq1…"
+// Validation / normalisation
 normalizePqAddress("pq1qx3f…");  // → "pq1qx3f…" (unchanged)
+normalizePqAddress("0xabcdef…"); // throws: expected a pq1… bech32m address
 ```
 
 ---
@@ -236,8 +236,8 @@ import { shellDevnet } from "shell-sdk/provider";
 | `.rpcHttpUrl` | HTTP RPC URL in use |
 | `getPqPubkey(address)` | `shell_getPqPubkey` → hex public key or `null` |
 | `sendTransaction(signed)` | `shell_sendTransaction` → tx hash string |
-| `getTransactionsByAddress(address, opts)` | `shell_getTransactionsByAddress` with optional `fromBlock/toBlock/page/limit` |
-| `getBlockReceipts(block)` | `eth_getBlockReceipts` → array of receipts |
+| `getTransactionsByAddress(address, opts)` | `shell_getTransactionsByAddress` with optional `fromBlock/toBlock/page/limit`; pin `toBlock` from page 0 for stable full-history pagination |
+| `getBlockReceipts(block)` | `eth_getBlockReceipts` → `ShellRpcReceipt[]` |
 | `getNodeInfo()` | `shell_getNodeInfo` → `ShellNodeInfo` (version, block height, peer count, storage profile) |
 | `getWitness(blockNumberOrHash)` | `shell_getWitness` → `ShellWitnessBundle` or `null` if pruned |
 | `getStorageProfile()` | Convenience wrapper around `getNodeInfo()` → `ShellStorageProfile \| undefined` |
@@ -258,6 +258,11 @@ const pubkeyHex = await provider.getPqPubkey("pq1…");
 const txHash    = await provider.sendTransaction(signedTx);
 
 const history = await provider.getTransactionsByAddress("pq1…", { page: 0, limit: 20 });
+const older = await provider.getTransactionsByAddress("pq1…", {
+  page: 1,
+  limit: 20,
+  toBlock: history.toBlock ?? history.to_block,
+});
 ```
 
 **Custom endpoint:**
@@ -334,7 +339,6 @@ const signer = new ShellSigner("MlDsa65", MlDsa65Adapter.generate());
 | `algorithmId` | Numeric algorithm ID (`0`, `1`, or `2`) |
 | `getPublicKey()` | Raw public key bytes |
 | `getAddress()` | `pq1…` bech32m address |
-| `getHexAddress()` | `0x…` hex address |
 | `sign(message)` | Sign an arbitrary byte message → signature bytes |
 | `buildSignedTransaction(options)` | Sign `txHash` and assemble a `SignedShellTransaction` |
 
@@ -568,7 +572,6 @@ import { buildTransferTransaction, hashTransaction } from "shell-sdk/transaction
 const adapter = MlDsa65Adapter.generate();
 const signer  = new ShellSigner("MlDsa65", adapter);
 const from    = signer.getAddress();      // pq1…
-const fromHex = signer.getHexAddress();   // 0x…
 
 console.log("Address:", from);
 
@@ -576,7 +579,7 @@ console.log("Address:", from);
 const provider = createShellProvider(); // defaults to http://127.0.0.1:8545
 
 // 3. Get current nonce
-const nonce = await provider.client.getTransactionCount({ address: fromHex });
+const nonce = await provider.client.getTransactionCount({ address: from });
 
 // 4. Build the transaction
 const tx = buildTransferTransaction({
@@ -614,7 +617,7 @@ import { parseEther } from "viem";
 
 const signer   = await decryptKeystore(readFileSync("./key.json", "utf8"), process.env.PASSPHRASE!);
 const provider = createShellProvider();
-const nonce    = await provider.client.getTransactionCount({ address: signer.getHexAddress() });
+const nonce    = await provider.client.getTransactionCount({ address: signer.getAddress() });
 
 const tx = buildTransferTransaction({
   chainId: 424242,
@@ -639,13 +642,13 @@ This is the recommended shape for a Chrome extension background worker: keep the
 import { createShellProvider, buildTransferTransaction, hashTransaction } from "shell-sdk";
 
 async function submitTransfer({ signer, to, value, rpcHttpUrl }: {
-  signer: { getHexAddress(): `0x${string}`; buildSignedTransaction(args: { tx: unknown; txHash: Uint8Array; includePublicKey?: boolean }): Promise<unknown> };
+  signer: { getAddress(): string; buildSignedTransaction(args: { tx: unknown; txHash: Uint8Array; includePublicKey?: boolean }): Promise<unknown> };
   to: string;
   value: bigint;
   rpcHttpUrl: string;
 }) {
   const provider = createShellProvider({ rpcHttpUrl });
-  const nonce = await provider.client.getTransactionCount({ address: signer.getHexAddress() });
+  const nonce = await provider.client.getTransactionCount({ address: signer.getAddress() });
 
   const tx = buildTransferTransaction({
     chainId: 424242,
@@ -671,7 +674,7 @@ const provider = createShellProvider({
   rpcHttpUrl: "https://rpc.testnet.shell.network",
 });
 
-const account = normalizePqAddress("0x1234...abcd");
+const account = normalizePqAddress("pq1qx3f...");
 const history = await provider.getTransactionsByAddress(account, { page: 1, limit: 10 });
 
 console.log("recent txs:", history.transactions);
@@ -699,7 +702,7 @@ const currentSigner = await decryptKeystore(readFileSync("old-key.json", "utf8")
 const newAdapter = MlDsa65Adapter.generate();
 const newSigner  = new ShellSigner("MlDsa65", newAdapter);
 
-const nonce = await provider.client.getTransactionCount({ address: currentSigner.getHexAddress() });
+const nonce = await provider.client.getTransactionCount({ address: currentSigner.getAddress() });
 
 // Build the rotateKey system transaction
 const tx = buildRotateKeyTransaction({
@@ -728,7 +731,6 @@ All SDK functions throw standard `Error` instances. Common error messages:
 |---|---|
 | `expected 20 address bytes, got N` | Wrong-length bytes passed to address helpers |
 | `expected pq address prefix, got X` | bech32m prefix is not `pq` |
-| `invalid hex address` | String does not start with `0x` |
 | `invalid bech32m address` | String is not a valid bech32m address |
 | `unsupported key type: X` | Keystore `key_type` not recognised |
 | `unsupported kdf: X` | Only `argon2id` is supported |

package/dist/index.d.ts

@@ -6,4 +6,5 @@ export { assertSignerMatchesKeystore, decryptKeystore, exportEncryptedKeyJson, p
 export { adapterFromKeyPair, generateAdapter, generateMlDsa65KeyPair, generateSlhDsaKeyPair, MlDsa65Adapter, SlhDsaAdapter, type MlDsa65KeyPair, type SlhDsaKeyPair, } from "./adapters.js";
 export { buildShellSignature, publicKeyFromHex, ShellSigner, signatureTypeFromKeyType, type SignerAdapter, } from "./signer.js";
 export { AA_MAX_PAYMASTER_CONTEXT, AA_SESSION_KEY_GAS_SURCHARGE } from "./types.js";
-export type { AaBundle, AaInnerCall, AddressLike, GuardianConfig, HexString, RecoveryProposal, SessionAuth, ShellAccessListItem, ShellBatchInnerCallRequest, ShellBatchInnerGas, ShellCipherParams, ShellEncryptedKey, ShellEstimateBatchRequest, ShellEstimateBatchResult, ShellIsSponsoredResult, ShellKdfParams, ShellNodeInfo, ShellPaymasterPolicy, ShellSendTransactionParams, ShellSignature, ShellStorageProfile, ShellTransactionRequest, ShellTxByAddressPage, ShellTxWitness, ShellWitnessBundle, ShellWitnessRootResult, SignedShellTransaction, SignatureTypeName, } 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, ShellDecodedProofInput, ShellSendTransactionParams, ShellSignature, ShellStorageProfile, ShellTransactionRequest, ShellTxByAddressPage, ShellTxWitness, ShellWitnessBundle, ShellWitnessRootResult, SignedShellTransaction, SignatureTypeName, } from "./types.js";

package/dist/index.js

@@ -6,3 +6,4 @@ export { assertSignerMatchesKeystore, decryptKeystore, exportEncryptedKeyJson, p
 export { adapterFromKeyPair, generateAdapter, generateMlDsa65KeyPair, generateSlhDsaKeyPair, MlDsa65Adapter, SlhDsaAdapter, } from "./adapters.js";
 export { buildShellSignature, publicKeyFromHex, ShellSigner, signatureTypeFromKeyType, } from "./signer.js";
 export { AA_MAX_PAYMASTER_CONTEXT, AA_SESSION_KEY_GAS_SURCHARGE } from "./types.js";
+export { formatShellRpcTxType } from "./types.js";

package/dist/provider.d.ts

@@ -16,7 +16,7 @@
  * @module provider
  */
 import { type Chain, type PublicClient } from "viem";
-import type { ShellEstimateBatchRequest, ShellEstimateBatchResult, ShellIsSponsoredResult, ShellNodeInfo, ShellPaymasterPolicy, ShellStorageProfile, ShellWitnessBundle, ShellWitnessRootResult, SignedShellTransaction } from "./types.js";
+import type { ShellEstimateBatchRequest, ShellEstimateBatchResult, ShellIsSponsoredResult, ShellNodeInfo, ShellPaymasterPolicy, ShellRpcReceipt, ShellStorageProfile, ShellTxByAddressPage, ShellWitnessBundle, ShellWitnessRootResult, SignedShellTransaction } from "./types.js";
 /**
  * Pre-configured viem chain definition for Shell Devnet.
  *
@@ -90,6 +90,7 @@ export interface CreateShellPublicClientOptions {
 }
 /** A typed alias for a viem `PublicClient`. */
 export type ShellPublicClient = PublicClient;
+export type ShellBlockRangeBound = number | `0x${string}`;
 /**
  * RPC client for Shell Chain.
  *
@@ -138,14 +139,16 @@ export declare class ShellProvider {
      * @param options.toBlock - End of block range (inclusive).
      * @param options.page - Zero-based page index.
      * @param options.limit - Maximum number of results per page.
-     * @returns Raw paginated response from the node.
+     * @returns Paginated response from the node. `fromBlock`/`toBlock` in the
+     * response is the effective inclusive range; clients that paginate under
+     * live load should pin `toBlock` from the first page.
      */
     getTransactionsByAddress(address: string, options?: {
-        fromBlock?: number;
-        toBlock?: number;
+        fromBlock?: ShellBlockRangeBound;
+        toBlock?: ShellBlockRangeBound;
         page?: number;
         limit?: number;
-    }): Promise<unknown>;
+    }): Promise<ShellTxByAddressPage>;
     /**
      * Fetch all transaction receipts for a block.
      *
@@ -154,7 +157,7 @@ export declare class ShellProvider {
      * @param block - Block identifier: `"latest"`, `"earliest"`, or a hex block number.
      * @returns Array of transaction receipt objects.
      */
-    getBlockReceipts(block: string): Promise<unknown[]>;
+    getBlockReceipts(block: string): Promise<ShellRpcReceipt[]>;
     /**
      * Fetch metadata about the connected Shell Chain node.
      *

package/dist/provider.js

@@ -115,7 +115,9 @@ export class ShellProvider {
      * @param options.toBlock - End of block range (inclusive).
      * @param options.page - Zero-based page index.
      * @param options.limit - Maximum number of results per page.
-     * @returns Raw paginated response from the node.
+     * @returns Paginated response from the node. `fromBlock`/`toBlock` in the
+     * response is the effective inclusive range; clients that paginate under
+     * live load should pin `toBlock` from the first page.
      */
     async getTransactionsByAddress(address, options = {}) {
         return this.request("shell_getTransactionsByAddress", [

package/dist/types.d.ts

@@ -237,6 +237,109 @@ export interface SignedShellTransaction {
      */
     aa_bundle?: AaBundle | null;
 }
+/** Product-level transaction kind emitted by Shell Chain RPC. */
+export type ShellKnownRpcTxType = "transfer" | "contractCreate" | "contractCall" | "aaBatch" | "blockGasReward" | "starkReward";
+export type ShellRpcTxType = ShellKnownRpcTxType | (string & {});
+/** Reward kind emitted for first-class system reward transactions. */
+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;
+    blockHash?: HexString | null;
+    blockNumber?: HexString | null;
+    transactionIndex?: HexString | null;
+    from: AddressLike;
+    to?: AddressLike | null;
+    value: HexString;
+    gas: HexString;
+    gasPrice: HexString;
+    maxFeePerGas?: HexString;
+    maxPriorityFeePerGas?: HexString;
+    nonce: HexString;
+    input: HexString;
+    chainId: HexString;
+    type: HexString;
+    shellType?: ShellRpcTxType | null;
+    rewardKind?: ShellRewardKind | null;
+    rewardLayer?: HexString | null;
+    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 {
+    hash: HexString;
+    blockHash?: HexString | null;
+    blockNumber?: HexString | null;
+    transactionIndex?: HexString | null;
+    from?: AddressLike;
+    to?: AddressLike | null;
+    value?: HexString;
+    type?: HexString;
+    hasInput?: boolean;
+    shellType?: ShellRpcTxType | null;
+    rewardKind?: ShellRewardKind | null;
+    rewardLayer?: HexString | null;
+    rewardSourceHash?: HexString | null;
+    originalSize?: HexString | null;
+    compressedSize?: HexString | null;
+}
+/** Shell Chain transaction receipt shape, including system reward metadata. */
+export interface ShellRpcReceipt {
+    transactionHash: HexString;
+    blockHash: HexString;
+    blockNumber: HexString;
+    transactionIndex: HexString;
+    from: AddressLike;
+    to?: AddressLike | null;
+    status: HexString;
+    gasUsed: HexString;
+    cumulativeGasUsed: HexString;
+    effectiveGasPrice: HexString;
+    contractAddress?: AddressLike | null;
+    logs: unknown[];
+    logsBloom: HexString;
+    type: HexString;
+    shellType?: ShellRpcTxType | null;
+    rewardKind?: ShellRewardKind | null;
+}
+/** Return a user-facing transaction type label without leaking EIP wire labels. */
+export declare function formatShellRpcTxType(tx: {
+    type?: string | null;
+    to?: AddressLike | null;
+    hasInput?: boolean;
+    input?: string | null;
+    shellType?: ShellRpcTxType | null;
+    rewardKind?: ShellRewardKind | null;
+}): ShellReadableTxType;
 /**
  * A single inner call entry in a `shell_estimateBatch` request.
  */
@@ -399,10 +502,18 @@ export interface ShellWitnessBundle {
 /** Paginated response from `shell_getTransactionsByAddress`. */
 export interface ShellTxByAddressPage {
     address: AddressLike;
+    /** Inclusive lower block bound used for the query, hex-encoded. */
+    from_block?: HexString;
+    /** Inclusive upper block snapshot used for the query, hex-encoded. */
+    to_block?: HexString;
+    /** Inclusive lower block bound used for the query, hex-encoded. */
+    fromBlock?: HexString;
+    /** Inclusive upper block snapshot used for the query, hex-encoded. */
+    toBlock?: HexString;
     page: number;
     limit: number;
     total: number;
-    transactions: unknown[];
+    transactions: ShellRpcTransactionSummary[];
 }
 /** Parameters for `shell_sendTransaction`. */
 export interface ShellSendTransactionParams {

package/dist/types.js

@@ -23,3 +23,36 @@ export const AA_MAX_PAYMASTER_CONTEXT = 256;
  * Added to intrinsic gas when a session key is used.
  */
 export const AA_SESSION_KEY_GAS_SURCHARGE = 20_000;
+/** Return a user-facing transaction type label without leaking EIP wire labels. */
+export function formatShellRpcTxType(tx) {
+    const shellType = tx.shellType ?? tx.rewardKind;
+    if (shellType === "blockGasReward")
+        return "Block Reward";
+    if (shellType === "starkReward")
+        return "STARK Reward";
+    if (shellType === "aaBatch")
+        return "AA Batch";
+    if (shellType === "contractCreate")
+        return "Contract Create";
+    if (shellType === "contractCall")
+        return "Contract Call";
+    if (shellType === "transfer")
+        return "Transfer";
+    if (shellType)
+        return "System";
+    if (tx.type === "0x7e")
+        return "AA Batch";
+    if (tx.to === null)
+        return "Contract Create";
+    if (tx.hasInput || (tx.input && tx.input !== "0x"))
+        return "Contract Call";
+    if (tx.type === "0x80")
+        return "System";
+    if (tx.type == null &&
+        tx.to === undefined &&
+        tx.hasInput === undefined &&
+        tx.input === undefined) {
+        return "Transaction";
+    }
+    return "Transfer";
+}

package/package.json

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