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
|