zerc20-client-sdk 0.1.13 → 0.1.14

package/dist/ic/candid.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Candid type definitions for ICP canister interaction.
+ * These types match the canister interface (snake_case) and are internal implementation details.
+ *
+ * @remarks
+ * Most SDK consumers should not import this module directly. Use {@link StealthCanisterClient}
+ * and the higher-level operations in `src/operations/*`.
+ */
+import { ActorMethod } from "@dfinity/agent";
+import type { CanisterResult } from "./types.js";
+export type KeyManagerActor = {
+    get_view_public_key: ActorMethod<[Uint8Array], CanisterResult<Uint8Array>>;
+    request_encrypted_view_key: ActorMethod<[
+        EncryptedViewKeyRequestCandid
+    ], CanisterResult<Uint8Array>>;
+    get_max_nonce: ActorMethod<[Uint8Array], CanisterResult<bigint>>;
+};
+export type StorageActor = {
+    submit_announcement: ActorMethod<[AnnouncementInputCandid], CanisterResult<AnnouncementCandid>>;
+    submit_invoice: ActorMethod<[InvoiceSubmissionCandid], CanisterResult<null>>;
+    list_invoices: ActorMethod<[Uint8Array, string], CanisterResult<Uint8Array[]>>;
+    list_announcements: ActorMethod<[[] | [bigint], [] | [number], string], AnnouncementPageCandid>;
+    list_announcements_by_time: ActorMethod<[
+        [] | [bigint],
+        [] | [number],
+        string
+    ], AnnouncementPageByTimeCandid>;
+    get_announcement: ActorMethod<[bigint], [] | [AnnouncementCandid]>;
+};
+export interface AnnouncementInputCandid {
+    ibe_ciphertext: Uint8Array;
+    ciphertext: Uint8Array;
+    nonce: Uint8Array;
+    tag: string;
+}
+export interface EncryptedViewKeyRequestCandid {
+    address: Uint8Array;
+    transport_public_key: Uint8Array;
+    expiry_ns: bigint;
+    nonce: bigint;
+    signature: Uint8Array;
+}
+export interface InvoiceSubmissionCandid {
+    invoice_id: Uint8Array;
+    signature: Uint8Array;
+    tag: string;
+}
+export interface AnnouncementCandid {
+    id: bigint;
+    ibe_ciphertext: Uint8Array;
+    ciphertext: Uint8Array;
+    nonce: Uint8Array;
+    created_at_ns: bigint;
+    tag: string;
+}
+export interface AnnouncementPageCandid {
+    announcements: AnnouncementCandid[];
+    next_id: [] | [bigint];
+}
+export interface AnnouncementPageByTimeCandid {
+    announcements: AnnouncementCandid[];
+    next_ts: [] | [bigint];
+}
+/**
+ * Unwraps a canister result, handling both Ok/Err and ok/err variants.
+ * @param result - Result union returned by canister method.
+ * @param method - Method name used for error context.
+ * @throws {@link StealthError} if the result is an error variant.
+ * @throws {@link StealthError} if the variant is unknown.
+ */
+export declare function unwrapResult<T>(result: CanisterResult<T>, method: string): T;
+//# sourceMappingURL=candid.d.ts.map

package/dist/ic/candid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"candid.d.ts","sourceRoot":"","sources":["../../src/ic/candid.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMjD,MAAM,MAAM,eAAe,GAAG;IAC5B,mBAAmB,EAAE,WAAW,CAAC,CAAC,UAAU,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC;IAC3E,0BAA0B,EAAE,WAAW,CACrC;QAAC,6BAA6B;KAAC,EAC/B,cAAc,CAAC,UAAU,CAAC,CAC3B,CAAC;IACF,aAAa,EAAE,WAAW,CAAC,CAAC,UAAU,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;CAClE,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,mBAAmB,EAAE,WAAW,CAAC,CAAC,uBAAuB,CAAC,EAAE,cAAc,CAAC,kBAAkB,CAAC,CAAC,CAAC;IAChG,cAAc,EAAE,WAAW,CAAC,CAAC,uBAAuB,CAAC,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7E,aAAa,EAAE,WAAW,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,cAAc,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IAC/E,kBAAkB,EAAE,WAAW,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,sBAAsB,CAAC,CAAC;IAChG,0BAA0B,EAAE,WAAW,CACrC;QAAC,EAAE,GAAG,CAAC,MAAM,CAAC;QAAE,EAAE,GAAG,CAAC,MAAM,CAAC;QAAE,MAAM;KAAC,EACtC,4BAA4B,CAC7B,CAAC;IACF,gBAAgB,EAAE,WAAW,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC;CACpE,CAAC;AAMF,MAAM,WAAW,uBAAuB;IACtC,cAAc,EAAE,UAAU,CAAC;IAC3B,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,EAAE,UAAU,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,UAAU,CAAC;IACpB,oBAAoB,EAAE,UAAU,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,UAAU,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,UAAU,CAAC;IACvB,SAAS,EAAE,UAAU,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,UAAU,CAAC;IAC3B,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,EAAE,UAAU,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,kBAAkB,EAAE,CAAC;IACpC,OAAO,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,4BAA4B;IAC3C,aAAa,EAAE,kBAAkB,EAAE,CAAC;IACpC,OAAO,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACxB;AAMD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,CAc5E"}

package/dist/ic/candid.js

@@ -0,0 +1,35 @@
+/**
+ * Candid type definitions for ICP canister interaction.
+ * These types match the canister interface (snake_case) and are internal implementation details.
+ *
+ * @remarks
+ * Most SDK consumers should not import this module directly. Use {@link StealthCanisterClient}
+ * and the higher-level operations in `src/operations/*`.
+ */
+import { StealthError } from "./errors.js";
+// ============================================================================
+// Result Unwrapping
+// ============================================================================
+/**
+ * Unwraps a canister result, handling both Ok/Err and ok/err variants.
+ * @param result - Result union returned by canister method.
+ * @param method - Method name used for error context.
+ * @throws {@link StealthError} if the result is an error variant.
+ * @throws {@link StealthError} if the variant is unknown.
+ */
+export function unwrapResult(result, method) {
+    if ("Ok" in result) {
+        return result.Ok;
+    }
+    if ("ok" in result) {
+        return result.ok;
+    }
+    if ("Err" in result) {
+        throw new StealthError(`${method} failed: ${result.Err}`);
+    }
+    if ("err" in result) {
+        throw new StealthError(`${method} failed: ${result.err}`);
+    }
+    throw new StealthError(`${method} failed: unknown canister result variant`);
+}
+//# sourceMappingURL=candid.js.map

package/dist/ic/candid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"candid.js","sourceRoot":"","sources":["../../src/ic/candid.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAwE3C,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAI,MAAyB,EAAE,MAAc;IACvE,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC,EAAE,CAAC;IACnB,CAAC;IACD,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC,EAAE,CAAC;IACnB,CAAC;IACD,IAAI,KAAK,IAAI,MAAM,EAAE,CAAC;QACpB,MAAM,IAAI,YAAY,CAAC,GAAG,MAAM,YAAY,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;IAC5D,CAAC;IACD,IAAI,KAAK,IAAI,MAAM,EAAE,CAAC;QACpB,MAAM,IAAI,YAAY,CAAC,GAAG,MAAM,YAAY,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;IAC5D,CAAC;IACD,MAAM,IAAI,YAAY,CAAC,GAAG,MAAM,0CAA0C,CAAC,CAAC;AAC9E,CAAC"}

package/dist/ic/client.d.ts

@@ -1,89 +1,87 @@
-import { ActorMethod, Agent } from "@dfinity/agent";
+import { Agent } from "@dfinity/agent";
 import { Principal } from "@dfinity/principal";
-import { Announcement, AnnouncementInput, AnnouncementPage, AnnouncementPageByTime, CanisterResult, EncryptedViewKeyRequest, InvoiceSubmission } from "./types.js";
-export type KeyManagerActor = {
-    get_view_public_key: ActorMethod<[Uint8Array], CanisterResult<Uint8Array>>;
-    request_encrypted_view_key: ActorMethod<[
-        EncryptedViewKeyRequestCandid
-    ], CanisterResult<Uint8Array>>;
-    get_max_nonce: ActorMethod<[Uint8Array], CanisterResult<bigint>>;
-};
-export interface AnnouncementInputCandid {
-    ibe_ciphertext: Uint8Array;
-    ciphertext: Uint8Array;
-    nonce: Uint8Array;
-    tag: string;
-}
-export interface EncryptedViewKeyRequestCandid {
-    address: Uint8Array;
-    transport_public_key: Uint8Array;
-    expiry_ns: bigint;
-    nonce: bigint;
-    signature: Uint8Array;
-}
-export interface InvoiceSubmissionCandid {
-    invoice_id: Uint8Array;
-    signature: Uint8Array;
-    tag: string;
-}
-export type StorageActor = {
-    submit_announcement: ActorMethod<[AnnouncementInputCandid], CanisterResult<AnnouncementCandid>>;
-    submit_invoice: ActorMethod<[InvoiceSubmissionCandid], CanisterResult<null>>;
-    list_invoices: ActorMethod<[Uint8Array, string], CanisterResult<Uint8Array[]>>;
-    list_announcements: ActorMethod<[
-        [] | [bigint],
-        [] | [number],
-        string
-    ], AnnouncementPageCandid>;
-    list_announcements_by_time: ActorMethod<[
-        [] | [bigint],
-        [] | [number],
-        string
-    ], AnnouncementPageByTimeCandid>;
-    get_announcement: ActorMethod<[bigint], [] | [AnnouncementCandid]>;
-};
-export interface AnnouncementCandid {
-    id: bigint;
-    ibe_ciphertext: Uint8Array;
-    ciphertext: Uint8Array;
-    nonce: Uint8Array;
-    created_at_ns: bigint;
-    tag: string;
-}
-export interface AnnouncementPageCandid {
-    announcements: AnnouncementCandid[];
-    next_id: [] | [bigint];
-}
-export interface AnnouncementPageByTimeCandid {
-    announcements: AnnouncementCandid[];
-    next_ts: [] | [bigint];
-}
+import { AnnouncementCandid, AnnouncementInputCandid, EncryptedViewKeyRequestCandid, InvoiceSubmissionCandid } from "./candid.js";
+import { Announcement, AnnouncementInput, AnnouncementPage, AnnouncementPageByTime, EncryptedViewKeyRequest, InvoiceSubmission } from "./types.js";
+/**
+ * Internet Computer canister client used for stealth announcements and invoices.
+ * @remarks
+ * This client:
+ * - Creates and memoizes canister actors for the key manager and storage canisters.
+ * - Unwraps `Result`-style canister responses (`Ok`/`ok`, `Err`/`err`) via `unwrapResult`.
+ */
 export declare class StealthCanisterClient {
     private readonly agent;
     private readonly storageCanisterId;
     private readonly keyManagerCanisterId;
     private keyManagerActor;
     private storageActor;
+    /**
+     * Create a canister client using a pre-configured {@link Agent} and canister principals.
+     */
     constructor(agent: Agent, storageCanisterId: Principal, keyManagerCanisterId: Principal);
+    /** Return the configured agent. */
     getAgent(): Agent;
+    /** Return the configured storage canister id. */
     getStorageCanisterId(): Principal;
+    /** Return the configured key manager canister id. */
     getKeyManagerCanisterId(): Principal;
+    /**
+     * Fetch the view public key for an EVM address (encoded as bytes).
+     */
     getViewPublicKey(address: Uint8Array): Promise<Uint8Array>;
+    /**
+     * Request an encrypted view key (vetKD flow).
+     * @remarks See {@link EncryptedViewKeyRequest} for required signature/nonce/expiry fields.
+     */
     requestEncryptedViewKey(request: EncryptedViewKeyRequest): Promise<Uint8Array>;
+    /**
+     * Read the maximum nonce for the given address from the key manager canister.
+     */
     getMaxNonce(address: Uint8Array): Promise<bigint>;
+    /**
+     * Submit an encrypted announcement to the storage canister.
+     */
     submitAnnouncement(input: AnnouncementInput): Promise<Announcement>;
+    /**
+     * Submit an invoice (signed pointer) to the storage canister.
+     */
     submitInvoice(submission: InvoiceSubmission): Promise<void>;
+    /**
+     * List invoice ids for an address.
+     * @param address - Address bytes used by the canister as the invoice owner key.
+     * @param tag - Optional storage tag. Defaults to {@link DEFAULT_ZSTORAGE_TAG}.
+     */
     listInvoices(address: Uint8Array, tag?: string): Promise<Uint8Array[]>;
+    /**
+     * List announcements using an id-based cursor.
+     * @param startAfter - If provided, results start strictly after this announcement id.
+     * @param limit - Maximum number of announcements to return.
+     * @param tag - Optional storage tag. Defaults to {@link DEFAULT_ZSTORAGE_TAG}.
+     * @returns A page with announcements and `nextId` cursor (or null if no more pages).
+     */
     listAnnouncements(startAfter?: bigint, limit?: number, tag?: string): Promise<AnnouncementPage>;
     /**
      * List announcements filtered by time.
      * @param startAfterTs - Timestamp in nanoseconds. Only announcements created after this time will be returned.
      * @param limit - Maximum number of announcements to return.
      * @param tag - Storage tag to filter by.
+     * @returns A page with announcements and `nextTs` cursor (or null if no more pages).
      */
     listAnnouncementsByTime(startAfterTs?: bigint, limit?: number, tag?: string): Promise<AnnouncementPageByTime>;
+    /**
+     * Fetch a single announcement by its id.
+     * @returns The announcement if present, otherwise `null`.
+     */
     getAnnouncement(id: bigint): Promise<Announcement | null>;
     private getKeyManagerActor;
     private getStorageActor;
 }
+/** @internal */
+export declare function mapAnnouncement(announcement: AnnouncementCandid): Announcement;
+/** @internal */
+export declare function toCandidAnnouncementInput(input: AnnouncementInput): AnnouncementInputCandid;
+/** @internal */
+export declare function toCandidEncryptedViewKeyRequest(request: EncryptedViewKeyRequest): EncryptedViewKeyRequestCandid;
+/** @internal */
+export declare function toCandidInvoiceSubmission(submission: InvoiceSubmission): InvoiceSubmissionCandid;
 //# sourceMappingURL=client.d.ts.map

package/dist/ic/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/ic/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/ic/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,6BAA6B,EAC7B,uBAAuB,EAIxB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAGpB;;;;;;GAMG;AACH,qBAAa,qBAAqB;IAQ9B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IATvC,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,YAAY,CAA6B;IAEjD;;OAEG;gBAEgB,KAAK,EAAE,KAAK,EACZ,iBAAiB,EAAE,SAAS,EAC5B,oBAAoB,EAAE,SAAS;IAGlD,mCAAmC;IACnC,QAAQ,IAAI,KAAK;IAIjB,iDAAiD;IACjD,oBAAoB,IAAI,SAAS;IAIjC,qDAAqD;IACrD,uBAAuB,IAAI,SAAS;IAIpC;;OAEG;IACG,gBAAgB,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAMhE;;;OAGG;IACG,uBAAuB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC;IAMpF;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAMvD;;OAEG;IACG,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC;IAOzE;;OAEG;IACG,aAAa,CAAC,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjE;;;;OAIG;IACG,YAAY,CAChB,OAAO,EAAE,UAAU,EACnB,GAAG,GAAE,MAA6B,GACjC,OAAO,CAAC,UAAU,EAAE,CAAC;IAMxB;;;;;;OAMG;IACG,iBAAiB,CACrB,UAAU,CAAC,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE,MAAM,EACd,GAAG,GAAE,MAA6B,GACjC,OAAO,CAAC,gBAAgB,CAAC;IAW5B;;;;;;OAMG;IACG,uBAAuB,CAC3B,YAAY,CAAC,EAAE,MAAM,EACrB,KAAK,CAAC,EAAE,MAAM,EACd,GAAG,GAAE,MAA6B,GACjC,OAAO,CAAC,sBAAsB,CAAC;IAWlC;;;OAGG;IACG,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;YASjD,kBAAkB;YAWlB,eAAe;CAU9B;AAMD,gBAAgB;AAChB,wBAAgB,eAAe,CAAC,YAAY,EAAE,kBAAkB,GAAG,YAAY,CAS9E;AAED,gBAAgB;AAChB,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,iBAAiB,GAAG,uBAAuB,CAO3F;AAED,gBAAgB;AAChB,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,uBAAuB,GAC/B,6BAA6B,CAQ/B;AAED,gBAAgB;AAChB,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,iBAAiB,GAAG,uBAAuB,CAMhG"}

package/dist/ic/client.js

@@ -1,57 +1,99 @@
 import { Actor } from "@dfinity/agent";
-import { StealthError } from "./errors.js";
+import { unwrapResult, } from "./candid.js";
+import { keyManagerIdlFactory, storageIdlFactory } from "./idl.js";
 import { DEFAULT_ZSTORAGE_TAG } from "../constants.js";
+/**
+ * Internet Computer canister client used for stealth announcements and invoices.
+ * @remarks
+ * This client:
+ * - Creates and memoizes canister actors for the key manager and storage canisters.
+ * - Unwraps `Result`-style canister responses (`Ok`/`ok`, `Err`/`err`) via `unwrapResult`.
+ */
 export class StealthCanisterClient {
     agent;
     storageCanisterId;
     keyManagerCanisterId;
     keyManagerActor = null;
     storageActor = null;
+    /**
+     * Create a canister client using a pre-configured {@link Agent} and canister principals.
+     */
     constructor(agent, storageCanisterId, keyManagerCanisterId) {
         this.agent = agent;
         this.storageCanisterId = storageCanisterId;
         this.keyManagerCanisterId = keyManagerCanisterId;
     }
+    /** Return the configured agent. */
     getAgent() {
         return this.agent;
     }
+    /** Return the configured storage canister id. */
     getStorageCanisterId() {
         return this.storageCanisterId;
     }
+    /** Return the configured key manager canister id. */
     getKeyManagerCanisterId() {
         return this.keyManagerCanisterId;
     }
+    /**
+     * Fetch the view public key for an EVM address (encoded as bytes).
+     */
     async getViewPublicKey(address) {
         const actor = await this.getKeyManagerActor();
         const result = await actor.get_view_public_key(address);
         return unwrapResult(result, "get_view_public_key");
     }
+    /**
+     * Request an encrypted view key (vetKD flow).
+     * @remarks See {@link EncryptedViewKeyRequest} for required signature/nonce/expiry fields.
+     */
     async requestEncryptedViewKey(request) {
         const actor = await this.getKeyManagerActor();
         const result = await actor.request_encrypted_view_key(toCandidEncryptedViewKeyRequest(request));
         return unwrapResult(result, "request_encrypted_view_key");
     }
+    /**
+     * Read the maximum nonce for the given address from the key manager canister.
+     */
     async getMaxNonce(address) {
         const actor = await this.getKeyManagerActor();
         const result = await actor.get_max_nonce(address);
         return unwrapResult(result, "get_max_nonce");
     }
+    /**
+     * Submit an encrypted announcement to the storage canister.
+     */
     async submitAnnouncement(input) {
         const actor = await this.getStorageActor();
         const result = await actor.submit_announcement(toCandidAnnouncementInput(input));
         const announcement = unwrapResult(result, "submit_announcement");
         return mapAnnouncement(announcement);
     }
+    /**
+     * Submit an invoice (signed pointer) to the storage canister.
+     */
     async submitInvoice(submission) {
         const actor = await this.getStorageActor();
         const result = await actor.submit_invoice(toCandidInvoiceSubmission(submission));
         unwrapResult(result, "submit_invoice");
     }
+    /**
+     * List invoice ids for an address.
+     * @param address - Address bytes used by the canister as the invoice owner key.
+     * @param tag - Optional storage tag. Defaults to {@link DEFAULT_ZSTORAGE_TAG}.
+     */
     async listInvoices(address, tag = DEFAULT_ZSTORAGE_TAG) {
         const actor = await this.getStorageActor();
         const result = await actor.list_invoices(address, tag);
         return unwrapResult(result, "list_invoices");
     }
+    /**
+     * List announcements using an id-based cursor.
+     * @param startAfter - If provided, results start strictly after this announcement id.
+     * @param limit - Maximum number of announcements to return.
+     * @param tag - Optional storage tag. Defaults to {@link DEFAULT_ZSTORAGE_TAG}.
+     * @returns A page with announcements and `nextId` cursor (or null if no more pages).
+     */
     async listAnnouncements(startAfter, limit, tag = DEFAULT_ZSTORAGE_TAG) {
         const actor = await this.getStorageActor();
         const start = (startAfter === undefined ? [] : [startAfter]);
@@ -67,6 +109,7 @@ export class StealthCanisterClient {
      * @param startAfterTs - Timestamp in nanoseconds. Only announcements created after this time will be returned.
      * @param limit - Maximum number of announcements to return.
      * @param tag - Storage tag to filter by.
+     * @returns A page with announcements and `nextTs` cursor (or null if no more pages).
      */
     async listAnnouncementsByTime(startAfterTs, limit, tag = DEFAULT_ZSTORAGE_TAG) {
         const actor = await this.getStorageActor();
@@ -78,6 +121,10 @@ export class StealthCanisterClient {
             nextTs: page.next_ts.length === 0 ? null : page.next_ts[0],
         };
     }
+    /**
+     * Fetch a single announcement by its id.
+     * @returns The announcement if present, otherwise `null`.
+     */
     async getAnnouncement(id) {
         const actor = await this.getStorageActor();
         const result = await actor.get_announcement(id);
@@ -107,22 +154,11 @@ export class StealthCanisterClient {
         return this.storageActor;
     }
 }
-function unwrapResult(result, method) {
-    if ("Ok" in result) {
-        return result.Ok;
-    }
-    if ("ok" in result) {
-        return result.ok;
-    }
-    if ("Err" in result) {
-        throw new StealthError(`${method} failed: ${result.Err}`);
-    }
-    if ("err" in result) {
-        throw new StealthError(`${method} failed: ${result.err}`);
-    }
-    throw new StealthError(`${method} failed: unknown canister result variant`);
-}
-function mapAnnouncement(announcement) {
+// ============================================================================
+// Internal Converters (exported for testing)
+// ============================================================================
+/** @internal */
+export function mapAnnouncement(announcement) {
     return {
         id: announcement.id,
         ibeCiphertext: announcement.ibe_ciphertext,
@@ -132,7 +168,8 @@ function mapAnnouncement(announcement) {
         tag: announcement.tag,
     };
 }
-function toCandidAnnouncementInput(input) {
+/** @internal */
+export function toCandidAnnouncementInput(input) {
     return {
         ibe_ciphertext: input.ibeCiphertext,
         ciphertext: input.ciphertext,
@@ -140,7 +177,8 @@ function toCandidAnnouncementInput(input) {
         tag: input.tag ?? DEFAULT_ZSTORAGE_TAG,
     };
 }
-function toCandidEncryptedViewKeyRequest(request) {
+/** @internal */
+export function toCandidEncryptedViewKeyRequest(request) {
     return {
         address: request.address,
         transport_public_key: request.transportPublicKey,
@@ -149,72 +187,12 @@ function toCandidEncryptedViewKeyRequest(request) {
         signature: request.signature,
     };
 }
-function toCandidInvoiceSubmission(submission) {
+/** @internal */
+export function toCandidInvoiceSubmission(submission) {
     return {
         invoice_id: submission.invoiceId,
         signature: submission.signature,
         tag: submission.tag ?? DEFAULT_ZSTORAGE_TAG,
     };
 }
-const keyManagerIdlFactory = ({ IDL: idl }) => {
-    const Address = idl.Vec(idl.Nat8);
-    const PublicKey = idl.Vec(idl.Nat8);
-    const Signature = idl.Vec(idl.Nat8);
-    const EncryptedKey = idl.Vec(idl.Nat8);
-    const EncryptedViewKeyRequest = idl.Record({
-        address: Address,
-        transport_public_key: PublicKey,
-        expiry_ns: idl.Nat64,
-        nonce: idl.Nat64,
-        signature: Signature,
-    });
-    const ResultPublicKey = idl.Variant({ Ok: PublicKey, Err: idl.Text });
-    const ResultEncryptedKey = idl.Variant({ Ok: EncryptedKey, Err: idl.Text });
-    const ResultNonce = idl.Variant({ Ok: idl.Nat64, Err: idl.Text });
-    return idl.Service({
-        get_view_public_key: idl.Func([Address], [ResultPublicKey], []),
-        request_encrypted_view_key: idl.Func([EncryptedViewKeyRequest], [ResultEncryptedKey], []),
-        get_max_nonce: idl.Func([Address], [ResultNonce], ["query"]),
-    });
-};
-const storageIdlFactory = ({ IDL: idl }) => {
-    const AnnouncementInput = idl.Record({
-        ibe_ciphertext: idl.Vec(idl.Nat8),
-        ciphertext: idl.Vec(idl.Nat8),
-        nonce: idl.Vec(idl.Nat8),
-        tag: idl.Text,
-    });
-    const Announcement = idl.Record({
-        id: idl.Nat64,
-        ibe_ciphertext: idl.Vec(idl.Nat8),
-        ciphertext: idl.Vec(idl.Nat8),
-        nonce: idl.Vec(idl.Nat8),
-        created_at_ns: idl.Nat64,
-        tag: idl.Text,
-    });
-    const AnnouncementPage = idl.Record({
-        announcements: idl.Vec(Announcement),
-        next_id: idl.Opt(idl.Nat64),
-    });
-    const AnnouncementPageByTime = idl.Record({
-        announcements: idl.Vec(Announcement),
-        next_ts: idl.Opt(idl.Nat64),
-    });
-    const InvoiceSubmission = idl.Record({
-        invoice_id: idl.Vec(idl.Nat8),
-        signature: idl.Vec(idl.Nat8),
-        tag: idl.Text,
-    });
-    const SubmitAnnouncementResult = idl.Variant({ Ok: Announcement, Err: idl.Text });
-    const SubmitInvoiceResult = idl.Variant({ Ok: idl.Null, Err: idl.Text });
-    const ListInvoicesResult = idl.Variant({ Ok: idl.Vec(idl.Vec(idl.Nat8)), Err: idl.Text });
-    return idl.Service({
-        submit_announcement: idl.Func([AnnouncementInput], [SubmitAnnouncementResult], []),
-        submit_invoice: idl.Func([InvoiceSubmission], [SubmitInvoiceResult], []),
-        list_invoices: idl.Func([idl.Vec(idl.Nat8), idl.Text], [ListInvoicesResult], ["query"]),
-        list_announcements: idl.Func([idl.Opt(idl.Nat64), idl.Opt(idl.Nat32), idl.Text], [AnnouncementPage], ["query"]),
-        list_announcements_by_time: idl.Func([idl.Opt(idl.Nat64), idl.Opt(idl.Nat32), idl.Text], [AnnouncementPageByTime], ["query"]),
-        get_announcement: idl.Func([idl.Nat64], [idl.Opt(Announcement)], ["query"]),
-    });
-};
 //# sourceMappingURL=client.js.map

package/dist/ic/client.js.map

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

package/dist/ic/config.d.ts

@@ -1,6 +1,33 @@
+/**
+ * Default configuration helpers for IC stealth canister interactions.
+ * @remarks
+ * These helpers are used to construct vetKD context bytes and select key id names when interacting
+ * with the key manager canister.
+ */
+/**
+ * Default vetKD context prefix (domain separator) used by the SDK.
+ * @remarks The full context is typically `DEFAULT_CONTEXT_PREFIX || addressBytes`.
+ */
 export declare const DEFAULT_CONTEXT_PREFIX: Uint8Array<ArrayBuffer>;
+/**
+ * Default vetKD key id name for production deployments.
+ * @remarks This must match the key id configured in the key manager canister.
+ */
 export declare const DEFAULT_KEY_ID_NAME = "key_1";
+/**
+ * Default vetKD key id name commonly used for test/local deployments.
+ * @remarks This is useful when running against local replicas or staging environments.
+ */
 export declare const DEFAULT_TEST_KEY_ID_NAME = "test_key_1";
+/**
+ * Derive the vetKD context bytes for an address.
+ * @param address - 20-byte EVM address (binary form).
+ * @param domain - Optional domain separator prefix. Defaults to {@link DEFAULT_CONTEXT_PREFIX}.
+ * @returns Concatenated context bytes: `domain || address`.
+ */
 export declare function deriveContext(address: Uint8Array, domain?: Uint8Array): Uint8Array;
+/**
+ * Encode a UTF-8 string into bytes.
+ */
 export declare function textToUint8(text: string): Uint8Array;
 //# sourceMappingURL=config.d.ts.map

package/dist/ic/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/ic/config.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,sBAAsB,yBAAiC,CAAC;AACrE,eAAO,MAAM,mBAAmB,UAAU,CAAC;AAC3C,eAAO,MAAM,wBAAwB,eAAe,CAAC;AAErD,wBAAgB,aAAa,CAC3B,OAAO,EAAE,UAAU,EACnB,MAAM,GAAE,UAAmC,GAC1C,UAAU,CAKZ;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAEpD"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/ic/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;GAGG;AACH,eAAO,MAAM,sBAAsB,yBAAiC,CAAC;AAErE;;;GAGG;AACH,eAAO,MAAM,mBAAmB,UAAU,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,wBAAwB,eAAe,CAAC;AAErD;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,UAAU,EACnB,MAAM,GAAE,UAAmC,GAC1C,UAAU,CAKZ;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAEpD"}

package/dist/ic/config.js

@@ -1,14 +1,41 @@
+/**
+ * Default configuration helpers for IC stealth canister interactions.
+ * @remarks
+ * These helpers are used to construct vetKD context bytes and select key id names when interacting
+ * with the key manager canister.
+ */
 const DEFAULT_DOMAIN = "icp-stealth-announcement-v1";
 const encoder = new TextEncoder();
+/**
+ * Default vetKD context prefix (domain separator) used by the SDK.
+ * @remarks The full context is typically `DEFAULT_CONTEXT_PREFIX || addressBytes`.
+ */
 export const DEFAULT_CONTEXT_PREFIX = encoder.encode(DEFAULT_DOMAIN);
+/**
+ * Default vetKD key id name for production deployments.
+ * @remarks This must match the key id configured in the key manager canister.
+ */
 export const DEFAULT_KEY_ID_NAME = "key_1";
+/**
+ * Default vetKD key id name commonly used for test/local deployments.
+ * @remarks This is useful when running against local replicas or staging environments.
+ */
 export const DEFAULT_TEST_KEY_ID_NAME = "test_key_1";
+/**
+ * Derive the vetKD context bytes for an address.
+ * @param address - 20-byte EVM address (binary form).
+ * @param domain - Optional domain separator prefix. Defaults to {@link DEFAULT_CONTEXT_PREFIX}.
+ * @returns Concatenated context bytes: `domain || address`.
+ */
 export function deriveContext(address, domain = DEFAULT_CONTEXT_PREFIX) {
     const context = new Uint8Array(domain.length + address.length);
     context.set(domain, 0);
     context.set(address, domain.length);
     return context;
 }
+/**
+ * Encode a UTF-8 string into bytes.
+ */
 export function textToUint8(text) {
     return encoder.encode(text);
 }

package/dist/ic/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/ic/config.ts"],"names":[],"mappings":"AAAA,MAAM,cAAc,GAAG,6BAA6B,CAAC;AAErD,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;AAElC,MAAM,CAAC,MAAM,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;AACrE,MAAM,CAAC,MAAM,mBAAmB,GAAG,OAAO,CAAC;AAC3C,MAAM,CAAC,MAAM,wBAAwB,GAAG,YAAY,CAAC;AAErD,MAAM,UAAU,aAAa,CAC3B,OAAmB,EACnB,SAAqB,sBAAsB;IAE3C,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/D,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACvB,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACpC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/ic/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,cAAc,GAAG,6BAA6B,CAAC;AAErD,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;AAElC;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;AAErE;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,OAAO,CAAC;AAE3C;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,YAAY,CAAC;AAErD;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAmB,EACnB,SAAqB,sBAAsB;IAE3C,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/D,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACvB,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACpC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC"}