Repository files navigation

iscc-observer-evm is aPython service for registering declarations ofInternational Standard Content Codes (ISCC) coming from Web3/EVM compatible blockchains. Instances of this service can observe events from a singleISCC-HUB contract and register them on anISCC Registry.

The service is configured via environment variables:

• CHAIN_ID - ID of blockchain to be observed.Supported values for EVM chains areETHEREUM,POLYGON
• WEB3_PROVIDER_URI -Web3 Websocket URI used for connecting to blockchain events.
• HUB_CONTRACT - The address of theISCC-HUB contract
• REGISTRY_URL - URL to OpenAPI REST service of anISCC-REGISTRY for event publishing
• OBSERVER_TOKEN - Bearer secret for authentication with ISCC-REGISTRY API service
• UPDATE_INTERVAL - Seconds to wait betweenn synchronization of chain-events and the registry
• READ_TIMEOUT - Timeout for Web3 websocket and REST API https connections in seconds
• SENTRY_DSN - Optional URI for error notifications viaSentry

See example at.env.dev

Requirements Python 3.9 withPoetryGet started with

$ git clone https://github.com/iscc/iscc-observer-evm.git$cd iscc-observer-evm$ poetry install

Start an observer instance withpoetry run iscc-observer-evm .env.dev.You may provide your own .env file configured according to your local development setup.

Docker images for deployment are available viahttps://ghcr.io/iscc/iscc-observer-evm.Seedocker-compose.yml for an example of how to deploy multiple observers.

@titusz

Pull requests are welcome. For significant changes, please open an issue first to discuss your plans. Please make sure to update tests as appropriate.

You may also want join our developer chat on Telegram athttps://t.me/iscc_dev.