search
HomeGithub
githubEdit

Dispatch Transaction

Wander Injected API dispatch() function

The dispatch() function allows you to quickly sign and send a transaction to the network in a bundled format. It is best for smaller datas and contract interactions. If the bundled transaction cannot be submitted, it will fall back to a base layer transaction. The function returns the result of the API call.

Argument
Type
Description

transaction

Transactionarrow-up-right

A valid Arweave transaction instance (without a keyfile)

options?

SignatureOptionsarrow-up-right

Arweave transaction signature options

circle-info

Note: This function requires the DISPATCH permission.

circle-info

Note: The options argument is optional, if it is not provided, the extension will use the default signature options (default salt length) to sign the transaction.

circle-exclamation

Note: If you are trying to sign a larger piece of data (5 MB <), make sure to notify the user to not switch / close the browser tab. Larger transactions are split into chunks in the background and will take longer to sign.

circle-exclamation

Note: The function uses the default bundler node set by the user or the extension. Consider using the signDataItem() function to submit data to a custom bundler.

hashtag
Dispatch result

The dispatch() function returns the result of the operation, including the ID of the submitted transaction, as well as if it was submitted in a bundle or on the base layer.

export interface DispatchResult {
  id: string;
  type?: "BASE" | "BUNDLED";
}

hashtag
Example usage

import Arweave from "arweave";

// create arweave client
const arweave = new Arweave({
  host: "ar-io.net",
  port: 443,
  protocol: "https"
});

// connect to the extension
await window.arweaveWallet.connect(["DISPATCH"]);

// create a transaction
const transaction = await arweave.createTransaction({
  data: '<html><head><meta charset="UTF-8"><title>Hello permanent world! This was signed via Wander!!!</title></head><body></body></html>'
});

// dispatch the tx
const res = await window.arweaveWallet.dispatch(transaction);

console.log(`The transaction was dispatched as a ${res.type === "BUNDLED" ? "bundled" : "base layer"} Arweave transaction.`)
PreviousSign TransactionNextSign DataItem

Last updated

Was this helpful?