x402, yapay zeka ajanlarının API'lere HTTP 402 üzerinden zincin üstü USDC ile ödeme yapmasını sağlıyor

dev.to'da yayınlanan bir geliştirici yazısı, yapay zeka ajanlarının zincin üstü USDC ile API erişimi satın almasını sağlayan ödeme şeması x402'ın Base mainnet üzerinde dağıtılıp test edilmiş çalışan bir uygulamasını belgeliyor.

Yazarlar sorunu açıkça ortaya koyuyor: Otonom ajanlar giderek artan biçimde diğer makinelerin sunduğu veri akışları, işlem gücü, depolama ve hizmetler için ödeme yapması gerekiyor; ancak Stripe ve PayPal gibi mevcut ödeme altyapıları insani bir katılımcı varsayıyor. Hesaplar, kartlar, API anahtarları, onay akışları ve kimlik doğrulama adımları, kendi adına hareket eden yazılımlarla iyi eşleşmiyor.

x402'ın cevabı, HTTP 402 Payment Required durum kodunu nadiren görülen bir hatadan gerçek bir ödeme el sıkışmasına dönüştürmek.

Akış nasıl çalışıyor

Yazıya göre etkileşim şöyle işliyor: Ajan ücretli bir kaynak istiyor. Sunucu 402 durumuyla birlikte makine tarafından okunabilir ödeme koşullarıyla yanıt veriyor: tutar, ağ, alıcı adresi ve varlık. Ajanın SDK'sı zincin dışında bir EIP-3009 TransferWithAuthorization mesajı imzalıyor, ardından özgün isteği X-PAYMENT başlığında eklenmiş yetkilendirmeyle yeniden deniyor.

Sunucu bu imzayı bir facilitator'a iletiyor; facilitator imzayı doğruluyor ve transferi Base üzerinde sonuçlandırıyor. Facilitator işlem gas'ını ödüyor — maliyeti komisyon modeliyle karşılıyor — böylece ajan istek başına kendi zincin üstü işlemini göndermiyor. Ödeme sonuçlandıktan sonra sunucu kaynağı sıradan bir 200 yanıtıyla döndürüyor ve satıcı USDC'ye sahip oluyor.

Merkezde EIP-3009 imzaları

İmzalı mesaj, ödeme yapanın adresini, satıcının adresini, token'ın altı ondalık hassasiyetiyle ifade edilen USDC tutarını, bir geçerlilik penceresini ve aynı yetkilendirmenin tekrar oynatılmasını engelleyen bir nonce taşıyor. Facilitator, zincine herhangi bir şey göndermeden önce nonce'un kullanılmadığını kontrol ediyor.

Bu uygulamada facilitator, API'nin kendisiyle birlikte bir Fastify modülü olarak çalışıyor; geliştiriciler bunun, dağıtımı paylaşılan bir genel facilitator hizmetine bağlı kılmak yerine kendi içinde tutarlı hale getirdiğini söylüyor.

Python ve TypeScript için eşleşen SDK'lar

Ekip, el sıkışmasını çağırandan gizleyen iki SDK'yı açık kaynak yaptı. Python'da özel bir anahtarla başlatılan istemci tek bir fetch çağrısı sunuyor; hedef API 402 ile yanıt verdiğinde SDK ödeme koşullarını keşfediyor, imzalıyor, yeniden deniyor ve hem ödenen yanıtı hem de ödemeyi onaylayan bir bayrağı döndürüyor. TypeScript SDK'sı aynı yapıyı yansıtıyor; böylece her iki dildeki ajanlar da özdeş bir akış elde ediyor.

Keşif, abonelikler ve kötüye kullanım kontrolleri

Ajanların fiyatlandırılmış hizmetleri bulabilmesi için platform, makine tarafından okunabilir bir katalog yayınlayan bir /discover endpoint'i sunuyor. Örnek payload, her kaynağı ödeme şeması, ağ, alıcı adresi ve maksimum tutarla listeliyor — 50000 birim, yani USDC'nin altı ondalığıyla 0,05 dolar.

İstek başına ödeme modelinin üzerine, platformun payını düşüren abonelik katmanları eklenmiş: yüzde 10 komisyonla ücretsiz katman, ayda 29 dolarlık Pro katmanı yüzde 5 ve ayda 299 dolarlık Enterprise katmanı yüzde 2. Aboneliklerin kendileri geleneksel biçimde yürütülüyor — Clerk ile kayıt, Stripe ile ödeme; webhook'lar katmanı ve komisyon yüzdesini veritabanına yazıyor, x402 middleware'ı da istek zamanında bunları okuyarak her ödemeyi satıcı ve platform arasında bölüştürüyor.

Yazı ayrıca moderasyon araçlarını da anlatıyor: Kuruluşlar veritabanında bir askıya alma bayrağı taşıyor, askıya alınmış hesaplar ödeme isteklerinde HTTP 403 alıyor ve keşif kataloğundan çıkarılıyor; saatlik bir cron işi ve webhook olayları askıya almayı otomatik tetikleyebiliyor.

Mainnet üzerinde doğrulandı

Geliştiriciler Base mainnet üzerinde, zincir kimliği 8453, uçtan uca tamamlanmış bir ödeme bildiriyor: Piyasa verisi endpoint'i için 0,05 dolar USDC, işlem hash'i yayımlandı ve zincin üstü komisyon yüzde 5 olarak kaydedildi; bu da Pro katmanı fiyatlandırmasının uygulandığını doğruluyor. Daha önceki bir testnet işlemi de kaydedilmiş.

Neden önemli

Ajanlar arası ticaretin, yazılımın gerçekten kullanabileceği bir ödeme altyapısına ihtiyacı var. x402, ödemeleri ajanların zaten konuştuğu istek-yanıt desenine oturtuyor; hesapları ve onay akışlarını bir cüzdan ve bir imzayla değiştirirken, EIP-3009 aracılığıyla facilitator-gas-öder tasarımı, ham cüzdan ödemelerini mikro ödemeler için kullanışsız hale getiren istek başına işlem maliyetlerini aşıyor. Bu belirli uygulama tek bir platformun inşası ve yazım da işin kendi anlatısı. Ancak ücretli bir API'nin otonom bir istemci tarafından birkaç satır kodla tüketilebileceğinin bir gösterimi olarak, ölçümlü, makineden makineye hizmetlerin özgür olanlar kadar birleştirilebilir olduğu bir web'e işaret ediyor.