@secondlayer/sdk 15.3.1 → 15.4.1

package/dist/subgraphs/index.d.ts

@@ -353,10 +353,9 @@ type ArchiveVerifyResult = {
 	}>;
 	reason?: string;
 };
+import { ArchiveDataset } from "@secondlayer/shared/archive/datasets";
 import { RangeDigest } from "@secondlayer/shared/archive/range-digest";
 import { ArchiveStatus } from "@secondlayer/shared/archive/status";
-/** The three archive datasets: blocks, transactions, and events. */
-type ArchiveDataset = "blocks" | "transactions" | "events";
 /** Whether an archive purchase is a bootstrap or a repair. */
 type ArchiveFlow = "bootstrap" | "repair";
 /** One archive file: dataset, block range, path, rows, bytes. */
@@ -451,7 +450,7 @@ type ArchiveClient = {
 	/**
 	* List a loaded archive's partitions, optionally filtered.
 	*
-	* Runs locally on the manifest you already loaded and makes no request. Filter by `dataset` (`blocks`, `transactions`, or `events`) and a block range.
+	* Runs locally on the manifest you already loaded and makes no request. Filter by `dataset` (`blocks`, `transactions`, `events`, or `state_writes` when the archive publishes it) and a block range.
 	*/
 	partitions(ref: LoadedArchive, filter?: {
 		dataset?: ArchiveDataset;
@@ -3126,6 +3125,46 @@ type RuneBalancesListParams = ({
 	cursor?: string | null;
 	limit?: number;
 };
+/** A Bitcoin output that no transaction spends yet. */
+type BitcoinOutputUnspent = {
+	txid: string;
+	vout: number;
+	spent: false;
+};
+/** A Bitcoin output that some transaction spends. The spend may
+*  still be in the mempool (`mempool: true`) or in a block. */
+type BitcoinOutputSpent = {
+	txid: string;
+	vout: number;
+	spent: true;
+	/** Null for a confirmed spend deeper than the blocks a lookup reads
+	*  (144 below the tip); `note` says so. Still spent. */
+	spending_txid: string | null;
+	/** The spending input's index in `spending_txid`. */
+	spending_vin: number | null;
+	/** In a block of the active chain. */
+	confirmed: boolean;
+	/** Only in the mempool so far. */
+	mempool: boolean;
+	/** Null in the mempool. */
+	block_height: number | null;
+	block_hash: string | null;
+	/** Why the spender is not named, when it isn't. */
+	note?: string;
+};
+/** `GET /v1/bitcoin/outspend/{txid}/{vout}`. Narrow on `spent`. */
+type BitcoinOutspend = BitcoinOutputUnspent | BitcoinOutputSpent;
+/** `index.bitcoin`: reads answered live from the instance's Bitcoin node. */
+interface BitcoinResource {
+	/**
+	* Whether a Bitcoin output is spent, and by which transaction.
+	*
+	* A mempool spend shows on the next read (`mempool: true`); a confirmed
+	* one names its block. Resolves to `null` on 404: no such transaction,
+	* no output at `vout`, or an OP_RETURN output.
+	*/
+	outspend(txid: string, vout: number): Promise<BitcoinOutspend | null>;
+}
 /** `index.runes` — the rune catalog, activity log, and balances. Runes is
 *  more data on the existing Index plane, not a new product. Not configured
 *  on hosted yet; every feed's `notes` says so when it isn't. Self-host with
@@ -3473,6 +3512,8 @@ declare class Index extends BaseClient {
 	/** Rune catalog, activity and balances. Separate clock/reorg source from
 	*  the Stacks feeds above — see {@link RunesResource}. */
 	readonly runes: RunesResource;
+	/** Spend status of Bitcoin outputs. See {@link BitcoinResource}. */
+	readonly bitcoin: BitcoinResource;
 	private listFtTransfers;
 	private listNftTransfers;
 	/** Shared keyset-pagination loop for every `walk*` feed: seed the cursor from
@@ -3526,6 +3567,7 @@ declare class Index extends BaseClient {
 	private walkPoxCycles;
 	private getPoxCycle;
 	private listRunes;
+	private getBitcoinOutspend;
 	private getRune;
 	private listRuneActivity;
 	private walkRuneActivity;

package/dist/subgraphs/index.js

@@ -1818,6 +1818,9 @@ class Index extends BaseClient {
       walk: (params = {}) => this.walkRuneActivity(params)
     }
   };
+  bitcoin = {
+    outspend: (txid, vout) => this.getBitcoinOutspend(txid, vout)
+  };
   async listFtTransfers(params = {}) {
     return this.request("GET", `/v1/index/ft-transfers${buildQuery({
       ...indexPageQuery(params),
@@ -2073,6 +2076,9 @@ class Index extends BaseClient {
       limit: params.limit
     })}`, undefined, { signal: params.signal });
   }
+  async getBitcoinOutspend(txid, vout) {
+    return this.requestOrNull("GET", `/v1/bitcoin/outspend/${encodeURIComponent(txid)}/${vout}`);
+  }
   async getRune(rune) {
     return this.requestOrNull("GET", `/v1/index/runes/${encodeURIComponent(rune)}`);
   }
@@ -2836,5 +2842,5 @@ export {
   getSubgraph
 };
 
-//# debugId=2B2B0CE3958DF43464756E2164756E21
+//# debugId=B52CC2088456848264756E2164756E21
 //# sourceMappingURL=index.js.map