git.iko.soy/bridge
on c8cd811 help sign in
bridge/src/lib/reticket.js
284 lines 7.3 kB history raw
1import * as azimuth from 'azimuth-js';
2import * as tank from './tank';
4import { hexify } from './txn';
5import {
6 deriveNetworkSeedFromUrbitWallet,
7 deriveNetworkKeys,
8 CRYPTO_SUITE_VERSION,
9} from './keys';
10import { addHexPrefix } from './utils/address';
11import {
12 sendAndAwaitAllSerial,
13 signTransaction,
14 sendSignedTransaction,
15} from './txn';
16import getSuggestedGasPrice from './getSuggestedGasPrice';
17import { GAS_LIMITS, INITIAL_NETWORK_KEY_REVISION } from './constants';
18import { toBN } from 'web3-utils';
19import { safeToWei } from './lib';
20import { isGalaxy, isPlanet } from './utils/point';
22export const TRANSACTION_PROGRESS = {
23 GENERATING: 0.01,
24 SIGNING: 0.15,
25 FUNDING: 0.3,
26 TRANSFERRING: 0.55,
27 CLEANING: 0.95,
28 DONE: 1.0,
29};
31export async function reticketPointBetweenWallets({
32 fromWallet,
33 fromWalletType,
34 fromWalletHdPath,
35 toWallet,
36 point,
37 web3,
38 contracts,
39 networkType,
40 onUpdate,
41 transferEth = false,
42 nextRevision = INITIAL_NETWORK_KEY_REVISION,
43 txnSigner,
44 txnSender,
45 doSetSpawnProxy = true,
46}) {
47 const askForFunding = (address, minBalance, balance) =>
48 onUpdate({
49 type: 'askFunding',
50 value: { address, minBalance, balance },
51 });
53 const gotFunding = () => onUpdate({ type: 'gotFunding' });
54 const progress = state => onUpdate({ type: 'progress', state });
56 //
57 // generate transactions
58 //
60 progress(TRANSACTION_PROGRESS.GENERATING);
62 // transfer to invite wallet, so it can configure
63 //NOTE doing this in the invite wallet instead of the final wallet makes
64 // failure cases "solvable" by just telling the user to fully retry.
65 // in other words, the invite flow is effectively idempotent.
67 //TODO no harm done if we already owned it, but should still get a bool arg
68 // for skipping this, if it isn't too big a burden for callers
69 const transferTmpTx = azimuth.ecliptic.transferPoint(
70 contracts,
71 point,
72 fromWallet.address,
73 false
74 );
75 transferTmpTx.gas = GAS_LIMITS.TRANSFER;
77 // configure networking public keys
78 const seed = await deriveNetworkSeedFromUrbitWallet(toWallet, nextRevision);
80 const networkSeed = seed.matchWith({
81 Nothing: () => {
82 throw new Error('network seed not derived');
83 },
84 Just: p => p.value,
85 });
87 const networkKeys = deriveNetworkKeys(networkSeed);
89 const keysTx = azimuth.ecliptic.configureKeys(
90 contracts,
91 point,
92 addHexPrefix(networkKeys.crypt.public),
93 addHexPrefix(networkKeys.auth.public),
94 CRYPTO_SUITE_VERSION,
95 /* discontinuous */ false
96 );
97 keysTx.gas = GAS_LIMITS.CONFIGURE_KEYS;
99 // configure management proxy
101 const managementTx = azimuth.ecliptic.setManagementProxy(
102 contracts,
103 point,
104 toWallet.management.keys.address
105 );
106 managementTx.gas = GAS_LIMITS.SET_PROXY;
108 // set spawn & voting proxies situationally
110 // skip this step if reticketing an L1 point with L2-migrated spawn proxy
111 let txs = [transferTmpTx, keysTx, managementTx];
112 if (!isPlanet(point) && doSetSpawnProxy) {
113 const spawnTx = azimuth.ecliptic.setSpawnProxy(
114 contracts,
115 point,
116 toWallet.spawn.keys.address
117 );
118 spawnTx.gas = GAS_LIMITS.SET_PROXY;
119 txs.push(spawnTx);
120 }
122 if (isGalaxy(point)) {
123 const votingTx = azimuth.ecliptic.setVotingProxy(
124 contracts,
125 point,
126 toWallet.voting.keys.address
127 );
128 votingTx.gas = GAS_LIMITS.SET_PROXY;
129 txs.push(votingTx);
130 }
132 // transfer configured point to user's new wallet
134 const transferFinalTx = azimuth.ecliptic.transferPoint(
135 contracts,
136 point,
137 toWallet.ownership.keys.address,
138 false
139 );
140 transferFinalTx.gas = GAS_LIMITS.TRANSFER;
141 txs.push(transferFinalTx);
143 //
144 // finalizing & signing transactions
145 //
147 progress(TRANSACTION_PROGRESS.SIGNING);
149 const gasPriceData = (await getSuggestedGasPrice(networkType)).average;
150 const gasPriceGwei = gasPriceData.price.toFixed();
151 const chainId = await web3.eth.net.getId();
152 const gasPriceWeiBN = toBN(safeToWei(gasPriceGwei, 'gwei'));
153 let inviteNonce = await web3.eth.getTransactionCount(fromWallet.address);
154 const totalCost = txs.reduce(
155 (acc, tx) => acc.add(gasPriceWeiBN.mul(toBN(tx.gas))),
156 toBN(0)
157 );
159 let txPairs = [];
161 // Must be done in serial else hardware will give nonce errors
162 for (let i = 0; i < txs.length; i++) {
163 const stx = await signTransaction({
164 wallet: fromWallet,
165 walletType: fromWalletType,
166 walletHdPath: fromWalletHdPath,
167 networkType,
168 txn: txs[i],
169 nonce: inviteNonce + i,
170 chainId,
171 gasPriceData,
172 gasLimit: txs[i].gas,
173 txnSigner,
174 txnSender,
175 });
176 txPairs.push({
177 raw: hexify(stx.serialize()),
178 signed: stx,
179 });
180 }
182 inviteNonce = inviteNonce + txs.length;
184 //
185 // ensuring funding for transactions
186 //
188 progress(TRANSACTION_PROGRESS.FUNDING);
190 const usedTank = await tank.ensureFundsFor(
191 web3,
192 point,
193 fromWallet.address,
194 fromWalletType,
195 totalCost,
196 txPairs.map(p => p.raw),
197 askForFunding,
198 gotFunding
199 );
201 //
202 // sending and awaiting transactions
203 //
205 progress(TRANSACTION_PROGRESS.TRANSFERRING);
207 const receipts = await sendAndAwaitAllSerial(
208 web3,
209 txPairs.map(p => p.signed),
210 usedTank
211 );
213 const realCost = gasPriceWeiBN.mul(
214 receipts.reduce((sum, receipt) => {
215 return sum.add(toBN(receipt.gasUsed));
216 }, toBN(0))
217 );
219 //
220 // move leftover eth
221 //
223 progress(TRANSACTION_PROGRESS.CLEANING);
225 let balance = toBN(await web3.eth.getBalance(fromWallet.address));
226 const gasLimit = GAS_LIMITS.SEND_ETH;
227 const sendEthCost = gasPriceWeiBN.mul(toBN(gasLimit));
229 // if we have funds left over from what the gas tank gave us, send those back
230 if (usedTank && realCost.add(sendEthCost).lt(totalCost)) {
231 try {
232 const remainder = totalCost.sub(realCost).sub(sendEthCost);
233 console.log('returning to gas tank', remainder.toString());
234 const txn = { to: tank.TANK_ADDRESS, value: remainder };
235 const stx = await signTransaction({
236 wallet: fromWallet,
237 walletType: fromWalletType,
238 walletHdPath: fromWalletHdPath,
239 txn,
240 chainId,
241 networkType,
242 gasPriceData,
243 gasLimit,
244 nonce: inviteNonce,
245 });
246 sendSignedTransaction(web3, stx);
248 // only update these after the above succeeded
249 inviteNonce++;
250 balance = balance.sub(remainder).sub(sendEthCost);
251 } catch (err) {
252 console.log('error returning gas, safely ignored:');
253 console.log(err);
254 }
255 }
257 // if non-trivial eth left in invite wallet, transfer to new ownership
258 if (transferEth && balance.gt(sendEthCost)) {
259 try {
260 const value = balance.sub(sendEthCost);
261 const txn = {
262 to: toWallet.ownership.keys.address,
263 value: value,
264 };
265 const stx = await signTransaction({
266 wallet: fromWallet,
267 walletType: fromWalletType,
268 walletHdPath: fromWalletHdPath,
269 txn,
270 chainId,
271 networkType,
272 gasPriceData,
273 gasLimit,
274 nonce: inviteNonce,
275 });
276 sendSignedTransaction(web3, stx);
277 } catch (err) {
278 console.log('error sending value tx, safely ignored:');
279 console.log(err);
280 }
281 }
283 progress(TRANSACTION_PROGRESS.DONE);