dcp-client 5.1.11 → 5.3.0

package/bin/dcp-bank

@@ -0,0 +1,269 @@
+#! /usr/bin/env node
+/**
+ * @file     dcp-bank - command-line utility for working with the DCP bank
+ * @author   Wes Garland, wes@distributive.network
+ * @date     Dec 2025
+ */
+'use strict';
+const fs = require('fs');
+
+process.exitCode = 3;
+require('../index').init().then(main).catch(reportError);
+
+function usage()
+{
+  console.log(`
+DCP Bank Utility. Copyright (c) 2025 Distributive Corp.
+Released under the terms of the MIT License.
+
+Usage:
+  dcp-bank transfer <amount> [--from=] <--to=>
+  dcp-bank balance [--from=]
+Where:
+  amount   is the number of Distributive Compute Credits to transfer
+  --to     specifies the bank account in which to deposit funds. The account may
+           be specified by address, wallet label, keystore JSON, or keystore
+           filename.
+  --from   specifies the bank account from which to withdraw funds. The account
+           may be specified by private key, wallet label, keystore, or keystore 
+           filename.
+`);
+  process.exit();
+}
+
+function userError(...args)
+{
+  console.error(...args);
+  process.exit(2);
+}
+
+function reportError(error)
+{
+  console.error(error.message + (error.code ? ` (${error.code})` : ''));
+}
+
+async function argAddress(optarg)
+{
+  const wallet = require('dcp/wallet');
+  const utils  = require('dcp/utils');
+
+  try
+  {
+    return { address: new wallet.Address(optarg) };
+  }
+  catch(error){} // eslint-disable-line
+
+  try
+  {
+    const pk = new wallet.PrivateKey(optarg);
+    return { address: pk.address };
+  }
+  catch(error){} // eslint-disable-line
+
+  try
+  {
+    const ks = JSON.parse(optarg);
+    if (typeof ks === 'object')
+      return { address: ks.address, label: ks.label };
+  }
+  catch(error){} // eslint-disable-line
+
+  try
+  {
+    const ks = await wallet.get(optarg);
+    if (typeof ks === 'object')
+      return { address: ks.address, label: ks.label };
+  }
+  catch(error){} // eslint-disable-line
+
+  try
+  {
+    const ks = JSON.parse(fs.readFileSync(utils.expandPath(optarg), 'utf-8'));
+    if (typeof ks === 'object')
+      return { address: ks.address, label: ks.label };
+  }
+  catch(error){} // eslint-disable-line
+
+  userError('invalid address specifier:', optarg);
+}
+
+async function argPrivateKey(optarg)
+{
+  const wallet = require('dcp/wallet');
+  const utils  = require('dcp/utils');
+
+  try
+  {
+    return { key: new wallet.PrivateKey(optarg) };
+  }
+  catch(error){} // eslint-disable-line
+
+  try
+  {
+    const ks = JSON.parse(optarg);
+    if (typeof ks === 'object')
+    {
+      const keystore = await (new wallet.BankAccountKeystore(optarg));
+      return { key: await keystore.getPrivateKey(), label: keystore.label };
+    }
+  }
+  catch(error){} // eslint-disable-line
+
+  try
+  {
+    const ks = await wallet.get(optarg);
+    if (typeof ks === 'object')
+      return { key: await ks.getPrivateKey(), label: ks.label };
+  }
+  catch(error){} // eslint-disable-line
+
+  try
+  {
+    const ks = JSON.parse(fs.readFileSync(utils.expandPath(optarg), 'utf-8'));
+    if (typeof ks === 'object')
+    {
+      const keystore = await (new wallet.BankAccountKeystore(ks, ''));
+      return { key: await keystore.getPrivateKey(), label: keystore.label };
+    }
+  }
+  catch(error){} // eslint-disable-line
+
+  userError('invalid address specifier:', optarg);
+}
+
+function short(address)
+{
+  return String(address).slice(0, 10);
+}
+
+function fmtLabel(label)
+{
+  if (!label)
+    return '';
+
+  return `[${label}] `;
+}
+
+async function main()
+{
+  const { Connection } = require('dcp/protocol');
+
+  var toLabel, fromLabel, toAccount, fromKey, amount, req;
+  var successHandler = () => console.log('success');
+  const argv = process.argv.slice(2);
+  const mode = argv.shift();
+
+  switch (mode)
+  {
+    case '-h': case '--help':
+    case undefined:
+      usage();
+      break;
+    case 'transfer':
+      amount = argv.shift();
+      break;
+    case 'balance':
+      break;
+    default:
+      userError('invalid mode:', mode);
+      break;
+  }
+
+  for (let { option, optarg } of
+       require('../lib/getopt').parse(argv, 'h(help)t:(to)f:(from)'))
+  {
+    switch (option)
+    {
+      case 'h':
+        usage();
+        break;
+      default:
+        throw new Error(`defined but unspecified option: -${option}` + (optarg ? `=${optarg}` : ''));
+      case '?':
+        process.exit(1);
+        break;
+      case 't':
+      {
+        const ret = await argAddress(optarg);
+        toLabel   = ret.label;
+        toAccount = ret.address;
+        break;
+      }
+      case 'f':
+      {
+        const ret = await argPrivateKey(optarg);
+        fromLabel = ret.label;
+        fromKey   = ret.key || false; /* ensure from is never undefined when --from */
+        break;
+      }
+    }
+  }
+  
+  if (typeof fromKey === 'undefined') /* no --from */
+  {
+    const ks = await require('dcp/wallet').get('default');
+    fromKey = await ks.getPrivateKey();
+    fromLabel = ks.label;
+  }
+  
+  toLabel   = fmtLabel(toLabel);
+  fromLabel = fmtLabel(fromLabel);
+
+  const bankTeller = new Connection(dcpConfig.bank.services.bankTeller);
+  try
+  {
+    switch(mode)
+    {
+      case 'balance':
+      {
+        if (!fromKey)
+          userError('missing balance check from account key');
+
+        req = new bankTeller.Request('viewAccounts', {
+          address: [fromKey.address]
+        });
+        await req.authorize(fromKey.address, fromKey);
+        successHandler = (res) => {
+          console.log(`Balance of ${fromLabel}${short(fromKey.address)} is ${res.payload.accounts[0].balance}\u2287`);
+        };
+        break;
+      }
+      case 'transfer':
+      {
+        const bnAmount = require('dcp/internal/bignumber.js')(amount);
+        if (isNaN(bnAmount))
+          userError(`invalid amount '${amount}'`);
+        if (!toAccount)
+          userError('missing transfer to account address');
+        if (!fromKey)
+          userError('missing transfer from account key');
+        process.stdout.write(`Transfering ${amount}\u2287 from ${fromLabel}${short(fromKey.address)} to ${toLabel}${short(toAccount)}...`);
+        req = new bankTeller.Request('transfer@1', { toAccount, amount,
+                                                     fromAccount: fromKey.address, /* remove this property after DCP MR-3143 on bank */
+                                                   });
+        await req.authorize(fromKey);
+        break;
+      }
+    }
+    const res = await req.send();
+    if (res.success === true)
+    {
+      successHandler(res);
+      process.exitCode = 0;
+    }
+    else
+    {
+      console.error(JSON.stringify(res.payload));
+      console.error('FAIL');
+      if (res.payload.message)
+        reportError(res.payload);
+      else
+        console.error(res);
+      process.exitCode = 4;
+    }
+  }
+  finally
+  {
+    bankTeller.close();
+  }
+}

package/build/bundle

@@ -174,7 +174,7 @@ fi
 NO_LOG=1 \
 SKIP_SUDO_CHECK=1 \
 DCP_LOCAL_CONFIG_EXTRAS="${BUNDLE_TMP}/local-config.incl" \
-  "${DCP_SRC}/install.sh" -NI ${DCP_INSTALL_FLAGS} autogen-schemas build-dcp-client
+  "${DCP_SRC}/install.sh" -N ${DCP_INSTALL_FLAGS} build-dcp-client
 
 EXIT_CODE="$?"
 if [ "$EXIT_CODE" != "0" ]; then