@abstraxn/signer-react 3.2.0 → 3.3.0

package/CHANGELOG.md

@@ -5,6 +5,18 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.3.0] - 2026-04-28
+
+### Added
+
+- **Solana gasless relayer hooks** – Added `useSolanaGasless()` and `useSignAndSendSolanaGaslessTxn()` to support build/sign/send gasless flow from React apps.
+- **Solana gasless provider config** – Added `solanaGasless` in `AbstraxnProviderConfig` for relayer settings (`enabled`, `relayerBaseUrl`, `apiKey`, `networkChainId`, and optional polling defaults).
+
+### Changed
+
+- **Gasless signing path uses existing signer-react backend signing** – Gasless transaction signing now reuses `signSolanaTransactionViaAPI` (+ MFA step-up retry) so signatures continue to come from the existing Turnkey-backed signer flow instead of client-side signing.
+- **Public exports extended** – Exported new Solana gasless hooks and related types from `@abstraxn/signer-react`.
+
 ## [3.2.0] - 2026-04-22
 
 ### Added

package/README.md

@@ -27,6 +27,12 @@ import App from './App';
 
 const providerConfig: AbstraxnProviderConfig = {
   apiKey: 'your-api-key-here',
+  solanaGasless: {
+    enabled: true,
+    relayerBaseUrl: 'https://solana-hub.abstraxn.com',
+    apiKey: 'your-solana-relayer-api-key',
+    networkChainId: 101, // Solana mainnet
+  },
 };
 
 createRoot(document.getElementById('root')!).render(
@@ -105,6 +111,7 @@ function HookConnectButton() {
 - `useExportWallet()` - Export wallet (EVM or Solana, based on current chain)
 - `usePublicClient()` / `usePrepareRawTxn()` / `useSignTxn()` / `useSignAndSendTxn()` / `useWaitForTxnReceipt()` - EVM transaction flow (prepare → sign → send → confirm)
 - `useSolanaConnection()` / `useSolanaPublicKey()` / `usePrepareSolanaTxn()` / `useSignSolanaTxn()` / `useSignAndSendSolanaTxn()` / `useWaitForSolanaConfirmation()` - Solana transaction flow (prepare → sign → send → confirm)
+- `useSolanaGasless()` / `useSignAndSendSolanaGaslessTxn()` - Solana gasless flow using relayer build/send with Turnkey signing through signer-react
 - `useSmartAccountOwner()` - Get an AA-compatible owner account for permissionless-style account abstraction flows
 
 ### Example: Account Abstraction owner (permissionless-compatible)

package/dist/src/components/AbstraxnProvider/AbstraxnProvider.js

@@ -14,6 +14,9 @@ import { ConnectionProvider, WalletProvider } from "@solana/wallet-adapter-react
 import { PhantomWalletAdapter, SolflareWalletAdapter } from "@solana/wallet-adapter-wallets";
 export function AbstraxnProvider({ config, children }) {
     const externalWalletsEnabled = config.externalWallets?.enabled ?? false;
+    const solanaEndpoint = config.chains?.solanaEndpoint ??
+        config.solanaEndpoint ??
+        "https://api.mainnet-beta.solana.com";
     const externalSsr = config.externalWallets?.ssr ?? false;
     // Get or create QueryClient - tries to use existing one from context first
     // This ensures we use the app's QueryClient instance if it exists, preventing multiple instances
@@ -197,7 +200,7 @@ export function AbstraxnProvider({ config, children }) {
         }
         // Do NOT pass key to WagmiProvider. Remounting loses connection state and causes
         // "Connector not connected" in Next.js (e.g. when config loads after hydration).
-        return (_jsx(QueryClientWrapper, { queryClient: queryClient, children: _jsx(ConnectionProvider, { endpoint: config.chains?.solanaEndpoint || "https://api.mainnet-beta.solana.com", children: _jsx(WalletProvider, { wallets: solanaWallets, autoConnect: true, children: _jsx(WagmiProvider, { config: wagmiConfig, initialState: config.initialState, children: _jsx(AbstraxnProviderWithWagmi, { config: config, children: children }) }) }) }) }));
+        return (_jsx(QueryClientWrapper, { queryClient: queryClient, children: _jsx(ConnectionProvider, { endpoint: solanaEndpoint, children: _jsx(WalletProvider, { wallets: solanaWallets, autoConnect: true, children: _jsx(WagmiProvider, { config: wagmiConfig, initialState: config.initialState, children: _jsx(AbstraxnProviderWithWagmi, { config: config, children: children }) }) }) }) }));
     }
     // If external wallets are disabled, use the provider without wagmi
     return (_jsx(AbstraxnProviderWithoutWagmi, { config: config, children: children }));

package/dist/src/components/AbstraxnProvider/AbstraxnProviderInner.js

@@ -3686,6 +3686,7 @@ export function AbstraxnProviderInner({ config, children, base, wagmi, solana, }
         setEmailForOtp: setEmailForOtp,
         // Global config flags
         enableSolana: config.chains?.enableSolana,
+        solanaGaslessConfig: config.solanaGasless,
     };
     // Ref to store latest value to avoid dependency issues (defined after value)
     const valueRef = useRef(value);

package/dist/src/hooks.d.ts

@@ -1,6 +1,8 @@
 import type { WhoamiResponse, TransactionRequest, EnableMfaResponse, VerifySetupMfaResponse, DisableMfaResponse, SupportedAuthMethod, LinkedAuthMethod } from '@abstraxn/signer-core';
 import type { Chain, PublicClient, Address, Abi, GetContractReturnType, TransactionReceipt } from 'viem';
 import { Connection as SolanaConnection, Transaction as SolanaTransaction, TransactionInstruction, type Commitment, type SendOptions } from '@solana/web3.js';
+import { SolanaRelayer } from '@abstraxn/solana-relayer';
+import type { BuildTxParams as SolanaGaslessBuildTxParams, BuildRelayTxResult as SolanaGaslessBuildTxResult, RelaySubmitResponse as SolanaGaslessRelaySubmitResponse, RelayStatusResponse as SolanaGaslessRelayStatusResponse } from '@abstraxn/solana-relayer';
 import type { TypedData, TypedDataDomain } from 'viem';
 import { type ConnectorType, type ConnectorMeta } from './connectors';
 /**
@@ -8614,6 +8616,47 @@ export declare function useSignAndSendSolanaTxn(connection: SolanaConnection): {
     isConnected: boolean;
     solanaAddress: string | null;
 };
+export type SolanaGaslessBuildParams = Omit<SolanaGaslessBuildTxParams, 'connection' | 'sender'> & {
+    connection?: SolanaConnection;
+    sender?: string;
+};
+export interface SolanaGaslessConfigResolved {
+    enabled: boolean;
+    relayerBaseUrl: string;
+    apiKey: string;
+    networkChainId: number;
+    defaultPollMs?: number;
+    defaultTimeoutMs?: number;
+    relayerUrl: string;
+}
+export declare function useSolanaGasless(): {
+    isEnabled: boolean;
+    config: SolanaGaslessConfigResolved | null;
+    relayerClient: SolanaRelayer | null;
+    buildGaslessTx: (params: SolanaGaslessBuildParams) => Promise<SolanaGaslessBuildTxResult>;
+    signGaslessTx: (params: {
+        transaction: SolanaTransaction;
+        sender?: string;
+    }) => Promise<{
+        signedTransactionBase64: string;
+        signedTransactionHex: string;
+    }>;
+    sendGaslessTx: (params: {
+        signedTransactionBase64: string;
+        lastValidBlockHeight: number;
+    }) => Promise<SolanaGaslessRelaySubmitResponse>;
+    getGaslessTxStatus: (txnId: string) => Promise<SolanaGaslessRelayStatusResponse>;
+};
+export declare function useSignAndSendSolanaGaslessTxn(): {
+    signAndSendGaslessTx: (params: SolanaGaslessBuildParams) => Promise<{
+        txnId: string;
+        status: "pending" | "confirmed" | "processing" | "failed";
+        preview: Record<string, unknown>;
+        signedTransactionHex: string;
+        signedTransactionBase64: string;
+        lastValidBlockHeight: number;
+    }>;
+};
 /**
  * Hook to wait for Solana transaction confirmation.
  */

package/dist/src/hooks.js

@@ -7,6 +7,7 @@ import { InvalidDeviceIdError, SignMfaRequiredError } from '@abstraxn/signer-cor
 import { createPublicClient, createWalletClient, http, getContract, serializeTransaction, encodeFunctionData, hashTypedData, hashMessage, parseSignature } from 'viem';
 import { toAccount } from 'viem/accounts';
 import { Connection as SolanaConnection, Transaction as SolanaTransaction, SystemProgram, PublicKey, LAMPORTS_PER_SOL, TransactionInstruction, } from '@solana/web3.js';
+import { SolanaRelayer } from '@abstraxn/solana-relayer';
 import { useWalletClient as useWagmiWalletClient, useAccount, useConfig, useChainId as useWagmiChainId, useSwitchChain as useWagmiSwitchChain, useSignMessage as useWagmiSignMessage, useReconnect as useWagmiReconnect } from 'wagmi';
 import { getWalletClient, switchChain } from '@wagmi/core';
 import { getConnectorMeta } from './connectors';
@@ -1517,6 +1518,145 @@ export function useSignAndSendSolanaTxn(connection) {
     }, [connection, isConnected, whoami, signSolanaTransactionViaAPI, verifySignMfa]);
     return { signAndSendSolanaTxn, isConnected, solanaAddress: whoami?.solanaAddress ?? null };
 }
+function buildSolanaRelayerUrl(relayerBaseUrl, networkChainId, apiKey) {
+    const parsed = new URL(relayerBaseUrl);
+    const hasTxPath = /\/tx\/\d+\/?$/.test(parsed.pathname);
+    const hasChainOnlyPath = /\/\d+\/?$/.test(parsed.pathname);
+    if (!hasTxPath && !hasChainOnlyPath) {
+        const basePath = parsed.pathname.replace(/\/$/, "");
+        const withApiV1 = /\/api\/v1$/.test(basePath)
+            ? basePath
+            : `${basePath}/api/v1`;
+        parsed.pathname = `${withApiV1}/tx/${networkChainId}/`;
+    }
+    parsed.searchParams.set("apikey", apiKey);
+    return parsed.toString();
+}
+function hexToBase64SignedTransaction(signedHex) {
+    const hex = signedHex.startsWith('0x') ? signedHex.slice(2) : signedHex;
+    const bytes = new Uint8Array(hex.match(/.{1,2}/g)?.map((byte) => parseInt(byte, 16)) ?? []);
+    if (typeof btoa === 'function') {
+        let binary = '';
+        for (let i = 0; i < bytes.length; i++)
+            binary += String.fromCharCode(bytes[i]);
+        return btoa(binary);
+    }
+    return Buffer.from(bytes).toString('base64');
+}
+export function useSolanaGasless() {
+    const { isConnected, whoami, solanaConnection, signSolanaTransactionViaAPI, verifySignMfa, solanaGaslessConfig, } = useAbstraxnWallet();
+    const providerConnection = solanaConnection?.connection ?? null;
+    const resolvedConfig = useMemo(() => {
+        if (!solanaGaslessConfig?.enabled)
+            return null;
+        const relayerBaseUrl = solanaGaslessConfig.relayerBaseUrl?.trim();
+        const apiKey = solanaGaslessConfig.apiKey?.trim();
+        const networkChainId = solanaGaslessConfig.networkChainId;
+        if (!relayerBaseUrl || !apiKey || !networkChainId)
+            return null;
+        const base = relayerBaseUrl.replace(/\/$/, '');
+        const relayerUrl = buildSolanaRelayerUrl(base, networkChainId, apiKey);
+        return {
+            enabled: true,
+            relayerBaseUrl: base,
+            apiKey,
+            networkChainId,
+            defaultPollMs: solanaGaslessConfig.defaultPollMs,
+            defaultTimeoutMs: solanaGaslessConfig.defaultTimeoutMs,
+            relayerUrl,
+        };
+    }, [solanaGaslessConfig]);
+    const relayerClient = useMemo(() => {
+        if (!resolvedConfig)
+            return null;
+        return new SolanaRelayer({
+            relayerUrl: resolvedConfig.relayerUrl,
+            defaultPollMs: resolvedConfig.defaultPollMs,
+            defaultTimeoutMs: resolvedConfig.defaultTimeoutMs,
+        });
+    }, [resolvedConfig]);
+    const ensureReady = useCallback(() => {
+        if (!isConnected)
+            throw new Error('Wallet is not connected');
+        if (!resolvedConfig) {
+            throw new Error('Solana gasless is not configured. Set config.solanaGasless with enabled, relayerBaseUrl, apiKey and networkChainId.');
+        }
+        if (!relayerClient)
+            throw new Error('Failed to initialize Solana relayer client');
+        if (!signSolanaTransactionViaAPI) {
+            throw new Error('Solana transaction signing is not supported by this wallet');
+        }
+        const sender = whoami?.solanaAddress ?? null;
+        if (!sender)
+            throw new Error('Solana address is required for gasless flow');
+        return { sender };
+    }, [isConnected, relayerClient, resolvedConfig, signSolanaTransactionViaAPI, whoami]);
+    const buildGaslessTx = useCallback(async (params) => {
+        const { sender } = ensureReady();
+        const connection = params.connection ?? providerConnection;
+        if (!connection)
+            throw new Error('Solana connection is required');
+        const { connection: _connection, sender: _sender, ...rest } = params;
+        return await relayerClient.buildTx({
+            connection,
+            sender: _sender ?? sender,
+            ...rest,
+        });
+    }, [ensureReady, providerConnection, relayerClient]);
+    const signGaslessTx = useCallback(async (params) => {
+        const { sender } = ensureReady();
+        const unsignedBytes = params.transaction.serialize({ requireAllSignatures: false });
+        const unsignedHex = Array.from(unsignedBytes)
+            .map((b) => b.toString(16).padStart(2, '0'))
+            .join('');
+        const signWith = params.sender ?? sender;
+        const { signedTransaction } = await runWithSignStepUpRetry(() => signSolanaTransactionViaAPI(unsignedHex, signWith), verifySignMfa);
+        return {
+            signedTransactionHex: signedTransaction,
+            signedTransactionBase64: hexToBase64SignedTransaction(signedTransaction),
+        };
+    }, [ensureReady, signSolanaTransactionViaAPI, verifySignMfa]);
+    const sendGaslessTx = useCallback(async (params) => {
+        ensureReady();
+        return await relayerClient.sendTx({
+            signedTransaction: params.signedTransactionBase64,
+            lastValidBlockHeight: params.lastValidBlockHeight,
+        });
+    }, [ensureReady, relayerClient]);
+    const getGaslessTxStatus = useCallback(async (txnId) => {
+        ensureReady();
+        return await relayerClient.getTxStatus({ txnId });
+    }, [ensureReady, relayerClient]);
+    return {
+        isEnabled: !!resolvedConfig,
+        config: resolvedConfig,
+        relayerClient,
+        buildGaslessTx,
+        signGaslessTx,
+        sendGaslessTx,
+        getGaslessTxStatus,
+    };
+}
+export function useSignAndSendSolanaGaslessTxn() {
+    const { buildGaslessTx, signGaslessTx, sendGaslessTx } = useSolanaGasless();
+    const signAndSendGaslessTx = useCallback(async (params) => {
+        const built = await buildGaslessTx(params);
+        const signed = await signGaslessTx({ transaction: built.tx, sender: params.sender });
+        const relay = await sendGaslessTx({
+            signedTransactionBase64: signed.signedTransactionBase64,
+            lastValidBlockHeight: built.lastValidBlockHeight,
+        });
+        return {
+            txnId: relay.txnId,
+            status: relay.status,
+            preview: built.preview,
+            signedTransactionHex: signed.signedTransactionHex,
+            signedTransactionBase64: signed.signedTransactionBase64,
+            lastValidBlockHeight: built.lastValidBlockHeight,
+        };
+    }, [buildGaslessTx, sendGaslessTx, signGaslessTx]);
+    return { signAndSendGaslessTx };
+}
 /**
  * Hook to wait for Solana transaction confirmation.
  */

package/dist/src/index.d.ts

@@ -4,14 +4,14 @@
  * when used in a React project
  */
 export { AbstraxnProvider, useAbstraxnWallet } from './AbstraxnProvider';
-export { useIsConnected, useAddress, useAuthContext, useChainId, useError, useEnableMfa, useDisableMfa, useAuthMethodLinking, useEmailForOtp, useWallet, useSmartAccountOwner, useExportWallet, useWhoami, useExternalWallet, useExternalWalletBalance, useExternalWalletChain, useExternalWalletInfo, usePublicClient, useWalletClient, useContract, usePrepareRawTxn, useSignTxn, useSignTypedTx, useSignAndSendTxn, useWaitForTxnReceipt, useReadContract, useExternalWalletClient, useWriteContract, useConnectionType, useSwitchChain, useSignMessage, useEstimateGas, useGetGasPrice, useSolanaConnection, useSolanaPublicKey, useSolanaBalance, usePrepareSolanaTxn, useSolanaExternalWallet, usePrepareSolanaProgramTxn, useSolanaProgramTransaction, useSignSolanaTxn, useSignAndSendSolanaTxn, useWaitForSolanaConfirmation, } from './hooks';
+export { useIsConnected, useAddress, useAuthContext, useChainId, useError, useEnableMfa, useDisableMfa, useAuthMethodLinking, useEmailForOtp, useWallet, useSmartAccountOwner, useExportWallet, useWhoami, useExternalWallet, useExternalWalletBalance, useExternalWalletChain, useExternalWalletInfo, usePublicClient, useWalletClient, useContract, usePrepareRawTxn, useSignTxn, useSignTypedTx, useSignAndSendTxn, useWaitForTxnReceipt, useReadContract, useExternalWalletClient, useWriteContract, useConnectionType, useSwitchChain, useSignMessage, useEstimateGas, useGetGasPrice, useSolanaConnection, useSolanaPublicKey, useSolanaBalance, usePrepareSolanaTxn, useSolanaExternalWallet, usePrepareSolanaProgramTxn, useSolanaProgramTransaction, useSignSolanaTxn, useSignAndSendSolanaTxn, useSolanaGasless, useSignAndSendSolanaGaslessTxn, useWaitForSolanaConfirmation, } from './hooks';
 export { ConnectButton } from './ConnectButton';
 export type { ConnectButtonProps, ConnectButtonVariant, ConnectButtonSize } from './ConnectButton';
 export { WalletModal } from './WalletModal';
 export type { WalletModalProps } from './WalletModal';
 export { OnboardingUIComponent as OnboardingUI } from './OnboardingUI';
-export type { AbstraxnProviderConfig, AbstraxnUIConfig, AbstraxnContextValue, ChainConfig, } from './types';
-export type { PayloadEncoding, HashFunction, SignTypedTxParams, SmartAccountOwnerOptions, SmartAccountOwnerResult, SolanaAccountMetaInput, SolanaInstructionDataInput, } from './hooks';
+export type { AbstraxnProviderConfig, AbstraxnUIConfig, AbstraxnContextValue, ChainConfig, SolanaGaslessConfig, } from './types';
+export type { PayloadEncoding, HashFunction, SignTypedTxParams, SmartAccountOwnerOptions, SmartAccountOwnerResult, SolanaGaslessBuildParams, SolanaGaslessConfigResolved, SolanaAccountMetaInput, SolanaInstructionDataInput, } from './hooks';
 export type { OnboardingUIComponentProps, OnboardingUIComponentRef } from './OnboardingUI';
 export { ALL_CHAINS, EVM_CHAINS, SOLANA_CHAINS, getChainById, getChainsByType, getDefaultChains, toCoreChain, type ChainData, } from './chains';
 export { CONNECTORS, getConnectorMeta, isOAuthConnector, isWalletConnector, isAuthConnector, type ConnectorType, type ConnectorMeta, } from './connectors';

package/dist/src/index.js

@@ -4,7 +4,7 @@
  * when used in a React project
  */
 export { AbstraxnProvider, useAbstraxnWallet } from './AbstraxnProvider';
-export { useIsConnected, useAddress, useAuthContext, useChainId, useError, useEnableMfa, useDisableMfa, useAuthMethodLinking, useEmailForOtp, useWallet, useSmartAccountOwner, useExportWallet, useWhoami, useExternalWallet, useExternalWalletBalance, useExternalWalletChain, useExternalWalletInfo, usePublicClient, useWalletClient, useContract, usePrepareRawTxn, useSignTxn, useSignTypedTx, useSignAndSendTxn, useWaitForTxnReceipt, useReadContract, useExternalWalletClient, useWriteContract, useConnectionType, useSwitchChain, useSignMessage, useEstimateGas, useGetGasPrice, useSolanaConnection, useSolanaPublicKey, useSolanaBalance, usePrepareSolanaTxn, useSolanaExternalWallet, usePrepareSolanaProgramTxn, useSolanaProgramTransaction, useSignSolanaTxn, useSignAndSendSolanaTxn, useWaitForSolanaConfirmation, } from './hooks';
+export { useIsConnected, useAddress, useAuthContext, useChainId, useError, useEnableMfa, useDisableMfa, useAuthMethodLinking, useEmailForOtp, useWallet, useSmartAccountOwner, useExportWallet, useWhoami, useExternalWallet, useExternalWalletBalance, useExternalWalletChain, useExternalWalletInfo, usePublicClient, useWalletClient, useContract, usePrepareRawTxn, useSignTxn, useSignTypedTx, useSignAndSendTxn, useWaitForTxnReceipt, useReadContract, useExternalWalletClient, useWriteContract, useConnectionType, useSwitchChain, useSignMessage, useEstimateGas, useGetGasPrice, useSolanaConnection, useSolanaPublicKey, useSolanaBalance, usePrepareSolanaTxn, useSolanaExternalWallet, usePrepareSolanaProgramTxn, useSolanaProgramTransaction, useSignSolanaTxn, useSignAndSendSolanaTxn, useSolanaGasless, useSignAndSendSolanaGaslessTxn, useWaitForSolanaConfirmation, } from './hooks';
 export { ConnectButton } from './ConnectButton';
 export { WalletModal } from './WalletModal';
 export { OnboardingUIComponent as OnboardingUI } from './OnboardingUI';

package/dist/src/types.d.ts

@@ -146,6 +146,33 @@ export interface ChainConfig {
      */
     solanaEndpoint?: string;
 }
+export interface SolanaGaslessConfig {
+    /**
+     * Enable Solana gasless relayer flow.
+     * @default false
+     */
+    enabled?: boolean;
+    /**
+     * Base relayer URL without path/query (e.g. https://relayer.abstraxn.com)
+     */
+    relayerBaseUrl?: string;
+    /**
+     * API key used by relayer endpoints.
+     */
+    apiKey?: string;
+    /**
+     * Solana chain/network id used in relayer path (/tx/:chainId).
+     */
+    networkChainId?: number;
+    /**
+     * Optional default polling interval in ms for status checks.
+     */
+    defaultPollMs?: number;
+    /**
+     * Optional default timeout in ms for polling helpers.
+     */
+    defaultTimeoutMs?: number;
+}
 /**
  * Complete configuration for AbstraxnProvider
  */
@@ -172,6 +199,15 @@ export interface AbstraxnProviderConfig extends AbstraxnWalletConfig {
      * Chain configuration
      */
     chains?: ChainConfig;
+    /**
+     * Top-level Solana RPC endpoint fallback.
+     * Useful when `chains` is passed as an array (viem chain format).
+     */
+    solanaEndpoint?: string;
+    /**
+     * Solana gasless relayer configuration.
+     */
+    solanaGasless?: SolanaGaslessConfig;
     /**
      * Optional custom wagmi config
      * If provided, this will be used instead of creating a new one
@@ -278,4 +314,5 @@ export interface AbstraxnContextValue {
     emailForOtp?: string;
     setEmailForOtp?: (email: string) => void;
     enableSolana?: boolean;
+    solanaGaslessConfig?: SolanaGaslessConfig;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@abstraxn/signer-react",
-  "version": "3.2.0",
+  "version": "3.3.0",
   "description": "React SDK for Abstraxn Wallet - React components, hooks, and providers for seamless Web3 wallet integration",
   "main": "./dist/src/index.js",
   "module": "./dist/src/index.js",
@@ -41,6 +41,7 @@
   },
   "dependencies": {
     "@abstraxn/signer-core": "2.1.2",
+    "@abstraxn/solana-relayer": "^0.0.2",
     "@solana/wallet-adapter-base": "^0.9.27",
     "@solana/wallet-adapter-react": "^0.15.39",
     "@solana/wallet-adapter-react-ui": "^0.9.39",