Introduction

The Quais SDK is a complete Quai Network interaction library for JavaScript and TypeScript. Quais was built using the Ethers v6 framework, with significant changes made to support Quai Network’s multi-chain environment.

This will be a very short introduction to the SDK’s features, installation, and important concepts.

​

Quai Specific Features

​

Installation

To install Quais, simply install via NPM:

npm install quais

All of the methods in Quais are exported at the root level and available through the quais object. Exports are also available for each module, which allows for more granular control of method imports.

Quais supports imports in both Node.js and ESM in browser environments.

• import in Node.js
• import in ESM

// Import all methods
import { quais } from 'quais'

// Import specific methods
import { getZoneFromAddress, parseQuai } from 'quais'

// Import from a specific module
import { QuaiHDWallet } from 'quais/wallet'

​

Concepts

​

Provider

A Provider is the primary interface for reading data from any chain or ledger within Quai Network. With a Provider, you can query details about accounts, blocks and transactions, event logs, and much more.

As the Provider class provides exclusively read-only access to the network, it is often paired alongside a Signer to create a read-and-write system for full interaction with the network.

// Connect a provider to pelagus
const browserProvider = new quais.BrowserProvider(window.pelagus)

// Connect a provider to a remote node
const provider = new quais.JsonRpcProvider('https://rpc.quai.network', undefined, { usePathing: true })

​

Transaction

Transactions are state changing operations made to any of the chains within the network. They are always accompanied by a fee, which covers the cost of transaction execution and information storage for network operators.

Quais supports transactions on all shards across both the Quai and Qi ledgers. Account based Quai transactions are represented by the QuaiTransaction class. UTXO ledger Qi transactions are represented by the QiTransaction class.

Transactions within Quai generally serve 4 different purposes: sending tokens from one user to another, deploying a smart contract, executing a state changing operation in a smart contract, or natively converting from Quai to Qi.

// Create a transaction
const tx: QuaiTransactionRequest = {
	to: '0x1234567890123456789012345678901234567890',
	value: parseQuai('1.0'),
}

// Send a transaction
await signer.sendTransaction(tx)

​

Contract

A Contract is a piece of code that has been deployed to and stored on the Quai ledger virtual machine. They do not exist on the Qi ledger.

Contract state changing operations can be executed using a Signer and data can be from them using a Provider.

// create a contract
const contract = new quais.Contract(contractAddress, contractABI, provider)

// call a read-only contract function
const symbol = await contract.symbol()