LinkGate (SDK)
Dùng LinkGate trong SDK Node/TypeScript, C#, C++ và Python: tạo lượt, đưa link bọc cho người dùng, chờ hoàn thành và đọc kết quả có chữ ký Ed25519.
LinkGate nằm trong cùng gói SDK với LR License (bản 0.2 trở lên; hubUrl từ bản 0.3). Tải gói ở /app/license › Tổng quan hoặc trang /services/lr-license; tệp ở https://lrsvn.com/sdk/ (manifest.json, SHA256SUMS).
SDK tự sinh nonce cho mỗi lần gọi, xác minh chữ ký, so nonce và campaign_id, tách lỗi mạng (network_error) khỏi kết luận đã ký và poll theo poll_after.
Node / TypeScript
import { LinkGate } from "@lrs/license";
const gate = new LinkGate({
campaignId: "lcmp_xxxxxxxx",
publicKeys: { lksk_xxxxxxxx: "PUBLIC_KEY_BASE64URL" },
});
const r = await gate.createRun("player-42");
if (!r.ok) throw new Error(r.code);
// Một link (hoặc mã QR) cho cả lượt; hoặc tự hiện từng link trong r.run.links.
console.log(r.run.hubUrl);
const done = await gate.waitForCompletion(r.run.id);
if (done.ok && done.run.status === "completed") {
console.log(done.run.result.licenseKey, done.run.result.code);
}Python
from lr_license import LinkGate
gate = LinkGate("lcmp_xxxxxxxx", {"lksk_xxxxxxxx": "PUBLIC_KEY_BASE64URL"})
r = gate.create_run("player-42")
print(r.run.hub_url) # một link (hoặc mã QR) cho cả lượt
done = gate.wait_for_completion(r.run.id)
if done.ok and done.run.status == "completed":
print(done.run.result.license_key)C#
using var gate = new LinkGate(new LinkGateOptions
{
CampaignId = "lcmp_xxxxxxxx",
PublicKeys = new Dictionary<string, string> { ["lksk_xxxxxxxx"] = "PUBLIC_KEY_BASE64URL" },
});
var r = await gate.CreateRunAsync("player-42");
Console.WriteLine(r.Run!.HubUrl); // một link (hoặc mã QR) cho cả lượt
var done = await gate.WaitForCompletionAsync(r.Run.Id);
if (done.Ok && done.Run?.Status == "completed") Console.WriteLine(done.Run.Result!.LicenseKey);C++
lr::LinkOptions o;
o.campaign_id = "lcmp_xxxxxxxx";
o.public_keys = {{"lksk_xxxxxxxx", "PUBLIC_KEY_BASE64URL"}};
lr::LinkGate gate(o);
auto r = gate.create_run("player-42");
std::puts(r.run->hub_url.c_str()); // một link (hoặc mã QR) cho cả lượt
auto done = gate.wait_for_completion(r.run->id); // chặn luồng
if (done.ok && done.run->status == "completed") std::puts(done.run->result->license_key.c_str());Hàm
| Hàm | Việc |
|---|---|
createRun(externalUser?) | Mở lượt. externalUser (≤ 128 ký tự) là mã người dùng của bạn: thống kê và giới hạn mỗi ngày. run.hubUrl là trang lượt (một link cho cả lượt). |
getRun(runId) | Lượt lúc này. Rẻ: poll 2–5 giây một lần là được. |
cancelRun(runId) | Huỷ lượt đang chờ; link bọc ngừng chạy. |
waitForCompletion(runId) | Poll tới khi lượt không còn pending (completed, expired, cancelled); lỗi mạng tự thử lại, mã khác thì dừng; hết thời gian chờ → timeout. |
Tên hàm theo quy ước của từng ngôn ngữ (create_run, CreateRunAsync…). Bảng mã ở Lượt (client API).
Bảo mật
- Chỉ mở khoá theo
resultmà SDK đã xác minh. Đừng tin ứng dụng tự báo "đã mở đủ link" — người dùng sửa được mọi thứ trên máy của họ. - Ứng dụng phía người dùng (game, launcher) dùng
LinkGatetrực tiếp được: chỉ cần mã chiến dịch và khoá công khai. Không bao giờ nhúng API keylrs_…. - Khoá LR License hay mã trong
resultchỉ trả cho lượt đó; nếu cần, cấp thêm từ máy chủ của bạn qua webhook.