Não há pacote Semantic Kernel. Em Python, você envolve o cliente real blockchain0x em um método decorado com @kernel_function; em C#, onde nenhum SDK .NET é enviado, um [KernelFunction] chama a API REST diretamente. Registre-o em seu kernel, defina FunctionChoiceBehavior como Auto, e o agente pode mover USDC na Base. Os SDKs principais enviados são Node, Python, Ruby, Go e JVM.

Instale Semantic Kernel e, em Python, o SDK principal.

Não há pacote blockchain0x Semantic Kernel para adicionar. Python instala Semantic Kernel mais o SDK real blockchain0x; C# instala Microsoft.SemanticKernel e chama a API REST com o HttpClient embutido. Java usa Semantic Kernel para Java mais o 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 (o cliente Python lê isto) é uma chave sk_test_ de testnet ou sk_live_ de mainnet do seu painel; o exemplo REST em C# lê o mesmo valor de BLOCKCHAIN0X_API_KEY. OPENAI_API_KEY (ou AZURE_OPENAI_* para modelos hospedados na Azure) é a sua chave do LLM. O handler de webhook também precisa de BLOCKCHAIN0X_WEBHOOK_SECRET.

API mínima do ASP.NET Core para receber eventos de pagamento.

Quando um pagamento é liquidado, Blockchain0x POSTa um evento assinado para sua URL de webhook. Não há verificador .NET enviado, então o manipulador verifica manualmente contra o HMAC documentado - que é tudo o que um helper faria. Exemplo de .NET abaixo; Python e Java verificam da mesma forma com suas próprias bibliotecas 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();

O algoritmo é HMAC-SHA256 sobre a string t.rawBody, uma janela de replay de 300 segundos e uma comparação em tempo constante. Leia o corpo bruto via StreamReader para que a assinatura permaneça intacta; não desserialize e depois re-serialize. Os eventos enviados são payment.received, payment.sent, wallet.deployed e webhook.test. Em produção, o webhook geralmente é executado como um serviço ASP.NET Core separado compartilhando um banco de dados com o agente para que os dois possam coordenar.

Cinco armadilhas específicas do Semantic Kernel a evitar.

O modelo de plugin do Semantic Kernel é limpo, mas tem armadilhas de comportamento e entre linguagens. Conhecê-las antecipadamente economiza tempo.