@reown/appkit-solana-react-native 0.0.0-chore-bump-builder-20250728194329

package/lib/module/adapter.js

@@ -0,0 +1,205 @@
+"use strict";
+
+import { SolanaBaseAdapter } from '@reown/appkit-common-react-native';
+import { getSolanaNativeBalance, getSolanaTokenBalance } from './helpers';
+import { Connection, Transaction, VersionedTransaction } from '@solana/web3.js';
+import base58 from 'bs58';
+import { createSendTransaction } from './utils/createSendTransaction';
+export class SolanaAdapter extends SolanaBaseAdapter {
+  static supportedNamespace = 'solana';
+  constructor(configParams) {
+    super({
+      projectId: configParams.projectId,
+      supportedNamespace: SolanaAdapter.supportedNamespace,
+      adapterType: 'solana'
+    });
+  }
+  async getBalance(params) {
+    const {
+      network,
+      address,
+      tokens
+    } = params;
+    if (!this.connector) throw new Error('No active connector');
+    if (!network) throw new Error('No network provided');
+    const balanceAddress = address || this.getAccounts()?.find(account => account.includes(network.id.toString()));
+    if (!balanceAddress) {
+      return {
+        amount: '0.00',
+        symbol: 'SOL'
+      };
+    }
+    try {
+      const rpcUrl = network.rpcUrls?.default?.http?.[0];
+      if (!rpcUrl) throw new Error('No RPC URL available');
+      const base58Address = balanceAddress.split(':')[2];
+      if (!base58Address) throw new Error('Invalid balance address');
+      const token = network?.caipNetworkId && tokens?.[network.caipNetworkId]?.address;
+      let balance;
+      if (token) {
+        const {
+          amount,
+          symbol
+        } = await getSolanaTokenBalance(rpcUrl, base58Address, token);
+        balance = {
+          amount,
+          symbol
+        };
+      } else {
+        const amount = await getSolanaNativeBalance(rpcUrl, base58Address);
+        balance = {
+          amount: amount.toString(),
+          symbol: 'SOL'
+        };
+      }
+      this.emit('balanceChanged', {
+        address: balanceAddress,
+        balance
+      });
+      return balance;
+    } catch (error) {
+      return {
+        amount: '0.00',
+        symbol: 'SOL'
+      };
+    }
+  }
+  async signTransaction(transaction, network) {
+    if (!this.connector) {
+      throw new Error('SolanaAdapter:signTransaction - no active connector');
+    }
+    if (!network) {
+      throw new Error('SolanaAdapter:signTransaction - network is undefined');
+    }
+    const provider = this.connector.getProvider();
+    if (!provider) {
+      throw new Error('SolanaAdapter:signTransaction - provider is undefined');
+    }
+    try {
+      // Serialize transaction to base64 (following WalletConnect standard)
+      const serializedTransaction = Buffer.from(new Uint8Array(transaction.serialize({
+        verifySignatures: false
+      }))).toString('base64');
+      const result = await provider.request({
+        method: 'solana_signTransaction',
+        params: {
+          transaction: serializedTransaction,
+          pubkey: this.getAccounts()?.[0]?.split(':')[2] || ''
+        }
+      }, network.caipNetworkId);
+
+      // Handle different response formats
+      if ('signature' in result && result.signature) {
+        // Old RPC response format - add signature to transaction
+        const decoded = base58.decode(result.signature);
+        if (transaction instanceof Transaction && transaction.feePayer) {
+          transaction.addSignature(transaction.feePayer, Buffer.from(decoded));
+        }
+        return transaction;
+      }
+      if ('transaction' in result && result.transaction) {
+        // New response format - deserialize the signed transaction
+        const decodedTransaction = Buffer.from(result.transaction, 'base64');
+        if (transaction instanceof VersionedTransaction) {
+          return VersionedTransaction.deserialize(new Uint8Array(decodedTransaction));
+        }
+        return Transaction.from(decodedTransaction);
+      }
+      throw new Error('SolanaAdapter:signTransaction - invalid response format');
+    } catch (error) {
+      if (error instanceof Error) {
+        throw new Error(`SolanaAdapter:signTransaction - ${error.message}`);
+      }
+      throw new Error('SolanaAdapter:signTransaction - unknown error occurred');
+    }
+  }
+  async sendTransaction(data) {
+    const {
+      fromAddress,
+      toAddress,
+      amount,
+      network,
+      rpcUrl
+    } = data;
+    if (!this.connector) {
+      throw new Error('SolanaAdapter:sendTransaction - no active connector');
+    }
+    const provider = this.connector.getProvider();
+    if (!provider) {
+      throw new Error('SolanaAdapter:sendTransaction - provider is undefined');
+    }
+    if (!network) {
+      throw new Error('SolanaAdapter:sendTransaction - network is undefined');
+    }
+    if (!fromAddress) {
+      throw new Error('SolanaAdapter:sendTransaction - fromAddress is undefined');
+    }
+    if (!toAddress) {
+      throw new Error('SolanaAdapter:sendTransaction - toAddress is undefined');
+    }
+    if (!amount || amount <= 0) {
+      throw new Error('SolanaAdapter:sendTransaction - amount must be greater than 0');
+    }
+    try {
+      // Determine RPC URL
+      let connectionRpcUrl = rpcUrl;
+      if (!connectionRpcUrl && network) {
+        connectionRpcUrl = network.rpcUrls?.default?.http?.[0];
+      }
+      if (!connectionRpcUrl) {
+        throw new Error('SolanaAdapter:sendTransaction - no RPC URL available');
+      }
+
+      // Create connection
+      const connection = new Connection(connectionRpcUrl, 'confirmed');
+      const transaction = await createSendTransaction({
+        connection,
+        fromAddress,
+        toAddress,
+        value: amount
+      });
+
+      // Sign the transaction
+      const signedTransaction = await this.signTransaction(transaction, network);
+
+      // Send the signed transaction
+      const signature = await connection.sendRawTransaction(signedTransaction.serialize(), {
+        skipPreflight: false,
+        preflightCommitment: 'confirmed'
+      });
+      if (!signature) {
+        throw new Error('SolanaAdapter:sendTransaction - no signature returned');
+      }
+      return signature;
+    } catch (error) {
+      if (error instanceof Error) {
+        throw new Error(`SolanaAdapter:sendTransaction - ${error.message}`);
+      }
+      throw new Error('SolanaAdapter:sendTransaction - unknown error occurred');
+    }
+  }
+  async switchNetwork(network) {
+    if (!this.connector) throw new Error('No active connector');
+    const provider = this.connector.getProvider();
+    if (!provider) throw new Error('No active provider');
+    try {
+      await this.connector.switchNetwork(network);
+      return;
+    } catch (switchError) {
+      throw switchError;
+    }
+  }
+  getAccounts() {
+    if (!this.connector) throw new Error('No active connector');
+    const namespaces = this.connector.getNamespaces();
+    return namespaces[this.getSupportedNamespace()]?.accounts;
+  }
+  disconnect() {
+    if (!this.connector) throw new Error('No active connector');
+    return this.connector.disconnect();
+  }
+  getSupportedNamespace() {
+    return SolanaAdapter.supportedNamespace;
+  }
+}
+//# sourceMappingURL=adapter.js.map

package/lib/module/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["SolanaBaseAdapter","getSolanaNativeBalance","getSolanaTokenBalance","Connection","Transaction","VersionedTransaction","base58","createSendTransaction","SolanaAdapter","supportedNamespace","constructor","configParams","projectId","adapterType","getBalance","params","network","address","tokens","connector","Error","balanceAddress","getAccounts","find","account","includes","id","toString","amount","symbol","rpcUrl","rpcUrls","default","http","base58Address","split","token","caipNetworkId","balance","emit","error","signTransaction","transaction","provider","getProvider","serializedTransaction","Buffer","from","Uint8Array","serialize","verifySignatures","result","request","method","pubkey","signature","decoded","decode","feePayer","addSignature","decodedTransaction","deserialize","message","sendTransaction","data","fromAddress","toAddress","connectionRpcUrl","connection","value","signedTransaction","sendRawTransaction","skipPreflight","preflightCommitment","switchNetwork","switchError","namespaces","getNamespaces","getSupportedNamespace","accounts","disconnect"],"sourceRoot":"../../src","sources":["adapter.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/connectors/PhantomConnector.js

@@ -0,0 +1,238 @@
+"use strict";
+
+import { WalletConnector, solana, solanaDevnet, solanaTestnet, ConstantsUtil } from '@reown/appkit-common-react-native';
+import nacl from 'tweetnacl';
+import bs58 from 'bs58';
+import { PhantomProvider, SOLANA_SIGNING_METHODS } from '../providers/PhantomProvider';
+const SOLANA_CLUSTER_TO_CHAIN_ID_PART = {
+  'mainnet-beta': solana.id,
+  'testnet': solanaTestnet.id,
+  'devnet': solanaDevnet.id
+};
+const PHANTOM_CONNECTOR_STORAGE_KEY = '@appkit/phantom-connector-data';
+const DAPP_KEYPAIR_STORAGE_KEY = '@appkit/phantom-dapp-secret-key';
+export class PhantomConnector extends WalletConnector {
+  currentCaipNetworkId = null;
+  static SUPPORTED_NAMESPACE = 'solana';
+  constructor(config) {
+    super({
+      type: 'phantom'
+    });
+    this.config = config ?? {
+      cluster: 'mainnet-beta'
+    };
+  }
+  async init(ops) {
+    super.init(ops);
+    this.storage = ops.storage;
+    await this.initializeKeyPair();
+    const appScheme = ops.metadata.redirect?.universal ?? ops.metadata.redirect?.native;
+    if (!appScheme) {
+      throw new Error('Phantom Connector: No redirect link found in metadata. Please add redirect.universal or redirect.native to the metadata.');
+    }
+    const providerConfig = {
+      appScheme,
+      dappUrl: ops.metadata.url,
+      storage: ops.storage,
+      dappEncryptionKeyPair: this.dappEncryptionKeyPair
+    };
+    this.provider = new PhantomProvider(providerConfig);
+    await this.restoreSession();
+  }
+  async initializeKeyPair() {
+    try {
+      const secretKeyB58 = await this.getStorage().getItem(DAPP_KEYPAIR_STORAGE_KEY);
+      if (secretKeyB58) {
+        const secretKey = bs58.decode(secretKeyB58);
+        this.dappEncryptionKeyPair = nacl.box.keyPair.fromSecretKey(secretKey);
+      } else {
+        const newKeyPair = nacl.box.keyPair();
+        this.dappEncryptionKeyPair = newKeyPair;
+        await this.getStorage().setItem(DAPP_KEYPAIR_STORAGE_KEY, bs58.encode(newKeyPair.secretKey));
+      }
+    } catch (error) {
+      // disconnect and clear session
+      await this.disconnect();
+      throw error;
+    }
+  }
+  async connect(opts) {
+    if (this.isConnected()) {
+      return this.namespaces;
+    }
+    const defaultChain = opts?.defaultChain?.split(':')?.[0] === 'solana' ? opts?.defaultChain?.split(':')[1] : opts?.namespaces?.['solana']?.chains?.[0]?.split(':')[1];
+    const requestedCluster = this.config.cluster ?? Object.keys(SOLANA_CLUSTER_TO_CHAIN_ID_PART).find(key => SOLANA_CLUSTER_TO_CHAIN_ID_PART[key] === defaultChain);
+    try {
+      const connectResult = await this.getProvider().connect({
+        cluster: requestedCluster
+      });
+      const solanaChainIdPart = SOLANA_CLUSTER_TO_CHAIN_ID_PART[connectResult.cluster];
+      if (!solanaChainIdPart) {
+        throw new Error(`Phantom Connect: Internal - Unknown cluster mapping for ${connectResult.cluster}`);
+      }
+      this.currentCaipNetworkId = `solana:${solanaChainIdPart}`;
+      this.wallet = ConstantsUtil.PHANTOM_CUSTOM_WALLET;
+      const userPublicKey = this.getProvider().getUserPublicKey();
+      if (!userPublicKey) {
+        throw new Error('Phantom Connect: Provider failed to return a user public key.');
+      }
+      const caipAddress = `${this.currentCaipNetworkId}:${userPublicKey}`;
+      this.namespaces = {
+        [PhantomConnector.SUPPORTED_NAMESPACE]: {
+          accounts: [caipAddress],
+          methods: Object.values(SOLANA_SIGNING_METHODS),
+          events: [],
+          chains: [this.currentCaipNetworkId]
+        }
+      };
+      await this.saveSession(); // Save connector-specific session on successful connect
+
+      return this.namespaces;
+    } catch (error) {
+      this.clearSession();
+      throw error;
+    }
+  }
+  async disconnect() {
+    try {
+      if (this.isConnected()) {
+        await super.disconnect();
+      }
+    } catch (error) {
+      // console.warn(`PhantomConnector: Error during provider disconnect: ${error.message}. Proceeding with local clear.`);
+    }
+    await this.clearSession();
+  }
+  async clearSession() {
+    this.namespaces = undefined;
+    this.wallet = undefined;
+    this.currentCaipNetworkId = null;
+    await this.clearSessionStorage();
+  }
+  getProvider() {
+    if (!this.provider) {
+      throw new Error('Phantom Connector: Provider not initialized. Call init() first.');
+    }
+    return this.provider;
+  }
+  getStorage() {
+    if (!this.storage) {
+      throw new Error('Phantom Connector: Storage not initialized. Call init() first.');
+    }
+    return this.storage;
+  }
+  getNamespaces() {
+    if (!this.namespaces) {
+      throw new Error('Phantom Connector: Not connected. Call connect() first.');
+    }
+    return this.namespaces;
+  }
+  getChainId(namespace) {
+    if (namespace === PhantomConnector.SUPPORTED_NAMESPACE) {
+      return this.currentCaipNetworkId ?? undefined;
+    }
+    return undefined;
+  }
+  getProperties() {
+    return this.properties;
+  }
+  getWalletInfo() {
+    if (!this.isConnected()) {
+      return undefined;
+    }
+    return this.wallet;
+  }
+  isConnected() {
+    // Rely solely on the provider as the source of truth for connection status.
+    return this.getProvider().isConnected() && !!this.getProvider().getUserPublicKey();
+  }
+  async switchNetwork(network) {
+    const targetClusterName = Object.keys(SOLANA_CLUSTER_TO_CHAIN_ID_PART).find(key => SOLANA_CLUSTER_TO_CHAIN_ID_PART[key] === network.id);
+    if (!targetClusterName) {
+      throw new Error(`Cannot switch to unsupported network ID: ${network.id}`);
+    }
+    const currentClusterName = Object.keys(SOLANA_CLUSTER_TO_CHAIN_ID_PART).find(key => `solana:${SOLANA_CLUSTER_TO_CHAIN_ID_PART[key]}` === this.currentCaipNetworkId);
+    if (targetClusterName === currentClusterName && this.isConnected()) {
+      return Promise.resolve();
+    }
+
+    // Phantom doesn't provide a way to switch network, so we need to disconnect and reconnect.
+    await this.disconnect(); // Clear current session
+
+    // Create a temporary options object to guide the new connection
+    const tempConnectOpts = {
+      defaultChain: `solana:${SOLANA_CLUSTER_TO_CHAIN_ID_PART[targetClusterName]}`
+    };
+
+    // Attempt to connect to the new cluster
+    // The connect method will use the defaultChain from opts to determine the cluster.
+    await this.connect(tempConnectOpts);
+    this.getProvider().emit('chainChanged', network.id);
+
+    // Verify if the connection was successful and to the correct new network
+    if (!this.isConnected() || this.getChainId(PhantomConnector.SUPPORTED_NAMESPACE) !== tempConnectOpts.defaultChain) {
+      throw new Error(`Failed to switch network to ${targetClusterName}. Please try connecting manually.`);
+    }
+  }
+
+  // Orchestrates session restoration
+  async restoreSession() {
+    try {
+      const providerSession = await this.getProvider().restoreSession();
+      if (!providerSession) {
+        return false;
+      }
+
+      // If provider session is restored, try to restore connector data
+      const connectorData = await this.getStorage().getItem(PHANTOM_CONNECTOR_STORAGE_KEY);
+      if (!connectorData) {
+        return false; // Provider session exists but connector data is missing
+      }
+      this.namespaces = connectorData.namespaces;
+      this.wallet = connectorData.wallet;
+      this.currentCaipNetworkId = connectorData.currentCaipNetworkId;
+
+      // await this.initializeKeyPair();
+
+      // Final validation
+      if (this.isConnected()) {
+        return true;
+      }
+
+      // If validation fails, something is out of sync. Clear everything.
+      await this.disconnect();
+      return false;
+    } catch (error) {
+      // On any error, disconnect to ensure a clean state
+      await this.disconnect();
+      return false;
+    }
+  }
+
+  // Saves only connector-specific data
+  async saveSession() {
+    if (!this.namespaces || !this.wallet || !this.currentCaipNetworkId) {
+      return;
+    }
+    const connectorData = {
+      namespaces: this.namespaces,
+      wallet: this.wallet,
+      currentCaipNetworkId: this.currentCaipNetworkId
+    };
+    try {
+      await this.getStorage().setItem(PHANTOM_CONNECTOR_STORAGE_KEY, connectorData);
+    } catch (error) {
+      // console.error('PhantomConnector: Failed to save session.', error);
+    }
+  }
+
+  // Clears only connector-specific data from storage
+  async clearSessionStorage() {
+    try {
+      await this.getStorage().removeItem(PHANTOM_CONNECTOR_STORAGE_KEY);
+    } catch (error) {
+      // console.error('PhantomConnector: Failed to clear session from storage.', error);
+    }
+  }
+}
+//# sourceMappingURL=PhantomConnector.js.map

package/lib/module/connectors/PhantomConnector.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["WalletConnector","solana","solanaDevnet","solanaTestnet","ConstantsUtil","nacl","bs58","PhantomProvider","SOLANA_SIGNING_METHODS","SOLANA_CLUSTER_TO_CHAIN_ID_PART","id","PHANTOM_CONNECTOR_STORAGE_KEY","DAPP_KEYPAIR_STORAGE_KEY","PhantomConnector","currentCaipNetworkId","SUPPORTED_NAMESPACE","constructor","config","type","cluster","init","ops","storage","initializeKeyPair","appScheme","metadata","redirect","universal","native","Error","providerConfig","dappUrl","url","dappEncryptionKeyPair","provider","restoreSession","secretKeyB58","getStorage","getItem","secretKey","decode","box","keyPair","fromSecretKey","newKeyPair","setItem","encode","error","disconnect","connect","opts","isConnected","namespaces","defaultChain","split","chains","requestedCluster","Object","keys","find","key","connectResult","getProvider","solanaChainIdPart","wallet","PHANTOM_CUSTOM_WALLET","userPublicKey","getUserPublicKey","caipAddress","accounts","methods","values","events","saveSession","clearSession","undefined","clearSessionStorage","getNamespaces","getChainId","namespace","getProperties","properties","getWalletInfo","switchNetwork","network","targetClusterName","currentClusterName","Promise","resolve","tempConnectOpts","emit","providerSession","connectorData","removeItem"],"sourceRoot":"../../../src","sources":["connectors/PhantomConnector.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/helpers.js

@@ -0,0 +1,95 @@
+"use strict";
+
+/**
+ * Validates if the given string is a Solana address.
+ * @param address The string to validate.
+ * @returns True if the address is valid, false otherwise.
+ */
+export function isSolanaAddress(address) {
+  const solanaAddressRegex = /^[1-9A-HJ-NP-Za-km-z]{32,44}$/;
+  return solanaAddressRegex.test(address);
+}
+
+/**
+ * Helper to fetch SOL balance using JSON-RPC
+ * @param rpcUrl Solana RPC endpoint
+ * @param address Solana public address (base58)
+ */
+export async function getSolanaNativeBalance(rpcUrl, address) {
+  if (!isSolanaAddress(address)) {
+    throw new Error('Invalid Solana address format');
+  }
+  const response = await fetch(rpcUrl, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json'
+    },
+    body: JSON.stringify({
+      jsonrpc: '2.0',
+      id: 1,
+      method: 'getBalance',
+      params: [address]
+    })
+  });
+  const json = await response.json();
+  if (json.error) throw new Error(json.error.message);
+  return json.result.value / 1000000000; // Convert lamports to SOL
+}
+let tokenCache = {};
+
+/**
+ * Fetch metadata for a Solana SPL token using the Jupiter token list.
+ * @param mint - The token's mint address
+ * @returns TokenInfo if found, or undefined
+ */
+export async function getSolanaTokenMetadata(mint) {
+  // Return from cache if available
+  if (tokenCache[mint]) return tokenCache[mint];
+  try {
+    const res = await fetch('https://token.jup.ag/all');
+    const list = await res.json();
+    for (const token of list) {
+      tokenCache[token.address] = token;
+    }
+    return tokenCache[mint];
+  } catch (error) {
+    return undefined;
+  }
+}
+
+/**
+ * Get the balance of a token for a given address
+ * @param rpcUrl - The RPC URL to use
+ * @param address - The address to get the balance for
+ * @param tokenAddress - The address of the token to get the balance for
+ * @returns The balance of the token for the given address
+ */
+export async function getSolanaTokenBalance(rpcUrl, address, tokenAddress) {
+  if (!isSolanaAddress(address)) {
+    throw new Error('Invalid Solana address format');
+  }
+  const token = await getSolanaTokenMetadata(tokenAddress);
+  const response = await fetch(rpcUrl, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json'
+    },
+    body: JSON.stringify({
+      jsonrpc: '2.0',
+      id: 1,
+      method: 'getTokenAccountsByOwner',
+      params: [address, {
+        mint: tokenAddress
+      }, {
+        encoding: 'jsonParsed'
+      }]
+    })
+  });
+  const result = await response.json();
+  const balance = result.result.value[0]?.account?.data?.parsed?.info?.tokenAmount?.uiAmount;
+  return {
+    amount: balance?.toString() ?? '0',
+    symbol: token?.symbol ?? 'SOL'
+  };
+}
+//# sourceMappingURL=helpers.js.map

package/lib/module/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isSolanaAddress","address","solanaAddressRegex","test","getSolanaNativeBalance","rpcUrl","Error","response","fetch","method","headers","body","JSON","stringify","jsonrpc","id","params","json","error","message","result","value","tokenCache","getSolanaTokenMetadata","mint","res","list","token","undefined","getSolanaTokenBalance","tokenAddress","encoding","balance","account","data","parsed","info","tokenAmount","uiAmount","amount","toString","symbol"],"sourceRoot":"../../src","sources":["helpers.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/index.js

@@ -0,0 +1,10 @@
+"use strict";
+
+// Adapter
+export { SolanaAdapter } from './adapter';
+
+// Types
+
+// Connectors
+export { PhantomConnector } from './connectors/PhantomConnector';
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["SolanaAdapter","PhantomConnector"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA;AACA,SAASA,aAAa,QAAQ,WAAW;;AAEzC;;AAGA;AACA,SAASC,gBAAgB,QAAQ,+BAA+B","ignoreList":[]}