Prerequisites & Repos

Prerequisites & Repos

Setup & information all types developers should be familiar with before diving into the Tableland tech.


In order to interact with Tableland, developers should ensure the following exist:

It is also recommended to leverage node providers like Alchemy, Infura, or Etherscan and create API keys to establish a connection to a chain. This avoids rate limiting by avoiding the default API keys provided.

Additionally, Tableland supports hardhat local development environments. See the information below for more details.

Tableland is still a testnet and will be launching a Tableland mainnet in 2023. But, smart contracts and apps deployed on testnet and mainnet chains can and should use the Tableland testnet. Developers should still proceed with caution due to the nature of testnets and ensure contracts that use Tableland are upgradable.

Development Information

For all of our tech, the default EVM network is ethereum-goerli. When using the SDK on the client side, if MetaMask does not show this or the other supported chains, check out how to add custom network RPCs and also how to find the chainId & RPCs.

GitHub Repositories

Using hardhat

For those new to web3 development, hardhat is a great framework for interacting the chains locally as well as on live testnets/mainnets. The hardhat website has plenty of great starter tutorial information.

The basic flow starts with the following npx command to create a new project, and then follow the prompts (e.g., Create a basic sample project)

npx hardhat

Great, a hardhat starter template now exists! You can import the @tableland/sdk or @tableland/evm-tableland smart contracts and leverage them within your project.

JavaScript SDK

The @tableland/sdk offers a top-level export called SUPPORTED_CHAINS, which defines the supported chains and Tableland smart contract addresses. For developers using hardhat, this can be useful when interacting with local or live contract deployments since it easily provides a way to retrieve the chain information.

For more information on SUPPORTED_CHAINS, see the dedicated section in the SDK docs. Note that spinning up a hardhat environment is not required to use the SDK itself but is a best practice for those using a local development setup.

Smart Contracts

All Tableland smart contracts are located at @tableland/evm-tableland. This repository also leverages hardhat. It uses a hardhat.config.ts that defines the network config information described above along with an .env file for key management, making it easy for developers to spin up the Tableland smart contracts & chain connections.

Simply clone the repo below, and you’ll have access to the Tableland smart contracts with a hardhat environment already configured.

Additional Notes

The Tableland JS SDK & CLI heavily rely on ethers under the hood. The concept of a provider is required to connect to a chain, which is simply an API to a node (running a chain client) that can then access the chain. The ethers library provides a no config way to do this using default, rate limited API providers (e.g., Alchemy). Thus, it is recommended to set up your own provider for any production or even development application by creating and specifying your own provider API keys.

Check out the Alchemy, Infura, and Etherscan API starter docs since these are commonly used providers that we support. Also, see the ethers documentation for more details on providers.

← Previous

Next →