cess-js-sdk-nodejs

About

JS-SDK for Cess Project with file storage.

Supports CommonJS and ES Module import type.

Support usage in both node.js and browsers. If used in browser, please install the Polkadot.js extension in the browser.

Installation

``bash


npm

npm i cess-js-sdk-nodejs --save

yarn

yarn add cess-js-sdk-nodejs -S

pnpm

pnpm add cess-js-sdk-nodejs
`

Example

`ts
const { Space, InitAPI, Common, defaultConfig } = require("cess-js-sdk-nodejs");
const wellKnownAcct = {
addr: "cXgaee2N8E77JJv9gdsGAckv1Qsf3hqWYf7NL4q6ZuQzuAUtB",
mnemonic: "bottom drive obey lake curtain smoke basket hold race lonely fit walk",
gatewayAddr: "cXhwBytXqrZLr1qM5NHJhCzEMckSTzNKw17ci2aHft6ETSQm9",
};

async function main() {
const { api, keyring } = await InitAPI(defaultConfig);
const { addr, mnemonic } = wellKnownAcct;

const space = new Space(api, keyring);
/*
const bucket = new Bucket(api, keyring, true);
const space2 = new Space2(api, keyring, true);
const authorizeHandle = new Authorize(api, keyring, true);
const fileHandle = new File(
api,
keyring,
config.gatewayURL,
true
);
*/
const common = new Common(api, keyring);

console.log("query userOwnedSpace:");
let result = await space.userOwnedSpace(addr);
const blockHeight = await common.queryBlockHeight();

result = common.formatSpaceInfo(result.data, blockHeight);
console.log(result);

function getDataIfOk(result) {
return result.msg === "ok" ? result.data : result;
}

if (result.totalSpace) {
console.log("expansionSpace:");
result = await space.expansionSpace(mnemonic, 1);
console.log(getDataIfOk(result), "\n");

console.log("renewalSpace:");
result = await space.renewalSpace(mnemonic, 1);
console.log(getDataIfOk(result), "\n");
} else {
console.log("buySpace:");
result = await space.buySpace(mnemonic, 1);
console.log(getDataIfOk(result), "\n");
}

console.log("query userOwnedSpace:");
result = await space.userOwnedSpace(addr);
result = common.formatSpaceInfo(result.data, blockHeight);
console.log(result);
}

main()
.catch(console.error)
.finally(() => process.exit());
`

More examples are in the examples directory.

To run them all, run the command:

`bash
pnpm examples
`

All examples connect to the Testnet and use the account cXgaee2N8E77JJv9gdsGAckv1Qsf3hqWYf7NL4q6ZuQzuAUtB as default with the following mnemonic:

`
bottom drive obey lake curtain smoke basket hold race lonely fit walk
`

This is the well-known development account in Substrate. If you don't have the token needed, please fetch it from the Testnet faucet.

$3

`
'wss://testnet-rpc.cess.cloud/ws/',
'wss://testnet-rpc.cess.network/ws/',
`

$3

`
https://testnet-faucet.cess.cloud/
`

$3

`
Address: https://deoss-pub-gateway.cess.cloud/
Account: cXhwBytXqrZLr1qM5NHJhCzEMckSTzNKw17ci2aHft6ETSQm9
`

APIs

$3

The config object of CESSConfig type is:

`ts
const testnetConfig = {
nodeURL: "wss://testnet-rpc0.cess.cloud/ws/",
keyringOption: { type: "sr25519", ss58Format: 42 },
gatewayURL: "http://deoss-pub-gateway.cess.cloud/",
};

function buildConfig(nodeURL, gatewayURL, keyringOption) {
return {
nodeURL,
gatewayURL,
// default value for keyring option
keyringOption: keyringOption || {
type: "sr25519",
ss58Format: 42,
},
};
}
`

$3

- userOwnedSpace(accountId32: string): Promise
- buySpace(mnemonic: string, gibCount: number): Promise
- expansionSpace(mnemonicOrAccountId32: string, gibCount: number): Promise
- renewalSpace(mnemonic: string, days: number): Promise

$3

- authorityList(accountId32: string): Promise
- authorize(mnemonic: string, operator: string): Promise
- cancelAuthorize(mnemonic: string, operator: string): Promise

$3

- queryBucketNames(accountId32: string): Promise
- queryBucketList(accountId32: string): Promise
- queryBucketInfo(accountId32: string, name: string): Promise
- createBucket(mnemonic: string, accountId32: string, name: string): Promise
- deleteBucket(mnemonic: string, accountId32: string, name: string): Promise

$3

- queryFileListFull(accountId32: string): Promise
- queryFileList(accountId32: string): Promise
- queryFileMetadata(fileHash: string): Promise
- uploadFile(mnemonic: string, accountId32: string, filePath: string, bucketName: string): Promise
- downloadFile(fileHash: string, savePath: string): Promise
- deleteFile(mnemonic: string, accountId32: string, fileHashArray: string[]): Promise`