@secondlayer/sdk 3.3.1 → 3.4.0

package/dist/index.js

@@ -276,6 +276,111 @@ class Subgraphs extends BaseClient {
     };
   }
 }
+// src/index-api/client.ts
+function appendSearchParam(params, name, value) {
+  if (value === undefined || value === null)
+    return;
+  params.set(name, String(value));
+}
+function firstWalkFromHeight(params) {
+  if (params.fromHeight !== undefined)
+    return params.fromHeight;
+  if (params.cursor || params.fromCursor)
+    return;
+  return 0;
+}
+
+class Index extends BaseClient {
+  constructor(options = {}) {
+    super(options);
+  }
+  ftTransfers = {
+    list: (params = {}) => this.listFtTransfers(params),
+    walk: (params = {}) => this.walkFtTransfers(params)
+  };
+  nftTransfers = {
+    list: (params = {}) => this.listNftTransfers(params),
+    walk: (params = {}) => this.walkNftTransfers(params)
+  };
+  async listFtTransfers(params = {}) {
+    const searchParams = new URLSearchParams;
+    appendSearchParam(searchParams, "cursor", params.cursor);
+    appendSearchParam(searchParams, "from_cursor", params.fromCursor);
+    appendSearchParam(searchParams, "limit", params.limit);
+    appendSearchParam(searchParams, "contract_id", params.contractId);
+    appendSearchParam(searchParams, "sender", params.sender);
+    appendSearchParam(searchParams, "recipient", params.recipient);
+    appendSearchParam(searchParams, "from_height", params.fromHeight);
+    appendSearchParam(searchParams, "to_height", params.toHeight);
+    const query = searchParams.toString();
+    return this.request("GET", `/v1/index/ft-transfers${query ? `?${query}` : ""}`);
+  }
+  async listNftTransfers(params = {}) {
+    const searchParams = new URLSearchParams;
+    appendSearchParam(searchParams, "cursor", params.cursor);
+    appendSearchParam(searchParams, "from_cursor", params.fromCursor);
+    appendSearchParam(searchParams, "limit", params.limit);
+    appendSearchParam(searchParams, "contract_id", params.contractId);
+    appendSearchParam(searchParams, "asset_identifier", params.assetIdentifier);
+    appendSearchParam(searchParams, "sender", params.sender);
+    appendSearchParam(searchParams, "recipient", params.recipient);
+    appendSearchParam(searchParams, "from_height", params.fromHeight);
+    appendSearchParam(searchParams, "to_height", params.toHeight);
+    const query = searchParams.toString();
+    return this.request("GET", `/v1/index/nft-transfers${query ? `?${query}` : ""}`);
+  }
+  async* walkFtTransfers(params = {}) {
+    const batchSize = params.batchSize ?? 200;
+    let cursor = params.cursor ?? params.fromCursor ?? null;
+    let firstPage = true;
+    while (!params.signal?.aborted) {
+      const envelope = await this.listFtTransfers({
+        ...params,
+        limit: batchSize,
+        cursor: firstPage ? params.cursor : cursor,
+        fromCursor: firstPage ? params.fromCursor : undefined,
+        fromHeight: firstPage ? firstWalkFromHeight(params) : undefined
+      });
+      for (const event of envelope.events) {
+        if (params.signal?.aborted)
+          return;
+        yield event;
+      }
+      const nextCursor = envelope.next_cursor;
+      if (!nextCursor || nextCursor === cursor || envelope.events.length < batchSize) {
+        return;
+      }
+      cursor = nextCursor;
+      firstPage = false;
+    }
+  }
+  async* walkNftTransfers(params = {}) {
+    const batchSize = params.batchSize ?? 200;
+    let cursor = params.cursor ?? params.fromCursor ?? null;
+    let firstPage = true;
+    while (!params.signal?.aborted) {
+      const envelope = await this.listNftTransfers({
+        ...params,
+        limit: batchSize,
+        cursor: firstPage ? params.cursor : cursor,
+        fromCursor: firstPage ? params.fromCursor : undefined,
+        fromHeight: firstPage ? firstWalkFromHeight(params) : undefined
+      });
+      for (const event of envelope.events) {
+        if (params.signal?.aborted)
+          return;
+        yield event;
+      }
+      const nextCursor = envelope.next_cursor;
+      if (!nextCursor || nextCursor === cursor || envelope.events.length < batchSize) {
+        return;
+      }
+      cursor = nextCursor;
+      firstPage = false;
+    }
+  }
+}
+
 // src/subscriptions/client.ts
 class Subscriptions extends BaseClient {
   async list() {
@@ -318,10 +423,12 @@ class Subscriptions extends BaseClient {
 
 // src/client.ts
 class SecondLayer extends BaseClient {
+  index;
   subgraphs;
   subscriptions;
   constructor(options = {}) {
     super(options);
+    this.index = new Index(options);
     this.subgraphs = new Subgraphs(options);
     this.subscriptions = new Subscriptions(options);
   }
@@ -337,6 +444,369 @@ function getSubgraph(def, options = {}) {
   }
   return new Subgraphs(options).typed(def);
 }
+// src/streams/consumer.ts
+async function defaultSleep(ms, signal) {
+  if (signal?.aborted)
+    return;
+  await new Promise((resolve) => {
+    const timeout = setTimeout(resolve, ms);
+    if (!signal)
+      return;
+    signal.addEventListener("abort", () => {
+      clearTimeout(timeout);
+      resolve();
+    }, { once: true });
+  });
+}
+async function consumeStreamsEvents(opts) {
+  const sleep = opts.sleep ?? defaultSleep;
+  const mode = opts.mode ?? "tail";
+  const emptyBackoffMs = opts.emptyBackoffMs ?? 500;
+  const maxPages = opts.maxPages ?? Number.POSITIVE_INFINITY;
+  const maxEmptyPolls = opts.maxEmptyPolls ?? Number.POSITIVE_INFINITY;
+  let cursor = opts.fromCursor ?? null;
+  let pages = 0;
+  let emptyPolls = 0;
+  while (pages < maxPages && emptyPolls < maxEmptyPolls && !opts.signal?.aborted) {
+    const envelope = await opts.fetchEvents({
+      cursor,
+      limit: opts.batchSize,
+      types: opts.types
+    });
+    pages++;
+    const returnedCursor = await opts.onBatch(envelope.events, envelope);
+    const nextCursor = returnedCursor ?? envelope.next_cursor;
+    if (nextCursor && nextCursor !== cursor) {
+      cursor = nextCursor;
+      emptyPolls = 0;
+      continue;
+    }
+    if (envelope.events.length === 0) {
+      emptyPolls++;
+      if (mode === "bounded") {
+        return { cursor, pages, emptyPolls };
+      }
+      await sleep(emptyBackoffMs, opts.signal);
+      continue;
+    }
+    return { cursor, pages, emptyPolls };
+  }
+  return { cursor, pages, emptyPolls };
+}
+async function* streamStreamsEvents(opts) {
+  const sleep = opts.sleep ?? defaultSleep;
+  const emptyBackoffMs = opts.emptyBackoffMs ?? 500;
+  const maxPages = opts.maxPages ?? Number.POSITIVE_INFINITY;
+  const maxEmptyPolls = opts.maxEmptyPolls ?? Number.POSITIVE_INFINITY;
+  let cursor = opts.fromCursor ?? null;
+  let pages = 0;
+  let emptyPolls = 0;
+  while (pages < maxPages && emptyPolls < maxEmptyPolls && !opts.signal?.aborted) {
+    const envelope = await opts.fetchEvents({
+      cursor,
+      limit: opts.batchSize,
+      types: opts.types
+    });
+    pages++;
+    for (const event of envelope.events) {
+      if (opts.signal?.aborted)
+        return;
+      yield event;
+    }
+    const nextCursor = envelope.next_cursor;
+    if (nextCursor && nextCursor !== cursor) {
+      cursor = nextCursor;
+      emptyPolls = 0;
+      continue;
+    }
+    if (envelope.events.length === 0) {
+      emptyPolls++;
+      if (emptyPolls >= maxEmptyPolls || pages >= maxPages)
+        return;
+      await sleep(emptyBackoffMs, opts.signal);
+      continue;
+    }
+    return;
+  }
+}
+
+// src/streams/errors.ts
+class AuthError extends Error {
+  status = 401;
+  constructor(message = "API key invalid or expired.") {
+    super(message);
+    this.name = "AuthError";
+  }
+}
+
+class RateLimitError extends Error {
+  retryAfter;
+  status = 429;
+  constructor(message = "Rate limited. Try again later.", retryAfter) {
+    super(message);
+    this.retryAfter = retryAfter;
+    this.name = "RateLimitError";
+  }
+}
+
+class ValidationError extends Error {
+  status;
+  body;
+  constructor(message, status, body) {
+    super(message);
+    this.status = status;
+    this.body = body;
+    this.name = "ValidationError";
+  }
+}
+
+class StreamsServerError extends Error {
+  status;
+  body;
+  constructor(message, status, body) {
+    super(message);
+    this.status = status;
+    this.body = body;
+    this.name = "StreamsServerError";
+  }
+}
+
+// src/streams/client.ts
+var DEFAULT_STREAMS_BASE_URL = "https://api.secondlayer.tools";
+function normalizeBaseUrl(baseUrl) {
+  return baseUrl.replace(/\/+$/, "");
+}
+function appendSearchParam2(params, name, value) {
+  if (value === undefined || value === null)
+    return;
+  params.set(name, String(value));
+}
+async function responseBody(response) {
+  const text = await response.text();
+  if (text.length === 0)
+    return;
+  try {
+    return JSON.parse(text);
+  } catch {
+    return text;
+  }
+}
+function errorMessage(body, fallback) {
+  if (body && typeof body === "object") {
+    const record = body;
+    const message = record.error ?? record.message;
+    if (typeof message === "string" && message.length > 0)
+      return message;
+  }
+  if (typeof body === "string" && body.length > 0)
+    return body;
+  return fallback;
+}
+async function mapStreamsError(response) {
+  const body = await responseBody(response);
+  if (response.status === 401) {
+    throw new AuthError(errorMessage(body, "API key invalid or expired."));
+  }
+  if (response.status === 429) {
+    const retryAfter = response.headers.get("Retry-After") ?? undefined;
+    throw new RateLimitError(errorMessage(body, "Rate limited. Try again later."), retryAfter);
+  }
+  if (response.status >= 500) {
+    throw new StreamsServerError(errorMessage(body, `Streams server returned ${response.status}.`), response.status, body);
+  }
+  throw new ValidationError(errorMessage(body, `Streams request returned ${response.status}.`), response.status, body);
+}
+function createStreamsClient(options) {
+  const baseUrl = normalizeBaseUrl(options.baseUrl ?? DEFAULT_STREAMS_BASE_URL);
+  const fetchImpl = options.fetchImpl ?? ((input, init) => fetch(input, init));
+  async function request(path) {
+    const response = await fetchImpl(`${baseUrl}${path}`, {
+      headers: { Authorization: `Bearer ${options.apiKey}` }
+    });
+    if (!response.ok)
+      await mapStreamsError(response);
+    return await response.json();
+  }
+  const fetchEvents = async ({
+    cursor,
+    limit,
+    types
+  }) => {
+    return listEvents({ cursor, limit, types });
+  };
+  async function listEvents(params = {}) {
+    const searchParams = new URLSearchParams;
+    appendSearchParam2(searchParams, "cursor", params.cursor);
+    appendSearchParam2(searchParams, "from_height", params.fromHeight);
+    appendSearchParam2(searchParams, "to_height", params.toHeight);
+    appendSearchParam2(searchParams, "limit", params.limit);
+    if (params.types?.length) {
+      searchParams.set("types", params.types.join(","));
+    }
+    const query = searchParams.toString();
+    return request(`/v1/streams/events${query ? `?${query}` : ""}`);
+  }
+  return {
+    events: {
+      list: listEvents,
+      consume(params) {
+        return consumeStreamsEvents({
+          fromCursor: params.fromCursor,
+          mode: params.mode,
+          types: params.types,
+          batchSize: params.batchSize ?? 100,
+          fetchEvents,
+          onBatch: params.onBatch,
+          emptyBackoffMs: params.emptyBackoffMs,
+          maxPages: params.maxPages,
+          maxEmptyPolls: params.maxEmptyPolls,
+          signal: params.signal
+        });
+      },
+      stream(params = {}) {
+        return streamStreamsEvents({
+          fromCursor: params.fromCursor,
+          types: params.types,
+          batchSize: params.batchSize ?? 100,
+          emptyBackoffMs: params.emptyBackoffMs,
+          maxPages: params.maxPages,
+          maxEmptyPolls: params.maxEmptyPolls,
+          signal: params.signal,
+          fetchEvents
+        });
+      }
+    },
+    tip() {
+      return request("/v1/streams/tip");
+    }
+  };
+}
+// src/streams/ft-transfer.ts
+function requireString(payload, field) {
+  const value = payload[field];
+  if (typeof value !== "string" || value.length === 0) {
+    throw new Error(`ft_transfer payload missing ${field}`);
+  }
+  return value;
+}
+function parseAssetIdentifier(assetIdentifier) {
+  const [contractId, tokenName] = assetIdentifier.split("::");
+  if (!contractId) {
+    throw new Error("ft_transfer payload has malformed asset_identifier");
+  }
+  return {
+    contract_id: contractId,
+    token_name: tokenName && tokenName.length > 0 ? tokenName : null
+  };
+}
+function isFtTransfer(event) {
+  return event.event_type === "ft_transfer";
+}
+function decodeFtTransfer(event) {
+  if (!isFtTransfer(event)) {
+    throw new Error(`Expected ft_transfer event, got ${event.event_type}`);
+  }
+  const payload = event.payload;
+  const assetIdentifier = requireString(payload, "asset_identifier");
+  const sender = requireString(payload, "sender");
+  const recipient = requireString(payload, "recipient");
+  const amount = requireString(payload, "amount");
+  if (!/^(0|[1-9]\d*)$/.test(amount)) {
+    throw new Error("ft_transfer payload has malformed amount");
+  }
+  const { contract_id, token_name } = parseAssetIdentifier(assetIdentifier);
+  return {
+    cursor: event.cursor,
+    block_height: event.block_height,
+    tx_id: event.tx_id,
+    tx_index: event.tx_index,
+    event_index: event.event_index,
+    event_type: event.event_type,
+    decoded_payload: {
+      asset_identifier: assetIdentifier,
+      contract_id: event.contract_id ?? contract_id,
+      token_name,
+      sender,
+      recipient,
+      amount
+    },
+    source_cursor: event.cursor
+  };
+}
+// src/streams/nft-transfer.ts
+function requireString2(payload, field) {
+  const value = payload[field];
+  if (typeof value !== "string" || value.length === 0) {
+    throw new Error(`nft_transfer payload missing ${field}`);
+  }
+  return value;
+}
+function requireHexValue(payload) {
+  const value = payload.value;
+  const hex = typeof value === "string" ? value : value && typeof value === "object" && typeof value.hex === "string" ? value.hex : null;
+  if (!hex) {
+    throw new Error("nft_transfer payload missing value");
+  }
+  if (!/^0x[0-9a-fA-F]*$/.test(hex)) {
+    throw new Error("nft_transfer payload has malformed value");
+  }
+  return hex;
+}
+function parseAssetIdentifier2(assetIdentifier) {
+  const [contractId, tokenName] = assetIdentifier.split("::");
+  if (!contractId) {
+    throw new Error("nft_transfer payload has malformed asset_identifier");
+  }
+  return {
+    contract_id: contractId,
+    token_name: tokenName && tokenName.length > 0 ? tokenName : null
+  };
+}
+function isNftTransfer(event) {
+  return event.event_type === "nft_transfer";
+}
+function decodeNftTransfer(event) {
+  if (!isNftTransfer(event)) {
+    throw new Error(`Expected nft_transfer event, got ${event.event_type}`);
+  }
+  const payload = event.payload;
+  const assetIdentifier = requireString2(payload, "asset_identifier");
+  const sender = requireString2(payload, "sender");
+  const recipient = requireString2(payload, "recipient");
+  const value = requireHexValue(payload);
+  const { contract_id, token_name } = parseAssetIdentifier2(assetIdentifier);
+  return {
+    cursor: event.cursor,
+    block_height: event.block_height,
+    tx_id: event.tx_id,
+    tx_index: event.tx_index,
+    event_index: event.event_index,
+    event_type: event.event_type,
+    decoded_payload: {
+      asset_identifier: assetIdentifier,
+      contract_id: event.contract_id ?? contract_id,
+      token_name,
+      sender,
+      recipient,
+      value
+    },
+    source_cursor: event.cursor
+  };
+}
+// src/streams/types.ts
+var STREAMS_EVENT_TYPES = [
+  "stx_transfer",
+  "stx_mint",
+  "stx_burn",
+  "stx_lock",
+  "ft_transfer",
+  "ft_mint",
+  "ft_burn",
+  "nft_transfer",
+  "nft_mint",
+  "nft_burn",
+  "print"
+];
 // src/webhooks.ts
 import { verifySignatureHeader } from "@secondlayer/shared/crypto/hmac";
 function verifyWebhookSignature(rawBody, signatureHeader, secret, toleranceSeconds = 300) {
@@ -344,13 +814,23 @@ function verifyWebhookSignature(rawBody, signatureHeader, secret, toleranceSecon
 }
 export {
   verifyWebhookSignature,
+  isNftTransfer,
+  isFtTransfer,
   getSubgraph,
+  decodeNftTransfer,
+  decodeFtTransfer,
+  createStreamsClient,
   VersionConflictError,
+  ValidationError,
   Subscriptions,
   Subgraphs,
+  StreamsServerError,
   SecondLayer,
+  RateLimitError,
+  Index,
+  AuthError,
   ApiError
 };
 
-//# debugId=75D2C909D4BDD37B64756E2164756E21
+//# debugId=2771C8998C150B3F64756E2164756E21
 //# sourceMappingURL=index.js.map