@aptos-labs/wallet-adapter-core 8.2.0 → 8.3.0

package/README.md

@@ -1,13 +1,189 @@
-# Aptos Wallet Adapter core functionality
+# @aptos-labs/wallet-adapter-core
 
-The core functionality for the wallet adapter that holds and manages the adapter state, validations and interaction with the current connected wallet.
+Core functionality for the Aptos Wallet Adapter. This package provides the foundation for wallet management, state handling, and interaction with AIP-62 compatible wallets on the Aptos blockchain.
 
-### Usage
+## Overview
+
+The wallet-adapter-core package handles:
+
+- **Wallet Detection**: Automatically detects AIP-62 standard compatible wallets installed in the browser
+- **Connection Management**: Connect, disconnect, and manage wallet sessions
+- **Transaction Signing**: Sign messages, transactions, and submit transactions to the network
+- **Network Management**: Handle network changes and multi-network support
+- **Event System**: Subscribe to wallet, account, and network change events
+- **State Management**: Centralized state for connected wallet, account, and network information
+
+## Installation
+
+```bash
+npm install @aptos-labs/wallet-adapter-core
+# or
+pnpm add @aptos-labs/wallet-adapter-core
+# or
+yarn add @aptos-labs/wallet-adapter-core
+```
+
+**Peer Dependencies:**
+
+```bash
+npm install @aptos-labs/ts-sdk
+```
+
+## Usage
+
+### Basic Setup
 
 ```ts
 import { WalletCore } from "@aptos-labs/wallet-adapter-core";
+import { Network } from "@aptos-labs/ts-sdk";
 
-const walletCore = new WalletCore([], dappConfig);
+// Create wallet core instance
+const walletCore = new WalletCore(
+  [], // Optional: array of wallet names to opt-in (empty = all wallets)
+  { network: Network.MAINNET }, // Optional: dapp configuration
+  false, // Optional: disable telemetry (default: false)
+  ["Petra Web"] // Optional: wallets to hide from display
+);
+
+// Get available wallets
+const wallets = walletCore.wallets;
+const notDetectedWallets = walletCore.notDetectedWallets;
+```
+
+### Connecting to a Wallet
+
+```ts
+// Connect to a wallet by name
+await walletCore.connect("Petra");
 
-const wallets = walletCore.wallets();
+// Check connection status
+if (walletCore.isConnected()) {
+  console.log("Connected account:", walletCore.account);
+  console.log("Connected network:", walletCore.network);
+}
 ```
+
+### Signing Messages
+
+```ts
+const signedMessage = await walletCore.signMessage({
+  message: "Hello, Aptos!",
+  nonce: "random-nonce-123",
+});
+
+console.log("Signature:", signedMessage.signature);
+console.log("Full message:", signedMessage.fullMessage);
+```
+
+### Signing and Submitting Transactions
+
+```ts
+const result = await walletCore.signAndSubmitTransaction({
+  data: {
+    function: "0x1::aptos_account::transfer",
+    typeArguments: [],
+    functionArguments: [recipientAddress, amount],
+  },
+});
+
+console.log("Transaction hash:", result.hash);
+```
+
+### Listening to Events
+
+```ts
+// Account change event
+walletCore.on("accountChange", (account) => {
+  console.log("Account changed:", account);
+});
+
+// Network change event
+walletCore.on("networkChange", (network) => {
+  console.log("Network changed:", network);
+});
+
+// Disconnect event
+walletCore.on("disconnect", () => {
+  console.log("Wallet disconnected");
+});
+```
+
+### Disconnecting
+
+```ts
+await walletCore.disconnect();
+```
+
+## API Reference
+
+### WalletCore
+
+The main class that manages wallet state and interactions.
+
+#### Constructor
+
+```ts
+new WalletCore(
+  optInWallets?: ReadonlyArray<AvailableWallets>,
+  dappConfig?: DappConfig,
+  disableTelemetry?: boolean,
+  hideWallets?: ReadonlyArray<AvailableWallets>
+)
+```
+
+#### Properties
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `wallet` | `AptosWallet \| null` | Currently connected wallet |
+| `account` | `AccountInfo \| null` | Currently connected account |
+| `network` | `NetworkInfo \| null` | Currently connected network |
+| `wallets` | `ReadonlyArray<AptosWallet>` | List of detected wallets |
+| `hiddenWallets` | `ReadonlyArray<AdapterWallet>` | List of hidden wallets |
+| `notDetectedWallets` | `ReadonlyArray<AdapterNotDetectedWallet>` | List of not-detected wallets |
+
+#### Methods
+
+| Method | Description |
+|--------|-------------|
+| `connect(walletName)` | Connect to a wallet |
+| `disconnect()` | Disconnect from current wallet |
+| `signMessage(input)` | Sign a message |
+| `signTransaction(args)` | Sign a transaction |
+| `signAndSubmitTransaction(input)` | Sign and submit a transaction |
+| `changeNetwork(network)` | Request network change |
+| `signIn(args)` | Sign in with SIWA (Sign In With Aptos) |
+| `isConnected()` | Check if wallet is connected |
+
+#### Events
+
+| Event | Payload | Description |
+|-------|---------|-------------|
+| `connect` | `AccountInfo` | Emitted when wallet connects |
+| `disconnect` | - | Emitted when wallet disconnects |
+| `accountChange` | `AccountInfo` | Emitted when account changes |
+| `networkChange` | `NetworkInfo` | Emitted when network changes |
+
+## DappConfig
+
+Configuration options for the wallet adapter:
+
+```ts
+interface DappConfig {
+  network: Network;
+  transactionSubmitter?: TransactionSubmitter;
+  aptosApiKeys?: Partial<Record<Network, string>>;
+  aptosConnectDappId?: string;
+  aptosConnect?: AptosConnectWalletConfig;
+  crossChainWallets?: boolean;
+}
+```
+
+## Related Packages
+
+- [`@aptos-labs/wallet-adapter-react`](../wallet-adapter-react) - React hooks and context provider
+- [`@aptos-labs/ts-sdk`](https://github.com/aptos-labs/aptos-ts-sdk) - Aptos TypeScript SDK
+
+## License
+
+Apache-2.0

package/dist/index.js

@@ -497,7 +497,7 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 // src/version.ts
-var WALLET_ADAPTER_CORE_VERSION = "8.2.0";
+var WALLET_ADAPTER_CORE_VERSION = "8.3.0";
 // src/WalletCore.ts
 var import_eventemitter3 = __toESM(require("eventemitter3"));
 var import_ts_sdk2 = require("@aptos-labs/ts-sdk");
@@ -778,7 +778,7 @@ function isRedirectable() {
     return isMobile() && !isInAppBrowser();
 }
 function generalizedErrorMessage(error) {
-    return (typeof error === "undefined" ? "undefined" : _type_of(error)) === "object" && "message" in error ? error.message : error;
+    return error !== null && (typeof error === "undefined" ? "undefined" : _type_of(error)) === "object" && "message" in error ? error.message : error;
 }
 var getAptosConfig = function(networkInfo, dappConfig) {
     if (!networkInfo) {
@@ -1046,13 +1046,6 @@ var aptosStandardSupportedWalletList = [
         isAIP62Standard: true,
         deeplinkProvider: "nightly://v1?network=aptos&url="
     },
-    {
-        name: "Pontem Wallet",
-        url: "https://pontem.network/pontem-wallet",
-        icon: "data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMzYiIGhlaWdodD0iMzYiIHZpZXdCb3g9IjAgMCAzNiAzNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTE4IDBDOC4wNzMwNCAwIDAgOC4wNzEzOSAwIDE3Ljk5NjNDMCAyNS4xMjk4IDQuMTczMTYgMzEuMzEwOCAxMC4yMDc2IDM0LjIyMDNWMzQuMjM1MUgxMC4yMzcyQzEyLjU4NiAzNS4zNjQ5IDE1LjIyMjggMzYgMTggMzZDMjcuOTI3IDM2IDM2IDI3LjkyODYgMzYgMTguMDAzN0MzNiA4LjA3MTM4IDI3LjkyNyAwIDE4IDBaTTE4IDEuNDc2OTJDMjcuMTA3MSAxLjQ3NjkyIDM0LjUyMjggOC44OTEwOCAzNC41MjI4IDE3Ljk5NjNDMzQuNTIyOCAyMC42MTA1IDMzLjkwOTcgMjMuMDkxNyAzMi44MjQgMjUuMjkyM0MzMC40NDU2IDI0LjE0MDMgMjguMDMwNCAyMy4yODM3IDI1LjU5MjkgMjIuNzAwM1Y4LjkyMDYyQzI1LjU5MjkgOC40NDA2MiAyNS4yMTYyIDguMDU2NjIgMjQuNzQzNSA4LjA1NjYySDIxLjcxNTJIMTQuMDg1NEgxMS4wNTdDMTAuNTkxNyA4LjA1NjYyIDEwLjIwNzYgOC40NDA2MiAxMC4yMDc2IDguOTIwNjJWMjIuNzY2OEM3Ljg0NDA3IDIzLjM1MDIgNS40OTUyOCAyNC4xOTIgMy4xODM0MiAyNS4yOTk3QzIuMDkwMjcgMjMuMDkxNyAxLjQ3NzIzIDIwLjYxNzggMS40NzcyMyAxNy45OTYzQzEuNDc3MjMgOC44OTEwOCA4Ljg5MjkgMS40NzY5MiAxOCAxLjQ3NjkyWk00LjEzNjIzIDI2Ljk2MTJDNi4wOTM1NiAyNS45OTM4IDguMTI0NzQgMjUuMjQ4IDEwLjIxNSAyNC43MzExVjMyLjU1ODhDNy43NDA2NiAzMS4yMzY5IDUuNjUwMzkgMjkuMzAyMiA0LjEzNjIzIDI2Ljk2MTJaTTE0LjA4NTQgMzQuMDQzMVYxNS42MDM3QzE0LjA4NTQgMTMuNDY5NSAxNS44MzU5IDExLjcwNDYgMTcuOTI2MSAxMS43MDQ2QzIwLjAxNjQgMTEuNzA0NiAyMS43MTUyIDEzLjQzMjYgMjEuNzE1MiAxNS41NTk0QzIxLjcxNTIgMTUuNTc0MiAyMS43MDc4IDE1LjU4ODkgMjEuNzA3OCAxNS42MDM3SDIxLjcxNTJWMjIuMDIwOUMxOS45MzUyIDIxLjgxNDIgMTguMTQ3NyAyMS43NDc3IDE2LjM2MDMgMjEuODQzN0wxNC44OTA0IDIzLjk3NzhDMTcuMTgwMSAyMy43ODU4IDE5LjQxMDcgMjMuODAwNiAyMS42MTE4IDI0LjA1MTdDMjEuNjM0IDI0LjA1MTcgMjEuNjQ4NyAyNC4wNTE3IDIxLjY3MDkgMjQuMDU5MUMyMS42ODU3IDI0LjA1OTEgMjEuNzAwNSAyNC4wNTkxIDIxLjcyMjYgMjQuMDY2NUMyMi4xMDY3IDI0LjExMDggMjMuNTAyNyAyNC4yODggMjQuNzgwNSAyNC42MDU1TDIxLjcyMjYgMjUuNjQ2OFYzNC4xMDIyQzIwLjUyNjEgMzQuMzc1NCAxOS4yODUyIDM0LjUzMDUgMTguMDE0OCAzNC41MzA1QzE2LjY0ODMgMzQuNTE1NyAxNS4zNDEgMzQuMzQ1OCAxNC4wODU0IDM0LjA0MzFaTTI1LjU4NTYgMzIuNjYyMlYyNC43NjhDMjcuNjY4NCAyNS4yOTIzIDI5LjcyOTIgMjYuMDYwMyAzMS43OTczIDI3LjA2NDZDMzAuMjQ2MiAyOS40MjAzIDI4LjEwNDIgMzEuMzU1MSAyNS41ODU2IDMyLjY2MjJaIiBmaWxsPSJ1cmwoI3BhaW50MF9saW5lYXJfMjIyXzE2NzApIi8+CjxkZWZzPgo8bGluZWFyR3JhZGllbnQgaWQ9InBhaW50MF9saW5lYXJfMjIyXzE2NzAiIHgxPSIxNy45OTk3IiB5MT0iMzYuNzc4OSIgeDI9IjE3Ljk5OTciIHkyPSItNS41MTk3OCIgZ3JhZGllbnRVbml0cz0idXNlclNwYWNlT25Vc2UiPgo8c3RvcCBvZmZzZXQ9IjAuMDg1OCIgc3RvcC1jb2xvcj0iIzhEMjlDMSIvPgo8c3RvcCBvZmZzZXQ9IjAuMjM4MyIgc3RvcC1jb2xvcj0iIzk0MkJCQiIvPgo8c3RvcCBvZmZzZXQ9IjAuNDY2NyIgc3RvcC1jb2xvcj0iI0E5MkZBQyIvPgo8c3RvcCBvZmZzZXQ9IjAuNzQxMyIgc3RvcC1jb2xvcj0iI0NBMzc5MyIvPgo8c3RvcCBvZmZzZXQ9IjEiIHN0b3AtY29sb3I9IiNGMDNGNzciLz4KPC9saW5lYXJHcmFkaWVudD4KPC9kZWZzPgo8L3N2Zz4K",
-        readyState: "NotDetected" /* NotDetected */ ,
-        isAIP62Standard: true
-    },
     {
         name: "Backpack",
         url: "https://chromewebstore.google.com/detail/backpack/aflkmfhebedbjioipglgcbcmnbpgliof",
@@ -1131,6 +1124,22 @@ var crossChainStandardSupportedWalletList = [
         readyState: "NotDetected" /* NotDetected */ ,
         isAIP62Standard: true,
         deeplinkProvider: "https://link.metamask.io/dapp/"
+    },
+    {
+        name: "Coinbase (Ethereum)",
+        url: "https://wallet.coinbase.com/",
+        icon: "data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMTAyNCIgaGVpZ2h0PSIxMDI0IiB2aWV3Qm94PSIwIDAgMTAyNCAxMDI0IiBmaWxsPSJub25lIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPgo8Y2lyY2xlIGN4PSI1MTIiIGN5PSI1MTIiIHI9IjUxMiIgZmlsbD0iIzAwNTJGRiIvPgo8cGF0aCBmaWxsLXJ1bGU9ImV2ZW5vZGQiIGNsaXAtcnVsZT0iZXZlbm9kZCIgZD0iTTUxMiAyOTZDMzkyLjQ3MSAyOTYgMjk2IDM5Mi40NzEgMjk2IDUxMkMyOTYgNjMxLjUyOSAzOTIuNDcxIDcyOCA1MTIgNzI4QzYzMS41MjkgNzI4IDcyOCA2MzEuNTI5IDcyOCA1MTJDNzI4IDM5Mi40NzEgNjMxLjUyOSAyOTYgNTEyIDI5NlpNNDIwLjggNDY0LjhDNDIwLjggNDUyLjU5NiA0MzAuNTk2IDQ0Mi44IDQ0Mi44IDQ0Mi44SDU4MS4yQzU5My40MDQgNDQyLjggNjAzLjIgNDUyLjU5NiA2MDMuMiA0NjQuOFY1NTkuMkM2MDMuMiA1NzEuNDA0IDU5My40MDQgNTgxLjIgNTgxLjIgNTgxLjJINDQyLjhDNDMwLjU5NiA1ODEuMiA0MjAuOCA1NzEuNDA0IDQyMC44IDU1OS4yVjQ2NC44WiIgZmlsbD0id2hpdGUiLz4KPC9zdmc+Cg==",
+        readyState: "NotDetected" /* NotDetected */ ,
+        isAIP62Standard: true,
+        deeplinkProvider: "https://wallet.coinbase.com/wsegue?cb_url="
+    },
+    {
+        name: "Coinbase (Solana)",
+        url: "https://wallet.coinbase.com/",
+        icon: "data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMTAyNCIgaGVpZ2h0PSIxMDI0IiB2aWV3Qm94PSIwIDAgMTAyNCAxMDI0IiBmaWxsPSJub25lIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPgo8Y2lyY2xlIGN4PSI1MTIiIGN5PSI1MTIiIHI9IjUxMiIgZmlsbD0iIzAwNTJGRiIvPgo8cGF0aCBmaWxsLXJ1bGU9ImV2ZW5vZGQiIGNsaXAtcnVsZT0iZXZlbm9kZCIgZD0iTTUxMiAyOTZDMzkyLjQ3MSAyOTYgMjk2IDM5Mi40NzEgMjk2IDUxMkMyOTYgNjMxLjUyOSAzOTIuNDcxIDcyOCA1MTIgNzI4QzYzMS41MjkgNzI4IDcyOCA2MzEuNTI5IDcyOCA1MTJDNzI4IDM5Mi40NzEgNjMxLjUyOSAyOTYgNTEyIDI5NlpNNDIwLjggNDY0LjhDNDIwLjggNDUyLjU5NiA0MzAuNTk2IDQ0Mi44IDQ0Mi44IDQ0Mi44SDU4MS4yQzU5My40MDQgNDQyLjggNjAzLjIgNDUyLjU5NiA2MDMuMiA0NjQuOFY1NTkuMkM2MDMuMiA1NzEuNDA0IDU5My40MDQgNTgxLjIgNTgxLjIgNTgxLjJINDQyLjhDNDMwLjU5NiA1ODEuMiA0MjAuOCA1NzEuNDA0IDQyMC44IDU1OS4yVjQ2NC44WiIgZmlsbD0id2hpdGUiLz4KPC9zdmc+Cg==",
+        readyState: "NotDetected" /* NotDetected */ ,
+        isAIP62Standard: true,
+        deeplinkProvider: "https://wallet.coinbase.com/wsegue?cb_url="
     }
 ];
 // src/sdkWallets.ts