Semantic Kernelパッケージはありません。Pythonでは、実際のblockchain0xクライアントを@kernel_functionで装飾されたメソッドでラップします。C#では、.NET SDKが出荷されないため、[KernelFunction]がREST APIを直接呼び出します。それをカーネルに登録し、FunctionChoiceBehaviorをAutoに設定すれば、エージェントはBase上でUSDCを移動できます。出荷されたコアSDKはNode、Python、Ruby、Go、JVMです。

Semantic Kernelをインストールし、PythonでコアSDKをインストールします。

追加するblockchain0x Semantic Kernelパッケージはありません。PythonはSemantic Kernelと実際のblockchain0x SDKをインストールします。C#はMicrosoft.SemanticKernelをインストールし、組み込みのHttpClientでREST APIを呼び出します。JavaはJava用のSemantic Kernelと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 (Python client がこれを読み込みます) は dashboard の sk_test_ testnet または sk_live_ mainnet キーです。C# REST の例でも同じ値を BLOCKCHAIN0X_API_KEY から読み込みます。OPENAI_API_KEY (または Azure-hosted models 用の AZURE_OPENAI_*) は LLM キーです。webhook handler には追加で BLOCKCHAIN0X_WEBHOOK_SECRET が必要です。

支払いイベントを受信するためのASP.NET CoreミニマルAPI。

支払いが決済されると、Blockchain0xはあなたのWebhook URLに署名されたイベントをPOSTします。出荷された.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();

アルゴリズムは、文字列t.rawBodyに対するHMAC-SHA256、300秒のリプレイウィンドウ、および定数時間比較です。署名がそのまま保持されるようにStreamReaderを介して生のボディを読み取ります; デシリアライズしてから再シリアライズしないでください。出荷されたイベントはpayment.received、payment.sent、wallet.deployed、およびwebhook.testです。本番環境では、Webhookはしばしばエージェントとデータベースを共有する別のASP.NET Coreサービスとして実行され、両者が調整できます。

Semantic Kernelに特有の避けるべき5つの罠。

セマンティックカーネルのプラグインモデルはクリーンですが、クロスランゲージや動作デフォルトの落とし穴があります。事前に知っておくことで時間を節約できます。