ทำไม Midnight wallet SDK ถึงเปลี่ยนชื่อ และทำไมเราต้องสนใจ?
หากคุณกำลังพัฒนาโปรเจกต์บน Web3 โดยใช้ Midnight wallet SDK (ชุดเครื่องมือสำหรับนักพัฒนาเพื่อเชื่อมต่อกับกระเป๋าเงินดิจิทัล) คุณอาจจะสังเกตเห็นการเปลี่ยนแปลงเล็กๆ น้อยๆ ในช่วงที่ผ่านมา การเปลี่ยน npm scope (พื้นที่เก็บแพ็กเกจในคลังโปรแกรม npm) เปรียบเสมือนการเปลี่ยนชื่อถนนที่ที่อยู่ของคุณตั้งอยู่ แม้ว่าจดหมายจะยังส่งถึงที่เดิมในตอนนี้ แต่ในอนาคตอันใกล้ ชื่อถนนเก่าจะถูกยกเลิกการใช้งานอย่างถาวร
npm scope คือการแบ่งกลุ่มของไลบรารีหรือแพ็กเกจในระบบนิเวศของ Node.js เพื่อป้องกันชื่อซ้ำกัน เช่น @mycompany/my-package สำหรับนักพัฒนาโปรแกรมมือใหม่ นี่เป็นโอกาสดีที่คุณจะได้เรียนรู้วิธีการจัดการ Dependency (ซอฟต์แวร์ที่เรานำมาใช้ร่วมกับโค้ดของเรา) ให้เป็นปัจจุบันอยู่เสมอ เพื่อป้องกันปัญหาโปรเจกต์พังในอนาคตเมื่อเวอร์ชันเก่าถูกถอดออก
ทำไมต้องสนใจเรื่องนี้ทั้งที่โค้ดยังรันได้ปกติ? คำตอบคือ ความปลอดภัยและการอัปเดตฟีเจอร์ใหม่ ครับ หากเรายังฝังใจอยู่กับชื่อเก่า เราจะพลาดการแก้ไขบั๊ก (Bug Fixes) และความสามารถใหม่ๆ ที่ทีมพัฒนาปล่อยออกมาเฉพาะในชื่อใหม่เท่านั้น การทำความเข้าใจเรื่องนี้จะช่วยให้คุณก้าวไปเป็นโปรแกรมเมอร์ที่ดูแลรักษาโปรเจกต์ได้ยั่งยืนกว่าคนอื่น
การเปลี่ยนแปลงครั้งใหญ่: จากมีขีด สู่ไม่มีขีด
การเปลี่ยนแปลงที่เกิดขึ้นคือการเปลี่ยนชื่อ Scope จาก @midnight-ntwrk (ที่มีขีดกลาง) ไปเป็น @midnightntwrk (แบบไม่มีขีดกลาง) นี่คือการปรับโครงสร้างเพื่อความสะดวกในการเรียกใช้และจัดระเบียบใหม่ของทีมพัฒนา โดยแพ็กเกจหลักอย่าง wallet-sdk-facade จะย้ายบ้านไปอยู่ที่ใหม่ทันที
ลองจินตนาการว่าคุณต้องไปรับของที่ตู้ล็อกเกอร์ ถ้าตู้เดิมเริ่มไม่เปิดให้ใส่ของใหม่แล้ว แต่ยังมีของเก่าค้างอยู่ คุณย่อมต้องเปลี่ยนไปใช้ตู้ใหม่เพื่อรับของที่สดใหม่กว่า ในโลกการเขียนโปรแกรม npm คือตู้ล็อกเกอร์นั้นครับ หากคุณยังอ้างอิงชื่อเก่า โค้ดของคุณจะได้รับแค่เวอร์ชันเก่าที่ทีมงานนำมาวางไว้เป็น "ทางผ่าน" ชั่วคราวเท่านั้น
ความแตกต่างของเวอร์ชันที่คุณจะได้รับหากไม่เปลี่ยนชื่อ มีดังนี้:
wallet-sdk-facade: ชื่อเก่าได้ v4.0.1 แต่ชื่อใหม่ได้ v4.1.0wallet-sdk-hd: ชื่อเก่าได้ v3.0.2 แต่ชื่อใหม่ได้ v3.0.3wallet-sdk-shielded: ชื่อเก่าได้ v3.0.1 แต่ชื่อใหม่ได้ v3.0.2
จุดที่มือใหม่มักพลาด: กฎเหล็กของ ledger-v8
เมื่อเราเรียนรู้เรื่องการเปลี่ยนชื่อ หลายคนจะใช้วิธี Find and Replace (การค้นหาและแทนที่คำทั้งหมดในโปรเจกต์) เพื่อเปลี่ยนชื่อ @midnight-ntwrk ให้เป็น @midnightntwrk ทั้งหมดทันที แต่ช้าก่อนครับ! การทำแบบนั้นจะทำให้โปรเจกต์ของคุณพังทันที เพราะมีบางแพ็กเกจที่ "ห้ามเปลี่ยนชื่อ" เด็ดขาด
แพ็กเกจที่ต้องคงชื่อเดิมไว้คือ @midnight-ntwrk/ledger-v8 และ @midnight-ntwrk/zkir-v2 เนื่องจากเป็นซอฟต์แวร์สนับสนุนจากภายนอก (Upstream dependencies) ที่ยังไม่ได้ย้าย Scope ตาม SDK หลัก หากคุณเผลอเปลี่ยนชื่อมันไปเป็นแบบไม่มีขีดกลาง โปรแกรมจะหาที่อยู่ของแพ็กเกจไม่เจอและแจ้งเตือน Error ทันที
หลักการสำคัญ สำหรับโปรแกรมเมอร์คือ "อ่านเอกสารให้ละเอียดก่อนลงมือแก้ไข" การที่แพ็กเกจหนึ่งย้ายบ้าน ไม่ได้หมายความว่าทุกอย่างในห้องครัวจะย้ายตามไปหมด การแยกแยะให้ชัดเจนว่าส่วนไหนคือ SDK ของเรา และส่วนไหนคือเครื่องมือจากภายนอก เป็นทักษะสำคัญที่แยกมือสมัครเล่นออกจากมืออาชีพ
ขั้นตอนการอัปเดต: ทำอย่างไรให้ปลอดภัย
การอัปเดตที่ถูกต้องคือการเลือกแก้เฉพาะตัวที่จำเป็นเท่านั้น โดยเริ่มจากการใช้คำสั่ง npm install เพื่อติดตั้งแพ็กเกจใหม่ลงในโปรเจกต์ของคุณ ให้สังเกตว่าเราจะระบุชื่อใหม่สำหรับ SDK แต่คงชื่อเดิมไว้สำหรับแพ็กเกจที่เป็นข้อยกเว้น
ลองดูตัวอย่างการติดตั้งที่ถูกต้องด้านล่างนี้ครับ:
# ติดตั้งแพ็กเกจ SDK ใหม่ (ไม่มีขีดกลาง)
npm install @midnightntwrk/wallet-sdk-facade@latest \
@midnightntwrk/wallet-sdk-hd@latest
# คงชื่อเดิมไว้สำหรับแพ็กเกจที่เป็นข้อยกเว้น
npm install @midnight-ntwrk/ledger-v8@latest
หลังจากรันคำสั่งเหล่านี้แล้ว ให้คุณตรวจสอบไฟล์ package.json ของคุณว่ามีรายการแพ็กเกจที่ถูกต้องหรือไม่ หากเห็นชื่อ @midnightntwrk ปรากฏขึ้นมาแทนที่ชื่อเดิมในส่วนของ SDK ถือว่าคุณมาถูกทางแล้วครับ นี่คือขั้นตอนแรกในการทำความสะอาดโปรเจกต์ให้เป็นมาตรฐานใหม่
การแก้ไขไฟล์ Import ในโค้ดของคุณ
เมื่อเราติดตั้งแพ็กเกจเสร็จแล้ว สิ่งถัดมาที่ต้องทำคือการแก้ไขไฟล์ .js หรือ .ts ที่มีการดึงข้อมูลเข้ามาใช้งาน ซึ่งเราเรียกว่าการ Import (การนำโค้ดจากไลบรารีอื่นเข้ามาใช้ในไฟล์ของเรา) คุณต้องเปลี่ยนที่อยู่ของไฟล์เหล่านี้ให้ถูกต้องตามชื่อใหม่
เปรียบเทียบโค้ดแบบเดิมและแบบใหม่ที่ถูกต้อง:
// แบบเดิม (ที่กำลังจะถูกยกเลิก)
import { WalletFacade } from '@midnight-ntwrk/wallet-sdk-facade';
// แบบใหม่ (ที่ควรใช้)
import { WalletFacade } from '@midnightntwrk/wallet-sdk-facade';
// คงไว้เหมือนเดิม (เพราะ ledger-v8 ไม่ย้าย Scope)
import * as ledger from '@midnight-ntwrk/ledger-v8';
การแก้ไขนี้ทำเพียงครั้งเดียวในไฟล์ที่เรียกใช้แพ็กเกจเหล่านั้น เมื่อคุณบันทึกไฟล์และรันโปรแกรมอีกครั้ง ให้สังเกตที่ Terminal หากไม่มีข้อความ Module not found แสดงว่าการเชื่อมต่อของคุณสมบูรณ์แบบแล้วครับ
สรุป: การดูแลรักษาโปรเจกต์ในระยะยาว
การอัปเดต SDK ในครั้งนี้เป็นบทเรียนที่ดีมากสำหรับคนที่กำลังฝึกเขียนโค้ดครับ มันไม่ได้เป็นแค่เรื่องของการเปลี่ยนชื่อ แต่เป็นเรื่องของการทำความคุ้นเคยกับการดูแลรักษาซอฟต์แวร์ (Maintenance) เมื่อผู้สร้างเครื่องมือมีการเปลี่ยนแปลง เราในฐานะผู้ใช้งานก็ต้องเรียนรู้ที่จะปรับตัวตามอย่างถูกวิธี
ตัวอย่างการนำไปใช้จริง: สมมติว่าคุณกำลังทำโปรเจกต์จบการศึกษา หากคุณใช้ชื่อแพ็กเกจเก่าไปเรื่อยๆ จนถึงวันที่ทีมพัฒนาเลิกสนับสนุน (Deprecated) โปรเจกต์ของคุณอาจจะติดตั้งไม่ได้อีกต่อไปในเครื่องของอาจารย์ การหมั่นตรวจสอบบันทึกการอัปเดต (Release Notes) จะช่วยให้คุณป้องกันปัญหาเหล่านี้ได้ก่อนที่จะเกิดขึ้นจริง
สุดท้ายนี้ จำไว้ว่า ความละเอียดรอบคอบคืออาวุธสำคัญของโปรแกรมเมอร์ ไม่ว่าจะเป็นการเปลี่ยนชื่อแพ็กเกจ หรือการแก้ไขบั๊กเล็กๆ น้อยๆ การใส่ใจกับรายละเอียดเหล่านี้จะทำให้คุณเป็นนักพัฒนาที่ทีมงานไว้วางใจ และทำให้โค้ดของคุณมีคุณภาพสูงและพร้อมสำหรับการใช้งานในอนาคตครับ
ที่มา: The Midnight wallet SDK changed its npm scope. Here is what to update. — DEV Community
