https://github.com/ambiretech/ambire-common
Common ground for the Ambire apps. This package puts together the core business logic behind the Ambire browser extensions and (the future) mobile apps.
https://github.com/ambiretech/ambire-common
account-abstraction erc-4337 ethereum evm wallets
Last synced: 20 days ago
JSON representation
Common ground for the Ambire apps. This package puts together the core business logic behind the Ambire browser extensions and (the future) mobile apps.
- Host: GitHub
- URL: https://github.com/ambiretech/ambire-common
- Owner: AmbireTech
- Created: 2022-05-11T14:21:48.000Z (almost 4 years ago)
- Default Branch: v2
- Last Pushed: 2026-01-23T20:47:12.000Z (3 months ago)
- Last Synced: 2026-01-24T05:00:03.864Z (3 months ago)
- Topics: account-abstraction, erc-4337, ethereum, evm, wallets
- Language: TypeScript
- Homepage: https://ambire.com
- Size: 42.9 MB
- Stars: 28
- Watchers: 3
- Forks: 23
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
- Funding: funding.json
- Audit: audits/Ambire-EIP-7702-Update-Hunter-Security-Audit-Report-0.1.pdf
Awesome Lists containing this project
README
# Common ground for the Ambire apps
This package puts together the core business logic behind the Ambire browser extensions and (the future) mobile apps.
## Install
This package is not intended to run standalone.
It’s meant to be used as a dependency by Ambire apps.
You may install it standalone only for development purposes — e.g. to run tests, make changes, or compile it locally:
```bash
npm install
```
## Environment Variables
Create ".env" file in the root directory and fill in all variables, see ".env-sample" for a reference.
## Branching & Git Flow
We follow a lightweight Git branching model:
- **v1** (legacy)
- `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.
- `develop` branch - deprecated and deleted; used in the past for v1 development
- **v2** (current)
- `v2` branch is our active development branch
- `main` branch - reflects the current production version, all releases are merged here
## Compiling
### JS and TS
This package **does not** include compiled **JS and TS** output in the repository.
Each Ambire app compiles it individually as needed.
The 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.
Do not rely on dist/ as a source of compiled code.
Example on how to manually compile a file to the dist/ folder:
```bash
tsc src/libs/portfolio/getOnchainBalances.ts \
--target es2020 \
--module commonjs \
--esModuleInterop true \
--sourceMap true \
--resolveJsonModule true \
--outDir ./dist
```
### Contracts
This 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.
To compile specific set of contracts, simply list the **contract names** in the command `compile:contracts` like so:
```bash
npm run compile:contracts WALLETSupplyController LegendsNFTImplementation
```
## Rules
Always commit in ambire-common code that's compatible with web & mobile both 🤞
## Editor Config
Make 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).
## Deploy scripts
How to deploy Ambire 7702:
- npx hardhat compile
- npx hardhat run scripts/deploy7702.js --network optimism
- npx hardhat verify --network optimism 0xfe77D030Ac0531f5A62bAe502712b1F1cf976DD9