@miden-sdk/miden-sdk 0.15.6 → 0.16.0-alpha.1

package/js/resources/transactions.js

@@ -79,97 +79,6 @@ export class TransactionsResource {
     return { txId, note: null, result };
   }
 
-  /**
-   * Builds a Public custom-script note carrying a NetworkAccountTarget
-   * attachment, submits it as an own output note, and optionally waits for
-   * confirmation. Provide exactly one of `recipient` or `script`.
-   */
-  async createNetworkNote(opts) {
-    this.#client.assertNotTerminated();
-    const wasm = await this.#getWasm();
-
-    if (opts.recipient && opts.script) {
-      throw new Error(
-        "createNetworkNote requires exactly one of `recipient` or `script`, not both."
-      );
-    }
-
-    const senderId = resolveAccountRef(opts.account, wasm);
-
-    const target =
-      opts.target instanceof wasm.NetworkAccountTarget
-        ? opts.target
-        : new wasm.NetworkAccountTarget(
-            resolveAccountRef(opts.target, wasm),
-            opts.executionHint
-          );
-
-    const noteAssets = opts.assets
-      ? new wasm.NoteAssets(
-          (Array.isArray(opts.assets) ? opts.assets : [opts.assets]).map(
-            (a) =>
-              new wasm.FungibleAsset(
-                resolveAccountRef(a.token, wasm),
-                BigInt(a.amount)
-              )
-          )
-        )
-      : new wasm.NoteAssets();
-
-    const metadata = new wasm.NoteMetadata(
-      senderId,
-      wasm.NoteType.Public,
-      wasm.NoteTag.withAccountTarget(target.targetId())
-    );
-
-    let recipient = opts.recipient;
-    if (!recipient) {
-      if (!opts.script) {
-        throw new Error(
-          "createNetworkNote requires either `recipient` or `script`."
-        );
-      }
-      const storage = new wasm.NoteStorage(
-        new wasm.FeltArray(
-          (opts.inputs ?? []).map((value) => new wasm.Felt(value))
-        )
-      );
-      recipient = wasm.NoteRecipient.fromScript(opts.script, storage);
-    }
-
-    const attachments = [target.toAttachment()];
-    if (opts.attachment) {
-      attachments.push(new wasm.NoteAttachment(opts.attachment));
-    }
-
-    const note = wasm.Note.withAttachments(
-      noteAssets,
-      metadata,
-      recipient,
-      attachments
-    );
-
-    // NoteArray constructor consumes its elements; use push(&note) to keep
-    // `note` valid so we can return it to the caller.
-    const ownOutputs = new wasm.NoteArray();
-    ownOutputs.push(note);
-    const request = new wasm.TransactionRequestBuilder()
-      .withOwnOutputNotes(ownOutputs)
-      .build();
-
-    const { txId, result } = await this.#submitOrSubmitWithProver(
-      senderId,
-      request,
-      opts.prover
-    );
-
-    if (opts.waitForConfirmation) {
-      await this.waitFor(txId.toHex(), { timeout: opts.timeout });
-    }
-
-    return { txId, note, result };
-  }
-
   async mint(opts) {
     this.#client.assertNotTerminated();
     const wasm = await this.#getWasm();
@@ -188,24 +97,6 @@ export class TransactionsResource {
     return { txId, result };
   }
 
-  async bridge(opts) {
-    this.#client.assertNotTerminated();
-    const wasm = await this.#getWasm();
-    const { accountId, request } = await this.#buildB2AggRequest(opts, wasm);
-
-    const { txId, result } = await this.#submitOrSubmitWithProver(
-      accountId,
-      request,
-      opts.prover
-    );
-
-    if (opts.waitForConfirmation) {
-      await this.waitFor(txId.toHex(), { timeout: opts.timeout });
-    }
-
-    return { txId, result };
-  }
-
   async consume(opts) {
     this.#client.assertNotTerminated();
     const wasm = await this.#getWasm();
@@ -352,6 +243,14 @@ export class TransactionsResource {
     return { txId, result };
   }
 
+  /**
+   * Dry-run a transaction to obtain the TransactionSummary pending
+   * authorization (e.g. a multisig below its signing threshold). Rejects
+   * with an error carrying `code: "TRANSACTION_ALREADY_AUTHORIZED"` (on
+   * Node.js the code prefixes the message instead) when the transaction
+   * executes successfully, since a fully authorized transaction produces
+   * no summary. See {@link PreviewOptions}.
+   */
   async preview(opts) {
     this.#client.assertNotTerminated();
     const wasm = await this.#getWasm();
@@ -368,10 +267,6 @@ export class TransactionsResource {
         ({ accountId, request } = await this.#buildMintRequest(opts, wasm));
         break;
       }
-      case "bridge": {
-        ({ accountId, request } = await this.#buildB2AggRequest(opts, wasm));
-        break;
-      }
       case "consume": {
         ({ accountId, request } = await this.#buildConsumeRequest(opts, wasm));
         break;
@@ -416,163 +311,6 @@ export class TransactionsResource {
   async execute(opts) {
     this.#client.assertNotTerminated();
     const wasm = await this.#getWasm();
-    const { accountId, request } = this.#buildExecuteRequest(opts, wasm);
-
-    const { txId, result } = await this.#submitOrSubmitWithProver(
-      accountId,
-      request,
-      opts.prover
-    );
-
-    if (opts.waitForConfirmation) {
-      await this.waitFor(txId.toHex(), { timeout: opts.timeout });
-    }
-
-    return { txId, result };
-  }
-
-  /**
-   * Submit a heterogeneous batch of operations against a single account. All
-   * operations are executed, proven individually and as a batch, and submitted
-   * atomically — either every tx in the batch lands or none does.
-   *
-   * @param {BatchOptions} opts - Batch options including the account, operations array, and confirmation settings.
-   * @returns {Promise<BatchSubmitResult>} The block number the batch was accepted into.
-   */
-  async batch(opts) {
-    this.#client.assertNotTerminated();
-    const wasm = await this.#getWasm();
-
-    if (!opts || !opts.account) {
-      throw new Error("batch: `account` is required");
-    }
-    if (!Array.isArray(opts.operations) || opts.operations.length === 0) {
-      throw new Error("batch: `operations` must be a non-empty array");
-    }
-
-    // Build each TransactionRequest. Per-op builders all use the batch-level
-    // `account` — V1 only supports same-account batches, mirroring the Rust
-    // constraint. We forward `opts.account` into each per-op options object so
-    // the existing builders' `resolveAccountRef` produces fresh AccountIds
-    // when needed.
-    const requests = [];
-    for (let i = 0; i < opts.operations.length; i++) {
-      const op = opts.operations[i];
-      let built;
-      switch (op?.kind) {
-        case "send":
-          built = await this.#buildSendRequest(
-            { ...op, account: opts.account },
-            wasm
-          );
-          break;
-        case "mint":
-          built = await this.#buildMintRequest(
-            { ...op, account: opts.account },
-            wasm
-          );
-          break;
-        case "consume":
-          built = await this.#buildConsumeRequest(
-            { ...op, account: opts.account },
-            wasm
-          );
-          break;
-        case "swap":
-          built = await this.#buildSwapRequest(
-            { ...op, account: opts.account },
-            wasm
-          );
-          break;
-        case "execute":
-          built = this.#buildExecuteRequest(
-            { ...op, account: opts.account },
-            wasm
-          );
-          break;
-        case "custom":
-          if (!op.request) {
-            throw new Error(
-              `batch: operation[${i}] of kind "custom" is missing \`request\``
-            );
-          }
-          built = { request: op.request };
-          break;
-        default:
-          throw new Error(
-            `batch: operation[${i}] has unknown kind "${op?.kind}"`
-          );
-      }
-      requests.push(built.request);
-    }
-
-    return this.submitBatch(opts.account, requests, opts);
-  }
-
-  /**
-   * Submit pre-built TransactionRequests as an atomic batch. Lower-level
-   * counterpart of `batch()` — for callers that already have built requests in
-   * hand. Equivalent to `submit()` but plural.
-   *
-   * @param {AccountRef} account - The account executing the batch.
-   * @param {TransactionRequest[]} requests - Pre-built transaction requests.
-   * @param {object} [options] - Optional settings (waitForConfirmation, timeout).
-   *   The batch is proved with the client's configured prover; the V1 batch API
-   *   has no per-call prover override.
-   * @returns {Promise<BatchSubmitResult>} The block number the batch was accepted into.
-   */
-  async submitBatch(account, requests, options) {
-    this.#client.assertNotTerminated();
-    const wasm = await this.#getWasm();
-
-    if (!Array.isArray(requests) || requests.length === 0) {
-      throw new Error("submitBatch: `requests` must be a non-empty array");
-    }
-
-    const accountId = resolveAccountRef(account, wasm);
-    const blockNumber = await this.#inner.submitNewTransactionBatch(
-      accountId,
-      requests.map((r) => r.serialize())
-    );
-
-    if (options?.waitForConfirmation) {
-      await this.#waitForBlock(blockNumber, options);
-    }
-
-    return { blockNumber };
-  }
-
-  /**
-   * Polls until the local sync height reaches `blockNumber` or the timeout
-   * expires. The Rust V1 batch API returns only a block number — there are no
-   * per-tx ids to poll on, so we wait on the chain height instead.
-   *
-   * @param {number} blockNumber - The block height to wait for.
-   * @param {object} [opts] - Polling options (timeout, interval).
-   */
-  async #waitForBlock(blockNumber, opts) {
-    const timeout = opts?.timeout ?? 60_000;
-    const interval = opts?.interval ?? 5_000;
-    const start = Date.now();
-
-    while (true) {
-      if (timeout > 0 && Date.now() - start >= timeout) {
-        throw new Error(
-          `Batch confirmation timed out after ${timeout}ms (waiting for block ${blockNumber})`
-        );
-      }
-      try {
-        await this.#inner.syncStateWithTimeout(0);
-      } catch {
-        // sync may fail transiently; continue polling
-      }
-      const height = await this.#inner.getSyncHeight();
-      if (height >= blockNumber) return;
-      await new Promise((resolve) => setTimeout(resolve, interval));
-    }
-  }
-
-  #buildExecuteRequest(opts, wasm) {
     const accountId = resolveAccountRef(opts.account, wasm);
 
     let builder = new wasm.TransactionRequestBuilder().withCustomScript(
@@ -600,7 +338,18 @@ export class TransactionsResource {
       );
     }
 
-    return { accountId, request: builder.build() };
+    const request = builder.build();
+    const { txId, result } = await this.#submitOrSubmitWithProver(
+      accountId,
+      request,
+      opts.prover
+    );
+
+    if (opts.waitForConfirmation) {
+      await this.waitFor(txId.toHex(), { timeout: opts.timeout });
+    }
+
+    return { txId, result };
   }
 
   async executeProgram(opts) {
@@ -773,24 +522,6 @@ export class TransactionsResource {
     return { accountId, request };
   }
 
-  async #buildB2AggRequest(opts, wasm) {
-    const accountId = resolveAccountRef(opts.account, wasm);
-    const bridgeAccountId = resolveAccountRef(opts.bridgeAccount, wasm);
-    const faucetId = resolveAccountRef(opts.token, wasm);
-    const amount = BigInt(opts.amount);
-    const destinationAddress = wasm.EthAddress.fromHex(opts.destinationAddress);
-
-    const request = await this.#inner.newB2AggTransactionRequest(
-      accountId,
-      bridgeAccountId,
-      faucetId,
-      amount,
-      opts.destinationNetwork,
-      destinationAddress
-    );
-    return { accountId, request };
-  }
-
   async #buildConsumeRequest(opts, wasm) {
     const accountId = resolveAccountRef(opts.account, wasm);
     const noteInputs = Array.isArray(opts.notes) ? opts.notes : [opts.notes];

package/js/standalone.js

@@ -101,70 +101,12 @@ export function buildSwapTag(opts) {
 
 function buildNoteAssets(assets, wasm) {
   const assetArray = Array.isArray(assets) ? assets : [assets];
+  if (assetArray.length === 0) {
+    throw new TypeError("P2ID and P2IDE notes require at least one asset");
+  }
   const fungibleAssets = assetArray.map((asset) => {
     const faucetId = resolveAccountRef(asset.token, wasm);
     return new wasm.FungibleAsset(faucetId, BigInt(asset.amount));
   });
   return new wasm.NoteAssets(fungibleAssets);
 }
-
-/**
- * Builds a Public custom-script note carrying a NetworkAccountTarget attachment
- * (does not submit). Provide exactly one of `recipient` or `script`.
- *
- * @param {NetworkNoteOptions} opts
- * @returns {Note}
- */
-export function buildNetworkNote(opts) {
-  const wasm = getWasm();
-  if (opts.recipient && opts.script) {
-    throw new Error(
-      "buildNetworkNote requires exactly one of `recipient` or `script`, not both."
-    );
-  }
-  const sender = resolveAccountRef(opts.account, wasm);
-
-  const target =
-    opts.target instanceof wasm.NetworkAccountTarget
-      ? opts.target
-      : new wasm.NetworkAccountTarget(
-          resolveAccountRef(opts.target, wasm),
-          opts.executionHint
-        );
-
-  const noteAssets = opts.assets
-    ? buildNoteAssets(opts.assets, wasm)
-    : new wasm.NoteAssets();
-
-  const metadata = new wasm.NoteMetadata(
-    sender,
-    wasm.NoteType.Public,
-    wasm.NoteTag.withAccountTarget(target.targetId())
-  );
-
-  const recipient = opts.recipient ?? buildRecipient(opts, wasm);
-
-  const attachments = [target.toAttachment()];
-  if (opts.attachment) {
-    attachments.push(new wasm.NoteAttachment(opts.attachment));
-  }
-
-  return wasm.Note.withAttachments(
-    noteAssets,
-    metadata,
-    recipient,
-    attachments
-  );
-}
-
-function buildRecipient(opts, wasm) {
-  if (!opts.script) {
-    throw new Error(
-      "buildNetworkNote requires either `recipient` or `script`."
-    );
-  }
-  const storage = new wasm.NoteStorage(
-    new wasm.FeltArray((opts.inputs ?? []).map((value) => new wasm.Felt(value)))
-  );
-  return wasm.NoteRecipient.fromScript(opts.script, storage);
-}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miden-sdk/miden-sdk",
-  "version": "0.15.6",
+  "version": "0.16.0-alpha.1",
   "description": "Miden Wasm SDK",
   "license": "MIT",
   "repository": {
@@ -83,9 +83,9 @@
     "glob": "^11.0.0"
   },
   "optionalDependencies": {
-    "@miden-sdk/node-darwin-arm64": "0.15.6",
-    "@miden-sdk/node-darwin-x64": "0.15.6",
-    "@miden-sdk/node-linux-x64-gnu": "0.15.6"
+    "@miden-sdk/node-darwin-arm64": "0.16.0-alpha.1",
+    "@miden-sdk/node-darwin-x64": "0.16.0-alpha.1",
+    "@miden-sdk/node-linux-x64-gnu": "0.16.0-alpha.1"
   },
   "scripts": {
     "build-rust-client-js": "pnpm --filter web_store run build",