Quickstart - Sorokit

Sorokit requires no code generation and no complex configuration. This guide will help you set up the SDK and make your first contract call.

1. Install Dependencies

Sorokit is split into modular packages. You will also need to install the peer dependencies that power our validation and data fetching.

pnpm add @sorokit/core @sorokit/provider @sorokit/wallet-adapter @sorokit/contract @sorokit/hooks @stellar/stellar-sdk @tanstack/react-query zod react-hook-form @hookform/resolvers @creit.tech/stellar-wallets-kit

2. Wrap your application

The SorokitProvider is the single entry point. It manages your network settings, handles wallet connections, and injects the DevTools.

import { SorokitProvider } from "@sorokit/provider";
import { stellarWalletsKit } from "@sorokit/wallet-adapter/stellar-wallets-kit";

// Setup the community wallet connector
const wallet = stellarWalletsKit();

export function App({ children }) {
  return (
    <SorokitProvider network="TESTNET" wallet={wallet} devtools={true}>
      {children}
    </SorokitProvider>
  );
}

3. Read from a contract

Use useContractCall to fetch data. You do not need a connected wallet for this since it uses a network simulation.

import { useContractCall } from "@sorokit/contract";

function TokenName({ contractId }) {
  const { data, isLoading } = useContractCall<string>({
    contractId,
    method: "name",
  });

  if (isLoading) return <div>Loading...</div>;
  return <div>Contract Name: {data}</div>;
}

4. Submit a transaction

Use useContractSend for state-changing operations. Ensure you connect a wallet using the ConnectWalletButton or the useWallet hook first.

import { useContractSend } from "@sorokit/contract";

function MintAction({ contractId }) {
  const { sendAsync, status } = useContractSend({
    contractId,
    method: "mint",
  });

  return (
    <button onClick={() => sendAsync({ to: "G...", amount: 100n })}>
      {status === "IDLE" ? "Mint Tokens" : status}
    </button>
  );
}