@secondlayer/sdk 6.18.0 → 6.20.0

package/dist/index.js

@@ -281,6 +281,19 @@ class Subgraphs extends BaseClient {
     const qs = options?.force ? "?force=true" : "";
     return this.request("DELETE", `/api/subgraphs/${name}${qs}`);
   }
+  async publish(name) {
+    return this.request("POST", `/api/subgraphs/${name}/publish`);
+  }
+  async unpublish(name) {
+    return this.request("POST", `/api/subgraphs/${name}/unpublish`);
+  }
+  async rows(name, table, params = {}) {
+    const { cursor, ...rest } = params;
+    const qs = buildSubgraphQueryString(rest);
+    const sep = qs ? "&" : "?";
+    const cursorQs = cursor ? `${sep}cursor=${encodeURIComponent(cursor)}` : "";
+    return this.request("GET", `/v1/subgraphs/${name}/${table}${qs}${cursorQs}`);
+  }
   async operations(name) {
     return this.request("GET", `/api/subgraphs/${name}/operations`);
   }
@@ -417,6 +430,16 @@ class Contracts extends BaseClient {
       cursor: params.cursor
     })}`);
   }
+  async get(contractId, opts = {}) {
+    try {
+      const { contract } = await this.request("GET", `/v1/contracts/${encodeURIComponent(contractId)}${opts.includeAbi ? "?include=abi" : ""}`);
+      return contract;
+    } catch (err) {
+      if (err instanceof ApiError && err.status === 404)
+        return null;
+      throw err;
+    }
+  }
 }
 
 // src/datasets/client.ts
@@ -596,18 +619,18 @@ class Index extends BaseClient {
   discover() {
     return this.request("GET", "/v1/index");
   }
-  ftTransfers = {
+  ftTransfers = Object.assign((params = {}) => this.listFtTransfers(params), {
     list: (params = {}) => this.listFtTransfers(params),
     walk: (params = {}) => this.walkFtTransfers(params)
-  };
-  nftTransfers = {
+  });
+  nftTransfers = Object.assign((params = {}) => this.listNftTransfers(params), {
     list: (params = {}) => this.listNftTransfers(params),
     walk: (params = {}) => this.walkNftTransfers(params)
-  };
-  events = {
+  });
+  events = Object.assign((params) => this.listEvents(params), {
     list: (params) => this.listEvents(params),
     walk: (params) => this.walkEvents(params)
-  };
+  });
   contractCalls = {
     list: (params = {}) => this.listContractCalls(params),
     walk: (params = {}) => this.walkContractCalls(params)
@@ -624,7 +647,8 @@ class Index extends BaseClient {
   transactions = {
     list: (params = {}) => this.listTransactions(params),
     walk: (params = {}) => this.walkTransactions(params),
-    get: (txId) => this.getTransaction(txId)
+    get: (txId) => this.getTransaction(txId),
+    getProof: (txId) => this.getTransactionProof(txId)
   };
   stacking = {
     list: (params = {}) => this.listStacking(params),
@@ -886,6 +910,15 @@ class Index extends BaseClient {
       throw err;
     }
   }
+  async getTransactionProof(txId) {
+    try {
+      return await this.request("GET", `/v1/index/transactions/${encodeURIComponent(txId)}/proof`);
+    } catch (err) {
+      if (err instanceof ApiError && err.status === 404)
+        return null;
+      throw err;
+    }
+  }
   async* walkTransactions(params = {}) {
     const batchSize = params.batchSize ?? 200;
     let cursor = params.cursor ?? params.fromCursor ?? null;
@@ -1162,6 +1195,38 @@ async function consumeStreamsEvents(opts) {
   }
   return { cursor, pages, emptyPolls };
 }
+async function* iterateStreamsBatches(opts) {
+  const sleep = opts.sleep ?? defaultSleep;
+  let cursor = opts.fromCursor ?? null;
+  while (!opts.signal?.aborted) {
+    const envelope = await opts.fetchEvents({
+      cursor,
+      limit: opts.batchSize,
+      types: opts.types,
+      notTypes: opts.notTypes,
+      contractId: opts.contractId,
+      sender: opts.sender,
+      recipient: opts.recipient,
+      assetIdentifier: opts.assetIdentifier
+    });
+    const checkpoint = envelope.next_cursor ?? cursor;
+    if (envelope.events.length > 0 || envelope.reorgs.length > 0) {
+      yield {
+        events: envelope.events,
+        cursor: checkpoint,
+        tip: envelope.tip,
+        reorgs: envelope.reorgs
+      };
+    }
+    const advanced = checkpoint !== null && checkpoint !== cursor;
+    cursor = checkpoint;
+    if (!advanced && envelope.events.length === 0) {
+      if (opts.signal?.aborted)
+        return;
+      await sleep(opts.intervalMs, opts.signal);
+    }
+  }
+}
 async function* streamStreamsEvents(opts) {
   const sleep = opts.sleep ?? defaultSleep;
   const emptyBackoffMs = opts.emptyBackoffMs ?? 500;
@@ -1539,6 +1604,21 @@ function createStreamsClient(options) {
     })}`);
   }
   return {
+    consume(params = {}) {
+      return iterateStreamsBatches({
+        fromCursor: params.cursor,
+        batchSize: params.batchSize ?? 100,
+        intervalMs: params.intervalMs ?? 2000,
+        types: params.types,
+        notTypes: params.notTypes,
+        contractId: params.contractId,
+        sender: params.sender,
+        recipient: params.recipient,
+        assetIdentifier: params.assetIdentifier,
+        signal: params.signal,
+        fetchEvents
+      });
+    },
     events: {
       list: listEvents,
       byTxId(txId) {
@@ -2073,6 +2153,174 @@ function decodePrint(event) {
 import {
   STREAMS_EVENT_TYPES
 } from "@secondlayer/shared";
+// src/x402.ts
+import {
+  X402_TOKENS,
+  findX402TokenByAsset
+} from "@secondlayer/shared/x402";
+import {
+  serializeTransactionHex,
+  signTransactionWithAccount
+} from "@secondlayer/stacks/transactions";
+import { buildExactTransfer } from "@secondlayer/stacks/x402";
+var DEFAULT_PREFER_ASSETS = [
+  "sBTC",
+  "USDCx",
+  "STX"
+];
+var DEFAULT_NONCE_NODE_URL = "https://api.hiro.so";
+
+class X402SpendGuardError extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "X402SpendGuardError";
+  }
+}
+function b64encode(value) {
+  return Buffer.from(JSON.stringify(value), "utf8").toString("base64");
+}
+function b64decodeJson(value) {
+  try {
+    return JSON.parse(Buffer.from(value, "base64").toString("utf8"));
+  } catch {
+    return null;
+  }
+}
+async function readX402Challenge(res) {
+  const header = res.headers.get("PAYMENT-REQUIRED");
+  if (header) {
+    const decoded = b64decodeJson(header);
+    if (decoded)
+      return decoded;
+  }
+  try {
+    return await res.clone().json();
+  } catch {
+    return null;
+  }
+}
+function readX402Receipt(res) {
+  const header = res.headers.get("PAYMENT-RESPONSE");
+  return header ? b64decodeJson(header) : null;
+}
+function selectOffer(challenge, opts = {}) {
+  const prefer = opts.preferAssets ?? DEFAULT_PREFER_ASSETS;
+  for (const symbol of prefer) {
+    const token = X402_TOKENS[symbol];
+    const accept = challenge.accepts.find((a) => a.asset === token.asset);
+    if (!accept)
+      continue;
+    const cap = opts.maxAmountPerCall?.[symbol];
+    if (cap !== undefined && BigInt(accept.amount) > cap)
+      continue;
+    return { accept, symbol };
+  }
+  throw new X402SpendGuardError("no x402 offer matched preferAssets within maxAmountPerCall");
+}
+async function resolveAccountNonce(address, nodeUrl = DEFAULT_NONCE_NODE_URL) {
+  const res = await fetch(`${nodeUrl.replace(/\/$/, "")}/v2/accounts/${address}?proof=0`);
+  if (!res.ok)
+    throw new Error(`x402 nonce lookup failed: ${res.status}`);
+  const json = await res.json();
+  return json.nonce;
+}
+async function buildSignedX402Payment(opts) {
+  const accept = opts.asset ? opts.challenge.accepts.find((a) => a.asset === opts.asset) : opts.challenge.accepts[0];
+  if (!accept) {
+    throw new Error(`No x402 offer${opts.asset ? ` for asset ${opts.asset}` : ""}`);
+  }
+  const token = findX402TokenByAsset(accept.asset);
+  if (!token)
+    throw new Error(`Unknown x402 asset: ${accept.asset}`);
+  const asset = token.contractId && token.assetName ? {
+    kind: "sip010",
+    contractId: token.contractId,
+    assetName: token.assetName
+  } : { kind: "stx" };
+  const tx = buildExactTransfer({
+    asset,
+    amount: BigInt(accept.amount),
+    payTo: accept.payTo,
+    payer: opts.account.address,
+    payerPublicKey: opts.account.publicKey,
+    accountNonce: opts.accountNonce,
+    nonce: accept.extra.nonce,
+    chain: opts.chain
+  });
+  const signed = await signTransactionWithAccount(tx, opts.account);
+  const header = b64encode({
+    x402Version: opts.challenge.x402Version ?? 2,
+    scheme: "exact",
+    network: accept.network,
+    asset: accept.asset,
+    payload: { transaction: serializeTransactionHex(signed) },
+    extra: { nonce: accept.extra.nonce }
+  });
+  return { header, accept };
+}
+function withX402(baseFetch, opts) {
+  return async (input, init) => {
+    const run = (extra, signal2) => baseFetch(input, {
+      ...init,
+      headers: { ...init?.headers, ...extra },
+      ...signal2 ? { signal: signal2 } : {}
+    });
+    const first = await run({});
+    if (first.status !== 402)
+      return first;
+    const challenge = await readX402Challenge(first);
+    if (!challenge)
+      return first;
+    const { accept } = selectOffer(challenge, opts);
+    const accountNonce = opts.accountNonce ?? await resolveAccountNonce(opts.account.address, opts.nodeUrl);
+    const { header } = await buildSignedX402Payment({
+      challenge,
+      account: opts.account,
+      accountNonce,
+      asset: accept.asset,
+      chain: opts.chain
+    });
+    opts.onSettling?.({ asset: accept.asset, amount: accept.amount });
+    const signal = opts.timeoutMs ? AbortSignal.timeout(opts.timeoutMs) : undefined;
+    return run({ "PAYMENT-SIGNATURE": header }, signal);
+  };
+}
+function createX402Client(opts) {
+  const f = withX402(opts.fetch ?? fetch, opts);
+  const base = opts.baseUrl.replace(/\/$/, "");
+  async function request(method, path, o = {}) {
+    const qs = o.query ? `?${new URLSearchParams(o.query).toString()}` : "";
+    const init = { method };
+    if (o.body !== undefined) {
+      init.body = JSON.stringify(o.body);
+      init.headers = { "content-type": "application/json" };
+    }
+    const response = await f(`${base}${path}${qs}`, init);
+    const data = await response.json().catch(() => null);
+    return { data, payment: readX402Receipt(response), response };
+  }
+  return {
+    get: (path, o) => request("GET", path, o),
+    post: (path, o) => request("POST", path, o)
+  };
+}
+async function payAndRetry(doFetch, opts) {
+  const first = await doFetch({});
+  if (first.status !== 402)
+    return first;
+  const challenge = await readX402Challenge(first);
+  if (!challenge)
+    return first;
+  const { accept } = selectOffer(challenge, opts);
+  const { header } = await buildSignedX402Payment({
+    challenge,
+    account: opts.account,
+    accountNonce: opts.accountNonce,
+    asset: accept.asset,
+    chain: opts.chain
+  });
+  return doFetch({ "PAYMENT-SIGNATURE": header });
+}
 // src/webhooks.ts
 import { verifySecondlayerSignatureValues } from "@secondlayer/shared/crypto/secondlayer-webhook";
 import {
@@ -2198,11 +2446,17 @@ function verifyTransactionProof(proof, opts) {
   };
 }
 export {
+  withX402,
   verifyWebhookSignature,
   verifyTransactionProof,
   verifySecondlayerSignature,
   trigger,
   toJsonSafe,
+  selectOffer,
+  resolveAccountNonce,
+  readX402Receipt,
+  readX402Challenge,
+  payAndRetry,
   isStxTransfer,
   isStxMint,
   isStxLock,
@@ -2228,7 +2482,10 @@ export {
   decodeFtMint,
   decodeFtBurn,
   decodeClarityValue,
+  createX402Client,
   createStreamsClient,
+  buildSignedX402Payment,
+  X402SpendGuardError,
   VersionConflictError,
   ValidationError,
   Subscriptions,
@@ -2240,6 +2497,7 @@ export {
   Projects,
   Index,
   Datasets,
+  DEFAULT_PREFER_ASSETS,
   Cursor,
   Contracts,
   CURSOR_SLUGS,
@@ -2249,5 +2507,5 @@ export {
   ApiError
 };
 
-//# debugId=DBAA238399806ED364756E2164756E21
+//# debugId=EFE64A13154F57C864756E2164756E21
 //# sourceMappingURL=index.js.map