Read & Write data on Avail DA

BEFORE YOU BEGIN
We recommend you go through these two pages in our docs before proceeding:

Get Testnet Tokens: To help you get set with some AVAIL tokens on the Turing testnet.
Create an AppID: The guide below focusses on reading & submitting data on a particular AppID. It will help to be familiar with the concept.

Setting up the dev environment

In this guide we will use avail-js, a dedicated JavaScript library to interact with Avail DA. To set up a dev environment for avail-js, please follow the steps outlined here.

Submitting data to Avail DA

Create a file named submit-data.ts
Import the dependencies from avail-js-sdk and create a main function:

import { SDK, WaitFor, Keyring, TransactionOptions } from "avail-js-sdk"
 
const main = async () => {
 
 
}
main()

Initialize a new instance of the SDK inside the main function:

    // Initialize the SDK with a public Turing testnet endpoint
    // You can always switch it out with your own endpoint
  const providerEndpoint = "wss://turing-rpc.avail.so/ws";
  const sdk = await SDK.New(providerEndpoint)

Initialize a new wallet using a 12-word seed phrase, and configure the params for the transaction:

  const Alice = "This is a random seed phrase please do not use it";
  const account = new Keyring({ type: "sr25519" }).addFromUri(Alice)
  const data = "Example data to be submitted to Avail DA"
 
  // You can submit data to any AppID of your choosing
  const options: TransactionOptions = { app_id: 89 }

Submit the transaction by calling the dataAvailability_submitData extrinsic via the avail-js SDK:

//Submit the transaction
  const result = await sdk.tx.dataAvailability.submitData(data, WaitFor.BlockInclusion, account, options)
	if (result.isErr) {
      console.log(result.reason)
      process.exit(1)
    }
 
// Logging transaction details in the terminal
  console.log("Data=" + result.txData.data)
  console.log("Who=" + result.event.who + ", DataHash=" + result.event.dataHash)
  console.log("TxHash=" + result.txHash + ", BlockHash=" + result.blockHash)

Run the script using the following command:

ts-node submit-data.ts

If everything went well, this is what your terminal should look like:

trying to stake via proxy on Avail DA

Reading data from Avail DA

You can read back your submitted data from Avail DA using the blockHash and txHash of the transaction.

Create a file named read-data.ts
Import the dependencies from avail-js-sdk and create a main function:

import { initialize } from "avail-js-sdk"
 
const main = async () => {
  try {
 
} catch (err) {
    console.error(err)
    process.exit(1)
  }}
main()

Initialize a new instance of the SDK inside the main function, and declare the params:

      //initialize sdk
    const api = await initialize("wss://turing-rpc.avail.so/ws")
 
    // Provide the transaction hash and block hash
    const [txHash, blockHash] = ["0x17463754ef4185f4faba2473535890e4397aa403830f3b5a77295340b9e7cf56", "0x758036aa0db77bb34f6bf23b9fe290900f203ef4547e46c36fa486adbe6488e8"]
    console.log(`Tx Hash: ${txHash}, Block Hash: ${blockHash}`)

Extract the data:

    // Extracting data
    const block = await api.rpc.chain.getBlock(blockHash)
    const tx = block.block.extrinsics.find((tx) => tx.hash.toHex() == txHash)
    if (tx == undefined) {
      console.log("Failed to find the Submit Data transaction")
      process.exit(1)
    }

Parse the data to extract a string:

    console.log(JSON.stringify(tx))
    const dataHex = tx.method.args.map((a) => a.toString()).join(", ")
    // Data retrieved from the extrinsic data
    let str = ""
    for (let n = 0; n < dataHex.length; n += 2) {
      str += String.fromCharCode(parseInt(dataHex.substring(n, n + 2), 16))
    }
    console.log(`This is the string that was submitted: ${str}`)

Run the script using the following command:

ts-node read-data.ts

If everything went well, this is what your terminal should look like:

trying to stake via proxy on Avail DA

Create an AppID Deploy a Rollup on Avail DA