@secondlayer/stacks 6.2.1 → 6.3.0

package/dist/src/index.d.cts

@@ -1591,21 +1591,22 @@ interface AbiContract {
 	defined_traits?: ReadonlyArray<AbiTraitDefinition>;
 }
 /**
-* `<contract>::<asset-name>` — the shape a fungible/non-fungible asset filter
-* takes, expressed so the compiler can check it.
+* A fungible or non-fungible asset identifier: `<contract>::<asset-name>`.
+*
+* This is the shape an asset filter takes, expressed so the compiler can check it.
 *
 * The most common mistake in this API is passing a CONTRACT ID
 * (`SP….sbtc-token`) where an asset identifier (`SP….sbtc-token::sbtc-token`)
 * belongs, and the failure mode is a query that quietly returns zero rows. The
 * two differ structurally by `::`, so a template-literal type catches it at the
-* call site — no brand, no cast, literals just work.
+* call site. No brand, no cast, literals just work.
 *
 * A value that is only known at runtime (config, env) is not narrow enough on
 * purpose; run it through {@link assetId} once, which validates and narrows.
 *
-* Wildcard patterns (Webhooks/Subgraphs-only) are admitted by the second arm — they
-* are legitimately not full identifiers (`SPB.*`), and the runtime validator
-* short-circuits on them for the same reason.
+* Wildcard patterns (Webhooks/Subgraphs-only) are admitted by the second arm.
+* They are legitimately not full identifiers (`SPB.*`), and the runtime
+* validator short-circuits on them for the same reason.
 */
 type AssetIdentifier = `${string}::${string}` | `${string}*${string}`;
 /** Scalar print field types (structural mirror of the subgraphs `ColumnType`). */
@@ -1783,6 +1784,7 @@ interface SbtcWithdrawalSweptConfirmedSpec {
 	sweepTxid?: string;
 }
 type ChainEventFilterSpec = StxTransferSpec | StxMintSpec | StxBurnSpec | StxLockSpec | FtTransferSpec | FtMintSpec | FtBurnSpec | NftTransferSpec | NftMintSpec | NftBurnSpec | ContractCallSpec | ContractDeploySpec | NestedContractCallSpec | VarSetSpec | MapSetSpec | MapInsertSpec | MapDeleteSpec | PrintEventSpec | SbtcDepositSpec | SbtcWithdrawalCreateSpec | SbtcWithdrawalAcceptSpec | SbtcWithdrawalRejectSpec | SbtcWithdrawalSweptConfirmedSpec;
+/** The filter spec for one chain event type. */
 type SpecFor<T extends ChainEventFilterType> = Extract<ChainEventFilterSpec, {
 	type: T
 }>;
@@ -1858,10 +1860,11 @@ type ProjectionsFor<
 	toSubgraphSource(): S
 } : {});
 /**
-* A canonical chain-event filter: the spec fields plus the projections its
-* member supports. Write the filter once; project it to a query
-* (`toIndexParams`), a stream (`toStreamsParams`), a webhook trigger
-* (`toChainTrigger`), or a subgraph source (`toSubgraphSource`).
+* A chain-event filter: the spec fields plus its member's projections.
+*
+* Write the filter once; project it to a query (`toIndexParams`), a stream
+* (`toStreamsParams`), a webhook trigger (`toChainTrigger`), or a subgraph
+* source (`toSubgraphSource`).
 */
 type ChainEventFilter<
 	T extends ChainEventFilterType = ChainEventFilterType,
@@ -1869,6 +1872,7 @@ type ChainEventFilter<
 		type: T
 	} = SpecFor<T>
 > = S & ProjectionsFor<T, S>;
+/** The fields a filter factory takes for one event type, without `type`. */
 type Fields<T extends ChainEventFilterType> = Omit<SpecFor<T>, "type">;
 /** The `on.*` namespace, annotated explicitly — bunup's dts emitter needs an
 *  annotation on exported values (an inferred object of generic factories

package/dist/src/index.d.ts

@@ -1591,21 +1591,22 @@ interface AbiContract {
 	defined_traits?: ReadonlyArray<AbiTraitDefinition>;
 }
 /**
-* `<contract>::<asset-name>` — the shape a fungible/non-fungible asset filter
-* takes, expressed so the compiler can check it.
+* A fungible or non-fungible asset identifier: `<contract>::<asset-name>`.
+*
+* This is the shape an asset filter takes, expressed so the compiler can check it.
 *
 * The most common mistake in this API is passing a CONTRACT ID
 * (`SP….sbtc-token`) where an asset identifier (`SP….sbtc-token::sbtc-token`)
 * belongs, and the failure mode is a query that quietly returns zero rows. The
 * two differ structurally by `::`, so a template-literal type catches it at the
-* call site — no brand, no cast, literals just work.
+* call site. No brand, no cast, literals just work.
 *
 * A value that is only known at runtime (config, env) is not narrow enough on
 * purpose; run it through {@link assetId} once, which validates and narrows.
 *
-* Wildcard patterns (Webhooks/Subgraphs-only) are admitted by the second arm — they
-* are legitimately not full identifiers (`SPB.*`), and the runtime validator
-* short-circuits on them for the same reason.
+* Wildcard patterns (Webhooks/Subgraphs-only) are admitted by the second arm.
+* They are legitimately not full identifiers (`SPB.*`), and the runtime
+* validator short-circuits on them for the same reason.
 */
 type AssetIdentifier = `${string}::${string}` | `${string}*${string}`;
 /** Scalar print field types (structural mirror of the subgraphs `ColumnType`). */
@@ -1783,6 +1784,7 @@ interface SbtcWithdrawalSweptConfirmedSpec {
 	sweepTxid?: string;
 }
 type ChainEventFilterSpec = StxTransferSpec | StxMintSpec | StxBurnSpec | StxLockSpec | FtTransferSpec | FtMintSpec | FtBurnSpec | NftTransferSpec | NftMintSpec | NftBurnSpec | ContractCallSpec | ContractDeploySpec | NestedContractCallSpec | VarSetSpec | MapSetSpec | MapInsertSpec | MapDeleteSpec | PrintEventSpec | SbtcDepositSpec | SbtcWithdrawalCreateSpec | SbtcWithdrawalAcceptSpec | SbtcWithdrawalRejectSpec | SbtcWithdrawalSweptConfirmedSpec;
+/** The filter spec for one chain event type. */
 type SpecFor<T extends ChainEventFilterType> = Extract<ChainEventFilterSpec, {
 	type: T
 }>;
@@ -1858,10 +1860,11 @@ type ProjectionsFor<
 	toSubgraphSource(): S
 } : {});
 /**
-* A canonical chain-event filter: the spec fields plus the projections its
-* member supports. Write the filter once; project it to a query
-* (`toIndexParams`), a stream (`toStreamsParams`), a webhook trigger
-* (`toChainTrigger`), or a subgraph source (`toSubgraphSource`).
+* A chain-event filter: the spec fields plus its member's projections.
+*
+* Write the filter once; project it to a query (`toIndexParams`), a stream
+* (`toStreamsParams`), a webhook trigger (`toChainTrigger`), or a subgraph
+* source (`toSubgraphSource`).
 */
 type ChainEventFilter<
 	T extends ChainEventFilterType = ChainEventFilterType,
@@ -1869,6 +1872,7 @@ type ChainEventFilter<
 		type: T
 	} = SpecFor<T>
 > = S & ProjectionsFor<T, S>;
+/** The fields a filter factory takes for one event type, without `type`. */
 type Fields<T extends ChainEventFilterType> = Omit<SpecFor<T>, "type">;
 /** The `on.*` namespace, annotated explicitly — bunup's dts emitter needs an
 *  annotation on exported values (an inferred object of generic factories

package/dist/src/pox5/index.cjs

@@ -5452,6 +5452,14 @@ function rootFromProof(leafInternal, proof) {
 }
 
 // src/bitcoin/proof.ts
+class BitcoinSourceError extends Error {
+  code;
+  name = "BitcoinSourceError";
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+  }
+}
 function normalizeTxid2(txid) {
   return without0x(txid).toLowerCase();
 }
@@ -5528,22 +5536,32 @@ function bitcoinRpcSource(config) {
       const basic = typeof config.auth === "string" ? config.auth : btoa(`${config.auth.username}:${config.auth.password}`);
       headers.authorization = `Basic ${basic}`;
     }
-    const res = await doFetch(config.url, {
-      method: "POST",
-      headers,
-      body: JSON.stringify({
-        jsonrpc: "1.0",
-        id: "secondlayer",
-        method,
-        params: rpcParams
-      })
-    });
-    if (!res.ok) {
-      throw new Error(`bitcoin rpc ${method} failed: HTTP ${res.status}`);
+    let res;
+    try {
+      res = await doFetch(config.url, {
+        method: "POST",
+        headers,
+        body: JSON.stringify({
+          jsonrpc: "1.0",
+          id: "secondlayer",
+          method,
+          params: rpcParams
+        })
+      });
+    } catch (error) {
+      throw new BitcoinSourceError("unavailable", `bitcoin rpc ${method} failed: ${error instanceof Error ? error.message : "network error"}`);
+    }
+    let json;
+    try {
+      json = await res.json();
+    } catch {
+      throw new BitcoinSourceError("unavailable", `bitcoin rpc ${method} failed: HTTP ${res.status}`);
     }
-    const json = await res.json();
     if (json.error) {
-      throw new Error(`bitcoin rpc ${method} error: ${json.error.message}`);
+      throw new BitcoinSourceError(json.error.code === -5 ? "not-found" : "unavailable", `bitcoin rpc ${method} error: ${json.error.message}`);
+    }
+    if (!res.ok) {
+      throw new BitcoinSourceError("unavailable", `bitcoin rpc ${method} failed: HTTP ${res.status}`);
     }
     return json.result;
   }
@@ -5557,7 +5575,7 @@ function bitcoinRpcSource(config) {
         true
       ]);
       if (!tx.blockhash) {
-        throw new Error(`tx ${txid} is not in a block (node needs -txindex, or the tx is unconfirmed)`);
+        throw new BitcoinSourceError("unconfirmed", `tx ${txid} is not in a block (node needs -txindex, or the tx is unconfirmed)`);
       }
       const block = await rpc("getblock", [
         tx.blockhash,
@@ -5578,9 +5596,14 @@ function esploraSource(config) {
   const doFetch = config.fetch ?? fetch;
   const base = config.url.replace(/\/+$/, "");
   async function get(path) {
-    const res = await doFetch(`${base}${path}`);
+    let res;
+    try {
+      res = await doFetch(`${base}${path}`);
+    } catch (error) {
+      throw new BitcoinSourceError("unavailable", `esplora GET ${path} failed: ${error instanceof Error ? error.message : "network error"}`);
+    }
     if (!res.ok) {
-      throw new Error(`esplora GET ${path} failed: HTTP ${res.status}`);
+      throw new BitcoinSourceError(res.status === 404 ? "not-found" : "unavailable", `esplora GET ${path} failed: HTTP ${res.status}`);
     }
     return res;
   }
@@ -5591,7 +5614,7 @@ function esploraSource(config) {
     async getBlockForTx(txid) {
       const status = await (await get(`/tx/${txid}`)).json();
       if (!status.status.confirmed) {
-        throw new Error(`tx ${txid} is unconfirmed`);
+        throw new BitcoinSourceError("unconfirmed", `tx ${txid} is unconfirmed`);
       }
       const blockHashHex = status.status.block_hash;
       const header = (await (await get(`/block/${blockHashHex}/header`)).text()).trim();
@@ -6137,5 +6160,5 @@ function parseSignerCalldata(calldata) {
   };
 }
 
-//# debugId=5713B30E41D0F0B964756E2164756E21
+//# debugId=B8DD8E4772B8284D64756E2164756E21
 //# sourceMappingURL=index.cjs.map