@provable-games/metagame-sdk 0.1.4 → 0.1.6

package/dist/react.d.ts

@@ -24,6 +24,16 @@ interface UseMerkleTreesReturn {
 }
 declare function useMerkleTrees(options?: UseMerkleTreesOptions): UseMerkleTreesReturn;
 
+interface UseMerkleTreeReturn {
+    tree: MerkleTree | null;
+    isLoading: boolean;
+}
+/**
+ * Fetch a single merkle tree by ID.
+ * Returns null when treeId is falsy (skips the fetch).
+ */
+declare function useMerkleTree(treeId: string | number | undefined): UseMerkleTreeReturn;
+
 interface UseMerkleProofReturn {
     proof: MerkleProofResponse | null;
     isLoading: boolean;
@@ -332,4 +342,4 @@ declare const useOpusTrovesBannableEntries: (provider: StarknetCallProvider | nu
     owner?: string;
 }>, config: OpusTrovesValidatorConfig | undefined, enabled: boolean) => UseOpusTrovesBannableEntriesResult;
 
-export { type CheckedExtensionQualification, type ExtensionQualification, type ExtensionQualificationResult, MetagameProvider, type MetagameProviderProps, type QualificationInput, type QualificationMethod, type UseEntryFeePreviewOptions, type UseEntryFeePreviewReturn, type UseEntryQualificationOptions, type UseEntryQualificationReturn, type UseMerkleProofReturn, type UseMerkleTreesOptions, type UseMerkleTreesReturn, type UseOpusTrovesBannableEntriesResult, type UsePaginationOptions, type UsePaginationReturn, type UsePrizeTableOptions, type UsePrizeTableReturn, type UseScoreTableOptions, type UseScoreTableReturn, type UseSearchFilterOptions, type UseSearchFilterReturn, type UseTokenSelectorOptions, type UseTokenSelectorReturn, useDebounce, useEntryFeePreview, useEntryQualification, useExtensionQualification, useMerkleProof, useMerkleTrees, useMetagameClient, useOpusTrovesBannableEntries, usePagination, usePrizeTable, useScoreTable, useSearchFilter, useStatusIndicator, useTokenSelector };
+export { type CheckedExtensionQualification, type ExtensionQualification, type ExtensionQualificationResult, MetagameProvider, type MetagameProviderProps, type QualificationInput, type QualificationMethod, type UseEntryFeePreviewOptions, type UseEntryFeePreviewReturn, type UseEntryQualificationOptions, type UseEntryQualificationReturn, type UseMerkleProofReturn, type UseMerkleTreeReturn, type UseMerkleTreesOptions, type UseMerkleTreesReturn, type UseOpusTrovesBannableEntriesResult, type UsePaginationOptions, type UsePaginationReturn, type UsePrizeTableOptions, type UsePrizeTableReturn, type UseScoreTableOptions, type UseScoreTableReturn, type UseSearchFilterOptions, type UseSearchFilterReturn, type UseTokenSelectorOptions, type UseTokenSelectorReturn, useDebounce, useEntryFeePreview, useEntryQualification, useExtensionQualification, useMerkleProof, useMerkleTree, useMerkleTrees, useMetagameClient, useOpusTrovesBannableEntries, usePagination, usePrizeTable, useScoreTable, useSearchFilter, useStatusIndicator, useTokenSelector };

package/dist/react.js

@@ -63,6 +63,16 @@ var MerkleClient = class {
       return empty2;
     }
   }
+  /** Fetch a single merkle tree by ID. */
+  async getTree(treeId) {
+    try {
+      const res = await fetch(`${this.apiUrl}/trees/${treeId}`);
+      if (!res.ok) return null;
+      return await res.json();
+    } catch {
+      return null;
+    }
+  }
   /** Fetch entries for a specific merkle tree. */
   async getTreeEntries(treeId, options) {
     const empty2 = {
@@ -219,6 +229,20 @@ function useMerkleTrees(options) {
     isLoading
   };
 }
+function useMerkleTree(treeId) {
+  const client = useMetagameClient();
+  const [tree, setTree] = useState(null);
+  const [isLoading, setIsLoading] = useState(false);
+  useEffect(() => {
+    if (!treeId) {
+      setTree(null);
+      return;
+    }
+    setIsLoading(true);
+    client.merkle.getTree(treeId).then(setTree).finally(() => setIsLoading(false));
+  }, [client, treeId]);
+  return { tree, isLoading };
+}
 function useMerkleProof(treeId, playerAddress) {
   const client = useMetagameClient();
   const [proof, setProof] = useState(null);
@@ -1118,6 +1142,6 @@ var useOpusTrovesBannableEntries = (provider, games, config, enabled) => {
   };
 };
 
-export { MetagameProvider, useDebounce, useEntryFeePreview, useEntryQualification, useExtensionQualification, useMerkleProof, useMerkleTrees, useMetagameClient, useOpusTrovesBannableEntries, usePagination, usePrizeTable, useScoreTable, useSearchFilter, useStatusIndicator, useTokenSelector };
+export { MetagameProvider, useDebounce, useEntryFeePreview, useEntryQualification, useExtensionQualification, useMerkleProof, useMerkleTree, useMerkleTrees, useMetagameClient, useOpusTrovesBannableEntries, usePagination, usePrizeTable, useScoreTable, useSearchFilter, useStatusIndicator, useTokenSelector };
 //# sourceMappingURL=react.js.map
 //# sourceMappingURL=react.js.map