tezos: migrate events demo and tzkt URLs from dead ghostnet to shadownet

Wizard1209 · claude · Wizard1209 · commit 247cf3c3f17f · 2026-06-01T20:49:17.000-03:00
Ghostnet was decommissioned; api.ghostnet.tzkt.io no longer resolves, so
the demo_tezos_events run/init tests and test_tzkt.test_no_content all
failed with DNS errors (not an infra flake). Shadownet is the current
Tezos testnet.

- tezos_tzkt: swap the ghostnet entry in TZKT_API_URLS for shadownet
- demo_tezos_events: repoint the events demo at a shadownet contract with
  equivalent properties — KT1E3EQJmoajoTj9YXJWgenuYTHnDUoWSiFt (WETH
  bridge) emits two frequent typed events (Wrap/Unwrap, like move/roll)
  plus a rare Create caught by the fallback handler. Regenerated handlers
  and types via `dipdup init`; move/roll -&gt; wrap/unwrap.
- tests: point demo_tezos_events config and test_no_content at shadownet
- docs: update tezos.events include to on_wrap_event.py
- regenerate merged changelog (was stale, missing the Portal/api_key Added
  entries)

Co-Authored-By: Claude Opus 4.8 &lt;noreply@anthropic.com&gt;
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -14,6 +14,10 @@ Releases prior to 7.0 has been removed from this file to declutter search result
 - evm.sqd_portal: Added a new datasource backed by the SQD Portal (`portal.sqd.dev`), a streaming alternative to the v2.archive `evm.subsquid` gateway.
 - evm.subsquid, starknet.subsquid, substrate.subsquid: Added `api_key` option to authenticate with `v2.archive.subsquid.io` gateways, which require a key since 2026-05-19.
 
+### Changed
+
+- tezos.tzkt: Replaced decommissioned ghostnet with shadownet in known testnet URLs and the `demo_tezos_events` project.
+
 ## [8.5.2] - 2026-04-08
 
 ### Fixed
diff --git a/docs/2.indexes/6.tezos_events.md b/docs/2.indexes/6.tezos_events.md
@@ -14,8 +14,8 @@ Kathmandu Tezos protocol upgrade has introduced [contract events](https://tezos.
 
 Unlike big maps, contracts may introduce new event tags and payloads at any time, so the index must be updated accordingly.
 
-```python [handlers/on_move_event.py]
-{{ #include ../src/demo_tezos_events/handlers/on_move_event.py }}
+```python [handlers/on_wrap_event.py]
+{{ #include ../src/demo_tezos_events/handlers/on_wrap_event.py }}
 ```
 
 Each contract can have a fallback handler called for all unknown events so you can process untyped data.
diff --git a/docs/9.release-notes/_0.0_changelog.md b/docs/9.release-notes/_0.0_changelog.md
@@ -1,6 +1,12 @@
 <!-- markdownlint-disable first-line-h1 -->
 ## Changes since -1.x
 
-### Fixed
+### Added
 
-- database: Fix exception when creating connections with aiosqlite==0.22.0.
+- context: Added `get_evm_portal_datasource` method to access `evm.sqd_portal` datasources from handlers and hooks with a precise type.
+- evm.sqd_portal: Added a new datasource backed by the SQD Portal (`portal.sqd.dev`), a streaming alternative to the v2.archive `evm.subsquid` gateway.
+- evm.subsquid, starknet.subsquid, substrate.subsquid: Added `api_key` option to authenticate with `v2.archive.subsquid.io` gateways, which require a key since 2026-05-19.
+
+### Changed
+
+- tezos.tzkt: Replaced decommissioned ghostnet with shadownet in known testnet URLs and the `demo_tezos_events` project.
diff --git a/src/demo_tezos_events/dipdup.yaml b/src/demo_tezos_events/dipdup.yaml
@@ -4,24 +4,24 @@ package: demo_tezos_events
 datasources:
   tzkt:
     kind: tezos.tzkt
-    url: https://api.ghostnet.tzkt.io
+    url: https://api.shadownet.tzkt.io
 
 contracts:
   events_contract:
     kind: tezos
-    address: KT1Up6AMehze2VTdt3w85xaZPtrEWn1AeyR3
+    address: KT1E3EQJmoajoTj9YXJWgenuYTHnDUoWSiFt
 
 indexes:
   events:
     kind: tezos.events
     datasources:
       - tzkt
     handlers:
-      - callback: on_move_event
+      - callback: on_wrap_event
         contract: events_contract
-        tag: move
-      - callback: on_roll_event
+        tag: Wrap
+      - callback: on_unwrap_event
         contract: events_contract
-        tag: roll
+        tag: Unwrap
       - callback: on_other_event
         contract: events_contract
diff --git a/src/demo_tezos_events/handlers/on_unwrap_event.py b/src/demo_tezos_events/handlers/on_unwrap_event.py
@@ -1,10 +1,10 @@
 from demo_tezos_events import models as models
-from demo_tezos_events.types.events_contract.tezos_events.roll import RollPayload
+from demo_tezos_events.types.events_contract.tezos_events.unwrap import UnwrapPayload
 from dipdup.context import HandlerContext
 from dipdup.models.tezos import TezosEvent
 
 
-async def on_roll_event(
+async def on_unwrap_event(
     ctx: HandlerContext,
-    event: TezosEvent[RollPayload],
+    event: TezosEvent[UnwrapPayload],
 ) -> None: ...
diff --git a/src/demo_tezos_events/handlers/on_wrap_event.py b/src/demo_tezos_events/handlers/on_wrap_event.py
@@ -1,10 +1,10 @@
 from demo_tezos_events import models as models
-from demo_tezos_events.types.events_contract.tezos_events.move import MovePayload
+from demo_tezos_events.types.events_contract.tezos_events.wrap import WrapPayload
 from dipdup.context import HandlerContext
 from dipdup.models.tezos import TezosEvent
 
 
-async def on_move_event(
+async def on_wrap_event(
     ctx: HandlerContext,
-    event: TezosEvent[MovePayload],
+    event: TezosEvent[WrapPayload],
 ) -> None: ...
diff --git a/src/demo_tezos_events/types/events_contract/tezos_events/unwrap.py b/src/demo_tezos_events/types/events_contract/tezos_events/unwrap.py
@@ -6,9 +6,13 @@
 from pydantic import ConfigDict
 
 
-class RollPayload(BaseModel):
+class UnwrapPayload(BaseModel):
     model_config = ConfigDict(
         extra='forbid',
     )
-    address: str
-    bool: bool
+    id: str
+    user: str
+    token_address: str
+    token_amount: str
+    eth_token_address: str
+    eth_address: str
diff --git a/src/demo_tezos_events/types/events_contract/tezos_events/wrap.py b/src/demo_tezos_events/types/events_contract/tezos_events/wrap.py
@@ -6,13 +6,12 @@
 from pydantic import ConfigDict
 
 
-class MovePayload(BaseModel):
+class WrapPayload(BaseModel):
     model_config = ConfigDict(
         extra='forbid',
     )
-    address: str
-    a: str
-    b: str
-    roll: str
-    epoch: str
-    rolls: str
+    id: str
+    user: str
+    ethereum_token: str
+    token_address: str
+    token_amount: str
diff --git a/src/dipdup/config/tezos_tzkt.py b/src/dipdup/config/tezos_tzkt.py
@@ -12,7 +12,7 @@
 
 TZKT_API_URLS: dict[str, str] = {
     'https://api.tzkt.io': 'mainnet',
-    'https://api.ghostnet.tzkt.io': 'ghostnet',
+    'https://api.shadownet.tzkt.io': 'shadownet',
     'https://api.limanet.tzkt.io': 'limanet',
     'https://staging.api.tzkt.io': 'staging',
 }
diff --git a/src/dipdup/projects/demo_tezos_events/dipdup.yaml.j2 b/src/dipdup/projects/demo_tezos_events/dipdup.yaml.j2
@@ -4,24 +4,24 @@ package: {{ project.package }}
 datasources:
   tzkt:
     kind: tezos.tzkt
-    url: https://api.ghostnet.tzkt.io
+    url: https://api.shadownet.tzkt.io
 
 contracts:
   events_contract:
     kind: tezos
-    address: KT1Up6AMehze2VTdt3w85xaZPtrEWn1AeyR3
+    address: KT1E3EQJmoajoTj9YXJWgenuYTHnDUoWSiFt
 
 indexes:
   events:
     kind: tezos.events
     datasources:
       - tzkt
     handlers:
-      - callback: on_move_event
+      - callback: on_wrap_event
         contract: events_contract
-        tag: move
-      - callback: on_roll_event
+        tag: Wrap
+      - callback: on_unwrap_event
         contract: events_contract
-        tag: roll
+        tag: Unwrap
       - callback: on_other_event
         contract: events_contract
diff --git a/tests/configs/demo_tezos_events.yaml b/tests/configs/demo_tezos_events.yaml
@@ -4,26 +4,26 @@ package: demo_tezos_events
 datasources:
   tzkt:
     kind: tezos.tzkt
-    url: ${TZKT_GHOSTNET_URL:-https://new.api.ghostnet.tzkt.io}
+    url: ${TZKT_SHADOWNET_URL:-https://api.shadownet.tzkt.io}
 
 contracts:
   events_contract:
     kind: tezos
-    address: KT1Up6AMehze2VTdt3w85xaZPtrEWn1AeyR3
+    address: KT1E3EQJmoajoTj9YXJWgenuYTHnDUoWSiFt
 
 indexes:
   events:
     kind: tezos.events
-    first_level: 1250000
-    last_level: 1258176
+    first_level: 2458162
+    last_level: 2466000
     datasources:
       - tzkt
     handlers:
-      - callback: on_move_event
+      - callback: on_wrap_event
         contract: events_contract
-        tag: move
-      - callback: on_roll_event
+        tag: Wrap
+      - callback: on_unwrap_event
         contract: events_contract
-        tag: roll
+        tag: Unwrap
       - callback: on_other_event
         contract: events_contract
diff --git a/tests/test_datasources/test_tzkt.py b/tests/test_datasources/test_tzkt.py
@@ -214,7 +214,7 @@ async def test_on_operation_message_data() -> None:
 
 # FIXME: Hangs without internet
 async def test_no_content() -> None:
-    async with tzkt_replay('https://api.ghostnet.tzkt.io', batch_size=1) as tzkt:
+    async with tzkt_replay('https://api.shadownet.tzkt.io', batch_size=1) as tzkt:
         with pytest.raises(InvalidRequestError):
             await tzkt.get_jsonschemas('KT1EHdK9asB6BtPLvt1ipKRuxsrKoQhDoKgs')
 

Original file line number	Diff line number	Diff line change
`@@ -12,7 +12,7 @@`
`12`	`12`
`13`	`13`	`TZKT_API_URLS: dict[str, str] = {`
`14`	`14`	`'https://api.tzkt.io': 'mainnet',`
`15`		`- 'https://api.ghostnet.tzkt.io': 'ghostnet',`
	`15`	`+ 'https://api.shadownet.tzkt.io': 'shadownet',`
`16`	`16`	`'https://api.limanet.tzkt.io': 'limanet',`
`17`	`17`	`'https://staging.api.tzkt.io': 'staging',`
`18`	`18`	`}`