@asigna/core-common

Common utilities and connectors for Asigna Bitcoin integration.

Description

This package contains shared components that were extracted from the external project vladpromotorov/appkit/packages/adapter/bitcoin/ to provide common functionality for Bitcoin wallet integration.

Installation

yarn add @asigna/core-common

Usage

AsignaConnector

import { AsignaConnector } from '@asigna/core-common';

const connector = new AsignaConnector();

// Connect to Asigna wallet
const connectionInfo = await connector.connect();

// Sign a message
const signature = await connector.signMessage({
  message: 'Hello, Bitcoin!',
  address: 'bc1...',
  protocol: 'ecdsa'
});

// Sign a PSBT
const signedPsbt = await connector.signPSBT({
  psbt: 'base64-encoded-psbt',
  signInputs: [{
    address: 'bc1...',
    index: 0,
    sighashTypes: [1]
  }],
  broadcast: false
});

// Send a transfer
const txId = await connector.sendTransfer({
  amount: '100000', // in satoshis
  recipient: 'bc1...'
});

AsignaUiHelper

import { AsignaUiHelper } from '@asigna/core-common';

// Create a signing modal
const { modal, updateProgress } = AsignaUiHelper.createSigningModal(
  'message', // or 'transaction'
  {
    message: 'Hello, Bitcoin!',
    threshold: 2,
    collectedSignaturesRef: { signatures: [] }
  },
  (result) => {
    console.log('Signing completed:', result);
  }
);

// Update progress
updateProgress(1, 2); // 1 signature collected out of 2 required

Development

Build

yarn build

Development mode

yarn dev

Structure

src/
├── connectors/
│   └── AsignaConnector.ts    # Bitcoin wallet connector
├── utils/
│   └── AsignaUiHelper.ts     # UI helper utilities
├── types.ts                  # Common type definitions
└── index.ts                  # Main export file

API Reference

AsignaConnector

Methods

• connect(): Connect to Asigna wallet
• disconnect(): Disconnect from wallet
• signMessage(params): Sign a message
• signPSBT(params): Sign a PSBT
• sendTransfer(params): Send a Bitcoin transfer
• broadcastPSBT(psbt): Broadcast a PSBT

AsignaUiHelper

Methods

• createSigningModal(mode, data, onApprove): Create a signing modal

Migration Notes

This package contains files that were moved from:

• vladpromotorov/appkit/packages/adapter/bitcoin/src/connectors/AsignaConnector.ts
• vladpromotorov/appkit/packages/adapter/bitcoin/src/utils/AsignaUiHelper

The original files should be updated to import from this package instead of containing the implementation directly.