js-mcs-sdk-calibration

Introduction
- Prerequisites
MCS API
Usage
Contributing

Introduction

A javascript software development kit for the Multi-Chain Storage (MCS) calibration https://calibration-mcs.filswan.com service. It provides a convenient interface for working with the MCS API from a web browser or Node.js. This SDK has the following functionalities:

POST upload file to Filswan IPFS gate way
POST make payment to swan filecoin storage gate way
POST mint asset as NFT
GET list of files uploaded
GET files by cid
GET status from filecoin

Prerequisites

Node.js - v16.13.0 (npm v8.1.0)
Polygon Mumbai Testnet Wallet - Metamask Tutorial
Polygon Mumbai Testnet RPC - Signup via Alchemy

You will also need Testnet USDC and MATIC balance to use this SDK. Swan Faucet Tutorial

MCS API

For more information about the API usage, check out the MCS API documentation.

Usage

Instructions for developers working with MCS SDK and API.

Installation

Install the package using npm

npm init -y
npm install js-mcs-sdk-calibration

Getting Started

First you should set your private key and RPC-url as environment variables in a .env file. Mumbai network and Binance Testnet are supported.

PRIVATE_KEY=<PRIVATE_KEY>
RPC_URL=https://polygon-mumbai.g.alchemy.com/v2/<API_KEY>
BSC_RPC_URL="https://data-seed-prebsc-1-s1.binance.org:8545"

Example of uploading a single file using the MCS SDK.

require('dotenv').config()
const { mcsSDK } = require('js-mcs-sdk-calibration')
const fs = require('fs')

async function main() {
  const testFile = JSON.stringify({ address: mcs.publicKey })
  const fileArray = [{ fileName: `${mcs.publicKey}.txt`, file: testFile }]

  // set up js-mcs-sdk
  const mcs = await mcsSDK.initialize({
    privateKey: process.env.PRIVATE_KEY,
    rpcUrl: process.env.RPC_URL, // process.env.BSC_RPC_URL for tbnc network
  })

  const uploadResponse = await mcs.upload(fileArray)
  console.log(uploadResponse)
}

main()

Documentation

For more examples please see the SDK documentation or the example directory in the sdk-test repository, which contains sample code for all SDK functionalities

Contributing

Feel free to join in and discuss. Suggestions are welcome! Open an issue or Join the Discord!