{"id":42938650,"url":"https://github.com/zeta-chain/protocol-contracts-evm","last_synced_at":"2026-05-27T18:04:40.755Z","repository":{"id":153671692,"uuid":"627820309","full_name":"zeta-chain/protocol-contracts-evm","owner":"zeta-chain","description":"Protocol contracts implementing the core logic of the protocol, deployed on ZetaChain and on connected chains","archived":false,"fork":false,"pushed_at":"2026-05-22T16:02:59.000Z","size":17168,"stargazers_count":82,"open_issues_count":42,"forks_count":70,"subscribers_count":5,"default_branch":"develop","last_synced_at":"2026-05-22T20:44:42.501Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zeta-chain.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-04-14T09:15:58.000Z","updated_at":"2026-05-22T16:03:01.000Z","dependencies_parsed_at":"2023-11-07T00:12:00.512Z","dependency_job_id":"77e09bdd-089e-4815-ab9a-be78da825dc6","html_url":"https://github.com/zeta-chain/protocol-contracts-evm","commit_stats":null,"previous_names":["zeta-chain/protocol-contracts-evm"],"tags_count":44,"template":false,"template_full_name":null,"purl":"pkg:github/zeta-chain/protocol-contracts-evm","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zeta-chain%2Fprotocol-contracts-evm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zeta-chain%2Fprotocol-contracts-evm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zeta-chain%2Fprotocol-contracts-evm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zeta-chain%2Fprotocol-contracts-evm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zeta-chain","download_url":"https://codeload.github.com/zeta-chain/protocol-contracts-evm/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zeta-chain%2Fprotocol-contracts-evm/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33577684,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-27T02:00:06.184Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-30T20:00:24.516Z","updated_at":"2026-05-27T18:04:40.749Z","avatar_url":"https://github.com/zeta-chain.png","language":"TypeScript","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"readme":"# ZetaChain Protocol Contracts\n\nContracts of official protocol contracts deployed by the core ZetaChain team.\n\n## Learn more about ZetaChain\n\n* Check our [website](https://www.zetachain.com/).\n* Read our [docs](https://docs.zetachain.com/).\n\n## Codebase\n\nThe protocol contracts codebase is separated into two sections:\n\n- `zevm`: contracts deployed on ZetaChain\n- `evm`: contracts deployed on EVM connected chains (Ethereum, Base, etc..)\n\n**ZEVM Contracts**\n\n- `GatewayZEVM`: entrypoints for interaction. The users call the gateway contract to initiate cctx. The gateway contract is also the contract calling the target when a smart contract call is initiated on a connected chain\n- `ZRC20`: is a ERC20 compliant contract that represents fungible assets from connected chains\n- `WZETA`: wrapped ZETA (fork of WETH)\n\n**EVM Contracts**\n\n- `GatewayEVM`: similar to GatewayZEVM for connected chains. Entrypoint for users.\n- `ERC20Custody`: hold ERC20 assets being sent to ZetaChain\n- `ZetaConnector`: manage ZETA for connected chains. There are two version of the contract:\n    - Native: when the ZETA tokens are native to the chain (ZETA where initially deployed as a ERC20 on Ethereum, not emitted fully on ZetaChain). Use lock/unlock model.\n    - Non-Native: when ZETA tokens where never native to the chains but withdrawn from ZetaChain. Use mint/burn model.\n- TSS (EOA): Threshold-signature-scheme wallet, this address holds the gas token sent to ZetaChain (like Ethers)\n\n[Learn more about the Gateway contracts](https://www.zetachain.com/docs/developers/evm/gateway/)\n\n## Usage\n\n**Install dependencies**\n\n```shell\n$ yarn\n$ forge soldeer update\n```\n\n**Build**\n\n```shell\n$ forge build\n```\n\n**Test**\n\n```shell\n$ forge test\n```\n\n**Format**\n\n```shell\n$ forge fmt\n```\n\n**Deploy**\n\n```shell\n$ forge script script/\u003cDeployScript\u003e.s.sol:\u003cDeployScript\u003e --rpc-url \u003cyour_rpc_url\u003e --private-key \u003cyour_private_key\u003e\n```\n\nTo view detailed instructions on how to deploy the contracts, please refer to the [Deployment Guide](./scripts/deploy/readme.md).\n\nThis guide covers all steps required to deploy the contracts, including environment setup, commands, and best practices.\n\n## Community\n\n[X](https://x.com/zetachain) | [Discord](https://discord.com/invite/zetachain) | [Telegram](https://t.me/zetachainofficial) | [Website](https://zetachain.com)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzeta-chain%2Fprotocol-contracts-evm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzeta-chain%2Fprotocol-contracts-evm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzeta-chain%2Fprotocol-contracts-evm/lists"}