POD-156: Feat/bridge #125

jakovmitrovski · 2025-09-04T14:42:16Z

Bridge Implementation: Mint-Burn and Deposit-Withdraw Patterns

Overview

This PR implements a cross-chain token bridging system with two contracts: mint-burn and deposit-withdraw. The implementation includes complete contracts, interfaces, test suites, and documentation.

Architecture

Abstract Bridge Contract

Template Method Pattern: Core functionality implemented in Bridge.sol with abstract methods for concrete implementations
Access Control: Admin and pauser roles with proper permission management
Token Management: Whitelisting, configuration, and daily limits
Migration Support: Contract upgrades with role transfers
Request Deduplication: Prevents double-processing of bridging requests

Two Bridge Implementations

1. BridgeMintBurn

Token Handling: Burns tokens on deposit, mints on claim
Deposit Verification: Uses external precompile for eth_getLogs verification
Token Creation: createAndWhitelistMirrorToken for token whitelisting / creation
To Be Deployed On: Pod

2. BridgeDepositWithdraw

Token Handling: Transfers (and locks) tokens to bridge on deposit, transfers out (unlocks) on claim
Deposit Verification: Uses PodRegistry to verify a certified log which attests that an event was emitted on Pod
To Be Deployed On: Ethereum

Testing

Added tests that cover the functionality of the bridge

Documentation Improvements

Interface Documentation
Function Documentation
Error Documentation

…ry-validator-administration

- Add functions for activating / deactivating validators - Add a function for initializing a validator - Refactor methods to use the functions - Rename nextValidatorIndex to validatorCount and derive index from it - Add tests compute weight when subset is larger than 255 and test ban not creating a snapshot when the banned validator is inactive

…ry-validator-administration

… + tests

… to index in params

…ngs, revert test to Test

…ry-validator-administration

…test suite

…y refactor

…d test tokens, update bridge to return id

jakovmitrovski · 2025-09-26T10:38:25Z

examples/bridge-flow/src/main.rs

+
+    let (request_id, token_address, block_number) =
+        source_chain_bridge_client.deposit_token(to, amount).await?;
+


We'd have to wait here for block_number to be finalized... repeatedly query get_block_by_number with finalized parameter and compare block_number to the response.block_number

jakovmitrovski · 2025-09-26T10:38:51Z

examples/bridge-flow/src/main.rs

+
+    let (request_id, source_chain_block_number) =
+        source_chain_bridge_client.deposit_native(to, value).await?;
+


Here too, wait for block number to be finalized when on sepolia/ethereum

k4m4 and others added 30 commits July 24, 2025 20:19

feat(registry): make {add,remove}Validator external

91cce32

feat(registry): maintain bitmap w/ validator set

163e5dd

feat(registry): enable validator {de,re}activation

5f6abc7

feat(registry): computeWeight for historical validator sets

9024c00

feat(registry): remove validator count state vars

13a0a01

refactor(registry): move events to interface

f9beeb4

feat(registry): add missing functions to interface

1090899

refactor(registry): {effective -> active}AsOfBlockNumber

d171ddc

Merge branch 'main' of github.com:podnetwork/pod-sdk into feat/regist…

cc50dc3

…ry-validator-administration

refactor(registry): address PR comments, minor fixes

5276a77

feat(registry): address PR comments

3192677

refactor(registry): replace requires with error reverts

c096cbc

refactor(registry): replace requires with error reverts

55c4043

Merge branch 'main' of github.com:podnetwork/pod-sdk into feat/regist…

a2724cc

…ry-validator-administration

refactor(registry): rename error

2c5ed4a

feat(registry): add getActiveValidators and getValidatorsAt functions…

e101bb8

… + tests

refactor(registry): remove fault tolerance, renaming, change blocknum…

58ff3a7

… to index in params

feat(registry): replace block numbers with timestamps

d063e9e

feat(podecdsa): implement old certificate verification

d0ac49c

refactor(podecdsa): remove all timestamps from certified receipt

a5b9b30

feat(podecdsa): modify threshold to be a fraction

fd63e14

docs(registry): add natspec docs

0ebf49b

update optimistic-auction to reflect changes in podecdsa, regen bindi…

811c22d

…ngs, revert test to Test

update optimistic-auction client

a1ef896

refactor(optimistic-auction): rename and update constant usage

55bf2ba

refacotr(registry): address PR comments

419c00d

Merge branch 'main' of github.com:podnetwork/pod-sdk into feat/regist…

5d96734

…ry-validator-administration

add bindings

e6f1f7d

feat(registry): add fast path of findSnapSHotIndex

a9d11af

jakovmitrovski marked this pull request as ready for review September 5, 2025 09:12

jakovmitrovski requested review from abresas and k4m4 September 5, 2025 09:12

Merge branch 'main' of github.com:podnetwork/pod-sdk into feat/bridge

953ecb2

jakovmitrovski changed the title ~~POD-156 Feat/bridge~~ POD-156: Feat/bridge Sep 5, 2025

Add eth get logs precompile specific types

6f7badb

jakovmitrovski force-pushed the feat/bridge branch from 72f89ac to 6f7badb Compare September 6, 2025 09:25

jakovmitrovski requested a review from shresthagrawal September 17, 2025 14:43

jakovmitrovski added 19 commits September 18, 2025 18:12

Address comments, resolve bugs, introduce native bridging, implement …

1b1cc01

…test suite

Merge branch 'main' of github.com:podnetwork/pod-sdk into feat/bridge

b63c068

rm protocl dependency

d4706de

fix error in log

91518c7

reduce contract size

2bb21c9

add configurable native token limits, contract size reduction, librar…

775f9c4

…y refactor

configurable limits for native token, gas reduction, library refactor

7c66bfd

add tests for consumption of native bridging

a27ddc2

bindings and deploy script update

ad35e1b

resolve ci

ed3712e

upd bridge args

dd72a83

bridge updates

53c7f19

script updates

dceb2c4

add bridge deployment scripts + a script that deploys both bridges an…

12abcb9

…d test tokens, update bridge to return id

script modifications, block tag for anvil

c875343

update finalized tag handling, script

1e6d807

Update deploy bridge script and e2e bridge flow example

47792df

clippy and unused deps

9280885

clippy

ca6a8d3

jakovmitrovski commented Sep 26, 2025

View reviewed changes

jakovmitrovski requested a review from poszu September 26, 2025 10:55

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

POD-156: Feat/bridge #125

POD-156: Feat/bridge #125

Uh oh!

jakovmitrovski commented Sep 4, 2025 •

edited

Loading

Uh oh!

jakovmitrovski Sep 26, 2025

Uh oh!

jakovmitrovski Sep 26, 2025

Uh oh!

Uh oh!


		let (request_id, token_address, block_number) =
		source_chain_bridge_client.deposit_token(to, amount).await?;


		let (request_id, source_chain_block_number) =
		source_chain_bridge_client.deposit_native(to, value).await?;

POD-156: Feat/bridge #125

Are you sure you want to change the base?

POD-156: Feat/bridge #125

Uh oh!

Conversation

jakovmitrovski commented Sep 4, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Bridge Implementation: Mint-Burn and Deposit-Withdraw Patterns

Overview

Architecture

Abstract Bridge Contract

Two Bridge Implementations

1. BridgeMintBurn

2. BridgeDepositWithdraw

Testing

Documentation Improvements

Uh oh!

jakovmitrovski Sep 26, 2025

Choose a reason for hiding this comment

Uh oh!

jakovmitrovski Sep 26, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

jakovmitrovski commented Sep 4, 2025 •

edited

Loading