@layerswap/wallet-starknet 1.1.0 → 1.1.2

package/README.md

@@ -0,0 +1,92 @@
+# @layerswap/wallet-starknet
+
+Starknet wallet provider for the Layerswap Widget. Enables Starknet wallet connections and transactions.
+
+## Installation
+
+```bash
+npm install @layerswap/wallet-starknet
+# or
+yarn add @layerswap/wallet-starknet
+# or
+pnpm add @layerswap/wallet-starknet
+```
+
+## Quick Start
+
+```tsx
+import { LayerswapProvider, Swap } from "@layerswap/widget";
+import { createStarknetProvider } from "@layerswap/wallet-starknet";
+
+export default function Page() {
+  const starknetProvider = createStarknetProvider({
+    walletConnectConfigs: {
+      projectId: "your-project-id",
+      name: "Your App",
+      description: "Your app description",
+      url: "https://your-app.com",
+      icons: ["https://your-app.com/icon.png"]
+    }
+  });
+  
+  return (
+    <LayerswapProvider walletProviders={[starknetProvider]}>
+      <Swap />
+    </LayerswapProvider>
+  );
+}
+```
+
+## Usage
+
+Use `createStarknetProvider()` to create a Starknet wallet provider:
+
+```tsx
+import { createStarknetProvider } from "@layerswap/wallet-starknet";
+
+const starknetProvider = createStarknetProvider({
+  walletConnectConfigs: {
+    projectId: "your-project-id",
+    name: "Your App",
+    description: "Your app description",
+    url: "https://your-app.com",
+    icons: ["https://your-app.com/icon.png"]
+  }
+});
+```
+
+## Documentation
+
+For detailed setup instructions, configuration options, and usage examples, see the [Starknet Wallet Provider documentation](https://docs.layerswap.io/integration/UI/Widget/WalletManagement/StarknetProvider).
+
+## Features
+
+- Starknet wallet connection via StarknetKit
+- Balance checking
+- Gas estimation
+- NFT provider support
+- Address validation and utilities
+- Starknet transaction support
+
+## Supported Wallets
+
+- Ready Wallet
+- Ready
+- Web wallet
+- Braavos
+- Keplr
+- Xverse
+- Cartridge Controller
+
+## TypeScript
+
+This package includes TypeScript definitions. All types are exported from the main entry point.
+
+## License
+
+MIT
+
+## Repository
+
+[GitHub](https://github.com/layerswap/layerswapapp/tree/main/packages/wallets/starknet)
+

package/dist/esm/StarknetProvider.js

@@ -21,6 +21,8 @@ import { ArgentMobileConnector } from "starknetkit/argentMobile";
 import { InjectedConnector } from "starknetkit/injected";
 // @ts-ignore
 import { WebWalletConnector } from "starknetkit/webwallet";
+// @ts-ignore
+import { ControllerConnector } from "starknetkit/controller";
 import useStarknetConnection, { resolveStarknetWallet } from "./useStarknetConnection";
 import { useStarknetStore } from "./starknetWalletStore";
 class DiscoveryConnector extends Connector {
@@ -105,6 +107,7 @@ const StarknetProvider = ({ children, walletConnectConfigs }) => {
                 description: walletConnectConfig?.description || 'Move crypto across exchanges, blockchains, and wallets.',
             }
         }));
+        defaultConnectors.push(new ControllerConnector());
         defaultConnectors.push(new WebWalletConnector());
         return defaultConnectors;
     };

package/dist/esm/starknetBalanceProvider.js

@@ -19,7 +19,7 @@ export class StarknetBalanceProvider extends BalanceProvider {
             const tokens = insertIfNotExists(network.tokens || [], network.token);
             for (const token of tokens) {
                 try {
-                    const erc20 = new Contract(Erc20Abi, token.contract, provider);
+                    const erc20 = new Contract({ abi: Erc20Abi, address: token.contract, providerOrAccount: provider });
                     const balanceResult = await erc20.balanceOf(address);
                     const balanceInWei = BigNumber.from(uint256.uint256ToBN(balanceResult.balance).toString()).toString();
                     const balance = {

package/dist/esm/starknetGasProvider.js

@@ -28,11 +28,11 @@ export class StarknetGasProvider {
                 calldata: ["69420"],
             };
             const resp = await starknetWalletAccount.estimateInvokeFee([transferCall, watch], { skipValidate: true });
-            if (!resp?.suggestedMaxFee) {
+            if (!resp?.overall_fee) {
                 throw new Error(`Couldn't get fee estimation for the transfer. Response: ${JSON.stringify(resp)}`);
             }
             ;
-            const feeInWei = resp.suggestedMaxFee.toString();
+            const feeInWei = resp.overall_fee.toString();
             const gas = Number(formatUnits(BigInt(feeInWei), network.token.decimals));
             return { gas, token: network.token };
         };

package/dist/esm/starknetNftProvider.js

@@ -29,7 +29,7 @@ export class StarknetNftProvider {
                 nodeUrl: network.node_url
             });
             try {
-                const contract = new Contract(NFT_ABI, contractAddress, provider);
+                const contract = new Contract({ abi: NFT_ABI, address: contractAddress, providerOrAccount: provider });
                 const response = await contract.balanceOf(address);
                 if (!response || typeof response.balance === 'undefined') {
                     throw new Error("Invalid response from NFT contract");

package/dist/esm/useStarknetConnection.js

@@ -1,8 +1,8 @@
 import { useConnect, useDisconnect } from "@starknet-react/core";
-import { KnownInternalNames } from "@layerswap/widget/internal";
-import { resolveStarknetWalletConnectorIcon } from "./utils";
+import { KnownInternalNames, walletIconResolver } from "@layerswap/widget/internal";
 import { useStarknetStore } from "./starknetWalletStore";
 import { useStarknetTransfer } from "./useStarknetTransfer";
+import { resolveStarknetWalletIcon } from "./utils";
 const starknetNames = [KnownInternalNames.Networks.StarkNetGoerli, KnownInternalNames.Networks.StarkNetMainnet, KnownInternalNames.Networks.StarkNetSepolia];
 export default function useStarknetConnection({ networks }) {
     const commonSupportedNetworks = [
@@ -28,20 +28,38 @@ export default function useStarknetConnection({ networks }) {
     const connectWallet = async ({ connector }) => {
         try {
             const starknetConnector = connectors.find(c => c.id === connector.id);
-            const result = await starknetConnector?.connect({});
+            let result = await starknetConnector?.connect({});
             const walletChain = `0x${result?.chainId?.toString(16)}`;
-            const wrongChanin = walletChain == '0x534e5f4d41494e' ? !isMainnet : isMainnet;
-            const starkent = networks.find(n => n.name === KnownInternalNames.Networks.StarkNetMainnet || n.name === KnownInternalNames.Networks.StarkNetSepolia);
-            if (result?.account && wrongChanin) {
-                disconnectWallets(connector?.name, result?.account);
-                const errorMessage = `Please switch the network in your wallet to ${isMainnet ? 'Mainnet' : 'Sepolia'} and click connect again`;
-                throw new Error(errorMessage);
+            const isWalletOnMainnet = walletChain === '0x534e5f4d41494e';
+            const wrongChain = isWalletOnMainnet !== isMainnet;
+            const starknetNetwork = networks.find(n => n.name === KnownInternalNames.Networks.StarkNetMainnet || n.name === KnownInternalNames.Networks.StarkNetSepolia);
+            if (result?.account && wrongChain) {
+                const wallet = starknetConnector?._wallet || starknetConnector?.wallet;
+                if (wallet?.request) {
+                    const targetChainId = isMainnet ? 'SN_MAIN' : 'SN_SEPOLIA';
+                    try {
+                        await wallet.request({
+                            type: "wallet_switchStarknetChain",
+                            params: { chainId: targetChainId }
+                        });
+                        result = await starknetConnector?.connect({});
+                    }
+                    catch (switchError) {
+                        console.log('Chain switch failed:', switchError);
+                        disconnectWallets(connector?.name, result?.account);
+                        throw new Error(`Failed to switch network. Please switch manually to ${isMainnet ? 'Mainnet' : 'Sepolia'} in your wallet.`);
+                    }
+                }
+                else {
+                    disconnectWallets(connector?.name, result?.account);
+                    throw new Error(`Please switch the network in your wallet to ${isMainnet ? 'Mainnet' : 'Sepolia'} and connect again.`);
+                }
             }
             if (result?.account && starknetConnector) {
-                const wallet = await resolveStarknetWallet({
+                const resolvedWallet = await resolveStarknetWallet({
                     name,
                     connector: starknetConnector,
-                    network: starkent,
+                    network: starknetNetwork,
                     disconnectWallets: () => disconnectWallets(starknetConnector.id, result?.account),
                     address: result?.account,
                     withdrawalSupportedNetworks,
@@ -49,15 +67,15 @@ export default function useStarknetConnection({ networks }) {
                     asSourceSupportedNetworks: commonSupportedNetworks,
                 });
                 addAccount(starknetConnector.id, result.account);
-                if (wallet) {
-                    addWallet(wallet);
-                    setActiveWallet(wallet.address);
-                    return wallet;
+                if (resolvedWallet) {
+                    addWallet(resolvedWallet);
+                    setActiveWallet(resolvedWallet.address);
+                    return resolvedWallet;
                 }
             }
         }
         catch (e) {
-            throw new Error(e);
+            throw e;
         }
     };
     const disconnectWallets = async (connectorName, address) => {
@@ -76,7 +94,7 @@ export default function useStarknetConnection({ networks }) {
         return {
             name: name,
             id: connector.id,
-            icon: typeof connector.icon === 'string' ? connector.icon : (connector.icon.light.startsWith('data:') ? connector.icon.light : `data:image/svg+xml;base64,${btoa(connector.icon.light.replaceAll('currentColor', '#FFFFFF'))}`),
+            icon: resolveStarknetWalletIcon({ icon: connector.icon }),
             type: connector?.["_wallet"] ? 'injected' : 'other',
             installUrl: connector?.["_wallet"] ? undefined : connectorsConfigs.find(c => c.id === connector.id)?.installLink,
         };
@@ -108,7 +126,7 @@ export async function resolveStarknetWallet(props) {
         const walletChain = network?.chain_id;
         const { RpcProvider, WalletAccount } = await import('starknet');
         const rpcProvider = new RpcProvider({ nodeUrl: network?.node_url });
-        const walletAccount = new WalletAccount(rpcProvider, connector.wallet, address);
+        const walletAccount = new WalletAccount({ provider: rpcProvider, walletProvider: connector.wallet, address });
         const accounts = await walletAccount.requestAccounts(true);
         const account = accounts?.[0];
         const wallet = {
@@ -117,7 +135,7 @@ export async function resolveStarknetWallet(props) {
             address: account,
             addresses: [account],
             chainId: walletChain || '',
-            icon: resolveStarknetWalletConnectorIcon({ connector: connector.name, address: account }),
+            icon: walletIconResolver(address, resolveStarknetWalletIcon({ icon: connector.icon })),
             providerName: name,
             metadata: {
                 starknetAccount: walletAccount,

package/dist/esm/utils/index.js

@@ -1,3 +1,2 @@
 export * from "./starkNetAddressValidator";
-export * from "./KnownStarknetConnectors";
-export * from "./resolveIcon";
+export * from "./resolveStarknetWalletIcon";

package/dist/esm/utils/resolveStarknetWalletIcon.js

@@ -0,0 +1,3 @@
+export const resolveStarknetWalletIcon = ({ icon }) => {
+    return typeof icon === 'string' ? icon : (icon.light.startsWith('data:') ? icon.light : `data:image/svg+xml;base64,${btoa(icon.light.replaceAll('currentColor', '#FFFFFF'))}`);
+};