Il n'y a pas de package Semantic Kernel. En Python, vous encapsulez le vrai client blockchain0x dans une méthode décorée avec @kernel_function ; en C#, où aucun SDK .NET n'est expédié, un [KernelFunction] appelle directement l'API REST. Enregistrez-le sur votre noyau, définissez FunctionChoiceBehavior sur Auto, et l'agent peut déplacer USDC sur Base. Les SDK de base expédiés sont Node, Python, Ruby, Go et JVM.

Installez Semantic Kernel et, en Python, le SDK de base.

Il n'y a pas de package blockchain0x Semantic Kernel à ajouter. Python installe Semantic Kernel plus le vrai SDK blockchain0x ; C# installe Microsoft.SemanticKernel et appelle l'API REST avec le HttpClient intégré. Java utilise Semantic Kernel pour Java plus le SDK com.blockchain0x:sdk-jvm.

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 (le client Python le lit) est une clé sk_test_ testnet ou sk_live_ mainnet de votre tableau de bord ; l'exemple REST C# lit la même valeur de BLOCKCHAIN0X_API_KEY. OPENAI_API_KEY (ou AZURE_OPENAI_* pour les modèles hébergés sur Azure) est votre clé LLM. Le gestionnaire de webhook a également besoin de BLOCKCHAIN0X_WEBHOOK_SECRET.

API minimale ASP.NET Core pour recevoir des événements de paiement.

Lorsque qu'un paiement est réglé, Blockchain0x envoie un événement signé à votre URL de webhook. Il n'y a pas de vérificateur .NET expédié, donc le gestionnaire vérifie manuellement contre le HMAC documenté - ce que ferait un outil. Exemple .NET ci-dessous ; Python et Java vérifient de la même manière avec leurs propres bibliothèques HMAC.

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

L'algorithme est HMAC-SHA256 sur la chaîne t.rawBody, une fenêtre de répétition de 300 secondes, et une comparaison en temps constant. Lisez le corps brut via StreamReader afin que la signature reste intacte ; ne désérialisez pas puis ne re-sérialisez pas. Les événements expédiés sont payment.received, payment.sent, wallet.deployed, et webhook.test. En production, le webhook fonctionne souvent comme un service ASP.NET Core séparé partageant une base de données avec l'agent afin que les deux puissent se coordonner.

Cinq pièges spécifiques à Semantic Kernel à éviter.

Le modèle de plugin du Semantic Kernel est propre mais présente des pièges liés aux langues et aux comportements par défaut. Les connaître à l'avance fait gagner du temps.