@coinbase/cdp-solana-standard-wallet 0.0.97 → 0.0.99

package/dist/esm/index3.js

@@ -1,4 +1,4 @@
-const o = "0.0.97";
+const o = "0.0.99";
 export {
   o as VERSION
 };

package/dist/types/index.d.ts

@@ -15,37 +15,178 @@ export declare const CDP_SOLANA_WALLET_STANDARD_VERSION: "1.0.0";
 
 export declare const CDP_STANDARD_SOLANA_WALLET_FEATURES: readonly ["solana:signAndSendTransaction", "solana:signTransaction", "solana:signMessage"];
 
+/**
+ * Custom feature to distinguish CDP Solana Wallet from other standard Solana wallets.
+ *
+ * This feature flag allows dapps to identify CDP wallets specifically.
+ */
 export declare type CdpFeature = {
     "cdp:": true;
 };
 
+/**
+ * Supported Solana chains for CDP wallets.
+ *
+ * Union type of supported Solana chain identifiers.
+ */
 export declare type CdpSolanaChain = (typeof CDP_SOLANA_CHAINS)[number];
 
+/**
+ * CDP Solana Wallet implementation for the Wallet Standard.
+ *
+ * This wallet integrates CDP's embedded Solana accounts with the wallet standard ecosystem,
+ * allowing dapps to interact with CDP wallets through standardized interfaces.
+ */
 export declare class CdpSolanaWallet implements Wallet {
     #private;
+    /**
+     * Create a new CDP Solana Wallet instance.
+     *
+     * @param solanaAddresses - Array of Solana addresses (base58 encoded)
+     */
     constructor(solanaAddresses: string[]);
+    /**
+     * Get the wallet name.
+     *
+     * @returns The wallet name
+     */
     get name(): "CDP Solana Wallet";
+    /**
+     * Get the wallet icon.
+     *
+     * @returns The wallet icon as base64 data URI
+     */
     get icon(): "data:image/svg+xml;base64,PHN2ZyBmaWxsPSJub25lIiBoZWlnaHQ9Ijg4IiB2aWV3Qm94PSIwIDAgMTAxIDg4IiB3aWR0aD0iMTAxIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHhtbG5zOnhsaW5rPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5L3hsaW5rIj48bGluZWFyR3JhZGllbnQgaWQ9ImEiIGdyYWRpZW50VW5pdHM9InVzZXJTcGFjZU9uVXNlIiB4MT0iOC41MjU1OCIgeDI9Ijg4Ljk5MzMiIHkxPSI5MC4wOTczIiB5Mj0iLTMuMDE2MjIiPjxzdG9wIG9mZnNldD0iLjA4IiBzdG9wLWNvbG9yPSIjOTk0NWZmIi8+PHN0b3Agb2Zmc2V0PSIuMyIgc3RvcC1jb2xvcj0iIzg3NTJmMyIvPjxzdG9wIG9mZnNldD0iLjUiIHN0b3AtY29sb3I9IiM1NDk3ZDUiLz48c3RvcCBvZmZzZXQ9Ii42IiBzdG9wLWNvbG9yPSIjNDNiNGNhIi8+PHN0b3Agb2Zmc2V0PSIuNzIiIHN0b3AtY29sb3I9IiMyOGUwYjkiLz48c3RvcCBvZmZzZXQ9Ii45NyIgc3RvcC1jb2xvcj0iIzE5ZmI5YiIvPjwvbGluZWFyR3JhZGllbnQ+PHBhdGggZD0ibTEwMC40OCA2OS4zODE3LTE2LjY3MzIgMTcuNDE5OGMtLjM2MjQuMzc4NC0uODAxLjY4MDEtMS4yODgzLjg4NjNzLTEuMDEzLjMxMjUtMS41NDQyLjMxMjJoLTc5LjAzODY3Yy0uMzc3MTQgMC0uNzQ2MDYtLjEwNzQtMS4wNjE0MjgtLjMwODgtLjMxNTM3My0uMjAxNS0uNTYzNDYyLS40ODgzLS43MTM3ODYtLjgyNTMtLjE1MDMyMzctLjMzNjktLjE5NjMzNDEtLjcwOTMtLjEzMjM3NzgtMS4wNzE0LjA2Mzk1NjItLjM2MjEuMjM1MDkyOC0uNjk4MS40OTIzODM4LS45NjY3bDE2LjY4NTY3OC0xNy40MTk4Yy4zNjE1LS4zNzc0Ljc5ODYtLjY3ODUgMS4yODQzLS44ODQ2LjQ4NTgtLjIwNjIgMS4wMDk4LS4zMTMgMS41Mzk3LS4zMTM5aDc5LjAzNDNjLjM3NzEgMCAuNzQ2LjEwNzQgMS4wNjE2LjMwODguMzE1LjIwMTUuNTYzLjQ4ODQuNzE0LjgyNTMuMTUuMzM3LjE5Ni43MDkzLjEzMiAxLjA3MTRzLS4yMzUuNjk4MS0uNDkyLjk2Njd6bS0xNi42NzMyLTM1LjA3ODVjLS4zNjI0LS4zNzg0LS44MDEtLjY4MDEtMS4yODgzLS44ODYzLS40ODczLS4yMDYxLTEuMDEzLS4zMTI0LTEuNTQ0Mi0uMzEyMWgtNzkuMDM4NjdjLS4zNzcxNCAwLS43NDYwNi4xMDczLTEuMDYxNDI4LjMwODgtLjMxNTM3My4yMDE1LS41NjM0NjIuNDg4My0uNzEzNzg2LjgyNTItLjE1MDMyMzcuMzM3LS4xOTYzMzQxLjcwOTQtLjEzMjM3NzggMS4wNzE1LjA2Mzk1NjIuMzYyLjIzNTA5MjguNjk4LjQ5MjM4MzguOTY2N2wxNi42ODU2NzggMTcuNDE5OGMuMzYxNS4zNzc0Ljc5ODYuNjc4NCAxLjI4NDMuODg0Ni40ODU4LjIwNjEgMS4wMDk4LjMxMyAxLjUzOTcuMzEzOGg3OS4wMzQzYy4zNzcxIDAgLjc0Ni0uMTA3MyAxLjA2MTYtLjMwODguMzE1LS4yMDE1LjU2My0uNDg4My43MTQtLjgyNTIuMTUtLjMzNy4xOTYtLjcwOTQuMTMyLTEuMDcxNS0uMDY0LS4zNjItLjIzNS0uNjk4LS40OTItLjk2Njd6bS04MS44NzExNy0xMi41MTI3aDc5LjAzODY3Yy41MzEyLjAwMDIgMS4wNTY5LS4xMDYgMS41NDQyLS4zMTIycy45MjU5LS41MDc5IDEuMjg4My0uODg2M2wxNi42NzMyLTE3LjQxOTgxYy4yNTctLjI2ODYyLjQyOC0uNjA0NjEuNDkyLS45NjY2OXMuMDE4LS43MzQ0Ny0uMTMyLTEuMDcxNDJjLS4xNTEtLjMzNjk1LS4zOTktLjYyMzc4NC0uNzE0LS44MjUyNTctLjMxNTYtLjIwMTQ3NC0uNjg0NS0uMzA4ODEwNTktMS4wNjE2LS4zMDg4MjNoLTc5LjAzNDNjLS41Mjk5LjAwMDg3ODQtMS4wNTM5LjEwNzY5OS0xLjUzOTcuMzEzODQ4LS40ODU3LjIwNjE1LS45MjI4LjUwNzIzOS0xLjI4NDMuODg0NjMybC0xNi42ODEzNzcgMTcuNDE5ODJjLS4yNTcwNDIuMjY4My0uNDI4MTAzMi42MDQtLjQ5MjIwNDUuOTY1Ni0uMDY0MTAxNC4zNjE3LS4wMTg0NTYxLjczMzguMTMxMzM3NSAxLjA3MDYuMTQ5Nzk0LjMzNjguMzk3MjI1LjYyMzYuNzExOTQ4LjgyNTQuMzE0NzI2LjIwMTguNjgzMDU2LjMwOTcgMS4wNTk4MjYuMzEwNnoiIGZpbGw9InVybCgjYSkiLz48L3N2Zz4=";
+    /**
+     * Get the supported chains.
+     *
+     * @returns Array of supported Solana chains
+     */
     get chains(): readonly ["solana:mainnet", "solana:devnet"];
+    /**
+     * Get the wallet standard version.
+     *
+     * @returns The wallet standard version
+     */
     get version(): "1.0.0";
+    /**
+     * Get the wallet accounts.
+     *
+     * @returns Array of readonly wallet accounts
+     */
     get accounts(): ReadonlyWalletAccount[];
+    /**
+     * Get the wallet features.
+     *
+     * @returns Wallet standard features supported by this wallet
+     */
     get features(): StandardConnectFeature & StandardDisconnectFeature & StandardEventsFeature & SolanaSignAndSendTransactionFeature & SolanaSignTransactionFeature & SolanaSignMessageFeature & CdpFeature;
 }
 
+/**
+ * CDP Wallet Account implementation for Solana accounts.
+ *
+ * This class represents a Solana account within the CDP wallet ecosystem.
+ */
 export declare class CdpWalletAccount implements WalletAccount {
     #private;
+    /**
+     * Create a new CDP Wallet Account.
+     *
+     * @param publicKey - The public key bytes for this account (must be exactly 32 bytes for Solana)
+     * @throws {Error} If publicKey is null, undefined, or not exactly 32 bytes
+     */
     constructor(publicKey: Uint8Array);
+    /**
+     * Get the base58 encoded address of this account.
+     *
+     * @returns The base58 encoded Solana address
+     */
     get address(): string;
+    /**
+     * Get the public key bytes of this account.
+     *
+     * @returns A copy of the public key bytes
+     */
     get publicKey(): Uint8Array<ArrayBuffer>;
+    /**
+     * Get the supported chains for this account.
+     *
+     * @returns Array of supported Solana chains
+     */
     get chains(): readonly ["solana:mainnet", "solana:devnet"];
+    /**
+     * Get the supported features for this account.
+     *
+     * @returns Array of supported wallet standard features
+     */
     get features(): readonly ["solana:signAndSendTransaction", "solana:signTransaction", "solana:signMessage"];
 }
 
+/**
+ * Hook to get the CDP Standard Solana Wallet with ready state.
+ *
+ * This hook monitors the user's Solana accounts from CDP core and:
+ * - Creates and registers a CdpSolanaWallet when accounts are available
+ * - Returns a ready flag indicating when the wallet is instantiated and registered
+ * - Returns the wallet instance for direct usage
+ * - Handles cleanup/unregistration on unmount
+ *
+ * @param config - Optional CDP configuration. If provided, will initialize the SDK.
+ *                 If omitted, assumes SDK is already initialized (e.g., via CDPHooksProvider).
+ *
+ * @example
+ * ```tsx
+ * // Within CDPHooksProvider (SDK already initialized)
+ * function MyComponent() {
+ *   const { ready, wallet } = useCdpSolanaStandardWallet();
+ *   // ...
+ * }
+ *
+ * // Standalone usage (initialize SDK)
+ * function MyComponent() {
+ *   const { ready, wallet } = useCdpSolanaStandardWallet({
+ *     projectId: "your-project-id"
+ *   });
+ *   // ...
+ * }
+ * ```
+ *
+ * @returns Object containing ready flag and wallet instance
+ */
 export declare const useCdpSolanaStandardWallet: (config?: Config) => {
     ready: boolean;
     wallet: CdpSolanaWallet | null;
 };
 
+/**
+ * Hook to get all Standard Solana Wallets registered in the wallet standard.
+ *
+ * This hook:
+ * - Gets all wallets using getWallets().get()
+ * - Listens for wallet registration/unregistration events
+ * - Returns the complete list including the CDP wallet once registered
+ *
+ * @example
+ * ```tsx
+ * function WalletList() {
+ *   const { wallets } = useSolanaStandardWallets();
+ *
+ *   return (
+ *     <div>
+ *       <h3>Available Wallets:</h3>
+ *       {wallets.map((wallet) => (
+ *         <div key={wallet.name}>
+ *           {wallet.name} {wallet.features['cdp:'] ? '(CDP)' : ''}
+ *         </div>
+ *       ))}
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @returns Object containing array of all registered wallets
+ */
 export declare const useSolanaStandardWallets: () => {
     wallets: readonly Wallet[];
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coinbase/cdp-solana-standard-wallet",
-  "version": "0.0.97",
+  "version": "0.0.99",
   "type": "module",
   "files": [
     "dist/**",
@@ -22,7 +22,7 @@
     "@wallet-standard/wallet": "^1.1.0",
     "@wallet-standard/features": "^1.1.0",
     "@wallet-standard/app": "^1.1.0",
-    "@coinbase/cdp-core": "^0.0.97"
+    "@coinbase/cdp-core": "^0.0.99"
   },
   "devDependencies": {
     "@testing-library/jest-dom": "^6.6.3",
@@ -37,7 +37,7 @@
     "@size-limit/webpack": "^11.2.0",
     "@size-limit/webpack-why": "^11.2.0",
     "size-limit": "^11.2.0",
-    "@coinbase/cdp-core": "^0.0.97"
+    "@coinbase/cdp-core": "^0.0.99"
   },
   "size-limit": [
     {