Es gibt kein Semantic Kernel-Paket. In Python wickeln Sie den echten blockchain0x-Client in eine Methode ein, die mit @kernel_function dekoriert ist; in C#, wo kein .NET SDK geliefert wird, ruft ein [KernelFunction] die REST-API direkt auf. Registrieren Sie es auf Ihrem Kernel, setzen Sie FunctionChoiceBehavior auf Auto, und der Agent kann USDC auf Base bewegen. Die gelieferten Kern-SDKs sind Node, Python, Ruby, Go und JVM.

Installieren Sie Semantic Kernel und, in Python, das Kern-SDK.

Es gibt kein blockchain0x Semantic Kernel-Paket hinzuzufügen. Python installiert Semantic Kernel plus das echte blockchain0x SDK; C# installiert Microsoft.SemanticKernel und ruft die REST-API mit dem integrierten HttpClient auf. Java verwendet Semantic Kernel für Java plus das com.blockchain0x:sdk-jvm SDK.

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 (der Python-Client liest dies) ist ein sk_test_ Testnet- oder sk_live_ Mainnet-Schlüssel von Ihrem Dashboard; das C# REST-Beispiel liest denselben Wert von BLOCKCHAIN0X_API_KEY. OPENAI_API_KEY (oder AZURE_OPENAI_* für Azure-gehostete Modelle) ist Ihr LLM-Schlüssel. Der Webhook-Handler benötigt zusätzlich BLOCKCHAIN0X_WEBHOOK_SECRET.

ASP.NET Core minimale API zum Empfangen von Zahlungsereignissen.

Wenn eine Zahlung abgeschlossen ist, POSTet Blockchain0x ein signiertes Ereignis an Ihre Webhook-URL. Es gibt keinen gelieferten .NET-Überprüfer, daher überprüft der Handler manuell gegen das dokumentierte HMAC - was ein Helfer tun würde. .NET-Beispiel unten; Python und Java überprüfen auf die gleiche Weise mit ihren eigenen HMAC-Bibliotheken.

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();

Der Algorithmus ist HMAC-SHA256 über den String t.rawBody, ein 300-Sekunden-Wiederholungsfenster und ein konstanter Vergleich. Lesen Sie den Rohkörper über StreamReader, damit die Signatur intakt bleibt; deserialisieren Sie nicht und serialisieren Sie dann erneut. Die gelieferten Ereignisse sind payment.received, payment.sent, wallet.deployed und webhook.test. In der Produktion läuft der Webhook oft als separater ASP.NET Core-Dienst, der sich eine Datenbank mit dem Agenten teilt, sodass die beiden koordinieren können.

Fünf Semantic Kernel-spezifische Fallen, die zu vermeiden sind.

Das Plugin-Modell des Semantic Kernels ist sauber, hat jedoch sprachübergreifende und verhaltensbedingte Fallstricke. Wenn man sie im Voraus kennt, spart das Zeit.