Skip to main content

useStargateClient

Hook to retrieve a StargateClient. Returns clients in a Record<chainId, StargateClient> format.

Usage

import { useStargateClient } from "graz";

function App() {
const { data: clients, isFetching, refetch } = useStargateClient({
chainId: ["cosmoshub-4", "osmosis-1"],
});

async function getAccountsFromClients() {
const cosmosClient = clients?.["cosmoshub-4"];
const osmosisClient = clients?.["osmosis-1"];

if (!cosmosClient || !osmosisClient) return;

const cosmosAccount = await cosmosClient.getAccount("cosmos1...");
const osmosisAccount = await osmosisClient.getAccount("osmo1...");

return { cosmosAccount, osmosisAccount };
}

return <div>...</div>;
}

All Active Chains

import { useStargateClient } from "graz";

function App() {
// Without chainId, uses all active chains
const { data: clients } = useStargateClient();

return (
<div>
{clients && Object.entries(clients).map(([chainId, client]) => (
<div key={chainId}>
Client ready for {chainId}
</div>
))}
</div>
);
}

Hook Params

{
chainId?: string[]; // Array of chain IDs, defaults to active chains
}

Return Value

{
data?: Record<string, StargateClient>; // StargateClient from @cosmjs/stargate
dataUpdatedAt: number;
error: TError | null;
errorUpdatedAt: number;
failureCount: number;
errorUpdateCount: number;
isError: boolean;
isFetched: boolean;
isFetchedAfterMount: boolean;
isFetching: boolean;
isLoading: boolean;
isLoadingError: boolean;
isPaused: boolean;
isPlaceholderData: boolean;
isRefetchError: boolean;
isRefetching: boolean;
isStale: boolean;
isSuccess: boolean;
refetch: (options?: RefetchOptions & RefetchQueryFilters) => Promise<QueryObserverResult<Record<string, StargateClient>, unknown>>;
remove: () => void;
status: 'loading' | 'error' | 'success';
fetchStatus: 'fetching' | 'paused' | 'idle';
}