How nori-zk/nori-solana-sdk works
Nori’s bridge workflow locks ETH on Ethereum, submits proofs of Ethereum state to the Solana program, advances verified bridge state, and lets recipients claim SPL tokens. Ethereum task scripts also support deployment, fee management, and timelock administration. Generated contract bindings are shown as an internal integration layer. The proof-generation system is external; source excerpts do not establish its implementation here. The mint code describes a Merkle-witness claim, while the README flags a missing root-membership check.
Main entry points: lib.rs Program instructions · mint.rs Token minting · update.rs Proof verification · TimelockController__factory.ts Timelock factory
Components 23
Ethereum bridge
- Bridge operations
ethereum/tasks/deploy.ts
Proof client
- Proof file loader
proof-submitter/src/proof_file.rs - RPC submitter
proof-submitter/src/submitter.rs
Solana program
- Program instructions
programs/token/src/lib.rs - Bridge initialization
programs/token/src/instructions/initialize.rs - Bridge state
programs/token/src/state.rs - Proof verification
programs/token/src/instructions/update.rs - Root history
programs/token/src/state.rs - Deposit witness
programs/token/src/deposit_witness.rs - Request leaf hash
programs/token/src/request_leaf_hash.rs - Token minting
programs/token/src/instructions/mint.rs - Claimed amount state
programs/token/src/state.rs
Contract bindings
- Token bridge API
ethereum/types/ethers-contracts/NoriTokenBridge.ts - Proof queue API
ethereum/types/ethers-contracts/NoriProofRequestQueue.ts - Timelock API
ethereum/types/ethers-contracts/TimeLockController.sol/TimelockController.ts - Shared contract types
ethereum/types/ethers-contracts/common.ts - Bridge factory
ethereum/types/ethers-contracts/factories/NoriTokenBridge__factory.ts - Queue factory
ethereum/types/ethers-contracts/factories/NoriProofRequestQueue__factory.ts - Timelock factory
ethereum/types/ethers-contracts/factories/TimeLockController.sol/TimelockController__factory.ts
Other components
- ETH depositor
- Proof producer
- Token claimant
- Ethereum contracts
Connections 23
- ETH depositor → Ethereum contracts: locks tokens
README.md - Ethereum contracts → Proof producer: proven state
- Proof producer → RPC submitter: provides proofs
README.md - RPC submitter → Program instructions: submits updates
README.md - Token claimant → Program instructions: invokes claim
README.md - Program instructions → Bridge initialization: dispatches
programs/token/src/lib.rs - Program instructions → Proof verification: dispatches
programs/token/src/lib.rs - Program instructions → Token minting: dispatches
programs/token/src/lib.rs - Bridge initialization → Bridge state: initializes
programs/token/src/instructions/initialize.rs - Proof verification → Bridge state: checks and advances
programs/token/src/instructions/update.rs - Proof verification → Root history: records roots
README.md - Token minting → Deposit witness: checks witness
programs/token/src/instructions/mint.rs - Deposit witness → Request leaf hash: hashes request
programs/token/src/deposit_witness.rs - Token minting → Bridge state: reads bridge state
programs/token/src/instructions/mint.rs - Token minting → Claimed amount state: tracks minted amount
README.md - Bridge operations → Ethereum contracts: manages bridge
README.md - Bridge operations → Timelock factory: deploys timelock
- Bridge factory → Token bridge API: creates binding
ethereum/types/ethers-contracts/factories/NoriTokenBridge__factory.ts - Queue factory → Proof queue API: creates binding
ethereum/types/ethers-contracts/factories/NoriProofRequestQueue__factory.ts - Timelock factory → Timelock API: creates binding
ethereum/types/ethers-contracts/factories/TimeLockController.sol/TimelockController__factory.ts - Bridge factory → Shared contract types: uses types
ethereum/types/ethers-contracts/factories/NoriTokenBridge__factory.ts - Queue factory → Shared contract types: uses types
ethereum/types/ethers-contracts/factories/NoriProofRequestQueue__factory.ts - Timelock factory → Shared contract types: uses types
ethereum/types/ethers-contracts/factories/TimeLockController.sol/TimelockController__factory.ts