ทำ Frontend เชื่อมต่อ Wallet ด้วย Nextjs + Solana Wallet Adapter

วันนี้ลองทำ Frontend เพื่อใส่ปุ่ม Connect Wallet ให้กับเว็บไซต์ ซึ่งผมจะใช้ตัว Solana Wallet Adapter ข้อดีคือ มัน handle หลายๆ Wallet ให้เราเลย ไม่ว่าจะเป็น Phantom, Sollet, Ledger, Solflare, Math Wallet เป็นต้น

ซึ่งถ้าเราไม่ใช้ เราก็ต้องไป handle เอง เช่น ถ้าเราติดตั้ง Phantom แล้ว เราก็เข้าถึง global object ได้ เหมือนกับ Metamask ที่ inject ethereum เป็น global object ใน window เช่นกัน

1
window.phantom
2

3
// {solana: n}

ตัวอย่าง Solana Wallet Adapter

• จะเห็นว่า มี Popup และรายชื่อ Wallet ให้เราเลือก Connect ได้เลย
• จัดการ Auto connect ให้เรา
• มี UI รองรับทั้ง Material UI และ Ant Design
• รองรับ Frontend หลักๆ ทั้ง React, Vue และ Angular รวมถึง Svelte

สำหรับบทความนี้ ผมเลือกใช้

• Phantom - เป็นกระเป๋า Wallet บน Browser Extension.
• React + Nextjs - สำหรับ Stack ของ frontend ครับ

สร้างโปรเจ็ค Next.js

ทำการสร้างโปรเจ็คขึ้นมาโดยใช้ create-next-app ครับ และผมเลือกเป็น TypeScript (หากไม่อยากเขียนด้วย TypeScript ก็เอา option ออกได้ครับ) หรืออ่านเพิ่มเติม Next.js - Getting Started

yarn create next-app --typescript

# หรือถ้าใช้ npx
npx create-next-app@latest --typescript

ผมตั้งชื่อว่า hello-sonala-wallet-adapter (แล้วแต่เลยว่าอยากได้ชื่ออะไร)

What is your project named? … hello-solana-wallet-adapter

เมื่อได้โปรเจ็คแล้ว ลองเปิดโปรเจ็ค แล้วลอง start development mode ดู

yarn dev

ต้องได้หน้าเว็บ starter ของ Next.js http://localhost:3000

เพิ่มปุ่ม Connect Wallet

ต่อมาติดตั้ง packages ของ Solana Wallet Adapter ที่จะใช้กัน

yarn add @solana/web3.js @solana/wallet-adapter-base @solana/wallet-adapter-wallets @solana/wallet-adapter-react

• @solana/web3.js - เป็นตัว Solana Web3 (ถ้าในบทความนี้หลักๆ ก็แค่ดึง url ซึ่งถ้า demo เรา hardcode ก็ได้)
• @solana/wallet-adapter-base - ตัวนี้เป็น base ที่เป็น Adapter Inferface และ Utilities ต่างๆ
• @solana/wallet-adapter-react - เป็นตัวจัดการ Context และ React Hooks
• @solana/wallet-adapter-react-ui - เป็นตัว React UI เช่น Modal, MultiButton
• @solana/wallet-adapter-wallets - เป็นตัวจัดการ Wallets ทุกๆตัวเลย (มี Tree shaking ตัวไหนไม่ได้ใช้ ก็ไม่ถูก include เข้ามาเวลา build)

ซึ่งถ้าใครไม่อยากใช้ adapter-wallets ที่รวมทุก Wallets ก็สามารถใช้แยกได้เช่น @solana/wallet-adapter-phantom หรือ @solana/wallet-adapter-sollet

จากนั้นที่ไฟล์​ pages/_app.tsx เพิ่ม Provider ลงไป

1
import { useMemo } from 'react'
2
import type { AppProps } from 'next/app'
3

4
import { WalletAdapterNetwork } from '@solana/wallet-adapter-base'
5
import { ConnectionProvider, WalletProvider } from '@solana/wallet-adapter-react'
6
import {
7
  PhantomWalletAdapter,
8
  MathWalletAdapter,
9
  SolflareWalletAdapter
10
} from '@solana/wallet-adapter-wallets'
11
import { WalletModalProvider } from '@solana/wallet-adapter-react-ui'
12
import { clusterApiUrl } from '@solana/web3.js'
13

14
import '../styles/globals.css'
15

16
function MyApp({ Component, pageProps }: AppProps) {
17
  const network = WalletAdapterNetwork.Devnet
18
  const endpoint = useMemo(() => clusterApiUrl(network), [network])
19

20
  const wallets = useMemo(() => {
21
    return [
22
      new PhantomWalletAdapter(),
23
      new SolflareWalletAdapter({ network }),
24
      new MathWalletAdapter()
25
    ]
26
  }, [network])
27

28
  return (
29
    <ConnectionProvider endpoint={endpoint}>
30
      <WalletProvider wallets={wallets}>
31
        <WalletModalProvider>
32
          <Component {...pageProps} />
33
        </WalletModalProvider>
34
      </WalletProvider>
35
    </ConnectionProvider>
36
  )
37
}
38

39
export default MyApp

อธิบายเพิ่มเติมนิดหน่อย คือ

1
const network = WalletAdapterNetwork.Devnet
2
const endpoint = useMemo(() => clusterApiUrl(network), [network])

เป็นการระบุ ให้ใช้ Network เป็น Devnet

1
const wallets = useMemo(() => {
2
  return [
3
    new PhantomWalletAdapter(),
4
    new SolflareWalletAdapter({ network }),
5
    new MathWalletAdapter()
6
  ]
7
}, [network])

สร้างตัว Wallets ขึ้นมา เพื่อเป็นเมนูให้ User เลือกครับ ถ้าอยากมีตัวเลือกหลาย Wallet ก็ import เพิ่ม

1
return (
2
  <ConnectionProvider endpoint={endpoint}>
3
    <WalletProvider wallets={wallets}>
4
      <WalletModalProvider>
5
        <Component {...pageProps} />
6
      </WalletModalProvider>
7
    </WalletProvider>
8
  </ConnectionProvider>
9
)

• ConnectionProvider - กำหนด endpoint จาก url ที่เรา set ค่าไว้
• WalletProvder - กำหนด ตัวเลือก wallets ที่เราต้องการ
• WalletModalProvider - เป็นตัว Modal UI ของ React

ทีนี้ก็เพิ่มปุ่ม Connect Wallet ที่หน้า pages/index.tsx ครับ โดยที่ผมไม่ได้เปลี่ยน content ที่ nextjs generate มาให้นะครับ แต่เอาปุ่มไปแทนที่ส่วนนี้

1
<p className={styles.description}>
2
  Get started by editing <code className={styles.code}>pages/index.tsx</code>
3
</p>

ที่เหลือเหมือนเดิม เปลี่ยนเป็น

1
import { WalletDisconnectButton, WalletMultiButton } from '@solana/wallet-adapter-react-ui'
2

3
const Home: NextPage = () => {
4
  return (
5
    // โค๊ดอื่นๆ ก่อนหน้า
6
    <div>
7
      <WalletMultiButton />
8
      <WalletDisconnectButton />
9
    </div>
10
    // ...
11
    // โค๊ดอื่นๆ ไม่ได้แก้
12
  )
13
}

แต่ว่าหน้าเว็บ ทำไมปุ่มเป็นแบบนี้ และก็กดอะไรไม่มีอะไรเกิดขึ้นเลย? จริงๆ มันได้ครับ และการทำงานปกติ เพียงแต่ว่าไม่มี css เท่านั้น

แก้ไขไฟล์ pages/_app.tsx โดยเพิ่ม css ของ wallet-adapter-react-ui ลงไปครับ

1
import '@solana/wallet-adapter-react-ui/styles.css'

เพียงแค่นี้ก็ได้แล้ว

แต่มันไม่ค่อยสวย ผมขอเพิ่ม css ให้มันนิดหน่อยนะครับ ให้มี spacing ของปุ่ม Connect และ Disconnect

1
.buttonContainer {
2
  display: flex;
3
  margin-top: 1em;
4
  margin-bottom: 1em;
5
}
6

7
/* WalletMultiButton */
8
.buttonContainer > * {
9
  margin-left: 0.5rem;
10
  margin-right: 0.5rem;
11
}

และเพิ่มคลาสไป ในไฟล์ pages/index.tsx

1
<div className={styles.buttonContainer}>
2
  <WalletMultiButton />
3
  <WalletDisconnectButton />
4
</div>

เป็นอันเรียบร้อย ซึ่ง Flow การทำงานของมันคือ Select Wallet ก่อน จากนั้นก็ Connect ครับ (สังเกตจาก icon wallet ที่เราเลือก)

เพื่อนๆ ลองนำไปใช้ ไปลองเล่นกันดูนะครับ ลองสลับ Network ลอง handle network ลองส่ง Transaction ดู หรือลองดูตัวอย่างอื่นๆ เพิ่มเติมได้ครับ ส่วนใหญ่จะเป็น Community ช่วยๆกันทำขึ้น เช่น Vue, Svelte

Happy Coding ❤️