{"id":20405463,"url":"https://github.com/tablelandnetwork/evm-tableland","last_synced_at":"2025-04-05T20:05:12.952Z","repository":{"id":37828070,"uuid":"431962396","full_name":"tablelandnetwork/evm-tableland","owner":"tablelandnetwork","description":"Tableland Smart Contracts - Simple solidity tooling to interact with Tableland from on-chain calls.","archived":false,"fork":false,"pushed_at":"2024-12-01T04:19:14.000Z","size":6078,"stargazers_count":39,"open_issues_count":8,"forks_count":11,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-03-25T17:03:25.490Z","etag":null,"topics":["database","evm","solidity","sql","tableland"],"latest_commit_sha":null,"homepage":"https://tableland.xyz","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/tablelandnetwork.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}},"created_at":"2021-11-25T19:55:59.000Z","updated_at":"2024-12-12T16:39:07.000Z","dependencies_parsed_at":"2022-06-23T06:19:56.825Z","dependency_job_id":"7cc5e6cb-27c4-4dfd-a868-e4bc0efbf80a","html_url":"https://github.com/tablelandnetwork/evm-tableland","commit_stats":{"total_commits":312,"total_committers":11,"mean_commits":"28.363636363636363","dds":0.6826923076923077,"last_synced_commit":"1885e2f134c4c5d0a679ed0c38eb680e150bd7c2"},"previous_names":["tablelandnetwork/eth-tableland","textileio/eth-tableland"],"tags_count":36,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tablelandnetwork%2Fevm-tableland","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tablelandnetwork%2Fevm-tableland/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tablelandnetwork%2Fevm-tableland/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tablelandnetwork%2Fevm-tableland/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tablelandnetwork","download_url":"https://codeload.github.com/tablelandnetwork/evm-tableland/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247217174,"owners_count":20903008,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["database","evm","solidity","sql","tableland"],"created_at":"2024-11-15T05:11:01.759Z","updated_at":"2025-04-05T20:05:12.912Z","avatar_url":"https://github.com/tablelandnetwork.png","language":"TypeScript","readme":"# @tableland/evm\n\n[![GitHub license](https://img.shields.io/github/license/tablelandnetwork/evm-tableland.svg)](./LICENSE)\n[![Release](https://img.shields.io/github/release/tablelandnetwork/evm-tableland.svg)](https://github.com/tablelandnetwork/evm-tableland/releases/latest)\n[![standard-readme compliant](https://img.shields.io/badge/standard--readme-OK-green.svg)](https://github.com/RichardLitt/standard-readme)\n[![Test](https://github.com/tablelandnetwork/evm-tableland/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/tablelandnetwork/evm-tableland/actions/workflows/test.yml)\n\n\u003e Tableland Tables EVM contracts and client components\n\n# Table of Contents\n\n- [Background](#background)\n- [Development](#development)\n- [Contributing](#contributing)\n- [License](#license)\n\n# Background\n\nThis is the Tableland Tables EVM contracts and client components.\n\n## Currently supported chains\n\n| Chain                | Chain ID | Contract                                   |\n| -------------------- | -------- | ------------------------------------------ |\n| homestead            | 1        | 0x012969f7e3439a9B04025b5a049EB9BAD82A8C12 |\n| optimism             | 10       | 0xfad44BF5B843dE943a09D4f3E84949A11d3aa3e6 |\n| arbitrum             | 42161    | 0x9aBd75E8640871A5a20d3B4eE6330a04c962aFfd |\n| arbitrum-nova        | 42170    | 0x1A22854c5b1642760a827f20137a67930AE108d2 |\n| base                 | 8453     | 0x8268F7Aba0E152B3A853e8CB4Ab9795Ec66c2b6B |\n| polygon              | 137      | 0x5c4e6A9e5C1e1BF445A062006faF19EA6c49aFeA |\n| filecoin             | 314      | 0x59EF8Bf2d6c102B4c42AEf9189e1a9F0ABfD652d |\n| sepolia              | 11155111 | 0xc50C62498448ACc8dBdE43DA77f8D5D2E2c7597D |\n| optimism-sepolia     | 11155420 | 0x68A2f4423ad3bf5139Db563CF3bC80aA09ed7079 |\n| arbitrum-sepolia     | 421614   | 0x223A74B8323914afDC3ff1e5005564dC17231d6e |\n| base-sepolia         | 84532    | 0xA85aAE9f0Aec5F5638E5F13840797303Ab29c9f9 |\n| polygon-amoy         | 80002    | 0x170fb206132b693e38adFc8727dCfa303546Cec1 |\n| filecoin-calibration | 314159   | 0x030BCf3D50cad04c2e57391B12740982A9308621 |\n\n# Development\n\n## Building the client\n\nYou can build the Typescript client locally:\n\n```shell\nnpm install\nnpx hardhat compile\nnpm run build\n```\n\n## Testing\n\nRun the test suite:\n\n```shell\nnpm test\n```\n\nTest with gas reporting:\n\n```shell\nREPORT_GAS=true npx hardhat test\n```\n\n## Deploying\n\nDeployments are handled on a per-network basis:\n\n```shell\nnpx hardhat run scripts/deploy.ts --network optimism\n```\n\nNetwork names may include context for the target Tableland network:\n\n```shell\nnpx hardhat run scripts/deploy.ts --network optimism-goerli-staging\n```\n\nWhere `optimism-goerli-staging` indicates a deployment to the Optimism Goerli testnet for the Tableland staging network.\n\nRefer to `proxies` in `network.ts` for the list of current deployments.\n\n## Upgrading\n\nThe Tableland contracts are currently upgradeable at this early stage of development. Upgrades are handled much like deployments:\n\n```shell\nnpx hardhat run scripts/upgrade.ts --network optimism\n```\n\nUpgrading on a network only works if a previous deployment already exists, referenced by proxy address in `network.ts`.\n\n## Extracting the ABI and Bytecode\n\nYou can grab the assets you need by compiling and then using some `jq` magic:\n\n### ABI\n\n```shell\ncat artifacts/contracts/TablelandTables.sol/TablelandTables.json | jq '.abi' \u003e abi.json\n```\n\n### Bytecode\n\n```shell\ncat artifacts/contracts/TablelandTables.sol/TablelandTables.json | jq -r '.bytecode' \u003e bytecode.bin\n```\n\n### Generate the Go client!\n\nYou can use the above `abi.json` to build the Go client:\n\n```shell\nmkdir gobuild\nabigen --abi ./abi.json --bin ./bytecode.bin --pkg contracts --out gobuild/Registry.go\n```\n\n## Etherscan verification\n\nTo perform Etherscan verification, you first need to deploy a contract to an Ethereum network that's supported by Etherscan, such as Sepolia:\n\n```shell\nnpx hardhat run scripts/deploy.ts --network ethereum-sepolia\n```\n\nThen, copy the deployment address and paste it in to replace `DEPLOYED_CONTRACT_ADDRESS` in this command:\n\n```shell\nnpx hardhat verify DEPLOYED_CONTRACT_ADDRESS --network ethereum-sepolia\n```\n\n## Speedier tests\n\nFor faster runs of your tests and scripts, consider skipping ts-node's type checking by setting the environment variable `TS_NODE_TRANSPILE_ONLY` to `1` in hardhat's environment. For more details see [the documentation](https://hardhat.org/guides/typescript.html#performance-optimizations).\n\n# Contributing\n\nPRs accepted.\n\nSmall note: If editing the README, please conform to the\n[standard-readme](https://github.com/RichardLitt/standard-readme) specification.\n\n# License\n\nMIT AND Apache-2.0, © 2021-2022 Tableland Network Contributors\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftablelandnetwork%2Fevm-tableland","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftablelandnetwork%2Fevm-tableland","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftablelandnetwork%2Fevm-tableland/lists"}