<br/> <p align="center"> <a href=" " target="_blank"> <img src="https://github.com/dataverse-os/dataverse-connector/raw/main/logo.svg" width="180" alt="Dataverse logo"> </a > </p > <br/>
npm install @dataverse/dataverse-connector
bash
pnpm install @dataverse/dataverse-connector
`
Run demo
$3
- Data Wallet -
A secure data wallet to protect your identity and data assets.
- MetaMask -
A cryptocurrency wallet browser extension.
- Node.js version >= 16.
- pnpm version >= 7.
`bash
pnpm install // install dependencies
pnpm build // build the package
pnpm test // run demo
`
the demo will be running on http://localhost:5173/.
Usage
`typescript
import { DataverseConnector } from "@dataverse/dataverse-connector";
const dataverseConnector = new DataverseConnector();
`
Functions
dataverseConnector.connectWallet({ wallet: WALLET.METAMASK })
Connect with user wallet. pass in which wallet you want to connect with,
currently support MetaMask, WalletConnect, Coinbase and Particle Network.
You can also pass in provider from any wallet to perform operations such
as data reading and writing.
`ts
enum WALLET {
METAMASK = "MetaMask",
WALLETCONNECT = "WalletConnect",
COINBASE = "Coinbase",
PARTICLE = "Particle"
}
`
- Returns:
- If the wallet is not connected, a pop-up will appear for the user to select
a wallet address. After the user selects an address, the address will be
returned to indicate that the wallet is connected.
- If the wallet is already connected, will return wallet address and other
info, example:
`json
{
"address": "0x312eA852726E3A9f633A0377c0ea882086d66666",
"chain": {
"chainId": 80001,
"chainName": "mumbai"
},
"wallet": "MetaMask"
}
`
dataverseConnector.createCapability({ appId: string, resource: RESOURCE, wallet: WALLET })
Create a capability for the application to access the data resources.
- appId: string - which appId is requesting the capability.
- resource: RESOURCE - Resource to give access to the capability.
`js
enum RESOURCE {
CERAMIC,
}
`
This method will open a popup and ask the user to sign a message to create a
capability. The message will be like this.
`yaml
Message:
Give this application access to some of your data
URI:
did:key:z6MknFM4H7EFyBGANghNvV43uLvUKvRPU94fUcc8AZQZCq8Z
Version:
1
Chain ID:
1
Nonce:
UboH08SYfJn9N2
Issued At:
2023-06-12T06:35:19.225Z
Expires At:
2023-06-19T06:35:19.225Z
Resources: 4
ceramic://*?model=kjzl6hvfrbw6c763ubdhowzao0m4yp84cxzbfnlh4hdi5alqo4yrebmc0qpjdi5
ceramic://*?model=kjzl6hvfrbw6c7cp6xafsa7ghxh1yfw4bsub1363ehrxhi999vlpxny9k69uoxz
ceramic://*?model=kjzl6hvfrbw6c5qdzwi9esxvt1v5mtt7od7hb2947624mn4u0rmq1rh9anjcnxx
ceramic://*?model=kjzl6hvfrbw6c6ad7ydn0hi4vtamx2v620hdgu6llq49h28rfd6cs02g3cmn9za
`
- Returns:
- pkh: string - a pkh did you may use to interact with the data resources
later.
`js
did:pkh:eip155:1:0x29761660d6Cb26a08e9A9c7de12E0038eE9cb623
``