ซีรี่ส์ Web3 Newbie: สำรวจการเข้าสู่ระบบด้วย Solana Token

NFT (โทเค็นที่ไม่สามารถทดแทนกันได้) ซึ่งเป็นโทเค็นที่ ไม่สามารถถูกแทนที่ได้ ตามชื่อของมัน เหมาะมากสำหรับใช้เป็นเครื่องมือตรวจสอบตัวตน

ต่อไป ให้เราสำรวจความเป็นไปได้ของการใช้ NFT เป็นใบรับรองการจดทะเบียนผ่านตัวอย่างง่ายๆ

คำนำ

ก่อนที่เราจะเริ่ม ให้ฉันแนะนำเครื่องมือที่เราจะใช้ต่อไป

โทเค็น SPL

เราสามารถเขียนสัญญา Solana ใหม่ได้ตั้งแต่เริ่มต้น แต่เพื่อจุดประสงค์ที่เราต้องการบรรลุในปัจจุบัน เราสามารถใช้การใช้งานทั่วไปของ Solana: Token Program ได้โดยตรง

โปรแกรม Token เป็นส่วนหนึ่งของไลบรารีโปรแกรม Solana (SPL, https://spl.solana.com/) SPL มีการใช้งานโปรแกรมทั่วไปหลายอย่าง รวมถึง Token, Swap และ Memo และมีไลบรารีไคลเอ็นต์และ CLI ที่สมบูรณ์และเครื่องมืออื่นๆ ซึ่งอำนวยความสะดวกให้กับนักพัฒนา Solana อย่างมาก

ซอร์สโค้ดโครงการของ Token Program อยู่ที่: https://github.com/solana-labs/solana-program-library/tree/master/token/program

สนามเด็กเล่นโซลานา

Solpy (https://beta.solpg.io/) จัดเตรียมสภาพแวดล้อมสำหรับการเขียนและปรับใช้สัญญา Solana ทางออนไลน์ และรวมเครื่องมือที่ใช้กันทั่วไปตามค่าเริ่มต้น รวมถึง SPL Token ที่นำมาใช้ในส่วนก่อนหน้า ช่วยให้เราสร้างและจัดการ Token ได้อย่างง่ายดายผ่าน spl-token-cli

โทเค็นการรับรองความถูกต้อง

ในส่วนนี้เราจะสร้าง NFT Token หากผู้ใช้ Mint Token ที่อยู่กระเป๋าสตางค์จะถือว่าได้รับการลงทะเบียนในระบบของเรา มิฉะนั้นผู้ใช้จะได้รับแจ้งให้ลงทะเบียนก่อน

ตอนนี้ เรามาเริ่มกันที่ส่วน On-chain:

สร้างโทเค็น

เราใช้ spl-token เพื่อสร้างโทเค็นใหม่ และส่ง --decimals เพื่อระบุว่าเป็นโทเค็นที่แบ่งแยกไม่ได้ (เช่นเดียวกับ NFT)

บันทึกต่อไปนี้จะถูกส่งออก:

ในหมู่พวกเขา 69yXraTu3FqXZkATg6MiRnWT2qHd4tRzWsfCHHE9j2XE มักเรียกว่า Mint Address ซึ่งเป็น ID ของ Token ที่เราสร้างขึ้น

ที่อยู่โทเค็นคือ:

https://solscan.io/token/69yXraTu3FqXZkATg6MiRnWT2qHd4tRzWsfCHHE9j2XE?cluster=devnet

สร้างบัญชีโทเค็น

ต่อไปเราต้องสร้างบัญชี Token สำหรับ Token ที่สร้างในขั้นตอนก่อนหน้า

สะระแหน่

ก่อนที่จะสร้างโทเค็นใหม่ด้วยที่อยู่กระเป๋าเงินอื่น ให้เราลองสร้างหน่วยโทเค็นสำหรับบัญชีโทเค็นที่สร้างขึ้นในขั้นตอนก่อนหน้าก่อน เพียงป้อน:

บันทึกต่อไปนี้จะถูกส่งออก:

อีกทางหนึ่ง:

คุณยังสามารถลองใช้ค่ามินต์อื่น ๆ เช่น 1.9:

เมื่อดูรายละเอียดธุรกรรม คุณจะพบว่าเนื่องจากเราระบุ --decimals เป็น 0 เมื่อสร้าง Token ในขั้นตอนแรก เมื่อดำเนินการ Mint จริง ส่วนทศนิยมจะถูกละทิ้ง ดังนั้นจำนวน Mint จะยังคงเป็น 1 .

คุณยังสามารถลองมอบโทเค็นเหรียญกษาปณ์ไปยังที่อยู่กระเป๋าสตางค์ได้โดยตรง ที่นี่เราใช้ 4wztJ4CAH4GbAUopZrVk7nLvoAC3KAF6ttMMWfnBRG1t เพื่อสาธิต:

มิ้นท์สำหรับที่อยู่กระเป๋าเงิน

เป้าหมายของการดำเนินการ Mint ข้างต้นคือที่อยู่ Token Mint และตามแนวคิดเดิมของเรา Mint ควรมอบให้กับที่อยู่กระเป๋าเงินอื่นที่ไม่ได้เป็นของเรา

ต่อไป มาทำตามขั้นตอนเริ่มต้นด้านบนโดยใช้ที่อยู่กระเป๋าเงินของผู้ใช้ Web3

• โทเค็นเราใช้โดยตรง 69yXraTu3FqXZkATg6MiRnWT2qHd4tRzWsfCHHE9j2XE ข้างต้น

• ที่อยู่กระเป๋าเงิน: ใช้ 4wztJ4CAH4GbAUopZrVk7nLvoAC3KAF6ttMMWfnBRG1t

แต่เมื่อเราเปลี่ยนพารามิเตอร์โดยตรง เราก็จะได้ผลลัพธ์ที่ไม่คาดคิด:

มีที่อยู่อยู่ แต่ที่อยู่ที่กำหนดโดย Mint ไม่ใช่ที่อยู่กระเป๋าเงินเดิม แต่เป็นบัญชีโทเค็นที่ต้องเชื่อมโยงด้วย

เราจำเป็นต้องดำเนินการตามกระบวนการเดียวกันกับข้างต้น: สร้างบัญชี Token สำหรับที่อยู่กระเป๋าเงิน จากนั้นใช้บัญชี Token ที่สร้างขึ้นเพื่อสร้างหน่วย Token ใหม่

กล่าวอีกนัยหนึ่ง หากเราต้องการสร้างหน่วยโทเค็นสำหรับที่อยู่กระเป๋าสตางค์หนึ่งๆ เราต้องสร้างบัญชีโทเค็นสำหรับที่อยู่กระเป๋าสตางค์นี้ก่อน สำหรับสาเหตุที่เราต้องทำเช่นนี้ เหตุผลหนึ่งก็คือ เราไม่มีอำนาจในการแก้ไขข้อมูลของที่อยู่บางแห่งโดยตรง

ในเอกสารของ Solana บางครั้งคุณอาจเห็นแนวคิดสองประการที่คล้ายกัน: บัญชีโทเค็น และบัญชีโทเค็นที่เกี่ยวข้อง (ATA) เอกสารดูเหมือนว่าทั้งสองจะเกี่ยวข้องกัน แต่ไม่ได้อธิบายสิ่งนี้ซึ่งทำให้สับสนมาก

แต่ถ้าคุณดูเอกสารของ Metaplex คุณจะพบว่าระบุไว้อย่างชัดเจนว่า: “บัญชีโทเค็นที่เกี่ยวข้อง ซึ่งบางครั้งเรียกง่ายๆ ว่าบัญชีโทเค็น”

เราจะไม่เจาะลึกสองสิ่งนี้ในที่นี้ ลองจินตนาการว่าบัญชีโทเค็นเป็นตัวกลางระหว่างโทเค็นและที่อยู่กระเป๋าเงิน

เราใช้คำสั่งต่อไปนี้เพื่อสร้างบัญชีโทเค็นสำหรับที่อยู่กระเป๋าเงิน:

การสร้างซ้ำจะทำให้เกิดข้อผิดพลาด:

นอกจากนี้ยังสามารถเห็นได้ในบันทึกว่าบัญชีโทเค็นที่ได้รับจากบัญชี Mint ที่กำหนดและที่อยู่กระเป๋าเงินถูกกำหนดไว้ (3JocyxV4LX4VbNU248CvNozZphgRW5JTyxn7FPWrF8bx) แต่เนื่องจากมีอยู่แล้ว ข้อความแสดงข้อผิดพลาดจึงถูกพิมพ์ออกมา

รับบัญชีโทเค็น

เราจำเป็นต้องใช้อินเทอร์เฟซ RPC เพื่อดูว่าที่อยู่กระเป๋าเงินบางแห่งมี Mint เป็น NFT ที่เราสร้างขึ้นหรือไม่ โดยเฉพาะ ค้นหาข้อมูลผ่านเมธอด getTokenAccountsByOwner ต่อไปนี้เป็นพารามิเตอร์ที่อินเทอร์เฟซต้องการ:

คุณจะต้องแทนที่ _YOUR_RPC_PROVIDER_ ด้วยที่อยู่ที่ให้ไว้โดยผู้ให้บริการ RPC ที่คุณเลือก

คุณสามารถใช้ที่อยู่ที่ได้รับอย่างเป็นทางการจาก Solana หรือคุณสามารถค้นหาเครือข่าย RPC สาธารณะฟรีได้ที่นี่: https://zan.top/service/public-rpc/solana

หมายเหตุ: ที่อยู่สาธารณะอาจไม่เสถียร หากคุณต้องการบริการ RPC ที่เสถียร ขอแนะนำให้สร้างคีย์ API ของคุณเอง

สำหรับที่อยู่กระเป๋าเงินด้านบน ข้อมูลเฉพาะมีดังนี้:

นอกเหนือจากการกรอกพารามิเตอร์คำขอด้วยตนเองผ่านโค้ดแล้ว คุณยังสามารถใช้เมธอด getParsedTokenAccountsByOwner บนการเชื่อมต่อที่ให้ไว้ใน @solana/web3.js ภายใน เมธอด getParsedTokenAccountsByOwner จริงๆ แล้วจะถูกเรียกผ่านอินเทอร์เฟซ RPC ที่ให้ไว้เมื่อสร้าง การเชื่อมต่อ.

หากเป็นกระเป๋าเงินที่สร้าง Account Token แล้ว มันจะส่งคืน:

ข้อมูลที่ถูกลบซึ่งไม่เป็นประโยชน์สำหรับเราอีกต่อไป

ทำให้สำเร็จ

จากความพยายามข้างต้น เราจะเห็นว่าเราสามารถใช้ความสามารถที่มีอยู่เพื่อให้บรรลุฟังก์ชันที่เราต้องการได้ จากนั้นจึงเริ่มเขียนโค้ดลูกค้า

รหัสต่อไปนี้อยู่ที่https://github.com/gin-lsl/my-sol-token-auth-example

คุณสามารถดูตัวอย่างได้ที่นี่: https://my-sol-token-auth-example.vercel.app/

ฉันจะนำไปใช้โดยสร้างโปรเจ็กต์ Nextjs ง่ายๆ โดยใช้ Ant Design Web3 เพื่อเชื่อมต่อ Wallet:

เริ่มต้นโครงการ Nextjs

ใช้ค่าเริ่มต้นสำหรับตัวเลือกทั้งหมด:

เพื่อเริ่มต้นอย่างรวดเร็ว เราใช้ @ant-design/web3-solana โดยตรงเพื่อเชื่อมต่อกับกระเป๋าเงิน และใช้ @solana/spl-token เพื่อโต้ตอบกับ Token Program

เพิ่มการอ้างอิงที่เกี่ยวข้อง:

เราจำเป็นต้องรวม 3 หน้าไว้ในหน้าแรก สร้าง app/sign-in/page.tsx และ app/sign-on/page.tsx ใช้เพื่อเชื่อมต่อกับกระเป๋าเงินและตรวจสอบว่าผู้ใช้ได้ลงทะเบียนแล้ว (mint NFT หรือไม่) และให้ผู้ใช้ดำเนินการตามขั้นตอนการลงทะเบียน (mint NFT)

หลังจากเปิดหน้าสาธิต สิ่งแรกที่คุณเห็นคือข้อความต้อนรับและลิงก์ไปยังหน้าลงชื่อเข้าใช้:

หลังจากเข้าสู่หน้าคุณต้องลงชื่อเข้าใช้ก่อน:

คลิก ดำเนินการต่อกับ Solana และกระเป๋าเงินจะปรากฏขึ้น

หากคุณยังไม่เคยลงทะเบียนมาก่อน คุณจะได้รับแจ้งให้ลงทะเบียนก่อน:

เนื่องจากในตรรกะของ /api/sign-in บัญชีโทเค็นที่เกี่ยวข้องจะถูกค้นหาตามที่อยู่กระเป๋าเงินที่เชื่อมต่อ เนื่องจากเราไม่เคยใช้มาก่อน จึงไม่สามารถหาข้อมูลได้ ดังนั้นระบบจะคิดว่าที่อยู่กระเป๋าเงินนี้ยังไม่ได้ลงทะเบียน

จากนั้นเราปฏิบัติตามคำแนะนำและไปที่หน้าลงชื่อเข้าใช้ โดยทั่วไปหน้าลงทะเบียนจะคล้ายกับหน้าเข้าสู่ระบบ ยกเว้นว่าตรรกะการประมวลผลบนฝั่งเซิร์ฟเวอร์จะแตกต่างออกไป:

ในความเป็นจริง ตรรกะทั้งสองสามารถนำมารวมกันได้ แต่จะแยกออกจากกันที่นี่เพื่อความสะดวกในการสาธิตเท่านั้น

อย่างไรก็ตาม คลิก “เริ่มต้นด้วย Solana” เพื่อเชื่อมต่อกระเป๋าเงิน จากนั้น หากทุกอย่างเป็นไปด้วยดี คุณจะเห็นข้อความแสดงความสำเร็จ:

เข้าสู่ Solscan แล้วดูว่าเกิดอะไรขึ้น ป้อน https://solscan.io/?cluster=devnet และตรวจสอบที่อยู่กระเป๋าเงินของคุณ หรือคุณสามารถตรวจสอบที่อยู่นี้: 79reVF46NyuuH7PADR3i6RpQ7hmBZgYkiieXNYPM1oLF

มีข้อมูลธุรกรรมชิ้นหนึ่ง:

โปรดทราบว่าในคำแนะนำ คุณจะเห็นว่าคำสั่ง CreateAccount ดำเนินการภายในธุรกรรม คลิกลิงก์เพื่อป้อนรายละเอียด และคุณจะพบว่าสิ่งที่สร้างขึ้นคือ TokenAccount: EXfDYkHw3UQw2VqiSLsRAfLMsxkgqnd3nhxbB4V5HAvA ค่า isOnCurve เป็นเท็จ ซึ่งบ่งชี้ว่าเป็นบัญชีที่เกี่ยวข้องกันโดยไม่มีคีย์ส่วนตัว

กลับไปที่หน้าก่อนหน้า ไปที่ Portfolio -> NFT และคุณจะเห็นการดำเนินการ Mint ที่เราเพิ่งทำในการลงชื่อเข้าใช้ เช่นเดียวกับ Mint NFT:

สรุป

เรามาสรุปกระบวนการทั้งหมดกันดีกว่า เราใช้ spl-token-cli เพื่อสร้าง NFT จากนั้นตรวจสอบว่าที่อยู่กระเป๋าสตางค์มีบัญชี Token และ Mint the Token เพื่อตรวจสอบว่าได้มีการลงทะเบียนบนเว็บไซต์ของเราหรือไม่

เมื่อผู้ใช้ Web3 เชื่อมต่อกับกระเป๋าเงิน เราจะส่งการลงชื่อเข้าใช้ไปยังแบ็กเอนด์โดยอัตโนมัติ สร้างบัญชีโทเค็นภายใน และสร้างหน่วยโทเค็นเป็นข้อมูลรับรองที่ลงทะเบียนของผู้ใช้

ในอนาคตผู้ใช้สามารถใช้ที่อยู่กระเป๋าเงินเดียวกันเพื่อเข้าสู่เว็บไซต์ของเราอีกครั้ง

บทความนี้เขียนโดย gin-lsl จากทีม ZAN (บัญชี X @zan_team )