@tableland/sdk v7.0.0
@tableland/sdk
A TypeScript/JavaScript library for creating and querying Tables on the Tableland network.
Table of Contents
Background
The Tableland project provides a zero-config Typescript/Javascript SDK that make it easy to interact with the Tableland network from Ethereum-based applications. The @tableland/sdk
SDK should feel comfortable to developers already familiar with the ethersjs
Javascript library. The Tableland SDK provides a small but powerful API surface that integrates nicely with existing ETH development best practices.
Simply import the library, connect to the Tableland network, and you are ready to start creating and updating tables.
Note: Interested in supporting additional chains and ecosystems? Create an Issue and let us know!
Install
Installation is easy using npm or yarn. An ES bundle is also available for those operating purely in a browser environnement.
npm i @tableland/sdk
Note: Not seeing the build type you need for your project or idea? Let us know, we're happy to work with you to improve the SDK usability!
Usage
Most common Tableland usage patterns will follow something like the following. In general, you'll need to connect, create, mutate, and query your tables. In that order :)
import { connect } from "@tableland/sdk";
// Connect
const connection = await connect({ network: "testnet" });
// Create
await connection.create("id int primary key, val text");
// Write
const write = await connection.write(
"INSERT INTO test_1 (colname) values (val1);"
);
console.log(write);
// {"hash": "blahhash"}
// Read
const query = await connection.read("SELECT * FROM test_1;");
console.log(query);
// {columns: [{name: "colname"}], rows: ["val1"]}
API
Full library documentation available on GitHub, and general docs, examples, and more available on our docs site.
Feedback
Reach out with feedback and ideas:
Maintainers
Contributing
PRs accepted.
To get started clone this repo, then do:
# use the latest node and npm LTS
npm install
npm run build
# see if everything is working
npm test
Small note: If editing the README, please conform to the standard-readme specification.
License
MIT AND Apache-2.0, © 2021-2022 Tableland Network Contributors
2 days ago
16 days ago
19 days ago
29 days ago
3 months ago
5 months ago
5 months ago
6 months ago
6 months ago
7 months ago
10 months ago
10 months ago
10 months ago
10 months ago
7 months ago
8 months ago
9 months ago
9 months ago
8 months ago
9 months ago
11 months ago
11 months ago
12 months ago
12 months ago
12 months ago
1 year ago
12 months ago
1 year ago
12 months ago
12 months ago
12 months ago
12 months ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago