{"id":31914149,"url":"https://github.com/ambiretech/ambire-common","last_synced_at":"2026-04-06T14:01:13.606Z","repository":{"id":37814199,"uuid":"491143940","full_name":"AmbireTech/ambire-common","owner":"AmbireTech","description":"Common ground for the Ambire apps. This package puts together the core business logic behind the Ambire browser extensions and (the future) mobile apps.","archived":false,"fork":false,"pushed_at":"2026-01-23T20:47:12.000Z","size":44997,"stargazers_count":28,"open_issues_count":15,"forks_count":23,"subscribers_count":3,"default_branch":"v2","last_synced_at":"2026-01-24T05:00:03.864Z","etag":null,"topics":["account-abstraction","erc-4337","ethereum","evm","wallets"],"latest_commit_sha":null,"homepage":"https://ambire.com","language":"TypeScript","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AmbireTech.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":"funding.json","license":null,"code_of_conduct":null,"threat_model":null,"audit":"audits/Ambire-EIP-7702-Update-Hunter-Security-Audit-Report-0.1.pdf","citation":null,"codeowners":null,"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},"funding":{}},"created_at":"2022-05-11T14:21:48.000Z","updated_at":"2026-01-23T15:10:15.000Z","dependencies_parsed_at":"2024-05-15T23:45:41.919Z","dependency_job_id":"e09fd109-96f7-41d6-acf9-c2f0c917aec0","html_url":"https://github.com/AmbireTech/ambire-common","commit_stats":null,"previous_names":[],"tags_count":305,"template":false,"template_full_name":null,"purl":"pkg:github/AmbireTech/ambire-common","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AmbireTech%2Fambire-common","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AmbireTech%2Fambire-common/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AmbireTech%2Fambire-common/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AmbireTech%2Fambire-common/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AmbireTech","download_url":"https://codeload.github.com/AmbireTech/ambire-common/tar.gz/refs/heads/v2","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AmbireTech%2Fambire-common/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28816571,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-27T12:25:15.069Z","status":"ssl_error","status_checked_at":"2026-01-27T12:25:05.297Z","response_time":168,"last_error":"SSL_read: 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":["account-abstraction","erc-4337","ethereum","evm","wallets"],"created_at":"2025-10-13T18:59:59.104Z","updated_at":"2026-01-27T17:00:50.926Z","avatar_url":"https://github.com/AmbireTech.png","language":"TypeScript","readme":"# Common ground for the Ambire apps\n\nThis package puts together the core business logic behind the Ambire browser extensions and (the future) mobile apps.\n\n## Install\n\nThis package is not intended to run standalone.\n\nIt’s meant to be used as a dependency by Ambire apps.\n\nYou may install it standalone only for development purposes — e.g. to run tests, make changes, or compile it locally:\n\n```bash\nnpm install\n```\n\n## Environment Variables\n\nCreate \".env\" file in the root directory and fill in all variables, see \".env-sample\" for a reference.\n\n## Branching \u0026 Git Flow\n\nWe follow a lightweight Git branching model:\n\n- **v1** (legacy)\n\n  - `v1` branch (ex `master` branch), now archived as the final state of the v1 codebase. Ambire v1 apps are in maintenance mode, so occasionally small changes may be applied to this branch.\n  - `develop` branch - deprecated and deleted; used in the past for v1 development\n\n- **v2** (current)\n\n  - `v2` branch is our active development branch\n  - `main` branch - reflects the current production version, all releases are merged here\n\n## Compiling\n\n### JS and TS\n\nThis package **does not** include compiled **JS and TS** output in the repository.\n\nEach Ambire app compiles it individually as needed.\n\nThe dist/ folder exists for internal use only. It may contain some compiled files, but it is not kept up to date and not updated on release.\n\nDo not rely on dist/ as a source of compiled code.\n\nExample on how to manually compile a file to the dist/ folder:\n\n```bash\ntsc src/libs/portfolio/getOnchainBalances.ts \\\n  --target es2020 \\\n  --module commonjs \\\n  --esModuleInterop true \\\n  --sourceMap true \\\n  --resolveJsonModule true \\\n  --outDir ./dist\n```\n\n### Contracts\n\nThis package contains all of the contracts that are used within ambire-common, as well as contracts that are used in projects that have ambire-common as dependency. Do not delete compiled contracts unless you are sure they are not used in the Ambire web wallet, mobile wallet and relayer.\n\nTo compile specific set of contracts, simply list the **contract names** in the command `compile:contracts` like so:\n\n```bash\nnpm run compile:contracts WALLETSupplyController LegendsNFTImplementation\n```\n\n## Rules\n\nAlways commit in ambire-common code that's compatible with web \u0026 mobile both 🤞\n\n## Editor Config\n\nMake sure your code editor has plugins that support the following configuration files: `.editorconfig`, `.prettierrc`, `tsconfig.json`, `eslintrc.js`, [`import-sorter.json`](https://github.com/SoominHan/import-sorter).\n\n## Deploy scripts\n\nHow to deploy Ambire 7702:\n\n- npx hardhat compile\n- npx hardhat run scripts/deploy7702.js --network optimism\n- npx hardhat verify --network optimism 0xfe77D030Ac0531f5A62bAe502712b1F1cf976DD9\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fambiretech%2Fambire-common","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fambiretech%2Fambire-common","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fambiretech%2Fambire-common/lists"}