useSacAddress

useSacAddress is the React wrapper around getSacAddress. It returns the Stellar Asset Contract (SAC) id of a classic asset — native XLM or a CODE:ISSUER pair.

Because the underlying derivation is synchronous and local (no network call, regardless of whether the SAC is deployed), this is not a TanStack Query — there's no loading state. The value is computed with useMemo and returned right away as { data, error }. An invalid asset or missing network passphrase is captured into error rather than thrown during render.

Import

import { useSacAddress } from "@bluxcc/react";

Usage

Derive the SAC id of an issued asset:

import { useSacAddress } from "@bluxcc/react";

function SacId() {
  const { data: sac, error } = useSacAddress("USDC:GA5Z....KZVN");

  if (error) return <p>{error.message}</p>;
  return <code>{sac}</code>; // "C..."
}

root.render(
  <BluxProvider
    config={{
      appName: "MyApp",
      networks: [networks.testnet, networks.mainnet],
    }}
  >
    <App />
  </BluxProvider>
);

It also accepts "xlm"/"native" or an Asset instance, and an optional network passphrase as the second argument:

import { useSacAddress, networks } from "@bluxcc/react";

// Native XLM on a specific network.
const { data } = useSacAddress("xlm", networks.mainnet);

Chain into a metadata read

A common flow is deriving the SAC, then reading its on-chain metadata with useTokenMetadata once the id is known:

import { useSacAddress, useTokenMetadata } from "@bluxcc/react";

function AssetCard() {
  const { data: sac } = useSacAddress("USDC:GA5Z....KZVN");
  const { data: meta } = useTokenMetadata(sac ?? "", undefined, {
    enabled: Boolean(sac),
  });

  return <p>{meta?.symbol} · {meta?.decimals} decimals</p>;
}

root.render(
  <BluxProvider
    config={{
      appName: "MyApp",
      networks: [networks.testnet, networks.mainnet],
    }}
  >
    <App />
  </BluxProvider>
);

Parameters

asset (required)

string | Asset

The asset: "xlm"/"native", a "CODE:ISSUER" string, or an Asset instance.

network

string | undefined

Network passphrase to derive against. Import networks from @bluxcc/react to select one. The SAC id is network-specific; omit to use the active network.

Return Type

useSacAddress returns a plain object — not a TanStack Query result:

type UseSacAddressResult = {
  // The SAC contract id (C…), or undefined when it can't be derived.
  data: string | undefined;
  // The error thrown while deriving, or null on success.
  error: Error | null;
};