humanfx-wallet-cli 0.1.0 → 0.2.0

package/dist/bin.js

@@ -5,6 +5,8 @@ import { runAddress } from './commands/address.js';
 import { runBalance } from './commands/balance.js';
 import { runSend } from './commands/send.js';
 import { runCall } from './commands/call.js';
+import { runAllowance } from './commands/allowance.js';
+import { runReceipt } from './commands/receipt.js';
 const USAGE = `hfx-wallet — local-custody HumanFX agentic wallet CLI
 
 The private key never leaves this machine and is never printed by any command — only addresses,
@@ -16,8 +18,10 @@ Usage:
   hfx-wallet import --from <file> [--force]        (file must contain the raw private key)
   hfx-wallet address
   hfx-wallet balance [--address <0x..>] [--token <0x..>]
+  hfx-wallet allowance --token <0x..> --spender <0x..> [--owner <0x..>]
   hfx-wallet send --to <0x..> --amount <decimal> [--token <0x..>]
   hfx-wallet call --calls <file.json>               ([{target, data, value?}, ...])
+  hfx-wallet receipt --tx <0x..> [--wait] [--timeout <ms>]
 `;
 async function main() {
     const [command, ...rest] = process.argv.slice(2);
@@ -40,6 +44,12 @@ async function main() {
         case 'call':
             await runCall(rest);
             return;
+        case 'allowance':
+            await runAllowance(rest);
+            return;
+        case 'receipt':
+            await runReceipt(rest);
+            return;
         default:
             console.error(USAGE);
             process.exit(command ? 1 : 0);

package/dist/commands/allowance.js

@@ -0,0 +1,56 @@
+import { formatUnits } from 'viem';
+import { getPublicClient } from '../chain-client.js';
+import { keystoreExists, loadKeystore } from '../keystore.js';
+import { parseFlags, requireFlag } from '../args.js';
+const ERC20_ALLOWANCE_ABI = [
+    {
+        type: 'function',
+        name: 'allowance',
+        stateMutability: 'view',
+        inputs: [
+            { name: 'owner', type: 'address' },
+            { name: 'spender', type: 'address' },
+        ],
+        outputs: [{ type: 'uint256' }],
+    },
+    {
+        type: 'function',
+        name: 'decimals',
+        stateMutability: 'view',
+        inputs: [],
+        outputs: [{ type: 'uint8' }],
+    },
+    {
+        type: 'function',
+        name: 'symbol',
+        stateMutability: 'view',
+        inputs: [],
+        outputs: [{ type: 'string' }],
+    },
+];
+export async function runAllowance(args) {
+    const flags = parseFlags(args);
+    const token = requireFlag(flags, 'token');
+    const spender = requireFlag(flags, 'spender');
+    const owner = (typeof flags.owner === 'string' ? flags.owner : loadKeystoreAddressOrThrow());
+    const client = getPublicClient();
+    const [raw, decimals, symbol] = await Promise.all([
+        client.readContract({
+            address: token,
+            abi: ERC20_ALLOWANCE_ABI,
+            functionName: 'allowance',
+            args: [owner, spender],
+        }),
+        client.readContract({ address: token, abi: ERC20_ALLOWANCE_ABI, functionName: 'decimals' }),
+        client
+            .readContract({ address: token, abi: ERC20_ALLOWANCE_ABI, functionName: 'symbol' })
+            .catch(() => ''),
+    ]);
+    console.log(`${formatUnits(raw, decimals)} ${symbol}`.trim());
+}
+function loadKeystoreAddressOrThrow() {
+    if (!keystoreExists()) {
+        throw new Error('No --owner given and no local wallet found — pass --owner <0x...> explicitly.');
+    }
+    return loadKeystore().address;
+}

package/dist/commands/receipt.js

@@ -0,0 +1,26 @@
+import { getPublicClient } from '../chain-client.js';
+import { parseFlags, requireFlag } from '../args.js';
+export async function runReceipt(args) {
+    const flags = parseFlags(args);
+    const hash = requireFlag(flags, 'tx');
+    const client = getPublicClient();
+    if (flags.wait) {
+        const timeout = typeof flags.timeout === 'string' ? Number(flags.timeout) : 60_000;
+        const receipt = await client.waitForTransactionReceipt({ hash, timeout });
+        printReceipt(receipt);
+        return;
+    }
+    const receipt = await client.getTransactionReceipt({ hash }).catch(() => null);
+    if (!receipt) {
+        console.log(JSON.stringify({ status: 'pending' }));
+        return;
+    }
+    printReceipt(receipt);
+}
+function printReceipt(receipt) {
+    console.log(JSON.stringify({
+        status: receipt.status,
+        block_number: receipt.blockNumber.toString(),
+        gas_used: receipt.gasUsed.toString(),
+    }));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "humanfx-wallet-cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Local-custody CLI for a HumanFX agentic wallet: generate/import a key that never leaves this machine, check balance, send tokens, execute arbitrary calldata. The private key never appears in any command's output — only addresses, balances, and tx hashes do.",
   "license": "UNLICENSED",
   "type": "module",