Semantic Kernel paketi yoktur. Python'da gerçek blockchain0x istemcisini @kernel_function ile süslenmiş bir yöntem içinde sararsınız; C#'da, .NET SDK'sı gönderilmeyen yerde, bir [KernelFunction] REST API'yi doğrudan çağırır. Bunu çekirdeğinize kaydedin, FunctionChoiceBehavior'ı Auto olarak ayarlayın ve ajansınız Base üzerinde USDC taşıyabilir. Gönderilen çekirdek SDK'lar Node, Python, Ruby, Go ve JVM'dir.

Semantic Kernel'i ve Python'da çekirdek SDK'yı kurun.

Ekleyecek bir blockchain0x Semantic Kernel paketi yoktur. Python, Semantic Kernel'ı ve gerçek blockchain0x SDK'sını kurar; C#, Microsoft.SemanticKernel'ı kurar ve REST API'yi yerleşik HttpClient ile çağırır. Java, Java için Semantic Kernel'ı ve com.blockchain0x:sdk-jvm SDK'sını kullanır.

pip install semantic-kernel blockchain0x

dotnet add package Microsoft.SemanticKernel

BLOCKCHAIN0X_API_KEY=sk_test_...   # sk_test_ = Base Sepolia, sk_live_ = Base mainnet
BLOCKCHAIN0X_API_KEY=sk_test_...             # same key, the name the .NET REST example reads
OPENAI_API_KEY=sk-...

BLOCKCHAIN0X_API_KEY (Python istemcisi bunu okur) dashboard'unuzdan alınan bir sk_test_ testnet veya sk_live_ mainnet anahtarıdır; C# REST örneği aynı değeri BLOCKCHAIN0X_API_KEY'den okur. OPENAI_API_KEY (veya Azure-hosted modeller için AZURE_OPENAI_*) sizin LLM anahtarınızdır. Webhook handler ayrıca BLOCKCHAIN0X_WEBHOOK_SECRET gerektirir.

Ödeme olaylarını almak için ASP.NET Core minimal API.

Bir ödeme yerleştiğinde, Blockchain0x imzalı bir olayı webhook URL'nize POST eder. Gönderilen bir .NET doğrulayıcı yoktur, bu nedenle işleyici belgelenmiş HMAC'a karşı elle doğrular - bu da bir yardımcı programın yapacağı tek şeydir. Aşağıdaki .NET örneği; Python ve Java kendi HMAC kütüphaneleri ile aynı şekilde doğrular.

using System.Security.Cryptography;
using System.Text;
using Microsoft.AspNetCore.Builder;

var app = WebApplication.CreateBuilder(args).Build();
var secret = Environment.GetEnvironmentVariable("BLOCKCHAIN0X_WEBHOOK_SECRET")!;

app.MapPost("/webhooks/payment", async (HttpRequest req) =>
{
    using var reader = new StreamReader(req.Body);
    var raw = await reader.ReadToEndAsync(); // RAW body - verify before parsing
    var sig = req.Headers["X-Blockchain0x-Signature"].ToString();
    var ts = req.Headers["X-Blockchain0x-Timestamp"].ToString();

    var parts = sig.Split(',').Select(p => p.Split('=', 2))
        .Where(p => p.Length == 2).ToDictionary(p => p[0], p => p[1]);
    var t = parts.GetValueOrDefault("t", ts);
    var v1 = parts.GetValueOrDefault("v1", sig);

    var want = Convert.ToHexString(new HMACSHA256(Encoding.UTF8.GetBytes(secret))
        .ComputeHash(Encoding.UTF8.GetBytes($"{t}.{raw}"))).ToLowerInvariant();
    var fresh = Math.Abs(DateTimeOffset.UtcNow.ToUnixTimeSeconds() - long.Parse(t)) <= 300;
    if (!fresh || !CryptographicOperations.FixedTimeEquals(
            Encoding.UTF8.GetBytes(want), Encoding.UTF8.GetBytes(v1)))
        return Results.Unauthorized();

    if (req.Headers["X-Blockchain0x-Event-Type"] == "payment.received")
        await RunFollowupAsync(); // USDC landed - do the next step
    return Results.Ok();
});

app.Run();

Algoritma, t.rawBody dizesi üzerinde HMAC-SHA256, 300 saniyelik bir tekrar penceresi ve sabit zamanlı karşılaştırma ile çalışır. İmzanın bozulmaması için ham veriyi StreamReader aracılığıyla okuyun; serileştirmeyin ve ardından yeniden serileştirmeyin. Gönderilen olaylar payment.received, payment.sent, wallet.deployed ve webhook.test'tir. Üretimde, webhook genellikle bir veritabanını ajansla paylaşan ayrı bir ASP.NET Core hizmeti olarak çalışır, böylece ikisi koordine olabilir.

Beş Semantic Kernel'a özgü kaçınılması gereken tuzak.

Semantic Kernel'in eklenti modeli temizdir ancak dil geçişleri ve davranış varsayılanları ile ilgili bazı sorunlar vardır. Bunları önceden bilmek zaman kazandırır.