Solana Üzerinde WithdrawExcessLamports: SPL Token ve Token-2022 Kılavuzu

WithdrawExcessLamports Token Programı talimatı 38'dır. Dar kapsamlı bir sorunu çözer: Bir mint, token hesabı veya çoklu imza hesabı kiradan muafiyet için gerekenden fazla lamport tutabilir, ancak bu lamport'lar sıradan bir token aktarımıyla taşınamaz.

WithdrawExcessLamports ne yapar?

Talimat hem klasik SPL Token Programı'nda hem de Token-2022 içinde mevcuttur. 2026 kira önerisinden önce token sahipli hesaplara yanlışlıkla gönderilen lamport'ları geri almak için kullanışlıydı. Daha düşük bir asgari kira tutarı, kullanım alanını genişletir: eski hesaplar daha küçük bir rezerv gerektirirken orijinal bakiyelerini koruyabilir.

Referans davranış ve güncel istemci örneği şurada yer alır: Solana'ın Withdraw Excess Lamports belgeleri. İşleyici uygulaması da Token Programı deposunda herkese açıktır.

Talimat hangi hesapları gerektirir?

İşleyici, kaynağın veri uzunluğunu ve mevcut kira ayarlarını okur, asgari bakiyesini hesaplar ve farkı aktarır. Çağırıcı tarafından sağlanan, güncelliğini yitirmiş veya manipüle edilmiş olabilecek bir rezerv değerini kabul etmez.

Her kaynak türü için kim imzalamalıdır?

İptal edilmiş mint durumu özel dikkat gerektirir. Kaynak mint on-curve bir anahtar çiftinden oluşturulduysa, bu orijinal anahtar çifti imzalamalıdır. Off-curve ise, onu kontrol eden program doğru PDA imzalayıcı seed'leriyle Token Programı'nı çağırmalıdır. Bir token sahibi veya eski mint yetkilisi, kaynak imzasının yerine geçemez.

Solana istemcisiyle talimat nasıl oluşturulur?

Güncel resmî örnek şunu kullanır: @solana-program/token yapılandırılmış bir @solana/kit istemci:

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

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

await client.sendTransaction([instruction]);

Burada authority bir TransactionSigner kaynak için uygun olmalıdır. Çoklu imza yetkilisi için, ortak imzalayıcılarını şunun aracılığıyla ekleyin: multiSigners. Üretimde paket sürümlerini sabitleyin ve tam olarak kullandığınız istemci sürümüne göre derleyin; zincir üzerindeki hesap sözleşmesi değişmese bile istemci türleri değişebilir.

SPL Token ile Token-2022 burada nasıl farklılık gösterir?

Talimatın temel etkisi aynıdır, ancak Token-2022 veri uzunluğu varsayımlarını özellikle riskli kılar. Mint ve hesap uzantıları serileştirilmiş boyutu, dolayısıyla gerekli rezervi artırır. Her kaynak için standart 82 veya 165 bayt boyutlarını kullanan bir entegrasyon fazlalığı olduğundan yüksek gösterebilir.

Token-2022'ın CPI Guard özelliği, sarmalayıcılar açısından bir başka pratik farktır. Guard kilitliyken cüzdan normalde geçerli bir yetkili olsa bile programlar arası çağrı reddedilebilir. Sol Incinerator, kesin olarak başarısız olacak tek bir işlemi daha büyük bir temizleme işlemine eklemek yerine bu kaynakları atlar.

Yerel sarılmış SOL token hesapları şu hatayla reddedilir: NativeNotSupported. Yerel SOL'ın sarmalamasını kaldırmak farklı bir hesap kapatma yolunu izler; bu, fazla lamport çekimi değildir.

Sol Incinerator API talimatı nasıl sarmalar?

Sol Incinerator v2 API, protokol ve isteğe bağlı iş ortağı ücretlerinin zincir üzerinde uygulanması için Token Programı çağrısını Assetcinerator üzerinden oluşturur. Bu sarmalayıcı bir ürün katmanıdır; ham Token Programı talimatının kendisi Sol Incinerator ücretini uygulamaz.

Kullanıcıdan imza istemeden önce doğrulanmış önizlemeyi kullanın:

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"
  }'

İlgili işlem ve talimat yolları şunlardır:

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

userPublicKey hedef cüzdan ve varsayılan yetkilidir. Şunu sağlayın: authorityPublicKey farklı bir mint, kaynak veya çoklu imza yetkilisinin imzalaması gerektiğinde. En fazla 11 sağlayın multisigSignerPublicKeys bir token çoklu imza akışı oluştururken. Tüm özel anahtarlar yerelde kalır; API, gerekli imzalayıcıların onaylaması için materyal döndürür.

Temel protokol ücreti 200 bps. Doğrudan bir entegratör bir partnerFeeAccount ve partnerFeeBps, normal Solana işlem ücreti ise ayrı kalır. Döndürülen feeLamports ve önbelleğe alınmış bir yüzde hesaplamasını yeniden kullanmak yerine geri alma alanlarını kullanın.

Bir entegrasyon hangi hataları ele almalıdır?

• Fazlalık yok: kaynak bakiyesi zaten mevcut rezerv seviyesindedir.
• Yanlış hesap sahibi veya düzeni: kaynak, desteklenen bir Token Programı hesabı değildir.
• Geçersiz yetki: sağlanan imzalayıcı, çözümlenen kaynak durumuyla eşleşmiyor.
• Eksik çoklu imza: yetersiz sayıda geçerli yapılandırılmış imzalayıcı sağlandı.
• Yerel hesap: sarılmış SOL başka bir işlem kullanır.
• Kilitli CPI Guard: Token-2022, sarmalayıcı CPI işlemini reddeder.
• Durum değişti: önizlemeden sonra bir bakiye, yetki veya kira ayarı değişti.
• İşlem maliyeti değeri aşıyor: çok küçük bir çekim, ağ ücretlerinden sonra ekonomik olmayabilir.

Durum değişmiş olabileceğinde yeniden önizleyin, kaynak seçimini idempotent tutun ve uygun olmadığı bilinen bir kaynağı asla diğer geçerli işlemlerle gruplandırmayın.

İlgili İçerikler

• Solana Kira İndirimi 2026
• Token Hesaplarını Kapatmadan Fazla SOL Nasıl Geri Alınır?
• Bir Solana Token Mint'inden Fazla SOL Nasıl Geri Alınır?
• Token Onayı ile Basım ve Dondurma Yetkisi Arasındaki Fark