@metamask/snaps-rpc-methods
Version:
MetaMask Snaps JSON-RPC method implementations
87 lines • 3.92 kB
JavaScript
;
Object.defineProperty(exports, "__esModule", { value: true });
exports.getBip32EntropyImplementation = exports.getBip32EntropyBuilder = void 0;
const permission_controller_1 = require("@metamask/permission-controller");
const rpc_errors_1 = require("@metamask/rpc-errors");
const snaps_utils_1 = require("@metamask/snaps-utils");
const utils_1 = require("@metamask/utils");
const utils_2 = require("../utils.cjs");
const targetName = 'snap_getBip32Entropy';
/**
* The specification builder for the `snap_getBip32Entropy` permission.
* `snap_getBip32Entropy` lets the Snap control private keys for a particular
* BIP-32 node.
*
* @param options - The specification builder options.
* @param options.methodHooks - The RPC method hooks needed by the method implementation.
* @returns The specification for the `snap_getBip32Entropy` permission.
*/
const specificationBuilder = ({ methodHooks }) => {
return {
permissionType: permission_controller_1.PermissionType.RestrictedMethod,
targetName,
allowedCaveats: [snaps_utils_1.SnapCaveatType.PermittedDerivationPaths],
methodImplementation: getBip32EntropyImplementation(methodHooks),
validator: ({ caveats }) => {
if (caveats?.length !== 1 ||
caveats[0].type !== snaps_utils_1.SnapCaveatType.PermittedDerivationPaths) {
throw rpc_errors_1.rpcErrors.invalidParams({
message: `Expected a single "${snaps_utils_1.SnapCaveatType.PermittedDerivationPaths}" caveat.`,
});
}
},
subjectTypes: [permission_controller_1.SubjectType.Snap],
};
};
const methodHooks = {
getMnemonic: true,
getMnemonicSeed: true,
getUnlockPromise: true,
getClientCryptography: true,
};
exports.getBip32EntropyBuilder = Object.freeze({
targetName,
specificationBuilder,
methodHooks,
});
/**
* Builds the method implementation for `snap_getBip32Entropy`.
*
* @param hooks - The RPC method hooks.
* @param hooks.getMnemonic - A function to retrieve the Secret Recovery Phrase of the user.
* @param hooks.getMnemonicSeed - A function to retrieve the BIP-39 seed of the user.
* @param hooks.getUnlockPromise - A function that resolves once the MetaMask extension is unlocked
* and prompts the user to unlock their MetaMask if it is locked.
* @param hooks.getClientCryptography - A function to retrieve the cryptographic
* functions to use for the client.
* @returns The method implementation which returns a `JsonSLIP10Node`.
* @throws If the params are invalid.
*/
function getBip32EntropyImplementation({ getMnemonic, getMnemonicSeed, getUnlockPromise, getClientCryptography, }) {
return async function getBip32Entropy(args) {
await getUnlockPromise(true);
const { params } = args;
(0, utils_1.assert)(params);
// Using the seed is much faster, but we can only do it for these specific curves.
if (params.curve === 'secp256k1' || params.curve === 'ed25519') {
const seed = await (0, utils_2.getValueFromEntropySource)(getMnemonicSeed, params.source);
const node = await (0, utils_2.getNodeFromSeed)({
curve: params.curve,
path: params.path,
seed,
cryptographicFunctions: getClientCryptography(),
});
return node.toJSON();
}
const secretRecoveryPhrase = await (0, utils_2.getValueFromEntropySource)(getMnemonic, params.source);
const node = await (0, utils_2.getNodeFromMnemonic)({
curve: params.curve,
path: params.path,
secretRecoveryPhrase,
cryptographicFunctions: getClientCryptography(),
});
return node.toJSON();
};
}
exports.getBip32EntropyImplementation = getBip32EntropyImplementation;
//# sourceMappingURL=getBip32Entropy.cjs.map