การย้ายไปใช้ RainbowKit และ Wagmi v2
การพึ่งพา wagmi และ viem ได้ถึงเวอร์ชัน 2.x.x
พร้อมกับการเปลี่ยนแปลงหลัก
ทำตามขั้นตอนด้านล่างเพื่อย้าย.
1. อัปเกรด RainbowKit, wagmi
, และ viem
ไปยังเวอร์ชันล่าสุด
2. ติดตั้งไลบรารี @tanstack/react-query
ที่เป็น peer dependency
ด้วย Wagmi v2, TanStack Query ตอนนี้เป็น peer dependency ที่ต้องการ
ติดตั้งด้วยคำสั่งต่อไปนี้:
**3. อัพเกรดการตั้งค่า RainbowKit และ Wagmi ของคุณ
4. ตรวจสอบการเปลี่ยนแปลงที่สำคัญใน wagmi
และ viem
หากคุณใช้งาน hooks ของ wagmi
และ actions ของ viem
ใน dApp ของคุณ, คุณจะต้องทำตามคู่มือการย้ายข้อมูลสำหรับ v2:
**1. พฤติกรรมที่ปรับปรุงสำหรับกระเป๋าสตางค์ EIP-6963
กระเป๋าสตางค์ที่รองรับมาตรฐานการเชื่อมต่อใหม่ EIP-6963 (รวมถึง Rainbow, MetaMask และอื่นๆ) จะปรากฏในส่วน Installed
โดยอัตโนมัติระหว่างประสบการณ์การเชื่อมต่อกระเป๋าสตางค์ สิ่งนี้ช่วยให้ผู้ใช้สามารถค้นหากระเป๋าสตางค์ที่ชื่นชอบได้เสมอและเชื่อมต่อกับ dApps โดยไม่มีความขัดแย้งหรือปุ่ม fallback สิ่งนี้ช่วยให้ผู้ใช้สามารถค้นหากระเป๋าสตางค์ที่ชื่นชอบได้เสมอและเชื่อมต่อกับ dApps โดยไม่มีความขัดแย้งหรือปุ่ม fallback สิ่งนี้ช่วยให้ผู้ใช้สามารถค้นหากระเป๋าสตางค์ที่ชื่นชอบได้เสมอและเชื่อมต่อกับ dApps โดยไม่มีความขัดแย้งหรือปุ่ม fallback
นักพัฒนายังคงมีการควบคุมเต็มที่เหนือรายการกระเป๋าสตางค์ที่กำหนดเองเพื่อเน้นกระเป๋าสตางค์ที่ต้องการสำหรับผู้ใช้ปลายทาง นักพัฒนายังคงมีการควบคุมเต็มที่เหนือรายการกระเป๋าสตางค์ที่กำหนดเองเพื่อเน้นกระเป๋าสตางค์ที่ต้องการสำหรับผู้ใช้ปลายทาง ขอแนะนำให้คุณยังคงรวม injectedWallet
และ walletConnectWallet
ในรายการของคุณเพื่อรองรับทุกแพลตฟอร์ม
2. การตั้งค่า Wagmi ด้วย getDefaultConfig
API ใหม่นี้ทำให้ประสบการณ์การกำหนดค่าง่ายขึ้นและทดแทนความจำเป็นในการใช้ createConfig
ของ Wagmi โดยตรง การกำหนดค่าเชนถูกทำให้ง่ายขึ้น รวมถึงการให้บริการสาธารณะที่สามารถสรุปได้สำหรับ transports
การกำหนดค่าเชนถูกทำให้ง่ายขึ้น รวมถึงการให้บริการสาธารณะที่สามารถสรุปได้สำหรับ transports
การกำหนดค่าเชนถูกทำให้ง่ายขึ้น รวมถึงการให้บริการสาธารณะที่สามารถสรุปได้สำหรับ transports
รายการกระเป๋าเงินเริ่มต้นจะถูกรวมเข้ามาโดยอัตโนมัติ ทำให้ไม่จำเป็นต้องใช้ getDefaultWallets
และ connectorsForWallets
คุณสามารถสร้างรายการกระเป๋าเงินที่กำหนดเองได้โดยการส่ง connectors กระเป๋าเงินที่นำเข้ามาหรือเชนที่กำหนดเองไปยัง wallets
ไม่จำเป็นต้องสร้าง connectors กระเป๋าเงินและส่ง projectId
และ chains
อีกต่อไป คุณสามารถสร้างรายการกระเป๋าเงินที่กำหนดเองได้โดยการส่ง connectors กระเป๋าเงินที่นำเข้ามาหรือเชนที่กำหนดเองไปยัง wallets
ไม่จำเป็นต้องสร้าง connectors กระเป๋าเงินและส่ง projectId
และ chains
อีกต่อไป ไม่จำเป็นต้องสร้าง connectors กระเป๋าเงินและส่ง projectId
และ chains
อีกต่อไป
3. RainbowKitProvider
คุณไม่จำเป็นต้องส่ง chains
ไปยัง <RainbowKitProvider>
4. เชนที่กำหนดเอง
ประเภทของ Chain
ได้เปลี่ยนแปลงตาม Wagmi v2 และยังคงสนับสนุน metadata iconUrl
และ iconBackground
ของ RainbowKit
ตัวอย่างที่ใช้ getDefaultConfig
:
ตัวอย่างโดยใช้ createConfig
:
5. กระเป๋าเงินที่กำหนดเอง
คอนเนคเตอร์กระเป๋าเงินของ RainbowKit ได้รับการเปลี่ยนแปลงอย่างมากเพื่อรองรับ Wagmi v2. อ้างอิง เอกสารที่อัปเดต และ ตัวอย่างคอนเนคเตอร์ เพื่ออัปเกรดคอนเนคเตอร์กระเป๋าเงินที่กำหนดเองใน dApp ของคุณ.
คอนเนคเตอร์กระเป๋าเงินยังรองรับมาตรฐาน EIP-6963 ด้วย prop rdns
. ตรวจสอบให้แน่ใจว่ามีการกรอกข้อมูลนี้เพื่อป้องกันการอ้างอิงซ้ำๆ ไปยังกระเป๋าเงินที่รองรับ EIP-6963 ในรายการกระเป๋าเงินของคุณ.