Transactions

This document explains how to influence the blockchain’s state by broadcasting transactions.

Transactions include:

• a list of messages
• an optional memo
• a fee
• a signature from a key

The messages included in a transaction contain the information that will be routed to a proper message handler in the node, which in turn parses the inputs and determines the next state of the blockchain.

Create Transactions #

Create a Signer #

You will first want to create a signer which you can use to sign transactions.

const queryClient = await createCosmosQueryClient("https://cube-rpc.xpla.io");
const mnemonic = "abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about";
const wallet = await EthSecp256k1HDWallet.fromMnemonic(mnemonic, {
    derivations: [{
        prefix: "xpla",
        hdPath: HDPath.eth().toString()
    }]
})

const baseSignConfig = {
    queryClient: queryClient,
    chainId: "cube_47-5",
    addressPrefix: "xpla",
}
const signerConfig = {
    ...DEFAULT_COSMOS_EVM_SIGNER_CONFIG,
    ...baseSignConfig
}

const signer = new DirectSigner(wallet, signerConfig);

Create Messages #

import { MessageComposer } from "@xpla/xplajs/cosmos/bank/v1beta1/tx.registry";
import { MsgSend } from "@xpla/xplajs/cosmos/bank/v1beta1/tx";

const msgSend = MsgSend.fromPartial({
    fromAddress: await signer.getAddress(),
    toAddress: "xpla1888g76xr3phk7qkfknnn8hvxyzfj0e2vuh4jmw",
    amount: [{denom: "axpla", amount: "1000000000000000000"}]
})
const { send } = MessageComposer.fromPartial;
const msg = await send(msgSend);

Create and Sign Transaction #

const {tx} = await signer.sign({messages: [msg]})

Broadcast Transaction #

const res = await signer.broadcast(tx)

The default broadcast mode is block, which waits until the transaction has been included in a block. This will give you the most information about the transaction, including events and errors while processing.

You can also use sync or async broadcast modes.

Sync #

const res = await signer.broadcast(tx, {checkTx: true})

async #

const res = await signer.broadcast(tx, {checkTx: false})

block #

const res = await signer.broadcast(tx, {checkTx: true, deliverTx: true})

Check Events #

If you broadcasted the transaction with block, you can get the events emitted by your transaction.

const res = await signer.broadcast(tx, {checkTx: true, deliverTx: true})
console.log(res.events.find(e => e.type === "transfer"))