Non esiste un pacchetto Semantic Kernel. In Python avvolgi il vero client blockchain0x in un metodo decorato con @kernel_function; in C#, dove non viene fornito alcun SDK .NET, un [KernelFunction] chiama direttamente l'API REST. Registralo sul tuo kernel, imposta FunctionChoiceBehavior su Auto, e l'agente può muovere USDC su Base. Gli SDK core forniti sono Node, Python, Ruby, Go e JVM.

Installa Semantic Kernel e, in Python, il core SDK.

Non esiste un pacchetto blockchain0x Semantic Kernel da aggiungere. Python installa Semantic Kernel più il vero SDK blockchain0x; C# installa Microsoft.SemanticKernel e chiama l'API REST con l'HttpClient integrato. Java utilizza Semantic Kernel per Java più l'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 (il client Python legge questo valore) è una chiave sk_test_ per testnet o sk_live_ per mainnet dalla tua dashboard; l'esempio C# REST legge lo stesso valore da BLOCKCHAIN0X_API_KEY. OPENAI_API_KEY (o AZURE_OPENAI_* per i modelli ospitati su Azure) è la tua chiave LLM. Il gestore webhook richiede inoltre BLOCKCHAIN0X_WEBHOOK_SECRET.

API minimale ASP.NET Core per ricevere eventi di pagamento.

Quando un pagamento si stabilisce, Blockchain0x POSTa un evento firmato al tuo URL webhook. Non esiste un verificatore .NET incluso, quindi il gestore verifica manualmente contro l'HMAC documentato - che è tutto ciò che farebbe un helper. Esempio .NET qui sotto; Python e Java verificano allo stesso modo con le proprie librerie 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'algoritmo è HMAC-SHA256 sulla stringa t.rawBody, una finestra di replay di 300 secondi e un confronto a tempo costante. Leggi il corpo grezzo tramite StreamReader in modo che la firma rimanga intatta; non deserializzare e poi rieseguire la serializzazione. Gli eventi spediti sono payment.received, payment.sent, wallet.deployed e webhook.test. In produzione il webhook spesso funziona come un servizio ASP.NET Core separato che condivide un database con l'agente in modo che i due possano coordinarsi.

Cinque trappole specifiche di Semantic Kernel da evitare.

Il modello di plugin di Semantic Kernel è pulito ma presenta insidie relative al linguaggio e ai comportamenti predefiniti. Conoscerle in anticipo fa risparmiare tempo.