Broadcast to a Node

Pre-Req: You have the body variable with a valid signature (see prior pages).

Simulating

A good practice to have is to simulate the transaction before you actually broadcast and update the fee from the transaction context with up to date values.

To do this, you can use

https://api.bitbadges.io/api/v0/simulate

or

http://URL:1317/cosmos/tx/v1beta1/simulate

This will return the gas used on a dry run of the transaction and any errors if it finds any. You can leave all signature fields empty because simulations do not check any signatures.

Note this tutorial is slightly out of order for clarity, the simulation step should typically be done before the user signs, so they only have to sign the final Msg with the up to date gas.

Once simulated, replace the expected gas you want in the transaction context.

export interface SimulateTxRouteSuccessResponse<T extends NumberType> {
    gas_info: {
        gas_used: string;
        gas_wanted: string;
    };
    result: {
        data: string;
        log: string;
        events: {
            type: string;
            attributes: {
                key: string;
                value: string;
                index: boolean;
            }[];
        }[];
        msg_responses: any[];
    };
}

Broadcasting

You can replace the URL below with any valid BitBadges blockchain node.

`http://URL:1317${generateEndpointBroadcast()}`

Or, you can use the BitBadges API to broadcast.

https://api.bitbadges.io/api/v0/broadcast

await BitBadgesApi.broadcastTx(body);

This will give you a response immediately. You should then use the tx_response.txhash to view it on an explorer, query the blockchain directly, see if it had errors, and so on. The response code should be 0 for a successful transaction. We refer you to Cosmos docs for more information about each indivdual item.

export interface BroadcastTxRouteSuccessResponse<T extends NumberType> {
    tx_response: {
        code: number;
        codespace: string;
        data: string;
        events: {
            type: string;
            attributes: {
                key: string;
                value: string;
                index: boolean;
            }[];
        }[];
        gas_wanted: string;
        gas_used: string;
        height: string;
        info: string;
        logs: {
            events: {
                type: string;
                attributes: {
                    key: string;
                    value: string;
                    index: boolean;
                }[];
            }[];
        }[];
        raw_log: string;
        timestamp: string;
        tx: object | null;
        txhash: string;
    };
}

Polling

Once you have the tx hash, you can poll a node until the transaction is confirmed like below. Note this is a blockchain REST API_URL, not the BitBadges API. You can also view it on explorers.

Use http://node.bitbadges.io:1317 or one of the aliases below for the BitBadges maintained node.

http://134.122.12.165:1317

https://node.bitbadges.io/api

const txHash = res.data.tx_response.txhash;
const code = res.data.tx_response.code;
if (code !== undefined && code !== 0) {
  throw new Error(`Error broadcasting transaction: Code ${code}: ${JSON.stringify(res.data.tx_response, null, 2)}`);
}

let fetched = false;
while (!fetched) {
  try {
    const res = await axios.get(`${process.env.API_URL}/cosmos/tx/v1beta1/txs/${txHash}`);
    fetched = true;

    return res;
  } catch (e) {
    // wait 1 sec
    console.log('Waiting 1 sec to fetch tx');
    await new Promise((resolve) => setTimeout(resolve, 1000));
  }
}

return res;