Skip to content

Crossbell.js - A JavaScript SDK to interact with Crossbell

License

Notifications You must be signed in to change notification settings

Crossbell-Box/crossbell.js

Repository files navigation

crossbell.js

A JavaScript SDK to interact with the Crossbell. It works for both browser and Node.js.

npm version npm downloads

Installation

npm install crossbell

Usage

Requirements

Node.js >= 18.0.0 or Node.js >= 16.14.0 with fetch polyfill

Contract

Connect with Metamask

import { createContract } from 'crossbell'

// Create a new contract instance with metamask provider
const provider = window.ethereum
const contract = new createContract(provider)

// Example API: Create a new character for an address
try {
  const result = await contract.character.create({
    owner: '0x1234567890123456789012345678901234567890',
    handle: 'Jason',
    metadataOrUri: 'ipfs://xxxx/metadata.json',
  })
  console.log(result.data) // '42' (characterId)
  console.log(result.transactionHash) // '0xabcdef...'
} catch (e) {
  console.error(e.message) // e.g. "execution reverted: Web3Entry: HandleExists"
}

Connect with Private Key

You can also connect with a private key directly.

import { createContract } from 'crossbell'

const privateKey =
  '0xabcdef0123456789012345678901234567890123456789012345678901234'
const contract = new createContract(provider)

Connect with Read-Only

You can also connect with a read-only provider. Note that in this case, you can't do write operations like createCharacter.

import { createContract } from 'crossbell'

const contract = new createContract(provider) // just pass nothing to use a read-only provider

For more contract api, see docs.

Indexer

You can fetch data from the crossbell indexer.

import { createIndexer } from 'crossbell'

const indexer = createIndexer()

// get a list of characters owned by a specific address
const res = await indexer.character.getMany(
  '0x1234567890123456789012345678901234567890',
)
console.log(res.list)

For more indexer api, see docs.