Skip to content

Latest commit

 

History

History
59 lines (43 loc) · 1.75 KB

verida-uris.md

File metadata and controls

59 lines (43 loc) · 1.75 KB
Raw

Verida URIs

Verida supports URI's that reference a specific record on the network.

URI helper library​

The @verida/helpers library provides tools to create and load Verida URI's.

Installation​ 

yarn add @verida/helpers

Generating a URI​ 

import { buildVeridaUri } from '@verida/helpers'

const did = 'did:vda:polamoy:0x...'
const contextName: 'Verida: Vault'
const databaseName: 'test_db'
const rowId: '123456'

const uri = buildVeridaUri(did, contextName, databaseName, rowId)
console.log(`Generated URI: ${uri}`)

Fetching a URI​ 

import { fetchVeridaUri } from '@verida/helpers'

const context = client.openContext('Verida: Vault')

try {
    const row = fetchVeridaUri(uri, context)
    console.log('Fetched row')
    console.log(row)
} catch (err) {
    // May throw document not found if it doesn't exist
    // or no permission to access
    console.log(err)
}

Parsing a URI​ 

import { explodeVeridaUri } from '@verida/helpers'

const {
    did,
    contextName,
    dbName,
    id,
    query
} = explodeVeridaUri(uri)