Skip to content

Latest commit

 

History

History
51 lines (36 loc) · 2.24 KB

README.md

File metadata and controls

51 lines (36 loc) · 2.24 KB

ISCC - UTXO Chain Observer

Tests

About iscc-observer-utxo

iscc-observer-utxo is a Python service for registering declarations of International Standard Content Codes (ISCC) coming from UTXO compatible blockchains like Bitcoin. Instances of this service observe relevant on-chain OP_RETURN messages and register them on an ISCC Registry.

Configuration

The service is configured via environment variables:

  • CHAIN_ID - ID of blockchain to be observed. See supported values.
  • NODE_SERVICE_URL - RPC connection string (http://user:password@host:port).
  • REGISTRY_URL - URL to OpenAPI REST service of an ISCC-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 via Sentry

See example at .env.dev

Development

Requirements Python 3.8 or higher with Poetry Get started with

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

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

Deployment

Docker images for deployment are available via https://ghcr.io/iscc/iscc-observer-utxo. See docker-compose.yml for an example.

Maintainers

@titusz

Contributing

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 at https://t.me/iscc_dev.