This repository contains the gateway smart contracts that connect Push Chain to external blockchain ecosystems. The system enables bidirectional bridging of funds, gas abstraction, and cross-chain payload execution between Push Chain and supported external chains.
The gateway is implemented for two ecosystems:
- EVM Gateway (
contracts/evm-gateway/) — Solidity contracts for Ethereum and EVM-compatible chains (Foundry) - SVM Gateway (
contracts/svm-gateway/) — Anchor programs for Solana (Anchor)
Dependencies: Foundry
cd contracts/evm-gateway
forge buildforge test -vv # all tests
forge test --match-path test/gateway/1_adminActions.t.sol -vv # single file
forge test --match-test testFunctionName -vv # single test
forge test -vvvv # full traces
forge test --gas-report # gas report
forge coverage --ir-minimum # coverageDependencies: Rust + Cargo, Solana CLI, Anchor CLI 0.31.1, Node.js 20+
cd contracts/svm-gateway
npm install
anchor buildanchor test # all tests
TEST_FILE=tests/execute.test.ts anchor test # single file
npm run test:execute # convenience script
# also: test:withdraw, test:admin, test:rate-limit, test:universal-tx,
# test:rescue, test:cea-to-uea, test:execute-heavy- UniversalGateway — Overview & Architecture
- UniversalGatewayPC — Outbound Gateway
- Outbound Transaction Flows
- Inbound Transaction Flows
- Revert Handling
- Threat Modelling
- EVM Gateway Upgrade Plan
- SVM Gateway Overview
- Deposit / Inbound
- Withdraw + Execute
- Revert
- CEA
- Rescue
- Threat Model
- Runbook
- Integration Guide
- Testnet RPC:
https://rpc.testnet.push.org - Docs: https://push.org/docs/
MIT (EVM) / ISC (SVM)