react-native-zcash 0.0.2 → 0.2.1

package/lib/rnzcash.rn.js

@@ -40,6 +40,18 @@ function _asyncToGenerator(fn) {
   };
 }
 
+var SynchronizerStatus;
+
+(function (SynchronizerStatus) {
+  SynchronizerStatus[SynchronizerStatus["STOPPED"] = 0] = "STOPPED";
+  SynchronizerStatus[SynchronizerStatus["DISCONNECTED"] = 1] = "DISCONNECTED";
+  SynchronizerStatus[SynchronizerStatus["DOWNLOADING"] = 2] = "DOWNLOADING";
+  SynchronizerStatus[SynchronizerStatus["VALIDATING"] = 3] = "VALIDATING";
+  SynchronizerStatus[SynchronizerStatus["SCANNING"] = 4] = "SCANNING";
+  SynchronizerStatus[SynchronizerStatus["ENHANCING"] = 5] = "ENHANCING";
+  SynchronizerStatus[SynchronizerStatus["SYNCED"] = 6] = "SYNCED";
+})(SynchronizerStatus || (SynchronizerStatus = {}));
+
 var RNZcash = reactNative.NativeModules.RNZcash;
 
 var snooze = function snooze(ms) {
@@ -48,94 +60,243 @@ var snooze = function snooze(ms) {
   });
 };
 
-// export function subscribeToFoo(callback: Callback): void {
-//   const eventEmitter = new NativeEventEmitter(RNZcash)
-//   eventEmitter.addListener('FooEvent', callback)
-// }
 var KeyTool = {
-  deriveViewKey: function () {
-    var _deriveViewKey = _asyncToGenerator(function* (seedBytesHex) {
-      var result = yield RNZcash.deriveViewKey(seedBytesHex);
+  deriveViewingKey: function () {
+    var _deriveViewingKey = _asyncToGenerator(function* (seedBytesHex, network) {
+      var result = yield RNZcash.deriveViewingKey(seedBytesHex, network);
       return result;
     });
 
-    function deriveViewKey(_x) {
-      return _deriveViewKey.apply(this, arguments);
-    }
-
-    return deriveViewKey;
-  }() // deriveSpendingKey: async (seedBytesHex: string): Promise<string> => {return ''}
-
-}; // const makeAddressTool = () => {
-//   return {
-//     deriveShieldedAddress: async (viewingKey: string): Promise<string> => {return ''},
-//     deriveTransparentAddress: async (viewingKey: string): Promise<string> => {return ''},
-//     isValidShieldedAddress: async (address: string): Promise<boolean> => {return true},
-//     isValidTransparentAddress: async (address: string): Promise<boolean> => {return true}
-//   }
-// }
-//
-// interface WalletBalance {
-//   shieldedAvailable: string
-//   shieldedTotal: string
-//   transparentAvailable: string
-//   transparentTotal: string
-// }
-// interface InitializerCallbacks {
-//   onError: (e: Error): void
-//   onTransactionsChanged: (): void
-//   onBalanceChanged: (walletBalance: WalletBalance): void
-// }
-// interface SpendInfo {
-//   zatoshi: string
-//   toAddress: string
-//   memo: string
-//   fromAccountIndex: number
-//   spendingKey?: string
-// }
-// interface ZcashTransaction {
-//   txId: string
-//   fee: string
-//   value: string
-//   direction: 'inbound' | 'outbound'
-//   toAddress: string
-//   memo?: string
-//   minedHeight: number // 0 for unconfirmed
-//   blockTime: number // UNIX timestamp
-// }
-// type PendingTransaction = ZcashTransaction & {
-//   accountIndex: number
-//   expiryHeight: number
-//   cancelled: number
-//   submitAttemps: number
-//   errorMessage?: string
-//   errorCode?: number
-//   createTime: number
-// }
-// interface TransactionQuery {
-//   offset?: number
-//   limit?: number
-//   startDate?: number
-//   endDate?: number
-// }
+    function deriveViewingKey(_x, _x2) {
+      return _deriveViewingKey.apply(this, arguments);
+    }
+
+    return deriveViewingKey;
+  }(),
+  deriveSpendingKey: function () {
+    var _deriveSpendingKey = _asyncToGenerator(function* (seedBytesHex, network) {
+      var result = yield RNZcash.deriveSpendingKey(seedBytesHex, network);
+      return result;
+    });
+
+    function deriveSpendingKey(_x3, _x4) {
+      return _deriveSpendingKey.apply(this, arguments);
+    }
+
+    return deriveSpendingKey;
+  }()
+};
+var AddressTool = {
+  deriveShieldedAddress: function () {
+    var _deriveShieldedAddress = _asyncToGenerator(function* (viewingKey, network) {
+      var result = yield RNZcash.deriveShieldedAddress(viewingKey, network);
+      return result;
+    });
+
+    function deriveShieldedAddress(_x5, _x6) {
+      return _deriveShieldedAddress.apply(this, arguments);
+    }
+
+    return deriveShieldedAddress;
+  }(),
+  isValidShieldedAddress: function () {
+    var _isValidShieldedAddress = _asyncToGenerator(function* (address, network) {
+      if (network === void 0) {
+        network = 'mainnet';
+      }
+
+      var result = yield RNZcash.isValidShieldedAddress(address, network);
+      return result;
+    });
+
+    function isValidShieldedAddress(_x7, _x8) {
+      return _isValidShieldedAddress.apply(this, arguments);
+    }
+
+    return isValidShieldedAddress;
+  }(),
+  isValidTransparentAddress: function () {
+    var _isValidTransparentAddress = _asyncToGenerator(function* (address, network) {
+      if (network === void 0) {
+        network = 'mainnet';
+      }
+
+      var result = yield RNZcash.isValidTransparentAddress(address, network);
+      return result;
+    });
+
+    function isValidTransparentAddress(_x9, _x10) {
+      return _isValidTransparentAddress.apply(this, arguments);
+    }
+
+    return isValidTransparentAddress;
+  }()
+};
 
 var Synchronizer = /*#__PURE__*/function () {
-  function Synchronizer(initializerConfig) {
-    console.log(initializerConfig);
-  } // static init (initializerConfig: InitializerConfig): void
-  // setCallbackHandlers (callbacks: InitializerCallbacks): void
-  // getLatestHeight (): number
-  // getProgress (): number // 0-1
-  // getStatus (): ??
+  function Synchronizer(alias, network) {
+    this.eventEmitter = new reactNative.NativeEventEmitter(RNZcash);
+    this.subscriptions = [];
+    this.alias = alias;
+    this.network = network;
+  } /// ////////////////////////////////////////////////////////////////
+  // Start PoC behavior
+  //     Here are a few functions to demonstrate functionality but the final library should not have these functions
+  //
 
 
   var _proto = Synchronizer.prototype;
 
-  _proto.getShieldedBalance =
+  _proto.readyToSend =
   /*#__PURE__*/
   function () {
+    var _readyToSend = _asyncToGenerator(function* () {
+      var result = yield RNZcash.readyToSend();
+      return result;
+    });
+
+    function readyToSend() {
+      return _readyToSend.apply(this, arguments);
+    }
+
+    return readyToSend;
+  }();
+
+  _proto.sendTestTransaction = /*#__PURE__*/function () {
+    var _sendTestTransaction = _asyncToGenerator(function* (key, address) {
+      // send an amount that's guaranteed to be too large for our wallet and expect it to fail but at least show how this is done
+      // simply change these two values to send a real transaction but ensure the function isn't called too often (although funds can't be spent if notes are unconfirmed)
+      var invalidValue = '9223372036854775807'; // Max long value (change this to 10000 to send a small transaction equal to the miner's fee on every reload and you could send 10,000 of those before it equals 1 ZEC)
+
+      var invalidAccount = 99; // should be 0
+
+      return this.sendToAddress({
+        zatoshi: invalidValue,
+        toAddress: address,
+        memo: 'this is a test transaction that will fail',
+        fromAccountIndex: invalidAccount,
+        spendingKey: key
+      });
+    });
+
+    function sendTestTransaction(_x11, _x12) {
+      return _sendTestTransaction.apply(this, arguments);
+    }
+
+    return sendTestTransaction;
+  }();
+
+  _proto.getBlockCount = /*#__PURE__*/function () {
+    var _getBlockCount = _asyncToGenerator(function* () {
+      var result = yield RNZcash.getBlockCount();
+      return result;
+    });
+
+    function getBlockCount() {
+      return _getBlockCount.apply(this, arguments);
+    }
+
+    return getBlockCount;
+  }() // End PoC behavior
+  /// ////////////////////////////////////////////////////////////////
+  ;
+
+  _proto.start =
+  /*#__PURE__*/
+  function () {
+    var _start = _asyncToGenerator(function* () {
+      var result = yield RNZcash.start(this.alias);
+      return result;
+    });
+
+    function start() {
+      return _start.apply(this, arguments);
+    }
+
+    return start;
+  }();
+
+  _proto.stop = /*#__PURE__*/function () {
+    var _stop = _asyncToGenerator(function* () {
+      this.unsubscribe();
+      var result = yield RNZcash.stop(this.alias);
+      return result;
+    });
+
+    function stop() {
+      return _stop.apply(this, arguments);
+    }
+
+    return stop;
+  }();
+
+  _proto.initialize = /*#__PURE__*/function () {
+    var _initialize = _asyncToGenerator(function* (initializerConfig) {
+      yield RNZcash.initialize(initializerConfig.fullViewingKey.extfvk, initializerConfig.fullViewingKey.extpub, initializerConfig.birthdayHeight, initializerConfig.alias, initializerConfig.networkName, initializerConfig.defaultHost, initializerConfig.defaultPort);
+    });
+
+    function initialize(_x13) {
+      return _initialize.apply(this, arguments);
+    }
+
+    return initialize;
+  }();
+
+  _proto.getLatestNetworkHeight = /*#__PURE__*/function () {
+    var _getLatestNetworkHeight = _asyncToGenerator(function* (alias) {
+      var result = yield RNZcash.getLatestNetworkHeight(alias);
+      return result;
+    });
+
+    function getLatestNetworkHeight(_x14) {
+      return _getLatestNetworkHeight.apply(this, arguments);
+    }
+
+    return getLatestNetworkHeight;
+  }();
+
+  _proto.getLatestScannedHeight = /*#__PURE__*/function () {
+    var _getLatestScannedHeight = _asyncToGenerator(function* () {
+      var result = yield RNZcash.getLatestScannedHeight();
+      return result;
+    });
+
+    function getLatestScannedHeight() {
+      return _getLatestScannedHeight.apply(this, arguments);
+    }
+
+    return getLatestScannedHeight;
+  }();
+
+  _proto.getProgress = /*#__PURE__*/function () {
+    var _getProgress = _asyncToGenerator(function* () {
+      var result = yield RNZcash.getProgress();
+      return result;
+    });
+
+    function getProgress() {
+      return _getProgress.apply(this, arguments);
+    }
+
+    return getProgress;
+  }();
+
+  _proto.getStatus = /*#__PURE__*/function () {
+    var _getStatus = _asyncToGenerator(function* () {
+      var result = yield RNZcash.getStatus();
+      return SynchronizerStatus[result.name];
+    });
+
+    function getStatus() {
+      return _getStatus.apply(this, arguments);
+    }
+
+    return getStatus;
+  }();
+
+  _proto.getShieldedBalance = /*#__PURE__*/function () {
     var _getShieldedBalance = _asyncToGenerator(function* () {
-      var result = yield RNZcash.getShieldedBalance();
+      var result = yield RNZcash.getShieldedBalance(this.alias);
       return result;
     });
 
@@ -148,11 +309,12 @@ var Synchronizer = /*#__PURE__*/function () {
 
   _proto.getTransparentBalance = /*#__PURE__*/function () {
     var _getTransparentBalance = _asyncToGenerator(function* () {
+      // TODO: integrate with lightwalletd service to provide taddr balance. Edge probably doesn't need this, though so it can wait.
       yield snooze(0); // Hack to make typescript happy
 
       return {
-        availableBalance: '0',
-        totalBalance: '0'
+        availableZatoshi: '0',
+        totalZatoshi: '0'
       };
     });
 
@@ -161,29 +323,87 @@ var Synchronizer = /*#__PURE__*/function () {
     }
 
     return getTransparentBalance;
+  }();
+
+  _proto.getTransactions = /*#__PURE__*/function () {
+    var _getTransactions = _asyncToGenerator(function* (range) {
+      var result = yield RNZcash.getTransactions(this.alias, range.first, range.last);
+      return result;
+    });
+
+    function getTransactions(_x15) {
+      return _getTransactions.apply(this, arguments);
+    }
+
+    return getTransactions;
+  }();
+
+  _proto.rescan = function rescan(height) {
+    RNZcash.rescan(this.alias, height);
+  };
+
+  _proto.sendToAddress = /*#__PURE__*/function () {
+    var _sendToAddress = _asyncToGenerator(function* (spendInfo) {
+      var result = yield RNZcash.spendToAddress(this.alias, spendInfo.zatoshi, spendInfo.toAddress, spendInfo.memo, spendInfo.fromAccountIndex, // TODO: ask is it okay to send this across the boundary or should it live on the native side and never leave?
+      spendInfo.spendingKey);
+      return result;
+    });
+
+    function sendToAddress(_x16) {
+      return _sendToAddress.apply(this, arguments);
+    }
+
+    return sendToAddress;
   }() // estimateFee (spendInfo: SpendInfo): string
   // sendToAddress (spendInfo: SpendInfo): void
-  // start (): void
-  // stop (): void
   // getPendingTransactions (): PendingTransactions[]
   // getConfirmedTransactions (query: TransactionQuery): ZcashTransaction[]
+  // Events
   ;
 
+  _proto.subscribe = function subscribe(_ref) {
+    var onStatusChanged = _ref.onStatusChanged,
+        onUpdate = _ref.onUpdate;
+    this.setListener('StatusEvent', onStatusChanged);
+    this.setListener('UpdateEvent', onUpdate);
+  };
+
+  _proto.setListener = function setListener(eventName, callback) {
+    var _this = this;
+
+    if (callback === void 0) {
+      callback = function callback(t) {
+        return null;
+      };
+    }
+
+    this.subscriptions.push(this.eventEmitter.addListener(eventName, function (arg) {
+      return arg.alias === _this.alias ? callback(arg) : null;
+    }));
+  };
+
+  _proto.unsubscribe = function unsubscribe() {
+    this.subscriptions.forEach(function (subscription) {
+      subscription.remove();
+    });
+  };
+
   return Synchronizer;
 }();
 
 var makeSynchronizer = /*#__PURE__*/function () {
-  var _ref = _asyncToGenerator(function* (initializerConfig) {
-    yield snooze(0); // Hack to make typescript happy
-
-    return new Synchronizer(initializerConfig);
+  var _ref2 = _asyncToGenerator(function* (initializerConfig) {
+    var synchronizer = new Synchronizer(initializerConfig.alias, initializerConfig.networkName);
+    yield synchronizer.initialize(initializerConfig);
+    return synchronizer;
   });
 
-  return function makeSynchronizer(_x2) {
-    return _ref.apply(this, arguments);
+  return function makeSynchronizer(_x17) {
+    return _ref2.apply(this, arguments);
   };
 }();
 
+exports.AddressTool = AddressTool;
 exports.KeyTool = KeyTool;
 exports.makeSynchronizer = makeSynchronizer;
 //# sourceMappingURL=rnzcash.rn.js.map

package/lib/rnzcash.rn.js.map

@@ -1 +1 @@
-{"version":3,"file":"rnzcash.rn.js","sources":["../src/react-native.ts"],"sourcesContent":["import { NativeModules } from 'react-native'\n\nimport { InitializerConfig, WalletBalance } from './types'\n\nconst { RNZcash } = NativeModules\n\nconst snooze: Function = (ms: number) =>\n  new Promise((resolve: Function) => setTimeout(resolve, ms))\n\ntype Callback = (...args: any[]) => any\n\n// export function subscribeToFoo(callback: Callback): void {\n//   const eventEmitter = new NativeEventEmitter(RNZcash)\n//   eventEmitter.addListener('FooEvent', callback)\n// }\n\nexport const KeyTool = {\n  deriveViewKey: async (seedBytesHex: string): Promise<string> => {\n    const result = await RNZcash.deriveViewKey(seedBytesHex)\n    return result\n  }\n  // deriveSpendingKey: async (seedBytesHex: string): Promise<string> => {return ''}\n}\n// const makeAddressTool = () => {\n//   return {\n//     deriveShieldedAddress: async (viewingKey: string): Promise<string> => {return ''},\n//     deriveTransparentAddress: async (viewingKey: string): Promise<string> => {return ''},\n//     isValidShieldedAddress: async (address: string): Promise<boolean> => {return true},\n//     isValidTransparentAddress: async (address: string): Promise<boolean> => {return true}\n//   }\n// }\n//\n// interface WalletBalance {\n//   shieldedAvailable: string\n//   shieldedTotal: string\n//   transparentAvailable: string\n//   transparentTotal: string\n// }\n// interface InitializerCallbacks {\n//   onError: (e: Error): void\n//   onTransactionsChanged: (): void\n//   onBalanceChanged: (walletBalance: WalletBalance): void\n// }\n// interface SpendInfo {\n//   zatoshi: string\n//   toAddress: string\n//   memo: string\n//   fromAccountIndex: number\n//   spendingKey?: string\n// }\n\n// interface ZcashTransaction {\n//   txId: string\n//   fee: string\n//   value: string\n//   direction: 'inbound' | 'outbound'\n//   toAddress: string\n//   memo?: string\n//   minedHeight: number // 0 for unconfirmed\n//   blockTime: number // UNIX timestamp\n// }\n// type PendingTransaction = ZcashTransaction & {\n//   accountIndex: number\n//   expiryHeight: number\n//   cancelled: number\n//   submitAttemps: number\n//   errorMessage?: string\n//   errorCode?: number\n//   createTime: number\n// }\n\n// interface TransactionQuery {\n//   offset?: number\n//   limit?: number\n//   startDate?: number\n//   endDate?: number\n// }\nclass Synchronizer {\n  constructor(initializerConfig: InitializerConfig) {\n    console.log(initializerConfig)\n  }\n\n  // static init (initializerConfig: InitializerConfig): void\n  // setCallbackHandlers (callbacks: InitializerCallbacks): void\n  // getLatestHeight (): number\n  // getProgress (): number // 0-1\n  // getStatus (): ??\n  async getShieldedBalance(): Promise<WalletBalance> {\n    const result = await RNZcash.getShieldedBalance()\n    return result\n  }\n\n  async getTransparentBalance(): Promise<WalletBalance> {\n    await snooze(0) // Hack to make typescript happy\n    return {\n      availableBalance: '0',\n      totalBalance: '0'\n    }\n  }\n  // estimateFee (spendInfo: SpendInfo): string\n  // sendToAddress (spendInfo: SpendInfo): void\n  // start (): void\n  // stop (): void\n  // getPendingTransactions (): PendingTransactions[]\n  // getConfirmedTransactions (query: TransactionQuery): ZcashTransaction[]\n}\n\nexport const makeSynchronizer = async (\n  initializerConfig: InitializerConfig\n): Promise<Synchronizer> => {\n  await snooze(0) // Hack to make typescript happy\n  return new Synchronizer(initializerConfig)\n}\n"],"names":["RNZcash","NativeModules","snooze","ms","Promise","resolve","setTimeout","KeyTool","deriveViewKey","seedBytesHex","result","Synchronizer","initializerConfig","console","log","getShieldedBalance","getTransparentBalance","availableBalance","totalBalance","makeSynchronizer"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAIQA,UAAYC,0BAAZD;;AAER,IAAME,MAAgB,GAAG,SAAnBA,MAAmB,CAACC,EAAD;AAAA,SACvB,IAAIC,OAAJ,CAAY,UAACC,OAAD;AAAA,WAAuBC,UAAU,CAACD,OAAD,EAAUF,EAAV,CAAjC;AAAA,GAAZ,CADuB;AAAA,CAAzB;;AAKA;AACA;AACA;AACA;IAEaI,OAAO,GAAG;AACrBC,EAAAA,aAAa;AAAA,2CAAE,WAAOC,YAAP,EAAiD;AAC9D,UAAMC,MAAM,SAASV,OAAO,CAACQ,aAAR,CAAsBC,YAAtB,CAArB;AACA,aAAOC,MAAP;AACD,KAHY;;AAAA;AAAA;AAAA;;AAAA;AAAA,KADQ;;AAAA;AAQvB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAEA;AACA;AACA;AACA;AACA;AACA;;IACMC;AACJ,wBAAYC,iBAAZ,EAAkD;AAChDC,IAAAA,OAAO,CAACC,GAAR,CAAYF,iBAAZ;AACD;AAGD;AACA;AACA;AACA;;;;;SACMG;;;gDAAN,aAAmD;AACjD,UAAML,MAAM,SAASV,OAAO,CAACe,kBAAR,EAArB;AACA,aAAOL,MAAP;AACD;;;;;;;;;SAEKM;mDAAN,aAAsD;AACpD,YAAMd,MAAM,CAAC,CAAD,CAAZ,CADoD;;AAEpD,aAAO;AACLe,QAAAA,gBAAgB,EAAE,GADb;AAELC,QAAAA,YAAY,EAAE;AAFT,OAAP;AAID;;;;;;;;AAED;AACA;AACA;AACA;AACA;;;;;;IAGWC,gBAAgB;AAAA,+BAAG,WAC9BP,iBAD8B,EAEJ;AAC1B,UAAMV,MAAM,CAAC,CAAD,CAAZ,CAD0B;;AAE1B,WAAO,IAAIS,YAAJ,CAAiBC,iBAAjB,CAAP;AACD,GAL4B;;AAAA,kBAAhBO,gBAAgB;AAAA;AAAA;AAAA;;;;;"}
+{"version":3,"file":"rnzcash.rn.js","sources":["../src/types.ts","../src/react-native.ts"],"sourcesContent":["export type Network = 'mainnet' | 'testnet'\n\nexport interface WalletBalance {\n  availableZatoshi: string\n  totalZatoshi: string\n}\n\nexport interface InitializerConfig {\n  networkName: Network\n  defaultHost: string\n  defaultPort: number\n  fullViewingKey: UnifiedViewingKey\n  alias: string\n  birthdayHeight: number\n}\n\nexport interface SpendInfo {\n  zatoshi: string\n  toAddress: string\n  memo: string\n  fromAccountIndex: number\n  spendingKey?: string\n}\n\nexport interface TransactionQuery {\n  offset?: number\n  limit?: number\n  startDate?: number\n  endDate?: number\n}\n\nexport interface ZcashTransaction {\n  txId: string\n  accountIndex: number\n  fee: string\n  value: string\n  direction: 'inbound' | 'outbound'\n  toAddress: string\n  memo?: string\n  minedHeight: number // 0 for unconfirmed\n  blockTime: number // UNIX timestamp\n}\n\nexport type PendingTransaction = ZcashTransaction & {\n  expiryHeight: number\n  cancelled: number\n  submitAttempts: number\n  errorMessage?: string\n  errorCode?: number\n  createTime: number\n}\n\nexport enum SynchronizerStatus {\n  /** Indicates that [stop] has been called on this Synchronizer and it will no longer be used. */\n  STOPPED,\n  /** Indicates that this Synchronizer is disconnected from its lightwalletd server. When set, a UI element may want to turn red. */\n  DISCONNECTED,\n  /** Indicates that this Synchronizer is actively downloading new blocks from the server. */\n  DOWNLOADING,\n  /** Indicates that this Synchronizer is actively validating new blocks that were downloaded from the server. Blocks need to be verified before they are scanned. This confirms that each block is chain-sequential, thereby detecting missing blocks and reorgs. */\n  VALIDATING,\n  /** Indicates that this Synchronizer is actively decrypting new blocks that were downloaded from the server. */\n  SCANNING,\n  /** Indicates that this Synchronizer is actively enhancing newly scanned blocks with additional transaction details, fetched from the server. */\n  ENHANCING,\n  /** Indicates that this Synchronizer is fully up to date and ready for all wallet functions. When set, a UI element may want to turn green. In this state, the balance can be trusted. */\n  SYNCED\n}\n\nexport interface UnifiedViewingKey {\n  extfvk: string\n  extpub: string\n}\n\nexport interface UpdateEvent {\n  lastDownloadedHeight: number\n  lastScannedHeight: number\n  scanProgress: number // 0 - 100\n  networkBlockHeight: number\n}\n\nexport interface SynchronizerCallbacks {\n  onShieldedBalanceChanged(walletBalance: WalletBalance): void\n  onStatusChanged(status: SynchronizerStatus): void\n  onUpdate(event: UpdateEvent): void\n  onTransactionsChanged(count: number): void\n  onPendingTransactionUpdated(tx: PendingTransaction): void\n}\n\nexport interface BlockRange {\n  first: number\n  last: number\n}\n\nexport interface ConfirmedTransaction {\n  value: string\n  memo?: string\n  minedHeight: number\n  rawTransactionId: string\n  toAddress?: string\n}\n","import {\n  EventSubscription,\n  NativeEventEmitter,\n  NativeModules\n} from 'react-native'\n\nimport {\n  BlockRange,\n  ConfirmedTransaction,\n  InitializerConfig,\n  Network,\n  PendingTransaction,\n  SpendInfo,\n  SynchronizerCallbacks,\n  SynchronizerStatus,\n  UnifiedViewingKey,\n  WalletBalance\n} from './types'\n\nconst { RNZcash } = NativeModules\n\nconst snooze: Function = (ms: number) =>\n  new Promise((resolve: Function) => setTimeout(resolve, ms))\n\ntype Callback = (...args: any[]) => any\n\nexport const KeyTool = {\n  deriveViewingKey: async (\n    seedBytesHex: string,\n    network: Network\n  ): Promise<UnifiedViewingKey> => {\n    const result = await RNZcash.deriveViewingKey(seedBytesHex, network)\n    return result\n  },\n  deriveSpendingKey: async (\n    seedBytesHex: string,\n    network: Network\n  ): Promise<string> => {\n    const result = await RNZcash.deriveSpendingKey(seedBytesHex, network)\n    return result\n  }\n}\n\nexport const AddressTool = {\n  deriveShieldedAddress: async (\n    viewingKey: string,\n    network: Network\n  ): Promise<string> => {\n    const result = await RNZcash.deriveShieldedAddress(viewingKey, network)\n    return result\n  },\n  isValidShieldedAddress: async (\n    address: string,\n    network: Network = 'mainnet'\n  ): Promise<boolean> => {\n    const result = await RNZcash.isValidShieldedAddress(address, network)\n    return result\n  },\n  isValidTransparentAddress: async (\n    address: string,\n    network: Network = 'mainnet'\n  ): Promise<boolean> => {\n    const result = await RNZcash.isValidTransparentAddress(address, network)\n    return result\n  }\n}\n\nclass Synchronizer {\n  eventEmitter: NativeEventEmitter\n  subscriptions: EventSubscription[]\n  alias: string\n  network: Network\n\n  constructor(alias: string, network: Network) {\n    this.eventEmitter = new NativeEventEmitter(RNZcash)\n    this.subscriptions = []\n    this.alias = alias\n    this.network = network\n  }\n\n  /// ////////////////////////////////////////////////////////////////\n  // Start PoC behavior\n  //     Here are a few functions to demonstrate functionality but the final library should not have these functions\n  //\n  async readyToSend(): Promise<boolean> {\n    const result = await RNZcash.readyToSend()\n    return result\n  }\n\n  async sendTestTransaction(\n    key: string,\n    address: string\n  ): Promise<PendingTransaction> {\n    // send an amount that's guaranteed to be too large for our wallet and expect it to fail but at least show how this is done\n    // simply change these two values to send a real transaction but ensure the function isn't called too often (although funds can't be spent if notes are unconfirmed)\n    const invalidValue = '9223372036854775807' // Max long value (change this to 10000 to send a small transaction equal to the miner's fee on every reload and you could send 10,000 of those before it equals 1 ZEC)\n    const invalidAccount = 99 // should be 0\n    return this.sendToAddress({\n      zatoshi: invalidValue,\n      toAddress: address,\n      memo: 'this is a test transaction that will fail',\n      fromAccountIndex: invalidAccount,\n      spendingKey: key\n    })\n  }\n\n  async getBlockCount(): Promise<number> {\n    const result = await RNZcash.getBlockCount()\n    return result\n  }\n  // End PoC behavior\n  /// ////////////////////////////////////////////////////////////////\n\n  async start(): Promise<String> {\n    const result = await RNZcash.start(this.alias)\n    return result\n  }\n\n  async stop(): Promise<String> {\n    this.unsubscribe()\n    const result = await RNZcash.stop(this.alias)\n    return result\n  }\n\n  async initialize(initializerConfig: InitializerConfig): Promise<void> {\n    await RNZcash.initialize(\n      initializerConfig.fullViewingKey.extfvk,\n      initializerConfig.fullViewingKey.extpub,\n      initializerConfig.birthdayHeight,\n      initializerConfig.alias,\n      initializerConfig.networkName,\n      initializerConfig.defaultHost,\n      initializerConfig.defaultPort\n    )\n  }\n\n  async getLatestNetworkHeight(alias: string): Promise<number> {\n    const result = await RNZcash.getLatestNetworkHeight(alias)\n    return result\n  }\n\n  async getLatestScannedHeight(): Promise<number> {\n    const result = await RNZcash.getLatestScannedHeight()\n    return result\n  }\n\n  async getProgress(): Promise<number> {\n    const result = await RNZcash.getProgress()\n    return result\n  }\n\n  async getStatus(): Promise<SynchronizerStatus> {\n    const result = await RNZcash.getStatus()\n    return SynchronizerStatus[result.name as keyof typeof SynchronizerStatus]\n  }\n\n  async getShieldedBalance(): Promise<WalletBalance> {\n    const result = await RNZcash.getShieldedBalance(this.alias)\n    return result\n  }\n\n  async getTransparentBalance(): Promise<WalletBalance> {\n    // TODO: integrate with lightwalletd service to provide taddr balance. Edge probably doesn't need this, though so it can wait.\n\n    await snooze(0) // Hack to make typescript happy\n    return {\n      availableZatoshi: '0',\n      totalZatoshi: '0'\n    }\n  }\n\n  async getTransactions(range: BlockRange): Promise<ConfirmedTransaction[]> {\n    const result = await RNZcash.getTransactions(\n      this.alias,\n      range.first,\n      range.last\n    )\n    return result\n  }\n\n  rescan(height: number): void {\n    RNZcash.rescan(this.alias, height)\n  }\n\n  async sendToAddress(spendInfo: SpendInfo): Promise<PendingTransaction> {\n    const result = await RNZcash.spendToAddress(\n      this.alias,\n      spendInfo.zatoshi,\n      spendInfo.toAddress,\n      spendInfo.memo,\n      spendInfo.fromAccountIndex,\n      // TODO: ask is it okay to send this across the boundary or should it live on the native side and never leave?\n      spendInfo.spendingKey\n    )\n    return result\n  }\n\n  // estimateFee (spendInfo: SpendInfo): string\n  // sendToAddress (spendInfo: SpendInfo): void\n\n  // getPendingTransactions (): PendingTransactions[]\n  // getConfirmedTransactions (query: TransactionQuery): ZcashTransaction[]\n\n  // Events\n\n  subscribe({ onStatusChanged, onUpdate }: SynchronizerCallbacks): void {\n    this.setListener('StatusEvent', onStatusChanged)\n    this.setListener('UpdateEvent', onUpdate)\n  }\n\n  private setListener<T>(\n    eventName: string,\n    callback: Callback = (t: any) => null\n  ): void {\n    this.subscriptions.push(\n      this.eventEmitter.addListener(eventName, arg =>\n        arg.alias === this.alias ? callback(arg) : null\n      )\n    )\n  }\n\n  unsubscribe(): void {\n    this.subscriptions.forEach(subscription => {\n      subscription.remove()\n    })\n  }\n}\n\nexport const makeSynchronizer = async (\n  initializerConfig: InitializerConfig\n): Promise<Synchronizer> => {\n  const synchronizer = new Synchronizer(\n    initializerConfig.alias,\n    initializerConfig.networkName\n  )\n  await synchronizer.initialize(initializerConfig)\n  return synchronizer\n}\n"],"names":["SynchronizerStatus","RNZcash","NativeModules","snooze","ms","Promise","resolve","setTimeout","KeyTool","deriveViewingKey","seedBytesHex","network","result","deriveSpendingKey","AddressTool","deriveShieldedAddress","viewingKey","isValidShieldedAddress","address","isValidTransparentAddress","Synchronizer","alias","eventEmitter","NativeEventEmitter","subscriptions","readyToSend","sendTestTransaction","key","invalidValue","invalidAccount","sendToAddress","zatoshi","toAddress","memo","fromAccountIndex","spendingKey","getBlockCount","start","stop","unsubscribe","initialize","initializerConfig","fullViewingKey","extfvk","extpub","birthdayHeight","networkName","defaultHost","defaultPort","getLatestNetworkHeight","getLatestScannedHeight","getProgress","getStatus","name","getShieldedBalance","getTransparentBalance","availableZatoshi","totalZatoshi","getTransactions","range","first","last","rescan","height","spendInfo","spendToAddress","subscribe","onStatusChanged","onUpdate","setListener","eventName","callback","t","push","addListener","arg","forEach","subscription","remove","makeSynchronizer","synchronizer"],"mappings":"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"}

package/lib/src/react-native.d.ts

@@ -1,11 +1,38 @@
-import { InitializerConfig, WalletBalance } from './types';
+import { EventSubscription, NativeEventEmitter } from 'react-native';
+import { BlockRange, ConfirmedTransaction, InitializerConfig, Network, PendingTransaction, SpendInfo, SynchronizerCallbacks, SynchronizerStatus, UnifiedViewingKey, WalletBalance } from './types';
 export declare const KeyTool: {
-    deriveViewKey: (seedBytesHex: string) => Promise<string>;
+    deriveViewingKey: (seedBytesHex: string, network: Network) => Promise<UnifiedViewingKey>;
+    deriveSpendingKey: (seedBytesHex: string, network: Network) => Promise<string>;
+};
+export declare const AddressTool: {
+    deriveShieldedAddress: (viewingKey: string, network: Network) => Promise<string>;
+    isValidShieldedAddress: (address: string, network?: Network) => Promise<boolean>;
+    isValidTransparentAddress: (address: string, network?: Network) => Promise<boolean>;
 };
 declare class Synchronizer {
-    constructor(initializerConfig: InitializerConfig);
+    eventEmitter: NativeEventEmitter;
+    subscriptions: EventSubscription[];
+    alias: string;
+    network: Network;
+    constructor(alias: string, network: Network);
+    readyToSend(): Promise<boolean>;
+    sendTestTransaction(key: string, address: string): Promise<PendingTransaction>;
+    getBlockCount(): Promise<number>;
+    start(): Promise<String>;
+    stop(): Promise<String>;
+    initialize(initializerConfig: InitializerConfig): Promise<void>;
+    getLatestNetworkHeight(alias: string): Promise<number>;
+    getLatestScannedHeight(): Promise<number>;
+    getProgress(): Promise<number>;
+    getStatus(): Promise<SynchronizerStatus>;
     getShieldedBalance(): Promise<WalletBalance>;
     getTransparentBalance(): Promise<WalletBalance>;
+    getTransactions(range: BlockRange): Promise<ConfirmedTransaction[]>;
+    rescan(height: number): void;
+    sendToAddress(spendInfo: SpendInfo): Promise<PendingTransaction>;
+    subscribe({ onStatusChanged, onUpdate }: SynchronizerCallbacks): void;
+    private setListener;
+    unsubscribe(): void;
 }
 export declare const makeSynchronizer: (initializerConfig: InitializerConfig) => Promise<Synchronizer>;
 export {};

package/lib/src/types.d.ts

@@ -1,10 +1,89 @@
+export declare type Network = 'mainnet' | 'testnet';
 export interface WalletBalance {
-    availableBalance: string;
-    totalBalance: string;
+    availableZatoshi: string;
+    totalZatoshi: string;
 }
 export interface InitializerConfig {
-    host: string;
-    port: number;
-    fullViewingKey: string;
+    networkName: Network;
+    defaultHost: string;
+    defaultPort: number;
+    fullViewingKey: UnifiedViewingKey;
+    alias: string;
     birthdayHeight: number;
 }
+export interface SpendInfo {
+    zatoshi: string;
+    toAddress: string;
+    memo: string;
+    fromAccountIndex: number;
+    spendingKey?: string;
+}
+export interface TransactionQuery {
+    offset?: number;
+    limit?: number;
+    startDate?: number;
+    endDate?: number;
+}
+export interface ZcashTransaction {
+    txId: string;
+    accountIndex: number;
+    fee: string;
+    value: string;
+    direction: 'inbound' | 'outbound';
+    toAddress: string;
+    memo?: string;
+    minedHeight: number;
+    blockTime: number;
+}
+export declare type PendingTransaction = ZcashTransaction & {
+    expiryHeight: number;
+    cancelled: number;
+    submitAttempts: number;
+    errorMessage?: string;
+    errorCode?: number;
+    createTime: number;
+};
+export declare enum SynchronizerStatus {
+    /** Indicates that [stop] has been called on this Synchronizer and it will no longer be used. */
+    STOPPED = 0,
+    /** Indicates that this Synchronizer is disconnected from its lightwalletd server. When set, a UI element may want to turn red. */
+    DISCONNECTED = 1,
+    /** Indicates that this Synchronizer is actively downloading new blocks from the server. */
+    DOWNLOADING = 2,
+    /** Indicates that this Synchronizer is actively validating new blocks that were downloaded from the server. Blocks need to be verified before they are scanned. This confirms that each block is chain-sequential, thereby detecting missing blocks and reorgs. */
+    VALIDATING = 3,
+    /** Indicates that this Synchronizer is actively decrypting new blocks that were downloaded from the server. */
+    SCANNING = 4,
+    /** Indicates that this Synchronizer is actively enhancing newly scanned blocks with additional transaction details, fetched from the server. */
+    ENHANCING = 5,
+    /** Indicates that this Synchronizer is fully up to date and ready for all wallet functions. When set, a UI element may want to turn green. In this state, the balance can be trusted. */
+    SYNCED = 6
+}
+export interface UnifiedViewingKey {
+    extfvk: string;
+    extpub: string;
+}
+export interface UpdateEvent {
+    lastDownloadedHeight: number;
+    lastScannedHeight: number;
+    scanProgress: number;
+    networkBlockHeight: number;
+}
+export interface SynchronizerCallbacks {
+    onShieldedBalanceChanged(walletBalance: WalletBalance): void;
+    onStatusChanged(status: SynchronizerStatus): void;
+    onUpdate(event: UpdateEvent): void;
+    onTransactionsChanged(count: number): void;
+    onPendingTransactionUpdated(tx: PendingTransaction): void;
+}
+export interface BlockRange {
+    first: number;
+    last: number;
+}
+export interface ConfirmedTransaction {
+    value: string;
+    memo?: string;
+    minedHeight: number;
+    rawTransactionId: string;
+    toAddress?: string;
+}