@bluxcc/react 0.3.6 → 0.3.8

package/dist/useStellar/useAccounts.d.ts

@@ -1,5 +1,5 @@
 import { UseQueryResult } from '@tanstack/react-query';
-import type { GetAccountsResult, GetAccountsOptions } from '@bluxcc/core/dist/exports/core/getAccounts';
+import type { GetAccountsResult, GetAccountsOptions } from '@bluxcc/core';
 import type { QueryOptions } from '../utils';
 type R = GetAccountsResult;
 type O = GetAccountsOptions;
@@ -22,7 +22,7 @@ type O = GetAccountsOptions;
  *
  * @example
  * ```tsx
- * const { data } = useAccounts({ forSigner: 'GA…', limit: 20 });
+ * const { data } = useAccounts({ forSigner: 'alice.xlm', limit: 20 });
  * data?.response.records.forEach((a) => console.log(a.account_id));
  * ```
  */

package/dist/useStellar/useAssets.d.ts

@@ -1,5 +1,5 @@
 import { UseQueryResult } from '@tanstack/react-query';
-import type { GetAssetsResult, GetAssetsOptions } from "@bluxcc/core/dist/exports/core/getAssets";
+import type { GetAssetsResult, GetAssetsOptions } from '@bluxcc/core';
 import type { QueryOptions } from '../utils';
 type R = GetAssetsResult;
 type O = GetAssetsOptions;
@@ -7,7 +7,8 @@ type O = GetAssetsOptions;
  * Fetches a paginated list of assets issued on the network from Horizon.
  *
  * Optionally narrow the list by `forCode` (asset code, e.g. "USDC") and/or
- * `forIssuer` (the issuing `G…` address). With no filter it returns all assets.
+ * `forIssuer` (a `G…`/`M…`, SEP-2, or `.xlm` account). With no filter it
+ * returns all assets.
  *
  * @param options - `forCode` / `forIssuer` filters, plus optional
  *   `cursor` / `limit` / `order` and `network` (defaults to the active network).
@@ -21,5 +22,18 @@ type O = GetAssetsOptions;
  * const { data } = useAssets({ forCode: 'USDC' });
  * ```
  */
-export declare function useAssets(options?: O, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
+export declare function useAssets(options?: {
+    /** Paging token; pass the previous page's cursor to fetch the next page. */
+    cursor?: string;
+    /** Maximum number of records returned per page. */
+    limit?: number;
+    /** Network passphrase to query. Defaults to the active network. */
+    network?: string;
+    /** Sort direction by ledger sequence. Defaults to Horizon's `asc`. */
+    order?: 'asc' | 'desc';
+    /** Filter to a single asset code (e.g. `USDC`). */
+    forCode?: string;
+    /** Filter to assets issued by this account id, SEP-2 address, or `.xlm` name. */
+    forIssuer?: string;
+}, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
 export {};

package/dist/useStellar/useBalances.d.ts

@@ -1,5 +1,5 @@
 import { UseQueryResult } from '@tanstack/react-query';
-import type { GetBalancesResult, GetBalancesOptions } from "@bluxcc/core/dist/exports/core/getBalances";
+import type { GetBalancesResult, GetBalancesOptions } from "@bluxcc/core";
 import type { QueryOptions } from '../utils';
 type R = GetBalancesResult;
 type O = GetBalancesOptions;
@@ -24,5 +24,15 @@ type O = GetBalancesOptions;
  * const xlm = balances?.find((b) => b.asset_type === 'native');
  * ```
  */
-export declare function useBalances(options?: O, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
+export declare function useBalances(options?: {
+    /**
+     * Account whose balances to read: a Stellar address (`G...`/`M...`), SEP-2
+     * federated address, or `.xlm` name. Defaults to the logged-in account.
+     */
+    address?: string;
+    /** Network passphrase to query. Defaults to the active network. */
+    network?: string;
+    /** Keep balance lines whose balance is exactly zero. Defaults to `false`. */
+    includeZeroBalances?: boolean;
+}, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
 export {};

package/dist/useStellar/useClaimableBalances.d.ts

@@ -1,5 +1,6 @@
+import type { AssetArg } from '@bluxcc/core';
 import { UseQueryResult } from '@tanstack/react-query';
-import type { GetClaimableBalancesResult, GetClaimableBalancesOptions } from "@bluxcc/core/dist/exports/core/getClaimableBalances";
+import type { GetClaimableBalancesResult, GetClaimableBalancesOptions } from "@bluxcc/core";
 import type { QueryOptions } from '../utils';
 type R = GetClaimableBalancesResult;
 type O = GetClaimableBalancesOptions;
@@ -23,5 +24,20 @@ type O = GetClaimableBalancesOptions;
  * const { data } = useClaimableBalances({ asset: Asset.native() });
  * ```
  */
-export declare function useClaimableBalances(options: O, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
+export declare function useClaimableBalances(options: {
+    /** Paging token; pass the previous page's cursor to fetch the next page. */
+    cursor?: string;
+    /** Maximum number of records returned per page. */
+    limit?: number;
+    /** Network passphrase to query. Defaults to the active network. */
+    network?: string;
+    /** Sort direction by ledger sequence. Defaults to Horizon's `asc`. */
+    order?: 'asc' | 'desc';
+    /** Only balances of this asset (`'xlm'`, `'CODE:ISSUER'`, or an `Asset`). */
+    asset: AssetArg;
+    /** Only balances sponsored by this account id, SEP-2 address, or `.xlm` name. */
+    sponsor?: string;
+    /** Only balances claimable by this account (address, SEP-2 address, or `.xlm` name). */
+    claimant: string;
+}, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
 export {};

package/dist/useStellar/useEffects.d.ts

@@ -1,5 +1,5 @@
 import { UseQueryResult } from '@tanstack/react-query';
-import type { GetEffectsResult, GetEffectsOptions } from "@bluxcc/core/dist/exports/core/getEffects";
+import type { GetEffectsResult, GetEffectsOptions } from "@bluxcc/core";
 import type { QueryOptions } from '../utils';
 type R = GetEffectsResult;
 type O = GetEffectsOptions;
@@ -24,5 +24,24 @@ type O = GetEffectsOptions;
  * const { data } = useEffects({ forAccount: 'GA…', limit: 50 });
  * ```
  */
-export declare function useEffects(options?: O, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
+export declare function useEffects(options?: {
+    /** Paging token; pass the previous page's cursor to fetch the next page. */
+    cursor?: string;
+    /** Maximum number of records returned per page. */
+    limit?: number;
+    /** Network passphrase to query. Defaults to the active network. */
+    network?: string;
+    /** Sort direction by ledger sequence. Defaults to Horizon's `asc`. */
+    order?: 'asc' | 'desc';
+    /** Only effects touching this account (address, SEP-2 address, or `.xlm` name). */
+    forAccount?: string;
+    /** Only effects in this ledger, by sequence number. */
+    forLedger?: string | number;
+    /** Only effects in this transaction, by hash. */
+    forTransaction?: string;
+    /** Only effects produced by this operation id. */
+    forOperation?: string;
+    /** Only effects for this liquidity pool id. */
+    forLiquidityPool?: string;
+}, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
 export {};

package/dist/useStellar/useLedgers.d.ts

@@ -1,5 +1,5 @@
 import { UseQueryResult } from '@tanstack/react-query';
-import type { GetLedgersResult, GetLedgersOptions } from "@bluxcc/core/dist/exports/core/getLedgers";
+import type { GetLedgersResult, GetLedgersOptions } from "@bluxcc/core";
 import type { QueryOptions } from '../utils';
 type R = GetLedgersResult;
 type O = GetLedgersOptions;
@@ -21,5 +21,16 @@ type O = GetLedgersOptions;
  * const { data } = useLedgers({ limit: 10, order: 'desc' });
  * ```
  */
-export declare function useLedgers(options?: O, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
+export declare function useLedgers(options?: {
+    /** Paging token; pass the previous page's cursor to fetch the next page. */
+    cursor?: string;
+    /** Maximum number of records returned per page. */
+    limit?: number;
+    /** Network passphrase to query. Defaults to the active network. */
+    network?: string;
+    /** Sort direction by ledger sequence. Defaults to Horizon's `asc`. */
+    order?: 'asc' | 'desc';
+    /** Fetch a single ledger by its sequence number. */
+    ledger?: number | string;
+}, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
 export {};

package/dist/useStellar/useLiquidityPools.d.ts

@@ -1,5 +1,6 @@
+import type { AssetArg } from '@bluxcc/core';
 import { UseQueryResult } from '@tanstack/react-query';
-import type { GetLiquidityPoolsResult, GetLiquidityPoolsOptions } from "@bluxcc/core/dist/exports/core/getLiquidityPools";
+import type { GetLiquidityPoolsResult, GetLiquidityPoolsOptions } from "@bluxcc/core";
 import type { QueryOptions } from '../utils';
 type R = GetLiquidityPoolsResult;
 type O = GetLiquidityPoolsOptions;
@@ -24,5 +25,18 @@ type O = GetLiquidityPoolsOptions;
  * });
  * ```
  */
-export declare function useLiquidityPools(options?: O, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
+export declare function useLiquidityPools(options?: {
+    /** Paging token; pass the previous page's cursor to fetch the next page. */
+    cursor?: string;
+    /** Maximum number of records returned per page. */
+    limit?: number;
+    /** Network passphrase to query. Defaults to the active network. */
+    network?: string;
+    /** Sort direction by ledger sequence. Defaults to Horizon's `asc`. */
+    order?: 'asc' | 'desc';
+    /** Only pools made up of exactly these reserve assets (`'xlm'`, `'CODE:ISSUER'`, or `Asset`). */
+    forAssets?: Array<AssetArg>;
+    /** Only pools this account holds shares in (address, SEP-2 address, or `.xlm` name). */
+    forAccount?: string;
+}, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
 export {};

package/dist/useStellar/useOffers.d.ts

@@ -1,5 +1,6 @@
+import type { AssetArg } from '@bluxcc/core';
 import { UseQueryResult } from '@tanstack/react-query';
-import type { GetOffersResult, GetOffersOptions } from "@bluxcc/core/dist/exports/core/getOffers";
+import type { GetOffersResult, GetOffersOptions } from "@bluxcc/core";
 import type { QueryOptions } from '../utils';
 type R = GetOffersResult;
 type O = GetOffersOptions;
@@ -22,5 +23,24 @@ type O = GetOffersOptions;
  * const { data } = useOffers({ seller: 'GA…' });
  * ```
  */
-export declare function useOffers(options?: O, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
+export declare function useOffers(options?: {
+    /** Paging token; pass the previous page's cursor to fetch the next page. */
+    cursor?: string;
+    /** Maximum number of records returned per page. */
+    limit?: number;
+    /** Network passphrase to query. Defaults to the active network. */
+    network?: string;
+    /** Sort direction by ledger sequence. Defaults to Horizon's `asc`. */
+    order?: 'asc' | 'desc';
+    /** Only offers owned by this account (address, SEP-2 address, or `.xlm` name). */
+    forAccount?: string;
+    /** Only offers buying this asset (`'xlm'`, `'CODE:ISSUER'`, or an `Asset`). */
+    buying?: AssetArg;
+    /** Only offers selling this asset (`'xlm'`, `'CODE:ISSUER'`, or an `Asset`). */
+    selling?: AssetArg;
+    /** Only offers sponsored by this account id, SEP-2 address, or `.xlm` name. */
+    sponsor?: string;
+    /** Only offers created by this seller (address, SEP-2 address, or `.xlm` name). */
+    seller?: string;
+}, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
 export {};

package/dist/useStellar/useOperations.d.ts

@@ -1,5 +1,5 @@
 import { UseQueryResult } from '@tanstack/react-query';
-import type { GetOperationsResult, GetOperationsOptions } from "@bluxcc/core/dist/exports/core/getOperations";
+import type { GetOperationsResult, GetOperationsOptions } from "@bluxcc/core";
 import type { QueryOptions } from '../utils';
 type R = GetOperationsResult;
 type O = GetOperationsOptions;
@@ -23,5 +23,26 @@ type O = GetOperationsOptions;
  * const { data } = useOperations({ forAccount: 'GA…', includeFailed: false });
  * ```
  */
-export declare function useOperations(options?: O, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
+export declare function useOperations(options?: {
+    /** Paging token; pass the previous page's cursor to fetch the next page. */
+    cursor?: string;
+    /** Maximum number of records returned per page. */
+    limit?: number;
+    /** Network passphrase to query. Defaults to the active network. */
+    network?: string;
+    /** Sort direction by ledger sequence. Defaults to Horizon's `asc`. */
+    order?: 'asc' | 'desc';
+    /** Only operations touching this account (address, SEP-2 address, or `.xlm` name). */
+    forAccount?: string;
+    /** Only operations for this claimable balance id. */
+    forClaimableBalance?: string;
+    /** Only operations in this ledger, by sequence number. */
+    forLedger?: string | number;
+    /** Only operations in this transaction, by hash. */
+    forTransaction?: string;
+    /** Only operations for this liquidity pool id. */
+    forLiquidityPool?: string;
+    /** Include operations from failed transactions. Defaults to `false`. */
+    includeFailed?: boolean;
+}, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
 export {};

package/dist/useStellar/useOrderbook.d.ts

@@ -1,5 +1,5 @@
 import { UseQueryResult } from '@tanstack/react-query';
-import type { GetOrderbookResult } from "@bluxcc/core/dist/exports/core/getOrderbook";
+import type { GetOrderbookResult } from "@bluxcc/core";
 import { Asset } from '@stellar/stellar-sdk';
 import { CallBuilderOptions } from '../utils';
 import type { QueryOptions } from '../utils';
@@ -24,5 +24,10 @@ type O = CallBuilderOptions;
  * console.log(data?.response.bids, data?.response.asks);
  * ```
  */
-export declare function useOrderbook(args: [selling: Asset, buying: Asset], options?: O, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
+export declare function useOrderbook(args: [selling: Asset, buying: Asset], options?: {
+    cursor?: string;
+    limit?: number;
+    network?: string;
+    order?: 'asc' | 'desc';
+}, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
 export {};

package/dist/useStellar/usePayments.d.ts

@@ -1,5 +1,5 @@
 import { UseQueryResult } from '@tanstack/react-query';
-import type { GetPaymentsOptions } from '@bluxcc/core/dist/exports/core/getPayments';
+import type { GetPaymentsOptions } from '@bluxcc/core';
 import { ServerApi } from '@stellar/stellar-sdk/lib/esm/horizon';
 import { PaymentCallBuilder } from '@stellar/stellar-sdk/lib/esm/horizon/payment_call_builder';
 import type { QueryOptions } from '../utils';
@@ -28,5 +28,22 @@ type O = GetPaymentsOptions;
  * const { data } = usePayments({ forAccount: 'GA…' });
  * ```
  */
-export declare function usePayments(options?: O, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
+export declare function usePayments(options?: {
+    /** Paging token; pass the previous page's cursor to fetch the next page. */
+    cursor?: string;
+    /** Maximum number of records returned per page. */
+    limit?: number;
+    /** Network passphrase to query. Defaults to the active network. */
+    network?: string;
+    /** Sort direction by ledger sequence. Defaults to Horizon's `asc`. */
+    order?: 'asc' | 'desc';
+    /** Only payments touching this account (address, SEP-2 address, or `.xlm` name). */
+    forAccount?: string;
+    /** Only payments in this ledger, by sequence number. */
+    forLedger?: string | number;
+    /** Only payments in this transaction, by hash. */
+    forTransaction?: string;
+    /** Include payments from failed transactions. Defaults to `false`. */
+    includeFailed?: boolean;
+}, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
 export {};

package/dist/useStellar/useReadContract.d.ts

@@ -0,0 +1,54 @@
+import { readContract } from '@bluxcc/core';
+import { UseQueryResult } from '@tanstack/react-query';
+import type { IContractCall, ReadContractsOptions } from '@bluxcc/core';
+import type { QueryOptions } from '../utils';
+type CoreReadContractResult = Awaited<ReturnType<typeof readContract>>;
+/** Typed result returned by {@link useReadContract}. */
+export type ReadContractHookResult<TReturnValue = unknown> = Omit<CoreReadContractResult, 'value'> & {
+    /** Decoded return value of the contract call. */
+    value: TReturnValue;
+};
+type O = ReadContractsOptions;
+/**
+ * Reads one Soroban contract function by simulating it — no transaction is
+ * submitted, so no signature or fees are required.
+ *
+ * The call names a contract `address`, a function `fn`, and a positional
+ * `args` array. Native values are encoded from the deployed contract ABI, and
+ * pre-built `xdr.ScVal`s remain supported. The result comes back already
+ * decoded in `data.value`, with the raw simulation in `data.raw`. For several
+ * calls at once use `useReadContracts`. For state-changing calls use
+ * `useWriteContract`.
+ *
+ * @param call - The contract call to simulate, `{ address, fn, args }`.
+ * @param options - Optional `network` (defaults to the active network).
+ * @param queryOptions - Optional TanStack Query options (`enabled`, `staleTime`,
+ *   …). `queryKey`/`queryFn` are managed by the hook.
+ * @returns A TanStack Query result. `data` is `{ raw, value }`.
+ *
+ * @example
+ * ```tsx
+ * const { data } = useReadContract<string>({
+ *   address: 'token.xlm',
+ *   fn: 'balance',
+ *   args: ['alice.xlm'],
+ * });
+ * const balance = data?.value; // string
+ * ```
+ */
+export declare function useReadContract<TReturnValue = unknown>(call: {
+    /** Contract id (`C...`) or `.xlm`/SEP-2 name resolving to a contract. */
+    address: string;
+    /** Name of the contract function to call. */
+    fn: string;
+    /**
+     * Positional call arguments. Native JS values are encoded from the deployed
+     * contract's spec; address-typed strings may be `G...`, `C...`, SEP-2, or
+     * `.xlm` names. Pre-encoded {@link xdr.ScVal} values are also accepted.
+     */
+    args: unknown[];
+}, options?: {
+    /** Network passphrase to simulate against. Defaults to the active network. */
+    network?: string;
+}, queryOptions?: QueryOptions<ReadContractHookResult<TReturnValue>>): UseQueryResult<ReadContractHookResult<TReturnValue>, Error>;
+export {};

package/dist/useStellar/useReadContracts.d.ts

@@ -1,17 +1,23 @@
 import { readContracts } from '@bluxcc/core';
 import { UseQueryResult } from '@tanstack/react-query';
-import type { IContractCall, ReadContractsOptions } from '@bluxcc/core/dist/exports/utils';
+import type { IContractCall, ReadContractsOptions } from '@bluxcc/core';
 import type { QueryOptions } from '../utils';
-type R = Awaited<ReturnType<typeof readContracts>>;
+type CoreReadContractsResult = Exclude<Awaited<ReturnType<typeof readContracts>>, readonly unknown[]>;
+/** Typed result returned by {@link useReadContracts}. */
+export type ReadContractsHookResult<TValues extends readonly unknown[] = readonly unknown[]> = Omit<CoreReadContractsResult, 'values'> & {
+    /** Decoded return values, index-aligned with the supplied calls. */
+    values: TValues;
+};
 type O = ReadContractsOptions;
 /**
  * Reads from one or more Soroban contracts by simulating their calls — no
  * transaction is submitted, so no signature or fees are required.
  *
- * Each call names a contract `address`, a function `fn`, and its `args` as
- * `xdr.ScVal`s — build those with the exported `ToScVal` helpers. Results come
- * back already decoded in `data.values`, with the raw simulation in `data.raws`.
- * For state-changing calls use `useWriteContract` instead.
+ * Each call names a contract `address`, a function `fn`, and a positional
+ * `args` array. Native values are encoded from the deployed contract ABI, and
+ * pre-built `xdr.ScVal`s remain supported. Results come back already decoded
+ * in `data.values`, with the raw simulation in `data.raws`. For state-changing
+ * calls use `useWriteContract` instead.
  *
  * @param calls - The contract calls to simulate, each `{ address, fn, args }`.
  * @param options - Optional `network` (defaults to the active network).
@@ -22,11 +28,15 @@ type O = ReadContractsOptions;
  *
  * @example
  * ```tsx
- * const { data } = useReadContracts([
- *   { address: 'C…', fn: 'balance', args: [ToScVal.address('GA…')] },
+ * const { data } = useReadContracts<[string, boolean]>([
+ *   { address: 'token.xlm', fn: 'balance', args: ['alice.xlm'] },
+ *   { address: 'token.xlm', fn: 'authorized', args: ['alice.xlm'] },
  * ]);
- * const balance = data?.values[0];
+ * const balance = data?.values[0]; // string
  * ```
  */
-export declare function useReadContracts(calls: IContractCall[], options?: O, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
+export declare function useReadContracts<TValues extends readonly unknown[] = readonly unknown[]>(calls: readonly IContractCall[], options?: {
+    /** Network passphrase to simulate against. Defaults to the active network. */
+    network?: string;
+}, queryOptions?: QueryOptions<ReadContractsHookResult<TValues>>): UseQueryResult<ReadContractsHookResult<TValues>, Error>;
 export {};

package/dist/useStellar/useResolveXlmName.d.ts

@@ -0,0 +1,22 @@
+import { type XlmNameLookupOptions, type XlmNameRecord } from '@bluxcc/core';
+import { type UseQueryResult } from '@tanstack/react-query';
+import type { QueryOptions } from '../utils';
+/**
+ * Resolves a `.xlm` name to a validated account or contract record.
+ *
+ * The query is independent of Blux's active transaction network because XLM
+ * Domains uses its mainnet registry. It stays disabled until `name` is non-empty.
+ *
+ * @param name - A `.xlm` name such as `alice.xlm` or `token.xlm`.
+ * @param options - Optional SEP-2 connection options.
+ * @param queryOptions - Optional TanStack Query options. `queryKey` and
+ *   `queryFn` are managed by the hook.
+ * @returns A TanStack Query result containing an {@link XlmNameRecord}.
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading, error } = useResolveXlmName('alice.xlm');
+ * console.log(data?.address);
+ * ```
+ */
+export declare function useResolveXlmName(name: string, options?: XlmNameLookupOptions, queryOptions?: QueryOptions<XlmNameRecord>): UseQueryResult<XlmNameRecord, Error>;

package/dist/useStellar/useResolveXlmNameByAddress.d.ts

@@ -0,0 +1,23 @@
+import { type XlmAccountNameRecord, type XlmNameLookupOptions } from '@bluxcc/core';
+import { type UseQueryResult } from '@tanstack/react-query';
+import type { QueryOptions } from '../utils';
+/**
+ * Finds one verified `.xlm` name associated with a classic Stellar account.
+ *
+ * The query accepts only a `G…` account address and stays disabled until the
+ * address is non-empty. If the account owns multiple names, XLM Domains chooses
+ * which reverse record to return.
+ *
+ * @param address - A classic Stellar account address (`G…`).
+ * @param options - Optional SEP-2 connection options.
+ * @param queryOptions - Optional TanStack Query options. `queryKey` and
+ *   `queryFn` are managed by the hook.
+ * @returns A TanStack Query result containing an {@link XlmAccountNameRecord}.
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading, error } = useResolveXlmNameByAddress('G…');
+ * console.log(data?.name);
+ * ```
+ */
+export declare function useResolveXlmNameByAddress(address: string, options?: XlmNameLookupOptions, queryOptions?: QueryOptions<XlmAccountNameRecord>): UseQueryResult<XlmAccountNameRecord, Error>;

package/dist/useStellar/useSacAddress.d.ts

@@ -1,4 +1,4 @@
-import type { AssetArg } from '@bluxcc/core/dist/exports/core/helpers';
+import type { AssetArg } from '@bluxcc/core';
 /**
  * Result of {@link useSacAddress}. Because the underlying derivation is
  * synchronous and local, there is no loading state — `data` is populated
@@ -19,7 +19,7 @@ export type UseSacAddressResult = {
  * actually deployed), so this hook is synchronous: it returns the value right
  * away rather than a TanStack query result. Feed the result into
  * {@link useTokenMetadata}, `transfer`'s `token` option, or
- * `useReadContracts` / `useWriteContract`.
+ * `useReadContract` / `useReadContracts` / `useWriteContract`.
  *
  * Errors are captured rather than thrown during render: an invalid asset or a
  * missing network passphrase surfaces as `{ data: undefined, error }`.

package/dist/useStellar/useStrictReceivePaths.d.ts

@@ -1,5 +1,5 @@
 import { UseQueryResult } from '@tanstack/react-query';
-import type { GetPaymentPathResult } from "@bluxcc/core/dist/exports/core/getStrictReceivePaths";
+import type { GetPaymentPathResult } from '@bluxcc/core';
 import { Asset } from '@stellar/stellar-sdk';
 import { CallBuilderOptions } from '../utils';
 import type { QueryOptions } from '../utils';
@@ -15,8 +15,8 @@ type O = CallBuilderOptions;
  * `useStrictSendPaths`.
  *
  * @param args - `[source, destinationAsset, destinationAmount]`: the source
- *   (a sending `G…` address, or an array of candidate source `Asset`s), the
- *   asset the destination receives, and the exact amount they receive.
+ *   (an account address/SEP-2/`.xlm` name, or an array of candidate source
+ *   `Asset`s), the asset the destination receives, and the exact amount.
  * @param options - Optional `cursor` / `limit` / `order` and `network`
  *   (defaults to active).
  * @param queryOptions - Optional TanStack Query options. `queryKey`/`queryFn`
@@ -33,5 +33,10 @@ export declare function useStrictReceivePaths(args: [
     source: string | Asset[],
     destinationAsset: Asset,
     destinationAmount: string
-], options?: O, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
+], options?: {
+    cursor?: string;
+    limit?: number;
+    network?: string;
+    order?: 'asc' | 'desc';
+}, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
 export {};

package/dist/useStellar/useStrictSendPaths.d.ts

@@ -1,5 +1,5 @@
 import { UseQueryResult } from '@tanstack/react-query';
-import type { GetPaymentPathResult } from "@bluxcc/core/dist/exports/core/getStrictSendPaths";
+import type { GetPaymentPathResult } from '@bluxcc/core';
 import { Asset } from '@stellar/stellar-sdk';
 import { CallBuilderOptions } from '../utils';
 import type { QueryOptions } from '../utils';
@@ -13,8 +13,8 @@ type O = CallBuilderOptions;
  * inverse — fixing the received amount — use `useStrictReceivePaths`.
  *
  * @param args - `[sourceAsset, sourceAmount, destination]`: the asset the sender
- *   spends, the exact amount they spend, and the destination (a `G…` address, or
- *   an array of candidate destination `Asset`s).
+ *   spends, the exact amount they spend, and the destination (an account
+ *   address/SEP-2/`.xlm` name, or candidate destination `Asset`s).
  * @param options - Optional `cursor` / `limit` / `order` and `network`
  *   (defaults to active).
  * @param queryOptions - Optional TanStack Query options. `queryKey`/`queryFn`
@@ -24,12 +24,17 @@ type O = CallBuilderOptions;
  *
  * @example
  * ```tsx
- * const { data } = useStrictSendPaths([Asset.native(), '50', 'GA…']);
+ * const { data } = useStrictSendPaths([Asset.native(), '50', 'alice.xlm']);
  * ```
  */
 export declare function useStrictSendPaths(args: [
     sourceAsset: Asset,
     sourceAmount: string,
     destination: string | Asset[]
-], options?: O, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
+], options?: {
+    cursor?: string;
+    limit?: number;
+    network?: string;
+    order?: 'asc' | 'desc';
+}, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
 export {};

package/dist/useStellar/useSwap.d.ts

@@ -1,6 +1,7 @@
+import type { AssetArg, Numberish, SwapType } from '@bluxcc/core';
 import { swap } from '@bluxcc/core';
 import { UseMutationResult } from '@tanstack/react-query';
-import type { SwapOptions } from '@bluxcc/core/dist/exports/core/swap';
+import type { SwapOptions } from '@bluxcc/core';
 import type { MutationOptions } from '../utils';
 type R = Awaited<ReturnType<typeof swap>>;
 /**
@@ -8,7 +9,35 @@ type R = Awaited<ReturnType<typeof swap>>;
  * knob it supports (`type` exactIn/exactOut, `slippage`, `to`, `memo`,
  * `network`) is just a field on the object passed to `swap({ ... })`.
  */
-export type SwapVariables = SwapOptions;
+export type SwapVariables = {
+    /** Asset being sold. Accepts `'xlm'` / `'native'`, a `CODE:ISSUER` string, or an `Asset`. */
+    fromAsset: AssetArg;
+    /** Asset being bought. Accepts `'xlm'` / `'native'`, a `CODE:ISSUER` string, or an `Asset`. */
+    toAsset: AssetArg;
+    /**
+     * The fixed amount. For `'exactIn'` this is how much `fromAsset` to send; for
+     * `'exactOut'` it is how much `toAsset` to receive. Numbers and bigints are
+     * coerced to a string.
+     */
+    amount: Numberish;
+    /** Which side is fixed. Defaults to `'exactIn'`. */
+    type?: SwapType;
+    /**
+     * Where the bought asset is delivered: a Stellar address (`G...`/`M...`), a
+     * SEP-2 federated address, or `.xlm` name. Defaults to the logged-in account.
+     */
+    to?: string;
+    /**
+     * Maximum acceptable slippage as a fraction, where `0.005` = 0.5%. Sets the
+     * `destMin` (exactIn) / `sendMax` (exactOut) guardrail off the quoted price.
+     * Defaults to `0.005`.
+     */
+    slippage?: number;
+    /** Optional text memo to attach to the transaction. */
+    memo?: string;
+    /** Network passphrase to swap on. Defaults to the active network. */
+    network?: string;
+};
 type V = SwapVariables;
 /**
  * Return type of {@link useSwap}: the full TanStack mutation result plus
@@ -57,7 +86,7 @@ export type UseSwapResult = UseMutationResult<R, Error, V> & {
  *   fromAsset: 'USDC:GA…',
  *   toAsset: 'xlm',
  *   amount: '25',
- *   to: 'GB…',
+ *   to: 'alice.xlm',
  *   slippage: 0.01, // 1%
  *   memo: 'cash out',
  * });

package/dist/useStellar/useTokenMetadata.d.ts

@@ -1,5 +1,5 @@
 import { UseQueryResult } from '@tanstack/react-query';
-import type { TokenMetadata, GetTokenMetadataOptions } from '@bluxcc/core/dist/exports/core/getTokenMetadata';
+import type { TokenMetadata, GetTokenMetadataOptions } from '@bluxcc/core';
 import type { QueryOptions } from '../utils';
 type R = TokenMetadata;
 type O = GetTokenMetadataOptions;
@@ -14,8 +14,8 @@ type O = GetTokenMetadataOptions;
  * Contracts, which expose `admin()` instead). The query stays disabled until a
  * non-empty `address` is provided.
  *
- * @param address - The token contract id (`C…`), e.g. a SAC from
- *   {@link useSacAddress} / `getSacAddress`.
+ * @param address - A token contract id (`C…`) or `.xlm`/SEP-2 name resolving
+ *   to one, e.g. a SAC from {@link useSacAddress} / `getSacAddress`.
  * @param options - Core read options (currently just `network`, which defaults
  *   to the active network).
  * @param queryOptions - Optional TanStack Query options (`enabled`, `staleTime`,
@@ -36,5 +36,8 @@ type O = GetTokenMetadataOptions;
  * });
  * ```
  */
-export declare function useTokenMetadata(address: string, options?: O, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
+export declare function useTokenMetadata(address: string, options?: {
+    /** Network passphrase to read from. Defaults to the active network. */
+    network?: string;
+}, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
 export {};