@abstraxn/signer-react 1.0.16 → 2.0.0

package/README.md

@@ -98,11 +98,107 @@ function HookConnectButton() {
 
 - `useAbstraxnWallet()` - Main wallet hook
 - `useIsConnected()` - Check connection status
-- `useAddress()` - Get wallet address
-- `useWhoami()` - Get user information
-- `useExternalWalletInfo()` - External wallet information
-- `usePrepareTransaction()` - Prepare and sign transactions
-- `useExportWallet()` - Export wallet
+- `useAddress()` - Get wallet address (EVM)
+- `useWhoami()` - Get user information (includes `solanaAddress` when available)
+- `useExternalWalletInfo()` - External wallet information (EVM)
+- `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)
+
+### Example: EVM → Solana flow after social/email login
+
+```tsx
+import {
+  useAbstraxnWallet,
+  usePublicClient,
+  usePrepareRawTxn,
+  useEstimateGas,
+  useGetGasPrice,
+  useSignAndSendTxn,
+  useWaitForTxnReceipt,
+  useSolanaConnection,
+  useSolanaPublicKey,
+  usePrepareSolanaTxn,
+  useSignAndSendSolanaTxn,
+  useWaitForSolanaConfirmation,
+} from '@abstraxn/signer-react';
+import { polygonAmoy } from 'viem/chains';
+
+function CrossChainExample() {
+  const { isConnected } = useAbstraxnWallet();
+
+  // EVM clients & hooks
+  const { publicClient } = usePublicClient(
+    polygonAmoy,
+    'https://rpc-amoy.polygon.technology'
+  );
+  const { prepareRawTxn } = usePrepareRawTxn(publicClient);
+  const { estimateGas } = useEstimateGas(publicClient);
+  const { getGasPrice } = useGetGasPrice(publicClient);
+  const { signAndSendTxn } = useSignAndSendTxn(publicClient);
+  const { waitForTxnReceipt } = useWaitForTxnReceipt(publicClient);
+
+  // Solana clients & hooks
+  const { connection } = useSolanaConnection('https://api.devnet.solana.com');
+  const { solanaAddress } = useSolanaPublicKey();
+  const { prepareSolanaTransfer } = usePrepareSolanaTxn(connection);
+  const { signAndSendSolanaTxn } = useSignAndSendSolanaTxn(connection);
+  const { waitForSolanaConfirmation } = useWaitForSolanaConfirmation(connection);
+
+  const handleCrossChain = async () => {
+    if (!isConnected) throw new Error('Please login first');
+
+    // 1) EVM tx (e.g. on Polygon Amoy)
+    const from = '0x...'; // current EVM address
+    const rawTx = await prepareRawTxn({
+      from,
+      to: '0x...',
+      value: '0.001',
+    });
+    const { gasLimit } = await estimateGas({
+      account: from,
+      to: rawTx.to,
+      data: rawTx.data,
+      value: rawTx.value,
+    });
+    const fees = await getGasPrice();
+
+    const evmResult = await signAndSendTxn({
+      from,
+      ...rawTx,
+      gas: {
+        gasLimit,
+        maxFeePerGas: fees.maxFeePerGas!,
+        maxPriorityFeePerGas: fees.maxPriorityFeePerGas!,
+      },
+    });
+
+    await waitForTxnReceipt({ hash: evmResult.hash, confirmations: 1 });
+
+    // 2) After EVM confirmation, send SOL
+    if (!solanaAddress) throw new Error('Solana wallet not provisioned');
+
+    const { transaction } = await prepareSolanaTransfer({
+      fromPubkey: solanaAddress,
+      toPubkey: 'TargetSolanaAddressHere',
+      amountInSol: 0.01,
+    });
+
+    const solanaResult = await signAndSendSolanaTxn({
+      transaction,
+      fromPubkey: solanaAddress,
+    });
+
+    await waitForSolanaConfirmation({ signature: solanaResult.signature });
+  };
+
+  return (
+    <button onClick={handleCrossChain}>
+      Run EVM → Solana Flow
+    </button>
+  );
+}
+```
 
 ## 🔗 Related Packages
 

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

@@ -1725,6 +1725,28 @@ export function AbstraxnProviderInner({ config, children, base, wagmi, }) {
             setLoading(false);
         }
     }, []);
+    // Sign Solana transaction via API (returns signed transaction)
+    const signSolanaTransactionViaAPI = useCallback(async (unsignedTransaction, fromAddress) => {
+        if (!walletRef.current)
+            throw new Error("Wallet not initialized");
+        setLoading(true);
+        setError(null);
+        try {
+            const walletAny = walletRef.current;
+            if (typeof walletAny.signSolanaTransactionViaAPI !== "function") {
+                throw new Error("Solana transaction signing is not supported by this wallet");
+            }
+            return await walletAny.signSolanaTransactionViaAPI(unsignedTransaction, fromAddress);
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error("Failed to sign Solana transaction");
+            setError(error);
+            throw error;
+        }
+        finally {
+            setLoading(false);
+        }
+    }, []);
     // Sign typed data / raw payload via API (same flow as signTransactionViaAPI, payload: from, unsignedTransaction, encoding, hashFunction)
     const signTypedTxViaAPI = useCallback(async (fromAddress, unsignedTransaction, encoding, hashFunction) => {
         if (!walletRef.current)
@@ -2855,6 +2877,7 @@ export function AbstraxnProviderInner({ config, children, base, wagmi, }) {
         signTransaction,
         sendTransaction,
         signTransactionViaAPI,
+        signSolanaTransactionViaAPI,
         signTypedTxViaAPI,
         signAndSendTransaction,
         loginWithOTP,