Get Address

getAddress

Can be called to retreive a users BCH/SLP/BTC address.

The address returned by this method may not repreent all the funds in the users control, and calling the method multiple times could return different addresses, depending on the wallet provider.

Method Interface

function getAddress(GetAccountInput): Promise<GetAccountOutput>

Copy

Input arguments

interface GetAccountInput {
  protocol: string; // BCH/SLP/BTC or any future protocol
}

Copy

Success return value

interface GetAccountOutput {
  address: string; // Address for the given protocol
  label?: string; // A label the users has set to identify their wallet
}

Copy

Error return value

interface Error {
  type: string; // `NO_PROVIDER`|`CONNECTION_DENIED`
  description: string;
  data: string;
}

Copy

Client Call Example

import bitcoincomLink from 'bitcoincom-link';

bitcoincomLink.getAddress({
  protocol: 'BCH',
})
.then((data: GetAccountOutput) => {
  const {
    address,
    label,
  } = data;

  console.log('User address: ' + address);
  console.log('User address label (Optional): ' + label);
})
.catch(({type: string, description: string, data: any}) => {
  switch(type) {
    case NO_PROVIDER:
      console.log('No provider available.');
      break;
    case CANCELED:
      console.log('The user has canceled this request.');
      break;
    case PROTOCOL_ERROR:
      console.log('The provided protocol is not supported by this wallet.');
      break;
  }
});

Copy

Demo

Provider Request Handling

Depending on the account structure of the wallet, user handling may be different. In all cases, the wallet MUST return an address & protocol, or an error message. Each wallet may choose to provide back a default address in all cases, while others with multiple accounts and HD keys, may prompt a user to select an account from which to provide a new address.

Example

{
  address: 'bitcoincash:qrd9khmeg4nqag3h5gzu8vjt537pm7le85lcauzezc',
  label: 'My Spending Wallet'
}

Copy

Wallet Provider Support

Bitcoin.com Link

• Getting Started
• Get Address
• Send Assets
• Pay Invoice
• Create Token
• Get Wallet Status