xyqon 0.2.0 → 0.3.0

package/README.md

@@ -67,6 +67,7 @@ xyqon send \
 ```
 
 The transaction is broadcast to reachable public nodes. A miner must include it in a block before the receiver sees the confirmed balance.
+The client checks the best reachable public chain before broadcasting and refuses sends that exceed the wallet's confirmed XYQON balance.
 
 ## Create And Send Coins
 
@@ -83,6 +84,7 @@ xyqon coin send \
 ```
 
 Coin creation and coin sends are signed 0 XYQON transactions. A miner must include them before the new coin or transfer appears on-chain.
+Before broadcasting a coin transfer, the client checks the best reachable public chain and refuses sends that exceed the wallet's confirmed coin balance.
 
 ## Mint And Send NFTs
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xyqon",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Friendly wallet CLI and JavaScript client for the XYQON network.",
   "keywords": [
     "xyqon",

package/src/cli.js

@@ -159,7 +159,8 @@ async function run() {
     console.log(`${color('bold', 'Amount:')} ${result.transaction.amount} XYQON`);
     console.log(`${color('bold', 'To:')} ${result.transaction.recipient}`);
     console.log(`${color('bold', 'Transaction ID:')} ${result.transactionId}`);
-    console.log(`${color('green', 'Broadcast:')} ${result.acceptedBy}/${result.peers.length} reachable nodes`);
+    console.log(`${color('dim', 'Checked balance:')} ${result.preflight.balance} XYQON at block ${result.preflight.blockHeight}`);
+    console.log(`${color('green', 'Delivered:')} ${result.acceptedBy}/${result.peers.length} reachable nodes`);
     console.log(color('yellow', 'The receiver balance updates after a miner includes this transaction in a block.'));
     return;
   }
@@ -217,7 +218,8 @@ async function run() {
     console.log(`${color('bold', 'Amount:')} ${result.transaction.asset_operation.TransferCoin.amount} ${result.transaction.asset_operation.TransferCoin.symbol}`);
     console.log(`${color('bold', 'To:')} ${result.transaction.recipient}`);
     console.log(`${color('bold', 'Transaction ID:')} ${result.transactionId}`);
-    console.log(`${color('green', 'Broadcast:')} ${result.acceptedBy}/${result.peers.length} reachable nodes`);
+    console.log(`${color('dim', 'Checked balance:')} ${result.preflight.balance} ${result.preflight.symbol} at block ${result.preflight.blockHeight}`);
+    console.log(`${color('green', 'Delivered:')} ${result.acceptedBy}/${result.peers.length} reachable nodes`);
     return;
   }
 

package/src/index.js

@@ -8,6 +8,7 @@ export const DEFAULT_PEERS = [
   '143.244.149.8:7101',
   '147.182.138.183:7101'
 ];
+const XYQON_EPSILON = 0.00000001;
 
 export const DEFAULT_WALLET_PATH = 'xyqon.wallet.json';
 
@@ -524,6 +525,48 @@ export async function getBalance(addressOrWallet, seedPeers = DEFAULT_PEERS) {
   };
 }
 
+export async function assertSpendableXyqonBalance(wallet, amount, seedPeers = DEFAULT_PEERS) {
+  const numericAmount = Number(amount);
+  const { chain, sourcePeer, peers } = await getBestChain(seedPeers);
+  const balances = calculateBalances(chain);
+  const balance = balances.get(wallet.public_key) ?? 0;
+
+  if (balance + XYQON_EPSILON < numericAmount) {
+    throw new Error(
+      `insufficient confirmed XYQON balance; balance is ${balance}, attempted to spend ${numericAmount}`
+    );
+  }
+
+  return {
+    balance,
+    blockHeight: chain.chain.at(-1)?.index ?? 0,
+    sourcePeer,
+    peers
+  };
+}
+
+export async function assertSpendableCoinBalance(wallet, symbol, amount, seedPeers = DEFAULT_PEERS) {
+  const normalizedSymbol = normalizeCoinSymbol(symbol);
+  const numericAmount = Number(amount);
+  const { chain, sourcePeer, peers } = await getBestChain(seedPeers);
+  const holding = listCoinHoldings(chain, wallet).find((coin) => coin.symbol === normalizedSymbol);
+  const balance = holding?.balance ?? 0;
+
+  if (balance + XYQON_EPSILON < numericAmount) {
+    throw new Error(
+      `insufficient confirmed ${normalizedSymbol} balance; balance is ${balance}, attempted to spend ${numericAmount}`
+    );
+  }
+
+  return {
+    symbol: normalizedSymbol,
+    balance,
+    blockHeight: chain.chain.at(-1)?.index ?? 0,
+    sourcePeer,
+    peers
+  };
+}
+
 export async function getCreatedCoins(addressOrWallet, seedPeers = DEFAULT_PEERS) {
   const { chain, sourcePeer, peers } = await getBestChain(seedPeers);
   return {
@@ -583,8 +626,10 @@ export async function broadcastTransaction(transaction, seedPeers = DEFAULT_PEER
 
 export async function sendTransaction({ wallet, recipient, amount, peers = DEFAULT_PEERS }) {
   const transaction = createSignedTransaction(wallet, recipient, amount);
+  const preflight = await assertSpendableXyqonBalance(wallet, transaction.amount, peers);
   return {
     transaction,
+    preflight,
     ...(await broadcastTransaction(transaction, peers))
   };
 }
@@ -599,8 +644,15 @@ export async function createCoin({ wallet, symbol, name, supply, peers = DEFAULT
 
 export async function sendCoin({ wallet, recipient, symbol, amount, peers = DEFAULT_PEERS }) {
   const transaction = createCoinTransferTransaction(wallet, { recipient, symbol, amount });
+  const preflight = await assertSpendableCoinBalance(
+    wallet,
+    transaction.asset_operation.TransferCoin.symbol,
+    transaction.asset_operation.TransferCoin.amount,
+    peers
+  );
   return {
     transaction,
+    preflight,
     ...(await broadcastTransaction(transaction, peers))
   };
 }