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

package/lib/typescript/types.d.ts

@@ -0,0 +1,96 @@
+import type { CaipNetworkId, Namespaces, Storage, WalletInfo } from '@reown/appkit-common-react-native';
+import type nacl from 'tweetnacl';
+export interface TokenInfo {
+    address: string;
+    symbol: string;
+    name: string;
+    decimals: number;
+    logoURI?: string;
+}
+export type PhantomCluster = 'mainnet-beta' | 'testnet' | 'devnet';
+export interface PhantomProviderConfig {
+    appScheme: string;
+    dappUrl: string;
+    storage: Storage;
+    dappEncryptionKeyPair: nacl.BoxKeyPair;
+}
+export type PhantomConnectResult = PhantomSession;
+export interface PhantomSession {
+    sessionToken: string;
+    userPublicKey: string;
+    phantomEncryptionPublicKeyBs58: string;
+    cluster: PhantomCluster;
+}
+export interface SignTransactionRequestParams {
+    transaction: string;
+}
+export interface SignMessageRequestParams {
+    message: Uint8Array | string;
+    display?: 'utf8' | 'hex';
+}
+export interface SignAllTransactionsRequestParams {
+    transactions: string[];
+}
+export interface PhantomDeeplinkResponse {
+    phantom_encryption_public_key?: string;
+    nonce: string;
+    data: string;
+}
+export interface DecryptedConnectData {
+    public_key: string;
+    session: string;
+}
+export interface PhantomProviderConfig {
+    appScheme: string;
+    dappUrl: string;
+    storage: Storage;
+    dappEncryptionKeyPair: nacl.BoxKeyPair;
+}
+export interface PhantomSession {
+    sessionToken: string;
+    userPublicKey: string;
+    phantomEncryptionPublicKeyBs58: string;
+    cluster: PhantomCluster;
+}
+export type PhantomRpcMethod = 'connect' | 'disconnect' | 'signTransaction' | 'signAndSendTransaction' | 'signAllTransactions' | 'signMessage';
+export interface PhantomSignTransactionParams {
+    dapp_encryption_public_key: string;
+    redirect_link: string;
+    payload: string;
+    nonce: string;
+    cluster?: PhantomCluster;
+}
+export interface PhantomSignAllTransactionsParams {
+    dapp_encryption_public_key: string;
+    redirect_link: string;
+    payload: string;
+    nonce: string;
+    cluster?: PhantomCluster;
+}
+export interface PhantomSignMessageParams {
+    dapp_encryption_public_key: string;
+    redirect_link: string;
+    payload: string;
+    nonce: string;
+}
+export interface PhantomConnectParams {
+    app_url: string;
+    dapp_encryption_public_key: string;
+    redirect_link: string;
+    cluster?: PhantomCluster;
+}
+export interface PhantomDisconnectParams {
+    dapp_encryption_public_key: string;
+    redirect_link: string;
+    payload: string;
+    nonce: string;
+}
+export interface PhantomConnectorConfig {
+    cluster?: PhantomCluster;
+}
+export interface PhantomConnectorSessionData {
+    namespaces: Namespaces;
+    wallet: WalletInfo;
+    currentCaipNetworkId: CaipNetworkId;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/lib/typescript/utils/createSendTransaction.d.ts

@@ -0,0 +1,10 @@
+import { type Connection, Transaction } from '@solana/web3.js';
+type SendTransactionArgs = {
+    connection: Connection;
+    fromAddress: string;
+    toAddress: string;
+    value: number;
+};
+export declare function createSendTransaction({ fromAddress, toAddress, value, connection }: SendTransactionArgs): Promise<Transaction>;
+export {};
+//# sourceMappingURL=createSendTransaction.d.ts.map

package/lib/typescript/utils/createSendTransaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createSendTransaction.d.ts","sourceRoot":"","sources":["../../../src/utils/createSendTransaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,UAAU,EAIf,WAAW,EACZ,MAAM,iBAAiB,CAAC;AAIzB,KAAK,mBAAmB,GAAG;IACzB,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAWF,wBAAsB,qBAAqB,CAAC,EAC1C,WAAW,EACX,SAAS,EACT,KAAK,EACL,UAAU,EACX,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC,CAwB5C"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@reown/appkit-solana-react-native",
+  "version": "0.0.0-chore-bump-builder-20250728194329",
+  "main": "lib/commonjs/index.js",
+  "types": "lib/typescript/index.d.ts",
+  "module": "lib/module/index.js",
+  "react-native": "src/index.ts",
+  "source": "src/index.ts",
+  "scripts": {
+    "build": "bob build",
+    "clean": "rm -rf lib",
+    "lint": "eslint . --ext .js,.jsx,.ts,.tsx"
+  },
+  "files": [
+    "src",
+    "lib",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__"
+  ],
+  "keywords": [
+    "web3",
+    "crypto",
+    "solana",
+    "appkit",
+    "reown",
+    "walletconnect",
+    "react-native"
+  ],
+  "repository": "https://github.com/reown-com/appkit-react-native",
+  "author": "Reown (https://discord.gg/reown)",
+  "homepage": "https://reown.com/appkit",
+  "license": "Apache-2.0",
+  "bugs": {
+    "url": "https://github.com/reown-com/appkit-react-native/issues"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "dependencies": {
+    "@reown/appkit-common-react-native": "0.0.0-chore-bump-builder-20250728194329",
+    "@solana/web3.js": "1.98.2",
+    "bs58": "6.0.0",
+    "tweetnacl": "1.0.3"
+  },
+  "peerDependencies": {
+    "@walletconnect/react-native-compat": ">=2.16.1",
+    "react": ">=18",
+    "react-native": ">=0.72"
+  }
+}

package/readme.md

@@ -0,0 +1,9 @@
+#### 📚 [Documentation](https://docs.reown.com/appkit/react-native/core/installation)
+
+#### 🔎 [Examples](https://github.com/reown-com/react-native-examples)
+
+#### 🔗 [Website](https://reown.com/appkit)
+
+# AppKit
+
+Your on-ramp to web3 multichain. AppKit is a versatile library that makes it super easy to connect users with your Dapp and start interacting with the blockchain.

package/src/adapter.ts

@@ -0,0 +1,248 @@
+import {
+  SolanaBaseAdapter,
+  type AppKitNetwork,
+  type CaipAddress,
+  type ChainNamespace,
+  type GetBalanceParams,
+  type GetBalanceResponse
+} 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 interface SolanaTransactionData {
+  fromAddress: string;
+  toAddress: string;
+  amount: number;
+  network?: AppKitNetwork;
+  rpcUrl?: string;
+}
+
+export class SolanaAdapter extends SolanaBaseAdapter {
+  private static supportedNamespace: ChainNamespace = 'solana';
+
+  constructor(configParams: { projectId: string }) {
+    super({
+      projectId: configParams.projectId,
+      supportedNamespace: SolanaAdapter.supportedNamespace,
+      adapterType: 'solana'
+    });
+  }
+
+  async getBalance(params: GetBalanceParams): Promise<GetBalanceResponse> {
+    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<T extends Transaction | VersionedTransaction>(
+    transaction: T,
+    network?: AppKitNetwork
+  ): Promise<T> {
+    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
+      )) as { signature?: string; transaction?: string };
+
+      // 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) as Buffer & Uint8Array
+          );
+        }
+
+        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)) as T;
+        }
+
+        return Transaction.from(decodedTransaction) as T;
+      }
+
+      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: SolanaTransactionData): Promise<string | null> {
+    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: AppKitNetwork): Promise<void> {
+    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: any) {
+      throw switchError;
+    }
+  }
+
+  getAccounts(): CaipAddress[] | undefined {
+    if (!this.connector) throw new Error('No active connector');
+    const namespaces = this.connector.getNamespaces();
+
+    return namespaces[this.getSupportedNamespace()]?.accounts;
+  }
+
+  disconnect(): Promise<void> {
+    if (!this.connector) throw new Error('No active connector');
+
+    return this.connector.disconnect();
+  }
+
+  getSupportedNamespace(): ChainNamespace {
+    return SolanaAdapter.supportedNamespace;
+  }
+}