@bluxcc/react 0.3.7 → 0.3.8

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;
@@ -22,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,6 +1,6 @@
 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 CoreReadContractsResult = Exclude<Awaited<ReturnType<typeof readContracts>>, readonly unknown[]>;
 /** Typed result returned by {@link useReadContracts}. */
@@ -35,5 +35,8 @@ type O = ReadContractsOptions;
  * const balance = data?.values[0]; // string
  * ```
  */
-export declare function useReadContracts<TValues extends readonly unknown[] = readonly unknown[]>(calls: readonly IContractCall[], options?: O, queryOptions?: QueryOptions<ReadContractsHookResult<TValues>>): UseQueryResult<ReadContractsHookResult<TValues>, 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/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';
@@ -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';
@@ -31,5 +31,10 @@ 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

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;
@@ -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 {};

package/dist/useStellar/useTradeAggregation.d.ts

@@ -1,5 +1,5 @@
 import { UseQueryResult } from '@tanstack/react-query';
-import type { GetTradeAggregationResult } from "@bluxcc/core/dist/exports/core/getTradeAggregation";
+import type { GetTradeAggregationResult } from "@bluxcc/core";
 import { Asset } from '@stellar/stellar-sdk';
 import { CallBuilderOptions } from '../utils';
 import type { QueryOptions } from '../utils';
@@ -37,5 +37,10 @@ export declare function useTradeAggregation(args: [
     end_time: number,
     resolution: number,
     offset: number
-], 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/useTrades.d.ts

@@ -1,5 +1,6 @@
+import type { AssetArg } from '@bluxcc/core';
 import { UseQueryResult } from '@tanstack/react-query';
-import type { GetTradesResult, GetTradesOptions } from "@bluxcc/core/dist/exports/core/getTrades";
+import type { GetTradesResult, GetTradesOptions } from "@bluxcc/core";
 import type { QueryOptions } from "../utils";
 type R = GetTradesResult;
 type O = GetTradesOptions;
@@ -23,5 +24,24 @@ type O = GetTradesOptions;
  * });
  * ```
  */
-export declare function useTrades(options?: O, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
+export declare function useTrades(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 trades for this `[base, counter]` asset pair. Each accepts `'xlm'`, `'CODE:ISSUER'`, or an `Asset`. */
+    forAssetPair?: [base: AssetArg, counter: AssetArg];
+    /** Only trades against this offer id. */
+    forOffer?: string;
+    /** Only trades of this type (e.g. `orderbook`, `liquidity_pool`). */
+    forType?: Horizon.ServerApi.TradeType;
+    /** Only trades involving this account (address, SEP-2 address, or `.xlm` name). */
+    forAccount?: string;
+    /** Only trades for this liquidity pool id. */
+    forLiquidityPool?: string;
+}, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
 export {};

package/dist/useStellar/useTransactions.d.ts

@@ -1,5 +1,5 @@
 import { UseQueryResult } from '@tanstack/react-query';
-import type { GetTransactionsResult, GetTransactionsOptions } from "@bluxcc/core/dist/exports/core/getTransactions";
+import type { GetTransactionsResult, GetTransactionsOptions } from "@bluxcc/core";
 import type { QueryOptions } from "../utils";
 type R = GetTransactionsResult;
 type O = GetTransactionsOptions;
@@ -21,5 +21,24 @@ type O = GetTransactionsOptions;
  * const { data } = useTransactions({ forAccount: 'GA…', limit: 25 });
  * ```
  */
-export declare function useTransactions(options?: O, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
+export declare function useTransactions(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 transactions touching this account (address, SEP-2 address, or `.xlm` name). */
+    forAccount?: string;
+    /** Only transactions affecting this claimable balance id. */
+    forClaimableBalance?: string;
+    /** Only transactions in this ledger, by sequence number. */
+    forLedger?: string | number;
+    /** Only transactions affecting this liquidity pool id. */
+    forLiquidityPool?: string;
+    /** Include failed transactions. Defaults to `false`. */
+    includeFailed?: boolean;
+}, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
 export {};

package/dist/useStellar/useTransfer.d.ts

@@ -1,6 +1,7 @@
+import type { AssetArg, Numberish } from '@bluxcc/core';
 import { transfer } from '@bluxcc/core';
 import { UseMutationResult } from '@tanstack/react-query';
-import type { TransferOptions } from '@bluxcc/core/dist/exports/core/transfer';
+import type { TransferOptions } from '@bluxcc/core';
 import type { MutationOptions } from '../utils';
 type R = Awaited<ReturnType<typeof transfer>>;
 /**
@@ -9,7 +10,41 @@ type R = Awaited<ReturnType<typeof transfer>>;
  * token, federated address, `.xlm` name) is just a different object passed to
  * `transfer({ ... })`.
  */
-export type TransferVariables = TransferOptions;
+export type TransferVariables = {
+    /**
+     * Recipient: a Stellar address (`G...` or muxed `M...`), a SEP-2 federated
+     * address (`alice*example.com`), or a `.xlm` name. For a `token` transfer a
+     * contract id (`C...`) or a name resolving to one is also accepted.
+     */
+    to: string;
+    /**
+     * Amount to send. Numbers and bigints are coerced to a string. For classic
+     * assets this is a decimal amount (`"10.5"`); for a `token` it is the integer
+     * base-unit amount the contract expects.
+     */
+    amount: Numberish;
+    /**
+     * Asset to send. Accepts `'xlm'` / `'native'`, a `CODE:ISSUER` string, or an
+     * `Asset`. Defaults to the native lumen. Ignored when `token` is set.
+     */
+    asset?: AssetArg;
+    /** Optional text memo. Ignored for `token` (Soroban) transfers. */
+    memo?: string;
+    /**
+     * When the recipient cannot receive the asset directly (its account does not
+     * exist, or it has no trustline for an issued asset), send a claimable balance
+     * it can claim later instead of failing. Defaults to `false`.
+     */
+    claimable?: boolean;
+    /**
+     * A SEP-41 token contract id (`C...`) or name resolving to one. When set,
+     * value moves through the contract's `transfer(from, to, amount)` entrypoint
+     * instead of a classic op.
+     */
+    token?: string;
+    /** Network passphrase to send on. Defaults to the active network. */
+    network?: string;
+};
 type V = TransferVariables;
 /**
  * Return type of {@link useTransfer}: the full TanStack mutation result plus

package/dist/useStellar/useWriteContract.d.ts

@@ -1,6 +1,6 @@
 import { writeContract } from '@bluxcc/core';
 import { UseMutationResult } from '@tanstack/react-query';
-import type { IContractCall, WriteContractsOptions } from '@bluxcc/core/dist/exports/utils';
+import type { IContractCall, WriteContractsOptions } from '@bluxcc/core';
 import type { MutationOptions } from '../utils';
 type CoreWriteContractResult = Awaited<ReturnType<typeof writeContract>>;
 /** Submitted transaction with a caller-specified decoded contract result. */
@@ -23,7 +23,7 @@ type V = WriteContractVariables;
  *
  * A thin wrapper over TanStack Query's `useMutation`: call `mutate` /
  * `mutateAsync` with the contract call to sign and send it. For read-only calls
- * (no signature, no fees) use `useReadContracts` instead.
+ * (no signature, no fees) use `useReadContract` or `useReadContracts` instead.
  *
  * @param mutationOptions - Optional TanStack Mutation options (`onSuccess`,
  *   `onError`, `onSettled`, …); `mutationFn` is provided by the hook.