Payments and actions

npm install @bsv/sdk

import { WalletClient } from '@bsv/sdk';

// Finds the user's local wallet, including the HandCash Desktop bridge.
const wallet = new WalletClient('auto');

const { authenticated } = await wallet.isAuthenticated();

if (!authenticated) {
  // Opens the connection prompt in HandCash.
  await wallet.waitForAuthentication();
}

const response = await fetch('http://127.0.0.1:3321/getBalance', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', originator: location.host },
  body: '{}'
});

const { satoshis } = await response.json();

const funding = await wallet.listOutputs({ basket: 'default', limit: 1000 });

const satoshis = funding.outputs.reduce((total, output) => total + output.satoshis, 0);

import { P2PKH, WalletClient } from '@bsv/sdk';

const wallet = new WalletClient('auto');

const { txid } = await wallet.createAction({
  description: 'Coffee order 7842',
  labels: ['coffee-order'],
  outputs: [
    {
      lockingScript: new P2PKH().lock(recipientAddress).toHex(),
      satoshis: 25_000,
      outputDescription: 'Coffee order'
    }
  ]
});

const staged = await wallet.createAction({
  description: 'Claim contract payout',
  inputs: [
    {
      outpoint: contractOutpoint,
      inputDescription: 'Game contract',
      unlockingScriptLength: 108
    }
  ],
  outputs: [
    {
      lockingScript: nextContractLockingScript,
      satoshis: 5_000,
      outputDescription: 'Next contract state'
    }
  ],
  options: { signAndProcess: false }
});

const { reference } = staged.signableTransaction!;

const { txid } = await wallet.signAction({
  reference,
  spends: {
    0: { unlockingScript: contractUnlockingScript }
  }
});

await wallet.abortAction({ reference });

const { accepted } = await wallet.internalizeAction({
  tx: atomicBeef,
  description: 'Tournament prize',
  labels: ['tournament-payout'],
  outputs: [
    {
      outputIndex: 0,
      protocol: 'wallet payment',
      paymentRemittance: {
        derivationPrefix,
        derivationSuffix,
        senderIdentityKey
      }
    }
  ]
});

const history = await wallet.listActions({
  labels: ['coffee-order'],
  labelQueryMode: 'all',
  includeLabels: true,
  includeOutputs: true,
  limit: 25,
  offset: 0
});

console.log(`${history.totalActions} matching actions`);

try {
  await wallet.createAction(action);
} catch (error) {
  // WALLET_LOCKED, NOT_AUTHENTICATED, PERMISSION_DENIED, ACTION_DENIED,
  // INSUFFICIENT_FUNDS, OFFLINE_PAYMENTS_DISABLED
  console.error(error);
}