> For the complete documentation index, see [llms.txt](https://docs.wepin.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wepin.io/en/widget-integration/web-javascript-sdk/wallet-adapter/solana-wallet-adapter.md).

# Solana Wallet Adapter

## Install

{% tabs %}
{% tab title="npm" %}

```bash
npm install @wepin/solana-wallet-adapter
```

{% endtab %}

{% tab title="yarn" %}

```bash
yarn add @wepin/solana-wallet-adapter
```

{% endtab %}
{% endtabs %}

Once the installation is complete, initialize the `WepinSolanaWalletAdapter` instance using the app ID and app key assigned after registering the app. This will enable the use of `WepinSolanaWalletAdapter`.

<pre class="language-javascript"><code class="lang-javascript"><strong>// 1. Package import
</strong>import { WepinSolanaWalletAdapter } from "@wepin/solana-wallet-adapter";

<strong>
</strong>// 2. Initialize
const wepinSolanaWalletAdapter = new WepinSolanaWalletAdapter({
    appId: 'your-wepin-app-id',
    appKey: 'your-wepin-app-key',
    network: 'solana',
    attributes: {
        defaultCurrency: 'KRW', 
        defaultLanguage: 'ko'
    }
})
</code></pre>

If you're using `@solana/wallet-adapter-react`, initialize the adapter as shown below:

```jsx
const wallets = useMemo(
    () => [
      new WepinSolanaWalletAdapter({
        appId: 'your-wepin-app-id',
        appKey: 'your-wepin-app-key',
        network: 'solana',
        attributes: {
            defaultCurrency: 'KRW', 
            defaultLanguage: 'ko'
        }
      })
    ],
    []
  );
```

### Parameters

#### `WepinWalletAdapterConfig <Object>`

* appId \<string>\
  The App ID assigned after application registration.
* `appKey` \<string>\
  The App Key assigned after application registration.
* `network` \<string> *(optional)*\
  The network variable for the supported wallet adapter. For Solana Mainnet, use `"solana"`.\
  Must be entered in lowercase. Default is `"solana"`.
* `attributes` \<object> *(optional)*
  * `defaultLanguage`: Sets the widget's default language. Supported languages are `en`, `ko`, and `ja`. Default is `en`.
  * `defaultCurrency`: Sets the widget's default currency. Supported currencies are `USD`, `KRW`, and `JPY`. Default is `USD`.

### Methods

The following methods are available in the `WepinSolanaWalletAdapter`.

### connect

Connects to the Wepin Wallet and retrieves the user's Public Key.

#### parameters

* `<void>`

#### Return Value

Promise\<void>

* On successful connection, the adapter's `connected` property will be set to `true`, and the `publicKey` property will hold the user's Public Key.

#### Example

```typescript
await walletSolanaWalletAdapter.connect()
const isConnected = walletSolanaWalletAdapter.connected    // Check connection status
const publicKey = walletSolanaWalletAdapter.publicKey        // Get connected account's Public Key
```

***

### signMessage

Signs a given message using the user's private key.

#### parameters

* message `<Uint8Array>`\
  The message to sign.

#### Return Value

* `Promise<Uint8Array>`\
  The signed message as a `Uint8Array`.

#### Example

```typescript
const message = new TextEncoder().encode('Hello, Solana!');
const signedMessage = await wepinSolanaWalletAdapter.signMessage(message);
console.log(`Signed message as Uint8Array:`, signedMessage);
```

***

### signTransaction

Signs a Solana transaction object.

#### parameters

* `<Transaction | VersionedTransaction>`\
  The Solana transaction object to sign.

#### Return Value

* `Promise<Transaction | VersionedTransaction>`\
  The signed transaction object.

#### Example

```typescript
import { Transaction, SystemProgram, PublicKey } from '@solana/web3.js';

const publicKey = wepinSolanaWalletAdapter.publicKey
// Create a transaction
const transaction = new Transaction().add(
  SystemProgram.transfer({
    fromPubkey: publicKey,
    toPubkey: new PublicKey('recipient-public-key'),
    lamports: 1000000,
  }),
);

// Set recent blockhash and feePayer
transaction.recentBlockhash = 'recent-blockhash';
transaction.feePayer = publicKey;

// Sign the transaction
const signedTransaction = await wepinSolanaWalletAdapter.signTransaction(transaction);

console.log('Signed Transaction:', signedTransaction);

```

***

### sendTransaction

The `sendTransaction` method accepts a Solana transaction object, signs it, and sends it to the network.

#### parameters

* `transaction` \<Transaction | VersionedTransaction> - The Solana transaction object to sign and send.
* `connection` Connection -The connection object that interacts with the Solana network.
* `options` SendTransactinOptions - Additional options required when sending the transaction. *optional*
  * `signers` - An array of accounts that require additional signatures. *optional*

#### Return Value

* `Promise<TransactionSignature>` - Returns the unique signature of the successfully sent transaction.

#### Example

```typescript
import { Connection, Transaction, SystemProgram, PublicKey } from '@solana/web3.js';

const connection = new Connection(umi.rpc.getEndpoint(), 'finalized')
const publicKey = wepinSolanaWalletAdapter.publicKey

const transaction = new Transaction().add(
  SystemProgram.transfer({
    fromPubkey: publicKey,
    toPubkey: new PublicKey('recipient-public-key'),
    lamports: 1000000,
  }),
);

//set blockhash and fee payer
transaction.recentBlockhash = 'recent-blockhash';
transaction.feePayer = publicKey;

// transaction sign and send
const signature = await wepinSolanaWalletAdapter.sendTransaction(transaction, connection, {});

console.log('Signature:', signature );

```

***

### signAllTransactions

The `signAllTransactions` method accepts multiple Solana transaction objects and signs them.

{% hint style="info" %}
**The maximum number of transactions that can be signed at once is 10.** Pre-registration is required to use this feature. For registration, [contact Wepin](https://mail.google.com/mail/u/0/?to=wepin.contact@iotrust.kr\&su=Contact+us%5BGeneral%5D\&body=Hello.+Please+enter+your+related+inquiries.\&fs=1\&tf=cm).
{% endhint %}

#### parameters

* `Array<Transaction | VersionedTransaction>`\
  An array of Solana transaction objects to sign.

#### Return Value

* `Promise<Array<Transaction | VersionedTransaction>>`\
  Returns an array of transaction objects with signatures included.

#### Example

```typescript
import { Transaction, SystemProgram, PublicKey } from '@solana/web3.js';

// sign transactions
const signedTransactions = await wepinSolanaWalletAdapter.signAllTransactions(transactions);

console.log('Signed Transactions:', signedTransactions);

```

***

### disconnect

Disconnects from the Wepin Wallet.

#### parameters

* `<void>`

#### Return Value

* `Promise<void>`

#### Example

```typescript
await wepinWallet.disconnect();
```