@ckb-ccc/core 0.0.4-alpha.8 → 0.0.5-alpha.0

package/dist.commonjs/signer/ckb/signerCkbScriptReadonly.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SignerCkbScriptReadonly = void 0;
+const address_1 = require("../../address");
+const ckb_1 = require("../../ckb");
+const signer_1 = require("../signer");
+/**
+ * A class extending Signer that provides read-only access to a CKB script.
+ * This class does not support signing operations.
+ */
+class SignerCkbScriptReadonly extends signer_1.Signer {
+    /**
+     * Creates an instance of SignerCkbScriptReadonly.
+     *
+     * @param client - The client instance used for communication.
+     * @param script - The script associated with the signer.
+     */
+    constructor(client, script) {
+        super(client);
+        this.script = ckb_1.Script.from(script);
+    }
+    /**
+     * Construct a new signer with the client replaced.
+     *
+     * @returns A promise that resolves the new Signer.
+     */
+    async replaceClient(client) {
+        return new SignerCkbScriptReadonly(client, this.script);
+    }
+    /**
+     * Connects to the client. This implementation does nothing as the class is read-only.
+     *
+     * @returns A promise that resolves when the connection is complete.
+     */
+    async connect() { }
+    /**
+     * Check if the signer is connected.
+     *
+     * @returns A promise that resolves the connection status.
+     */
+    async isConnected() {
+        return true;
+    }
+    /**
+     * Gets the internal address for the script.
+     *
+     * @returns A promise that resolves to a string representing the internal address.
+     *
+     * @example
+     * ```typescript
+     * const internalAddress = await signer.getInternalAddress(); // Outputs the internal address
+     * ```
+     */
+    async getInternalAddress() {
+        return this.getRecommendedAddress();
+    }
+    /**
+     * Gets an array of Address objects representing the script address.
+     *
+     * @returns A promise that resolves to an array of Address objects.
+     *
+     * @example
+     * ```typescript
+     * const addressObjs = await signer.getAddressObjs(); // Outputs the array of Address objects
+     * ```
+     */
+    async getAddressObjs() {
+        return [await address_1.Address.fromScript(this.script, this.client)];
+    }
+}
+exports.SignerCkbScriptReadonly = SignerCkbScriptReadonly;

package/dist.commonjs/signer/evm/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./signerEvm";
+export * from "./signerEvmAddressReadonly";
+//# sourceMappingURL=index.d.ts.map

package/dist.commonjs/signer/evm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/signer/evm/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,4BAA4B,CAAC"}

package/dist.commonjs/signer/evm/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./signerEvm"), exports);
+__exportStar(require("./signerEvmAddressReadonly"), exports);

package/dist.commonjs/signer/evm/signerEvm.d.ts

@@ -0,0 +1,46 @@
+import { Address } from "../../address";
+import { BytesLike } from "../../bytes";
+import { Script, Transaction, TransactionLike } from "../../ckb";
+import { Signer } from "../signer";
+/**
+ * An abstract class extending Signer for Ethereum Virtual Machine (EVM) based signing operations.
+ * This class provides methods to get EVM account, internal address, and signing transactions.
+ */
+export declare abstract class SignerEvm extends Signer {
+    /**
+     * Gets the EVM account associated with the signer.
+     *
+     * @returns A promise that resolves to a string representing the EVM account.
+     */
+    abstract getEvmAccount(): Promise<string>;
+    /**
+     * Gets the internal address, which is the EVM account in this case.
+     *
+     * @returns A promise that resolves to a string representing the internal address.
+     */
+    getInternalAddress(): Promise<string>;
+    /**
+     * Gets an array of Address objects representing the known script addresses for the signer.
+     *
+     * @returns A promise that resolves to an array of Address objects.
+     */
+    getAddressObjs(): Promise<Address[]>;
+    _getOmniLockEvmAddressObj(account: string): Promise<Address>;
+    _getOmniLockOldEvmAddressObj(account: string): Promise<Address>;
+    /**
+     * prepare a transaction before signing. This method is not implemented and should be overridden by subclasses.
+     *
+     * @param txLike - The transaction to prepare, represented as a TransactionLike object.
+     * @returns A promise that resolves to the prepared Transaction object.
+     */
+    prepareTransaction(txLike: TransactionLike): Promise<Transaction>;
+    /**
+     * Signs a transaction without modifying it.
+     *
+     * @param txLike - The transaction to sign, represented as a TransactionLike object.
+     * @returns A promise that resolves to a signed Transaction object.
+     */
+    signOnlyTransaction(txLike: TransactionLike): Promise<Transaction>;
+    _signOmniLockScriptForTransaction(tx: Transaction, script: Script, messageTransformer: (hash: string) => BytesLike): Promise<Transaction>;
+}
+//# sourceMappingURL=signerEvm.d.ts.map

package/dist.commonjs/signer/evm/signerEvm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signerEvm.d.ts","sourceRoot":"","sources":["../../../src/signer/evm/signerEvm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,SAAS,EAA0B,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,eAAe,EAAe,MAAM,WAAW,CAAC;AAI9E,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC;;;GAGG;AACH,8BAAsB,SAAU,SAAQ,MAAM;IAC5C;;;;OAIG;IACH,QAAQ,CAAC,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAEzC;;;;OAIG;IACG,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC;IAI3C;;;;OAIG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAQpC,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ5D,4BAA4B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQrE;;;;;OAKG;IACG,kBAAkB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC;IAYvE;;;;;OAKG;IACG,mBAAmB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC;IAsBlE,iCAAiC,CACrC,EAAE,EAAE,WAAW,EACf,MAAM,EAAE,MAAM,EACd,kBAAkB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,SAAS,GAC9C,OAAO,CAAC,WAAW,CAAC;CA6BxB"}

package/dist.commonjs/signer/evm/signerEvm.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SignerEvm = void 0;
+const address_1 = require("../../address");
+const bytes_1 = require("../../bytes");
+const ckb_1 = require("../../ckb");
+const client_1 = require("../../client");
+const hex_1 = require("../../hex");
+const num_1 = require("../../num");
+const signer_1 = require("../signer");
+/**
+ * An abstract class extending Signer for Ethereum Virtual Machine (EVM) based signing operations.
+ * This class provides methods to get EVM account, internal address, and signing transactions.
+ */
+class SignerEvm extends signer_1.Signer {
+    /**
+     * Gets the internal address, which is the EVM account in this case.
+     *
+     * @returns A promise that resolves to a string representing the internal address.
+     */
+    async getInternalAddress() {
+        return this.getEvmAccount();
+    }
+    /**
+     * Gets an array of Address objects representing the known script addresses for the signer.
+     *
+     * @returns A promise that resolves to an array of Address objects.
+     */
+    async getAddressObjs() {
+        const account = await this.getEvmAccount();
+        return [
+            await this._getOmniLockEvmAddressObj(account),
+            await this._getOmniLockOldEvmAddressObj(account),
+        ];
+    }
+    async _getOmniLockEvmAddressObj(account) {
+        return address_1.Address.fromKnownScript(client_1.KnownScript.OmniLock, (0, hex_1.hexFrom)([0x12, ...(0, bytes_1.bytesFrom)(account), 0x00]), this.client);
+    }
+    async _getOmniLockOldEvmAddressObj(account) {
+        return address_1.Address.fromKnownScript(client_1.KnownScript.OmniLock, (0, hex_1.hexFrom)([0x1, ...(0, bytes_1.bytesFrom)(account), 0x00]), this.client);
+    }
+    /**
+     * prepare a transaction before signing. This method is not implemented and should be overridden by subclasses.
+     *
+     * @param txLike - The transaction to prepare, represented as a TransactionLike object.
+     * @returns A promise that resolves to the prepared Transaction object.
+     */
+    async prepareTransaction(txLike) {
+        const addresses = await this.getAddressObjs();
+        return addresses.reduce((txPromise, { script }) => txPromise.then((tx) => tx.prepareSighashAllWitness(script, 85, this.client)), Promise.resolve(ckb_1.Transaction.from(txLike)));
+    }
+    /**
+     * Signs a transaction without modifying it.
+     *
+     * @param txLike - The transaction to sign, represented as a TransactionLike object.
+     * @returns A promise that resolves to a signed Transaction object.
+     */
+    async signOnlyTransaction(txLike) {
+        let tx = ckb_1.Transaction.from(txLike);
+        const account = await this.getEvmAccount();
+        const { script: evmScript } = await this._getOmniLockEvmAddressObj(account);
+        const { script: oldEvmScript } = await this._getOmniLockOldEvmAddressObj(account);
+        tx = await this._signOmniLockScriptForTransaction(tx, evmScript, (hash) => `CKB transaction: ${hash}`);
+        tx = await this._signOmniLockScriptForTransaction(tx, oldEvmScript, (hash) => (0, bytes_1.bytesFrom)(hash));
+        return tx;
+    }
+    async _signOmniLockScriptForTransaction(tx, script, messageTransformer) {
+        const info = await tx.getSignHashInfo(script, this.client);
+        if (!info) {
+            return tx;
+        }
+        const signature = (0, bytes_1.bytesFrom)(await this.signMessage(messageTransformer(info.message)));
+        if (signature[signature.length - 1] >= 27) {
+            signature[signature.length - 1] -= 27;
+        }
+        const witness = ckb_1.WitnessArgs.fromBytes(tx.witnesses[info.position]);
+        witness.lock = (0, hex_1.hexFrom)((0, bytes_1.bytesConcat)((0, num_1.numToBytes)(5 * 4 + signature.length, 4), (0, num_1.numToBytes)(4 * 4, 4), (0, num_1.numToBytes)(5 * 4 + signature.length, 4), (0, num_1.numToBytes)(5 * 4 + signature.length, 4), (0, num_1.numToBytes)(signature.length, 4), signature));
+        tx.witnesses[info.position] = (0, hex_1.hexFrom)(witness.toBytes());
+        return tx;
+    }
+}
+exports.SignerEvm = SignerEvm;

package/dist.commonjs/signer/evm/signerEvmAddressReadonly.d.ts

@@ -0,0 +1,52 @@
+import { Client } from "../../client";
+import { HexLike } from "../../hex";
+import { SignerEvm } from "./signerEvm";
+/**
+ * A class extending SignerEvm that provides read-only access to an EVM address.
+ * This class does not support signing operations.
+ */
+export declare class SignerEvmAddressReadonly extends SignerEvm {
+    private readonly address;
+    /**
+     * Creates an instance of SignerEvmAddressReadonly.
+     *
+     * @param client - The client instance used for communication.
+     * @param address - The EVM address associated with the signer.
+     */
+    constructor(client: Client, address: HexLike);
+    /**
+     * Construct a new signer with the client replaced.
+     *
+     * @returns A promise that resolves the new Signer.
+     */
+    replaceClient(client: Client): Promise<SignerEvmAddressReadonly>;
+    /**
+     * Connects to the client. This implementation does nothing as the class is read-only.
+     *
+     * @returns A promise that resolves when the connection is complete.
+     *
+     * @example
+     * ```typescript
+     * await signer.connect();
+     * ```
+     */
+    connect(): Promise<void>;
+    /**
+     * Check if the signer is connected.
+     *
+     * @returns A promise that resolves the connection status.
+     */
+    isConnected(): Promise<boolean>;
+    /**
+     * Gets the EVM account associated with the signer.
+     *
+     * @returns A promise that resolves to a string representing the EVM account.
+     *
+     * @example
+     * ```typescript
+     * const account = await signer.getEvmAccount(); // Outputs the EVM account
+     * ```
+     */
+    getEvmAccount(): Promise<string>;
+}
+//# sourceMappingURL=signerEvmAddressReadonly.d.ts.map

package/dist.commonjs/signer/evm/signerEvmAddressReadonly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signerEvmAddressReadonly.d.ts","sourceRoot":"","sources":["../../../src/signer/evm/signerEvmAddressReadonly.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAO,OAAO,EAAW,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC;;;GAGG;AACH,qBAAa,wBAAyB,SAAQ,SAAS;IACrD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAM;IAE9B;;;;;OAKG;gBACS,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IAM5C;;;;OAIG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAItE;;;;;;;;;OASG;IAEG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAE9B;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAIrC;;;;;;;;;OASG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;CAGvC"}

package/dist.commonjs/signer/evm/signerEvmAddressReadonly.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SignerEvmAddressReadonly = void 0;
+const hex_1 = require("../../hex");
+const signerEvm_1 = require("./signerEvm");
+/**
+ * A class extending SignerEvm that provides read-only access to an EVM address.
+ * This class does not support signing operations.
+ */
+class SignerEvmAddressReadonly extends signerEvm_1.SignerEvm {
+    /**
+     * Creates an instance of SignerEvmAddressReadonly.
+     *
+     * @param client - The client instance used for communication.
+     * @param address - The EVM address associated with the signer.
+     */
+    constructor(client, address) {
+        super(client);
+        this.address = (0, hex_1.hexFrom)(address);
+    }
+    /**
+     * Construct a new signer with the client replaced.
+     *
+     * @returns A promise that resolves the new Signer.
+     */
+    async replaceClient(client) {
+        return new SignerEvmAddressReadonly(client, this.address);
+    }
+    /**
+     * Connects to the client. This implementation does nothing as the class is read-only.
+     *
+     * @returns A promise that resolves when the connection is complete.
+     *
+     * @example
+     * ```typescript
+     * await signer.connect();
+     * ```
+     */
+    async connect() { }
+    /**
+     * Check if the signer is connected.
+     *
+     * @returns A promise that resolves the connection status.
+     */
+    async isConnected() {
+        return true;
+    }
+    /**
+     * Gets the EVM account associated with the signer.
+     *
+     * @returns A promise that resolves to a string representing the EVM account.
+     *
+     * @example
+     * ```typescript
+     * const account = await signer.getEvmAccount(); // Outputs the EVM account
+     * ```
+     */
+    async getEvmAccount() {
+        return this.address;
+    }
+}
+exports.SignerEvmAddressReadonly = SignerEvmAddressReadonly;

package/dist.commonjs/signer/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./btc";
+export * from "./ckb";
+export * from "./evm";
+export * from "./signer";
+//# sourceMappingURL=index.d.ts.map

package/dist.commonjs/signer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/signer/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAC;AACtB,cAAc,OAAO,CAAC;AACtB,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC"}

package/dist.commonjs/signer/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./btc"), exports);
+__exportStar(require("./ckb"), exports);
+__exportStar(require("./evm"), exports);
+__exportStar(require("./signer"), exports);

package/dist.commonjs/signer/signer.d.ts

@@ -0,0 +1,133 @@
+import { Address } from "../address";
+import { BytesLike } from "../bytes";
+import { Transaction, TransactionLike } from "../ckb";
+import { Client } from "../client";
+import { Hex } from "../hex";
+/**
+ * An abstract class representing a generic signer.
+ * This class provides methods to connect, get addresses, and sign transactions.
+ */
+export declare abstract class Signer {
+    protected client_: Client;
+    constructor(client_: Client);
+    get client(): Client;
+    /**
+     * Construct a new signer with the client replaced.
+     *
+     * @returns A promise that resolves the new Signer.
+     */
+    abstract replaceClient(client: Client): Promise<Signer>;
+    /**
+     * Connects to the signer.
+     *
+     * @returns A promise that resolves when the connection is complete.
+     */
+    abstract connect(): Promise<void>;
+    /**
+     * Disconnects to the signer.
+     *
+     * @returns A promise that resolves when disconnected.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Check if the signer is connected.
+     *
+     * @returns A promise that resolves the connection status.
+     */
+    abstract isConnected(): Promise<boolean>;
+    /**
+     * Gets the internal address associated with the signer.
+     *
+     * @returns A promise that resolves to a string representing the internal address.
+     */
+    abstract getInternalAddress(): Promise<string>;
+    /**
+     * Gets an array of Address objects associated with the signer.
+     *
+     * @returns A promise that resolves to an array of Address objects.
+     */
+    abstract getAddressObjs(): Promise<Address[]>;
+    /**
+     * Gets the recommended Address object for the signer.
+     *
+     * @param _preference - Optional preference parameter.
+     * @returns A promise that resolves to the recommended Address object.
+     */
+    getRecommendedAddressObj(_preference?: unknown): Promise<Address>;
+    /**
+     * Gets the recommended address for the signer as a string.
+     *
+     * @param preference - Optional preference parameter.
+     * @returns A promise that resolves to the recommended address as a string.
+     */
+    getRecommendedAddress(preference?: unknown): Promise<string>;
+    /**
+     * Gets an array of addresses associated with the signer as strings.
+     *
+     * @returns A promise that resolves to an array of addresses as strings.
+     */
+    getAddresses(): Promise<string[]>;
+    /**
+     * Signs a message. This method is not implemented and should be overridden by subclasses.
+     *
+     * @param _ - The message to sign, as a string or BytesLike object.
+     * @returns A promise that resolves to the signed message as a string.
+     * @throws Will throw an error if not implemented.
+     */
+    signMessage(_: string | BytesLike): Promise<string>;
+    /**
+     * Sends a transaction after signing it.
+     *
+     * @param tx - The transaction to send, represented as a TransactionLike object.
+     * @returns A promise that resolves to the transaction hash as a Hex string.
+     */
+    sendTransaction(tx: TransactionLike): Promise<Hex>;
+    /**
+     * Signs a transaction.
+     *
+     * @param tx - The transaction to sign, represented as a TransactionLike object.
+     * @returns A promise that resolves to the signed Transaction object.
+     */
+    signTransaction(tx: TransactionLike): Promise<Transaction>;
+    /**
+     * prepare a transaction before signing. This method is not implemented and should be overridden by subclasses.
+     *
+     * @param _ - The transaction to prepare, represented as a TransactionLike object.
+     * @returns A promise that resolves to the prepared Transaction object.
+     * @throws Will throw an error if not implemented.
+     */
+    prepareTransaction(_: TransactionLike): Promise<Transaction>;
+    /**
+     * Signs a transaction without sending it. This method is not implemented and should be overridden by subclasses.
+     *
+     * @param _ - The transaction to sign, represented as a TransactionLike object.
+     * @returns A promise that resolves to the signed Transaction object.
+     * @throws Will throw an error if not implemented.
+     */
+    signOnlyTransaction(_: TransactionLike): Promise<Transaction>;
+}
+/**
+ * An enumeration of signer types.
+ */
+export declare enum SignerType {
+    EVM = "EVM",
+    BTC = "BTC",
+    CKB = "CKB"
+}
+/**
+ * A class representing information about a signer, including its type and the signer instance.
+ */
+export declare class SignerInfo {
+    name: string;
+    type: SignerType;
+    signer: Signer;
+    constructor(name: string, type: SignerType, signer: Signer);
+}
+/**
+ * Represents a wallet with a name, icon, and an array of signer information.
+ */
+export type Wallet = {
+    name: string;
+    icon: string;
+};
+//# sourceMappingURL=signer.d.ts.map

package/dist.commonjs/signer/signer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signer.d.ts","sourceRoot":"","sources":["../../src/signer/signer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAE7B;;;GAGG;AACH,8BAAsB,MAAM;IACd,SAAS,CAAC,OAAO,EAAE,MAAM;gBAAf,OAAO,EAAE,MAAM;IAErC,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAEvD;;;;OAIG;IACH,QAAQ,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAEjC;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAEjC;;;;OAIG;IACH,QAAQ,CAAC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAExC;;;;OAIG;IACH,QAAQ,CAAC,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC;IAE9C;;;;OAIG;IACH,QAAQ,CAAC,cAAc,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAE7C;;;;;OAKG;IACG,wBAAwB,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvE;;;;;OAKG;IACG,qBAAqB,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAIlE;;;;OAIG;IACG,YAAY,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAMvC;;;;;;OAMG;IACH,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IAInD;;;;;OAKG;IACG,eAAe,CAAC,EAAE,EAAE,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC;IAIxD;;;;;OAKG;IACG,eAAe,CAAC,EAAE,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC;IAKhE;;;;;;OAMG;IACH,kBAAkB,CAAC,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC;IAI5D;;;;;;OAMG;IACH,mBAAmB,CAAC,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC;CAG9D;AAED;;GAEG;AACH,oBAAY,UAAU;IACpB,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;CACZ;AAED;;GAEG;AACH,qBAAa,UAAU;IAEZ,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,UAAU;IAChB,MAAM,EAAE,MAAM;gBAFd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,MAAM;CAExB;AAED;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC"}

package/dist.commonjs/signer/signer.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SignerInfo = exports.SignerType = exports.Signer = void 0;
+/**
+ * An abstract class representing a generic signer.
+ * This class provides methods to connect, get addresses, and sign transactions.
+ */
+class Signer {
+    constructor(client_) {
+        this.client_ = client_;
+    }
+    get client() {
+        return this.client_;
+    }
+    /**
+     * Disconnects to the signer.
+     *
+     * @returns A promise that resolves when disconnected.
+     */
+    async disconnect() { }
+    /**
+     * Gets the recommended Address object for the signer.
+     *
+     * @param _preference - Optional preference parameter.
+     * @returns A promise that resolves to the recommended Address object.
+     */
+    async getRecommendedAddressObj(_preference) {
+        return (await this.getAddressObjs())[0];
+    }
+    /**
+     * Gets the recommended address for the signer as a string.
+     *
+     * @param preference - Optional preference parameter.
+     * @returns A promise that resolves to the recommended address as a string.
+     */
+    async getRecommendedAddress(preference) {
+        return (await this.getRecommendedAddressObj(preference)).toString();
+    }
+    /**
+     * Gets an array of addresses associated with the signer as strings.
+     *
+     * @returns A promise that resolves to an array of addresses as strings.
+     */
+    async getAddresses() {
+        return this.getAddressObjs().then((addresses) => addresses.map((address) => address.toString()));
+    }
+    /**
+     * Signs a message. This method is not implemented and should be overridden by subclasses.
+     *
+     * @param _ - The message to sign, as a string or BytesLike object.
+     * @returns A promise that resolves to the signed message as a string.
+     * @throws Will throw an error if not implemented.
+     */
+    signMessage(_) {
+        throw Error("Signer.signMessage not implemented");
+    }
+    /**
+     * Sends a transaction after signing it.
+     *
+     * @param tx - The transaction to send, represented as a TransactionLike object.
+     * @returns A promise that resolves to the transaction hash as a Hex string.
+     */
+    async sendTransaction(tx) {
+        return this.client.sendTransaction(await this.signTransaction(tx));
+    }
+    /**
+     * Signs a transaction.
+     *
+     * @param tx - The transaction to sign, represented as a TransactionLike object.
+     * @returns A promise that resolves to the signed Transaction object.
+     */
+    async signTransaction(tx) {
+        const preparedTx = await this.prepareTransaction(tx);
+        return this.signOnlyTransaction(preparedTx);
+    }
+    /**
+     * prepare a transaction before signing. This method is not implemented and should be overridden by subclasses.
+     *
+     * @param _ - The transaction to prepare, represented as a TransactionLike object.
+     * @returns A promise that resolves to the prepared Transaction object.
+     * @throws Will throw an error if not implemented.
+     */
+    prepareTransaction(_) {
+        throw Error("Signer.prepareTransaction not implemented");
+    }
+    /**
+     * Signs a transaction without sending it. This method is not implemented and should be overridden by subclasses.
+     *
+     * @param _ - The transaction to sign, represented as a TransactionLike object.
+     * @returns A promise that resolves to the signed Transaction object.
+     * @throws Will throw an error if not implemented.
+     */
+    signOnlyTransaction(_) {
+        throw Error("Signer.signOnlyTransaction not implemented");
+    }
+}
+exports.Signer = Signer;
+/**
+ * An enumeration of signer types.
+ */
+var SignerType;
+(function (SignerType) {
+    SignerType["EVM"] = "EVM";
+    SignerType["BTC"] = "BTC";
+    SignerType["CKB"] = "CKB";
+})(SignerType || (exports.SignerType = SignerType = {}));
+/**
+ * A class representing information about a signer, including its type and the signer instance.
+ */
+class SignerInfo {
+    constructor(name, type, signer) {
+        this.name = name;
+        this.type = type;
+        this.signer = signer;
+    }
+}
+exports.SignerInfo = SignerInfo;