@arkade-os/sdk 0.5.2 → 0.5.4

package/dist/{chunk-HKG26NUT.js → chunk-AG4TFD6F.js}

@@ -18,7 +18,8 @@ var getNetwork = (network) => {
   if (!found) throw new Error(`Unsupported network: ${network}`);
   return found;
 };
-var networkFromArkadeInfo = (info) => getNetwork(info.network);
+var networkFromOperatorInfo = (info) => getNetwork(info.network);
+var networkFromArkadeInfo = networkFromOperatorInfo;
 var networks = {
   bitcoin: withArkPrefix(NETWORK, "ark", "bitcoin"),
   testnet: withArkPrefix(TEST_NETWORK, "tark", "testnet"),
@@ -1170,32 +1171,8 @@ function checkKeyMatch(key, arkPsbtFieldKey, prefixOnly = false) {
   return true;
 }
 
-// src/providers/eventSource.ts
-var GUIDANCE = "Pass one with configureEventSource(url => new EventSource(url)) \u2014 in Node, from the `eventsource` package or by running with --experimental-eventsource. In React Native, use ExpoArkProvider / ExpoIndexerProvider instead.";
-var EventSourceUnavailableError = class extends Error {
-  constructor() {
-    super(`no EventSource is available, so server-sent events cannot be opened. ${GUIDANCE}`);
-    this.name = "EventSourceUnavailableError";
-  }
-};
-function isEventSourceUnavailableError(error) {
-  return error instanceof EventSourceUnavailableError || error instanceof Error && error.name === "EventSourceUnavailableError";
-}
-var configured;
-function configureEventSource(factory) {
-  configured = factory;
-}
-function getConfiguredEventSource() {
-  return configured;
-}
-function resolveEventSource(override) {
-  const factory = override ?? configured ?? (typeof EventSource === "undefined" ? void 0 : (url) => new EventSource(url));
-  if (!factory) throw new EventSourceUnavailableError();
-  return factory;
-}
-
 // package.json
-var version = "0.5.2";
+var version = "0.5.4";
 
 // src/utils/fetch.ts
 var buildVersion = "0.9.9";
@@ -1261,6 +1238,103 @@ function describeRequest(input, init) {
   return { url, method };
 }
 
+// src/providers/sseFrames.ts
+async function* readSseFrames(body) {
+  const reader = body.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  let pendingCR = false;
+  let event = "";
+  let data = [];
+  try {
+    for (; ; ) {
+      const { done, value: chunk } = await reader.read();
+      if (done) return;
+      const text = decoder.decode(chunk, { stream: true });
+      if (!text) continue;
+      const skipLF = pendingCR && text.startsWith("\n");
+      pendingCR = text.endsWith("\r");
+      buffer += (skipLF ? text.slice(1) : text).replace(/\r\n?/g, "\n");
+      const lines = buffer.split("\n");
+      buffer = lines.pop() ?? "";
+      for (const line of lines) {
+        if (line === "") {
+          const joined = data.join("\n");
+          if (joined) yield { event: event || "message", data: joined };
+          event = "";
+          data = [];
+          continue;
+        }
+        const colon = line.indexOf(":");
+        const field = colon === -1 ? line : line.slice(0, colon);
+        const value = colon === -1 ? "" : line.slice(colon + 1).replace(/^ /, "");
+        if (field === "event") event = value;
+        else if (field === "data") data.push(value);
+      }
+    }
+  } finally {
+    await reader.cancel().catch(() => {
+    });
+  }
+}
+
+// src/providers/eventSource.ts
+var GUIDANCE = "Pass one with configureEventSource(url => new EventSource(url)) \u2014 in Node, from the `eventsource` package or by running with --experimental-eventsource. In React Native, use ExpoOperatorProvider / ExpoIndexerProvider instead.";
+var EventSourceUnavailableError = class extends Error {
+  constructor() {
+    super(`no EventSource is available, so server-sent events cannot be opened. ${GUIDANCE}`);
+    this.name = "EventSourceUnavailableError";
+  }
+};
+function isEventSourceUnavailableError(error) {
+  return error instanceof EventSourceUnavailableError || error instanceof Error && error.name === "EventSourceUnavailableError";
+}
+var configured;
+function configureEventSource(factory) {
+  configured = factory;
+}
+function getConfiguredEventSource() {
+  return configured;
+}
+function resolveEventSource(override) {
+  const factory = override ?? configured ?? (typeof globalThis.fetch === "function" && typeof ReadableStream !== "undefined" ? (url, headers) => new FetchEventSource(url, headers) : void 0) ?? (typeof EventSource === "undefined" ? void 0 : (url) => new EventSource(url));
+  if (!factory) throw new EventSourceUnavailableError();
+  return factory;
+}
+var FetchEventSource = class {
+  events = new EventTarget();
+  controller = new AbortController();
+  constructor(url, headers = {}) {
+    this.read(url, headers).catch(() => {
+      if (!this.controller.signal.aborted) this.events.dispatchEvent(new Event("error"));
+    });
+  }
+  addEventListener(type, listener) {
+    this.events.addEventListener(type, listener);
+  }
+  removeEventListener(type, listener) {
+    this.events.removeEventListener(type, listener);
+  }
+  close() {
+    this.controller.abort();
+  }
+  async read(url, headers) {
+    const response = await baseFetch(url, {
+      headers: { Accept: "text/event-stream", ...headers },
+      signal: this.controller.signal
+    });
+    const type = response.headers.get("Content-Type") ?? "";
+    if (response.status !== 200 || !response.body || !/^text\/event-stream\s*(;|$)/i.test(type)) {
+      await response.body?.cancel();
+      throw new Error(`SSE response ${response.status} ${type}`);
+    }
+    for await (const { event, data } of readSseFrames(response.body)) {
+      this.events.dispatchEvent(new MessageEvent(event, { data }));
+    }
+    throw new Error("SSE stream ended");
+  }
+};
+
 // src/providers/errors.ts
 var ArkError = class extends Error {
   constructor(code, message, name, metadata) {
@@ -1355,42 +1429,42 @@ function maybeArkError(error) {
 function isMetadata(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-var Intent;
-((Intent2) => {
+var Proof;
+((Proof2) => {
   function create(message, ins, outputs = []) {
     if (typeof message !== "string") {
       message = encodeMessage(message);
     }
-    if (ins.length == 0) throw new Error("intent proof requires at least one input");
-    const inputs = ins.map(prepareCoinAsIntentProofInput);
+    if (ins.length == 0) throw new Error("proof requires at least one input");
+    const inputs = ins.map(prepareProofInput);
     validateInputs(inputs);
     validateOutputs(outputs);
     const toSpend = craftToSpendTx(message, inputs[0].witnessUtxo.script);
     return craftToSignTx(toSpend, inputs, outputs, message);
   }
-  Intent2.create = create;
+  Proof2.create = create;
   function fee(proof) {
     let sumOfInputs = 0n;
     for (let i = 0; i < proof.inputsLength; i++) {
       const input = proof.getInput(i);
       if (input.witnessUtxo === void 0)
-        throw new Error("intent proof input requires witness utxo");
+        throw new Error("proof input requires witness utxo");
       sumOfInputs += input.witnessUtxo.amount;
     }
     let sumOfOutputs = 0n;
     for (let i = 0; i < proof.outputsLength; i++) {
       const output = proof.getOutput(i);
-      if (output.amount === void 0) throw new Error("intent proof output requires amount");
+      if (output.amount === void 0) throw new Error("proof output requires amount");
       sumOfOutputs += output.amount;
     }
     if (sumOfOutputs > sumOfInputs) {
       throw new Error(
-        `intent proof output amount is greater than input amount: ${sumOfOutputs} > ${sumOfInputs}`
+        `proof output amount is greater than input amount: ${sumOfOutputs} > ${sumOfInputs}`
       );
     }
     return Number(sumOfInputs - sumOfOutputs);
   }
-  Intent2.fee = fee;
+  Proof2.fee = fee;
   function encodeMessage(message) {
     switch (message.type) {
       case "register":
@@ -1413,31 +1487,31 @@ var Intent;
         });
     }
   }
-  Intent2.encodeMessage = encodeMessage;
-})(Intent || (Intent = {}));
+  Proof2.encodeMessage = encodeMessage;
+})(Proof || (Proof = {}));
+var Intent = Proof;
 var OP_RETURN_EMPTY_PKSCRIPT = new Uint8Array([OP.RETURN]);
 var ZERO_32 = new Uint8Array(32).fill(0);
 var MAX_INDEX = 4294967295;
-var TAG_INTENT_PROOF = "ark-intent-proof-message";
+var TAG_PROOF = "ark-intent-proof-message";
 function validateInput(input) {
-  if (input.index === void 0) throw new Error("intent proof input requires index");
-  if (input.txid === void 0) throw new Error("intent proof input requires txid");
-  if (input.witnessUtxo === void 0)
-    throw new Error("intent proof input requires witness utxo");
+  if (input.index === void 0) throw new Error("proof input requires index");
+  if (input.txid === void 0) throw new Error("proof input requires txid");
+  if (input.witnessUtxo === void 0) throw new Error("proof input requires witness utxo");
   return true;
 }
 function validateInputs(inputs) {
   inputs.forEach(validateInput);
 }
 function validateOutput(output) {
-  if (output.amount === void 0) throw new Error("intent proof output requires amount");
-  if (output.script === void 0) throw new Error("intent proof output requires script");
+  if (output.amount === void 0) throw new Error("proof output requires amount");
+  if (output.script === void 0) throw new Error("proof output requires script");
   return true;
 }
 function validateOutputs(outputs) {
   outputs.forEach(validateOutput);
 }
-function craftToSpendTx(message, pkScript, tag = TAG_INTENT_PROOF) {
+function craftToSpendTx(message, pkScript, tag = TAG_PROOF) {
   const messageHash = hashMessage(message, tag);
   const tx = new Transaction({
     version: 0
@@ -1502,10 +1576,10 @@ function craftToSignTx(toSpend, inputs, outputs, message) {
   tx.global.genericSignedMessage = new TextEncoder().encode(message);
   return tx;
 }
-function hashMessage(message, tag = TAG_INTENT_PROOF) {
+function hashMessage(message, tag = TAG_PROOF) {
   return schnorr.utils.taggedHash(tag, new TextEncoder().encode(message));
 }
-function prepareCoinAsIntentProofInput(coin) {
+function prepareProofInput(coin) {
   if (!("tapTree" in coin)) {
     return coin;
   }
@@ -1806,7 +1880,7 @@ function advertisedLimit(fromServer) {
   const limit = BigInt(fromServer);
   return limit > 0n ? limit : void 0;
 }
-var RestArkProvider = class {
+var RestOperatorProvider = class {
   constructor(serverUrl = DEFAULT_ARKADE_SERVER_URL, options = {}) {
     this.serverUrl = serverUrl;
     this.eventSource = options.eventSource;
@@ -1815,7 +1889,7 @@ var RestArkProvider = class {
   /** Overrides {@link configureEventSource} for this provider's streams. */
   eventSource;
   /**
-   * Last server-info digest seen (from {@link getInfo}). Sent as `X-Digest`
+   * Last operator info digest seen (from {@link getInfo}). Sent as `X-Digest`
    * on outgoing requests so arkd can reject a client whose cached info is
    * stale. Empty until the first {@link getInfo}.
    */
@@ -1824,7 +1898,7 @@ var RestArkProvider = class {
   _suppressNextGetInfoChangeEmit = false;
   _serverInfoListeners = /* @__PURE__ */ new Set();
   /**
-   * Subscribe to server-info changes. Fired after a stale-info
+   * Subscribe to operator info changes. Fired after a stale-info
    * `DIGEST_MISMATCH` refresh or when {@link getInfo} observes a changed digest.
    * Returns an unsubscribe function.
    */
@@ -1844,7 +1918,7 @@ var RestArkProvider = class {
     }
   }
   /**
-   * `fetch` wrapper for arkd requests that participates in server-info digest
+   * `fetch` wrapper for arkd requests that participates in operator info digest
    * negotiation. Sends the cached `X-Digest`; when arkd rejects a request with
    * `DIGEST_MISMATCH`, refreshes {@link getInfo} (updating the digest), fires
    * {@link onServerInfoChanged}, and THROWS {@link DigestMismatchError} — it
@@ -1981,6 +2055,9 @@ var RestArkProvider = class {
       (errorText) => `Failed to submit virtual transaction: ${errorText}`
     );
     const data = await response.json();
+    if (typeof data.finalArkTx !== "string" || !data.finalArkTx) {
+      throw new Error("Invalid submitTx response: missing finalArkTx");
+    }
     return {
       arkTxid: data.arkTxid,
       finalArkTx: data.finalArkTx,
@@ -2005,7 +2082,7 @@ var RestArkProvider = class {
       {
         intent: {
           proof: intent.proof,
-          message: Intent.encodeMessage(intent.message)
+          message: Proof.encodeMessage(intent.message)
         }
       },
       (errorText) => `Failed to register intent: ${errorText}`
@@ -2020,7 +2097,7 @@ var RestArkProvider = class {
       {
         intent: {
           proof: intent.proof,
-          message: Intent.encodeMessage(intent.message)
+          message: Proof.encodeMessage(intent.message)
         }
       },
       (errorText) => `Failed to delete intent: ${errorText}`
@@ -2083,7 +2160,10 @@ var RestArkProvider = class {
       try {
         while (!signal?.aborted) {
           const currentIterator = eventSourceIterator(
-            resolveEventSource(self.eventSource)(url + queryParams)
+            resolveEventSource(self.eventSource)(
+              url + queryParams,
+              ARKADE_VERSION_HEADERS
+            )
           );
           iterator = currentIterator;
           try {
@@ -2143,7 +2223,7 @@ var RestArkProvider = class {
         while (!signal?.aborted) {
           try {
             const currentIterator = eventSourceIterator(
-              resolveEventSource(self.eventSource)(url)
+              resolveEventSource(self.eventSource)(url, ARKADE_VERSION_HEADERS)
             );
             iterator = currentIterator;
             for await (const event of currentIterator) {
@@ -2197,7 +2277,7 @@ var RestArkProvider = class {
       {
         intent: {
           proof: intent.proof,
-          message: Intent.encodeMessage(intent.message)
+          message: Proof.encodeMessage(intent.message)
         }
       },
       (errorText) => `Failed to get pending transactions: ${errorText}`
@@ -2389,6 +2469,7 @@ function handleError(errorText, defaultMessage) {
   const arkError = maybeArkError(error);
   throw arkError ?? new Error(defaultMessage);
 }
+var RestArkProvider = RestOperatorProvider;
 
 // src/providers/availability.ts
 function isRetryableProviderError(error) {
@@ -2558,6 +2639,6 @@ function isVirtualCoin(input) {
   return typeof input === "object" && input !== null && typeof input.script === "string";
 }
 
-export { ARKADE_VERSION_HEADERS, ArkAddress, ArkError, ArkErrorName, ArkPsbtFieldKey, ArkPsbtFieldKeyType, BITCOIN_EMULATOR_PUBKEY, CLTVMultisigTapscript, CSVMultisigTapscript, ConditionCSVMultisigTapscript, ConditionMultisigTapscript, ConditionWitness, CosignerPublicKey, DEFAULT_ARKADE_EMULATOR_URL, DEFAULT_ARKADE_SERVER_URL, DEFAULT_NETWORK, DEFAULT_NETWORK_NAME, DEFAULT_PAGE_SIZE, DigestMismatchError, EXPIRY_MIN_PLAUSIBLE_MS, EventSourceUnavailableError, FetchError, INFO_FETCH_TIMEOUT_MS, Intent, MUTINYNET_EMULATOR_PUBKEY, MultisigTapscript, OP_RETURN_EMPTY_PKSCRIPT, PrevArkTxField, PrevoutTxField, ProviderUnavailableError, READ_TIMEOUT_MS, REGTEST_EMULATOR_PUBKEY, RestArkProvider, SCRIPT_QUERY_CHUNK_SIZE, ServerResponseMismatchError, SettlementEventType, TapTreeCoder, Transaction, VtxoScript, VtxoTaprootTree, VtxoTreeExpiry, __export, assembleBtcdTaprootTree, assertAllowedSighashTypes, assertNonNegativeMs, assertTimerMs, baseFetch, buildVersion, canRecoverOnchain, canSpendOffchain, canSweepOnchain, configureEventSource, convertVtxo, craftToSpendTx, decodeTapscript, defaultEmulatorPubkey, eventSourceIterator, fetchVtxoCreatedAtByTxid, formatSighash, getAllNormalizedVtxos, getArkPsbtFields, getConfiguredEventSource, getNetwork, getNormalizedVtxos, getSequence, isArkError, isEventSourceError, isEventSourceUnavailableError, isFetchTimeoutError, isPastExpiry, isRetryableProviderError, isVirtualCoin, isVtxoSpent, maybeArkError, networkFromArkadeInfo, networks, normalizeVtxo, rateGate, requiresForfeit, resolveEmulatorPubkey, resolveEventSource, resolveTimeHeight, scriptFromTapLeafScript, sdkVersion, sequenceToCanonicalTimelock, sequenceToTimelock, setArkPsbtField, streamFailureError, throwIfHttpUnavailable, timelockToSequence, toBIP371TapTree, toOffchainInputFeeParams, toProviderUnavailable };
-//# sourceMappingURL=chunk-HKG26NUT.js.map
-//# sourceMappingURL=chunk-HKG26NUT.js.map
+export { ARKADE_VERSION_HEADERS, ArkAddress, ArkError, ArkErrorName, ArkPsbtFieldKey, ArkPsbtFieldKeyType, BITCOIN_EMULATOR_PUBKEY, CLTVMultisigTapscript, CSVMultisigTapscript, ConditionCSVMultisigTapscript, ConditionMultisigTapscript, ConditionWitness, CosignerPublicKey, DEFAULT_ARKADE_EMULATOR_URL, DEFAULT_ARKADE_SERVER_URL, DEFAULT_NETWORK, DEFAULT_NETWORK_NAME, DEFAULT_PAGE_SIZE, DigestMismatchError, EXPIRY_MIN_PLAUSIBLE_MS, EventSourceUnavailableError, FetchError, INFO_FETCH_TIMEOUT_MS, Intent, MUTINYNET_EMULATOR_PUBKEY, MultisigTapscript, OP_RETURN_EMPTY_PKSCRIPT, PrevArkTxField, PrevoutTxField, Proof, ProviderUnavailableError, READ_TIMEOUT_MS, REGTEST_EMULATOR_PUBKEY, RestArkProvider, RestOperatorProvider, SCRIPT_QUERY_CHUNK_SIZE, ServerResponseMismatchError, SettlementEventType, TapTreeCoder, Transaction, VtxoScript, VtxoTaprootTree, VtxoTreeExpiry, __export, assembleBtcdTaprootTree, assertAllowedSighashTypes, assertNonNegativeMs, assertTimerMs, baseFetch, buildVersion, canRecoverOnchain, canSpendOffchain, canSweepOnchain, configureEventSource, convertVtxo, craftToSpendTx, decodeTapscript, defaultEmulatorPubkey, eventSourceIterator, fetchVtxoCreatedAtByTxid, formatSighash, getAllNormalizedVtxos, getArkPsbtFields, getConfiguredEventSource, getNetwork, getNormalizedVtxos, getSequence, isArkError, isEventSourceError, isEventSourceUnavailableError, isFetchTimeoutError, isPastExpiry, isRetryableProviderError, isVirtualCoin, isVtxoSpent, maybeArkError, networkFromArkadeInfo, networkFromOperatorInfo, networks, normalizeVtxo, rateGate, readSseFrames, requiresForfeit, resolveEmulatorPubkey, resolveEventSource, resolveTimeHeight, scriptFromTapLeafScript, sdkVersion, sequenceToCanonicalTimelock, sequenceToTimelock, setArkPsbtField, streamFailureError, throwIfHttpUnavailable, timelockToSequence, toBIP371TapTree, toOffchainInputFeeParams, toProviderUnavailable };
+//# sourceMappingURL=chunk-AG4TFD6F.js.map
+//# sourceMappingURL=chunk-AG4TFD6F.js.map