Merge branch 'master' of github.com:harmony-one/sdk

examples/balance.js

@@ -0,0 +1,31 @@
+const { Harmony } = require('@harmony-js/core');
+
+// import or require settings
+const { ChainID, ChainType } = require('@harmony-js/utils');
+
+const URL_TESTNET = `https://api.s0.b.hmny.io`;
+const URL_MAINNET = `https://api.s0.t.hmny.io`;
+
+// 1. initialize the Harmony instance
+
+const harmony = new Harmony(
+  // rpc url
+  URL_TESTNET,
+  {
+    // chainType set to Harmony
+    chainType: ChainType.Harmony,
+    // chainType set to HmyLocal
+    chainId: ChainID.HmyTestnet,
+  },
+);
+
+harmony.blockchain
+  .getBalance({
+    address: `one1vjywuur8ckddmc4dsyx6qdgf590eu07ag9fg4a`,
+  })
+  .then((res) => {
+    console.log(new harmony.utils.Unit(res.result).asWei().toEther());
+  })
+  .catch((err) => {
+    console.log(err);
+  });

examples/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "example",
+  "version": "1.0.0",
+  "description": "",
+  "main": "test.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "@harmony-js/core": "^0.1.32"
+  }
+}

examples/staking_test.js

@@ -0,0 +1,75 @@
+const { Harmony } = require('@harmony-js/core');
+const { ChainID, ChainType } = require('@harmony-js/utils');
+const {
+  StakingTransaction,
+  CreateValidator,
+  Delegate,
+  Undelegate,
+  CollectRewards,
+} = require('@harmony-js/staking');
+
+const createMsg = CreateValidator({
+  validatorAddress: 'one1a0x3d6xpmr6f8wsyaxd9v36pytvp48zckswvv9',
+  description: {
+    name: 'Alice',
+    identity: 'alice',
+    website: 'alice.harmony.one',
+    securityContact: 'Bob',
+    details: "Don't mess with me!!!",
+  },
+  commissionRates: {
+    rate: '0.1',
+    maxRate: '0.9',
+    maxChangeRate: '0.05',
+  },
+  minSelfDelegation: '0xa',
+  maxTotalDelegation: '0x0bb8',
+  slotPubKeys: [
+    '0xb9486167ab9087ab818dc4ce026edb5bf216863364c32e42df2af03c5ced1ad181e7d12f0e6dd5307a73b62247608611',
+  ],
+  amount: '0x64',
+});
+
+const stakingTxn = StakingTransaction({
+  directive: '0x',
+  stakeMsg: createMsg,
+  nonce: '0x2',
+  gasPrice: '0x',
+  gasLimit: '0x64',
+  chainId: 0,
+  from: 'one1a0x3d6xpmr6f8wsyaxd9v36pytvp48zckswvv9',
+});
+
+stakingTxn
+  .sendTransaction()
+  .then((stakingTxn, res) => {
+    console.log(res);
+  })
+  .catch((err) => {
+    console.log(err);
+  });
+
+//   const delegateMsg = Delegate({
+//     delegatorAddress: 'one1a0x3d6xpmr6f8wsyaxd9v36pytvp48zckswvv9',
+//     validatorAddress: 'one1a0x3d6xpmr6f8wsyaxd9v36pytvp48zckswvv9',
+//     amount: '0xa',
+//   });
+
+//   const stakingTxn = StakingTransaction({
+//     directive: '0x2',
+//     stakeMsg: delegateMsg,
+//     nonce: '0x2',
+//     gasPrice: '0x',
+//     gasLimit: '0x64',
+//     chainId: 0,
+//     from: 'one1a0x3d6xpmr6f8wsyaxd9v36pytvp48zckswvv9',
+//   });
+
+//   stakingTxn
+//     .sendTransaction()
+//     .then((stakingTxn, res) => {
+//       console.log(res);
+//     })
+//     .catch((err) => {
+//       console.log(err);
+//     });

examples/test.js

@@ -0,0 +1,31 @@
+const { Harmony } = require('@harmony-js/core');
+const { ChainID, ChainType } = require('@harmony-js/utils');
+const { encryptPhrase, decryptPhrase } = require('@harmony-js/crypto');
+
+const harmony = new Harmony('http://localhost:9500', { chainId: 2, chainType: 'hmy' });
+const myPhrase = harmony.wallet.newMnemonic();
+const pwd = '1234';
+
+async function encryptThePhrase(phrase, pass) {
+  const result = await encryptPhrase(phrase, pass);
+  return result;
+}
+
+async function decryptThePhrase(keystore, pass) {
+  const result = await decryptPhrase(keystore, pass);
+  return result;
+}
+
+async function phraseKeyStore() {
+  const keyStore = await encryptThePhrase(myPhrase, pwd);
+  const recoveredPhrase = await decryptThePhrase(JSON.parse(keyStore), pwd);
+  return { myPhrase, keyStore, recoveredPhrase };
+}
+
+phraseKeyStore().then((result) => {
+  const { myPhrase, keyStore, recoveredPhrase } = result;
+
+  harmony.wallet.addByMnemonic(myPhrase);
+  console.log({ myPhrase, keyStore, recoveredPhrase });
+  console.log(harmony.wallet);
+});

examples/test2.js

@@ -0,0 +1,40 @@
+const { Harmony } = require('@harmony-js/core');
+const { ChainID, ChainType } = require('@harmony-js/utils');
+const {
+  randomBytes,
+  generatePrivateKey,
+  getAddress,
+  getAddressFromPrivateKey,
+  encryptPhrase,
+  decryptPhrase,
+} = require('@harmony-js/crypto');
+
+const harmony = new Harmony('http://localhost:9500', { chainId: 2, chainType: 'hmy' });
+const myPhrase = harmony.wallet.newMnemonic();
+const pwd = '1234';
+
+async function encryptThePhrase(phrase, pass) {
+  const result = await encryptPhrase(phrase, pass);
+  return result;
+}
+
+async function decryptThePhrase(keystore, pass) {
+  const result = await decryptPhrase(keystore, pass);
+  return result;
+}
+
+async function phraseKeyStore() {
+  const keyStore = await encryptThePhrase(myPhrase, pwd);
+  const recoveredPhrase = await decryptThePhrase(JSON.parse(keyStore), pwd);
+  return { myPhrase, keyStore, recoveredPhrase };
+}
+
+phraseKeyStore().then((result) => {
+  const { myPhrase, keyStore, recoveredPhrase } = result;
+
+  const anotherPhrase = 'wall public vague under poem acid jaguar describe net scene sponsor neck';
+  harmony.wallet.addByMnemonic(myPhrase);
+  harmony.wallet.addByMnemonic(anotherPhrase);
+  console.log({ myPhrase, keyStore, recoveredPhrase });
+  console.log(harmony.wallet);
+});

examples/transfer.js

@@ -0,0 +1,133 @@
+// import or require Harmony class
+const { Harmony } = require('@harmony-js/core');
+
+// import or require settings
+const { ChainID, ChainType } = require('@harmony-js/utils');
+
+const URL_TESTNET = `https://api.s0.b.hmny.io`;
+const URL_MAINNET = `https://api.s0.t.hmny.io`;
+
+// 1. initialize the Harmony instance
+
+const harmony = new Harmony(
+  // rpc url
+  URL_TESTNET,
+  {
+    // chainType set to Harmony
+    chainType: ChainType.Harmony,
+    // chainType set to HmyLocal
+    chainId: ChainID.HmyTestnet,
+  },
+);
+
+// 2. get wallet ready
+// one18n8e7472pg5fqvcfcr5hg0npquha24wsxmjheg
+const phrase = 'genius cable radar memory high catch blossom correct middle wish gentle fiscal';
+
+// one1a2rhuaqjcvfu69met9sque2l3w5v9z6qcdcz65
+// surge welcome lion goose gate consider taste injury health march debris kick
+
+// add privateKey to wallet
+const sender = harmony.wallet.addByMnemonic(phrase);
+
+// 3. get sharding info
+async function setSharding() {
+  // Harmony is a sharded blockchain, each endpoint have sharding structure,
+  // However sharding structure is different between mainnet, testnet and local testnet
+  // We need to get sharding info before doing cross-shard transaction
+  const res = await harmony.blockchain.getShardingStructure();
+  harmony.shardingStructures(res.result);
+}
+
+// 4. get transaction payload ready
+
+async function transfer(receiver) {
+  // run set sharding first, if you want to make a cross-shard transaction
+  await setSharding();
+
+  //1e18
+  const txn = harmony.transactions.newTx({
+    //  token send to
+    to: receiver,
+    // amount to send
+    value: '1000000000000000000',
+    // gas limit, you can use string
+    gasLimit: '210000',
+    // send token from shardID
+    shardID: 0,
+    // send token to toShardID
+    toShardID: 0,
+    // gas Price, you can use Unit class, and use Gwei, then remember to use toWei(), which will be transformed to BN
+    gasPrice: new harmony.utils.Unit('100').asGwei().toWei(),
+  });
+
+  // sign the transaction use wallet;
+
+  // This will happen at the chrome extension.
+  const signedTxn = await harmony.wallet.signTransaction(txn);
+
+  // Now you can use `Transaction.observed()` to listen events
+
+  // Frontend received back the signedTxn and do the followings to Send transaction.
+  signedTxn
+    .observed()
+    .on('transactionHash', (txnHash) => {
+      console.log('');
+      console.log('--- hash ---');
+      console.log('');
+      console.log(txnHash);
+      console.log('');
+    })
+    .on('receipt', (receipt) => {
+      console.log('');
+      console.log('--- receipt ---');
+      console.log('');
+      console.log(receipt);
+      console.log('');
+    })
+    .on('cxReceipt', (receipt) => {
+      console.log('');
+      console.log('--- cxReceipt ---');
+      console.log('');
+      console.log(receipt);
+      console.log('');
+    })
+    .on('error', (error) => {
+      console.log('');
+      console.log('--- error ---');
+      console.log('');
+      console.log(error);
+      console.log('');
+    });
+
+  // send the txn, get [Transaction, transactionHash] as result
+
+  const [sentTxn, txnHash] = await signedTxn.sendTransaction();
+
+  // to confirm the result if it is already there
+
+  const confiremdTxn = await sentTxn.confirm(txnHash);
+
+  // if the transactino is cross-shard transaction
+  if (!confiremdTxn.isCrossShard()) {
+    if (confiremdTxn.isConfirmed()) {
+      console.log('--- Result ---');
+      console.log('');
+      console.log('Normal transaction');
+      console.log(`${txnHash} is confirmed`);
+      console.log('');
+      process.exit();
+    }
+  }
+  if (confiremdTxn.isConfirmed() && confiremdTxn.isCxConfirmed()) {
+    console.log('--- Result ---');
+    console.log('');
+    console.log('Cross-Shard transaction');
+    console.log(`${txnHash} is confirmed`);
+    console.log('');
+    process.exit();
+  }
+}
+
+// sending from one18n8e7472pg5fqvcfcr5hg0npquha24wsxmjheg to  one1a2rhuaqjcvfu69met9sque2l3w5v9z6qcdcz65
+transfer('one1a2rhuaqjcvfu69met9sque2l3w5v9z6qcdcz65');