@secondlayer/sdk 6.27.0 → 6.27.1

package/dist/index.d.ts

@@ -24,6 +24,9 @@ declare abstract class BaseClient {
 	constructor(options?: Partial<SecondLayerOptions>);
 	static authHeaders(apiKey?: string): Record<string, string>;
 	protected request<T>(method: string, path: string, body?: unknown): Promise<T>;
+	/** Like `request`, but maps a 404 to `null` instead of throwing — the one
+	*  place that owns the "absent resource" rule for `get*` accessors. */
+	protected requestOrNull<T>(method: string, path: string, body?: unknown): Promise<T | null>;
 	protected requestText(method: string, path: string, body?: unknown): Promise<string>;
 	private fetchResponse;
 }

package/dist/index.js

@@ -80,6 +80,15 @@ class BaseClient {
     }
     return response.json();
   }
+  async requestOrNull(method, path, body) {
+    try {
+      return await this.request(method, path, body);
+    } catch (err) {
+      if (err instanceof ApiError && err.status === 404)
+        return null;
+      throw err;
+    }
+  }
   async requestText(method, path, body) {
     const response = await this.fetchResponse(method, path, body);
     return response.text();
@@ -424,14 +433,8 @@ class Contracts extends BaseClient {
     })}`);
   }
   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;
-    }
+    const result = await this.requestOrNull("GET", `/v1/contracts/${encodeURIComponent(contractId)}${opts.includeAbi ? "?include=abi" : ""}`);
+    return result?.contract ?? null;
   }
 }
 
@@ -732,13 +735,7 @@ class Index extends BaseClient {
     return this.request("GET", "/v1/index");
   }
   async printSchema(contractId) {
-    try {
-      return await this.request("GET", `/v1/index/contracts/${encodeURIComponent(contractId)}/print-schema`);
-    } catch (err) {
-      if (err instanceof ApiError && err.status === 404)
-        return null;
-      throw err;
-    }
+    return this.requestOrNull("GET", `/v1/index/contracts/${encodeURIComponent(contractId)}/print-schema`);
   }
   ftTransfers = Object.assign((params = {}) => this.listFtTransfers(params), {
     list: (params = {}) => this.listFtTransfers(params),
@@ -1033,13 +1030,7 @@ class Index extends BaseClient {
     })}`);
   }
   async getBlock(ref) {
-    try {
-      return await this.request("GET", `/v1/index/blocks/${encodeURIComponent(String(ref))}`);
-    } catch (err) {
-      if (err instanceof ApiError && err.status === 404)
-        return null;
-      throw err;
-    }
+    return this.requestOrNull("GET", `/v1/index/blocks/${encodeURIComponent(String(ref))}`);
   }
   async* walkBlocks(params = {}) {
     const batchSize = params.batchSize ?? 200;
@@ -1079,22 +1070,10 @@ class Index extends BaseClient {
     })}`);
   }
   async getTransaction(txId) {
-    try {
-      return await this.request("GET", `/v1/index/transactions/${encodeURIComponent(txId)}`);
-    } catch (err) {
-      if (err instanceof ApiError && err.status === 404)
-        return null;
-      throw err;
-    }
+    return this.requestOrNull("GET", `/v1/index/transactions/${encodeURIComponent(txId)}`);
   }
   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;
-    }
+    return this.requestOrNull("GET", `/v1/index/transactions/${encodeURIComponent(txId)}/proof`);
   }
   async* walkTransactions(params = {}) {
     const batchSize = params.batchSize ?? 200;
@@ -1169,13 +1148,7 @@ class Index extends BaseClient {
     })}`);
   }
   async getMempoolTx(txId) {
-    try {
-      return await this.request("GET", `/v1/index/mempool/${encodeURIComponent(txId)}`);
-    } catch (err) {
-      if (err instanceof ApiError && err.status === 404)
-        return null;
-      throw err;
-    }
+    return this.requestOrNull("GET", `/v1/index/mempool/${encodeURIComponent(txId)}`);
   }
   async* walkMempool(params = {}) {
     const batchSize = params.batchSize ?? 200;
@@ -1239,13 +1212,7 @@ class Index extends BaseClient {
     }
   }
   async getSbtcDeposit(bitcoinTxid) {
-    try {
-      return await this.request("GET", `/v1/index/sbtc/deposits/${encodeURIComponent(bitcoinTxid)}`);
-    } catch (err) {
-      if (err instanceof ApiError && err.status === 404)
-        return null;
-      throw err;
-    }
+    return this.requestOrNull("GET", `/v1/index/sbtc/deposits/${encodeURIComponent(bitcoinTxid)}`);
   }
   async listSbtcWithdrawals(params = {}) {
     return this.request("GET", `/v1/index/sbtc/withdrawals${buildQuery({
@@ -1286,13 +1253,7 @@ class Index extends BaseClient {
     }
   }
   async getSbtcWithdrawal(requestId) {
-    try {
-      return await this.request("GET", `/v1/index/sbtc/withdrawals/${requestId}`);
-    } catch (err) {
-      if (err instanceof ApiError && err.status === 404)
-        return null;
-      throw err;
-    }
+    return this.requestOrNull("GET", `/v1/index/sbtc/withdrawals/${requestId}`);
   }
   async listSbtcEvents(params = {}) {
     return this.request("GET", `/v1/index/sbtc/events${buildQuery({
@@ -1360,13 +1321,7 @@ class Index extends BaseClient {
     }
   }
   async getPoxCycle(rewardCycle) {
-    try {
-      return await this.request("GET", `/v1/index/pox/cycles/${rewardCycle}`);
-    } catch (err) {
-      if (err instanceof ApiError && err.status === 404)
-        return null;
-      throw err;
-    }
+    return this.requestOrNull("GET", `/v1/index/pox/cycles/${rewardCycle}`);
   }
 }
 
@@ -2701,5 +2656,5 @@ export {
   ApiError
 };
 
-//# debugId=FEC0971346A0193B64756E2164756E21
+//# debugId=C1FDCE89B0E4893864756E2164756E21
 //# sourceMappingURL=index.js.map