lumina-node-wasm 0.11.0 → 0.13.0

package/lumina_node_wasm.d.ts

@@ -384,10 +384,14 @@ export enum TxStatus {
    * The transaction was evicted from the mempool.
    */
   Evicted = 2,
+  /**
+   * The transaction was rejected
+   */
+  Rejected = 3,
   /**
    * The transaction was committed into the block.
    */
-  Committed = 3,
+  Committed = 4,
 }
 /**
  * Types of votes
@@ -474,6 +478,24 @@ type ReadableStreamType = "bytes";
       height: bigint;
     }
 
+    /**
+     * A transaction that was broadcasted
+     */
+    export interface BroadcastedTx {
+      /**
+       * Broadcasted bytes
+       */
+      tx: Uint8Array;
+      /**
+       * Transaction hash
+       */
+      hash: string;
+      /**
+       * Transaction sequence
+       */
+      sequence: bigint;
+    }
+
     /**
      * Transaction config.
      */
@@ -536,6 +558,13 @@ export class AbciMessageLog {
 export class AbciQueryResponse {
   private constructor();
   free(): void;
+  /**
+   * The block height from which data was derived.
+   *
+   * Note that this is the height of the block containing the application's Merkle root hash,
+   * which represents the state as it was after committing the block at height - 1.
+   */
+  readonly height: bigint;
   /**
    * Response code.
    */
@@ -579,13 +608,6 @@ export class AbciQueryResponse {
    * Additional information. May be non-deterministic.
    */
   info: string;
-  /**
-   * The block height from which data was derived.
-   *
-   * Note that this is the height of the block containing the application's Merkle root hash,
-   * which represents the state as it was after committing the block at height - 1.
-   */
-  readonly height: bigint;
 }
 /**
  * Address of an account.
@@ -751,6 +773,29 @@ export class BlobParams {
    */
   gov_max_square_size: bigint;
 }
+/**
+ * List of blobs together with height they were published at
+ */
+export class BlobsAtHeight {
+  private constructor();
+/**
+** Return copy of self without private attributes.
+*/
+  toJSON(): Object;
+/**
+* Return stringified version of self.
+*/
+  toString(): string;
+  free(): void;
+  /**
+   * Height the blobs were published at
+   */
+  height: bigint;
+  /**
+   * Published blobs
+   */
+  blobs: Blob[];
+}
 /**
  * Blocks consist of a header, transactions, votes (the commit), and a list of
  * evidence of malfeasance (i.e. signing conflicting votes).
@@ -840,16 +885,16 @@ export class BroadcastMode {
    * zero-value for mode ordering
    */
   static readonly Unspecified: BroadcastMode;
-  /**
-   * DEPRECATED: use `BroadcastMode` `Sync` instead,
-   * `BroadcastMode` `Block` is not supported by the SDK from v0.47.x onwards.
-   */
-  static readonly Block: BroadcastMode;
   /**
    * `BroadcastMode` `Sync` defines a tx broadcasting mode where the client waits for
    * a CheckTx execution response only.
    */
   static readonly Sync: BroadcastMode;
+  /**
+   * DEPRECATED: use `BroadcastMode` `Sync` instead,
+   * `BroadcastMode` `Block` is not supported by the SDK from v0.47.x onwards.
+   */
+  static readonly Block: BroadcastMode;
   /**
    * `BroadcastMode` `Async` defines a tx broadcasting mode where the client returns
    * immediately.
@@ -1026,6 +1071,9 @@ export class ConflictingBlock {
    */
   validator_set: ValidatorSet;
 }
+/**
+ * Network connection information
+ */
 export class ConnectionCountersSnapshot {
   private constructor();
 /**
@@ -1122,7 +1170,7 @@ export class Data {
  * # fn extended_header() -> ExtendedHeader {
  * #     unimplemented!();
  * # }
- * # fn shares_with_proof(_: Height, _: &Namespace) -> (Vec<Share>, NamespaceProof) {
+ * # fn shares_with_proof(_: u64, _: &Namespace) -> (Vec<Share>, NamespaceProof) {
  * #     unimplemented!();
  * # }
  * // fetch the block header and data for your namespace
@@ -1151,32 +1199,32 @@ export class DataAvailabilityHeader {
 */
   toString(): string;
   free(): void;
+  /**
+   * Get a root of the row with the given index.
+   */
+  rowRoot(row: number): any;
   /**
    * Merkle roots of the [`ExtendedDataSquare`] rows.
    */
   rowRoots(): Array<any>;
   /**
-   * Merkle roots of the [`ExtendedDataSquare`] columns.
+   * Get the a root of the column with the given index.
    */
-  columnRoots(): Array<any>;
+  columnRoot(column: number): any;
   /**
-   * Get a root of the row with the given index.
+   * Merkle roots of the [`ExtendedDataSquare`] columns.
    */
-  rowRoot(row: number): any;
+  columnRoots(): Array<any>;
   /**
-   * Get the a root of the column with the given index.
+   * Get the size of the [`ExtendedDataSquare`] for which this header was built.
    */
-  columnRoot(column: number): any;
+  squareWidth(): number;
   /**
    * Compute the combined hash of all rows and columns.
    *
    * This is the data commitment for the block.
    */
   hash(): any;
-  /**
-   * Get the size of the [`ExtendedDataSquare`] for which this header was built.
-   */
-  squareWidth(): number;
 }
 /**
  * Duplicate vote evidence
@@ -1252,40 +1300,10 @@ export class ExtendedHeader {
 */
   toString(): string;
   free(): void;
-  /**
-   * Clone a header producing a deep copy of it.
-   */
-  clone(): ExtendedHeader;
-  /**
-   * Get the block height.
-   */
-  height(): bigint;
-  /**
-   * Get the block time.
-   */
-  time(): number;
-  /**
-   * Get the block hash.
-   */
-  hash(): string;
-  /**
-   * Get the hash of the previous header.
-   */
-  previousHeaderHash(): string;
   /**
    * Decode protobuf encoded header and then validate it.
    */
   validate(): void;
-  /**
-   * Verify a chain of adjacent untrusted headers and make sure
-   * they are adjacent to `self`.
-   *
-   * # Errors
-   *
-   * If verification fails, this function will return an error with a reason of failure.
-   * This function will also return an error if untrusted headers and `self` don't form contiguous range
-   */
-  verify(untrusted: ExtendedHeader): void;
   /**
    * Verify a chain of adjacent untrusted headers.
    *
@@ -1308,6 +1326,10 @@ export class ExtendedHeader {
    * to each other.
    */
   verifyRange(untrusted: ExtendedHeader[]): void;
+  /**
+   * Get the hash of the previous header.
+   */
+  previousHeaderHash(): string;
   /**
    * Verify a chain of adjacent untrusted headers and make sure
    * they are adjacent to `self`.
@@ -1331,21 +1353,47 @@ export class ExtendedHeader {
    */
   verifyAdjacentRange(untrusted: ExtendedHeader[]): void;
   /**
-   * Header of the block data availability.
+   * Get the block hash.
    */
-  dah: DataAvailabilityHeader;
+  hash(): string;
   /**
-   * Tendermint block header.
+   * Get the block time.
    */
-  readonly header: any;
+  time(): number;
   /**
-   * Commit metadata and signatures from validators committing the block.
+   * Clone a header producing a deep copy of it.
    */
-  readonly commit: any;
+  clone(): ExtendedHeader;
+  /**
+   * Get the block height.
+   */
+  height(): bigint;
+  /**
+   * Verify a chain of adjacent untrusted headers and make sure
+   * they are adjacent to `self`.
+   *
+   * # Errors
+   *
+   * If verification fails, this function will return an error with a reason of failure.
+   * This function will also return an error if untrusted headers and `self` don't form contiguous range
+   */
+  verify(untrusted: ExtendedHeader): void;
   /**
    * Information about the set of validators commiting the block.
    */
   readonly validatorSet: any;
+  /**
+   * Commit metadata and signatures from validators committing the block.
+   */
+  readonly commit: any;
+  /**
+   * Tendermint block header.
+   */
+  readonly header: any;
+  /**
+   * Header of the block data availability.
+   */
+  dah: DataAvailabilityHeader;
 }
 /**
  * Fee includes the amount of coins paid in fees and the maximum
@@ -1429,92 +1477,41 @@ export class GrpcClient {
   private constructor();
   free(): void;
   /**
-   * Create a builder for [`GrpcClient`] connected to `url`
+   * Issue a direct ABCI query to the application
    */
-  static withUrl(url: string): GrpcClientBuilder;
+  abciQuery(data: Uint8Array, path: string, height: bigint, prove: boolean): Promise<AbciQueryResponse>;
   /**
-   * Get auth params
+   * Confirm transaction broadcasted with [`broadcast_blobs`] or [`broadcast_message`].
+   *
+   * # Example
+   * ```js
+   * const ns = Namespace.newV0(new Uint8Array([97, 98, 99]));
+   * const data = new Uint8Array([100, 97, 116, 97]);
+   * const blob = new Blob(ns, data, AppVersion.latest());
+   *
+   * const broadcastedTx = await txClient.broadcastBlobs([blob]);
+   * console.log("Tx hash:", broadcastedTx.hash);
+   * const txInfo = await txClient.confirmTx(broadcastedTx);
+   * console.log("Confirmed at height:", txInfo.height);
+   * ```
    */
-  getAuthParams(): Promise<AuthParams>;
+  confirmTx(broadcasted_tx: BroadcastedTx, tx_config?: TxConfig | null): Promise<TxInfo>;
   /**
    * Get account
    */
   getAccount(account: string): Promise<BaseAccount>;
-  /**
-   * Get accounts
-   */
-  getAccounts(): Promise<BaseAccount[]>;
-  /**
-   * Retrieves the verified Celestia coin balance for the address.
-   *
-   * # Notes
-   *
-   * This returns the verified balance which is the one that was reported by
-   * the previous network block. In other words, if you transfer some coins,
-   * you need to wait 1 more block in order to see the new balance. If you want
-   * something more immediate then use [`GrpcClient::get_balance`].
-   */
-  getVerifiedBalance(address: string, header: ExtendedHeader): Promise<Coin>;
   /**
    * Retrieves the Celestia coin balance for the given address.
    */
   getBalance(address: string, denom: string): Promise<Coin>;
-  /**
-   * Get balance of all coins
-   */
-  getAllBalances(address: string): Promise<Coin[]>;
-  /**
-   * Get balance of all spendable coins
-   */
-  getSpendableBalances(address: string): Promise<Coin[]>;
-  /**
-   * Get total supply
-   */
-  getTotalSupply(): Promise<Coin[]>;
-  /**
-   * Get node configuration
-   */
-  get_node_config(): Promise<ConfigResponse>;
-  /**
-   * Get latest block
-   */
-  getLatestBlock(): Promise<Block>;
-  /**
-   * Get block by height
-   */
-  getBlockByHeight(height: bigint): Promise<Block>;
-  /**
-   * Issue a direct ABCI query to the application
-   */
-  abciQuery(data: Uint8Array, path: string, height: bigint, prove: boolean): Promise<AbciQueryResponse>;
   /**
    * Broadcast prepared and serialised transaction
    */
   broadcastTx(tx_bytes: Uint8Array, mode: BroadcastMode): Promise<TxResponse>;
   /**
-   * Get Tx
-   */
-  getTx(hash: string): Promise<GetTxResponse>;
-  /**
-   * Simulate prepared and serialised transaction, returning simulated gas usage
-   */
-  simulate(tx_bytes: Uint8Array): Promise<GasInfo>;
-  /**
-   * Get blob params
-   */
-  getBlobParams(): Promise<BlobParams>;
-  /**
-   * Get status of the transaction
-   */
-  txStatus(hash: string): Promise<TxStatusResponse>;
-  /**
-   * Estimate gas price for given transaction priority based
-   * on the gas prices of the transactions in the last five blocks.
-   *
-   * If no transaction is found in the last five blocks, return the network
-   * min gas price.
+   * Get accounts
    */
-  estimateGasPrice(priority: TxPriority): Promise<number>;
+  getAccounts(): Promise<BaseAccount[]>;
   /**
    * Submit blobs to the celestia network.
    *
@@ -1563,16 +1560,140 @@ export class GrpcClient {
    */
   submitMessage(message: ProtoAny, tx_config?: TxConfig | null): Promise<TxInfo>;
   /**
-   * Chain id of the client
+   * Broadcast blobs to the celestia network, and return without confirming.
+   *
+   * # Example
+   * ```js
+   * const ns = Namespace.newV0(new Uint8Array([97, 98, 99]));
+   * const data = new Uint8Array([100, 97, 116, 97]);
+   * const blob = new Blob(ns, data, AppVersion.latest());
+   *
+   * const broadcastedTx = await txClient.broadcastBlobs([blob]);
+   * console.log("Tx hash:", broadcastedTx.hash);
+   * const txInfo = await txClient.confirmTx(broadcastedTx);
+   * ```
+   *
+   * # Note
+   *
+   * Provided blobs will be consumed by this method, meaning
+   * they will no longer be accessible. If this behavior is not desired,
+   * consider using `Blob.clone()`.
+   *
+   * ```js
+   * const blobs = [blob1, blob2, blob3];
+   * await txClient.broadcastBlobs(blobs.map(b => b.clone()));
+   * ```
    */
-  readonly chainId: Promise<string>;
+  broadcastBlobs(blobs: Blob[], tx_config?: TxConfig | null): Promise<BroadcastedTx>;
   /**
-   * AppVersion of the client
+   * Get auth params
    */
-  readonly appVersion: Promise<AppVersion>;
-}
-/**
- * Builder for [`GrpcClient`] and [`TxClient`].
+  getAuthParams(): Promise<AuthParams>;
+  /**
+   * Get blob params
+   */
+  getBlobParams(): Promise<BlobParams>;
+  /**
+   * Get node configuration
+   */
+  get_node_config(): Promise<ConfigResponse>;
+  /**
+   * Get balance of all coins
+   */
+  getAllBalances(address: string): Promise<Coin[]>;
+  /**
+   * Get latest block
+   */
+  getLatestBlock(): Promise<Block>;
+  /**
+   * Get total supply
+   */
+  getTotalSupply(): Promise<Coin[]>;
+  /**
+   * Broadcast message to the celestia network, and return without confirming.
+   *
+   * # Example
+   * ```js
+   * import { Registry } from "@cosmjs/proto-signing";
+   *
+   * const registry = new Registry();
+   * const sendMsg = {
+   *   typeUrl: "/cosmos.bank.v1beta1.MsgSend",
+   *   value: {
+   *     fromAddress: "celestia169s50psyj2f4la9a2235329xz7rk6c53zhw9mm",
+   *     toAddress: "celestia1t52q7uqgnjfzdh3wx5m5phvma3umrq8k6tq2p9",
+   *     amount: [{ denom: "utia", amount: "10000" }],
+   *   },
+   * };
+   * const sendMsgAny = registry.encodeAsAny(sendMsg);
+   *
+   * const broadcastedTx = await txClient.broadcastMessage(sendMsgAny);
+   * console.log("Tx hash:", broadcastedTx.hash);
+   * const txInfo = await txClient.confirmTx(broadcastedTx);
+   * ```
+   */
+  broadcastMessage(message: ProtoAny, tx_config?: TxConfig | null): Promise<BroadcastedTx>;
+  /**
+   * Estimate gas price for given transaction priority based
+   * on the gas prices of the transactions in the last five blocks.
+   *
+   * If no transaction is found in the last five blocks, return the network
+   * min gas price.
+   */
+  estimateGasPrice(priority: TxPriority): Promise<number>;
+  /**
+   * Get block by height
+   */
+  getBlockByHeight(height: bigint): Promise<Block>;
+  /**
+   * Retrieves the verified Celestia coin balance for the address.
+   *
+   * # Notes
+   *
+   * This returns the verified balance which is the one that was reported by
+   * the previous network block. In other words, if you transfer some coins,
+   * you need to wait 1 more block in order to see the new balance. If you want
+   * something more immediate then use [`GrpcClient::get_balance`].
+   */
+  getVerifiedBalance(address: string, header: ExtendedHeader): Promise<Coin>;
+  /**
+   * Get balance of all spendable coins
+   */
+  getSpendableBalances(address: string): Promise<Coin[]>;
+  /**
+   * Get Tx
+   */
+  getTx(hash: string): Promise<GetTxResponse>;
+  /**
+   * Simulate prepared and serialised transaction, returning simulated gas usage
+   */
+  simulate(tx_bytes: Uint8Array): Promise<GasInfo>;
+  /**
+   * Create a builder for [`GrpcClient`] connected to `url`
+   */
+  static withUrl(url: string): GrpcClientBuilder;
+  /**
+   * Get status of the transaction
+   */
+  txStatus(hash: string): Promise<TxStatusResponse>;
+  /**
+   * Create a builder for [`GrpcClient`] with multiple URL endpoints for fallback support.
+   *
+   * When multiple endpoints are configured, the client will automatically
+   * fall back to the next endpoint if a network-related error occurs.
+   */
+  static withUrls(urls: string[]): GrpcClientBuilder;
+  /**
+   * AppVersion of the client
+   */
+  readonly appVersion: Promise<AppVersion>;
+  /**
+   * Chain id of the client
+   */
+  readonly chainId: Promise<string>;
+}
+/**
+ * Builder for [`GrpcClient`] and [`TxClient`].
  *
  * Url must point to a [grpc-web proxy](https://github.com/grpc/grpc/blob/master/doc/PROTOCOL-WEB.md).
  *
@@ -1581,6 +1702,7 @@ export class GrpcClient {
  * ```js
  * const client = await GrpcClient
  *   .withUrl("http://127.0.0.1:18080")
+ *   .withTimeout(5000)  // Optional: 5 second timeout
  *   .build()
  * ```
  *
@@ -1625,19 +1747,12 @@ export class GrpcClientBuilder {
   private constructor();
   free(): void;
   /**
-   * Set the `url` of the grpc-web server to connect to
+   * Sets the request timeout in milliseconds, overriding default one from the transport.
    *
    * Note that this method **consumes** builder and returns updated instance of it.
    * Make sure to re-assign it if you keep builder in a variable.
    */
-  withUrl(url: string): GrpcClientBuilder;
-  /**
-   * Add public key and signer to the client being built
-   *
-   * Note that this method **consumes** builder and returns updated instance of it.
-   * Make sure to re-assign it if you keep builder in a variable.
-   */
-  withPubkeyAndSigner(account_pubkey: Uint8Array, signer_fn: SignerFn): GrpcClientBuilder;
+  withTimeout(timeout_ms: bigint): GrpcClientBuilder;
   /**
    * Appends ascii metadata to all requests made by the client.
    *
@@ -1654,10 +1769,34 @@ export class GrpcClientBuilder {
    * Make sure to re-assign it if you keep builder in a variable.
    */
   withMetadataBin(key: string, value: Uint8Array): GrpcClientBuilder;
+  /**
+   * Add public key and signer to the client being built
+   *
+   * Note that this method **consumes** builder and returns updated instance of it.
+   * Make sure to re-assign it if you keep builder in a variable.
+   */
+  withPubkeyAndSigner(account_pubkey: Uint8Array, signer_fn: SignerFn): GrpcClientBuilder;
   /**
    * build gRPC client
    */
   build(): GrpcClient;
+  /**
+   * Set the `url` of the grpc-web server to connect to
+   *
+   * Note that this method **consumes** builder and returns updated instance of it.
+   * Make sure to re-assign it if you keep builder in a variable.
+   */
+  withUrl(url: string): GrpcClientBuilder;
+  /**
+   * Add multiple URL endpoints at once for fallback support.
+   *
+   * When multiple endpoints are configured, the client will automatically
+   * fall back to the next endpoint if a network-related error occurs.
+   *
+   * Note that this method **consumes** builder and returns updated instance of it.
+   * Make sure to re-assign it if you keep builder in a variable.
+   */
+  withUrls(urls: string[]): GrpcClientBuilder;
 }
 /**
  * Block Header values contain metadata about the block and about the consensus,
@@ -1747,18 +1886,18 @@ export class Header {
 export class IntoUnderlyingByteSource {
   private constructor();
   free(): void;
-  start(controller: ReadableByteStreamController): void;
   pull(controller: ReadableByteStreamController): Promise<any>;
+  start(controller: ReadableByteStreamController): void;
   cancel(): void;
-  readonly type: ReadableStreamType;
   readonly autoAllocateChunkSize: number;
+  readonly type: ReadableStreamType;
 }
 export class IntoUnderlyingSink {
   private constructor();
   free(): void;
-  write(chunk: any): Promise<any>;
-  close(): Promise<any>;
   abort(reason: any): Promise<any>;
+  close(): Promise<any>;
+  write(chunk: any): Promise<any>;
 }
 export class IntoUnderlyingSource {
   private constructor();
@@ -1766,6 +1905,21 @@ export class IntoUnderlyingSource {
   pull(controller: ReadableStreamDefaultController): Promise<any>;
   cancel(): void;
 }
+export class IteratorResultObject {
+  private constructor();
+  free(): void;
+  /**
+   * Has the value true if the iterator is past the end of the
+   * iterated sequence. In this case value optionally specifies
+   * the return value of the iterator.
+   */
+  done: boolean;
+  /**
+   * Any JavaScript value returned by the iterator.
+   * Can be omitted when done is true.
+   */
+  value: any;
+}
 /**
  * Array of bits
  */
@@ -1860,6 +2014,12 @@ export class ModeInfo {
    * Return signature mode for the stored signature(s)
    */
   signature_mode(): SignatureMode;
+  /**
+   * Multi is the mode info for a multisig public key
+   * mode_infos is the corresponding modes of the signers of the multisig
+   * which could include nested multisig public keys
+   */
+  readonly mode_infos: ModeInfo[] | undefined;
   /**
    * Single is the mode info for a single signer. It is structured as a message
    * to allow for additional fields such as locale for SIGN_MODE_TEXTUAL in the
@@ -1871,12 +2031,6 @@ export class ModeInfo {
    * bitarray specifies which keys within the multisig are signing
    */
   readonly bitarray: JsBitVector | undefined;
-  /**
-   * Multi is the mode info for a multisig public key
-   * mode_infos is the corresponding modes of the signers of the multisig
-   * which could include nested multisig public keys
-   */
-  readonly mode_infos: ModeInfo[] | undefined;
 }
 /**
  * Namespace of the data published to the celestia network.
@@ -1911,13 +2065,9 @@ export class Namespace {
   toString(): string;
   free(): void;
   /**
-   * Create a new [`Namespace`] version `0` with given id.
-   *
-   * Check [`Namespace::new_v0`] for more details.
-   *
-   * [`Namespace::new_v0`]: https://docs.rs/celestia-types/latest/celestia_types/nmt/struct.Namespace.html#method.new_v0
+   * Converts the [`Namespace`] to a byte slice.
    */
-  static newV0(id: Uint8Array): Namespace;
+  asBytes(): Uint8Array;
   /**
    * Create a new [`Namespace`] from the raw bytes.
    *
@@ -1929,28 +2079,44 @@ export class Namespace {
    */
   static fromRaw(raw: Uint8Array): Namespace;
   /**
-   * Converts the [`Namespace`] to a byte slice.
+   * Create a new [`Namespace`] version `0` with given id.
+   *
+   * Check [`Namespace::new_v0`] for more details.
+   *
+   * [`Namespace::new_v0`]: https://docs.rs/celestia-types/latest/celestia_types/nmt/struct.Namespace.html#method.new_v0
    */
-  asBytes(): Uint8Array;
+  static newV0(id: Uint8Array): Namespace;
   /**
    * Namespace size in bytes.
    */
   static readonly NS_SIZE: number;
+  /**
+   * Returns the first byte indicating the version of the [`Namespace`].
+   */
+  readonly version: number;
   /**
    * Primary reserved [`Namespace`] for the compact `Share`s with `cosmos SDK` transactions.
    */
   static readonly TRANSACTION: Namespace;
+  /**
+   * The [`Namespace`] for `parity shares`.
+   *
+   * It is the namespace with which all the `parity shares` from
+   * `ExtendedDataSquare` are inserted to the `Nmt` when computing
+   * merkle roots.
+   */
+  static readonly PARITY_SHARE: Namespace;
   /**
    * Primary reserved [`Namespace`] for the compact Shares with MsgPayForBlobs transactions.
    */
   static readonly PAY_FOR_BLOB: Namespace;
   /**
-   * Primary reserved [`Namespace`] for the `Share`s used for padding.
+   * Secondary reserved [`Namespace`] used for padding after the blobs.
    *
-   * `Share`s with this namespace are inserted after other shares from primary reserved namespace
-   * so that user-defined namespaces are correctly aligned in `ExtendedDataSquare`
+   * It is used to fill up the `original data square` after all user-submitted
+   * blobs before the parity data is generated for the `ExtendedDataSquare`.
    */
-  static readonly PRIMARY_RESERVED_PADDING: Namespace;
+  static readonly TAIL_PADDING: Namespace;
   /**
    * Maximal primary reserved [`Namespace`].
    *
@@ -1964,24 +2130,12 @@ export class Namespace {
    */
   static readonly MIN_SECONDARY_RESERVED: Namespace;
   /**
-   * Secondary reserved [`Namespace`] used for padding after the blobs.
-   *
-   * It is used to fill up the `original data square` after all user-submitted
-   * blobs before the parity data is generated for the `ExtendedDataSquare`.
-   */
-  static readonly TAIL_PADDING: Namespace;
-  /**
-   * The [`Namespace`] for `parity shares`.
+   * Primary reserved [`Namespace`] for the `Share`s used for padding.
    *
-   * It is the namespace with which all the `parity shares` from
-   * `ExtendedDataSquare` are inserted to the `Nmt` when computing
-   * merkle roots.
-   */
-  static readonly PARITY_SHARE: Namespace;
-  /**
-   * Returns the first byte indicating the version of the [`Namespace`].
+   * `Share`s with this namespace are inserted after other shares from primary reserved namespace
+   * so that user-defined namespaces are correctly aligned in `ExtendedDataSquare`
    */
-  readonly version: number;
+  static readonly PRIMARY_RESERVED_PADDING: Namespace;
   /**
    * Returns the trailing 28 bytes indicating the id of the [`Namespace`].
    */
@@ -2019,118 +2173,142 @@ export class NetworkInfoSnapshot {
 export class NodeClient {
   free(): void;
   /**
-   * Create a new connection to a Lumina node running in [`NodeWorker`]. Provided `port` is
-   * expected to have `MessagePort`-like interface for sending and receiving messages.
+   * Check whether Lumina is currently running
    */
-  constructor(port: any);
+  isRunning(): Promise<boolean>;
   /**
-   * Establish a new connection to the existing worker over provided port
+   * Get synced headers from the given heights range.
+   *
+   * If start of the range is undefined (None), the first returned header will be of height 1.
+   * If end of the range is undefined (None), the last returned header will be the last header in the
+   * store.
+   *
+   * # Errors
+   *
+   * If range contains a height of a header that is not found in the store.
    */
-  addConnectionToWorker(port: any): Promise<void>;
+  getHeaders(start_height?: bigint | null, end_height?: bigint | null): Promise<ExtendedHeader[]>;
   /**
-   * Check whether Lumina is currently running
+   * Get current header syncing info.
    */
-  isRunning(): Promise<boolean>;
+  syncerInfo(): Promise<SyncingInfoSnapshot>;
   /**
-   * Start a node with the provided config, if it's not running
+   * Get current network info.
    */
-  start(config: NodeConfig): Promise<void>;
-  stop(): Promise<void>;
+  networkInfo(): Promise<NetworkInfoSnapshot>;
   /**
    * Get node's local peer ID.
    */
   localPeerId(): Promise<string>;
   /**
-   * Get current [`PeerTracker`] info.
+   * Subscribe to the shares from the namespace, as new headers are received by the node
+   *
+   * Return an async iterator which will yield all the blobs from the namespace, as the new headers
+   * are being received by the node, starting from the first header received after the call.
    */
-  peerTrackerInfo(): Promise<PeerTrackerInfoSnapshot>;
+  blobSubscribe(namespace: Namespace): Promise<AsyncIterable<BlobsAtHeight | SubscriptionError>>;
+  /**
+   * Returns a [`BroadcastChannel`] for events generated by [`Node`].
+   */
+  eventsChannel(): Promise<BroadcastChannel>;
+  /**
+   * Trust or untrust the peer with a given ID.
+   */
+  setPeerTrust(peer_id: string, is_trusted: boolean): Promise<void>;
   /**
    * Wait until the node is connected to at least 1 peer.
    */
   waitConnected(): Promise<void>;
   /**
-   * Wait until the node is connected to at least 1 trusted peer.
+   * Get all the peers that node is connected to.
    */
-  waitConnectedTrusted(): Promise<void>;
+  connectedPeers(): Promise<Array<any>>;
   /**
-   * Get current network info.
+   * Subscribe to new headers received by the node from the network.
+   *
+   * Return an async iterator which will yield all the headers, as they are being received by the
+   * node, starting from the first header received after the call.
    */
-  networkInfo(): Promise<NetworkInfoSnapshot>;
+  headerSubscribe(): Promise<AsyncIterable<ExtendedHeader | SubscriptionError>>;
   /**
-   * Get all the multiaddresses on which the node listens.
+   * Get current [`PeerTracker`] info.
    */
-  listeners(): Promise<Array<any>>;
+  peerTrackerInfo(): Promise<PeerTrackerInfoSnapshot>;
   /**
-   * Get all the peers that node is connected to.
+   * Request all blobs with provided namespace in the block corresponding to this header
+   * using bitswap protocol.
    */
-  connectedPeers(): Promise<Array<any>>;
+  requestAllBlobs(namespace: Namespace, block_height: bigint, timeout_secs?: number | null): Promise<Blob[]>;
   /**
-   * Trust or untrust the peer with a given ID.
+   * Get a synced header for the block with a given hash.
    */
-  setPeerTrust(peer_id: string, is_trusted: boolean): Promise<void>;
+  getHeaderByHash(hash: string): Promise<ExtendedHeader>;
+  /**
+   * Subscribe to the blobs from the namespace, as new headers are received by the node
+   *
+   * Return an async iterator which will yield all the shares from the namespace, as the new headers
+   * are being received by the node, starting from the first header received after the call.
+   */
+  namespaceSubscribe(namespace: Namespace): Promise<AsyncIterable<SharesAtHeight | SubscriptionError>>;
   /**
    * Request the head header from the network.
    */
   requestHeadHeader(): Promise<ExtendedHeader>;
   /**
-   * Request a header for the block with a given hash from the network.
+   * Get a synced header for the block with a given height.
    */
-  requestHeaderByHash(hash: string): Promise<ExtendedHeader>;
+  getHeaderByHeight(height: bigint): Promise<ExtendedHeader>;
   /**
-   * Request a header for the block with a given height from the network.
+   * Get the latest locally synced header.
    */
-  requestHeaderByHeight(height: bigint): Promise<ExtendedHeader>;
+  getLocalHeadHeader(): Promise<ExtendedHeader>;
   /**
-   * Request headers in range (from, from + amount] from the network.
-   *
-   * The headers will be verified with the `from` header.
+   * Get data sampling metadata of an already sampled height.
    */
-  requestVerifiedHeaders(from: ExtendedHeader, amount: bigint): Promise<ExtendedHeader[]>;
+  getSamplingMetadata(height: bigint): Promise<SamplingMetadata | undefined>;
   /**
-   * Request all blobs with provided namespace in the block corresponding to this header
-   * using bitswap protocol.
+   * Request a header for the block with a given hash from the network.
    */
-  requestAllBlobs(namespace: Namespace, block_height: bigint, timeout_secs?: number | null): Promise<Blob[]>;
+  requestHeaderByHash(hash: string): Promise<ExtendedHeader>;
   /**
-   * Get current header syncing info.
+   * Wait until the node is connected to at least 1 trusted peer.
    */
-  syncerInfo(): Promise<SyncingInfoSnapshot>;
+  waitConnectedTrusted(): Promise<void>;
   /**
    * Get the latest header announced in the network.
    */
   getNetworkHeadHeader(): Promise<ExtendedHeader | undefined>;
   /**
-   * Get the latest locally synced header.
+   * Establish a new connection to the existing worker over provided port
    */
-  getLocalHeadHeader(): Promise<ExtendedHeader>;
+  addConnectionToWorker(port: any): Promise<void>;
   /**
-   * Get a synced header for the block with a given hash.
+   * Request a header for the block with a given height from the network.
    */
-  getHeaderByHash(hash: string): Promise<ExtendedHeader>;
+  requestHeaderByHeight(height: bigint): Promise<ExtendedHeader>;
   /**
-   * Get a synced header for the block with a given height.
+   * Request headers in range (from, from + amount] from the network.
+   *
+   * The headers will be verified with the `from` header.
    */
-  getHeaderByHeight(height: bigint): Promise<ExtendedHeader>;
+  requestVerifiedHeaders(from: ExtendedHeader, amount: bigint): Promise<ExtendedHeader[]>;
   /**
-   * Get synced headers from the given heights range.
-   *
-   * If start of the range is undefined (None), the first returned header will be of height 1.
-   * If end of the range is undefined (None), the last returned header will be the last header in the
-   * store.
-   *
-   * # Errors
-   *
-   * If range contains a height of a header that is not found in the store.
+   * Create a new connection to a Lumina node running in [`NodeWorker`]. Provided `port` is
+   * expected to have `MessagePort`-like interface for sending and receiving messages.
    */
-  getHeaders(start_height?: bigint | null, end_height?: bigint | null): Promise<ExtendedHeader[]>;
+  constructor(port: any);
   /**
-   * Get data sampling metadata of an already sampled height.
+   * Stop the node.
    */
-  getSamplingMetadata(height: bigint): Promise<SamplingMetadata | undefined>;
+  stop(): Promise<void>;
   /**
-   * Returns a [`BroadcastChannel`] for events generated by [`Node`].
+   * Start the node with the provided config, if it's not running
    */
-  eventsChannel(): Promise<BroadcastChannel>;
+  start(config: NodeConfig): Promise<void>;
+  /**
+   * Get all the multiaddresses on which the node listens.
+   */
+  listeners(): Promise<Array<any>>;
 }
 /**
  * Config for the lumina wasm node.
@@ -2209,7 +2387,13 @@ export class NodeConfig {
  */
 export class NodeWorker {
   free(): void;
+  /**
+   * Create a new `NodeWorker` with a port-like JS object.
+   */
   constructor(port_like_object: any);
+  /**
+   * Run `NodeWorker` main loop.
+   */
   run(): Promise<void>;
 }
 /**
@@ -2302,6 +2486,58 @@ export class SamplingMetadata {
    */
   readonly cids: Uint8Array[];
 }
+/**
+ * A single fixed-size chunk of data which is used to form an [`ExtendedDataSquare`].
+ *
+ * All data in Celestia is split into [`Share`]s before being put into a
+ * block's data square. See [`Blob::to_shares`].
+ *
+ * All shares have the fixed size of 512 bytes and the following structure:
+ *
+ * ```text
+ * | Namespace | InfoByte | (optional) sequence length | data |
+ * ```
+ *
+ * `sequence length` is the length of the original data in bytes and is present only in the first of the shares the data was split into.
+ *
+ * [`ExtendedDataSquare`]: crate::eds::ExtendedDataSquare
+ * [`Blob::to_shares`]: crate::Blob::to_shares
+ */
+export class Share {
+  private constructor();
+/**
+** Return copy of self without private attributes.
+*/
+  toJSON(): Object;
+/**
+* Return stringified version of self.
+*/
+  toString(): string;
+  free(): void;
+}
+/**
+ * A list of shares that were published at particular height.
+ */
+export class SharesAtHeight {
+  private constructor();
+/**
+** Return copy of self without private attributes.
+*/
+  toJSON(): Object;
+/**
+* Return stringified version of self.
+*/
+  toString(): string;
+  free(): void;
+  /**
+   * height the shares were published at
+   */
+  height: bigint;
+  /**
+   * shares published
+   */
+  shares: Share[];
+}
 /**
  * Signature
  */
@@ -2360,6 +2596,25 @@ export class StringEvent {
   type: string;
   attributes: Attribute[];
 }
+/**
+ * Error thrown while processing subscription
+ */
+export class SubscriptionError {
+  private constructor();
+  free(): void;
+  /**
+   * Height at which the error occurred, if applicable
+   */
+  get height(): bigint | undefined;
+  /**
+   * Height at which the error occurred, if applicable
+   */
+  set height(value: bigint | null | undefined);
+  /**
+   * error message
+   */
+  error: string;
+}
 /**
  * Status of the synchronization.
  */
@@ -2410,17 +2665,6 @@ export class Tx {
 export class TxBody {
   private constructor();
   free(): void;
-  /**
-   * `messages` is a list of messages to be executed. The required signers of
-   * those messages define the number and order of elements in `AuthInfo`'s
-   * signer_infos and Tx's signatures. Each required signer address is added to
-   * the list only the first time it occurs.
-   *
-   * By convention, the first required signer (usually from the first message)
-   * is referred to as the primary signer and pays the fee for the whole
-   * transaction.
-   */
-  messages(): ProtoAny[];
   /**
    * `extension_options` are arbitrary options that can be added by chains
    * when the default options are not sufficient. If any of these are present
@@ -2433,6 +2677,17 @@ export class TxBody {
    * and can't be handled, they will be ignored
    */
   non_critical_extension_options(): ProtoAny[];
+  /**
+   * `messages` is a list of messages to be executed. The required signers of
+   * those messages define the number and order of elements in `AuthInfo`'s
+   * signer_infos and Tx's signatures. Each required signer address is added to
+   * the list only the first time it occurs.
+   *
+   * By convention, the first required signer (usually from the first message)
+   * is referred to as the primary signer and pays the fee for the whole
+   * transaction.
+   */
+  messages(): ProtoAny[];
   /**
    * `memo` is any arbitrary memo to be added to the transaction.
    */
@@ -2449,6 +2704,17 @@ export class TxBody {
 export class TxResponse {
   private constructor();
   free(): void;
+  /**
+   * Events defines all the events emitted by processing a transaction. Note,
+   * these events include those emitted by processing all the messages and those
+   * emitted from the ante. Whereas Logs contains the events, with
+   * additional metadata, emitted only by processing the messages.
+   */
+  readonly events: JsEvent[];
+  /**
+   * The block height
+   */
+  readonly height: bigint;
   /**
    * Namespace for the Code
    */
@@ -2488,17 +2754,6 @@ export class TxResponse {
    * it's genesis time.
    */
   timestamp: string;
-  /**
-   * The block height
-   */
-  readonly height: bigint;
-  /**
-   * Events defines all the events emitted by processing a transaction. Note,
-   * these events include those emitted by processing all the messages and those
-   * emitted from the ante. Whereas Logs contains the events, with
-   * additional metadata, emitted only by processing the messages.
-   */
-  readonly events: JsEvent[];
 }
 /**
  * Response to a tx status query
@@ -2506,6 +2761,10 @@ export class TxResponse {
 export class TxStatusResponse {
   private constructor();
   free(): void;
+  /**
+   * Height of the block in which the transaction was committed.
+   */
+  readonly height: bigint;
   /**
    * Index of the transaction in block.
    */
@@ -2524,10 +2783,6 @@ export class TxStatusResponse {
    * Status of the transaction.
    */
   status: TxStatus;
-  /**
-   * Height of the block in which the transaction was committed.
-   */
-  readonly height: bigint;
 }
 /**
  * Address of a validator.