@secondlayer/sdk 6.29.1 → 6.31.0

package/dist/subgraphs/index.d.ts

@@ -1615,6 +1615,73 @@ interface PoxResource {
 		get(rewardCycle: number): Promise<PoxCycleEnvelope | null>
 	};
 }
+/** The decoded `pox-5` boot-contract print topics (SIP-045 Bitcoin Staking).
+*  Declared locally rather than imported from the server packages — the SDK is
+*  published and owns its own dependency surface (same as {@link SbtcEventTopic}). */
+type IndexPox5EventTopic = "set-bond-admin" | "set-pause-admin" | "pause-rewards" | "setup-bond" | "add-to-allowlist" | "register-for-bond" | "update-bond-registration" | "register-signer" | "stake" | "stake-update" | "announce-l1-early-exit" | "unstake-sbtc" | "unstake" | "calculate-rewards" | "bond-distribution" | "claim-rewards" | "claim-staker-rewards-for-signer" | "grant-signer-key" | "revoke-signer-grant";
+/** A raw decoded PoX-5 print event. Promoted fields cover the hot query paths;
+*  `data` always carries the full decoded tuple, including nested shapes
+*  (`btc-lockup`, `bond-rewards`, `bond-periods`) that have no flat column. */
+type IndexPox5Event = {
+	cursor: string
+	block_height: number
+	block_time: string | null
+	tx_id: string
+	tx_index: number
+	event_index: number
+	topic: IndexPox5EventTopic
+	staker: string | null
+	signer: string | null
+	signer_manager: string | null
+	bond_index: number | null
+	/** ustx, bigint-safe string. */
+	amount_ustx: string | null
+	/** sats, bigint-safe string. */
+	amount_sats: string | null
+	reward_cycle: number | null
+	first_reward_cycle: number | null
+	unlock_cycle: number | null
+	unlock_burn_height: number | null
+	is_l1_lock: boolean | null
+	signer_key: string | null
+	/** The full decoded print tuple as JSON. */
+	data: unknown
+};
+type Pox5EventsEnvelope = {
+	events: IndexPox5Event[]
+	next_cursor: string | null
+	tip: IndexTip
+	reorgs: IndexReorg[]
+	/** Present only when the PoX-5 decoder is disabled, explaining an empty feed. */
+	notes?: string
+};
+type Pox5EventsListParams = {
+	cursor?: string | null
+	fromCursor?: string | null
+	limit?: number
+	/** Clamp to the finality boundary — only rows past the reorg margin. */
+	confirmed?: boolean
+	topic?: IndexPox5EventTopic
+	staker?: string
+	signer?: string
+	signerManager?: string
+	bondIndex?: number
+	rewardCycle?: number
+	fromHeight?: number
+	toHeight?: number
+};
+type Pox5EventsWalkParams = Omit<Pox5EventsListParams, "limit"> & {
+	batchSize?: number
+	signal?: AbortSignal
+};
+/** `index.pox5` — decoded PoX-5 print events, the staking primitive from the
+*  epoch 4.0 hard fork onward (PoX-4's `index.stacking` stream ends there). */
+interface Pox5Resource {
+	events: {
+		list(params?: Pox5EventsListParams): Promise<Pox5EventsEnvelope>
+		walk(params?: Pox5EventsWalkParams): AsyncIterable<IndexPox5Event>
+	};
+}
 /**
 * `index.ftTransfers` — callable shorthand for `.list()`, with `.list`/`.walk`
 * still available: `await sl.index.ftTransfers({ contractId })`.
@@ -1729,6 +1796,9 @@ declare class Index extends BaseClient {
 	/** PoX reward-cycle aggregates. Distinct from `stacking` (per-call PoX-4
 	*  actions); `cycles` is the reward-cycle rollup. */
 	readonly pox: PoxResource;
+	/** Decoded PoX-5 print events (SIP-045 Bitcoin Staking) — the raw pox-5
+	*  boot-contract log, all 19 topics. Distinct from `stacking` (PoX-4 era). */
+	readonly pox5: Pox5Resource;
 	private listFtTransfers;
 	private listNftTransfers;
 	/** Shared keyset-pagination loop for every `walk*` feed: seed the cursor from
@@ -1770,6 +1840,8 @@ declare class Index extends BaseClient {
 	private listSbtcEvents;
 	private walkSbtcEvents;
 	private getSbtcSummary;
+	private listPox5Events;
+	private walkPox5Events;
 	private listPoxCycles;
 	private walkPoxCycles;
 	private getPoxCycle;

package/dist/subgraphs/index.js

@@ -810,6 +810,12 @@ class Index extends BaseClient {
       get: (rewardCycle) => this.getPoxCycle(rewardCycle)
     }
   };
+  pox5 = {
+    events: {
+      list: (params = {}) => this.listPox5Events(params),
+      walk: (params = {}) => this.walkPox5Events(params)
+    }
+  };
   async listFtTransfers(params = {}) {
     return this.request("GET", `/v1/index/ft-transfers${buildQuery({
       cursor: params.cursor,
@@ -1038,6 +1044,25 @@ class Index extends BaseClient {
   async getSbtcSummary() {
     return this.request("GET", "/v1/index/sbtc/summary");
   }
+  async listPox5Events(params = {}) {
+    return this.request("GET", `/v1/index/pox5/events${buildQuery({
+      cursor: params.cursor,
+      from_cursor: params.fromCursor,
+      limit: params.limit,
+      confirmed: params.confirmed,
+      topic: params.topic,
+      staker: params.staker,
+      signer: params.signer,
+      signer_manager: params.signerManager,
+      bond_index: params.bondIndex,
+      reward_cycle: params.rewardCycle,
+      from_height: params.fromHeight,
+      to_height: params.toHeight
+    })}`);
+  }
+  walkPox5Events(params = {}) {
+    return this.keysetWalk(params, (page) => this.listPox5Events({ ...params, ...page }), (e) => e.events);
+  }
   async listPoxCycles(params = {}) {
     return this.request("GET", `/v1/index/pox/cycles${buildQuery({
       cursor: params.cursor,
@@ -1720,5 +1745,5 @@ export {
   Subgraphs
 };
 
-//# debugId=D9521B9F6768A30F64756E2164756E21
+//# debugId=815357866F80FC1964756E2164756E21
 //# sourceMappingURL=index.js.map