@solana/client 0.1.3 → 0.2.0

package/dist/index.browser.cjs

@@ -7,14 +7,44 @@ var system = require('@solana-program/system');
 var token = require('@solana-program/token');
 var computeBudget = require('@solana-program/compute-budget');
 var vanilla = require('zustand/vanilla');
-var transactions = require('@solana/transactions');
-var walletStandardFeatures = require('@solana/wallet-standard-features');
 var app = require('@wallet-standard/app');
 var features = require('@wallet-standard/features');
+var transactions = require('@solana/transactions');
+var walletStandardFeatures = require('@solana/wallet-standard-features');
 
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 
+// src/actions.ts
+function connectWallet(client, params) {
+  return client.actions.connectWallet(params.connectorId, params.options);
+}
+__name(connectWallet, "connectWallet");
+function disconnectWallet(client, _params) {
+  return client.actions.disconnectWallet();
+}
+__name(disconnectWallet, "disconnectWallet");
+function fetchAccount(client, params) {
+  return client.actions.fetchAccount(params.address, params.commitment);
+}
+__name(fetchAccount, "fetchAccount");
+function fetchBalance(client, params) {
+  return client.actions.fetchBalance(params.address, params.commitment);
+}
+__name(fetchBalance, "fetchBalance");
+function requestAirdrop(client, params) {
+  return client.actions.requestAirdrop(params.address, params.lamports);
+}
+__name(requestAirdrop, "requestAirdrop");
+function sendTransaction(client, params) {
+  return client.actions.sendTransaction(params.transaction, params.commitment);
+}
+__name(sendTransaction, "sendTransaction");
+function setCluster(client, params) {
+  return client.actions.setCluster(params.endpoint, params.config);
+}
+__name(setCluster, "setCluster");
+
 // src/utils.ts
 function deepFreeze(value) {
   if (typeof value !== "object" || value === null) {
@@ -165,6 +195,94 @@ function createSolanaRpcClient(config) {
 }
 __name(createSolanaRpcClient, "createSolanaRpcClient");
 
+// src/serialization/state.ts
+var SERIALIZABLE_STATE_VERSION = 1;
+function getInitialSerializableState(config) {
+  return {
+    autoconnect: false,
+    commitment: config.commitment,
+    endpoint: config.endpoint,
+    lastConnectorId: null,
+    lastPublicKey: null,
+    version: SERIALIZABLE_STATE_VERSION,
+    websocketEndpoint: config.websocketEndpoint
+  };
+}
+__name(getInitialSerializableState, "getInitialSerializableState");
+function applySerializableState(config, state) {
+  if (!state) {
+    return config;
+  }
+  return {
+    ...config,
+    commitment: state.commitment ?? config.commitment,
+    endpoint: state.endpoint ?? config.endpoint,
+    websocketEndpoint: state.websocketEndpoint ?? config.websocketEndpoint
+  };
+}
+__name(applySerializableState, "applySerializableState");
+function serializeSolanaState(state) {
+  return JSON.stringify(state);
+}
+__name(serializeSolanaState, "serializeSolanaState");
+function deserializeSolanaState(json) {
+  if (!json) return null;
+  try {
+    const parsed = JSON.parse(json);
+    if (typeof parsed !== "object" || parsed === null) return null;
+    const state = parsed;
+    return {
+      autoconnect: state.autoconnect ?? false,
+      commitment: state.commitment,
+      endpoint: state.endpoint,
+      lastConnectorId: state.lastConnectorId ?? null,
+      lastPublicKey: state.lastPublicKey ?? null,
+      version: state.version ?? SERIALIZABLE_STATE_VERSION,
+      websocketEndpoint: state.websocketEndpoint
+    };
+  } catch {
+    return null;
+  }
+}
+__name(deserializeSolanaState, "deserializeSolanaState");
+function getSerializableStateSnapshot(client) {
+  const state = client.store.getState();
+  const wallet = state.wallet;
+  let lastConnectorId = null;
+  let lastPublicKey = null;
+  if ("connectorId" in wallet) {
+    lastConnectorId = wallet.connectorId ?? null;
+    if (wallet.status === "connected") {
+      lastPublicKey = wallet.session.account.address.toString();
+    }
+  }
+  return {
+    autoconnect: false,
+    commitment: state.cluster.commitment,
+    endpoint: state.cluster.endpoint,
+    lastConnectorId,
+    lastPublicKey,
+    version: SERIALIZABLE_STATE_VERSION,
+    websocketEndpoint: state.cluster.websocketEndpoint
+  };
+}
+__name(getSerializableStateSnapshot, "getSerializableStateSnapshot");
+function subscribeSolanaState(client, listener) {
+  let previous = serializeSolanaState(getSerializableStateSnapshot(client));
+  listener(JSON.parse(previous));
+  const unsubscribe = client.store.subscribe(() => {
+    const snapshot = getSerializableStateSnapshot(client);
+    const serialized = serializeSolanaState(snapshot);
+    if (serialized === previous) {
+      return;
+    }
+    previous = serialized;
+    listener(snapshot);
+  });
+  return unsubscribe;
+}
+__name(subscribeSolanaState, "subscribeSolanaState");
+
 // src/wallet/registry.ts
 function createWalletRegistry(connectors) {
   const byId = /* @__PURE__ */ new Map();
@@ -216,7 +334,7 @@ function createActions({ connectors, logger: inputLogger, runtime, store }) {
     }
   }
   __name(warmupCluster, "warmupCluster");
-  async function setCluster(endpoint, config) {
+  async function setCluster2(endpoint, config) {
     const nextCommitment = config?.commitment ?? store.getState().cluster.commitment;
     const websocketEndpoint = config?.websocketEndpoint ?? endpoint;
     store.setState((state) => ({
@@ -267,8 +385,8 @@ function createActions({ connectors, logger: inputLogger, runtime, store }) {
       throw error;
     }
   }
-  __name(setCluster, "setCluster");
-  async function connectWallet(connectorId, options = {}) {
+  __name(setCluster2, "setCluster");
+  async function connectWallet2(connectorId, options = {}) {
     const connector = connectors.get(connectorId);
     if (!connector) {
       throw new Error(`No wallet connector registered for id "${connectorId}".`);
@@ -307,8 +425,8 @@ function createActions({ connectors, logger: inputLogger, runtime, store }) {
       throw error;
     }
   }
-  __name(connectWallet, "connectWallet");
-  async function disconnectWallet2() {
+  __name(connectWallet2, "connectWallet");
+  async function disconnectWallet3() {
     const wallet = store.getState().wallet;
     if (wallet.status === "disconnected") {
       return;
@@ -330,8 +448,8 @@ function createActions({ connectors, logger: inputLogger, runtime, store }) {
       updateState(store, { wallet: { status: "disconnected" } });
     }
   }
-  __name(disconnectWallet2, "disconnectWallet");
-  async function fetchBalance(address4, commitment) {
+  __name(disconnectWallet3, "disconnectWallet");
+  async function fetchBalance2(address4, commitment) {
     const key = address4.toString();
     store.setState((state) => ({
       ...state,
@@ -394,8 +512,8 @@ function createActions({ connectors, logger: inputLogger, runtime, store }) {
       throw error;
     }
   }
-  __name(fetchBalance, "fetchBalance");
-  async function fetchAccount(address4, commitment) {
+  __name(fetchBalance2, "fetchBalance");
+  async function fetchAccount2(address4, commitment) {
     const key = address4.toString();
     store.setState((state) => ({
       ...state,
@@ -459,8 +577,8 @@ function createActions({ connectors, logger: inputLogger, runtime, store }) {
       throw error;
     }
   }
-  __name(fetchAccount, "fetchAccount");
-  async function sendTransaction(transaction, commitment) {
+  __name(fetchAccount2, "fetchAccount");
+  async function sendTransaction2(transaction, commitment) {
     const targetCommitment = getCommitment(commitment);
     const abortController = new AbortController();
     const signature4 = await runtime.rpc.sendTransaction(kit.getBase64EncodedWireTransaction(transaction), {
@@ -531,8 +649,8 @@ function createActions({ connectors, logger: inputLogger, runtime, store }) {
       throw error;
     }
   }
-  __name(sendTransaction, "sendTransaction");
-  async function requestAirdrop(address4, lamports2) {
+  __name(sendTransaction2, "sendTransaction");
+  async function requestAirdrop2(address4, lamports2) {
     try {
       const factory = kit.airdropFactory({
         rpc: runtime.rpc,
@@ -558,15 +676,15 @@ function createActions({ connectors, logger: inputLogger, runtime, store }) {
       throw error;
     }
   }
-  __name(requestAirdrop, "requestAirdrop");
+  __name(requestAirdrop2, "requestAirdrop");
   return {
-    connectWallet,
-    disconnectWallet: disconnectWallet2,
-    fetchAccount,
-    fetchBalance,
-    requestAirdrop,
-    sendTransaction,
-    setCluster
+    connectWallet: connectWallet2,
+    disconnectWallet: disconnectWallet3,
+    fetchAccount: fetchAccount2,
+    fetchBalance: fetchBalance2,
+    requestAirdrop: requestAirdrop2,
+    sendTransaction: sendTransaction2,
+    setCluster: setCluster2
   };
 }
 __name(createActions, "createActions");
@@ -1000,13 +1118,13 @@ function createWalletTransactionSigner(session, config = {}) {
   }
   if (session.sendTransaction) {
     const base58Encoder = codecsStrings.getBase58Encoder();
-    const sendTransaction = session.sendTransaction.bind(session);
+    const sendTransaction2 = session.sendTransaction.bind(session);
     const sendingSigner = Object.freeze({
       address: address4,
       async signAndSendTransactions(transactions) {
         const signatures = [];
         for (const transaction of transactions) {
-          const signatureString = await sendTransaction(
+          const signatureString = await sendTransaction2(
             transaction,
             commitment ? { commitment } : void 0
           );
@@ -1192,7 +1310,7 @@ function createSplTokenHelper(runtime, config) {
     return ata;
   }
   __name(deriveAssociatedTokenAddress, "deriveAssociatedTokenAddress");
-  async function fetchBalance(owner, commitment) {
+  async function fetchBalance2(owner, commitment) {
     const ataAddress = await deriveAssociatedTokenAddress(owner);
     const decimals = await resolveDecimals(commitment);
     try {
@@ -1217,7 +1335,7 @@ function createSplTokenHelper(runtime, config) {
       };
     }
   }
-  __name(fetchBalance, "fetchBalance");
+  __name(fetchBalance2, "fetchBalance");
   async function prepareTransfer(config2) {
     const commitment = config2.commitment;
     const lifetime = await resolveLifetime2(runtime, commitment, config2.lifetime);
@@ -1334,7 +1452,7 @@ function createSplTokenHelper(runtime, config) {
   __name(sendTransfer, "sendTransfer");
   return {
     deriveAssociatedTokenAddress,
-    fetchBalance,
+    fetchBalance: fetchBalance2,
     prepareTransfer,
     sendPreparedTransfer,
     sendTransfer
@@ -2012,25 +2130,26 @@ __name(createWatchers, "createWatchers");
 
 // src/client/createClient.ts
 function createClient(config) {
-  const commitment = config.commitment ?? "confirmed";
-  const websocketEndpoint = config.websocketEndpoint ?? config.endpoint;
+  const hydratedConfig = config.initialState ? applySerializableState(config, config.initialState) : config;
+  const commitment = hydratedConfig.commitment ?? "confirmed";
+  const websocketEndpoint = hydratedConfig.websocketEndpoint ?? hydratedConfig.endpoint;
   const initialState = createInitialClientState({
     commitment,
-    endpoint: config.endpoint,
+    endpoint: hydratedConfig.endpoint,
     websocketEndpoint
   });
   const store = config.createStore ? config.createStore(initialState) : createClientStore(initialState);
-  const rpcClient = config.rpcClient ?? createSolanaRpcClient({
+  const rpcClient = hydratedConfig.rpcClient ?? createSolanaRpcClient({
     commitment,
-    endpoint: config.endpoint,
+    endpoint: hydratedConfig.endpoint,
     websocketEndpoint
   });
   const runtime = {
     rpc: rpcClient.rpc,
     rpcSubscriptions: rpcClient.rpcSubscriptions
   };
-  const connectors = createWalletRegistry(config.walletConnectors ?? []);
-  const logger = createLogger(config.logger);
+  const connectors = createWalletRegistry(hydratedConfig.walletConnectors ?? []);
+  const logger = createLogger(hydratedConfig.logger);
   const actions = createActions({ connectors, logger, runtime, store });
   const watchers = createWatchers({ logger, runtime, store });
   const helpers = createClientHelpers(runtime, store);
@@ -2042,7 +2161,7 @@ function createClient(config) {
     },
     lastUpdatedAt: now()
   }));
-  actions.setCluster(config.endpoint, { commitment, websocketEndpoint }).catch(
+  actions.setCluster(hydratedConfig.endpoint, { commitment, websocketEndpoint }).catch(
     (error) => logger({
       data: formatError(error),
       level: "error",
@@ -2246,33 +2365,6 @@ function lamportsFromJson(value) {
   return lamports(value, "lamports");
 }
 __name(lamportsFromJson, "lamportsFromJson");
-
-// src/serialization/state.ts
-var SERIALIZABLE_STATE_VERSION = 1;
-function getInitialSerializableState(config) {
-  return {
-    autoconnect: false,
-    commitment: config.commitment,
-    endpoint: config.endpoint,
-    lastConnectorId: null,
-    lastPublicKey: null,
-    version: SERIALIZABLE_STATE_VERSION,
-    websocketEndpoint: config.websocketEndpoint
-  };
-}
-__name(getInitialSerializableState, "getInitialSerializableState");
-function applySerializableState(config, state) {
-  if (!state) {
-    return config;
-  }
-  return {
-    ...config,
-    commitment: state.commitment ?? config.commitment,
-    endpoint: state.endpoint ?? config.endpoint,
-    websocketEndpoint: state.websocketEndpoint ?? config.websocketEndpoint
-  };
-}
-__name(applySerializableState, "applySerializableState");
 var COMMITMENT_PRIORITY = {
   processed: 0,
   confirmed: 1,
@@ -2685,13 +2777,13 @@ function getChain(account) {
   return preferred;
 }
 __name(getChain, "getChain");
-async function disconnectWallet(wallet) {
+async function disconnectWallet2(wallet) {
   const disconnectFeature = wallet.features[features.StandardDisconnect];
   if (disconnectFeature) {
     await disconnectFeature.disconnect();
   }
 }
-__name(disconnectWallet, "disconnectWallet");
+__name(disconnectWallet2, "disconnectWallet");
 function createWalletStandardConnector(wallet, options = {}) {
   const metadata = {
     canAutoConnect: options.canAutoConnect ?? Boolean(wallet.features[features.StandardConnect]),
@@ -2739,7 +2831,7 @@ function createWalletStandardConnector(wallet, options = {}) {
       const [output] = await signTransactionFeature.signTransaction(request);
       return transactionDecoder.decode(output.signedTransaction);
     } : void 0;
-    const sendTransaction = signAndSendFeature ? async (transaction, config) => {
+    const sendTransaction2 = signAndSendFeature ? async (transaction, config) => {
       const wireBytes = new Uint8Array(transactionEncoder.encode(transaction));
       const chain = options.defaultChain ?? getChain(primaryAccount) ?? "solana:mainnet-beta";
       const [output] = await signAndSendFeature.signAndSendTransaction({
@@ -2753,21 +2845,21 @@ function createWalletStandardConnector(wallet, options = {}) {
       return base58Decoder.decode(output.signature);
     } : void 0;
     async function disconnectSession() {
-      await disconnectWallet(wallet);
+      await disconnectWallet2(wallet);
     }
     __name(disconnectSession, "disconnectSession");
     return {
       account: sessionAccount,
       connector: metadata,
       disconnect: disconnectSession,
-      sendTransaction,
+      sendTransaction: sendTransaction2,
       signMessage,
       signTransaction
     };
   }
   __name(connect, "connect");
   async function disconnect() {
-    await disconnectWallet(wallet);
+    await disconnectWallet2(wallet);
   }
   __name(disconnect, "disconnect");
   function isSupported() {
@@ -2823,12 +2915,78 @@ function watchWalletStandardConnectors(onChange, options = {}) {
 }
 __name(watchWalletStandardConnectors, "watchWalletStandardConnectors");
 
+// src/wallet/connectors.ts
+function autoDiscover(options = {}) {
+  const { get } = app.getWallets();
+  const wallets = get().filter((wallet) => options.filter ? options.filter(wallet) : true);
+  const connectors = wallets.map((wallet) => createWalletStandardConnector(wallet, options.overrides?.(wallet)));
+  const seen = /* @__PURE__ */ new Set();
+  return connectors.filter((connector) => {
+    if (seen.has(connector.id)) return false;
+    seen.add(connector.id);
+    return true;
+  });
+}
+__name(autoDiscover, "autoDiscover");
+function injected(options) {
+  const connector = {
+    canAutoConnect: true,
+    id: "wallet-standard:injected",
+    kind: "wallet-standard",
+    name: "Injected Wallet",
+    ready: typeof window !== "undefined",
+    async connect() {
+      const wallets = app.getWallets().get();
+      const first = wallets.find((wallet) => features.StandardConnect in wallet.features);
+      if (!first) {
+        throw new Error("No Wallet Standard wallets available.");
+      }
+      return createWalletStandardConnector(first, options).connect();
+    },
+    async disconnect() {
+    },
+    isSupported() {
+      return typeof window !== "undefined";
+    }
+  };
+  return connector;
+}
+__name(injected, "injected");
+function filterByName(name) {
+  const lower = name.toLowerCase();
+  return (wallet) => wallet.name.toLowerCase().includes(lower);
+}
+__name(filterByName, "filterByName");
+function phantom(options) {
+  return autoDiscover({
+    filter: filterByName("phantom"),
+    overrides: /* @__PURE__ */ __name(() => ({ ...options, id: "wallet-standard:phantom" }), "overrides")
+  });
+}
+__name(phantom, "phantom");
+function solflare(options) {
+  return autoDiscover({
+    filter: filterByName("solflare"),
+    overrides: /* @__PURE__ */ __name(() => ({ ...options, id: "wallet-standard:solflare" }), "overrides")
+  });
+}
+__name(solflare, "solflare");
+function backpack(options) {
+  return autoDiscover({
+    filter: filterByName("backpack"),
+    overrides: /* @__PURE__ */ __name(() => ({ ...options, id: "wallet-standard:backpack" }), "overrides")
+  });
+}
+__name(backpack, "backpack");
+
 exports.LAMPORTS_PER_SOL = LAMPORTS_PER_SOL;
 exports.SIGNATURE_STATUS_TIMEOUT_MS = SIGNATURE_STATUS_TIMEOUT_MS;
 exports.applyRatio = applyRatio;
 exports.applySerializableState = applySerializableState;
 exports.assertDecimals = assertDecimals;
 exports.assertNonNegative = assertNonNegative;
+exports.autoDiscover = autoDiscover;
+exports.backpack = backpack;
 exports.bigintFromJson = bigintFromJson;
 exports.bigintToJson = bigintToJson;
 exports.checkedAdd = checkedAdd;
@@ -2836,6 +2994,7 @@ exports.checkedDivide = checkedDivide;
 exports.checkedMultiply = checkedMultiply;
 exports.checkedSubtract = checkedSubtract;
 exports.confirmationMeetsCommitment = confirmationMeetsCommitment;
+exports.connectWallet = connectWallet;
 exports.createAsyncState = createAsyncState;
 exports.createClient = createClient;
 exports.createClientStore = createClientStore;
@@ -2855,8 +3014,13 @@ exports.createTransactionRecipe = createTransactionRecipe;
 exports.createWalletRegistry = createWalletRegistry;
 exports.createWalletStandardConnector = createWalletStandardConnector;
 exports.deriveConfirmationStatus = deriveConfirmationStatus;
+exports.deserializeSolanaState = deserializeSolanaState;
+exports.disconnectWallet = disconnectWallet;
+exports.fetchAccount = fetchAccount;
+exports.fetchBalance = fetchBalance;
 exports.getInitialSerializableState = getInitialSerializableState;
 exports.getWalletStandardConnectors = getWalletStandardConnectors;
+exports.injected = injected;
 exports.insertReferenceKey = insertReferenceKey;
 exports.insertReferenceKeys = insertReferenceKeys;
 exports.lamports = lamports;
@@ -2866,10 +3030,17 @@ exports.lamportsMath = lamportsMath;
 exports.lamportsToJson = lamportsToJson;
 exports.lamportsToSolString = lamportsToSolString;
 exports.normalizeSignature = normalizeSignature;
+exports.phantom = phantom;
 exports.pow10 = pow10;
 exports.prepareTransaction = prepareTransaction;
+exports.requestAirdrop = requestAirdrop;
 exports.resolveCluster = resolveCluster;
+exports.sendTransaction = sendTransaction;
+exports.serializeSolanaState = serializeSolanaState;
+exports.setCluster = setCluster;
+exports.solflare = solflare;
 exports.stableStringify = stableStringify;
+exports.subscribeSolanaState = subscribeSolanaState;
 exports.toAddress = toAddress2;
 exports.toAddressString = toAddressString;
 exports.toBigint = toBigint2;