@@ -1,44 +1,66 @@
1import { useCallback, useMemo, useEffect, useState } from 'react';
1import { useCallback, useMemo, useEffect, useState } from 'react';
2−import { Just, Nothing } from 'folktale/maybe';
2+import { Just } from 'folktale/maybe';
3import saveAs from 'file-saver';
3import saveAs from 'file-saver';
5import { useWallet } from 'store/wallet';
4import { useWallet } from 'store/wallet';
6−import { useRollerStore } from 'store/rollerStore';
5+import { EMPTY_POINT, useRollerStore } from 'store/rollerStore';
8import { generateCode } from 'lib/networkCode';
6import { generateCode } from 'lib/networkCode';
11 attemptNetworkSeedDerivation,
8 attemptNetworkSeedDerivation,
9+ deriveNetworkSeedFromUrbitWallet,
12 keysMatchChain,
10 keysMatchChain,
13 deriveNetworkKeys,
11 deriveNetworkKeys,
14 compileMultiKey,
12 compileMultiKey,
15} from './keys';
13} from './keys';
16import { stripSigPrefix } from 'form/formatters';
14import { stripSigPrefix } from 'form/formatters';
15+import useRoller from './useRoller';
16+import Point from './types/Point';
17+import { toL1Details } from './utils/point';
18+import { ETH_ZERO_ADDR } from './constants';
18interface useKeyfileGeneratorArgs {
20interface useKeyfileGeneratorArgs {
19− seed?: string;
22+ seeds: string[];
23− * seed - (optional) derived from wallet, mnemonic, or token by default (if possible)
26+ * The default Keyfile Generator. Can be used by itself, or composed with
27+ * other hooks (see `useActivationKeyfileGenerator` and `useHomeKeyfileGenerator`).
29+ * @param point Point - (optional) the Point for which to generate keys
30+ * @param seeds string[] - (required) one or more seeds consumed by deriveNetworkKeys
25−export default function useKeyfileGenerator({ seed }: useKeyfileGeneratorArgs) {
33+function useKeyfileGenerator({ point, seeds }: useKeyfileGeneratorArgs) {
26− const { urbitWallet, wallet, authMnemonic, authToken }: any = useWallet();
34+ // exported keyfile generator properties
27− const { point } = useRollerStore();
29 const [notice, setNotice] = useState('Deriving networking keys...');
35 const [notice, setNotice] = useState('Deriving networking keys...');
30 const [downloaded, setDownloaded] = useState(false);
36 const [downloaded, setDownloaded] = useState(false);
31 const [generating, setGenerating] = useState(true);
37 const [generating, setGenerating] = useState(true);
32 const [keyfile, setKeyfile] = useState<boolean | string>(false);
38 const [keyfile, setKeyfile] = useState<boolean | string>(false);
33 const [code, setCode] = useState(false);
39 const [code, setCode] = useState(false);
42+ const { point: storedPoint } = useRollerStore();
43+ const resolvedPoint = useMemo(() => {
44+ return point || storedPoint;
45+ }, [point, storedPoint]);
35− const networkRevision = Number(point.keyRevisionNumber);
47+ const networkRevision = useMemo(() => {
48+ return Number(resolvedPoint.keyRevisionNumber);
50+ const canManage = useMemo(() => {
36− const canManage = point.isOwner || point.isManagementProxy;
51+ return resolvedPoint.isOwner || resolvedPoint.isManagementProxy;
38 const hasNetworkKeys = networkRevision > 0;
54 const hasNetworkKeys = networkRevision > 0;
39 const available = canManage && hasNetworkKeys && !!keyfile;
55 const available = canManage && hasNetworkKeys && !!keyfile;
41 const generate = useCallback(async () => {
57 const generate = useCallback(async () => {
58+ // Point still loading ...
59+ if (resolvedPoint.value === EMPTY_POINT.value) {
60+ console.log('Loading point data ...');
42 if (!hasNetworkKeys) {
64 if (!hasNetworkKeys) {
43 setGenerating(false);
65 setGenerating(false);
44 setNotice('Network keys not yet set.');
66 setNotice('Network keys not yet set.');
@@ -48,19 +70,9 @@ export default function useKeyfileGenerator({ seed }: useKeyfileGeneratorArgs) {
51− const networkSeed = seed
73+ // seeds were either generated non-deterministically,
52− ? Just(seed)
74+ // or still being derived ...
53− : await attemptNetworkSeedDerivation({
75+ if (seeds.length === 0) {
60− revision: networkRevision,
63− if (Nothing.hasInstance(networkSeed)) {
64 setGenerating(false);
76 setGenerating(false);
65 setNotice(
77 setNotice(
66 'Custom or nondeterministic networking keys cannot be re-downloaded.'
78 'Custom or nondeterministic networking keys cannot be re-downloaded.'
@@ -69,11 +81,10 @@ export default function useKeyfileGenerator({ seed }: useKeyfileGeneratorArgs) {
72− const _networkSeed = networkSeed.value;
74− const pair = deriveNetworkKeys(_networkSeed);
84+ const pairs = seeds.map(seed => deriveNetworkKeys(seed));
85+ const firstPair = pairs[0];
76− if (!keysMatchChain(pair, point)) {
87+ if (!keysMatchChain(firstPair, resolvedPoint)) {
77 setGenerating(false);
88 setGenerating(false);
78 setNotice('Derived networking keys do not match on-chain details.');
89 setNotice('Derived networking keys do not match on-chain details.');
79 console.log(`keys do not match details for revision ${networkRevision}`);
90 console.log(`keys do not match details for revision ${networkRevision}`);
@@ -81,31 +92,22 @@ export default function useKeyfileGenerator({ seed }: useKeyfileGeneratorArgs) {
83 setNotice('');
94 setNotice('');
84− setCode(generateCode(pair));
95+ setCode(generateCode(firstPair));
85 setKeyfile(
96 setKeyfile(
86− compileMultiKey(point.value, [
97+ compileMultiKey(
87− {
98+ resolvedPoint.value,
99+ pairs.map((pair, k) => {
88− revision: networkRevision,
100+ return { revision: networkRevision + k, pair };
104+ console.log(`keyfile generated for revision ${networkRevision}`);
93 setGenerating(false);
105 setGenerating(false);
96− hasNetworkKeys,
106+ }, [hasNetworkKeys, seeds, resolvedPoint, networkRevision]);
106 const filename = useMemo(() => {
108 const filename = useMemo(() => {
107− return `${stripSigPrefix(point.patp)}-${networkRevision}.key`;
109+ return `${stripSigPrefix(resolvedPoint.patp)}-${networkRevision}.key`;
108− }, [point, networkRevision]);
110+ }, [resolvedPoint, networkRevision]);
110 const download = useCallback(() => {
112 const download = useCallback(() => {
111 if (typeof keyfile !== 'string') {
113 if (typeof keyfile !== 'string') {
@@ -138,3 +140,114 @@ export default function useKeyfileGenerator({ seed }: useKeyfileGeneratorArgs) {
139 return { ...values, bind: values };
141 return { ...values, bind: values };
144+interface ActivationKeyfileGeneratorArgs {
146+ wallets: UrbitWallet[];
150+ * This Activation Keyfile Generator is used to derive a multikey during the
151+ * Activation Flow. At the time of generation, there is no Point yet set in
152+ * the Roller Store, so we need to look it up by Point ID (to retreive the
153+ * current key revision via API).
155+ * @param pointId number - (required) the point ID for which to generate keys
156+ * @param wallets UrbitWallet[] - (required) for each wallet,
157+ * a seed + revision pair is generated and consumed by `compileMultiKey`.
158+ * It should be an array of [deterministic invite wallet, non-deterministic
159+ * master ticket wallet] (the sending and receiving wallets)
161+export const useActivationKeyfileGenerator = ({
164+}: ActivationKeyfileGeneratorArgs) => {
166+ const { api } = useRoller();
167+ const [point, setPoint] = useState<Point>(EMPTY_POINT);
169+ const resolvePoint = useCallback(async () => {
170+ const resolved = new Point({
172+ details: toL1Details(await api.getPoint(pointId)),
173+ address: ETH_ZERO_ADDR,
183+ // derive seeds from wallets
184+ const [seeds, setSeeds] = useState<string[]>([]);
185+ const deriveSeeds = useCallback(async () => {
186+ if (!('keyRevisionNumber' in point)) {
190+ const derivedSeeds = await Promise.all(
191+ wallets.map(async (w, i) => {
192+ return deriveNetworkSeedFromUrbitWallet(w, point.keyRevisionNumber + i);
198+ .map(maybeSeed => maybeSeed.getOrElse(null))
199+ .filter(s => s !== null)
201+ }, [point, wallets]);
205+ // eslint-disable-next-line react-hooks/exhaustive-deps
208+ return useKeyfileGenerator({ point, seeds });
211+interface HomeKeyfileGeneratorArgs {
216+ * This Home Keyfile Generator is used to derive a multikey in multiple views
217+ * in the Bridge dashboard (Set Network Keys, Home > ID, Home > OS views).
219+ * * @param seed string - (optional) default: provided by the logged in wallet
221+export const useHomeKeyfileGenerator = ({ seed }: HomeKeyfileGeneratorArgs) => {
222+ // use provided seed, or fallback to deriving from logged in wallet
223+ const { point } = useRollerStore();
224+ const { authMnemonic, authToken, urbitWallet, wallet }: any = useWallet();
225+ const [seeds, setSeeds] = useState<string[]>([]);
227+ const deriveSeeds = useCallback(async () => {
233+ const derivedSeed = await attemptNetworkSeedDerivation({
240+ revision: point.keyRevisionNumber,
243+ if (Just.hasInstance(derivedSeed)) {
244+ setSeeds([derivedSeed.value]);
246+ }, [authMnemonic, authToken, point, seed, urbitWallet, wallet]);
252+ return useKeyfileGenerator({ seeds });