@ceramicnetwork/anchor-listener
TypeScript icon, indicating that this package has built-in type declarations

4.11.0 • Public • Published

Ceramic Anchor listener

ceramicnetwork MIT license Twitter

Getting started

Installation

$ npm install @ceramicnetwork/anchor-listener

Usage

import {
  createBlockProofsListener,
  createBlocksProofsLoader,
  createAncestorBlocksProofsLoader,
} from '@ceramicnetwork/anchor-listener'
import { take, timeout } from 'rxjs'

// Listen to new block events on the provider and load anchor proofs
const subsription = createBlockProofsListener({ chainId: 'eip155:1', confirmations: 20, provider: ... }).subscribe({
  next(event) {
    // event contains the `block` and `proofs`
  }
})
// Unsubscribe to stop listening
subscription.unsubscribe()

// Load proofs for a range of blocks
createBlocksProofsLoader({ chainId: 'eip155:1', fromBlock: 100, toBlock: 120, provider: ...  }).subscribe({
  next(event) {
    // event contains the `block` and `proofs`
  }
})

// Load proofs for blocks, walking up the parents until the expected ancestor hash is found
createAncestorBlocksProofsLoader({ chainId: 'eip155:1', initialBlock: 'latest', targetAncestorHash: '...', provider: ...  }).pipe(
  // Operators can be used to add stopping conditions
  take(50), // attempt to load maximum 50 blocks
  timeout(300_000), // timeout after 5 minutes
).subscribe({
  next(event) {
    // event contains the `block` and `proofs`
    // unless interrupted, `block.parentHash` will be `targetAncestorHash` in the last event
  }
})

Development

Run tests:

npm test

Run linter:

npm run lint

Contributing

We are happy to accept small and large contributions. Make sure to check out the Ceramic specifications for details of how the protocol works.

License

MIT or Apache-2.0

/@ceramicnetwork/anchor-listener/

    Package Sidebar

    Install

    npm i @ceramicnetwork/anchor-listener

    Weekly Downloads

    1,801

    Version

    4.11.0

    License

    (Apache-2.0 OR MIT)

    Unpacked Size

    31.9 kB

    Total Files

    22

    Last publish

    Collaborators

    • dav1do
    • ceramic-velvetshark
    • cb3box
    • jpham2023
    • npm.3box
    • smrz2001
    • oed
    • paul_lecam
    • stbrody
    • ukstv