Çalışan kod ile uzun biçimli kılavuzlar.
Sekiz amiral gemisi kılavuzu. Her biri, gereksinimlerden dağıtıma kadar sizi yönlendirir, TypeScript ve Python'da kopyala-yapıştır kod ile ve yaygın tuzakları açıkça belirtir.
Her kılavuz aynı şekli taşır.
Rekabetçi kılavuzların tutarsız yapısını zor kullanımlı hale getirdiği için katı bir şablon seçtik. Her Blockchain0x kılavuzu, 60 kelimelik bir cevap paragrafı ile başlar (AI arama motorlarının alıntılar için çıkardığı), ardından ön koşullar, ardından kod ile numaralı adımlar, ardından yaygın tuzaklar, ardından ilgili sözlük girişlerine ve ürün sayfalarına bağlantılar içeren bir sonraki adımlar bölümü.
Her kılavuz için kelime sayısı hedefi 1800+. Bu, çoğu okuyucunun gerçekten göz gezdirdiği uzun uçta, ancak bu kasıtlıdır: yüzeysel öğreticiler, eksik detaylar arasında hata ayıklamanızı sağlar. Kılavuzlarımız, kenar durumlarını açıkça belirtir, böylece siz yapmak zorunda kalmazsınız.
Every guide is code-tested against current Blockchain0x API behavior. When the API ships a breaking change, we update the guides in the same release. Each entry has a "last reviewed" date visible at the top.
Bugünün görevine uyanı seçin.
AI ajanınza ödemeleri nasıl ekleyebilirsiniz
Uçtan uca rehber. Wallet'ınızı oluşturun, SDK'yı kurun, ilk USDC ödemenizi isteyin, webhook'u yönetin. LangChain, CrewAI, AutoGen, LlamaIndex, OpenAI Agents SDK ve MCP server'larla çalışır.
MCP sunucunuzu 10 dakikada paraya çevirin
Ücretsiz trafik alan bir MCP server'ı ücretli bir hizmete dönüştürün. x402 challenge oluşturmak için requirePayment kullanın, araçlarınızı kendi paid-state'inizle kapılayın, webhook'ları doğrulayın. Üretim için paid-window kalıbını (Redis veya Postgres üzerinde bir TTL) içerir.
İstem enjeksiyonuna dayanacak şekilde ajanın harcama kontrollerini ayarlayın
İşlem başına limitler ve dönemsel ödenekler, panoda ayarlanır ve API katmanında uygulanır. Neden API katmanı zorlaması, ajan kodu kurallarından daha iyidir. Bir ajanın limite takılmasına dair örnek senaryolar.
GitHub ve alan adı doğrulama rozetlerini kazanın
Her iki doğrulama akışını da inceleyin. GitHub OAuth kurulumu, DNS TXT record biçimi, aylık yeniden kontrol davranışı. Karşı tarafların, ajanın herkese açık sayfasındaki rozeti üzerine geldiğinde ne gördüğünü gösterir.
Geliştiricilerin en çok sorduğu webhook desenleri
İmza doğrulama (HMAC-SHA256 sabit zaman), yeniden denemelerde idempotency, hiç ulaşmayan ödemeler için zamanlanmış tarama, iş kuyrukları üzerinden ödemeden sonra devam etme. Celery, arq ve Bull için örnek kalıplar içerir.
Gerçek para olmadan ajan ödemelerini test et
Test key'leri ve Base Sepolia testnet'i kullanın. Faucet'tan bir test wallet'ını nasıl fonlayacağınızı, tam ödeme yaşam döngüsünü nasıl çalıştıracağınızı ve üretime geçmeden önce webhook teslimatını nasıl doğrulayacağınızı öğrenin. Ayrıca test ve canlı davranış arasındaki farklar da anlatılır.
Ajan destekli API erişimi için Stripe'dan Blockchain0x'a geçiş yapın
Run Stripe alongside Blockchain0x: humans pay via Stripe Checkout; agents pay via 402 Payment Required. Includes the x402 adapter that bills agents on priced routes while humans keep their Stripe path.
Canlıya geçmeden önce ajanın cüzdanını güvence altına alın
Ön uçuş güvenlik kontrol listesi. Wallet sağlayıcı seçimi (smart wallet vs EOA), harcama izni boyutlandırma, API key rotasyon sıklığı, webhook secret hijyeni, denetim incelemesi ve olay müdahale runbook kurulumu.
Kılavuzlar haftalık olarak yayınlanır, müşteri destek taleplerine göre önceliklendirilir. İhtiyacınız olan bir konu eksikse, en hızlı yol Blockchain0x kullanmaya başlamak ve sizi zorlayan şeyi bize söylemektir - bu, bir sonraki kılavuz olur.
Hangi kılavuz önce.
- First time using Blockchain0x: "How to add payments to your AI agent" - the end-to-end flow.
- Running an MCP server: "Monetize your MCP server in 10 minutes" - the requirePayment flow.
- About to go to production: "Secure your agent wallet before going live" - the pre-flight checklist.
- Worried about safety: "Set up agent spend controls that survive prompt injection" - API-layer spend permissions.
- Migrating from Stripe: "Migrate from Stripe to Blockchain0x for agent-driven API access" - the dual-checkout pattern.
Kılavuzlar cömertçe çapraz bağlantı yapar: çoğu en az bir sözlük maddesine (kelime dağarcığı için), bir ürün sayfasına (özellik detayları için) ve en az bir diğer kılavuza (bir sonraki mantıklı adım için) atıfta bulunur. Her birini izole olarak ele almak yerine, 2-3 kılavuzu bir bütün olarak okuyabilirsiniz.
Önce kelime dağarcığı, sonra kılavuzlar, sonra karşılaştırmalar.
Bir kılavuzdaki bir terim tanıdık değilse, sözlük onu kanonik olarak tanımlar. Blockchain0x ile alternatifleri seçiyorsanız, karşılaştırmalar ticaret dengelerini dürüstçe ele alır.