WithdrawExcessLamports บน Solana: คู่มือ SPL Token และ Token-2022

WithdrawExcessLamports คือคำสั่ง 38 ของ Token Program ซึ่งแก้ปัญหาเฉพาะด้าน กล่าวคือ มินต์ บัญชีโทเค็น หรือ multisig อาจถือแลมพอร์ตมากกว่าที่จำเป็นสำหรับการยกเว้นค่าเช่า แต่ไม่สามารถย้ายแลมพอร์ตเหล่านั้นด้วยการโอนโทเค็นตามปกติ

WithdrawExcessLamports ทำอะไร

คำสั่งนี้ใช้ได้ทั้งใน SPL Token Program แบบคลาสสิกและ Token-2022 โดยมีประโยชน์สำหรับเรียกคืนแลมพอร์ตที่ส่งไปยังบัญชีซึ่งโปรแกรมโทเค็นเป็นเจ้าของโดยไม่ตั้งใจก่อนข้อเสนอค่าเช่า 2026 เกณฑ์ค่าเช่าขั้นต่ำที่ลดลงทำให้คำสั่งนี้ใช้งานได้กว้างขึ้น เพราะบัญชีเก่าสามารถคงยอดเดิมไว้ขณะที่ต้องสำรองน้อยลง

ลักษณะการทำงานที่ใช้อ้างอิงและตัวอย่างไคลเอนต์ปัจจุบันอยู่ใน เอกสาร Withdraw Excess Lamports ของ Solana นอกจากนี้ การทำงานของตัวประมวลผลยัง เผยแพร่ต่อสาธารณะในที่เก็บโค้ดของ Token Program.

คำสั่งนี้ต้องใช้บัญชีใดบ้าง

ตัวประมวลผลจะอ่านความยาวข้อมูลของต้นทางและการตั้งค่าเช่าปัจจุบัน คำนวณยอดขั้นต่ำ แล้วโอนส่วนต่าง โดยไม่รับค่าเงินสำรองจากผู้เรียกซึ่งอาจล้าสมัยหรือถูกบิดเบือน

ต้นทางแต่ละประเภทต้องให้ใครลงนาม

กรณีมินต์ถูกเพิกถอนสิทธิ์ควรได้รับความใส่ใจเป็นพิเศษ หากมินต์ต้นทางสร้างจากคู่คีย์แบบ on-curve คู่คีย์เดิมนั้นต้องลงนาม หากเป็นแบบ off-curve โปรแกรมที่ควบคุมต้องเรียก Token Program โดยใช้ seed ผู้ลงนาม PDA ที่ถูกต้อง ผู้ถือโทเค็นหรืออดีตผู้มีสิทธิ์ในการมินต์ไม่สามารถลงนามแทนต้นทางได้

คุณจะสร้างคำสั่งด้วยไคลเอนต์ Solana ได้อย่างไร

ตัวอย่างทางการในปัจจุบันใช้ @solana-program/token ที่มีการกำหนดค่า @solana/kit ไคลเอนต์:

import { getWithdrawExcessLamportsInstruction } from "@solana-program/token";

const instruction = getWithdrawExcessLamportsInstruction({
    source,
    destination,
    authority,
});

await client.sendTransaction([instruction]);

ที่นี่ authority เป็น TransactionSigner ที่เหมาะสมกับต้นทาง สำหรับผู้มีสิทธิ์แบบ multisig ให้รวมผู้ร่วมลงนามผ่าน multiSigners ในระบบใช้งานจริง ให้ตรึงเวอร์ชันแพ็กเกจและคอมไพล์กับไคลเอนต์รุ่นที่ใช้งานโดยตรง เพราะชนิดข้อมูลของไคลเอนต์อาจเปลี่ยน แม้สัญญาบัญชีบนเชนจะไม่เปลี่ยนก็ตาม

ในกรณีนี้ SPL Token และ Token-2022 แตกต่างกันอย่างไร

ผลลัพธ์หลักของคำสั่งนั้นเหมือนกัน แต่ Token-2022 ทำให้การตั้งสมมติฐานเรื่องความยาวข้อมูลมีความเสี่ยงเป็นพิเศษ ส่วนขยายของมินต์และบัญชีจะเพิ่มขนาดข้อมูลที่ทำซีเรียลไลซ์แล้ว จึงทำให้ต้องใช้เงินสำรองเพิ่มขึ้น การผสานรวมที่ใช้ขนาดมาตรฐาน 82 หรือ 165 ไบต์กับทุกต้นทางอาจทำให้ยอดส่วนเกินสูงเกินจริง

CPI Guard ของ Token-2022 เป็นอีกหนึ่งความแตกต่างในทางปฏิบัติสำหรับตัวห่อหุ้ม เมื่อการ์ดถูกล็อก การเรียกข้ามโปรแกรมอาจถูกปฏิเสธ แม้โดยปกติกระเป๋าเงินจะเป็นผู้มีสิทธิ์ที่ถูกต้องก็ตาม Sol Incinerator จะข้ามต้นทางเหล่านั้นแทนการใส่รายการที่ล้มเหลวแน่นอนลงในธุรกรรมล้างข้อมูลขนาดใหญ่

บัญชีโทเค็น wrapped-SOL แบบเนทีฟจะถูกปฏิเสธด้วย NativeNotSupported. การแกะ wrapped SOL แบบเนทีฟใช้กระบวนการปิดบัญชีอีกแบบหนึ่ง ไม่ใช่การถอนแลมพอร์ตส่วนเกิน

Sol Incinerator API ห่อหุ้มคำสั่งนี้อย่างไร

API เวอร์ชัน v2 ของ Sol Incinerator สร้างการเรียก Token Program ผ่าน Assetcinerator เพื่อบังคับใช้ค่าธรรมเนียมโปรโตคอลและค่าธรรมเนียมพาร์ทเนอร์ที่เป็นตัวเลือกบนเชน ตัวห่อหุ้มนี้เป็นชั้นผลิตภัณฑ์ ส่วนคำสั่งดิบของ Token Program เองไม่ได้เรียกเก็บค่าธรรมเนียมของ Sol Incinerator

ใช้การแสดงตัวอย่างที่ผ่านการตรวจสอบสิทธิ์ก่อนขอให้ผู้ใช้ลงนาม

curl -X POST https://v2.api.sol-incinerator.com/withdraw-excess-lamports/preview \
  -H "content-type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "userPublicKey": "DESTINATION_WALLET",
    "sourceAccount": "TOKEN_ACCOUNT_MINT_OR_MULTISIG"
  }'

เส้นทางธุรกรรมและคำสั่งที่เกี่ยวข้องมีดังนี้

• POST /withdraw-excess-lamports
• POST /withdraw-excess-lamports-instructions

userPublicKey คือกระเป๋าเงินปลายทางและผู้มีสิทธิ์เริ่มต้น ระบุ authorityPublicKey เมื่อมินต์ ต้นทาง หรือผู้มีสิทธิ์แบบ multisig อื่นต้องลงนาม ระบุได้สูงสุด 11 multisigSignerPublicKeys เมื่อสร้างขั้นตอน token multisig คีย์ส่วนตัวทุกคีย์จะยังคงอยู่ภายในอุปกรณ์ ส่วน API จะส่งคืนข้อมูลสำหรับให้ผู้ลงนามที่จำเป็นอนุมัติ

ค่าธรรมเนียมพื้นฐานของโปรโตคอลคือ 200 bps. ผู้ผสานรวมโดยตรงสามารถเพิ่ม partnerFeeAccount และ partnerFeeBps ขณะที่ค่าธรรมเนียมธุรกรรม Solana ตามปกติจะแยกต่างหาก ให้ใช้ข้อมูลที่ส่งกลับมาในช่อง feeLamports และช่องข้อมูลการเรียกคืน แทนการนำผลคำนวณเปอร์เซ็นต์ที่แคชไว้กลับมาใช้

การผสานรวมควรรองรับข้อผิดพลาดใดบ้าง

• ไม่มีส่วนเกิน ยอดคงเหลือต้นทางเท่ากับเงินสำรองปัจจุบันอยู่แล้ว
• เจ้าของบัญชีหรือโครงสร้างข้อมูลไม่ถูกต้อง: ต้นทางไม่ใช่บัญชี Token Program ที่รองรับ
• ผู้มีสิทธิ์ไม่ถูกต้อง: ผู้ลงนามที่ระบุไม่ตรงกับสถานะต้นทางที่ถอดรหัสแล้ว
• ผู้ลงนาม multisig ไม่ครบ ระบุผู้ลงนามที่กำหนดค่าไว้และถูกต้องไม่ครบตามจำนวนขั้นต่ำ
• บัญชีแบบเนทีฟ wrapped SOL ใช้การดำเนินการอีกแบบหนึ่ง
• CPI Guard ถูกล็อก Token-2022 ปฏิเสธตัวห่อหุ้ม CPI
• สถานะเปลี่ยนแปลง ยอดคงเหลือ สิทธิ์ หรือการตั้งค่าเช่าเปลี่ยนหลังจากแสดงตัวอย่าง
• ต้นทุนธุรกรรมสูงกว่ามูลค่า: การถอนจำนวนเล็กน้อยอาจไม่คุ้มค่าหลังหักค่าธรรมเนียมเครือข่าย

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

บทความที่เกี่ยวข้อง

• Solana การลดค่าเช่า 2026
• วิธีเรียกคืน SOL ส่วนเกินโดยไม่ปิดบัญชีโทเค็น
• วิธีเรียกคืน SOL ส่วนเกินจากมินต์โทเค็น Solana
• การอนุมัติโทเค็นเทียบกับสิทธิ์ในการมินต์และอายัด