Introduction
Introduction to the Quais SDK.
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
API Compatibility
Quais utilizes the quai_
namespace, which allows developers to correctly make calls to any Quai RPC endpoint or wallet. Quai APIs also
return different data types in comparison to Ethereum APIs, which the SDK is built to handle.
Utilities
The quais SDK has a number of additional utility functions designed to make handling the hierarchy much easier.
Contract Address Grinding
Similar to the address sharding mentioned above, contract addresses must have a shard prefix. During deployment, Quais handles address grinding to ensure the contract address has the correct shard prefix.
Installation
To install Quais, simply install via NPM:
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.
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.
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.
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.
Was this page helpful?