@ckb-ccc/joy-id 0.0.5-alpha.7 → 0.0.6-alpha.0

package/dist/btc/index.d.ts

@@ -1,5 +1,10 @@
 import { ccc } from "@ckb-ccc/core";
 import { ConnectionsRepo } from "../connectionsStorage";
+/**
+ * Class representing a Bitcoin signer that extends SignerBtc from @ckb-ccc/core.
+ * @class
+ * @extends {ccc.SignerBtc}
+ */
 export declare class BitcoinSigner extends ccc.SignerBtc {
     private readonly name;
     private readonly icon;
@@ -7,14 +12,54 @@ export declare class BitcoinSigner extends ccc.SignerBtc {
     private readonly appUri;
     private readonly connectionsRepo;
     private connection?;
+    /**
+     * Ensures that the signer is connected and returns the connection.
+     * @private
+     * @throws Will throw an error if not connected.
+     * @returns {Connection} The current connection.
+     */
     private assertConnection;
+    /**
+     * Creates an instance of BitcoinSigner.
+     * @param {ccc.Client} client - The client instance.
+     * @param {string} name - The name of the signer.
+     * @param {string} icon - The icon URL of the signer.
+     * @param {"auto" | "p2wpkh" | "p2tr"} [addressType="auto"] - The address type.
+     * @param {string} [appUri="https://app.joy.id"] - The application URI.
+     * @param {ConnectionsRepo} [connectionsRepo=new ConnectionsRepoLocalStorage()] - The connections repository.
+     */
     constructor(client: ccc.Client, name: string, icon: string, addressType?: "auto" | "p2wpkh" | "p2tr", appUri?: string, connectionsRepo?: ConnectionsRepo);
-    replaceClient(client: ccc.Client): Promise<BitcoinSigner>;
+    /**
+     * Gets the configuration for JoyID.
+     * @private
+     * @returns {object} The configuration object.
+     */
     private getConfig;
+    /**
+     * Gets the Bitcoin account address.
+     * @returns {Promise<string>} A promise that resolves to the Bitcoin account address.
+     */
     getBtcAccount(): Promise<string>;
+    /**
+     * Gets the Bitcoin public key.
+     * @returns {Promise<ccc.Hex>} A promise that resolves to the Bitcoin public key.
+     */
     getBtcPublicKey(): Promise<ccc.Hex>;
+    /**
+     * Connects to the provider by requesting authentication.
+     * @returns {Promise<void>} A promise that resolves when the connection is established.
+     */
     connect(): Promise<void>;
+    /**
+     * Checks if the signer is connected.
+     * @returns {Promise<boolean>} A promise that resolves to true if connected, false otherwise.
+     */
     isConnected(): Promise<boolean>;
+    /**
+     * Signs a raw message with the Bitcoin account.
+     * @param {string | ccc.BytesLike} message - The message to sign.
+     * @returns {Promise<string>} A promise that resolves to the signed message.
+     */
     signMessageRaw(message: string | ccc.BytesLike): Promise<string>;
 }
 //# sourceMappingURL=index.d.ts.map

package/dist/btc/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/btc/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAGpC,OAAO,EAEL,eAAe,EAEhB,MAAM,uBAAuB,CAAC;AAE/B,qBAAa,aAAc,SAAQ,GAAG,CAAC,SAAS;IAa5C,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAhBlC,OAAO,CAAC,UAAU,CAAC,CAAa;IAEhC,OAAO,CAAC,gBAAgB;gBAStB,MAAM,EAAE,GAAG,CAAC,MAAM,EACD,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,WAAW,GAAE,MAAM,GAAG,QAAQ,GAAG,MAAe,EAChD,MAAM,SAAuB,EAC7B,eAAe,GAAE,eAAmD;IAKjF,aAAa,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAW/D,OAAO,CAAC,SAAS;IAUX,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAKhC,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;IAKnC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA+BxB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAY/B,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;CAsBvE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/btc/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAGpC,OAAO,EAEL,eAAe,EAEhB,MAAM,uBAAuB,CAAC;AAE/B;;;;GAIG;AACH,qBAAa,aAAc,SAAQ,GAAG,CAAC,SAAS;IA4B5C,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,eAAe;IA/BlC,OAAO,CAAC,UAAU,CAAC,CAAa;IAEhC;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;;;;;;;OAQG;gBAED,MAAM,EAAE,GAAG,CAAC,MAAM,EACD,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,WAAW,GAAE,MAAM,GAAG,QAAQ,GAAG,MAAe,EAChD,MAAM,SAAuB,EAC7B,eAAe,GAAE,eAAmD;IAKvF;;;;OAIG;IACH,OAAO,CAAC,SAAS;IAUjB;;;OAGG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAKtC;;;OAGG;IACG,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;IAKzC;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA+B9B;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAYrC;;;;OAIG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;CAsBvE"}

package/dist/btc/index.js

@@ -2,13 +2,33 @@ import { ccc } from "@ckb-ccc/core";
 import { DappRequestType, buildJoyIDURL } from "@joyid/common";
 import { createPopup } from "../common";
 import { ConnectionsRepoLocalStorage, } from "../connectionsStorage";
+/**
+ * Class representing a Bitcoin signer that extends SignerBtc from @ckb-ccc/core.
+ * @class
+ * @extends {ccc.SignerBtc}
+ */
 export class BitcoinSigner extends ccc.SignerBtc {
+    /**
+     * Ensures that the signer is connected and returns the connection.
+     * @private
+     * @throws Will throw an error if not connected.
+     * @returns {Connection} The current connection.
+     */
     assertConnection() {
         if (!this.isConnected() || !this.connection) {
             throw new Error("Not connected");
         }
         return this.connection;
     }
+    /**
+     * Creates an instance of BitcoinSigner.
+     * @param {ccc.Client} client - The client instance.
+     * @param {string} name - The name of the signer.
+     * @param {string} icon - The icon URL of the signer.
+     * @param {"auto" | "p2wpkh" | "p2tr"} [addressType="auto"] - The address type.
+     * @param {string} [appUri="https://app.joy.id"] - The application URI.
+     * @param {ConnectionsRepo} [connectionsRepo=new ConnectionsRepoLocalStorage()] - The connections repository.
+     */
     constructor(client, name, icon, addressType = "auto", appUri = "https://app.joy.id", connectionsRepo = new ConnectionsRepoLocalStorage()) {
         super(client);
         this.name = name;
@@ -17,9 +37,11 @@ export class BitcoinSigner extends ccc.SignerBtc {
         this.appUri = appUri;
         this.connectionsRepo = connectionsRepo;
     }
-    async replaceClient(client) {
-        return new BitcoinSigner(client, this.name, this.icon, this.addressType, this.appUri, this.connectionsRepo);
-    }
+    /**
+     * Gets the configuration for JoyID.
+     * @private
+     * @returns {object} The configuration object.
+     */
     getConfig() {
         return {
             redirectURL: location.href,
@@ -29,14 +51,26 @@ export class BitcoinSigner extends ccc.SignerBtc {
             logo: this.icon,
         };
     }
+    /**
+     * Gets the Bitcoin account address.
+     * @returns {Promise<string>} A promise that resolves to the Bitcoin account address.
+     */
     async getBtcAccount() {
         const { address } = this.assertConnection();
         return address;
     }
+    /**
+     * Gets the Bitcoin public key.
+     * @returns {Promise<ccc.Hex>} A promise that resolves to the Bitcoin public key.
+     */
     async getBtcPublicKey() {
         const { publicKey } = this.assertConnection();
         return publicKey;
     }
+    /**
+     * Connects to the provider by requesting authentication.
+     * @returns {Promise<void>} A promise that resolves when the connection is established.
+     */
     async connect() {
         const config = this.getConfig();
         const res = await createPopup(buildJoyIDURL(config, "popup", "/auth"), {
@@ -59,6 +93,10 @@ export class BitcoinSigner extends ccc.SignerBtc {
             this.connectionsRepo.set({ uri: this.appUri, addressType: "btc-auto" }, this.connection),
         ]);
     }
+    /**
+     * Checks if the signer is connected.
+     * @returns {Promise<boolean>} A promise that resolves to true if connected, false otherwise.
+     */
     async isConnected() {
         if (this.connection) {
             return true;
@@ -69,6 +107,11 @@ export class BitcoinSigner extends ccc.SignerBtc {
         });
         return this.connection !== undefined;
     }
+    /**
+     * Signs a raw message with the Bitcoin account.
+     * @param {string | ccc.BytesLike} message - The message to sign.
+     * @returns {Promise<string>} A promise that resolves to the signed message.
+     */
     async signMessageRaw(message) {
         const { address } = this.assertConnection();
         const challenge = typeof message === "string" ? message : ccc.hexFrom(message).slice(2);

package/dist/ckb/index.d.ts

@@ -1,31 +1,124 @@
 import { ccc } from "@ckb-ccc/core";
 import { ConnectionsRepo } from "../connectionsStorage";
+/**
+ * Class representing a CKB signer that extends Signer from @ckb-ccc/core.
+ * @class
+ * @extends {ccc.Signer}
+ */
 export declare class CkbSigner extends ccc.Signer {
     private readonly name;
     private readonly icon;
     private readonly _appUri?;
     private readonly _aggregatorUri?;
     private readonly connectionsRepo;
+    /**
+     * Gets the signer type.
+     * @returns {ccc.SignerType} The type of the signer.
+     */
     get type(): ccc.SignerType;
+    /**
+     * Gets the sign type.
+     * @returns {ccc.SignerSignType} The sign type.
+     */
     get signType(): ccc.SignerSignType;
     private connection?;
+    /**
+     * Ensures that the signer is connected and returns the connection.
+     * @private
+     * @throws Will throw an error if not connected.
+     * @returns {Promise<Connection>} A promise that resolves to the current connection.
+     */
     private assertConnection;
+    /**
+     * Creates an instance of CkbSigner.
+     * @param {ccc.Client} client - The client instance.
+     * @param {string} name - The name of the signer.
+     * @param {string} icon - The icon URL of the signer.
+     * @param {string} [_appUri] - The application URI.
+     * @param {string} [_aggregatorUri] - The aggregator URI.
+     * @param {ConnectionsRepo} [connectionsRepo=new ConnectionsRepoLocalStorage()] - The connections repository.
+     */
     constructor(client: ccc.Client, name: string, icon: string, _appUri?: string | undefined, _aggregatorUri?: string | undefined, connectionsRepo?: ConnectionsRepo);
-    replaceClient(client: ccc.Client): Promise<CkbSigner>;
+    /**
+     * Gets the configuration for JoyID.
+     * @private
+     * @returns {object} The configuration object.
+     */
     private getConfig;
+    /**
+     * Gets the aggregator URI.
+     * @private
+     * @returns {string} The aggregator URI.
+     */
     private getAggregatorUri;
+    /**
+     * Connects to the provider by requesting authentication.
+     * @returns {Promise<void>} A promise that resolves when the connection is established.
+     */
     connect(): Promise<void>;
-    disconnect(): Promise<void>;
+    /**
+     * Checks if the signer is connected.
+     * @returns {Promise<boolean>} A promise that resolves to true if connected, false otherwise.
+     */
     isConnected(): Promise<boolean>;
+    /**
+     * Gets the internal address.
+     * @returns {Promise<string>} A promise that resolves to the internal address.
+     */
     getInternalAddress(): Promise<string>;
+    /**
+     * Gets the identity of the signer.
+     * @returns {Promise<string>} A promise that resolves to the identity.
+     */
     getIdentity(): Promise<string>;
+    /**
+     * Gets the address object.
+     * @returns {Promise<ccc.Address>} A promise that resolves to the address object.
+     */
     getAddressObj(): Promise<ccc.Address>;
+    /**
+     * Gets the address objects.
+     * @returns {Promise<ccc.Address[]>} A promise that resolves to an array of address objects.
+     */
     getAddressObjs(): Promise<ccc.Address[]>;
+    /**
+     * Prepares a transaction.
+     * @param {ccc.TransactionLike} txLike - The transaction-like object.
+     * @returns {Promise<ccc.Transaction>} A promise that resolves to the prepared transaction.
+     */
     prepareTransaction(txLike: ccc.TransactionLike): Promise<ccc.Transaction>;
+    /**
+     * Prepares a transaction for a sub key.
+     * @private
+     * @param {ccc.Transaction} tx - The transaction object.
+     * @param {ccc.WitnessArgs} witness - The witness arguments.
+     * @returns {Promise<void>}
+     * @throws Will throw an error if no COTA cells are found for the sub key wallet.
+     */
     private prepareTransactionForSubKey;
+    /**
+     * Signs a transaction.
+     * @param {ccc.TransactionLike} txLike - The transaction-like object.
+     * @returns {Promise<ccc.Transaction>} A promise that resolves to the signed transaction.
+     */
     signOnlyTransaction(txLike: ccc.TransactionLike): Promise<ccc.Transaction>;
+    /**
+     * Signs a raw message with the account.
+     * @param {string | ccc.BytesLike} message - The message to sign.
+     * @returns {Promise<string>} A promise that resolves to the signed message.
+     */
     signMessageRaw(message: string | ccc.BytesLike): Promise<string>;
+    /**
+     * Saves the current connection.
+     * @private
+     * @returns {Promise<void>}
+     */
     private saveConnection;
+    /**
+     * Restores the previous connection.
+     * @private
+     * @returns {Promise<void>}
+     */
     private restoreConnection;
 }
 //# sourceMappingURL=index.d.ts.map

package/dist/ckb/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ckb/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAIpC,OAAO,EAEL,eAAe,EAEhB,MAAM,uBAAuB,CAAC;AAE/B,qBAAa,SAAU,SAAQ,GAAG,CAAC,MAAM;IAqBrC,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;IAChC,OAAO,CAAC,QAAQ,CAAC,eAAe;IAxBlC,IAAI,IAAI,IAAI,GAAG,CAAC,UAAU,CAEzB;IAED,IAAI,QAAQ,IAAI,GAAG,CAAC,cAAc,CAEjC;IAED,OAAO,CAAC,UAAU,CAAC,CAAa;YAElB,gBAAgB;gBAS5B,MAAM,EAAE,GAAG,CAAC,MAAM,EACD,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,oBAAQ,EAChB,cAAc,CAAC,oBAAQ,EACvB,eAAe,GAAE,eAAmD;IAKjF,aAAa,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAW3D,OAAO,CAAC,SAAS;IAYjB,OAAO,CAAC,gBAAgB;IAUlB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAQ/B,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC;IAIrC,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;IAQ9B,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;IAOrC,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAIxC,kBAAkB,CACtB,MAAM,EAAE,GAAG,CAAC,eAAe,GAC1B,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;YAgBb,2BAA2B;IAuCnC,mBAAmB,CACvB,MAAM,EAAE,GAAG,CAAC,eAAe,GAC1B,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IAyBrB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;YA2BxD,cAAc;YAUd,iBAAiB;CAMhC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ckb/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAIpC,OAAO,EAEL,eAAe,EAEhB,MAAM,uBAAuB,CAAC;AAE/B;;;;GAIG;AACH,qBAAa,SAAU,SAAQ,GAAG,CAAC,MAAM;IA4CrC,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;IAChC,OAAO,CAAC,QAAQ,CAAC,eAAe;IA/ClC;;;OAGG;IACH,IAAI,IAAI,IAAI,GAAG,CAAC,UAAU,CAEzB;IAED;;;OAGG;IACH,IAAI,QAAQ,IAAI,GAAG,CAAC,cAAc,CAEjC;IAED,OAAO,CAAC,UAAU,CAAC,CAAa;IAEhC;;;;;OAKG;YACW,gBAAgB;IAQ9B;;;;;;;;OAQG;gBAED,MAAM,EAAE,GAAG,CAAC,MAAM,EACD,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,oBAAQ,EAChB,cAAc,CAAC,oBAAQ,EACvB,eAAe,GAAE,eAAmD;IAKvF;;;;OAIG;IACH,OAAO,CAAC,SAAS;IAYjB;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB9B;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAQrC;;;OAGG;IACG,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC;IAI3C;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;IAQpC;;;OAGG;IACG,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;IAO3C;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAI9C;;;;OAIG;IACG,kBAAkB,CACtB,MAAM,EAAE,GAAG,CAAC,eAAe,GAC1B,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IAkB3B;;;;;;;OAOG;YACW,2BAA2B;IAuCzC;;;;OAIG;IACG,mBAAmB,CACvB,MAAM,EAAE,GAAG,CAAC,eAAe,GAC1B,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IA6B3B;;;;OAIG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IA2BtE;;;;OAIG;YACW,cAAc;IAU5B;;;;OAIG;YACW,iBAAiB;CAMhC"}

package/dist/ckb/index.js

@@ -3,19 +3,47 @@ import { Aggregator } from "@joyid/ckb";
 import { DappRequestType, buildJoyIDURL } from "@joyid/common";
 import { createPopup } from "../common";
 import { ConnectionsRepoLocalStorage, } from "../connectionsStorage";
+/**
+ * Class representing a CKB signer that extends Signer from @ckb-ccc/core.
+ * @class
+ * @extends {ccc.Signer}
+ */
 export class CkbSigner extends ccc.Signer {
+    /**
+     * Gets the signer type.
+     * @returns {ccc.SignerType} The type of the signer.
+     */
     get type() {
         return ccc.SignerType.CKB;
     }
+    /**
+     * Gets the sign type.
+     * @returns {ccc.SignerSignType} The sign type.
+     */
     get signType() {
         return ccc.SignerSignType.JoyId;
     }
+    /**
+     * Ensures that the signer is connected and returns the connection.
+     * @private
+     * @throws Will throw an error if not connected.
+     * @returns {Promise<Connection>} A promise that resolves to the current connection.
+     */
     async assertConnection() {
         if (!(await this.isConnected()) || !this.connection) {
             throw new Error("Not connected");
         }
         return this.connection;
     }
+    /**
+     * Creates an instance of CkbSigner.
+     * @param {ccc.Client} client - The client instance.
+     * @param {string} name - The name of the signer.
+     * @param {string} icon - The icon URL of the signer.
+     * @param {string} [_appUri] - The application URI.
+     * @param {string} [_aggregatorUri] - The aggregator URI.
+     * @param {ConnectionsRepo} [connectionsRepo=new ConnectionsRepoLocalStorage()] - The connections repository.
+     */
     constructor(client, name, icon, _appUri, _aggregatorUri, connectionsRepo = new ConnectionsRepoLocalStorage()) {
         super(client);
         this.name = name;
@@ -24,9 +52,11 @@ export class CkbSigner extends ccc.Signer {
         this._aggregatorUri = _aggregatorUri;
         this.connectionsRepo = connectionsRepo;
     }
-    async replaceClient(client) {
-        return new CkbSigner(client, this.name, this.icon, this._appUri, this._aggregatorUri, this.connectionsRepo);
-    }
+    /**
+     * Gets the configuration for JoyID.
+     * @private
+     * @returns {object} The configuration object.
+     */
     getConfig() {
         return {
             redirectURL: location.href,
@@ -37,6 +67,11 @@ export class CkbSigner extends ccc.Signer {
             logo: this.icon,
         };
     }
+    /**
+     * Gets the aggregator URI.
+     * @private
+     * @returns {string} The aggregator URI.
+     */
     getAggregatorUri() {
         if (this._aggregatorUri) {
             return this._aggregatorUri;
@@ -45,6 +80,10 @@ export class CkbSigner extends ccc.Signer {
             ? "https://cota.nervina.dev/mainnet-aggregator"
             : "https://cota.nervina.dev/aggregator";
     }
+    /**
+     * Connects to the provider by requesting authentication.
+     * @returns {Promise<void>} A promise that resolves when the connection is established.
+     */
     async connect() {
         const config = this.getConfig();
         const res = await createPopup(buildJoyIDURL(config, "popup", "/auth"), {
@@ -58,10 +97,10 @@ export class CkbSigner extends ccc.Signer {
         };
         await this.saveConnection();
     }
-    async disconnect() {
-        this.connection = undefined;
-        await this.saveConnection();
-    }
+    /**
+     * Checks if the signer is connected.
+     * @returns {Promise<boolean>} A promise that resolves to true if connected, false otherwise.
+     */
     async isConnected() {
         if (this.connection) {
             return true;
@@ -69,9 +108,17 @@ export class CkbSigner extends ccc.Signer {
         await this.restoreConnection();
         return this.connection !== undefined;
     }
+    /**
+     * Gets the internal address.
+     * @returns {Promise<string>} A promise that resolves to the internal address.
+     */
     async getInternalAddress() {
         return (await this.assertConnection()).address;
     }
+    /**
+     * Gets the identity of the signer.
+     * @returns {Promise<string>} A promise that resolves to the identity.
+     */
     async getIdentity() {
         const connection = await this.assertConnection();
         return JSON.stringify({
@@ -79,12 +126,25 @@ export class CkbSigner extends ccc.Signer {
             publicKey: connection.publicKey.slice(2),
         });
     }
+    /**
+     * Gets the address object.
+     * @returns {Promise<ccc.Address>} A promise that resolves to the address object.
+     */
     async getAddressObj() {
         return await ccc.Address.fromString(await this.getInternalAddress(), this.client);
     }
+    /**
+     * Gets the address objects.
+     * @returns {Promise<ccc.Address[]>} A promise that resolves to an array of address objects.
+     */
     async getAddressObjs() {
         return [await this.getAddressObj()];
     }
+    /**
+     * Prepares a transaction.
+     * @param {ccc.TransactionLike} txLike - The transaction-like object.
+     * @returns {Promise<ccc.Transaction>} A promise that resolves to the prepared transaction.
+     */
     async prepareTransaction(txLike) {
         const tx = ccc.Transaction.from(txLike);
         const position = await tx.findInputIndexByLock((await this.getAddressObj()).script, this.client);
@@ -94,8 +154,17 @@ export class CkbSigner extends ccc.Signer {
         const witness = tx.getWitnessArgsAt(position) ?? ccc.WitnessArgs.from({});
         witness.lock = "0x";
         await this.prepareTransactionForSubKey(tx, witness);
-        return tx.setWitnessArgsAt(position, witness);
+        tx.setWitnessArgsAt(position, witness);
+        return tx;
     }
+    /**
+     * Prepares a transaction for a sub key.
+     * @private
+     * @param {ccc.Transaction} tx - The transaction object.
+     * @param {ccc.WitnessArgs} witness - The witness arguments.
+     * @returns {Promise<void>}
+     * @throws Will throw an error if no COTA cells are found for the sub key wallet.
+     */
     async prepareTransactionForSubKey(tx, witness) {
         if (this.connection?.keyType !== "sub_key") {
             return [];
@@ -124,6 +193,11 @@ export class CkbSigner extends ccc.Signer {
         }
         tx.cellDeps.unshift(...cotaDeps);
     }
+    /**
+     * Signs a transaction.
+     * @param {ccc.TransactionLike} txLike - The transaction-like object.
+     * @returns {Promise<ccc.Transaction>} A promise that resolves to the signed transaction.
+     */
     async signOnlyTransaction(txLike) {
         const tx = ccc.Transaction.from(txLike);
         const { script } = await this.getAddressObj();
@@ -133,12 +207,18 @@ export class CkbSigner extends ccc.Signer {
             tx: JSON.parse(tx.stringify()),
             signerAddress: (await this.assertConnection()).address,
             witnessIndex: await tx.findInputIndexByLock(script, this.client),
+            witnessLastIndex: await tx.findLastInputIndexByLock(script, this.client),
         }, "popup", "/sign-ckb-raw-tx"), {
             ...config,
             type: DappRequestType.SignCkbRawTx,
         });
         return ccc.Transaction.from(res.tx);
     }
+    /**
+     * Signs a raw message with the account.
+     * @param {string | ccc.BytesLike} message - The message to sign.
+     * @returns {Promise<string>} A promise that resolves to the signed message.
+     */
     async signMessageRaw(message) {
         const { address } = await this.assertConnection();
         const challenge = typeof message === "string" ? message : ccc.hexFrom(message).slice(2);
@@ -155,12 +235,22 @@ export class CkbSigner extends ccc.Signer {
             message: res.message,
         });
     }
+    /**
+     * Saves the current connection.
+     * @private
+     * @returns {Promise<void>}
+     */
     async saveConnection() {
         return this.connectionsRepo.set({
             uri: this.getConfig().joyidAppURL,
             addressType: "ckb",
         }, this.connection);
     }
+    /**
+     * Restores the previous connection.
+     * @private
+     * @returns {Promise<void>}
+     */
     async restoreConnection() {
         this.connection = await this.connectionsRepo.get({
             uri: this.getConfig().joyidAppURL,

package/dist/common/index.d.ts

@@ -1,4 +1,8 @@
 import { AuthResponseData, DappRequestType, EvmWeb2LoginResponse, PopupConfigOptions, SignCkbTxResponseData, SignCotaNFTResponseData, SignEvmTxResponseData, SignMessageResponseData, SignNostrEventData } from "@joyid/common";
+/**
+ * Interface representing the return type for various Dapp request types.
+ * @interface
+ */
 export interface PopupReturnType {
     [DappRequestType.Auth]: AuthResponseData;
     [DappRequestType.SignMessage]: SignMessageResponseData;
@@ -18,6 +22,15 @@ export interface PopupReturnType {
     [DappRequestType.SignMiniAppMessage]: any;
     [DappRequestType.EvmWeb2Login]: EvmWeb2LoginResponse;
 }
+/**
+ * Creates a popup window for JoyID Dapp requests.
+ * @param {string} url - The URL to open in the popup.
+ * @param {PopupConfigOptions<T> & { joyidAppURL: string }} config - The popup configuration options.
+ * @returns {Promise<PopupReturnType[T]>} A promise that resolves to the response data of the requested type.
+ * @throws {PopupNotSupportedError} If popups are not supported in the current browser.
+ * @throws {PopupCancelledError} If the popup is closed by the user.
+ * @throws {PopupTimeoutError} If the popup operation times out.
+ */
 export declare function createPopup<T extends DappRequestType>(url: string, config: PopupConfigOptions<T> & {
     joyidAppURL: string;
 }): Promise<PopupReturnType[T]>;

package/dist/common/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EAEpB,kBAAkB,EAGlB,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,kBAAkB,EAInB,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,eAAe;IAC9B,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACzC,CAAC,eAAe,CAAC,WAAW,CAAC,EAAE,uBAAuB,CAAC;IACvD,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,qBAAqB,CAAC;IACjD,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IAClD,CAAC,eAAe,CAAC,aAAa,CAAC,EAAE;QAC/B,KAAK,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC;IACF,CAAC,eAAe,CAAC,SAAS,CAAC,EAAE,qBAAqB,CAAC;IACnD,CAAC,eAAe,CAAC,WAAW,CAAC,EAAE,uBAAuB,CAAC;IACvD,CAAC,eAAe,CAAC,YAAY,CAAC,EAAE,qBAAqB,CAAC;IACtD,CAAC,eAAe,CAAC,cAAc,CAAC,EAAE,kBAAkB,CAAC;IACrD,CAAC,eAAe,CAAC,mBAAmB,CAAC,EAAE,GAAG,CAAC;IAC3C,CAAC,eAAe,CAAC,mBAAmB,CAAC,EAAE,GAAG,CAAC;IAC3C,CAAC,eAAe,CAAC,WAAW,CAAC,EAAE,GAAG,CAAC;IACnC,CAAC,eAAe,CAAC,cAAc,CAAC,EAAE,GAAG,CAAC;IACtC,CAAC,eAAe,CAAC,kBAAkB,CAAC,EAAE,GAAG,CAAC;IAC1C,CAAC,eAAe,CAAC,YAAY,CAAC,EAAE,oBAAoB,CAAC;CACtD;AAED,wBAAsB,WAAW,CAAC,CAAC,SAAS,eAAe,EACzD,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GACtD,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CA0D7B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EAEpB,kBAAkB,EAGlB,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,kBAAkB,EAInB,MAAM,eAAe,CAAC;AAEvB;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACzC,CAAC,eAAe,CAAC,WAAW,CAAC,EAAE,uBAAuB,CAAC;IACvD,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,qBAAqB,CAAC;IACjD,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IAClD,CAAC,eAAe,CAAC,aAAa,CAAC,EAAE;QAC/B,KAAK,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC;IACF,CAAC,eAAe,CAAC,SAAS,CAAC,EAAE,qBAAqB,CAAC;IACnD,CAAC,eAAe,CAAC,WAAW,CAAC,EAAE,uBAAuB,CAAC;IACvD,CAAC,eAAe,CAAC,YAAY,CAAC,EAAE,qBAAqB,CAAC;IACtD,CAAC,eAAe,CAAC,cAAc,CAAC,EAAE,kBAAkB,CAAC;IACrD,CAAC,eAAe,CAAC,mBAAmB,CAAC,EAAE,GAAG,CAAC;IAC3C,CAAC,eAAe,CAAC,mBAAmB,CAAC,EAAE,GAAG,CAAC;IAC3C,CAAC,eAAe,CAAC,WAAW,CAAC,EAAE,GAAG,CAAC;IACnC,CAAC,eAAe,CAAC,cAAc,CAAC,EAAE,GAAG,CAAC;IACtC,CAAC,eAAe,CAAC,kBAAkB,CAAC,EAAE,GAAG,CAAC;IAC1C,CAAC,eAAe,CAAC,YAAY,CAAC,EAAE,oBAAoB,CAAC;CACtD;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,CAAC,SAAS,eAAe,EACzD,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GACtD,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CA0D7B"}

package/dist/common/index.js

@@ -1,4 +1,13 @@
 import { DappRequestType, PopupCancelledError, PopupNotSupportedError, PopupTimeoutError, createBlockDialog, isStandaloneBrowser, openPopup, } from "@joyid/common";
+/**
+ * Creates a popup window for JoyID Dapp requests.
+ * @param {string} url - The URL to open in the popup.
+ * @param {PopupConfigOptions<T> & { joyidAppURL: string }} config - The popup configuration options.
+ * @returns {Promise<PopupReturnType[T]>} A promise that resolves to the response data of the requested type.
+ * @throws {PopupNotSupportedError} If popups are not supported in the current browser.
+ * @throws {PopupCancelledError} If the popup is closed by the user.
+ * @throws {PopupTimeoutError} If the popup operation times out.
+ */
 export async function createPopup(url, config) {
     if (config.popup == null) {
         config.popup = openPopup("");

package/dist/connectionsStorage/index.d.ts

@@ -1,23 +1,81 @@
 import { ccc } from "@ckb-ccc/core";
+/**
+ * Type representing an account selector with a URI and address type.
+ * @typedef {Object} AccountSelector
+ * @property {string} uri - The URI of the account.
+ * @property {string} addressType - The address type of the account.
+ */
 export type AccountSelector = {
     uri: string;
     addressType: string;
 };
+/**
+ * Checks if two AccountSelectors are equal.
+ * @param {AccountSelector} a - The first account selector.
+ * @param {AccountSelector} b - The second account selector.
+ * @returns {boolean} True if the selectors are equal, false otherwise.
+ */
 export declare function isSelectorEq(a: AccountSelector, b: AccountSelector): boolean;
+/**
+ * Type representing a connection with an address, public key, and key type.
+ * @typedef {Object} Connection
+ * @property {string} address - The address of the connection.
+ * @property {ccc.Hex} publicKey - The public key of the connection.
+ * @property {string} keyType - The key type of the connection.
+ */
 export type Connection = {
     readonly address: string;
     readonly publicKey: ccc.Hex;
     readonly keyType: string;
 };
+/**
+ * Interface representing a repository for managing connections.
+ * @interface
+ */
 export interface ConnectionsRepo {
+    /**
+     * Gets a connection for the given selector.
+     * @param {AccountSelector} selector - The account selector.
+     * @returns {Promise<Connection | undefined>} A promise that resolves to the connection, if found.
+     */
     get(selector: AccountSelector): Promise<Connection | undefined>;
+    /**
+     * Sets a connection for the given selector.
+     * @param {AccountSelector} selector - The account selector.
+     * @param {Connection | undefined} connection - The connection to set.
+     * @returns {Promise<void>} A promise that resolves when the connection is set.
+     */
     set(selector: AccountSelector, connection: Connection | undefined): Promise<void>;
 }
+/**
+ * Class representing a local storage-based repository for managing connections.
+ * @class
+ * @implements {ConnectionsRepo}
+ */
 export declare class ConnectionsRepoLocalStorage implements ConnectionsRepo {
     private readonly storageKey;
+    /**
+     * Creates an instance of ConnectionsRepoLocalStorage.
+     * @param {string} [storageKey="ccc-joy-id-signer"] - The local storage key.
+     */
     constructor(storageKey?: string);
+    /**
+     * Reads all connections from local storage.
+     * @returns {Promise<[AccountSelector, Connection][]>} A promise that resolves to an array of selectors and connections.
+     */
     readConnections(): Promise<[AccountSelector, Connection][]>;
+    /**
+     * Gets a connection for the given selector.
+     * @param {AccountSelector} selector - The account selector.
+     * @returns {Promise<Connection | undefined>} A promise that resolves to the connection, if found.
+     */
     get(selector: AccountSelector): Promise<Connection | undefined>;
+    /**
+     * Sets a connection for the given selector.
+     * @param {AccountSelector} selector - The account selector.
+     * @param {Connection | undefined} connection - The connection to set.
+     * @returns {Promise<void>}
+     */
     set(selector: AccountSelector, connection: Connection | undefined): Promise<void>;
 }
 //# sourceMappingURL=index.d.ts.map

package/dist/connectionsStorage/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/connectionsStorage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAEpC,MAAM,MAAM,eAAe,GAAG;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,wBAAgB,YAAY,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,eAAe,WAElE;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,GAAG,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;IAChE,GAAG,CACD,QAAQ,EAAE,eAAe,EACzB,UAAU,EAAE,UAAU,GAAG,SAAS,GACjC,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAED,qBAAa,2BAA4B,YAAW,eAAe;IACrD,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,SAAsB;IAEvD,eAAe,IAAI,OAAO,CAAC,CAAC,eAAe,EAAE,UAAU,CAAC,EAAE,CAAC;IAI3D,GAAG,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAM/D,GAAG,CAAC,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,GAAG,SAAS;CAkBxE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/connectionsStorage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAEpC;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,eAAe,GAAG,OAAO,CAE5E;AAED;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,GAAG,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,GAAG,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;IAEhE;;;;;OAKG;IACH,GAAG,CACD,QAAQ,EAAE,eAAe,EACzB,UAAU,EAAE,UAAU,GAAG,SAAS,GACjC,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAED;;;;GAIG;AACH,qBAAa,2BAA4B,YAAW,eAAe;IAKrD,OAAO,CAAC,QAAQ,CAAC,UAAU;IAJvC;;;OAGG;gBAC0B,UAAU,SAAsB;IAE7D;;;OAGG;IACG,eAAe,IAAI,OAAO,CAAC,CAAC,eAAe,EAAE,UAAU,CAAC,EAAE,CAAC;IAIjE;;;;OAIG;IACG,GAAG,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAMrE;;;;;OAKG;IACG,GAAG,CACP,QAAQ,EAAE,eAAe,EACzB,UAAU,EAAE,UAAU,GAAG,SAAS,GACjC,OAAO,CAAC,IAAI,CAAC;CAkBjB"}