@a2afoundation/ans-registrar-sdk 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,69 @@
-# Temporary Holding Version
+# @a2afoundation/ans-registrar-sdk
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Registrar SDK for the A2A Agent Name Service. Channel calls use the registrar's issued credential key. Names belong to the customer's ANS account; a participant ID is only a resolution target.
+
+## 生成凭证密钥对
+
+在注册商自己的系统中运行以下 Node.js 示例。`generateKeypair()` 返回 `privateKey`、`publicKey` 和 `participantId`。私钥只保存在注册商自己的安全存储中，不要提交到代码库，不要上传到 ANS。示例只输出公钥标识。
+
+```ts
+import { generateKeypair } from '@a2afoundation/ans-registrar-sdk';
+
+const keypair = await generateKeypair();
+// Keep keypair.privateKey only in your own secure system.
+// Never commit it to a repository or upload it to ANS.
+// Paste only this public identifier into the console Credentials page:
+console.log(keypair.participantId);
+```
+
+把 `participantId` 填入注册商控制台「凭证」页的「公钥（participant_id）」字段。ANS 只保存公钥。后续请求签名时，从注册商自己的安全存储加载密钥对。
+
+## 调用渠道接口
+
+```ts
+import { AnsRegistrarClient } from '@a2afoundation/ans-registrar-sdk';
+
+const client = new AnsRegistrarClient({
+  baseUrl: 'https://a2ans.io',
+  signingKey: registrarCredentialKeypair, // Load securely; never embed the private key.
+});
+
+// Fund the registrar prepaid balance first. International: email; China: +86 phone.
+const registered = await client.registerForCustomer(
+  'customername',
+  { email: 'alice@example.com' },
+  { durationYears: 1, idempotencyKey: 'registration-order-123' },
+);
+console.log(registered.tx_id, registered.charged, registered.balance_after);
+
+// Reuse the same key AND request on retry. Use fresh keys for different operations.
+const retried = await client.registerForCustomer(
+  'customername',
+  { email: 'alice@example.com' },
+  { durationYears: 1, idempotencyKey: registered.idempotencyKey },
+);
+
+const renewed = await client.renewForCustomer('customername', { durationYears: 1 });
+// Automatically generated keys are returned for reuse on retry.
+console.log(renewed.idempotencyKey);
+await client.setNameTarget('customername', null);
+
+const page = await client.listNames({ limit: 20 });
+if (page.next_cursor) await client.listNames({ cursor: page.next_cursor, limit: 20 });
+await client.getName('customername');
+await client.getBalance();
+await client.listLedger({ limit: 20 });
+await client.listInvoices({ limit: 20 });
+```
+
+`registerForCustomer` takes `{ email }` on the international site or `{ phone: '+8613812341234' }` on the China site. `participantId` is optional in its options. The old customer participant-ID argument and `paymentProofRef` option are replaced. The server debits prepaid balance at the registrar purchase price and returns no customer account ID or account-creation flag. Only ordinary names are available.
+
+All channel writes require an 8–128 visible ASCII `Idempotency-Key`. Write methods generate a random key if omitted and return it as `idempotencyKey`. Errors also carry `idempotencyKey`, including network failures; retain it when retrying. `AnsRegistrarError` carries `status`, `errorCode`, and the raw response `body`. Reusing a key with different request content returns HTTP 409 `IDEMPOTENCY_CONFLICT`.
+
+An optional `targetConsent: { privateKey, publicKey }` on `registerForCustomer` or `setNameTarget` produces the independent target cosignature headers. Omit it to leave the target unconfirmed. Keep target private keys under the target owner's control; target consent is optional and requires that owner's authorization.
+
+Read methods sign the path including encoded query parameters and send no GET body. Pages accept `cursor` and `limit` (1–100, default 20); `next_cursor: null` ends the list. Amounts are decimal strings in CNY or USD. Name responses contain masked customer contact details.
+
+The existing self-service `register`, `renew`, `bind`, `release`, and transfer methods keep their contracts. The SDK uses the registry's `A2A-ANS-v1` canonical signing format and depends only on `@noble/*` and `@scure/base`.
+
+Run `npm run sdk:pack` and `npm run sdk:smoke` from the repository root to verify the package locally. These commands do not publish to npm. Full channel/admin contracts and financial transaction rules: [docs/23](../../docs/23-registrar-billing-and-channel-api.md).

package/dist/client.d.ts

@@ -0,0 +1,190 @@
+type FetchResponse = {
+    ok: boolean;
+    status: number;
+    text(): Promise<string>;
+};
+type FetchLike = (url: string, init: {
+    method: string;
+    headers: Record<string, string>;
+    body?: string;
+}) => Promise<FetchResponse>;
+export interface AnsRegistrarClientOptions {
+    /** ANS 注册局基址，如 https://a2ans.io 。 */
+    baseUrl: string;
+    /** 签名密钥：名字持有者自己的密钥，或注册商的渠道凭证密钥。 */
+    signingKey: {
+        privateKey: Uint8Array;
+        publicKey: Uint8Array;
+    };
+    fetchImpl?: FetchLike;
+    /** 当前 Unix 秒（测试可注入）。 */
+    now?: () => number;
+}
+export declare class AnsRegistrarError extends Error {
+    readonly status: number;
+    readonly errorCode: string;
+    readonly body: string;
+    idempotencyKey?: string | undefined;
+    constructor(status: number, errorCode: string, body: string, idempotencyKey?: string | undefined);
+}
+export type RegistrarCustomer = {
+    email: string;
+    phone?: never;
+} | {
+    phone: string;
+    email?: never;
+};
+export interface RegistrarMoney {
+    amount: string;
+    currency: 'CNY' | 'USD';
+}
+export interface IdempotentResult {
+    idempotencyKey: string;
+}
+export interface RegistrarPageOptions {
+    cursor?: string;
+    limit?: number;
+}
+export interface TargetConsent {
+    privateKey: Uint8Array;
+    publicKey: Uint8Array;
+}
+export interface RegistrarRenewal {
+    name: string;
+    expires_at: string;
+    registrar_id: string;
+    tx_id: string;
+    charged: RegistrarMoney;
+    balance_after: RegistrarMoney;
+}
+export interface RegistrarRegistration extends RegistrarRenewal {
+    tier: 'standard';
+    target: string | null;
+    target_confirmed: boolean;
+}
+export interface RegistrarName {
+    name: string;
+    status: string;
+    registered_at: string;
+    expires_at: string;
+    target: string | null;
+    target_confirmed: boolean;
+    customer: {
+        email?: string;
+        phone?: string;
+    };
+}
+export interface RegistrarLedgerItem {
+    entry_id: string;
+    type: 'topup_online' | 'topup_offline' | 'register_debit' | 'renew_debit' | 'refund_credit' | 'adjustment' | 'exit_refund';
+    amount: string;
+    currency: string;
+    balance_after: string;
+    ref_id: string;
+    actor: string;
+    reason: string;
+    created_at: string;
+}
+export interface RegistrarInvoice {
+    tx_id: string;
+    txId: string;
+    kind: string;
+    amount: string;
+    currency: string;
+    registrarId?: string;
+    label?: string;
+    createdAt: string;
+    [key: string]: unknown;
+}
+export declare class AnsRegistrarClient {
+    /** 本客户端签名身份（自助=持有者；代客=注册商渠道凭证）。 */
+    readonly participantId: string;
+    private readonly baseUrl;
+    private readonly privateKey;
+    private readonly fetchImpl;
+    private readonly now;
+    constructor(opts: AnsRegistrarClientOptions);
+    /** 便捷构造：从 32 字节私钥种子派生公钥。 */
+    static fromPrivateKey(baseUrl: string, privateKey: Uint8Array, fetchImpl?: FetchLike): Promise<AnsRegistrarClient>;
+    private handle;
+    private send;
+    /** 注册名字。`target` 缺省 = 自绑定到本签名身份（自助注册）。`paymentProofRef` = D 组支付承诺存证引用。 */
+    register(name: string, opts: {
+        durationYears: number;
+        paymentProofRef: string;
+        target?: string;
+    }): Promise<unknown>;
+    /** Registrar prepaid registration. The customer contact owns the name; participantId is only its target. */
+    registerForCustomer(name: string, customer: RegistrarCustomer, opts: {
+        durationYears: number;
+        participantId?: string;
+        idempotencyKey?: string;
+        targetConsent?: TargetConsent;
+    }): Promise<RegistrarRegistration & IdempotentResult>;
+    renewForCustomer(name: string, opts: {
+        durationYears: number;
+        idempotencyKey?: string;
+    }): Promise<RegistrarRenewal & IdempotentResult>;
+    setNameTarget(name: string, participantId: string | null, opts?: {
+        idempotencyKey?: string;
+        targetConsent?: TargetConsent;
+    }): Promise<{
+        name: string;
+        target: string | null;
+        target_confirmed: boolean;
+    } & IdempotentResult>;
+    private channelWrite;
+    private pagePath;
+    listNames(options?: RegistrarPageOptions): Promise<{
+        names: RegistrarName[];
+        next_cursor: string | null;
+    }>;
+    getName(name: string): Promise<RegistrarName>;
+    getBalance(): Promise<{
+        registrar_id: string;
+        balance: RegistrarMoney;
+        purchase_price: RegistrarMoney;
+    }>;
+    listLedger(options?: RegistrarPageOptions): Promise<{
+        entries: RegistrarLedgerItem[];
+        next_cursor: string | null;
+    }>;
+    listInvoices(options?: RegistrarPageOptions): Promise<{
+        registrar_id: string;
+        count: number;
+        invoices: RegistrarInvoice[];
+        next_cursor: string | null;
+    }>;
+    /** 设置/解除解析目标（target=null 解绑）。 */
+    bind(name: string, target: string | null): Promise<unknown>;
+    /** 续费。 */
+    renew(name: string, opts: {
+        durationYears: number;
+        paymentProofRef: string;
+    }): Promise<unknown>;
+    /** 释放（已付费用不退）。 */
+    release(name: string): Promise<unknown>;
+    /**
+     * 即时双签过户（key↔key）：当前 owner（本客户端）+ 新 owner 共签。
+     * 需要新 owner 的密钥来共签（新 owner 对同一 nonce/timestamp/body 以自身 pid 再签）。
+     * 已绑 2FA 的 owner 须传 twofa 动态码（FR-AUTH-6）。
+     */
+    transfer(name: string, newOwner: {
+        privateKey: Uint8Array;
+        publicKey: Uint8Array;
+    }, opts?: {
+        twofa?: string;
+    }): Promise<unknown>;
+    /** 两步过户·发起（M2，支持账号收件人）：指定收件人邮箱或 participant_id；返回 transfer_id。 */
+    initiateTransfer(name: string, to: {
+        toEmail?: string;
+        toParticipantId?: string;
+    }, opts?: {
+        twofa?: string;
+    }): Promise<unknown>;
+    /** 两步过户·接受（本客户端 = 收件人）。 */
+    acceptTransfer(transferId: string): Promise<unknown>;
+    /** 两步过户·取消（发起方或收件人均可）。 */
+    cancelTransfer(transferId: string): Promise<unknown>;
+}
+export {};

package/dist/client.js

@@ -0,0 +1,197 @@
+import { randomBytes } from 'node:crypto';
+/**
+ * 注册方 SDK 客户端：封装「签名 + 调 ANS 注册局写端点」，让注册商/名字持有者不必手搓签名。
+ *
+ * 两类用法：
+ *  - 名字持有者自助：register / bind / renew / release（用自己的密钥签）。
+ *  - 注册服务商代客注册：registerForCustomer（用注册商渠道凭证签名，提交客户联系方式，
+ *    服务端按进货价扣预存款；客户账号持有，participant_id 只作解析目标；见 docs/23）。
+ *
+ * 校验不过/被拒一律抛 AnsRegistrarError（含服务端 error_code）。
+ */
+import { getPublicKeyAsync } from '@noble/ed25519';
+import { encodeParticipantId, signRequest, cosignRequest } from './signing.js';
+export class AnsRegistrarError extends Error {
+    status;
+    errorCode;
+    body;
+    idempotencyKey;
+    constructor(status, errorCode, body, idempotencyKey) {
+        super(`${errorCode} (HTTP ${status})`);
+        this.status = status;
+        this.errorCode = errorCode;
+        this.body = body;
+        this.idempotencyKey = idempotencyKey;
+        this.name = 'AnsRegistrarError';
+    }
+}
+export class AnsRegistrarClient {
+    /** 本客户端签名身份（自助=持有者；代客=注册商渠道凭证）。 */
+    participantId;
+    baseUrl;
+    privateKey;
+    fetchImpl;
+    now;
+    constructor(opts) {
+        this.baseUrl = opts.baseUrl.replace(/\/$/, '');
+        this.privateKey = opts.signingKey.privateKey;
+        this.participantId = encodeParticipantId(opts.signingKey.publicKey);
+        this.fetchImpl = opts.fetchImpl ?? ((url, init) => fetch(url, init));
+        this.now = opts.now;
+    }
+    /** 便捷构造：从 32 字节私钥种子派生公钥。 */
+    static async fromPrivateKey(baseUrl, privateKey, fetchImpl) {
+        const publicKey = await getPublicKeyAsync(privateKey);
+        return new AnsRegistrarClient({ baseUrl, signingKey: { privateKey, publicKey }, ...(fetchImpl ? { fetchImpl } : {}) });
+    }
+    async handle(res) {
+        const text = await res.text();
+        if (!res.ok) {
+            let errorCode = `HTTP_${res.status}`;
+            try {
+                errorCode = JSON.parse(text).error_code ?? errorCode;
+            }
+            catch {
+                /* non-JSON body */
+            }
+            throw new AnsRegistrarError(res.status, errorCode, text);
+        }
+        return text ? JSON.parse(text) : {};
+    }
+    async send(method, path, bodyObj, extraHeaders = {}) {
+        const body = method === 'GET' ? '' : JSON.stringify(bodyObj ?? {});
+        const bodyBytes = new TextEncoder().encode(body);
+        const headers = await signRequest({
+            method,
+            path,
+            bodyBytes,
+            privateKey: this.privateKey,
+            participantId: this.participantId,
+            ...(this.now ? { nowEpochSec: this.now() } : {}),
+        });
+        const res = await this.fetchImpl(this.baseUrl + path, {
+            method,
+            headers: { 'content-type': 'application/json', ...headers, ...extraHeaders },
+            ...(method === 'GET' ? {} : { body }),
+        });
+        return this.handle(res);
+    }
+    /** 注册名字。`target` 缺省 = 自绑定到本签名身份（自助注册）。`paymentProofRef` = D 组支付承诺存证引用。 */
+    async register(name, opts) {
+        return this.send('POST', '/v1/ans/register', { name, participant_id: opts.target ?? this.participantId, duration_years: opts.durationYears }, { 'x-ans-payment-proof': opts.paymentProofRef });
+    }
+    /** Registrar prepaid registration. The customer contact owns the name; participantId is only its target. */
+    async registerForCustomer(name, customer, opts) {
+        const body = { name, customer, duration_years: opts.durationYears, ...(opts.participantId ? { participant_id: opts.participantId } : {}) };
+        return this.channelWrite('POST', '/v1/channel/register', body, opts);
+    }
+    async renewForCustomer(name, opts) {
+        return this.channelWrite('POST', '/v1/channel/renew', { name, duration_years: opts.durationYears }, opts);
+    }
+    async setNameTarget(name, participantId, opts = {}) {
+        return this.channelWrite('PUT', `/v1/channel/names/${encodeURIComponent(name)}/target`, { participant_id: participantId }, opts);
+    }
+    async channelWrite(method, path, body, opts) {
+        const key = opts.idempotencyKey ?? randomBytes(24).toString('hex');
+        if (!/^[!-~]{8,128}$/.test(key))
+            throw new Error('idempotencyKey must be 8–128 visible ASCII characters');
+        const headers = { 'idempotency-key': key };
+        if (opts.targetConsent) {
+            const consent = await signRequest({ method, path, bodyBytes: new TextEncoder().encode(JSON.stringify(body)), privateKey: opts.targetConsent.privateKey, participantId: encodeParticipantId(opts.targetConsent.publicKey), ...(this.now ? { nowEpochSec: this.now() } : {}) });
+            headers['x-ans-cosign-participant'] = consent['x-ans-participant'];
+            headers['x-ans-cosign-nonce'] = consent['x-ans-nonce'];
+            headers['x-ans-cosign-timestamp'] = consent['x-ans-timestamp'];
+            headers['x-ans-cosign-signature'] = consent['x-ans-signature'];
+        }
+        try {
+            return { ...await this.send(method, path, body, headers), idempotencyKey: key };
+        }
+        catch (error) {
+            // Keep the generated key available even when the network failed before a response.
+            if (error && typeof error === 'object')
+                Object.assign(error, { idempotencyKey: key });
+            throw error;
+        }
+    }
+    pagePath(path, options) {
+        const query = new URLSearchParams();
+        if (options.cursor !== undefined)
+            query.set('cursor', options.cursor);
+        if (options.limit !== undefined)
+            query.set('limit', String(options.limit));
+        return query.size ? `${path}?${query.toString()}` : path;
+    }
+    async listNames(options = {}) {
+        return await this.send('GET', this.pagePath('/v1/channel/names', options), undefined);
+    }
+    async getName(name) { return await this.send('GET', `/v1/channel/names/${encodeURIComponent(name)}`, undefined); }
+    async getBalance() {
+        return await this.send('GET', '/v1/channel/balance', undefined);
+    }
+    async listLedger(options = {}) {
+        return await this.send('GET', this.pagePath('/v1/channel/ledger', options), undefined);
+    }
+    async listInvoices(options = {}) {
+        return await this.send('GET', this.pagePath('/v1/channel/invoices', options), undefined);
+    }
+    /** 设置/解除解析目标（target=null 解绑）。 */
+    async bind(name, target) {
+        return this.send('POST', '/v1/ans/bind', { name, target });
+    }
+    /** 续费。 */
+    async renew(name, opts) {
+        return this.send('POST', '/v1/ans/renew', { name, duration_years: opts.durationYears }, { 'x-ans-payment-proof': opts.paymentProofRef });
+    }
+    /** 释放（已付费用不退）。 */
+    async release(name) {
+        return this.send('DELETE', '/v1/ans/release', { name });
+    }
+    /**
+     * 即时双签过户（key↔key）：当前 owner（本客户端）+ 新 owner 共签。
+     * 需要新 owner 的密钥来共签（新 owner 对同一 nonce/timestamp/body 以自身 pid 再签）。
+     * 已绑 2FA 的 owner 须传 twofa 动态码（FR-AUTH-6）。
+     */
+    async transfer(name, newOwner, opts = {}) {
+        const method = 'POST';
+        const path = '/v1/ans/transfer';
+        const newOwnerPid = encodeParticipantId(newOwner.publicKey);
+        const body = JSON.stringify({ name, new_owner: newOwnerPid });
+        const bodyBytes = new TextEncoder().encode(body);
+        const primary = await signRequest({
+            method,
+            path,
+            bodyBytes,
+            privateKey: this.privateKey,
+            participantId: this.participantId,
+            ...(this.now ? { nowEpochSec: this.now() } : {}),
+        });
+        const cosign = await cosignRequest({
+            method,
+            path,
+            bodyBytes,
+            cosignerPrivateKey: newOwner.privateKey,
+            cosignerParticipantId: newOwnerPid,
+            nonce: primary['x-ans-nonce'], // 共签复用主签的 nonce/timestamp
+            timestamp: primary['x-ans-timestamp'],
+        });
+        const res = await this.fetchImpl(this.baseUrl + path, {
+            method,
+            headers: { 'content-type': 'application/json', ...primary, ...cosign, ...(opts.twofa ? { 'x-ans-2fa': opts.twofa } : {}) },
+            body,
+        });
+        return this.handle(res);
+    }
+    /** 两步过户·发起（M2，支持账号收件人）：指定收件人邮箱或 participant_id；返回 transfer_id。 */
+    async initiateTransfer(name, to, opts = {}) {
+        return this.send('POST', '/v1/ans/transfer/initiate', { name, ...(to.toEmail ? { to_email: to.toEmail } : {}), ...(to.toParticipantId ? { to_participant_id: to.toParticipantId } : {}) }, opts.twofa ? { 'x-ans-2fa': opts.twofa } : {});
+    }
+    /** 两步过户·接受（本客户端 = 收件人）。 */
+    async acceptTransfer(transferId) {
+        return this.send('POST', '/v1/ans/transfer/accept', { transfer_id: transferId });
+    }
+    /** 两步过户·取消（发起方或收件人均可）。 */
+    async cancelTransfer(transferId) {
+        return this.send('POST', '/v1/ans/transfer/cancel', { transfer_id: transferId });
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/sdk/client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * ANS 注册方 SDK（@noble/@scure 自包含）：请求签名 + AnsRegistrarClient（注册/绑定/续费/释放/代客注册）。
+ * 解析+校验是另一侧能力，见 ans-resolver 的客户端 SDK（`ans-resolver/client`）。
+ */
+export * from './signing.js';
+export * from './client.js';

package/dist/index.js

@@ -0,0 +1,7 @@
+/**
+ * ANS 注册方 SDK（@noble/@scure 自包含）：请求签名 + AnsRegistrarClient（注册/绑定/续费/释放/代客注册）。
+ * 解析+校验是另一侧能力，见 ans-resolver 的客户端 SDK（`ans-resolver/client`）。
+ */
+export * from './signing.js';
+export * from './client.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/sdk/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}

package/dist/signing.d.ts

@@ -0,0 +1,55 @@
+/**
+ * 注册方 SDK —— 请求签名（OQ-5，与服务端 auth/signing.ts 同 canonical 格式 A2A-ANS-v1）。
+ *
+ * 自包含：仅依赖 @noble/@scure，不引入服务端任何模块（config/store 等），便于外部注册商安装即用。
+ * 格式正确性由 test/sdk/registrar.test.ts 用服务端真实 verifyRequestSignature 交叉校验守护，杜绝漂移。
+ */
+/** 32 字节原始公钥 → participant_id（`a2a:z…`）。 */
+export declare function encodeParticipantId(publicKey: Uint8Array): string;
+export interface Keypair {
+    privateKey: Uint8Array;
+    publicKey: Uint8Array;
+    participantId: string;
+}
+/** 生成一对新 Ed25519 密钥（私钥 32 字节种子）。 */
+export declare function generateKeypair(): Promise<Keypair>;
+/** 构造规范化请求字节（与服务端逐字节一致）。 */
+export declare function canonicalRequest(input: {
+    method: string;
+    path: string;
+    bodyBytes: Uint8Array;
+    participantId: string;
+    nonce: string;
+    timestamp: string;
+}): Uint8Array;
+/** 请求签名头（附到 HTTP 请求）。 */
+export interface SignedHeaders {
+    'x-ans-participant': string;
+    'x-ans-nonce': string;
+    'x-ans-timestamp': string;
+    'x-ans-signature': string;
+}
+/** 用私钥对请求签名，返回 x-ans-* 头。nonce/timestamp 可注入（测试），否则随机/当前。 */
+export declare function signRequest(input: {
+    method: string;
+    path: string;
+    bodyBytes: Uint8Array;
+    privateKey: Uint8Array;
+    participantId: string;
+    nowEpochSec?: number;
+    nonce?: string;
+}): Promise<SignedHeaders>;
+/** 共签头（transfer 双签：新 owner 对**同一** nonce/timestamp/body 的 canonical 以自身 pid 再签）。 */
+export interface CosignHeaders {
+    'x-ans-cosign-participant': string;
+    'x-ans-cosign-signature': string;
+}
+export declare function cosignRequest(input: {
+    method: string;
+    path: string;
+    bodyBytes: Uint8Array;
+    cosignerPrivateKey: Uint8Array;
+    cosignerParticipantId: string;
+    nonce: string;
+    timestamp: string;
+}): Promise<CosignHeaders>;

package/dist/signing.js

@@ -0,0 +1,45 @@
+/**
+ * 注册方 SDK —— 请求签名（OQ-5，与服务端 auth/signing.ts 同 canonical 格式 A2A-ANS-v1）。
+ *
+ * 自包含：仅依赖 @noble/@scure，不引入服务端任何模块（config/store 等），便于外部注册商安装即用。
+ * 格式正确性由 test/sdk/registrar.test.ts 用服务端真实 verifyRequestSignature 交叉校验守护，杜绝漂移。
+ */
+import { getPublicKeyAsync, signAsync } from '@noble/ed25519';
+import { sha256 } from '@noble/hashes/sha256';
+import { bytesToHex } from '@noble/hashes/utils';
+import { base58 } from '@scure/base';
+import { randomBytes } from 'node:crypto';
+const PARTICIPANT_PREFIX = 'a2a:z';
+const CANONICAL_VERSION = 'A2A-ANS-v1';
+const UTF8 = new TextEncoder();
+/** 32 字节原始公钥 → participant_id（`a2a:z…`）。 */
+export function encodeParticipantId(publicKey) {
+    return PARTICIPANT_PREFIX + base58.encode(publicKey);
+}
+/** 生成一对新 Ed25519 密钥（私钥 32 字节种子）。 */
+export async function generateKeypair() {
+    const privateKey = Uint8Array.from(randomBytes(32));
+    const publicKey = await getPublicKeyAsync(privateKey);
+    return { privateKey, publicKey, participantId: encodeParticipantId(publicKey) };
+}
+/** 构造规范化请求字节（与服务端逐字节一致）。 */
+export function canonicalRequest(input) {
+    return UTF8.encode(`${CANONICAL_VERSION}\n${input.method.toUpperCase()}\n${input.path}\n${bytesToHex(sha256(input.bodyBytes))}\n${input.participantId}\n${input.nonce}\n${input.timestamp}`);
+}
+/** 用私钥对请求签名，返回 x-ans-* 头。nonce/timestamp 可注入（测试），否则随机/当前。 */
+export async function signRequest(input) {
+    const timestamp = String(input.nowEpochSec ?? Math.floor(Date.now() / 1000));
+    const nonce = input.nonce ?? base58.encode(Uint8Array.from(randomBytes(16)));
+    const sig = await signAsync(canonicalRequest({ method: input.method, path: input.path, bodyBytes: input.bodyBytes, participantId: input.participantId, nonce, timestamp }), input.privateKey);
+    return {
+        'x-ans-participant': input.participantId,
+        'x-ans-nonce': nonce,
+        'x-ans-timestamp': timestamp,
+        'x-ans-signature': Buffer.from(sig).toString('base64'),
+    };
+}
+export async function cosignRequest(input) {
+    const sig = await signAsync(canonicalRequest({ method: input.method, path: input.path, bodyBytes: input.bodyBytes, participantId: input.cosignerParticipantId, nonce: input.nonce, timestamp: input.timestamp }), input.cosignerPrivateKey);
+    return { 'x-ans-cosign-participant': input.cosignerParticipantId, 'x-ans-cosign-signature': Buffer.from(sig).toString('base64') };
+}
+//# sourceMappingURL=signing.js.map

package/dist/signing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signing.js","sourceRoot":"","sources":["../../../src/sdk/signing.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,36 @@
 {
   "name": "@a2afoundation/ans-registrar-sdk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Registrar SDK for the A2A Agent Name Service.",
+  "type": "module",
+  "private": false,
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "types": "./dist/index.d.ts",
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "pack:dry-run": "npm pack --dry-run",
+    "prepack": "npm run build"
+  },
+  "dependencies": {
+    "@noble/ed25519": "^2.1.0",
+    "@noble/hashes": "^1.4.0",
+    "@scure/base": "^1.1.6"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}