send msg via v2 bot

[Evanfeenstra]

v2 bot can be used to send msg to hunters if they are on Sphinx

To send a simple text msg to a user, they need to be added first (key exchange must be completed). If the bot invited the user in the first place, then they may already be connected?

First, check if the user exists already:

• GET /contact/{pubkey}

// returns
export interface Contact {
  version: number;
  my_idx: number;
  pubkey: string;
  lsp: string;
  scid: number;
  contact_key?: string;
}

You must wait until the contact_key is defined, that means the user has signed on and key exchange has been completed

If user does exist:

• POST /send to send a msg

For simple text msg, set amt_msat=0, is_tribe=false. wait=true will wait until the msg succeeded before returning

// body:
interface PayBody {
  dest: string;
  amt_msat?: number;
  content?: string;
  is_tribe?: boolean;
  reply_uuid?: string;
  msg_type?: number;
  wait?: boolean;
}
// returns:
export interface SendOnionRes {
  status: SendOnionStatus; // "COMPLETE", "PENDING", or "FAILED"
  tag: string;
  preimage?: string;
  payment_hash?: string;
  message?: string; // this is the error message if status==FAILED
}

If user does not exist:

• POST /add_contact

interface AddContactBody {
  contact_info: string;
  alias?: string;
}

add_contact will send the key exchange request, then you can use get_contact again to check