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 (the Python client reads this)는 dashboard의 sk_test_ testnet 또는 sk_live_ mainnet 키입니다. C# REST 예제는 같은 값을 BLOCKCHAIN0X_API_KEY에서 읽습니다. OPENAI_API_KEY (또는 Azure-hosted 모델의 AZURE_OPENAI_*)는 LLM 키입니다. webhook handler에는 추가로 BLOCKCHAIN0X_WEBHOOK_SECRET가 필요합니다.

결제 이벤트 수신을 위한 ASP.NET Core 최소 API.

결제가 완료되면 Blockchain0x가 귀하의 웹훅 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입니다. 프로덕션에서는 웹훅이 종종 에이전트와 데이터베이스를 공유하는 별도의 ASP.NET Core 서비스로 실행되어 두 개가 조정될 수 있습니다.

Semantic Kernel에 특화된 피해야 할 다섯 가지 함정.

시맨틱 커널의 플러그인 모델은 깔끔하지만 언어 간 및 동작 기본값에 대한 문제점이 있습니다. 이를 미리 아는 것이 시간을 절약합니다.