@tradetrust-tt/document-store
v4.0.0
Published
The [Document Store](https://github.com/Open-Attestation/document-store) repository contains both the smart contract code for document store (in `/contracts`) as well as the node package for using this library (in `/src`).
Downloads
1,362
Readme
Document Store
The Document Store repository contains both the smart contract code for document store (in /contracts
) as well as the node package for using this library (in /src
).
Prerequisite
- Node (optionally, use nvm to manage node version)
- Node version 18 onwards.
Installation
npm i @tradetrust-tt/document-store
Usage
To use the package, you will need to provide your own Web3 provider or signer (if you are writing to the blockchain).
Deploy new document store
import { deployAndWait } from "@tradetrust-tt/document-store";
const documentStore = await deployAndWait("My Document Store", signer).then(console.log);
Connect to existing document store
import { connect } from "@tradetrust-tt/document-store";
const documentStore = await connect("0x4077534e82c97be03a07fb10f5c853d2bc7161fb", providerOrSigner);
Interact with document store
const issueMerkleRoot = async () => {
const documentStore = connect("0x4077534e82c97be03a07fb10f5c853d2bc7161fb", signer);
const tx = await documentStore.issue("0x7fe0b58ed760804eb7118988637693c4351613be327b56527e55bcd0a8d170d7");
const receipt = await tx.wait();
console.log(receipt);
const isIssued = await instance.isIssued("0x7fe0b58ed760804eb7118988637693c4351613be327b56527e55bcd0a8d170d7");
console.log(isIssued);
};
List of available functions
documentIssued
documentRevoked
isOwner
name
owner
renounceOwnership
transferOwnership
version
initialize
issue
bulkIssue
getIssuedBlock
isIssued
isIssuedBefore
revoke
bulkRevoke
isRevoked
isRevokedBefore
Provider & Signer
Different ways to get provider or signer:
import { Wallet, providers, getDefaultProvider } from "ethers";
// Providers
const mainnetProvider = getDefaultProvider();
const goerliProvider = getDefaultProvider("goerli");
const metamaskProvider = new providers.Web3Provider(web3.currentProvider); // Will change network automatically
// Signer
const signerFromPrivateKey = new Wallet("YOUR-PRIVATE-KEY-HERE", provider);
const signerFromEncryptedJson = Wallet.fromEncryptedJson(json, password);
signerFromEncryptedJson.connect(provider);
const signerFromMnemonic = Wallet.fromMnemonic("MNEMONIC-HERE");
signerFromMnemonic.connect(provider);
Setup
npm install
npm lint
npm test
npm truffle <command>
Contract Benchmark
A benchmark is provided to show the different transaction cost of the different variants of the document store.
npm run benchmark
Notes
If you are using vscode, you may need to link the openzeppelin libraries. Refer to here.