Không có gói Semantic Kernel. Trong Python, bạn bọc khách hàng thực blockchain0x trong một phương thức được trang trí bằng @kernel_function; trong C#, nơi không có SDK .NET nào được gửi, một [KernelFunction] gọi REST API trực tiếp. Đăng ký nó trên kernel của bạn, đặt FunctionChoiceBehavior thành Tự động, và tác nhân có thể chuyển USDC trên Base. Các SDK cốt lõi đã được gửi là Node, Python, Ruby, Go và JVM.

Cài đặt Semantic Kernel và, trong Python, SDK cốt lõi.

Không có gói blockchain0x Semantic Kernel nào để thêm. Python cài đặt Semantic Kernel cộng với SDK blockchain0x thực tế; C# cài đặt Microsoft.SemanticKernel và gọi REST API bằng HttpClient tích hợp sẵn. Java sử dụng Semantic Kernel cho Java cộng với 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 (Python client đọc giá trị này) là một khóa sk_test_ testnet hoặc sk_live_ mainnet từ dashboard của bạn; ví dụ C# REST đọc cùng giá trị từ BLOCKCHAIN0X_API_KEY. OPENAI_API_KEY (hoặc AZURE_OPENAI_* cho các model chạy trên Azure) là khóa LLM của bạn. Bộ xử lý webhook cũng cần BLOCKCHAIN0X_WEBHOOK_SECRET.

API tối thiểu ASP.NET Core để nhận các sự kiện thanh toán.

Khi một khoản thanh toán được giải quyết, Blockchain0x POST một sự kiện đã ký đến URL webhook của bạn. Không có trình xác minh .NET nào được cung cấp, vì vậy trình xử lý xác minh bằng tay theo HMAC đã được tài liệu hóa - điều này là tất cả những gì một trợ giúp sẽ làm. Ví dụ .NET bên dưới; Python và Java xác minh theo cách tương tự với các thư viện HMAC của riêng họ.

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

Thuật toán là HMAC-SHA256 trên chuỗi t.rawBody, một cửa sổ phát lại 300 giây, và so sánh thời gian cố định. Đọc thân thô qua StreamReader để chữ ký giữ nguyên; không giải mã rồi tái mã hóa. Các sự kiện đã gửi là payment.received, payment.sent, wallet.deployed, và webhook.test. Trong sản xuất, webhook thường chạy như một dịch vụ ASP.NET Core riêng biệt chia sẻ cơ sở dữ liệu với tác nhân để hai bên có thể phối hợp.

Năm cạm bẫy cụ thể về Semantic Kernel cần tránh.

Mô hình plugin của Semantic Kernel rất rõ ràng nhưng có những vấn đề về ngôn ngữ và hành vi mặc định. Biết trước những điều này sẽ tiết kiệm thời gian.