ไม่มีแพ็คเกจ Semantic Kernel ใน Python คุณห่อหุ้มไคลเอนต์จริง blockchain0x ในวิธีที่ตกแต่งด้วย @kernel_function; ใน C# ซึ่งไม่มี SDK .NET ที่จัดส่ง [KernelFunction] เรียก REST API โดยตรง ลงทะเบียนมันในเคอร์เนลของคุณ ตั้งค่า FunctionChoiceBehavior เป็น Auto และตัวแทนสามารถย้าย USDC บน Base SDK หลักที่จัดส่งคือ Node, Python, Ruby, Go และ JVM.

ติดตั้ง Semantic Kernel และ SDK หลักใน Python

ไม่มีแพ็คเกจ Semantic Kernel ของ blockchain0x ที่จะเพิ่ม Python ติดตั้ง Semantic Kernel พร้อมกับ SDK blockchain0x จริง; C# ติดตั้ง Microsoft.SemanticKernel และเรียก REST API ด้วย HttpClient ที่มีอยู่ Java ใช้ Semantic Kernel สำหรับ Java พร้อมกับ 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 จะอ่านค่านี้) คือคีย์ sk_test_ สำหรับ testnet หรือ sk_live_ สำหรับ mainnet จากแดชบอร์ดของคุณ; ตัวอย่าง C# REST จะอ่านค่าจาก BLOCKCHAIN0X_API_KEY ค่าเดียวกัน OPENAI_API_KEY (หรือ AZURE_OPENAI_* สำหรับโมเดลที่โฮสต์บน Azure) คือคีย์ LLM ของคุณ ส่วน webhook handler ยังต้องใช้ BLOCKCHAIN0X_WEBHOOK_SECRET เพิ่มเติมด้วย

ASP.NET Core minimal API สำหรับรับเหตุการณ์การชำระเงิน

เมื่อการชำระเงินถูกชำระ Blockchain0x POST เหตุการณ์ที่ลงนามไปยัง URL webhook ของคุณ ไม่มีตัวตรวจสอบ .NET ที่ส่งมา ดังนั้นตัวจัดการจึงตรวจสอบด้วยมือกับ HMAC ที่บันทึกไว้ - ซึ่งเป็นสิ่งที่ตัวช่วยจะทำ .NET ตัวอย่างด้านล่าง; Python และ Java ตรวจสอบในลักษณะเดียวกันด้วยไลบรารี 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();

อัลกอริธึมคือ HMAC-SHA256 บนสตริง t.rawBody หน้าต่างการเล่นซ้ำ 300 วินาที และการเปรียบเทียบในเวลาคงที่ อ่านร่างดิบผ่าน StreamReader เพื่อให้ลายเซ็นยังคงอยู่; อย่าถอดรหัสแล้วทำการถอดรหัสใหม่ เหตุการณ์ที่ส่งคือ payment.received, payment.sent, wallet.deployed และ webhook.test ในการผลิต webhook มักทำงานเป็นบริการ ASP.NET Core แยกต่างหากที่แชร์ฐานข้อมูลกับตัวแทนเพื่อให้ทั้งสองสามารถประสานงานกันได้

ห้าหมายที่เฉพาะเจาะจงเกี่ยวกับ Semantic Kernel ที่ควรหลีกเลี่ยง

โมเดลปลั๊กอินของ Semantic Kernel มีความชัดเจนแต่มีข้อควรระวังเกี่ยวกับการข้ามภาษาและพฤติกรรมเริ่มต้น การรู้จักพวกเขาล่วงหน้าช่วยประหยัดเวลา.