@claw-network/sdk 0.5.3 → 0.6.0

package/dist/index.d.ts

@@ -23,6 +23,8 @@ export { MarketsApi, InfoMarketApi, TaskMarketApi, CapabilityMarketApi, MarketDi
 export { ContractsApi } from './contracts.js';
 export { DaoApi } from './dao.js';
 export { MessagingApi, RECEIPT_TOPIC } from './messaging.js';
+export { RelayApi } from './relay.js';
+export type { RelayStats, RelayPeriodStats, RelayHealthInfo, RelayAccessInfo, RelayAccessUpdateParams, } from './relay.js';
 export type { SendMessageParams, SendMessageResult, SendBatchParams, SendBatchResult, InboxMessage, InboxQueryParams, InboxResponse, RelayAttachmentParams, RelayAttachmentResult, AttachmentInfo, AttachmentListResponse, } from './messaging.js';
 export * from './types.js';
 import { HttpClient, type HttpClientConfig } from './http.js';
@@ -34,6 +36,7 @@ import { MarketsApi } from './markets.js';
 import { ContractsApi } from './contracts.js';
 import { DaoApi } from './dao.js';
 import { MessagingApi } from './messaging.js';
+import { RelayApi } from './relay.js';
 /** Configuration for the top-level client. */
 export type ClientConfig = HttpClientConfig;
 /**
@@ -53,6 +56,7 @@ export declare class ClawNetClient {
     readonly contracts: ContractsApi;
     readonly dao: DaoApi;
     readonly messaging: MessagingApi;
+    readonly relay: RelayApi;
     constructor(config?: Partial<ClientConfig>);
 }
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACvF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC/G,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC7D,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,qBAAqB,EACrB,qBAAqB,EACrB,cAAc,EACd,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAGxB,cAAc,YAAY,CAAC;AAE3B,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,8CAA8C;AAC9C,MAAM,MAAM,YAAY,GAAG,gBAAgB,CAAC;AAI5C;;;;;;GAMG;AACH,qBAAa,aAAa;IACxB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;gBAErB,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC;CAc3C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACvF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC/G,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EACV,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,uBAAuB,GACxB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,qBAAqB,EACrB,qBAAqB,EACrB,cAAc,EACd,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAGxB,cAAc,YAAY,CAAC;AAE3B,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,8CAA8C;AAC9C,MAAM,MAAM,YAAY,GAAG,gBAAgB,CAAC;AAI5C;;;;;;GAMG;AACH,qBAAa,aAAa;IACxB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;gBAEb,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC;CAe3C"}

package/dist/index.js

@@ -24,6 +24,7 @@ export { MarketsApi, InfoMarketApi, TaskMarketApi, CapabilityMarketApi, MarketDi
 export { ContractsApi } from './contracts.js';
 export { DaoApi } from './dao.js';
 export { MessagingApi, RECEIPT_TOPIC } from './messaging.js';
+export { RelayApi } from './relay.js';
 // ── Shared types ─────────────────────────────────────────────────────────
 export * from './types.js';
 import { HttpClient } from './http.js';
@@ -35,6 +36,7 @@ import { MarketsApi } from './markets.js';
 import { ContractsApi } from './contracts.js';
 import { DaoApi } from './dao.js';
 import { MessagingApi } from './messaging.js';
+import { RelayApi } from './relay.js';
 const DEFAULT_BASE_URL = 'http://127.0.0.1:9528';
 /**
  * Top-level client that exposes all ClawNet APIs via REST.
@@ -53,6 +55,7 @@ export class ClawNetClient {
     contracts;
     dao;
     messaging;
+    relay;
     constructor(config) {
         this.http = new HttpClient({
             baseUrl: config?.baseUrl ?? DEFAULT_BASE_URL,
@@ -66,6 +69,7 @@ export class ClawNetClient {
         this.contracts = new ContractsApi(this.http);
         this.dao = new DaoApi(this.http);
         this.messaging = new MessagingApi(this.http);
+        this.relay = new RelayApi(this.http);
     }
 }
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,4EAA4E;AAC5E,OAAO,EAAE,UAAU,EAAoC,YAAY,EAAE,MAAM,WAAW,CAAC;AACvF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC/G,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAe7D,4EAA4E;AAC5E,cAAc,YAAY,CAAC;AAE3B,OAAO,EAAE,UAAU,EAAyB,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAK9C,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,OAAO,aAAa;IACf,IAAI,CAAa;IACjB,IAAI,CAAU;IACd,QAAQ,CAAc;IACtB,MAAM,CAAY;IAClB,UAAU,CAAgB;IAC1B,OAAO,CAAa;IACpB,SAAS,CAAe;IACxB,GAAG,CAAS;IACZ,SAAS,CAAe;IAEjC,YAAY,MAA8B;QACxC,IAAI,CAAC,IAAI,GAAG,IAAI,UAAU,CAAC;YACzB,OAAO,EAAE,MAAM,EAAE,OAAO,IAAI,gBAAgB;YAC5C,GAAG,MAAM;SACV,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,QAAQ,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,MAAM,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,UAAU,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,CAAC,OAAO,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,SAAS,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,GAAG,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,SAAS,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC;CACF"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,4EAA4E;AAC5E,OAAO,EAAE,UAAU,EAAoC,YAAY,EAAE,MAAM,WAAW,CAAC;AACvF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC/G,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAsBtC,4EAA4E;AAC5E,cAAc,YAAY,CAAC;AAE3B,OAAO,EAAE,UAAU,EAAyB,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAKtC,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,OAAO,aAAa;IACf,IAAI,CAAa;IACjB,IAAI,CAAU;IACd,QAAQ,CAAc;IACtB,MAAM,CAAY;IAClB,UAAU,CAAgB;IAC1B,OAAO,CAAa;IACpB,SAAS,CAAe;IACxB,GAAG,CAAS;IACZ,SAAS,CAAe;IACxB,KAAK,CAAW;IAEzB,YAAY,MAA8B;QACxC,IAAI,CAAC,IAAI,GAAG,IAAI,UAAU,CAAC;YACzB,OAAO,EAAE,MAAM,EAAE,OAAO,IAAI,gBAAgB;YAC5C,GAAG,MAAM;SACV,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,QAAQ,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,MAAM,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,UAAU,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,CAAC,OAAO,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,SAAS,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,GAAG,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,SAAS,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;CACF"}

package/dist/relay.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Relay API — relay statistics, health diagnosis, access control,
+ * relay discovery, quality scoring, and drain management.
+ */
+import type { HttpClient, RequestOptions } from './http.js';
+export interface RelayPeriodStats {
+    periodStart: number;
+    periodEnd: number;
+    bytesRelayed: number;
+    attachmentBytesRelayed: number;
+    circuitsServed: number;
+    uniquePeersServed: number;
+}
+export interface RelayStats {
+    relayEnabled: boolean;
+    totalCircuitsServed: number;
+    activeCircuits: number;
+    totalBytesRelayed: number;
+    totalMessagesRelayed: number;
+    totalAttachmentBytesRelayed: number;
+    uptimeSeconds: number;
+    periodStats: RelayPeriodStats;
+}
+export interface RelayHealthInfo {
+    relayEnabled: boolean;
+    natStatus: 'public' | 'private' | 'unknown';
+    publicAddresses: string[];
+    isReachable: boolean;
+    load: {
+        activeCircuits: number;
+        maxCircuits: number;
+        utilizationPercent: number;
+    };
+    warnings: string[];
+}
+export interface RelayAccessInfo {
+    mode: 'open' | 'whitelist' | 'blacklist';
+    list: string[];
+}
+export interface RelayAccessUpdateParams {
+    action?: 'add' | 'remove';
+    did?: string;
+    mode?: 'open' | 'whitelist' | 'blacklist';
+}
+/** Relay discovery result (F2). */
+export interface RelayDiscoveryInfo {
+    relays: string[];
+    count: number;
+}
+/** Relay quality score (F5). */
+export interface RelayScore {
+    peerId: string;
+    latencyMs: number;
+    availableCapacity: number;
+    maxCapacity: number;
+    successRate: number;
+    uptimeSeconds: number;
+    score: number;
+}
+/** Relay scoring result (F5). */
+export interface RelayScoresInfo {
+    scores: RelayScore[];
+    count: number;
+}
+/** Relay peers info (F12). */
+export interface RelayPeersInfo {
+    peers: string[];
+    count: number;
+    draining: boolean;
+}
+/** Relay drain result (F12). */
+export interface RelayDrainResult {
+    draining: boolean;
+}
+/** A single peer's co-signed confirmation of relay traffic (F10). */
+export interface PeerConfirmation {
+    peerDid: string;
+    bytesConfirmed: number;
+    circuitsConfirmed: number;
+    signature: string;
+}
+/** Period contribution proof with co-signatures (F4). */
+export interface RelayPeriodProof {
+    relayDid: string;
+    periodId: number;
+    periodStart: number;
+    periodEnd: number;
+    bytesRelayed: number;
+    attachmentBytesRelayed: number;
+    circuitsServed: number;
+    uniquePeersServed: number;
+    peerConfirmations: PeerConfirmation[];
+    relaySignature: string;
+}
+/** Params for confirming relay contribution (F10). */
+export interface ConfirmContributionParams {
+    peerDid: string;
+    bytesConfirmed: number;
+    circuitsConfirmed: number;
+    signature: string;
+}
+/** Result of confirm-contribution (F10). */
+export interface ConfirmContributionResult {
+    accepted: boolean;
+    peerDid: string;
+    bytesConfirmed: number;
+    circuitsConfirmed: number;
+}
+export declare class RelayApi {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** Get relay traffic statistics. */
+    getStats(opts?: RequestOptions): Promise<RelayStats>;
+    /** Get relay self-diagnosis health info. */
+    getHealth(opts?: RequestOptions): Promise<RelayHealthInfo>;
+    /** Get current relay access control settings. */
+    getAccess(opts?: RequestOptions): Promise<RelayAccessInfo>;
+    /** Update relay access control settings (add/remove DID, or change mode). */
+    updateAccess(params: RelayAccessUpdateParams, opts?: RequestOptions): Promise<RelayAccessInfo>;
+    /** Discover relay nodes via DHT (F2). */
+    discover(opts?: RequestOptions): Promise<RelayDiscoveryInfo>;
+    /** Get scored relay candidates (F5). Discovers + probes + scores. */
+    getScores(opts?: RequestOptions): Promise<RelayScoresInfo>;
+    /** Get peers using this node as relay (F12). */
+    getPeers(opts?: RequestOptions): Promise<RelayPeersInfo>;
+    /** Start or stop graceful relay drain (F12). */
+    setDrain(enable?: boolean, opts?: RequestOptions): Promise<RelayDrainResult>;
+    /** Get the last generated period proof (F4). */
+    getPeriodProof(opts?: RequestOptions): Promise<RelayPeriodProof | null>;
+    /** Generate a new period proof (F4). */
+    generatePeriodProof(relayDid: string, opts?: RequestOptions): Promise<RelayPeriodProof>;
+    /** Confirm relay contribution as a served peer (F10). */
+    confirmContribution(params: ConfirmContributionParams, opts?: RequestOptions): Promise<ConfirmContributionResult>;
+}
+//# sourceMappingURL=relay.d.ts.map

package/dist/relay.d.ts.map

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

package/dist/relay.js

@@ -0,0 +1,55 @@
+// ── API class ───────────────────────────────────────────────────
+export class RelayApi {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** Get relay traffic statistics. */
+    async getStats(opts) {
+        return this.http.get('/api/v1/relay/stats', undefined, opts);
+    }
+    /** Get relay self-diagnosis health info. */
+    async getHealth(opts) {
+        return this.http.get('/api/v1/relay/health', undefined, opts);
+    }
+    /** Get current relay access control settings. */
+    async getAccess(opts) {
+        return this.http.get('/api/v1/relay/access', undefined, opts);
+    }
+    /** Update relay access control settings (add/remove DID, or change mode). */
+    async updateAccess(params, opts) {
+        return this.http.post('/api/v1/relay/access', params, opts);
+    }
+    /** Discover relay nodes via DHT (F2). */
+    async discover(opts) {
+        return this.http.get('/api/v1/relay/discover', undefined, opts);
+    }
+    /** Get scored relay candidates (F5). Discovers + probes + scores. */
+    async getScores(opts) {
+        return this.http.get('/api/v1/relay/scores', undefined, opts);
+    }
+    /** Get peers using this node as relay (F12). */
+    async getPeers(opts) {
+        return this.http.get('/api/v1/relay/peers', undefined, opts);
+    }
+    /** Start or stop graceful relay drain (F12). */
+    async setDrain(enable = true, opts) {
+        return this.http.post('/api/v1/relay/drain', { enable }, opts);
+    }
+    /** Get the last generated period proof (F4). */
+    async getPeriodProof(opts) {
+        const result = await this.http.get('/api/v1/relay/period-proof', undefined, opts);
+        if ('proof' in result && result.proof === null)
+            return null;
+        return result;
+    }
+    /** Generate a new period proof (F4). */
+    async generatePeriodProof(relayDid, opts) {
+        return this.http.post('/api/v1/relay/period-proof', { relayDid }, opts);
+    }
+    /** Confirm relay contribution as a served peer (F10). */
+    async confirmContribution(params, opts) {
+        return this.http.post('/api/v1/relay/confirm-contribution', params, opts);
+    }
+}
+//# sourceMappingURL=relay.js.map

package/dist/relay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay.js","sourceRoot":"","sources":["../src/relay.ts"],"names":[],"mappings":"AA6HA,mEAAmE;AAEnE,MAAM,OAAO,QAAQ;IACU;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD,oCAAoC;IACpC,KAAK,CAAC,QAAQ,CAAC,IAAqB;QAClC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAa,qBAAqB,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IAC3E,CAAC;IAED,4CAA4C;IAC5C,KAAK,CAAC,SAAS,CAAC,IAAqB;QACnC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAkB,sBAAsB,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IACjF,CAAC;IAED,iDAAiD;IACjD,KAAK,CAAC,SAAS,CAAC,IAAqB;QACnC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAkB,sBAAsB,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IACjF,CAAC;IAED,6EAA6E;IAC7E,KAAK,CAAC,YAAY,CAAC,MAA+B,EAAE,IAAqB;QACvE,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAkB,sBAAsB,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IAC/E,CAAC;IAED,yCAAyC;IACzC,KAAK,CAAC,QAAQ,CAAC,IAAqB;QAClC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAqB,wBAAwB,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IACtF,CAAC;IAED,qEAAqE;IACrE,KAAK,CAAC,SAAS,CAAC,IAAqB;QACnC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAkB,sBAAsB,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IACjF,CAAC;IAED,gDAAgD;IAChD,KAAK,CAAC,QAAQ,CAAC,IAAqB;QAClC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAiB,qBAAqB,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IAC/E,CAAC;IAED,gDAAgD;IAChD,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,IAAI,EAAE,IAAqB;QACjD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAmB,qBAAqB,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,CAAC;IACnF,CAAC;IAED,gDAAgD;IAChD,KAAK,CAAC,cAAc,CAAC,IAAqB;QACxC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAChC,4BAA4B,EAAE,SAAS,EAAE,IAAI,CAC9C,CAAC;QACF,IAAI,OAAO,IAAI,MAAM,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAC5D,OAAO,MAA0B,CAAC;IACpC,CAAC;IAED,wCAAwC;IACxC,KAAK,CAAC,mBAAmB,CAAC,QAAgB,EAAE,IAAqB;QAC/D,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAmB,4BAA4B,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,CAAC,CAAC;IAC5F,CAAC;IAED,yDAAyD;IACzD,KAAK,CAAC,mBAAmB,CAAC,MAAiC,EAAE,IAAqB;QAChF,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAA4B,oCAAoC,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IACvG,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claw-network/sdk",
-  "version": "0.5.3",
+  "version": "0.6.0",
   "description": "TypeScript SDK for the ClawNet decentralized agent economy",
   "type": "module",
   "main": "dist/index.js",
@@ -31,6 +31,6 @@
   "scripts": {
     "build": "tsc -b tsconfig.json",
     "test": "vitest run --passWithNoTests",
-    "lint": "eslint src --max-warnings=0"
+    "lint": "eslint src test --max-warnings=0"
   }
 }