ethers.js/lib.esm/wallet/base-wallet.js

101 lines
3.9 KiB
JavaScript
Raw Normal View History

2022-09-05 23:57:11 +03:00
import { getAddress, resolveAddress } from "../address/index.js";
import { hashMessage, TypedDataEncoder } from "../hash/index.js";
import { AbstractSigner } from "../providers/index.js";
import { computeAddress, Transaction } from "../transaction/index.js";
2022-11-09 10:57:02 +03:00
import { defineProperties, resolveProperties, assert, assertArgument } from "../utils/index.js";
2022-11-30 23:44:23 +03:00
/**
* The **BaseWallet** is a stream-lined implementation of a
* [[Signer]] that operates with a private key.
*
* It is preferred to use the [[Wallet]] class, as it offers
* additional functionality and simplifies loading a variety
* of JSON formats, Mnemonic Phrases, etc.
*
* This class may be of use for those attempting to implement
* a minimal Signer.
*/
2022-09-05 23:57:11 +03:00
export class BaseWallet extends AbstractSigner {
2022-11-30 23:44:23 +03:00
/**
* The wallet address.
*/
2022-09-05 23:57:11 +03:00
address;
#signingKey;
2022-11-30 23:44:23 +03:00
/**
* Creates a new BaseWallet for %%privateKey%%, optionally
* connected to %%provider%%.
*
* If %%provider%% is not specified, only offline methods can
* be used.
*/
2022-09-05 23:57:11 +03:00
constructor(privateKey, provider) {
super(provider);
2022-11-30 23:44:23 +03:00
assertArgument(privateKey && typeof (privateKey.sign) === "function", "invalid private key", "privateKey", "[ REDACTED ]");
2022-09-05 23:57:11 +03:00
this.#signingKey = privateKey;
const address = computeAddress(this.signingKey.publicKey);
defineProperties(this, { address });
}
2022-11-30 23:44:23 +03:00
// Store private values behind getters to reduce visibility
// in console.log
/**
* The [[SigningKey]] used for signing payloads.
*/
2022-09-05 23:57:11 +03:00
get signingKey() { return this.#signingKey; }
2022-11-30 23:44:23 +03:00
/**
* The private key for this wallet.
*/
2022-09-05 23:57:11 +03:00
get privateKey() { return this.signingKey.privateKey; }
async getAddress() { return this.address; }
connect(provider) {
return new BaseWallet(this.#signingKey, provider);
}
2022-10-20 12:03:32 +03:00
async signTransaction(tx) {
2022-09-05 23:57:11 +03:00
// Replace any Addressable or ENS name with an address
2022-10-20 12:03:32 +03:00
const { to, from } = await resolveProperties({
to: (tx.to ? resolveAddress(tx.to, this.provider) : undefined),
from: (tx.from ? resolveAddress(tx.from, this.provider) : undefined)
});
if (to != null) {
tx.to = to;
}
if (from != null) {
tx.from = from;
}
2022-09-05 23:57:11 +03:00
if (tx.from != null) {
2022-11-09 10:57:02 +03:00
assertArgument(getAddress((tx.from)) === this.address, "transaction from address mismatch", "tx.from", tx.from);
2022-09-05 23:57:11 +03:00
delete tx.from;
}
// Build the transaction
const btx = Transaction.from(tx);
btx.signature = this.signingKey.sign(btx.unsignedHash);
return btx.serialized;
}
async signMessage(message) {
2022-11-30 23:44:23 +03:00
return this.signMessageSync(message);
2022-09-05 23:57:11 +03:00
}
2022-10-20 12:03:32 +03:00
// @TODO: Add a secialized signTx and signTyped sync that enforces
// all parameters are known?
2022-11-30 23:44:23 +03:00
/**
* Returns the signature for %%message%% signed with this wallet.
*/
2022-10-20 12:03:32 +03:00
signMessageSync(message) {
return this.signingKey.sign(hashMessage(message)).serialized;
}
2022-09-05 23:57:11 +03:00
async signTypedData(domain, types, value) {
// Populate any ENS names
const populated = await TypedDataEncoder.resolveNames(domain, types, value, async (name) => {
2022-11-10 12:05:51 +03:00
// @TODO: this should use resolveName; addresses don't
// need a provider
2022-11-09 10:57:02 +03:00
assert(this.provider != null, "cannot resolve ENS names without a provider", "UNSUPPORTED_OPERATION", {
operation: "resolveName",
info: { name }
});
2022-09-05 23:57:11 +03:00
const address = await this.provider.resolveName(name);
2022-11-09 10:57:02 +03:00
assert(address != null, "unconfigured ENS name", "UNCONFIGURED_NAME", {
value: name
});
2022-09-05 23:57:11 +03:00
return address;
});
return this.signingKey.sign(TypedDataEncoder.hash(populated.domain, types, populated.value)).serialized;
}
}
//# sourceMappingURL=base-wallet.js.map