0g-ts-sdk

This is the JavaScript SDK for 0g-storage. Features include:

Install

npm install 0g-ts-sdk ethers

ethers is a peer dependency of this project.

Usage

Node.js environment ESM example:

Use NHFile to create a file object, then call merkleTree method to get the merkle tree of the file.

import { NHFile } from '0g-ts-sdk';

const file = await NHFile.fromFilePath('path/to/file');
const [tree, err] = await file.merkleTree();
if (err === null) {
  console.log("File Root Hash: ", tree.rootHash());
}
await file.close();

Create and submit submission:

import { getFlowContract, TESTNET_FLOW_ADDRESS } from '0g-ts-sdk';
import { ethers } from 'ethers';

// create ethers signer from private key and rpc endpoint
const rpc = 'https://rpc-testnet.0g.ai';
const provider = new ethers.JsonRpcProvider(rpc);
const privateKey = 'your-private-key'; // with balance to pay for gas
const signer = new ethers.Wallet(privateKey, provider);

// get flow contract instance
const flowContract = getFlowContract(TESTNET_FLOW_ADDRESS, signer);

const tagBytes = '0x';
const [submission, err] = await file.createSubmission(tagBytes); // check previous example for file
if (err != null) {
    console.log('create submission error: ', err);
    return;
}
let tx = await flowContract.submit(submission);
await tx.wait();
console.log(tx.hash);

Upload file to 0g-storage:

import { NHProvider } from '0g-ts-sdk';

const nhRpc = 'https://rpc-storage-testnet.0g.ai';
const nhProvider = new NHProvider(nhRpc);

await nhProvider.uploadFile(file);

Download file from 0g-storage

await nhProvider.downloadFile(<file_root_hash>, <file_path>, false);

Browser environment example:

Import zgstorage.esm.js in your html file:

<script type="module">
  import { NHBlob, NHProvider, getFlowContract } from "./dist/zgstorage.esm.js";
  // Your code here...
</script>

Create file object from blob:

const file = new NHBlob(blob);
const [tree, err] = await file.merkleTree();
if (err === null) {
  console.log("File Root Hash: ", tree.rootHash());
}

Create and submit submission:

// create ethers signer from private key and rpc endpoint
import { BrowserProvider } from 'ethers';  // or from ethers.js url
import { getFlowContract, TESTNET_FLOW_ADDRESS } from '0g-ts-sdk';
let provider = new BrowserProvider(window.ethereum) // metamask need to be installed
let signer = await provider.getSigner();

// get flow contract instance
const flowContract = getFlowContract(TESTNET_FLOW_ADDRESS, signer);

const tagBytes = '0x';
const [submission, err] = await file.createSubmission(tagBytes); // check previous example for file
if (err != null) {
    console.log('create submission error: ', err);
    return;
}
let tx = await flowContract.submit(submission);
await tx.wait();
console.log(tx.hash);

File upload is same with node.js environment.

Check codes in examples for more details.

Contribute

This project uses pnpm as package manager. After cloning the project, run pnpm install to install dependencies.

Generate Contract Flow Types

Make sure 0g-storage-contracts is in project sibling directory.

pnpm gen-contract-type-flow

0glabs / 0g-ts-sdk