@bluxcc/react 0.2.7 → 0.2.8

package/dist/Provider.d.ts

@@ -4,5 +4,36 @@ type BluxProviderProps = {
     config: IConfig;
     children: React.ReactNode | any;
 };
+/**
+ * Root provider that initializes Blux; it must wrap any part of the app that
+ * uses Blux hooks.
+ *
+ * It applies your `config` (and its optional `appearance`) via the core
+ * `createConfig` / `setAppearance`, mounts the host element the wallet modal
+ * renders into, and supplies the TanStack `QueryClient` that every query and
+ * mutation hook depends on. Place it near the root of your tree.
+ *
+ * @param props - Component props.
+ * @param props.config - The Blux `IConfig` (`appId`, `appName`, `networks`,
+ *   optional `defaultNetwork` / `appearance` / `loginMethods` / …) used to
+ *   initialize the SDK.
+ * @param props.children - Your application tree.
+ * @returns The provider element wrapping `children`.
+ *
+ * @example
+ * ```tsx
+ * import { BluxProvider, networks } from '@bluxcc/react';
+ *
+ * const config = {
+ *   appId: 'your-app-id',
+ *   appName: 'My App',
+ *   networks: [networks.testnet],
+ * };
+ *
+ * <BluxProvider config={config}>
+ *   <App />
+ * </BluxProvider>;
+ * ```
+ */
 export declare const BluxProvider: ({ config, children }: BluxProviderProps) => React.JSX.Element;
 export {};

package/dist/hooks/useBlux.d.ts

@@ -1,3 +1,29 @@
+/**
+ * The primary wallet/session hook: returns the live `blux` instance and
+ * re-renders when the connected user or auth state changes.
+ *
+ * Use it to drive authentication and signing from the UI. The returned object
+ * exposes session actions (`login`, `logout`, `fundMe`, `profile`), signing and
+ * submission (`signTransaction`, `signMessage`, `signAuthEntry`,
+ * `sendTransaction`), and reactive state (`user`, `isAuthenticated`, `isReady`).
+ *
+ * @returns The reactive `blux` instance.
+ *
+ * @example
+ * ```tsx
+ * const blux = useBlux();
+ *
+ * if (!blux.isAuthenticated) {
+ *   return <button onClick={() => blux.login()}>Connect wallet</button>;
+ * }
+ * return (
+ *   <>
+ *     <span>{blux.user?.address}</span>
+ *     <button onClick={() => blux.logout()}>Disconnect</button>
+ *   </>
+ * );
+ * ```
+ */
 export declare const useBlux: () => {
     login: () => Promise<import("@bluxcc/core/dist/store").IUser>;
     logout: () => void;

package/dist/index.cjs.js

@@ -1 +1 @@
-"use strict";var e=require("@bluxcc/core"),n=require("@stellar/stellar-sdk"),o=require("react"),l=require("@tanstack/react-query");const r=n=>{const{user:o}=e.getState();return n||(null==o?void 0:o.address)},u=n=>{const{stellar:o}=e.getState();return!n&&o?o.activeNetwork:n};const t=new l.QueryClient;Object.defineProperty(exports,"networks",{enumerable:!0,get:function(){return e.networks}}),Object.defineProperty(exports,"setAppearance",{enumerable:!0,get:function(){return e.setAppearance}}),Object.defineProperty(exports,"Asset",{enumerable:!0,get:function(){return n.Asset}}),exports.BluxProvider=({config:n,children:r})=>{const u=o.useRef(null),{appearance:i,...s}=null!=n?n:{},d=o.useMemo(()=>s,[JSON.stringify(s)]);return o.useEffect(()=>{u.current&&e.createConfig(n,u.current)},[u,d]),o.useEffect(()=>{u.current&&e.setAppearance(null!=i?i:{})},[u,i]),o.createElement(l.QueryClientProvider,{client:t},o.createElement("div",{ref:u},r))},exports.useAccount=function(n,t){var i;const s=r(null==n?void 0:n.address),d=u(null==n?void 0:n.network),a=null===(i=null==t?void 0:t.enabled)||void 0===i||i,c=[s,d],v=o.useMemo(()=>["blux","account",d,...c],[d,...c]),y=o.useMemo(()=>async()=>{const o={...n,address:s,network:d};return e.getAccount(o)},[d,...c]);return l.useQuery({...t,enabled:a,queryKey:v,queryFn:y})},exports.useAccounts=function(n,r){var t;const i=u(null==n?void 0:n.network),s=null===(t=null==r?void 0:r.enabled)||void 0===t||t,d=[null==n?void 0:n.forSigner,null==n?void 0:n.forAsset,null==n?void 0:n.sponsor,null==n?void 0:n.forLiquidityPool,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],a=o.useMemo(()=>["blux","accounts",i,...d],[i,...d]),c=o.useMemo(()=>async()=>{const o={...n,network:i};return e.getAccounts(o)},[i,...d]);return l.useQuery({...r,enabled:s,queryKey:a,queryFn:c})},exports.useAssets=function(n,r){var t;const i=u(null==n?void 0:n.network),s=null===(t=null==r?void 0:r.enabled)||void 0===t||t,d=[null==n?void 0:n.forCode,null==n?void 0:n.forIssuer,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],a=o.useMemo(()=>["blux","assets",i,...d],[i,n,...d]),c=o.useMemo(()=>async()=>{const o={...n,network:i};return e.getAssets(o)},[i,n,...d]);return l.useQuery({...r,enabled:s,queryKey:a,queryFn:c})},exports.useBalances=function(n,t){var i,s;const d=r(null==n?void 0:n.address),a=u(null==n?void 0:n.network),c=null===(i=null==t?void 0:t.enabled)||void 0===i||i,v=null===(s=null==n?void 0:n.includeZeroBalances)||void 0===s||s,y=[d,a,v],f=o.useMemo(()=>["blux","balances",a,...y],[a,...y]),b=o.useMemo(()=>async()=>{const o={...n,address:d,includeZeroBalances:v,network:a};return e.getBalances(o)},[a,...y]);return l.useQuery({...t,enabled:c,queryKey:f,queryFn:b})},exports.useBlux=()=>{const[n,l]=o.useState(e.blux),r=e.useExportedStore(e=>e.user),u=e.useExportedStore(e=>e.authState);return o.useEffect(()=>{l(e.blux)},[r,u]),n},exports.useClaimableBalances=function(n,t){var i;const s=r(n.claimant),d=u(null==n?void 0:n.network),a=null===(i=null==t?void 0:t.enabled)||void 0===i||i,c=[s,null==n?void 0:n.asset,null==n?void 0:n.sponsor,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],v=o.useMemo(()=>["blux","claimableBalances",d,...c],[d,...c]),y=o.useMemo(()=>async()=>{const o={...n,claimant:s,network:d};return e.getClaimableBalances(o)},[d,...c]);return l.useQuery({...t,enabled:a,queryKey:v,queryFn:y})},exports.useEffects=function(n,r){var t;const i=u(null==n?void 0:n.network),s=null===(t=null==r?void 0:r.enabled)||void 0===t||t,d=[null==n?void 0:n.forAccount,null==n?void 0:n.forLedger,null==n?void 0:n.forTransaction,null==n?void 0:n.forOperation,null==n?void 0:n.forLiquidityPool,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],a=o.useMemo(()=>["blux","effects",i,...d],[i,...d]),c=o.useMemo(()=>async()=>{const o={...n,network:i};return e.getEffects(o)},[i,...d]);return l.useQuery({...r,enabled:s,queryKey:a,queryFn:c})},exports.useLedgers=function(n,r){var t;const i=u(null==n?void 0:n.network),s=null===(t=null==r?void 0:r.enabled)||void 0===t||t,d=[null==n?void 0:n.ledger,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],a=o.useMemo(()=>["blux","ledgers",i,...d],[i,n,...d]),c=o.useMemo(()=>async()=>{const o={...n,network:i};return e.getLedgers(o)},[i,n,...d]);return l.useQuery({...r,enabled:s,queryKey:a,queryFn:c})},exports.useLiquidityPools=function(n,r){var t;const i=u(null==n?void 0:n.network),s=null===(t=null==r?void 0:r.enabled)||void 0===t||t,d=[null==n?void 0:n.forAccount,null==n?void 0:n.forAssets,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],a=o.useMemo(()=>["blux","liquidityPools",i,...d],[i,...d]),c=o.useMemo(()=>async()=>{const o={...n,network:i};return e.getLiquidityPools(o)},[i,...d]);return l.useQuery({...r,enabled:s,queryKey:a,queryFn:c})},exports.useNetwork=()=>{var n;const l=e.useExportedStore(e=>e),[r,u]=o.useState((null===(n=l.stellar)||void 0===n?void 0:n.activeNetwork)||l.config.defaultNetwork);return o.useEffect(()=>{var e;u((null===(e=l.stellar)||void 0===e?void 0:e.activeNetwork)||l.config.defaultNetwork)},[l.stellar,l.config]),r},exports.useOffers=function(n,r){var t;const i=u(null==n?void 0:n.network),s=null===(t=null==r?void 0:r.enabled)||void 0===t||t,d=[null==n?void 0:n.forAccount,null==n?void 0:n.buying,null==n?void 0:n.selling,null==n?void 0:n.sponsor,null==n?void 0:n.seller,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],a=o.useMemo(()=>["blux","offers",i,...d],[i,...d]),c=o.useMemo(()=>async()=>{const o={...n,network:i};return e.getOffers(o)},[i,...d]);return l.useQuery({...r,enabled:s,queryKey:a,queryFn:c})},exports.useOperations=function(n,r){var t;const i=u(null==n?void 0:n.network),s=null===(t=null==r?void 0:r.enabled)||void 0===t||t,d=[null==n?void 0:n.forAccount,null==n?void 0:n.includeFailed,null==n?void 0:n.forClaimableBalance,null==n?void 0:n.forLedger,null==n?void 0:n.forTransaction,null==n?void 0:n.forLiquidityPool,null==n?void 0:n.forAccount,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],a=o.useMemo(()=>["blux","operations",i,...d],[i,...d]),c=o.useMemo(()=>async()=>{const o={...n,network:i};return e.getOperations(o)},[i,n,...d]);return l.useQuery({...r,enabled:s,queryKey:a,queryFn:c})},exports.useOrderbook=function(n,r,t){var i;const s=u(null==r?void 0:r.network),d=null===(i=null==t?void 0:t.enabled)||void 0===i||i,a=[n[0],n[1],null==r?void 0:r.cursor,null==r?void 0:r.limit,null==r?void 0:r.network,null==r?void 0:r.order],c=o.useMemo(()=>["blux","orderbook",s,...a],[s,r,...a]),v=o.useMemo(()=>async()=>{const o={...r,network:s};return e.getOrderbook(n,o)},[s,r,...a]);return l.useQuery({...t,enabled:d,queryKey:c,queryFn:v})},exports.usePayments=function(n,r){var t;const i=u(null==n?void 0:n.network),s=null===(t=null==r?void 0:r.enabled)||void 0===t||t,d=[null==n?void 0:n.forAccount,null==n?void 0:n.includeFailed,null==n?void 0:n.forLedger,null==n?void 0:n.forTransaction,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],a=o.useMemo(()=>["blux","payments",i,...d],[i,...d]),c=o.useMemo(()=>async()=>{const o={...n,network:i};return e.getPayments(o)},[i,...d]);return l.useQuery({...r,enabled:s,queryKey:a,queryFn:c})},exports.useReadContracts=function(n,r,t){var i;const s=u(null==r?void 0:r.network),d=null===(i=null==t?void 0:t.enabled)||void 0===i||i,a=o.useMemo(()=>JSON.stringify((null!=n?n:[]).map(e=>{var n;return{address:null==e?void 0:e.address,fn:null==e?void 0:e.fn,args:(null!==(n=null==e?void 0:e.args)&&void 0!==n?n:[]).map(e=>e.toXDR("base64"))}})),[n]),c=[s,a],v=o.useMemo(()=>["blux","readContracts",s,a],[...c]),y=o.useMemo(()=>async()=>{const o={...r,network:s};return e.readContracts(n,o)},[...c]);return l.useQuery({...t,enabled:d,queryKey:v,queryFn:y})},exports.useStrictReceivePaths=function(n,r,t){var i;const s=u(null==r?void 0:r.network),d=null===(i=null==t?void 0:t.enabled)||void 0===i||i,a=[n[0],n[1],n[2],null==r?void 0:r.cursor,null==r?void 0:r.limit,null==r?void 0:r.network,null==r?void 0:r.order],c=o.useMemo(()=>["blux","strictReceivePaths",s,...a],[s,r,...a]),v=o.useMemo(()=>async()=>{const o={...r,network:s};return e.getStrictReceivePaths(n,o)},[s,r,...a]);return l.useQuery({...t,enabled:d,queryKey:c,queryFn:v})},exports.useStrictSendPaths=function(n,r,t){var i;const s=u(null==r?void 0:r.network),d=null===(i=null==t?void 0:t.enabled)||void 0===i||i,a=[n[0],n[1],n[2],null==r?void 0:r.cursor,null==r?void 0:r.limit,null==r?void 0:r.network,null==r?void 0:r.order],c=o.useMemo(()=>["blux","strictSendPaths",s,...a],[s,r,...a]),v=o.useMemo(()=>async()=>{const o={...r,network:s};return e.getStrictSendPaths(n,o)},[s,r,...a]);return l.useQuery({...t,enabled:d,queryKey:c,queryFn:v})},exports.useSwitchNetwork=()=>({networks:e.networks,switchNetwork:e.switchNetwork}),exports.useTradeAggregation=function(n,r,t){var i;const s=u(null==r?void 0:r.network),d=null===(i=null==t?void 0:t.enabled)||void 0===i||i,a=[n[0],n[1],n[2],n[3],n[4],n[5],null==r?void 0:r.cursor,null==r?void 0:r.limit,null==r?void 0:r.network,null==r?void 0:r.order],c=o.useMemo(()=>["blux","tradeAggregation",s,...a],[s,r,...a]),v=o.useMemo(()=>async()=>{const o={...r,network:s};return e.getTradeAggregation(n,o)},[s,r,...a]);return l.useQuery({...t,enabled:d,queryKey:c,queryFn:v})},exports.useTrades=function(n,r){var t;const i=u(null==n?void 0:n.network),s=null===(t=null==r?void 0:r.enabled)||void 0===t||t,d=[null==n?void 0:n.forAssetPair,null==n?void 0:n.forOffer,null==n?void 0:n.forType,null==n?void 0:n.forLiquidityPool,null==n?void 0:n.forAccount,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],a=o.useMemo(()=>["blux","trades",i,...d],[i,...d]),c=o.useMemo(()=>async()=>{const o={...n,network:i};return e.getTrades(o)},[i,...d]);return l.useQuery({...r,enabled:s,queryKey:a,queryFn:c})},exports.useTransactions=function(n,r){var t;const i=u(null==n?void 0:n.network),s=null===(t=null==r?void 0:r.enabled)||void 0===t||t,d=[null==n?void 0:n.forAccount,null==n?void 0:n.includeFailed,null==n?void 0:n.forClaimableBalance,null==n?void 0:n.forLedger,null==n?void 0:n.forLiquidityPool,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],a=o.useMemo(()=>["blux","transactions",i,...d],[i,...d]),c=o.useMemo(()=>async()=>{const o={...n,network:i};return e.getTransactions(o)},[i,...d]);return l.useQuery({...r,enabled:s,queryKey:a,queryFn:c})},exports.useWriteContract=function(n){return l.useMutation({...n,mutationFn:async({call:n,options:o})=>e.writeContract(n,o)})};
+"use strict";var e=require("@bluxcc/core"),n=require("@stellar/stellar-sdk"),r=require("react"),t=require("@tanstack/react-query");const o=n=>{const{user:r}=e.getState();return n||(null==r?void 0:r.address)},u=n=>{const{stellar:r}=e.getState();return!n&&r?r.activeNetwork:n};const l=new t.QueryClient;Object.defineProperty(exports,"BluxEvent",{enumerable:!0,get:function(){return e.BluxEvent}}),Object.defineProperty(exports,"StellarSdk",{enumerable:!0,get:function(){return e.StellarSdk}}),Object.defineProperty(exports,"ToScVal",{enumerable:!0,get:function(){return e.ToScVal}}),Object.defineProperty(exports,"events",{enumerable:!0,get:function(){return e.events}}),Object.defineProperty(exports,"getAccount",{enumerable:!0,get:function(){return e.getAccount}}),Object.defineProperty(exports,"getAccounts",{enumerable:!0,get:function(){return e.getAccounts}}),Object.defineProperty(exports,"getAssets",{enumerable:!0,get:function(){return e.getAssets}}),Object.defineProperty(exports,"getBalances",{enumerable:!0,get:function(){return e.getBalances}}),Object.defineProperty(exports,"getClaimableBalances",{enumerable:!0,get:function(){return e.getClaimableBalances}}),Object.defineProperty(exports,"getEffects",{enumerable:!0,get:function(){return e.getEffects}}),Object.defineProperty(exports,"getInitialState",{enumerable:!0,get:function(){return e.getInitialState}}),Object.defineProperty(exports,"getLedgers",{enumerable:!0,get:function(){return e.getLedgers}}),Object.defineProperty(exports,"getLiquidityPools",{enumerable:!0,get:function(){return e.getLiquidityPools}}),Object.defineProperty(exports,"getNetwork",{enumerable:!0,get:function(){return e.getNetwork}}),Object.defineProperty(exports,"getOffers",{enumerable:!0,get:function(){return e.getOffers}}),Object.defineProperty(exports,"getOperations",{enumerable:!0,get:function(){return e.getOperations}}),Object.defineProperty(exports,"getOrderbook",{enumerable:!0,get:function(){return e.getOrderbook}}),Object.defineProperty(exports,"getPayments",{enumerable:!0,get:function(){return e.getPayments}}),Object.defineProperty(exports,"getSacAddress",{enumerable:!0,get:function(){return e.getSacAddress}}),Object.defineProperty(exports,"getState",{enumerable:!0,get:function(){return e.getState}}),Object.defineProperty(exports,"getStrictReceivePaths",{enumerable:!0,get:function(){return e.getStrictReceivePaths}}),Object.defineProperty(exports,"getStrictSendPaths",{enumerable:!0,get:function(){return e.getStrictSendPaths}}),Object.defineProperty(exports,"getTokenMetadata",{enumerable:!0,get:function(){return e.getTokenMetadata}}),Object.defineProperty(exports,"getTradeAggregation",{enumerable:!0,get:function(){return e.getTradeAggregation}}),Object.defineProperty(exports,"getTrades",{enumerable:!0,get:function(){return e.getTrades}}),Object.defineProperty(exports,"getTransactions",{enumerable:!0,get:function(){return e.getTransactions}}),Object.defineProperty(exports,"networks",{enumerable:!0,get:function(){return e.networks}}),Object.defineProperty(exports,"numberish",{enumerable:!0,get:function(){return e.numberish}}),Object.defineProperty(exports,"readContracts",{enumerable:!0,get:function(){return e.readContracts}}),Object.defineProperty(exports,"setAppearance",{enumerable:!0,get:function(){return e.setAppearance}}),Object.defineProperty(exports,"subscribe",{enumerable:!0,get:function(){return e.subscribe}}),Object.defineProperty(exports,"swap",{enumerable:!0,get:function(){return e.swap}}),Object.defineProperty(exports,"switchNetwork",{enumerable:!0,get:function(){return e.switchNetwork}}),Object.defineProperty(exports,"useExportedStore",{enumerable:!0,get:function(){return e.useExportedStore}}),Object.defineProperty(exports,"writeContract",{enumerable:!0,get:function(){return e.writeContract}}),Object.defineProperty(exports,"Asset",{enumerable:!0,get:function(){return n.Asset}}),exports.BluxProvider=({config:n,children:o})=>{const u=r.useRef(null),{appearance:s,...i}=null!=n?n:{},d=r.useMemo(()=>i,[JSON.stringify(i)]);return r.useEffect(()=>{u.current&&e.createConfig(n,u.current)},[u,d]),r.useEffect(()=>{u.current&&e.setAppearance(null!=s?s:{})},[u,s]),r.createElement(t.QueryClientProvider,{client:l},r.createElement("div",{ref:u},o))},exports.useAccount=function(n,l){var s;const i=o(null==n?void 0:n.address),d=u(null==n?void 0:n.network),a=null===(s=null==l?void 0:l.enabled)||void 0===s||s,c=[i,d],v=r.useMemo(()=>["blux","account",d,...c],[d,...c]),f=r.useMemo(()=>async()=>{const r={...n,address:i,network:d};return e.getAccount(r)},[d,...c]);return t.useQuery({...l,enabled:a,queryKey:v,queryFn:f})},exports.useAccounts=function(n,o){var l;const s=u(null==n?void 0:n.network),i=null===(l=null==o?void 0:o.enabled)||void 0===l||l,d=[null==n?void 0:n.forSigner,null==n?void 0:n.forAsset,null==n?void 0:n.sponsor,null==n?void 0:n.forLiquidityPool,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],a=r.useMemo(()=>["blux","accounts",s,...d],[s,...d]),c=r.useMemo(()=>async()=>{const r={...n,network:s};return e.getAccounts(r)},[s,...d]);return t.useQuery({...o,enabled:i,queryKey:a,queryFn:c})},exports.useAssets=function(n,o){var l;const s=u(null==n?void 0:n.network),i=null===(l=null==o?void 0:o.enabled)||void 0===l||l,d=[null==n?void 0:n.forCode,null==n?void 0:n.forIssuer,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],a=r.useMemo(()=>["blux","assets",s,...d],[s,n,...d]),c=r.useMemo(()=>async()=>{const r={...n,network:s};return e.getAssets(r)},[s,n,...d]);return t.useQuery({...o,enabled:i,queryKey:a,queryFn:c})},exports.useBalances=function(n,l){var s,i;const d=o(null==n?void 0:n.address),a=u(null==n?void 0:n.network),c=null===(s=null==l?void 0:l.enabled)||void 0===s||s,v=null===(i=null==n?void 0:n.includeZeroBalances)||void 0===i||i,f=[d,a,v],y=r.useMemo(()=>["blux","balances",a,...f],[a,...f]),b=r.useMemo(()=>async()=>{const r={...n,address:d,includeZeroBalances:v,network:a};return e.getBalances(r)},[a,...f]);return t.useQuery({...l,enabled:c,queryKey:y,queryFn:b})},exports.useBlux=()=>{const[n,t]=r.useState(e.blux),o=e.useExportedStore(e=>e.user),u=e.useExportedStore(e=>e.authState);return r.useEffect(()=>{t(e.blux)},[o,u]),n},exports.useClaimableBalances=function(n,l){var s;const i=o(n.claimant),d=u(null==n?void 0:n.network),a=null===(s=null==l?void 0:l.enabled)||void 0===s||s,c=[i,null==n?void 0:n.asset,null==n?void 0:n.sponsor,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],v=r.useMemo(()=>["blux","claimableBalances",d,...c],[d,...c]),f=r.useMemo(()=>async()=>{const r={...n,claimant:i,network:d};return e.getClaimableBalances(r)},[d,...c]);return t.useQuery({...l,enabled:a,queryKey:v,queryFn:f})},exports.useEffects=function(n,o){var l;const s=u(null==n?void 0:n.network),i=null===(l=null==o?void 0:o.enabled)||void 0===l||l,d=[null==n?void 0:n.forAccount,null==n?void 0:n.forLedger,null==n?void 0:n.forTransaction,null==n?void 0:n.forOperation,null==n?void 0:n.forLiquidityPool,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],a=r.useMemo(()=>["blux","effects",s,...d],[s,...d]),c=r.useMemo(()=>async()=>{const r={...n,network:s};return e.getEffects(r)},[s,...d]);return t.useQuery({...o,enabled:i,queryKey:a,queryFn:c})},exports.useLedgers=function(n,o){var l;const s=u(null==n?void 0:n.network),i=null===(l=null==o?void 0:o.enabled)||void 0===l||l,d=[null==n?void 0:n.ledger,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],a=r.useMemo(()=>["blux","ledgers",s,...d],[s,n,...d]),c=r.useMemo(()=>async()=>{const r={...n,network:s};return e.getLedgers(r)},[s,n,...d]);return t.useQuery({...o,enabled:i,queryKey:a,queryFn:c})},exports.useLiquidityPools=function(n,o){var l;const s=u(null==n?void 0:n.network),i=null===(l=null==o?void 0:o.enabled)||void 0===l||l,d=[null==n?void 0:n.forAccount,null==n?void 0:n.forAssets,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],a=r.useMemo(()=>["blux","liquidityPools",s,...d],[s,...d]),c=r.useMemo(()=>async()=>{const r={...n,network:s};return e.getLiquidityPools(r)},[s,...d]);return t.useQuery({...o,enabled:i,queryKey:a,queryFn:c})},exports.useNetwork=()=>{var n;const t=e.useExportedStore(e=>e),[o,u]=r.useState((null===(n=t.stellar)||void 0===n?void 0:n.activeNetwork)||t.config.defaultNetwork);return r.useEffect(()=>{var e;u((null===(e=t.stellar)||void 0===e?void 0:e.activeNetwork)||t.config.defaultNetwork)},[t.stellar,t.config]),o},exports.useOffers=function(n,o){var l;const s=u(null==n?void 0:n.network),i=null===(l=null==o?void 0:o.enabled)||void 0===l||l,d=[null==n?void 0:n.forAccount,null==n?void 0:n.buying,null==n?void 0:n.selling,null==n?void 0:n.sponsor,null==n?void 0:n.seller,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],a=r.useMemo(()=>["blux","offers",s,...d],[s,...d]),c=r.useMemo(()=>async()=>{const r={...n,network:s};return e.getOffers(r)},[s,...d]);return t.useQuery({...o,enabled:i,queryKey:a,queryFn:c})},exports.useOperations=function(n,o){var l;const s=u(null==n?void 0:n.network),i=null===(l=null==o?void 0:o.enabled)||void 0===l||l,d=[null==n?void 0:n.forAccount,null==n?void 0:n.includeFailed,null==n?void 0:n.forClaimableBalance,null==n?void 0:n.forLedger,null==n?void 0:n.forTransaction,null==n?void 0:n.forLiquidityPool,null==n?void 0:n.forAccount,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],a=r.useMemo(()=>["blux","operations",s,...d],[s,...d]),c=r.useMemo(()=>async()=>{const r={...n,network:s};return e.getOperations(r)},[s,n,...d]);return t.useQuery({...o,enabled:i,queryKey:a,queryFn:c})},exports.useOrderbook=function(n,o,l){var s;const i=u(null==o?void 0:o.network),d=null===(s=null==l?void 0:l.enabled)||void 0===s||s,a=[n[0],n[1],null==o?void 0:o.cursor,null==o?void 0:o.limit,null==o?void 0:o.network,null==o?void 0:o.order],c=r.useMemo(()=>["blux","orderbook",i,...a],[i,o,...a]),v=r.useMemo(()=>async()=>{const r={...o,network:i};return e.getOrderbook(n,r)},[i,o,...a]);return t.useQuery({...l,enabled:d,queryKey:c,queryFn:v})},exports.usePayments=function(n,o){var l;const s=u(null==n?void 0:n.network),i=null===(l=null==o?void 0:o.enabled)||void 0===l||l,d=[null==n?void 0:n.forAccount,null==n?void 0:n.includeFailed,null==n?void 0:n.forLedger,null==n?void 0:n.forTransaction,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],a=r.useMemo(()=>["blux","payments",s,...d],[s,...d]),c=r.useMemo(()=>async()=>{const r={...n,network:s};return e.getPayments(r)},[s,...d]);return t.useQuery({...o,enabled:i,queryKey:a,queryFn:c})},exports.useReadContracts=function(n,o,l){var s;const i=u(null==o?void 0:o.network),d=null===(s=null==l?void 0:l.enabled)||void 0===s||s,a=r.useMemo(()=>JSON.stringify((null!=n?n:[]).map(e=>{var n;return{address:null==e?void 0:e.address,fn:null==e?void 0:e.fn,args:(null!==(n=null==e?void 0:e.args)&&void 0!==n?n:[]).map(e=>e.toXDR("base64"))}})),[n]),c=[i,a],v=r.useMemo(()=>["blux","readContracts",i,a],[...c]),f=r.useMemo(()=>async()=>{const r={...o,network:i};return e.readContracts(n,r)},[...c]);return t.useQuery({...l,enabled:d,queryKey:v,queryFn:f})},exports.useSacAddress=function(n,t){const o=u(t);return r.useMemo(()=>{try{return{data:e.getSacAddress(n,o),error:null}}catch(e){return{data:void 0,error:e}}},[n,o])},exports.useStrictReceivePaths=function(n,o,l){var s;const i=u(null==o?void 0:o.network),d=null===(s=null==l?void 0:l.enabled)||void 0===s||s,a=[n[0],n[1],n[2],null==o?void 0:o.cursor,null==o?void 0:o.limit,null==o?void 0:o.network,null==o?void 0:o.order],c=r.useMemo(()=>["blux","strictReceivePaths",i,...a],[i,o,...a]),v=r.useMemo(()=>async()=>{const r={...o,network:i};return e.getStrictReceivePaths(n,r)},[i,o,...a]);return t.useQuery({...l,enabled:d,queryKey:c,queryFn:v})},exports.useStrictSendPaths=function(n,o,l){var s;const i=u(null==o?void 0:o.network),d=null===(s=null==l?void 0:l.enabled)||void 0===s||s,a=[n[0],n[1],n[2],null==o?void 0:o.cursor,null==o?void 0:o.limit,null==o?void 0:o.network,null==o?void 0:o.order],c=r.useMemo(()=>["blux","strictSendPaths",i,...a],[i,o,...a]),v=r.useMemo(()=>async()=>{const r={...o,network:i};return e.getStrictSendPaths(n,r)},[i,o,...a]);return t.useQuery({...l,enabled:d,queryKey:c,queryFn:v})},exports.useSwap=function(n){const r=t.useMutation({...n,mutationFn:async n=>e.swap(n)});return Object.assign(r,{swap:r.mutate,swapAsync:r.mutateAsync})},exports.useSwitchNetwork=()=>({networks:e.networks,switchNetwork:e.switchNetwork}),exports.useTokenMetadata=function(n,o,l){var s;const i=u(null==o?void 0:o.network),d=(null===(s=null==l?void 0:l.enabled)||void 0===s||s)&&Boolean(n),a=[n,i],c=r.useMemo(()=>["blux","tokenMetadata",...a],[...a]),v=r.useMemo(()=>async()=>{const r={...o,network:i};return e.getTokenMetadata(n,r)},[...a]);return t.useQuery({...l,enabled:d,queryKey:c,queryFn:v})},exports.useTradeAggregation=function(n,o,l){var s;const i=u(null==o?void 0:o.network),d=null===(s=null==l?void 0:l.enabled)||void 0===s||s,a=[n[0],n[1],n[2],n[3],n[4],n[5],null==o?void 0:o.cursor,null==o?void 0:o.limit,null==o?void 0:o.network,null==o?void 0:o.order],c=r.useMemo(()=>["blux","tradeAggregation",i,...a],[i,o,...a]),v=r.useMemo(()=>async()=>{const r={...o,network:i};return e.getTradeAggregation(n,r)},[i,o,...a]);return t.useQuery({...l,enabled:d,queryKey:c,queryFn:v})},exports.useTrades=function(n,o){var l;const s=u(null==n?void 0:n.network),i=null===(l=null==o?void 0:o.enabled)||void 0===l||l,d=[null==n?void 0:n.forAssetPair,null==n?void 0:n.forOffer,null==n?void 0:n.forType,null==n?void 0:n.forLiquidityPool,null==n?void 0:n.forAccount,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],a=r.useMemo(()=>["blux","trades",s,...d],[s,...d]),c=r.useMemo(()=>async()=>{const r={...n,network:s};return e.getTrades(r)},[s,...d]);return t.useQuery({...o,enabled:i,queryKey:a,queryFn:c})},exports.useTransactions=function(n,o){var l;const s=u(null==n?void 0:n.network),i=null===(l=null==o?void 0:o.enabled)||void 0===l||l,d=[null==n?void 0:n.forAccount,null==n?void 0:n.includeFailed,null==n?void 0:n.forClaimableBalance,null==n?void 0:n.forLedger,null==n?void 0:n.forLiquidityPool,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],a=r.useMemo(()=>["blux","transactions",s,...d],[s,...d]),c=r.useMemo(()=>async()=>{const r={...n,network:s};return e.getTransactions(r)},[s,...d]);return t.useQuery({...o,enabled:i,queryKey:a,queryFn:c})},exports.useTransfer=function(n){const r=t.useMutation({...n,mutationFn:async n=>e.transfer(n)});return Object.assign(r,{transfer:r.mutate,transferAsync:r.mutateAsync})},exports.useWriteContract=function(n){return t.useMutation({...n,mutationFn:async({call:n,options:r})=>e.writeContract(n,r)})};

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-export { setAppearance } from '@bluxcc/core';
+export { getAccount, getAccounts, getAssets, getBalances, getClaimableBalances, getEffects, getLedgers, getLiquidityPools, getNetwork, getOffers, getOperations, getOrderbook, getPayments, getStrictReceivePaths, getStrictSendPaths, getTradeAggregation, getTrades, getTransactions, readContracts, writeContract, swap, getSacAddress, getTokenMetadata, networks, switchNetwork, numberish, ToScVal, setAppearance, events, BluxEvent, StellarSdk, getState, subscribe, getInitialState, useExportedStore, } from '@bluxcc/core';
+export type { Numberish, SwapOptions, SwapType, TokenMetadata, GetTokenMetadataOptions, } from '@bluxcc/core';
 export { Asset } from '@stellar/stellar-sdk';
 export * from './useStellar';
 export { useBlux } from './hooks/useBlux';

package/dist/index.esm.js

@@ -1 +1 @@
-import{getState as n,getAccount as l,getAccounts as o,getAssets as r,getBalances as e,getClaimableBalances as u,getEffects as i,getLedgers as d,getLiquidityPools as t,useExportedStore as v,getOffers as c,getOperations as a,getOrderbook as s,getPayments as y,readContracts as f,getStrictReceivePaths as b,getStrictSendPaths as k,getTradeAggregation as w,getTrades as q,getTransactions as m,switchNetwork as x,networks as F,writeContract as g,blux as p,createConfig as K,setAppearance as A}from"@bluxcc/core";export{networks,setAppearance}from"@bluxcc/core";export{Asset}from"@stellar/stellar-sdk";import L,{useMemo as P,useState as N,useEffect as h,useRef as B}from"react";import{useQuery as S,useMutation as C,QueryClient as O,QueryClientProvider as T}from"@tanstack/react-query";const E=l=>{const{user:o}=n();return l||(null==o?void 0:o.address)},J=l=>{const{stellar:o}=n();return!l&&o?o.activeNetwork:l};function R(n,o){var r;const e=E(null==n?void 0:n.address),u=J(null==n?void 0:n.network),i=null===(r=null==o?void 0:o.enabled)||void 0===r||r,d=[e,u],t=P(()=>["blux","account",u,...d],[u,...d]),v=P(()=>async()=>{const o={...n,address:e,network:u};return l(o)},[u,...d]);return S({...o,enabled:i,queryKey:t,queryFn:v})}function Z(n,l){var r;const e=J(null==n?void 0:n.network),u=null===(r=null==l?void 0:l.enabled)||void 0===r||r,i=[null==n?void 0:n.forSigner,null==n?void 0:n.forAsset,null==n?void 0:n.sponsor,null==n?void 0:n.forLiquidityPool,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],d=P(()=>["blux","accounts",e,...i],[e,...i]),t=P(()=>async()=>{const l={...n,network:e};return o(l)},[e,...i]);return S({...l,enabled:u,queryKey:d,queryFn:t})}function D(n,l){var o;const e=J(null==n?void 0:n.network),u=null===(o=null==l?void 0:l.enabled)||void 0===o||o,i=[null==n?void 0:n.forCode,null==n?void 0:n.forIssuer,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],d=P(()=>["blux","assets",e,...i],[e,n,...i]),t=P(()=>async()=>{const l={...n,network:e};return r(l)},[e,n,...i]);return S({...l,enabled:u,queryKey:d,queryFn:t})}function I(n,l){var o,r;const u=E(null==n?void 0:n.address),i=J(null==n?void 0:n.network),d=null===(o=null==l?void 0:l.enabled)||void 0===o||o,t=null===(r=null==n?void 0:n.includeZeroBalances)||void 0===r||r,v=[u,i,t],c=P(()=>["blux","balances",i,...v],[i,...v]),a=P(()=>async()=>{const l={...n,address:u,includeZeroBalances:t,network:i};return e(l)},[i,...v]);return S({...l,enabled:d,queryKey:c,queryFn:a})}function X(n,l){var o;const r=E(n.claimant),e=J(null==n?void 0:n.network),i=null===(o=null==l?void 0:l.enabled)||void 0===o||o,d=[r,null==n?void 0:n.asset,null==n?void 0:n.sponsor,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],t=P(()=>["blux","claimableBalances",e,...d],[e,...d]),v=P(()=>async()=>{const l={...n,claimant:r,network:e};return u(l)},[e,...d]);return S({...l,enabled:i,queryKey:t,queryFn:v})}function j(n,l){var o;const r=J(null==n?void 0:n.network),e=null===(o=null==l?void 0:l.enabled)||void 0===o||o,u=[null==n?void 0:n.forAccount,null==n?void 0:n.forLedger,null==n?void 0:n.forTransaction,null==n?void 0:n.forOperation,null==n?void 0:n.forLiquidityPool,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],d=P(()=>["blux","effects",r,...u],[r,...u]),t=P(()=>async()=>{const l={...n,network:r};return i(l)},[r,...u]);return S({...l,enabled:e,queryKey:d,queryFn:t})}function z(n,l){var o;const r=J(null==n?void 0:n.network),e=null===(o=null==l?void 0:l.enabled)||void 0===o||o,u=[null==n?void 0:n.ledger,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],i=P(()=>["blux","ledgers",r,...u],[r,n,...u]),t=P(()=>async()=>{const l={...n,network:r};return d(l)},[r,n,...u]);return S({...l,enabled:e,queryKey:i,queryFn:t})}function G(n,l){var o;const r=J(null==n?void 0:n.network),e=null===(o=null==l?void 0:l.enabled)||void 0===o||o,u=[null==n?void 0:n.forAccount,null==n?void 0:n.forAssets,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],i=P(()=>["blux","liquidityPools",r,...u],[r,...u]),d=P(()=>async()=>{const l={...n,network:r};return t(l)},[r,...u]);return S({...l,enabled:e,queryKey:i,queryFn:d})}const H=()=>{var n;const l=v(n=>n),[o,r]=N((null===(n=l.stellar)||void 0===n?void 0:n.activeNetwork)||l.config.defaultNetwork);return h(()=>{var n;r((null===(n=l.stellar)||void 0===n?void 0:n.activeNetwork)||l.config.defaultNetwork)},[l.stellar,l.config]),o};function M(n,l){var o;const r=J(null==n?void 0:n.network),e=null===(o=null==l?void 0:l.enabled)||void 0===o||o,u=[null==n?void 0:n.forAccount,null==n?void 0:n.buying,null==n?void 0:n.selling,null==n?void 0:n.sponsor,null==n?void 0:n.seller,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],i=P(()=>["blux","offers",r,...u],[r,...u]),d=P(()=>async()=>{const l={...n,network:r};return c(l)},[r,...u]);return S({...l,enabled:e,queryKey:i,queryFn:d})}function Q(n,l){var o;const r=J(null==n?void 0:n.network),e=null===(o=null==l?void 0:l.enabled)||void 0===o||o,u=[null==n?void 0:n.forAccount,null==n?void 0:n.includeFailed,null==n?void 0:n.forClaimableBalance,null==n?void 0:n.forLedger,null==n?void 0:n.forTransaction,null==n?void 0:n.forLiquidityPool,null==n?void 0:n.forAccount,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],i=P(()=>["blux","operations",r,...u],[r,...u]),d=P(()=>async()=>{const l={...n,network:r};return a(l)},[r,n,...u]);return S({...l,enabled:e,queryKey:i,queryFn:d})}function U(n,l,o){var r;const e=J(null==l?void 0:l.network),u=null===(r=null==o?void 0:o.enabled)||void 0===r||r,i=[n[0],n[1],null==l?void 0:l.cursor,null==l?void 0:l.limit,null==l?void 0:l.network,null==l?void 0:l.order],d=P(()=>["blux","orderbook",e,...i],[e,l,...i]),t=P(()=>async()=>{const o={...l,network:e};return s(n,o)},[e,l,...i]);return S({...o,enabled:u,queryKey:d,queryFn:t})}function V(n,l){var o;const r=J(null==n?void 0:n.network),e=null===(o=null==l?void 0:l.enabled)||void 0===o||o,u=[null==n?void 0:n.forAccount,null==n?void 0:n.includeFailed,null==n?void 0:n.forLedger,null==n?void 0:n.forTransaction,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],i=P(()=>["blux","payments",r,...u],[r,...u]),d=P(()=>async()=>{const l={...n,network:r};return y(l)},[r,...u]);return S({...l,enabled:e,queryKey:i,queryFn:d})}function W(n,l,o){var r;const e=J(null==l?void 0:l.network),u=null===(r=null==o?void 0:o.enabled)||void 0===r||r,i=P(()=>JSON.stringify((null!=n?n:[]).map(n=>{var l;return{address:null==n?void 0:n.address,fn:null==n?void 0:n.fn,args:(null!==(l=null==n?void 0:n.args)&&void 0!==l?l:[]).map(n=>n.toXDR("base64"))}})),[n]),d=[e,i],t=P(()=>["blux","readContracts",e,i],[...d]),v=P(()=>async()=>{const o={...l,network:e};return f(n,o)},[...d]);return S({...o,enabled:u,queryKey:t,queryFn:v})}function Y(n,l,o){var r;const e=J(null==l?void 0:l.network),u=null===(r=null==o?void 0:o.enabled)||void 0===r||r,i=[n[0],n[1],n[2],null==l?void 0:l.cursor,null==l?void 0:l.limit,null==l?void 0:l.network,null==l?void 0:l.order],d=P(()=>["blux","strictReceivePaths",e,...i],[e,l,...i]),t=P(()=>async()=>{const o={...l,network:e};return b(n,o)},[e,l,...i]);return S({...o,enabled:u,queryKey:d,queryFn:t})}function $(n,l,o){var r;const e=J(null==l?void 0:l.network),u=null===(r=null==o?void 0:o.enabled)||void 0===r||r,i=[n[0],n[1],n[2],null==l?void 0:l.cursor,null==l?void 0:l.limit,null==l?void 0:l.network,null==l?void 0:l.order],d=P(()=>["blux","strictSendPaths",e,...i],[e,l,...i]),t=P(()=>async()=>{const o={...l,network:e};return k(n,o)},[e,l,...i]);return S({...o,enabled:u,queryKey:d,queryFn:t})}function _(n,l,o){var r;const e=J(null==l?void 0:l.network),u=null===(r=null==o?void 0:o.enabled)||void 0===r||r,i=[n[0],n[1],n[2],n[3],n[4],n[5],null==l?void 0:l.cursor,null==l?void 0:l.limit,null==l?void 0:l.network,null==l?void 0:l.order],d=P(()=>["blux","tradeAggregation",e,...i],[e,l,...i]),t=P(()=>async()=>{const o={...l,network:e};return w(n,o)},[e,l,...i]);return S({...o,enabled:u,queryKey:d,queryFn:t})}function nn(n,l){var o;const r=J(null==n?void 0:n.network),e=null===(o=null==l?void 0:l.enabled)||void 0===o||o,u=[null==n?void 0:n.forAssetPair,null==n?void 0:n.forOffer,null==n?void 0:n.forType,null==n?void 0:n.forLiquidityPool,null==n?void 0:n.forAccount,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],i=P(()=>["blux","trades",r,...u],[r,...u]),d=P(()=>async()=>{const l={...n,network:r};return q(l)},[r,...u]);return S({...l,enabled:e,queryKey:i,queryFn:d})}function ln(n,l){var o;const r=J(null==n?void 0:n.network),e=null===(o=null==l?void 0:l.enabled)||void 0===o||o,u=[null==n?void 0:n.forAccount,null==n?void 0:n.includeFailed,null==n?void 0:n.forClaimableBalance,null==n?void 0:n.forLedger,null==n?void 0:n.forLiquidityPool,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],i=P(()=>["blux","transactions",r,...u],[r,...u]),d=P(()=>async()=>{const l={...n,network:r};return m(l)},[r,...u]);return S({...l,enabled:e,queryKey:i,queryFn:d})}const on=()=>({networks:F,switchNetwork:x});function rn(n){return C({...n,mutationFn:async({call:n,options:l})=>g(n,l)})}const en=()=>{const[n,l]=N(p),o=v(n=>n.user),r=v(n=>n.authState);return h(()=>{l(p)},[o,r]),n},un=new O,dn=({config:n,children:l})=>{const o=B(null),{appearance:r,...e}=null!=n?n:{},u=P(()=>e,[JSON.stringify(e)]);return h(()=>{o.current&&K(n,o.current)},[o,u]),h(()=>{o.current&&A(null!=r?r:{})},[o,r]),L.createElement(T,{client:un},L.createElement("div",{ref:o},l))};export{dn as BluxProvider,R as useAccount,Z as useAccounts,D as useAssets,I as useBalances,en as useBlux,X as useClaimableBalances,j as useEffects,z as useLedgers,G as useLiquidityPools,H as useNetwork,M as useOffers,Q as useOperations,U as useOrderbook,V as usePayments,W as useReadContracts,Y as useStrictReceivePaths,$ as useStrictSendPaths,on as useSwitchNetwork,_ as useTradeAggregation,nn as useTrades,ln as useTransactions,rn as useWriteContract};
+import{getState as n,getAccount as l,getAccounts as o,getAssets as e,getBalances as r,getClaimableBalances as u,getEffects as t,getLedgers as i,getLiquidityPools as d,useExportedStore as a,getOffers as s,getOperations as c,getOrderbook as v,getPayments as y,readContracts as f,getStrictReceivePaths as b,getStrictSendPaths as k,getTradeAggregation as w,getTrades as g,getTransactions as q,transfer as m,switchNetwork as x,networks as p,writeContract as F,swap as A,getTokenMetadata as K,getSacAddress as S,blux as P,createConfig as L,setAppearance as h}from"@bluxcc/core";export{BluxEvent,StellarSdk,ToScVal,events,getAccount,getAccounts,getAssets,getBalances,getClaimableBalances,getEffects,getInitialState,getLedgers,getLiquidityPools,getNetwork,getOffers,getOperations,getOrderbook,getPayments,getSacAddress,getState,getStrictReceivePaths,getStrictSendPaths,getTokenMetadata,getTradeAggregation,getTrades,getTransactions,networks,numberish,readContracts,setAppearance,subscribe,swap,switchNetwork,useExportedStore,writeContract}from"@bluxcc/core";export{Asset}from"@stellar/stellar-sdk";import N,{useMemo as B,useState as O,useEffect as T,useRef as C}from"react";import{useQuery as E,useMutation as R,QueryClient as j,QueryClientProvider as I}from"@tanstack/react-query";const J=l=>{const{user:o}=n();return l||(null==o?void 0:o.address)},M=l=>{const{stellar:o}=n();return!l&&o?o.activeNetwork:l};function Z(n,o){var e;const r=J(null==n?void 0:n.address),u=M(null==n?void 0:n.network),t=null===(e=null==o?void 0:o.enabled)||void 0===e||e,i=[r,u],d=B(()=>["blux","account",u,...i],[u,...i]),a=B(()=>async()=>{const o={...n,address:r,network:u};return l(o)},[u,...i]);return E({...o,enabled:t,queryKey:d,queryFn:a})}function D(n,l){var e;const r=M(null==n?void 0:n.network),u=null===(e=null==l?void 0:l.enabled)||void 0===e||e,t=[null==n?void 0:n.forSigner,null==n?void 0:n.forAsset,null==n?void 0:n.sponsor,null==n?void 0:n.forLiquidityPool,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],i=B(()=>["blux","accounts",r,...t],[r,...t]),d=B(()=>async()=>{const l={...n,network:r};return o(l)},[r,...t]);return E({...l,enabled:u,queryKey:i,queryFn:d})}function V(n,l){var o;const r=M(null==n?void 0:n.network),u=null===(o=null==l?void 0:l.enabled)||void 0===o||o,t=[null==n?void 0:n.forCode,null==n?void 0:n.forIssuer,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],i=B(()=>["blux","assets",r,...t],[r,n,...t]),d=B(()=>async()=>{const l={...n,network:r};return e(l)},[r,n,...t]);return E({...l,enabled:u,queryKey:i,queryFn:d})}function X(n,l){var o,e;const u=J(null==n?void 0:n.address),t=M(null==n?void 0:n.network),i=null===(o=null==l?void 0:l.enabled)||void 0===o||o,d=null===(e=null==n?void 0:n.includeZeroBalances)||void 0===e||e,a=[u,t,d],s=B(()=>["blux","balances",t,...a],[t,...a]),c=B(()=>async()=>{const l={...n,address:u,includeZeroBalances:d,network:t};return r(l)},[t,...a]);return E({...l,enabled:i,queryKey:s,queryFn:c})}function z(n,l){var o;const e=J(n.claimant),r=M(null==n?void 0:n.network),t=null===(o=null==l?void 0:l.enabled)||void 0===o||o,i=[e,null==n?void 0:n.asset,null==n?void 0:n.sponsor,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],d=B(()=>["blux","claimableBalances",r,...i],[r,...i]),a=B(()=>async()=>{const l={...n,claimant:e,network:r};return u(l)},[r,...i]);return E({...l,enabled:t,queryKey:d,queryFn:a})}function G(n,l){var o;const e=M(null==n?void 0:n.network),r=null===(o=null==l?void 0:l.enabled)||void 0===o||o,u=[null==n?void 0:n.forAccount,null==n?void 0:n.forLedger,null==n?void 0:n.forTransaction,null==n?void 0:n.forOperation,null==n?void 0:n.forLiquidityPool,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],i=B(()=>["blux","effects",e,...u],[e,...u]),d=B(()=>async()=>{const l={...n,network:e};return t(l)},[e,...u]);return E({...l,enabled:r,queryKey:i,queryFn:d})}function H(n,l){var o;const e=M(null==n?void 0:n.network),r=null===(o=null==l?void 0:l.enabled)||void 0===o||o,u=[null==n?void 0:n.ledger,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],t=B(()=>["blux","ledgers",e,...u],[e,n,...u]),d=B(()=>async()=>{const l={...n,network:e};return i(l)},[e,n,...u]);return E({...l,enabled:r,queryKey:t,queryFn:d})}function Q(n,l){var o;const e=M(null==n?void 0:n.network),r=null===(o=null==l?void 0:l.enabled)||void 0===o||o,u=[null==n?void 0:n.forAccount,null==n?void 0:n.forAssets,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],t=B(()=>["blux","liquidityPools",e,...u],[e,...u]),i=B(()=>async()=>{const l={...n,network:e};return d(l)},[e,...u]);return E({...l,enabled:r,queryKey:t,queryFn:i})}const U=()=>{var n;const l=a(n=>n),[o,e]=O((null===(n=l.stellar)||void 0===n?void 0:n.activeNetwork)||l.config.defaultNetwork);return T(()=>{var n;e((null===(n=l.stellar)||void 0===n?void 0:n.activeNetwork)||l.config.defaultNetwork)},[l.stellar,l.config]),o};function W(n,l){var o;const e=M(null==n?void 0:n.network),r=null===(o=null==l?void 0:l.enabled)||void 0===o||o,u=[null==n?void 0:n.forAccount,null==n?void 0:n.buying,null==n?void 0:n.selling,null==n?void 0:n.sponsor,null==n?void 0:n.seller,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],t=B(()=>["blux","offers",e,...u],[e,...u]),i=B(()=>async()=>{const l={...n,network:e};return s(l)},[e,...u]);return E({...l,enabled:r,queryKey:t,queryFn:i})}function Y(n,l){var o;const e=M(null==n?void 0:n.network),r=null===(o=null==l?void 0:l.enabled)||void 0===o||o,u=[null==n?void 0:n.forAccount,null==n?void 0:n.includeFailed,null==n?void 0:n.forClaimableBalance,null==n?void 0:n.forLedger,null==n?void 0:n.forTransaction,null==n?void 0:n.forLiquidityPool,null==n?void 0:n.forAccount,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],t=B(()=>["blux","operations",e,...u],[e,...u]),i=B(()=>async()=>{const l={...n,network:e};return c(l)},[e,n,...u]);return E({...l,enabled:r,queryKey:t,queryFn:i})}function $(n,l,o){var e;const r=M(null==l?void 0:l.network),u=null===(e=null==o?void 0:o.enabled)||void 0===e||e,t=[n[0],n[1],null==l?void 0:l.cursor,null==l?void 0:l.limit,null==l?void 0:l.network,null==l?void 0:l.order],i=B(()=>["blux","orderbook",r,...t],[r,l,...t]),d=B(()=>async()=>{const o={...l,network:r};return v(n,o)},[r,l,...t]);return E({...o,enabled:u,queryKey:i,queryFn:d})}function _(n,l){var o;const e=M(null==n?void 0:n.network),r=null===(o=null==l?void 0:l.enabled)||void 0===o||o,u=[null==n?void 0:n.forAccount,null==n?void 0:n.includeFailed,null==n?void 0:n.forLedger,null==n?void 0:n.forTransaction,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],t=B(()=>["blux","payments",e,...u],[e,...u]),i=B(()=>async()=>{const l={...n,network:e};return y(l)},[e,...u]);return E({...l,enabled:r,queryKey:t,queryFn:i})}function nn(n,l,o){var e;const r=M(null==l?void 0:l.network),u=null===(e=null==o?void 0:o.enabled)||void 0===e||e,t=B(()=>JSON.stringify((null!=n?n:[]).map(n=>{var l;return{address:null==n?void 0:n.address,fn:null==n?void 0:n.fn,args:(null!==(l=null==n?void 0:n.args)&&void 0!==l?l:[]).map(n=>n.toXDR("base64"))}})),[n]),i=[r,t],d=B(()=>["blux","readContracts",r,t],[...i]),a=B(()=>async()=>{const o={...l,network:r};return f(n,o)},[...i]);return E({...o,enabled:u,queryKey:d,queryFn:a})}function ln(n,l,o){var e;const r=M(null==l?void 0:l.network),u=null===(e=null==o?void 0:o.enabled)||void 0===e||e,t=[n[0],n[1],n[2],null==l?void 0:l.cursor,null==l?void 0:l.limit,null==l?void 0:l.network,null==l?void 0:l.order],i=B(()=>["blux","strictReceivePaths",r,...t],[r,l,...t]),d=B(()=>async()=>{const o={...l,network:r};return b(n,o)},[r,l,...t]);return E({...o,enabled:u,queryKey:i,queryFn:d})}function on(n,l,o){var e;const r=M(null==l?void 0:l.network),u=null===(e=null==o?void 0:o.enabled)||void 0===e||e,t=[n[0],n[1],n[2],null==l?void 0:l.cursor,null==l?void 0:l.limit,null==l?void 0:l.network,null==l?void 0:l.order],i=B(()=>["blux","strictSendPaths",r,...t],[r,l,...t]),d=B(()=>async()=>{const o={...l,network:r};return k(n,o)},[r,l,...t]);return E({...o,enabled:u,queryKey:i,queryFn:d})}function en(n,l,o){var e;const r=M(null==l?void 0:l.network),u=null===(e=null==o?void 0:o.enabled)||void 0===e||e,t=[n[0],n[1],n[2],n[3],n[4],n[5],null==l?void 0:l.cursor,null==l?void 0:l.limit,null==l?void 0:l.network,null==l?void 0:l.order],i=B(()=>["blux","tradeAggregation",r,...t],[r,l,...t]),d=B(()=>async()=>{const o={...l,network:r};return w(n,o)},[r,l,...t]);return E({...o,enabled:u,queryKey:i,queryFn:d})}function rn(n,l){var o;const e=M(null==n?void 0:n.network),r=null===(o=null==l?void 0:l.enabled)||void 0===o||o,u=[null==n?void 0:n.forAssetPair,null==n?void 0:n.forOffer,null==n?void 0:n.forType,null==n?void 0:n.forLiquidityPool,null==n?void 0:n.forAccount,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],t=B(()=>["blux","trades",e,...u],[e,...u]),i=B(()=>async()=>{const l={...n,network:e};return g(l)},[e,...u]);return E({...l,enabled:r,queryKey:t,queryFn:i})}function un(n,l){var o;const e=M(null==n?void 0:n.network),r=null===(o=null==l?void 0:l.enabled)||void 0===o||o,u=[null==n?void 0:n.forAccount,null==n?void 0:n.includeFailed,null==n?void 0:n.forClaimableBalance,null==n?void 0:n.forLedger,null==n?void 0:n.forLiquidityPool,null==n?void 0:n.cursor,null==n?void 0:n.limit,null==n?void 0:n.network,null==n?void 0:n.order],t=B(()=>["blux","transactions",e,...u],[e,...u]),i=B(()=>async()=>{const l={...n,network:e};return q(l)},[e,...u]);return E({...l,enabled:r,queryKey:t,queryFn:i})}function tn(n){const l=R({...n,mutationFn:async n=>m(n)});return Object.assign(l,{transfer:l.mutate,transferAsync:l.mutateAsync})}const dn=()=>({networks:p,switchNetwork:x});function an(n){return R({...n,mutationFn:async({call:n,options:l})=>F(n,l)})}function sn(n){const l=R({...n,mutationFn:async n=>A(n)});return Object.assign(l,{swap:l.mutate,swapAsync:l.mutateAsync})}function cn(n,l,o){var e;const r=M(null==l?void 0:l.network),u=(null===(e=null==o?void 0:o.enabled)||void 0===e||e)&&Boolean(n),t=[n,r],i=B(()=>["blux","tokenMetadata",...t],[...t]),d=B(()=>async()=>{const o={...l,network:r};return K(n,o)},[...t]);return E({...o,enabled:u,queryKey:i,queryFn:d})}function vn(n,l){const o=M(l);return B(()=>{try{return{data:S(n,o),error:null}}catch(n){return{data:void 0,error:n}}},[n,o])}const yn=()=>{const[n,l]=O(P),o=a(n=>n.user),e=a(n=>n.authState);return T(()=>{l(P)},[o,e]),n},fn=new j,bn=({config:n,children:l})=>{const o=C(null),{appearance:e,...r}=null!=n?n:{},u=B(()=>r,[JSON.stringify(r)]);return T(()=>{o.current&&L(n,o.current)},[o,u]),T(()=>{o.current&&h(null!=e?e:{})},[o,e]),N.createElement(I,{client:fn},N.createElement("div",{ref:o},l))};export{bn as BluxProvider,Z as useAccount,D as useAccounts,V as useAssets,X as useBalances,yn as useBlux,z as useClaimableBalances,G as useEffects,H as useLedgers,Q as useLiquidityPools,U as useNetwork,W as useOffers,Y as useOperations,$ as useOrderbook,_ as usePayments,nn as useReadContracts,vn as useSacAddress,ln as useStrictReceivePaths,on as useStrictSendPaths,sn as useSwap,dn as useSwitchNetwork,cn as useTokenMetadata,en as useTradeAggregation,rn as useTrades,un as useTransactions,tn as useTransfer,an as useWriteContract};

package/dist/useStellar/index.d.ts

@@ -18,5 +18,9 @@ export * from './useStrictSendPaths';
 export * from './useTradeAggregation';
 export * from './useTrades';
 export * from './useTransactions';
+export * from './useTransfer';
 export * from './useSwitchNetwork';
 export * from './useWriteContract';
+export * from './useSwap';
+export * from './useTokenMetadata';
+export * from './useSacAddress';

package/dist/useStellar/useAccount.d.ts

@@ -3,5 +3,30 @@ import type { GetAccountResult, GetAccountOptions } from '@bluxcc/core/dist/expo
 import type { QueryOptions } from '../utils';
 type R = GetAccountResult;
 type O = GetAccountOptions;
+/**
+ * Fetches a single account's on-chain state from Horizon.
+ *
+ * Wraps the core `getAccount` call in a TanStack Query. When `address` is
+ * omitted it falls back to the connected wallet's address, so it doubles as a
+ * "current account" hook. Resolves to `null` when the account does not exist on
+ * the target network (e.g. it has never been funded).
+ *
+ * @param options - `address` (the `G…` account to load; defaults to the
+ *   connected wallet) and `network` (defaults to the active network).
+ * @param queryOptions - Optional TanStack Query options (`enabled`, `staleTime`,
+ *   `refetchInterval`, `select`, …). `queryKey`/`queryFn` are managed by the hook.
+ * @returns A TanStack Query result; `data` is the Horizon `AccountResponse`, or
+ *   `null` if the account is not found.
+ *
+ * @example
+ * ```tsx
+ * // Connected wallet's account
+ * const { data: account, isLoading } = useAccount();
+ *
+ * // A specific account
+ * const { data } = useAccount({ address: 'GA…' });
+ * console.log(data?.sequence, data?.balances);
+ * ```
+ */
 export declare function useAccount(options?: O, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
 export {};

package/dist/useStellar/useAccounts.d.ts

@@ -3,5 +3,28 @@ import type { GetAccountsResult, GetAccountsOptions } from '@bluxcc/core/dist/ex
 import type { QueryOptions } from '../utils';
 type R = GetAccountsResult;
 type O = GetAccountsOptions;
+/**
+ * Fetches a paginated list of accounts that match a filter from Horizon.
+ *
+ * Exactly one filter is required: `forSigner` (accounts a key can sign for),
+ * `forAsset` (accounts that hold a trustline to an asset), `sponsor` (accounts
+ * sponsored by an address), or `forLiquidityPool` (accounts holding pool
+ * shares). Standard pagination (`cursor`, `limit`, `order`) applies.
+ *
+ * @param options - One of the required filters above, plus optional
+ *   `cursor` / `limit` / `order` and `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 `{ builder, response }`, where
+ *   `response` is the Horizon collection page (`response.records`, plus
+ *   `response.next()` / `response.prev()` for pagination) and `builder` is the
+ *   underlying call builder for advanced queries or streaming.
+ *
+ * @example
+ * ```tsx
+ * const { data } = useAccounts({ forSigner: 'GA…', limit: 20 });
+ * data?.response.records.forEach((a) => console.log(a.account_id));
+ * ```
+ */
 export declare function useAccounts(options?: O, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
 export {};

package/dist/useStellar/useAssets.d.ts

@@ -3,5 +3,23 @@ import type { GetAssetsResult, GetAssetsOptions } from "@bluxcc/core/dist/export
 import type { QueryOptions } from '../utils';
 type R = GetAssetsResult;
 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.
+ *
+ * @param options - `forCode` / `forIssuer` filters, plus optional
+ *   `cursor` / `limit` / `order` and `network` (defaults to the active network).
+ * @param queryOptions - Optional TanStack Query options. `queryKey`/`queryFn`
+ *   are managed by the hook.
+ * @returns A TanStack Query result. `data` is `{ builder, response }`;
+ *   `response.records` holds the asset records (supply, flags, issuer, …).
+ *
+ * @example
+ * ```tsx
+ * const { data } = useAssets({ forCode: 'USDC' });
+ * ```
+ */
 export declare function useAssets(options?: O, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
 export {};

package/dist/useStellar/useBalances.d.ts

@@ -3,5 +3,26 @@ import type { GetBalancesResult, GetBalancesOptions } from "@bluxcc/core/dist/ex
 import type { QueryOptions } from '../utils';
 type R = GetBalancesResult;
 type O = GetBalancesOptions;
+/**
+ * Fetches an account's asset balances from Horizon.
+ *
+ * When `address` is omitted it uses the connected wallet. By default zero
+ * balances (e.g. empty trustlines) are included; set `includeZeroBalances` to
+ * `false` to drop them. Pairs well with `useTransfer`'s `onSuccess` to refetch
+ * balances after a payment.
+ *
+ * @param options - `address` (defaults to the connected wallet),
+ *   `includeZeroBalances` (default `true`), and `network` (defaults to active).
+ * @param queryOptions - Optional TanStack Query options. `queryKey`/`queryFn`
+ *   are managed by the hook.
+ * @returns A TanStack Query result; `data` is an array of Horizon balance lines
+ *   (the native balance plus each trustline).
+ *
+ * @example
+ * ```tsx
+ * const { data: balances } = useBalances();
+ * const xlm = balances?.find((b) => b.asset_type === 'native');
+ * ```
+ */
 export declare function useBalances(options?: O, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
 export {};

package/dist/useStellar/useClaimableBalances.d.ts

@@ -3,5 +3,25 @@ import type { GetClaimableBalancesResult, GetClaimableBalancesOptions } from "@b
 import type { QueryOptions } from '../utils';
 type R = GetClaimableBalancesResult;
 type O = GetClaimableBalancesOptions;
+/**
+ * Fetches claimable balances addressed to a claimant from Horizon.
+ *
+ * `claimant` defaults to the connected wallet, so by default it lists balances
+ * the current user can claim. `asset` is required; `sponsor` optionally filters
+ * by who reserved the balance.
+ *
+ * @param options - Required: `asset` (the `Asset` to filter by) and `claimant`
+ *   (defaults to the connected wallet). Optional: `sponsor`,
+ *   `cursor` / `limit` / `order`, and `network` (defaults to active).
+ * @param queryOptions - Optional TanStack Query options. `queryKey`/`queryFn`
+ *   are managed by the hook.
+ * @returns A TanStack Query result. `data` is `{ builder, response }`;
+ *   `response.records` holds the claimable balance records.
+ *
+ * @example
+ * ```tsx
+ * const { data } = useClaimableBalances({ asset: Asset.native() });
+ * ```
+ */
 export declare function useClaimableBalances(options: O, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
 export {};

package/dist/useStellar/useEffects.d.ts

@@ -3,5 +3,26 @@ import type { GetEffectsResult, GetEffectsOptions } from "@bluxcc/core/dist/expo
 import type { QueryOptions } from '../utils';
 type R = GetEffectsResult;
 type O = GetEffectsOptions;
+/**
+ * Fetches a paginated list of effects (the granular results of operations) from
+ * Horizon.
+ *
+ * Effects describe concrete ledger changes — account credited, trustline
+ * created, trade executed, and so on. Filter by `forAccount`, `forLedger`,
+ * `forTransaction`, `forOperation`, or `forLiquidityPool`; with no filter the
+ * full effects feed is returned.
+ *
+ * @param options - One of the `for…` filters, plus optional
+ *   `cursor` / `limit` / `order` and `network` (defaults to active).
+ * @param queryOptions - Optional TanStack Query options. `queryKey`/`queryFn`
+ *   are managed by the hook.
+ * @returns A TanStack Query result. `data` is `{ builder, response }`;
+ *   `response.records` holds the effect records.
+ *
+ * @example
+ * ```tsx
+ * const { data } = useEffects({ forAccount: 'GA…', limit: 50 });
+ * ```
+ */
 export declare function useEffects(options?: O, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
 export {};

package/dist/useStellar/useLedgers.d.ts

@@ -3,5 +3,23 @@ import type { GetLedgersResult, GetLedgersOptions } from "@bluxcc/core/dist/expo
 import type { QueryOptions } from '../utils';
 type R = GetLedgersResult;
 type O = GetLedgersOptions;
+/**
+ * Fetches ledgers from Horizon — either the latest ledgers or a single one.
+ *
+ * Pass `ledger` (a sequence number) to load one specific ledger; omit it to page
+ * through the most recent ledgers.
+ *
+ * @param options - `ledger` (a sequence number for a single ledger), plus
+ *   optional `cursor` / `limit` / `order` and `network` (defaults to active).
+ * @param queryOptions - Optional TanStack Query options. `queryKey`/`queryFn`
+ *   are managed by the hook.
+ * @returns A TanStack Query result. `data` is `{ builder, response }`;
+ *   `response.records` holds the ledger records.
+ *
+ * @example
+ * ```tsx
+ * const { data } = useLedgers({ limit: 10, order: 'desc' });
+ * ```
+ */
 export declare function useLedgers(options?: O, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
 export {};

package/dist/useStellar/useLiquidityPools.d.ts

@@ -3,5 +3,26 @@ import type { GetLiquidityPoolsResult, GetLiquidityPoolsOptions } from "@bluxcc/
 import type { QueryOptions } from '../utils';
 type R = GetLiquidityPoolsResult;
 type O = GetLiquidityPoolsOptions;
+/**
+ * Fetches a paginated list of liquidity pools from Horizon.
+ *
+ * Optionally filter by `forAssets` (pools containing the given assets) or
+ * `forAccount` (pools an account holds shares in). With no filter it lists all
+ * pools.
+ *
+ * @param options - `forAssets` / `forAccount` filters, plus optional
+ *   `cursor` / `limit` / `order` and `network` (defaults to active).
+ * @param queryOptions - Optional TanStack Query options. `queryKey`/`queryFn`
+ *   are managed by the hook.
+ * @returns A TanStack Query result. `data` is `{ builder, response }`;
+ *   `response.records` holds the liquidity pool records (reserves, shares, …).
+ *
+ * @example
+ * ```tsx
+ * const { data } = useLiquidityPools({
+ *   forAssets: [Asset.native(), new Asset('USDC', 'GA…')],
+ * });
+ * ```
+ */
 export declare function useLiquidityPools(options?: O, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
 export {};

package/dist/useStellar/useNetwork.d.ts

@@ -1 +1,17 @@
+/**
+ * Returns the currently active Stellar network and re-renders when it changes.
+ *
+ * Reads the active network from the Blux store (falling back to the configured
+ * `defaultNetwork`), so components stay in sync after
+ * `useSwitchNetwork().switchNetwork(...)`.
+ *
+ * @returns The active network passphrase — the value the other hooks accept as
+ *   their `network` option (one of `networks.mainnet` / `testnet` / …).
+ *
+ * @example
+ * ```tsx
+ * const network = useNetwork();
+ * return <span>Connected to {network}</span>;
+ * ```
+ */
 export declare const useNetwork: () => string;

package/dist/useStellar/useOffers.d.ts

@@ -3,5 +3,24 @@ import type { GetOffersResult, GetOffersOptions } from "@bluxcc/core/dist/export
 import type { QueryOptions } from '../utils';
 type R = GetOffersResult;
 type O = GetOffersOptions;
+/**
+ * Fetches a paginated list of open DEX offers from Horizon.
+ *
+ * Filter by `forAccount` / `seller` (offers created by an account),
+ * `buying` / `selling` (offers on a given asset side), or `sponsor`.
+ *
+ * @param options - `forAccount` / `seller` / `buying` / `selling` / `sponsor`
+ *   filters, plus optional `cursor` / `limit` / `order` and `network` (defaults
+ *   to active).
+ * @param queryOptions - Optional TanStack Query options. `queryKey`/`queryFn`
+ *   are managed by the hook.
+ * @returns A TanStack Query result. `data` is `{ builder, response }`;
+ *   `response.records` holds the offer records (price, amount, assets).
+ *
+ * @example
+ * ```tsx
+ * const { data } = useOffers({ seller: 'GA…' });
+ * ```
+ */
 export declare function useOffers(options?: O, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
 export {};

package/dist/useStellar/useOperations.d.ts

@@ -3,5 +3,25 @@ import type { GetOperationsResult, GetOperationsOptions } from "@bluxcc/core/dis
 import type { QueryOptions } from '../utils';
 type R = GetOperationsResult;
 type O = GetOperationsOptions;
+/**
+ * Fetches a paginated list of operations from Horizon.
+ *
+ * Operations are the individual actions inside transactions (payments, trades,
+ * trustline changes, contract invocations, …). Filter by `forAccount`,
+ * `forTransaction`, `forLedger`, `forClaimableBalance`, or `forLiquidityPool`;
+ * set `includeFailed` to also include operations from failed transactions.
+ *
+ * @param options - The `for…` filters and `includeFailed`, plus optional
+ *   `cursor` / `limit` / `order` and `network` (defaults to active).
+ * @param queryOptions - Optional TanStack Query options. `queryKey`/`queryFn`
+ *   are managed by the hook.
+ * @returns A TanStack Query result. `data` is `{ builder, response }`;
+ *   `response.records` holds the operation records.
+ *
+ * @example
+ * ```tsx
+ * const { data } = useOperations({ forAccount: 'GA…', includeFailed: false });
+ * ```
+ */
 export declare function useOperations(options?: O, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
 export {};

package/dist/useStellar/useOrderbook.d.ts

@@ -5,5 +5,24 @@ import { CallBuilderOptions } from '../utils';
 import type { QueryOptions } from '../utils';
 type R = GetOrderbookResult;
 type O = CallBuilderOptions;
+/**
+ * Fetches the current DEX order book for a `selling`/`buying` asset pair from
+ * Horizon.
+ *
+ * @param args - `[selling, buying]` — the two `Asset`s whose order book to load
+ *   (e.g. `[Asset.native(), usdc]`).
+ * @param options - Optional `cursor` / `limit` / `order` and `network`
+ *   (defaults to active).
+ * @param queryOptions - Optional TanStack Query options. `queryKey`/`queryFn`
+ *   are managed by the hook.
+ * @returns A TanStack Query result. `data` is `{ builder, response }`, where
+ *   `response` holds the `bids` and `asks` arrays.
+ *
+ * @example
+ * ```tsx
+ * const { data } = useOrderbook([Asset.native(), new Asset('USDC', 'GA…')]);
+ * 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 {};

package/dist/useStellar/usePayments.d.ts

@@ -1,12 +1,32 @@
 import { UseQueryResult } from '@tanstack/react-query';
-import type { GetPaymentsOptions } from "@bluxcc/core/dist/exports/core/getPayments";
-import { PaymentCallBuilder } from '@stellar/stellar-sdk/lib/horizon/payment_call_builder';
-import { ServerApi } from '@stellar/stellar-sdk/lib/horizon';
+import type { GetPaymentsOptions } from '@bluxcc/core/dist/exports/core/getPayments';
+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';
 type R = {
     builder: PaymentCallBuilder;
     response: ServerApi.CollectionPage<ServerApi.CreateAccountOperationRecord | ServerApi.PaymentOperationRecord | ServerApi.PathPaymentOperationRecord | ServerApi.AccountMergeOperationRecord | ServerApi.PathPaymentStrictSendOperationRecord | ServerApi.InvokeHostFunctionOperationRecord>;
 };
 type O = GetPaymentsOptions;
+/**
+ * Fetches a paginated list of payment operations from Horizon.
+ *
+ * Like `useOperations`, but narrowed to payment-type records (payments,
+ * create-account, path payments, account merges). Filter by `forAccount`,
+ * `forTransaction`, or `forLedger`; set `includeFailed` to include failures.
+ *
+ * @param options - `forAccount` / `forTransaction` / `forLedger` and
+ *   `includeFailed`, plus optional `cursor` / `limit` / `order` and `network`
+ *   (defaults to active).
+ * @param queryOptions - Optional TanStack Query options. `queryKey`/`queryFn`
+ *   are managed by the hook.
+ * @returns A TanStack Query result. `data` is `{ builder, response }`;
+ *   `response.records` holds the payment-related records.
+ *
+ * @example
+ * ```tsx
+ * const { data } = usePayments({ forAccount: 'GA…' });
+ * ```
+ */
 export declare function usePayments(options?: O, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
 export {};

package/dist/useStellar/useReadContracts.d.ts

@@ -4,5 +4,29 @@ import type { IContractCall, ReadContractsOptions } from '@bluxcc/core/dist/expo
 import type { QueryOptions } from '../utils';
 type R = Awaited<ReturnType<typeof readContracts>>;
 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.
+ *
+ * @param calls - The contract calls to simulate, each `{ 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 `{ raws, values }` — `values` are
+ *   the decoded return values, index-aligned with `calls`.
+ *
+ * @example
+ * ```tsx
+ * const { data } = useReadContracts([
+ *   { address: 'C…', fn: 'balance', args: [ToScVal.address('GA…')] },
+ * ]);
+ * const balance = data?.values[0];
+ * ```
+ */
 export declare function useReadContracts(calls: IContractCall[], options?: O, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
 export {};

package/dist/useStellar/useSacAddress.d.ts

@@ -0,0 +1,45 @@
+import type { AssetArg } from '@bluxcc/core/dist/exports/core/helpers';
+/**
+ * Result of {@link useSacAddress}. Because the underlying derivation is
+ * synchronous and local, there is no loading state — `data` is populated
+ * immediately, or `error` is set when the asset/network is invalid.
+ */
+export type UseSacAddressResult = {
+    /** The Stellar Asset 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;
+};
+/**
+ * Computes the Stellar Asset Contract (SAC) id of a classic asset, memoized.
+ *
+ * Every classic asset — native XLM or a `CODE:ISSUER` pair — has a deterministic
+ * Soroban contract id derived from the asset plus the network passphrase. The id
+ * is computed locally with no network call (and regardless of whether the SAC is
+ * 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`.
+ *
+ * Errors are captured rather than thrown during render: an invalid asset or a
+ * missing network passphrase surfaces as `{ data: undefined, error }`.
+ *
+ * @param asset - The asset: `'xlm'` / `'native'`, a `CODE:ISSUER` string, or an
+ *   `Asset`. Pass a stable value (a string, or a memoized `Asset`) to avoid
+ *   recomputing every render.
+ * @param network - Network passphrase to derive against. Defaults to the active
+ *   network.
+ * @returns `{ data, error }` — see {@link UseSacAddressResult}.
+ *
+ * @example
+ * ```tsx
+ * const { data: sac, error } = useSacAddress('USDC:GA…');
+ * // sac → 'C…'
+ *
+ * // Chain into a metadata read once the SAC is known.
+ * const { data: meta } = useTokenMetadata(sac ?? '', undefined, {
+ *   enabled: Boolean(sac),
+ * });
+ * ```
+ */
+export declare function useSacAddress(asset: AssetArg, network?: string): UseSacAddressResult;

package/dist/useStellar/useStrictReceivePaths.d.ts

@@ -5,6 +5,30 @@ import { CallBuilderOptions } from '../utils';
 import type { QueryOptions } from '../utils';
 type R = GetPaymentPathResult;
 type O = CallBuilderOptions;
+/**
+ * Finds payment paths for a fixed destination amount (strict-receive) via
+ * Horizon.
+ *
+ * Use this when you know exactly how much the recipient should receive and want
+ * to discover which source assets/paths can deliver it (and what they would
+ * cost). For the inverse — fixing what the sender spends — use
+ * `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.
+ * @param options - Optional `cursor` / `limit` / `order` and `network`
+ *   (defaults to active).
+ * @param queryOptions - Optional TanStack Query options. `queryKey`/`queryFn`
+ *   are managed by the hook.
+ * @returns A TanStack Query result. `data` is `{ builder, response }`;
+ *   `response.records` holds each candidate path with its source amount.
+ *
+ * @example
+ * ```tsx
+ * const { data } = useStrictReceivePaths(['GA…', new Asset('USDC', 'GA…'), '100']);
+ * ```
+ */
 export declare function useStrictReceivePaths(args: [
     source: string | Asset[],
     destinationAsset: Asset,

package/dist/useStellar/useStrictSendPaths.d.ts

@@ -5,6 +5,28 @@ import { CallBuilderOptions } from '../utils';
 import type { QueryOptions } from '../utils';
 type R = GetPaymentPathResult;
 type O = CallBuilderOptions;
+/**
+ * Finds payment paths for a fixed source amount (strict-send) via Horizon.
+ *
+ * Use this when you know exactly how much the sender will spend and want to
+ * discover the paths and how much the destination would receive. For the
+ * 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).
+ * @param options - Optional `cursor` / `limit` / `order` and `network`
+ *   (defaults to active).
+ * @param queryOptions - Optional TanStack Query options. `queryKey`/`queryFn`
+ *   are managed by the hook.
+ * @returns A TanStack Query result. `data` is `{ builder, response }`;
+ *   `response.records` holds each candidate path with its destination amount.
+ *
+ * @example
+ * ```tsx
+ * const { data } = useStrictSendPaths([Asset.native(), '50', 'GA…']);
+ * ```
+ */
 export declare function useStrictSendPaths(args: [
     sourceAsset: Asset,
     sourceAmount: string,

package/dist/useStellar/useSwap.d.ts

@@ -0,0 +1,67 @@
+import { swap } from '@bluxcc/core';
+import { UseMutationResult } from '@tanstack/react-query';
+import type { SwapOptions } from '@bluxcc/core/dist/exports/core/swap';
+import type { MutationOptions } from '../utils';
+type R = Awaited<ReturnType<typeof swap>>;
+/**
+ * Variables for {@link useSwap} — the core `swap` options verbatim, so every
+ * knob it supports (`type` exactIn/exactOut, `slippage`, `to`, `memo`,
+ * `network`) is just a field on the object passed to `swap({ ... })`.
+ */
+export type SwapVariables = SwapOptions;
+type V = SwapVariables;
+/**
+ * Return type of {@link useSwap}: the full TanStack mutation result plus
+ * wagmi-style aliases — `swap` (alias of `mutate`, fire-and-forget) and
+ * `swapAsync` (alias of `mutateAsync`, returns a promise).
+ */
+export type UseSwapResult = UseMutationResult<R, Error, V> & {
+    swap: UseMutationResult<R, Error, V>['mutate'];
+    swapAsync: UseMutationResult<R, Error, V>['mutateAsync'];
+};
+/**
+ * Swaps one asset for another through the Stellar DEX / liquidity pools by
+ * wrapping the core `swap` in a TanStack mutation.
+ *
+ * The core call discovers the best path payment automatically and applies a
+ * slippage guardrail, so callers just describe the trade. `type: 'exactIn'`
+ * (the default) sends a fixed `amount` of `fromAsset` and lets the received
+ * amount float; `type: 'exactOut'` receives a fixed `amount` of `toAsset` and
+ * lets the spent amount float. Defaults to a self-swap; pass `to` to deliver the
+ * bought asset elsewhere. When it is a self-swap into an asset the account has
+ * never held, the required `changeTrust` is added automatically. Requires a
+ * logged-in account.
+ *
+ * Named after wagmi's mutation hooks: fire `swap({ ... })` (fire-and-forget) or
+ * `await swapAsync({ ... })`.
+ *
+ * @param mutationOptions - Optional TanStack Mutation options (`onSuccess`,
+ *   `onError`, `onSettled`, …); a common use is invalidating `useBalances` on
+ *   success. `mutationFn` is provided by the hook.
+ * @returns The TanStack mutation result plus `swap` (alias of `mutate`) and
+ *   `swapAsync` (alias of `mutateAsync`); read `data` (the submitted
+ *   transaction), `isPending`, `isSuccess`, `error`, `reset`, etc. for state.
+ *
+ * @example
+ * ```tsx
+ * const { swap, swapAsync, isPending, error } = useSwap();
+ *
+ * // Sell exactly 100 XLM for USDC (exactIn is the default).
+ * swap({ fromAsset: 'xlm', toAsset: 'USDC:GA…', amount: '100' });
+ *
+ * // Receive exactly 50 USDC, spending up to a slippage-bounded amount of XLM.
+ * swap({ fromAsset: 'xlm', toAsset: 'USDC:GA…', amount: '50', type: 'exactOut' });
+ *
+ * // Deliver the bought asset to another account, with tighter slippage + a memo.
+ * const tx = await swapAsync({
+ *   fromAsset: 'USDC:GA…',
+ *   toAsset: 'xlm',
+ *   amount: '25',
+ *   to: 'GB…',
+ *   slippage: 0.01, // 1%
+ *   memo: 'cash out',
+ * });
+ * ```
+ */
+export declare function useSwap(mutationOptions?: MutationOptions<R, V>): UseSwapResult;
+export {};

package/dist/useStellar/useSwitchNetwork.d.ts

@@ -1,10 +1,27 @@
+/**
+ * Provides the list of configured networks and a setter to change the active
+ * one.
+ *
+ * Switching updates the Blux store; components that read the network via
+ * `useNetwork` (and network-scoped queries) update accordingly.
+ *
+ * @returns `{ networks, switchNetwork }` — `networks` is the map of available
+ *   networks (`mainnet` / `testnet` / `sandbox` / `futurenet` / `standalone`)
+ *   and `switchNetwork(network)` sets the active network.
+ *
+ * @example
+ * ```tsx
+ * const { networks, switchNetwork } = useSwitchNetwork();
+ * <button onClick={() => switchNetwork(networks.testnet)}>Use testnet</button>;
+ * ```
+ */
 export declare const useSwitchNetwork: () => {
     networks: {
-        mainnet: import("@stellar/stellar-base").Networks;
-        testnet: import("@stellar/stellar-base").Networks;
-        sandbox: import("@stellar/stellar-base").Networks;
-        futurenet: import("@stellar/stellar-base").Networks;
-        standalone: import("@stellar/stellar-base").Networks;
+        mainnet: import("@stellar/stellar-sdk").Networks;
+        testnet: import("@stellar/stellar-sdk").Networks;
+        sandbox: import("@stellar/stellar-sdk").Networks;
+        futurenet: import("@stellar/stellar-sdk").Networks;
+        standalone: import("@stellar/stellar-sdk").Networks;
     };
     switchNetwork: (newNetwork: string) => void;
 };

package/dist/useStellar/useTokenMetadata.d.ts

@@ -0,0 +1,40 @@
+import { UseQueryResult } from '@tanstack/react-query';
+import type { TokenMetadata, GetTokenMetadataOptions } from '@bluxcc/core/dist/exports/core/getTokenMetadata';
+import type { QueryOptions } from '../utils';
+type R = TokenMetadata;
+type O = GetTokenMetadataOptions;
+/**
+ * Reads a SEP-41 token / Stellar Asset Contract's metadata by wrapping the core
+ * `getTokenMetadata` in a TanStack query.
+ *
+ * The read is simulation-only — no account, signing, or fees — so it works for
+ * any contract id, deployed or not yet funded. `decimals`, `name`, and `symbol`
+ * come from the standard token interface; `owner` is read separately and is
+ * `undefined` for contracts without an `owner()` function (notably Stellar Asset
+ * 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 options - Core read options (currently just `network`, which defaults
+ *   to the active network).
+ * @param queryOptions - Optional TanStack Query options (`enabled`, `staleTime`,
+ *   `select`, …); `queryKey` and `queryFn` are provided by the hook.
+ * @returns A TanStack query result. Read `data` (the {@link TokenMetadata}),
+ *   `isLoading`, `isError`, `error`, `refetch`, etc.
+ *
+ * @example
+ * ```tsx
+ * // Read a token contract directly.
+ * const { data, isLoading, error } = useTokenMetadata('C…');
+ * // data → { decimals: 7, name: 'USD Coin', symbol: 'USDC', owner?: 'G…' }
+ *
+ * // Derive a classic asset's SAC, then read its metadata once it's known.
+ * const { data: sac } = useSacAddress('USDC:GA…');
+ * const { data: meta } = useTokenMetadata(sac ?? '', undefined, {
+ *   enabled: Boolean(sac),
+ * });
+ * ```
+ */
+export declare function useTokenMetadata(address: string, options?: O, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
+export {};

package/dist/useStellar/useTradeAggregation.d.ts

@@ -5,6 +5,31 @@ import { CallBuilderOptions } from '../utils';
 import type { QueryOptions } from '../utils';
 type R = GetTradeAggregationResult;
 type O = CallBuilderOptions;
+/**
+ * Fetches aggregated trade history (OHLC-style time buckets) for an asset pair
+ * from Horizon.
+ *
+ * Useful for building price charts: trades between `base` and `counter` are
+ * grouped into fixed `resolution`-millisecond buckets over the
+ * `start_time`–`end_time` window.
+ *
+ * @param args - `[base, counter, start_time, end_time, resolution, offset]`: the
+ *   two assets, the start/end of the window (ms since epoch), the bucket size
+ *   `resolution` (ms), and a timezone `offset` (ms).
+ * @param options - Optional `cursor` / `limit` / `order` and `network`
+ *   (defaults to active).
+ * @param queryOptions - Optional TanStack Query options. `queryKey`/`queryFn`
+ *   are managed by the hook.
+ * @returns A TanStack Query result whose `data` holds the aggregated trade
+ *   records (open/high/low/close and volume) per time bucket.
+ *
+ * @example
+ * ```tsx
+ * const { data } = useTradeAggregation([
+ *   Asset.native(), new Asset('USDC', 'GA…'), start, end, 3_600_000, 0,
+ * ]);
+ * ```
+ */
 export declare function useTradeAggregation(args: [
     base: Asset,
     counter: Asset,

package/dist/useStellar/useTrades.d.ts

@@ -3,5 +3,25 @@ import type { GetTradesResult, GetTradesOptions } from "@bluxcc/core/dist/export
 import type { QueryOptions } from "../utils";
 type R = GetTradesResult;
 type O = GetTradesOptions;
+/**
+ * Fetches a paginated list of executed trades from Horizon.
+ *
+ * Filter by `forAssetPair` (`[base, counter]`), `forAccount`, `forOffer`,
+ * `forLiquidityPool`, or `forType` (e.g. orderbook vs. liquidity-pool trades).
+ *
+ * @param options - The `for…` filters, plus optional `cursor` / `limit` /
+ *   `order` and `network` (defaults to active).
+ * @param queryOptions - Optional TanStack Query options. `queryKey`/`queryFn`
+ *   are managed by the hook.
+ * @returns A TanStack Query result. `data` is `{ builder, response }`;
+ *   `response.records` holds the trade records (price, amounts, counterparties).
+ *
+ * @example
+ * ```tsx
+ * const { data } = useTrades({
+ *   forAssetPair: [Asset.native(), new Asset('USDC', 'GA…')],
+ * });
+ * ```
+ */
 export declare function useTrades(options?: O, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
 export {};

package/dist/useStellar/useTransactions.d.ts

@@ -3,5 +3,23 @@ import type { GetTransactionsResult, GetTransactionsOptions } from "@bluxcc/core
 import type { QueryOptions } from "../utils";
 type R = GetTransactionsResult;
 type O = GetTransactionsOptions;
+/**
+ * Fetches a paginated list of transactions from Horizon.
+ *
+ * Filter by `forAccount`, `forLedger`, `forClaimableBalance`, or
+ * `forLiquidityPool`; set `includeFailed` to include transactions that failed.
+ *
+ * @param options - The `for…` filters and `includeFailed`, plus optional
+ *   `cursor` / `limit` / `order` and `network` (defaults to active).
+ * @param queryOptions - Optional TanStack Query options. `queryKey`/`queryFn`
+ *   are managed by the hook.
+ * @returns A TanStack Query result. `data` is `{ builder, response }`;
+ *   `response.records` holds the transaction records.
+ *
+ * @example
+ * ```tsx
+ * const { data } = useTransactions({ forAccount: 'GA…', limit: 25 });
+ * ```
+ */
 export declare function useTransactions(options?: O, queryOptions?: QueryOptions<R>): UseQueryResult<R, Error>;
 export {};

package/dist/useStellar/useTransfer.d.ts

@@ -0,0 +1,60 @@
+import { transfer } from '@bluxcc/core';
+import { UseMutationResult } from '@tanstack/react-query';
+import type { TransferOptions } from '@bluxcc/core/dist/exports/core/transfer';
+import type { MutationOptions } from '../utils';
+type R = Awaited<ReturnType<typeof transfer>>;
+/**
+ * Variables for {@link useTransfer} — the core `transfer` options verbatim, so
+ * every path it supports (native XLM, issued asset, claimable balance, SEP-41
+ * token, federated address) is just a different object passed to
+ * `transfer({ ... })`.
+ */
+export type TransferVariables = TransferOptions;
+type V = TransferVariables;
+/**
+ * Return type of {@link useTransfer}: the full TanStack mutation result plus
+ * wagmi-style aliases — `transfer` (alias of `mutate`, fire-and-forget) and
+ * `transferAsync` (alias of `mutateAsync`, returns a promise).
+ */
+export type UseTransferResult = UseMutationResult<R, Error, V> & {
+    transfer: UseMutationResult<R, Error, V>['mutate'];
+    transferAsync: UseMutationResult<R, Error, V>['mutateAsync'];
+};
+/**
+ * Sends value from the connected wallet to a recipient — native XLM, an issued
+ * asset, or a SEP-41 token — by wrapping the core `transfer` in a TanStack
+ * mutation.
+ *
+ * The core call picks the right operation for you (create-account vs. payment
+ * vs. claimable balance for classic assets, or the token contract's `transfer`
+ * when `token` is set), so callers just describe the transfer. Named after
+ * wagmi's `useSendTransaction` / `useWriteContract`: fire `transfer({ ... })`
+ * (fire-and-forget) or `await transferAsync({ ... })`.
+ *
+ * @param mutationOptions - Optional TanStack Mutation options (`onSuccess`,
+ *   `onError`, `onSettled`, …); a common use is invalidating `useBalances` on
+ *   success. `mutationFn` is provided by the hook.
+ * @returns The TanStack mutation result plus `transfer` (alias of `mutate`) and
+ *   `transferAsync` (alias of `mutateAsync`); read `data` (the submitted
+ *   transaction), `isPending`, `isSuccess`, `error`, `reset`, etc. for state.
+ *
+ * @example
+ * ```tsx
+ * const { transfer, transferAsync, isPending, error } = useTransfer();
+ *
+ * // Native XLM
+ * transfer({ to: 'GB…', amount: '10.5' });
+ *
+ * // Issued asset, falling back to a claimable balance if the recipient
+ * // cannot receive it directly
+ * transfer({ to: 'GB…', amount: '10', asset: 'USDC:GA…', claimable: true });
+ *
+ * // SEP-41 token (integer base units)
+ * transfer({ to: 'GB…', amount: '1000000', token: 'C…' });
+ *
+ * // Await the result (e.g. in a form submit handler)
+ * const tx = await transferAsync({ to: 'alice*example.com', amount: '5' });
+ * ```
+ */
+export declare function useTransfer(mutationOptions?: MutationOptions<R, V>): UseTransferResult;
+export {};

package/dist/useStellar/useWriteContract.d.ts

@@ -3,10 +3,46 @@ import { UseMutationResult } from '@tanstack/react-query';
 import type { IContractCall, WriteContractsOptions } from '@bluxcc/core/dist/exports/utils';
 import type { MutationOptions } from '../utils';
 type R = Awaited<ReturnType<typeof writeContract>>;
+/**
+ * Variables for {@link useWriteContract}: the contract `call` to invoke and
+ * optional core write `options` (e.g. `network`).
+ */
 export type WriteContractVariables = {
     call: IContractCall;
     options?: WriteContractsOptions;
 };
 type V = WriteContractVariables;
+/**
+ * Submits a state-changing Soroban contract invocation as a signed, on-chain
+ * transaction.
+ *
+ * A thin wrapper over TanStack Query's `useMutation`: call `mutate` /
+ * `mutateAsync` with the contract call to sign and send it. Build `args` with
+ * the exported `ToScVal` helpers. For read-only calls (no signature, no fees)
+ * use `useReadContracts` instead.
+ *
+ * @param mutationOptions - Optional TanStack Mutation options (`onSuccess`,
+ *   `onError`, `onSettled`, …); `mutationFn` is provided by the hook.
+ * @returns A TanStack mutation result. Call `mutate({ call, options })` (or
+ *   `mutateAsync`) to send; read `data`, `isPending`, `isSuccess`, `error`,
+ *   `reset`, etc. for state.
+ *
+ * @example
+ * ```tsx
+ * const { mutate, isPending, data } = useWriteContract();
+ *
+ * mutate({
+ *   call: {
+ *     address: 'C…',
+ *     fn: 'transfer',
+ *     args: [
+ *       ToScVal.address('GFROM…'),
+ *       ToScVal.address('GTO…'),
+ *       ToScVal.i128('1000000'),
+ *     ],
+ *   },
+ * });
+ * ```
+ */
 export declare function useWriteContract(mutationOptions?: MutationOptions<R, V>): UseMutationResult<R, Error, V>;
 export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bluxcc/react",
   "author": "Blux team",
-  "version": "0.2.7",
+  "version": "0.2.8",
   "homepage": "https://blux.cc",
   "description": "Connecting to the Stellar Ecosystem and Beyond",
   "repository": {
@@ -30,8 +30,8 @@
     "build": "rollup -c rollup.config.prod.js"
   },
   "peerDependencies": {
-    "@bluxcc/core": "^0.2.7",
-    "@stellar/stellar-sdk": "^15.1.0",
+    "@bluxcc/core": "^0.2.8",
+    "@stellar/stellar-sdk": "^16.0.1",
     "@tanstack/react-query": "^5.90.11",
     "react": ">=17.0.0",
     "react-dom": ">=17.0.0"