Skip to content

Commit 0e65d06

Browse files
committed
docs(experimental): update multidapp-claimer instructions
1 parent fcb9615 commit 0e65d06

1 file changed

Lines changed: 17 additions & 8 deletions

File tree

offchain/authority-claimer/README.md

Lines changed: 17 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -17,13 +17,22 @@ All dapps must share the same History contract and the same chain ID.
1717
Instead of using evironment variables,
1818
the claimer will get the list of application addresses from Redis,
1919
through the `experimental-dapp-addresses-config` key.
20-
This key holds a Redis Set value.
21-
You must use commands such as SADD and SREM to manipulate the list of addresses.
22-
Addresses are encoded as hex strings without the leading `"0x"`.
23-
Redis values are case sensitive, so addresses must be in lowercase format.
24-
Example address value: `"0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a"`.
20+
This key holds a [Redis Set](https://redis.io/docs/latest/develop/data-types/sets/) value.
21+
You must use commands such as [`SADD`](https://redis.io/docs/latest/commands/sadd/) and [`SREM`]https://redis.io/docs/latest/commands/srem/() to manipulate the set of addresses.
2522

26-
You may rewrite the list of addresses at any time,
23+
Application addresses must be encoded as hex strings.
24+
The prefix `0x` is ignored by the `authority-claimer` when loading applications adresses.
25+
However, it's advised to use it as a matter of convention.
26+
Example address value: `"0x0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a0a"`.
27+
28+
> [!NOTE]
29+
> Duplicate addresses as well as malformed addresses are detected and logged.
30+
31+
> [!TIP]
32+
> Application addresses are case insensitive even though Redis values are not.
33+
> So, even though `"0x00000000000000000000000000000000deadbeef"` and `"0x00000000000000000000000000000000DeadBeef"` may belong to the same Redis Set, they are considered to be the same application address and one of them will be identified as a duplicate.
34+
35+
You may update the contents of `experimental-dapp-addresses-config` at any time,
2736
the claimer will adjust accordingly.
28-
The list of addresses can be empty at any time,
29-
the claimer will wait until an application address is added to the set to resume operations.
37+
The set of addresses may be emptied at any time as well,
38+
the claimer will wait until an application address is added to the set before resuming operations.

0 commit comments

Comments
 (0)