{"id":42272965,"url":"https://github.com/immutable/contracts","last_synced_at":"2026-01-27T07:30:20.469Z","repository":{"id":143585549,"uuid":"601875476","full_name":"immutable/contracts","owner":"immutable","description":"Smart contracts for developers in the Immutable ecosystem. ","archived":false,"fork":false,"pushed_at":"2025-12-11T01:46:49.000Z","size":15116,"stargazers_count":43,"open_issues_count":20,"forks_count":44,"subscribers_count":14,"default_branch":"main","last_synced_at":"2025-12-11T16:26:01.445Z","etag":null,"topics":["gaming","immutable","smart-contract","solidity","web3","web3-gaming"],"latest_commit_sha":null,"homepage":"","language":"Solidity","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/immutable.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":"audits/allowlist/202402-internal-audit-operator-allow-list.pdf","citation":null,"codeowners":"CODEOWNERS","security":"SECURITY.md","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":"cla.txt"}},"created_at":"2023-02-15T02:23:01.000Z","updated_at":"2025-12-06T23:08:21.000Z","dependencies_parsed_at":null,"dependency_job_id":"543ed36f-d128-48d4-8eff-fb0d56a453d5","html_url":"https://github.com/immutable/contracts","commit_stats":null,"previous_names":["immutable/contracts","immutable/zkevm-contracts"],"tags_count":42,"template":false,"template_full_name":null,"purl":"pkg:github/immutable/contracts","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/immutable%2Fcontracts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/immutable%2Fcontracts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/immutable%2Fcontracts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/immutable%2Fcontracts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/immutable","download_url":"https://codeload.github.com/immutable/contracts/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/immutable%2Fcontracts/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28808012,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-27T07:14:39.408Z","status":"ssl_error","status_checked_at":"2026-01-27T07:14:39.098Z","response_time":168,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["gaming","immutable","smart-contract","solidity","web3","web3-gaming"],"created_at":"2026-01-27T07:30:13.423Z","updated_at":"2026-01-27T07:30:20.403Z","avatar_url":"https://github.com/immutable.png","language":"Solidity","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Immutable Contracts\n\n\u003cp align=\"center\"\u003e\u003cimg src=\"https://cdn.dribbble.com/users/1299339/screenshots/7133657/media/837237d447d36581ebd59ec36d30daea.gif\" width=\"280\"/\u003e\u003c/p\u003e\n\nImmutable Contracts is a library of smart contracts targeted at developers who wish to quickly build and deploy their smart contracts on the Immutable X and Immutable zkEVM, a general-purpose permissionless L2 zero-knowledge rollup. The library allows developers to build on contracts curated by Immutable, including (but not limited to):\n\n- Token presets, e.g. ERC721\n\n  - [ImmutableERC721](./contracts/token/erc721/preset/ImmutableERC721.sol)\n  - [ImmutableERC721MintByID](./contracts/token/erc721/preset/ImmutableERC721MintByID.sol)\n  - [ImmutableERC1155](./contracts/token/erc1155/preset/ImmutableERC1155.sol)\n  - [ImmutableERC20MinterBurnerPermit](./contracts/token/erc20/preset/ImmutableERC20MinterBurnerPermit.sol)\n  - [ImmutableERC20FixedSupplyNoBurn](./contracts/token/erc20/preset/ImmutableERC20FixedSupplyNoBurn.sol)\n\n- Bridging contracts\n\n- Marketplace and AMM contracts\n\n- Smart Contract Wallets\n\n- Random Number Generation\n\nThese contracts are feature-rich and are the recommended standard on Immutable zkEVM intended for all users and partners within the ecosystem.\n\n## Setup\n\n### Installation\n\n```\n$ yarn add @imtbl/contracts\n```\n\n### Usage\n\n#### Contracts\n\nOnce the `contracts` package is installed, use the contracts from the library by importing them:\n\n```solidity\npragma solidity \u003e=0.8.19 \u003c0.8.29;\n\nimport \"@imtbl/contracts/contracts/token/erc721/preset/ImmutableERC721.sol\";\n\ncontract MyERC721 is ImmutableERC721 {\n    constructor(\n        address owner,\n        string memory name,\n        string memory symbol,\n        string memory baseURI,\n        string memory contractURI,\n        address operatorAllowlist,\n        address royaltyReceiver,\n        uint96 feeNumerator\n    ) ImmutableERC721(\n        owner,\n        name,\n        symbol,\n        baseURI,\n        contractURI,\n        operatorAllowlist,\n        royaltyReceiver,\n        feeNumerator\n    )\n    {}\n}\n```\n\n#### Typescript ABIs\n\n`contracts` comes with importable Typescript ABIs that can be used to generate a contract client in conjunction with libraries such as `viem` or `wagmi`, so that you can\ninteract with deployed preset contracts.\n\nThe following Typescript ABIs are available:\n\n- `ImmutableERC721Abi`\n- `ImmutableERC721MintByIdAbi`\n- `ImmutableERC1155Abi`\n\nAn example of how to create and use a contract client in order to interact with a deployed `ImmutableERC721`:\n\n```typescript\nimport { getContract, http, createWalletClient, defineChain } from \"viem\";\nimport { privateKeyToAccount } from \"viem/accounts\";\nimport { ImmutableERC721MintByIdAbi } from \"@imtbl/contracts\";\n\nconst PRIVATE_KEY = \"YOUR_PRIVATE_KEY\"; // should be read from environment variable\nconst CONTRACT_ADDRESS = \"YOUR_CONTRACT_ADDRESS\"; // should be of type `0x${string}`\nconst RECIPIENT = \"ACCOUNT_ADDRESS\"; // should be of type `0x${string}`\nconst TOKEN_ID = BigInt(1);\n\nconst immutableTestnet = defineChain({\n  id: 13473,\n  name: \"imtbl-zkevm-testnet\",\n  nativeCurrency: { name: \"IMX\", symbol: \"IMX\", decimals: 18 },\n  rpcUrls: {\n    default: {\n      http: [\"https://rpc.testnet.immutable.com\"],\n    },\n  },\n});\n\nconst walletClient = createWalletClient({\n  chain: immutableTestnet,\n  transport: http(),\n  account: privateKeyToAccount(`0x${PRIVATE_KEY}`),\n});\n\n// Bound contract instance\nconst contract = getContract({\n  address: CONTRACT_ADDRESS,\n  abi: ImmutableERC721MintByIdAbi,\n  client: walletClient,\n});\n\nconst txHash = await contract.write.mint([recipient, tokenId]);\nconsole.log(`txHash: ${txHash}`);\n```\n\n## Build, Test and Deploy\n\nInformation about how to build and test the contracts can be found in our [build information](BUILD.md).\n\n## Contribution\n\nWe aim to build robust and feature-rich standards to help all developers onboard and build their projects on Immuable zkEVM, and we welcome any and all feedback and contributions to this repository! See our [contribution guideline](CONTRIBUTING.md) for more details on opening Github issues, pull requests requesting features, minor security vulnerabilities and providing general feedback.\n\n## Disclaimers\n\nThese contracts are in an experimental stage and are subject to change without notice. The code must still be formally audited or reviewed and may have security vulnerabilities. Do not use it in production. We take no responsibility for your implementation decisions and any security problems you might experience.\n\nWe will audit these contracts before our mainnet launch.\n\n## Security\n\nPlease responsibly disclose any major security issues you find by reaching out to [security@immutable.com][im-sec].\n\n[im-sec]: mailto:security@immutable.com\n\n## License\n\nImmutable zkEVM Contracts are released under the Apache-2.0 license. See [LICENSE.md](LICENSE.md) for more details.\n\n## Links\n\n### Socials\n\n- [Twitter](https://twitter.com/Immutable)\n- [Discord](https://discord.gg/6GjgPkp464)\n- [Telegram](https://t.me/immutablex)\n- [Reddit](https://www.reddit.com/r/ImmutableX/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimmutable%2Fcontracts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fimmutable%2Fcontracts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimmutable%2Fcontracts/lists"}