Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 8 additions & 3 deletions daemons/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,12 @@ relayer ◀──GET /v1/signature/{emitter_chain}/{sequence}──────
the cursor moves to the range's end only on full agreement, else just past the longest agreed
prefix (the lowest block among the agreeing providers), else not at all. A provider that errors
agrees with nothing. So one provider can neither get an invented or altered lock signed nor move
the cursor past a real one. One `rpc` alone still works, with a startup warning.
the cursor past a real one. One `rpc` alone still works on a devnet, with a startup warning.
On a public Rand chain (id 14 and up, or none configured) the guardian **refuses to start**
without at least two providers at a quorum of at least two on every watched chain, a non-empty
`guardian.peers` and `[guardian.limits]` (BR-601; `--check-config`, and the emergency-only
`--unsafe-skip-mainnet-guards`: `docs/guardian-hosts.md`, "The mainnet guard"). A provider URL
that carries an API key is written as a `${NAME}` placeholder and filled from the environment.
- Rebuilds the body from the event plus the block timestamp, the emitter chain id and the
emitter address (`spec/ATTESTATION.md` §3.2), checks it re-encodes canonically, and signs it
only if the destination would accept it: registered emitter, `to_chain` / `token_chain` rules,
Expand All @@ -49,7 +54,7 @@ relayer ◀──GET /v1/signature/{emitter_chain}/{sequence}──────
signed on its own once its window has room, in sequence order per token; later transfers of the
same token wait behind it, and the source's cursor moves on for everything else. Nothing pauses signing automatically; `--pause-signing <reason>` and
`--resume-signing` are the operator's global brake. This bounds loss without any contract change;
a guardian without the section warns at startup.
a guardian without the section warns at startup on a devnet, and does not start on a public chain (BR-601).
- Persists the signature before it advances its cursor, and refuses — fatally — to sign a
second body under an `(emitter chain, sequence)` it has already signed.
- **Asks its peers before a first signature** (BR-502, `guardian.peers`): replay protection on
Expand All @@ -62,7 +67,7 @@ relayer ◀──GET /v1/signature/{emitter_chain}/{sequence}──────
ignored, so no other guardian can block a transfer. If no peer answers, the transfer is deferred
(`deferred/`) and retried every round — never skipped. List among the peers any API that keeps
this guardian's past signatures (another guardian that mirrors them, or a copy of this one's
`signed/`). At startup it reports how many peers answer, or warns that none are configured.
`signed/`). At startup it reports how many peers answer, or warns that none are configured (on a public chain it refuses to start, BR-601).
- Every record under `data_dir` is written durably (BR-951): a temp file, fsynced, renamed over
the record, then the directory fsynced. A record that is still unreadable (zero-length,
truncated, not JSON) fails that `(emitter chain, sequence)` alone: the guardian signs nothing
Expand Down
19 changes: 19 additions & 0 deletions daemons/mainnet/guardian-1.toml
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,8 @@ poll_secs = 15

[rand]
rpc = "http://127.0.0.1:8545" # the bridged Rand chain's node, once it is cut
rpcs = ["${GUARDIAN_RPC_RAND}"] # BR-4/BR-601: a second Rand node, not this host's (docs/guardian-hosts.md, "Providers")
rpc_quorum = 2
chain_id = 21 # part of every PQ co-signature and governance message (spec/PQ-COSIGNATURE.md §9)
genesis_hash = "ca76c2766ed6090ac6ba5dad86b724dd5d2b80c0edfaed287cd8b129e663ca9a" # chain 21 (spec/PQ-COSIGNATURE.md); with chain_id, checked against the node at start and on every poll (BR-1005) — a cut changes BOTH lines
emitter = "c02df6ba70c2457a7406780da97492a6acb57dc40751e6279f003a570559d15f"
Expand All @@ -13,6 +15,8 @@ name = "ethereum"
chain = 2
kind = "evm"
rpc = "https://ethereum-rpc.publicnode.com"
rpcs = ["https://rpc.mevblocker.io", "${GUARDIAN_RPC_ETHEREUM}"] # three operators; the keyed one from the env
rpc_quorum = 2
contract = "0x7aF6b17047C1db6cB54347FdEa45cF9179075bfA"
finality = "finalized"
start_block = 26090266 # the 2026-09-30 endpoint (deploy block); cursors start at sequence 1, past the consume-step lock
Expand All @@ -22,6 +26,8 @@ name = "bsc"
chain = 3
kind = "evm"
rpc = "https://bsc-rpc.publicnode.com"
rpcs = ["${GUARDIAN_RPC_BSC}"] # no second keyless BSC provider serves eth_getLogs over 1,000 blocks
rpc_quorum = 2
contract = "0x7aF6b17047C1db6cB54347FdEa45cF9179075bfA"
finality = 15
start_block = 125030322 # the 2026-09-30 endpoint (deploy block, 1 h before the cut); cursors start at sequence 1
Expand All @@ -32,19 +38,32 @@ name = "tron"
chain = 4
kind = "tron"
rpc = "https://tron-rpc.publicnode.com" # TronGrid rate-limits one IP without an API key
rpcs = ["https://api.trongrid.io", "${GUARDIAN_RPC_TRON}"]
rpc_quorum = 2
contract = "0x6410797df959987a5baf65b5fab97edeb34d5163" # TK6JJv55CCkFjNHq7WwoU91GKaZEiC93me
finality = 19
start_block = 86699346 # the 2026-09-30 endpoint (deploy block); cursors start at sequence 1
max_log_range = 1000

[solana]
rpc = "https://api.mainnet-beta.solana.com"
rpcs = ["https://solana-rpc.publicnode.com", "${GUARDIAN_RPC_SOLANA}"]
rpc_quorum = 2
program = "FGA3kY3RjfDKjUszJESMYtYXAbsnkFhhoxM3Mb34vycu"

[guardian]
listen = "127.0.0.1:7071"
key_env = "GUARDIAN1_PRIV_KEY"
pq_seed_env = "GUARDIAN1_PQ_SEED"
# BR-502: the other droplet guardians, each through this host's peer forward 127.0.0.1:717<j> ->
# guardian j's 127.0.0.1:7071 (docs/guardian-hosts.md, "Peers"). Guardians 7 and 8 are offline (BR-402).
peers = [
"http://127.0.0.1:7172",
"http://127.0.0.1:7173",
"http://127.0.0.1:7174",
"http://127.0.0.1:7175",
"http://127.0.0.1:7176",
]

# BRG-1: the published caps (100 per transfer, 1,000 per day, every token), in attested 8-decimal
# units, held by this guardian before it signs. A transfer over per_transfer is withheld until
Expand Down
19 changes: 19 additions & 0 deletions daemons/mainnet/guardian-2.toml
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,8 @@ poll_secs = 15

[rand]
rpc = "http://127.0.0.1:8545" # the bridged Rand chain's node, once it is cut
rpcs = ["${GUARDIAN_RPC_RAND}"] # BR-4/BR-601: a second Rand node, not this host's (docs/guardian-hosts.md, "Providers")
rpc_quorum = 2
chain_id = 21 # part of every PQ co-signature and governance message (spec/PQ-COSIGNATURE.md §9)
genesis_hash = "ca76c2766ed6090ac6ba5dad86b724dd5d2b80c0edfaed287cd8b129e663ca9a" # chain 21 (spec/PQ-COSIGNATURE.md); with chain_id, checked against the node at start and on every poll (BR-1005) — a cut changes BOTH lines
emitter = "c02df6ba70c2457a7406780da97492a6acb57dc40751e6279f003a570559d15f"
Expand All @@ -13,6 +15,8 @@ name = "ethereum"
chain = 2
kind = "evm"
rpc = "https://ethereum-rpc.publicnode.com"
rpcs = ["https://rpc.mevblocker.io", "${GUARDIAN_RPC_ETHEREUM}"] # three operators; the keyed one from the env
rpc_quorum = 2
contract = "0x7aF6b17047C1db6cB54347FdEa45cF9179075bfA"
finality = "finalized"
start_block = 26090266 # the 2026-09-30 endpoint (deploy block); cursors start at sequence 1, past the consume-step lock
Expand All @@ -22,6 +26,8 @@ name = "bsc"
chain = 3
kind = "evm"
rpc = "https://bsc-rpc.publicnode.com"
rpcs = ["${GUARDIAN_RPC_BSC}"] # no second keyless BSC provider serves eth_getLogs over 1,000 blocks
rpc_quorum = 2
contract = "0x7aF6b17047C1db6cB54347FdEa45cF9179075bfA"
finality = 15
start_block = 125030322 # the 2026-09-30 endpoint (deploy block, 1 h before the cut); cursors start at sequence 1
Expand All @@ -32,19 +38,32 @@ name = "tron"
chain = 4
kind = "tron"
rpc = "https://tron-rpc.publicnode.com" # TronGrid rate-limits one IP without an API key
rpcs = ["https://api.trongrid.io", "${GUARDIAN_RPC_TRON}"]
rpc_quorum = 2
contract = "0x6410797df959987a5baf65b5fab97edeb34d5163" # TK6JJv55CCkFjNHq7WwoU91GKaZEiC93me
finality = 19
start_block = 86699346 # the 2026-09-30 endpoint (deploy block); cursors start at sequence 1
max_log_range = 1000

[solana]
rpc = "https://api.mainnet-beta.solana.com"
rpcs = ["https://solana-rpc.publicnode.com", "${GUARDIAN_RPC_SOLANA}"]
rpc_quorum = 2
program = "FGA3kY3RjfDKjUszJESMYtYXAbsnkFhhoxM3Mb34vycu"

[guardian]
listen = "127.0.0.1:7072"
key_env = "GUARDIAN2_PRIV_KEY"
pq_seed_env = "GUARDIAN2_PQ_SEED"
# BR-502: the other droplet guardians, each through this host's peer forward 127.0.0.1:717<j> ->
# guardian j's 127.0.0.1:7071 (docs/guardian-hosts.md, "Peers"). Guardians 7 and 8 are offline (BR-402).
peers = [
"http://127.0.0.1:7171",
"http://127.0.0.1:7173",
"http://127.0.0.1:7174",
"http://127.0.0.1:7175",
"http://127.0.0.1:7176",
]

# BRG-1: the published caps (100 per transfer, 1,000 per day, every token), in attested 8-decimal
# units, held by this guardian before it signs. A transfer over per_transfer is withheld until
Expand Down
19 changes: 19 additions & 0 deletions daemons/mainnet/guardian-3.toml
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,8 @@ poll_secs = 15

[rand]
rpc = "http://127.0.0.1:8545" # the bridged Rand chain's node, once it is cut
rpcs = ["${GUARDIAN_RPC_RAND}"] # BR-4/BR-601: a second Rand node, not this host's (docs/guardian-hosts.md, "Providers")
rpc_quorum = 2
chain_id = 21 # part of every PQ co-signature and governance message (spec/PQ-COSIGNATURE.md §9)
genesis_hash = "ca76c2766ed6090ac6ba5dad86b724dd5d2b80c0edfaed287cd8b129e663ca9a" # chain 21 (spec/PQ-COSIGNATURE.md); with chain_id, checked against the node at start and on every poll (BR-1005) — a cut changes BOTH lines
emitter = "c02df6ba70c2457a7406780da97492a6acb57dc40751e6279f003a570559d15f"
Expand All @@ -13,6 +15,8 @@ name = "ethereum"
chain = 2
kind = "evm"
rpc = "https://ethereum-rpc.publicnode.com"
rpcs = ["https://rpc.mevblocker.io", "${GUARDIAN_RPC_ETHEREUM}"] # three operators; the keyed one from the env
rpc_quorum = 2
contract = "0x7aF6b17047C1db6cB54347FdEa45cF9179075bfA"
finality = "finalized"
start_block = 26090266 # the 2026-09-30 endpoint (deploy block); cursors start at sequence 1, past the consume-step lock
Expand All @@ -22,6 +26,8 @@ name = "bsc"
chain = 3
kind = "evm"
rpc = "https://bsc-rpc.publicnode.com"
rpcs = ["${GUARDIAN_RPC_BSC}"] # no second keyless BSC provider serves eth_getLogs over 1,000 blocks
rpc_quorum = 2
contract = "0x7aF6b17047C1db6cB54347FdEa45cF9179075bfA"
finality = 15
start_block = 125030322 # the 2026-09-30 endpoint (deploy block, 1 h before the cut); cursors start at sequence 1
Expand All @@ -32,19 +38,32 @@ name = "tron"
chain = 4
kind = "tron"
rpc = "https://tron-rpc.publicnode.com" # TronGrid rate-limits one IP without an API key
rpcs = ["https://api.trongrid.io", "${GUARDIAN_RPC_TRON}"]
rpc_quorum = 2
contract = "0x6410797df959987a5baf65b5fab97edeb34d5163" # TK6JJv55CCkFjNHq7WwoU91GKaZEiC93me
finality = 19
start_block = 86699346 # the 2026-09-30 endpoint (deploy block); cursors start at sequence 1
max_log_range = 1000

[solana]
rpc = "https://api.mainnet-beta.solana.com"
rpcs = ["https://solana-rpc.publicnode.com", "${GUARDIAN_RPC_SOLANA}"]
rpc_quorum = 2
program = "FGA3kY3RjfDKjUszJESMYtYXAbsnkFhhoxM3Mb34vycu"

[guardian]
listen = "127.0.0.1:7073"
key_env = "GUARDIAN3_PRIV_KEY"
pq_seed_env = "GUARDIAN3_PQ_SEED"
# BR-502: the other droplet guardians, each through this host's peer forward 127.0.0.1:717<j> ->
# guardian j's 127.0.0.1:7071 (docs/guardian-hosts.md, "Peers"). Guardians 7 and 8 are offline (BR-402).
peers = [
"http://127.0.0.1:7171",
"http://127.0.0.1:7172",
"http://127.0.0.1:7174",
"http://127.0.0.1:7175",
"http://127.0.0.1:7176",
]

# BRG-1: the published caps (100 per transfer, 1,000 per day, every token), in attested 8-decimal
# units, held by this guardian before it signs. A transfer over per_transfer is withheld until
Expand Down
19 changes: 19 additions & 0 deletions daemons/mainnet/guardian-4.toml
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,8 @@ poll_secs = 15

[rand]
rpc = "http://127.0.0.1:8545" # the bridged Rand chain's node, once it is cut
rpcs = ["${GUARDIAN_RPC_RAND}"] # BR-4/BR-601: a second Rand node, not this host's (docs/guardian-hosts.md, "Providers")
rpc_quorum = 2
chain_id = 21 # part of every PQ co-signature and governance message (spec/PQ-COSIGNATURE.md §9)
genesis_hash = "ca76c2766ed6090ac6ba5dad86b724dd5d2b80c0edfaed287cd8b129e663ca9a" # chain 21 (spec/PQ-COSIGNATURE.md); with chain_id, checked against the node at start and on every poll (BR-1005) — a cut changes BOTH lines
emitter = "c02df6ba70c2457a7406780da97492a6acb57dc40751e6279f003a570559d15f"
Expand All @@ -13,6 +15,8 @@ name = "ethereum"
chain = 2
kind = "evm"
rpc = "https://ethereum-rpc.publicnode.com"
rpcs = ["https://rpc.mevblocker.io", "${GUARDIAN_RPC_ETHEREUM}"] # three operators; the keyed one from the env
rpc_quorum = 2
contract = "0x7aF6b17047C1db6cB54347FdEa45cF9179075bfA"
finality = "finalized"
start_block = 26090266 # the 2026-09-30 endpoint (deploy block); cursors start at sequence 1, past the consume-step lock
Expand All @@ -22,6 +26,8 @@ name = "bsc"
chain = 3
kind = "evm"
rpc = "https://bsc-rpc.publicnode.com"
rpcs = ["${GUARDIAN_RPC_BSC}"] # no second keyless BSC provider serves eth_getLogs over 1,000 blocks
rpc_quorum = 2
contract = "0x7aF6b17047C1db6cB54347FdEa45cF9179075bfA"
finality = 15
start_block = 125030322 # the 2026-09-30 endpoint (deploy block, 1 h before the cut); cursors start at sequence 1
Expand All @@ -32,19 +38,32 @@ name = "tron"
chain = 4
kind = "tron"
rpc = "https://tron-rpc.publicnode.com" # TronGrid rate-limits one IP without an API key
rpcs = ["https://api.trongrid.io", "${GUARDIAN_RPC_TRON}"]
rpc_quorum = 2
contract = "0x6410797df959987a5baf65b5fab97edeb34d5163" # TK6JJv55CCkFjNHq7WwoU91GKaZEiC93me
finality = 19
start_block = 86699346 # the 2026-09-30 endpoint (deploy block); cursors start at sequence 1
max_log_range = 1000

[solana]
rpc = "https://api.mainnet-beta.solana.com"
rpcs = ["https://solana-rpc.publicnode.com", "${GUARDIAN_RPC_SOLANA}"]
rpc_quorum = 2
program = "FGA3kY3RjfDKjUszJESMYtYXAbsnkFhhoxM3Mb34vycu"

[guardian]
listen = "127.0.0.1:7074"
key_env = "GUARDIAN4_PRIV_KEY"
pq_seed_env = "GUARDIAN4_PQ_SEED"
# BR-502: the other droplet guardians, each through this host's peer forward 127.0.0.1:717<j> ->
# guardian j's 127.0.0.1:7071 (docs/guardian-hosts.md, "Peers"). Guardians 7 and 8 are offline (BR-402).
peers = [
"http://127.0.0.1:7171",
"http://127.0.0.1:7172",
"http://127.0.0.1:7173",
"http://127.0.0.1:7175",
"http://127.0.0.1:7176",
]

# BRG-1: the published caps (100 per transfer, 1,000 per day, every token), in attested 8-decimal
# units, held by this guardian before it signs. A transfer over per_transfer is withheld until
Expand Down
19 changes: 19 additions & 0 deletions daemons/mainnet/guardian-5.toml
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,8 @@ poll_secs = 15

[rand]
rpc = "http://127.0.0.1:8545" # the bridged Rand chain's node, once it is cut
rpcs = ["${GUARDIAN_RPC_RAND}"] # BR-4/BR-601: a second Rand node, not this host's (docs/guardian-hosts.md, "Providers")
rpc_quorum = 2
chain_id = 21 # part of every PQ co-signature and governance message (spec/PQ-COSIGNATURE.md §9)
genesis_hash = "ca76c2766ed6090ac6ba5dad86b724dd5d2b80c0edfaed287cd8b129e663ca9a" # chain 21 (spec/PQ-COSIGNATURE.md); with chain_id, checked against the node at start and on every poll (BR-1005) — a cut changes BOTH lines
emitter = "c02df6ba70c2457a7406780da97492a6acb57dc40751e6279f003a570559d15f"
Expand All @@ -13,6 +15,8 @@ name = "ethereum"
chain = 2
kind = "evm"
rpc = "https://ethereum-rpc.publicnode.com"
rpcs = ["https://rpc.mevblocker.io", "${GUARDIAN_RPC_ETHEREUM}"] # three operators; the keyed one from the env
rpc_quorum = 2
contract = "0x7aF6b17047C1db6cB54347FdEa45cF9179075bfA"
finality = "finalized"
start_block = 26090266 # the 2026-09-30 endpoint (deploy block); cursors start at sequence 1, past the consume-step lock
Expand All @@ -22,6 +26,8 @@ name = "bsc"
chain = 3
kind = "evm"
rpc = "https://bsc-rpc.publicnode.com"
rpcs = ["${GUARDIAN_RPC_BSC}"] # no second keyless BSC provider serves eth_getLogs over 1,000 blocks
rpc_quorum = 2
contract = "0x7aF6b17047C1db6cB54347FdEa45cF9179075bfA"
finality = 15
start_block = 125030322 # the 2026-09-30 endpoint (deploy block, 1 h before the cut); cursors start at sequence 1
Expand All @@ -32,19 +38,32 @@ name = "tron"
chain = 4
kind = "tron"
rpc = "https://tron-rpc.publicnode.com" # TronGrid rate-limits one IP without an API key
rpcs = ["https://api.trongrid.io", "${GUARDIAN_RPC_TRON}"]
rpc_quorum = 2
contract = "0x6410797df959987a5baf65b5fab97edeb34d5163" # TK6JJv55CCkFjNHq7WwoU91GKaZEiC93me
finality = 19
start_block = 86699346 # the 2026-09-30 endpoint (deploy block); cursors start at sequence 1
max_log_range = 1000

[solana]
rpc = "https://api.mainnet-beta.solana.com"
rpcs = ["https://solana-rpc.publicnode.com", "${GUARDIAN_RPC_SOLANA}"]
rpc_quorum = 2
program = "FGA3kY3RjfDKjUszJESMYtYXAbsnkFhhoxM3Mb34vycu"

[guardian]
listen = "127.0.0.1:7075"
key_env = "GUARDIAN5_PRIV_KEY"
pq_seed_env = "GUARDIAN5_PQ_SEED"
# BR-502: the other droplet guardians, each through this host's peer forward 127.0.0.1:717<j> ->
# guardian j's 127.0.0.1:7071 (docs/guardian-hosts.md, "Peers"). Guardians 7 and 8 are offline (BR-402).
peers = [
"http://127.0.0.1:7171",
"http://127.0.0.1:7172",
"http://127.0.0.1:7173",
"http://127.0.0.1:7174",
"http://127.0.0.1:7176",
]

# BRG-1: the published caps (100 per transfer, 1,000 per day, every token), in attested 8-decimal
# units, held by this guardian before it signs. A transfer over per_transfer is withheld until
Expand Down
Loading
Loading