{"id":50342523,"url":"https://github.com/BitteProtocol/near-safe","last_synced_at":"2026-06-15T09:01:04.488Z","repository":{"id":243915792,"uuid":"813736000","full_name":"BitteProtocol/near-safe","owner":"BitteProtocol","description":"An SDK for controlling Ethereum Smart Accounts via ERC4337 from a Near Account.","archived":false,"fork":false,"pushed_at":"2025-11-02T11:30:51.000Z","size":1276,"stargazers_count":6,"open_issues_count":13,"forks_count":1,"subscribers_count":5,"default_branch":"main","last_synced_at":"2026-04-26T18:25:54.359Z","etag":null,"topics":["erc4337","ethereum","near","sdk"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/near-safe","language":"TypeScript","has_issues":true,"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/BitteProtocol.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"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}},"created_at":"2024-06-11T16:31:27.000Z","updated_at":"2025-11-02T11:30:54.000Z","dependencies_parsed_at":"2024-06-12T02:54:56.958Z","dependency_job_id":"4aa99c63-786f-48da-880e-7815c9f88e3d","html_url":"https://github.com/BitteProtocol/near-safe","commit_stats":null,"previous_names":["bh2smith/nearly-safe","mintbase/near-safe","bitteprotocol/near-safe"],"tags_count":59,"template":false,"template_full_name":null,"purl":"pkg:github/BitteProtocol/near-safe","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BitteProtocol%2Fnear-safe","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BitteProtocol%2Fnear-safe/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BitteProtocol%2Fnear-safe/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BitteProtocol%2Fnear-safe/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BitteProtocol","download_url":"https://codeload.github.com/BitteProtocol/near-safe/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BitteProtocol%2Fnear-safe/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34355156,"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-06-15T02:00:07.085Z","response_time":63,"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":["erc4337","ethereum","near","sdk"],"created_at":"2026-05-29T18:00:25.258Z","updated_at":"2026-06-15T09:01:04.482Z","avatar_url":"https://github.com/BitteProtocol.png","language":"TypeScript","funding_links":[],"categories":["Uncategorized"],"sub_categories":["Uncategorized"],"readme":"# Near-Safe\n\n**TLDR;** This project provides a TypeScript implementation for controling Ethereum Smart Accounts via ERC4337 standard from a Near Account. \nIt includes utilities for packing data, managing transactions, and interacting with a bundler.\n\nThe account structure is defined as follows:\n\n1. **Near Account** produces signatures for a deterministic EOA via Near's MPC Contract for [Chain Signatures](https://docs.near.org/concepts/abstraction/chain-signatures)\n2. This EOA (controled by the Near Account) is the owner of a deterministic [Safe](https://safe.global/) with configured support for [ERC4337](https://www.erc4337.io/) standard.\n\n## Features\n\n1. Users first transaction is bundled together with the Safe's deployement (i.e. Safe does not need to be created before it is used). This is achived as multisend transaction.\n2. No need to fund the EOA Account (it is only used for signatures).\n3. Account Recovery: Near's MPC service provides signatures for accounts that users control, but do not hold the private key for. Provide a \"recoveryAddress\" that will be added as an additional owner of the Safe.\n4. Paymaster Support for an entirely gasless experience!\n5. Same address on all chains!\n\n## Installation \u0026 Configuration\n\nTo get started, clone the repository and install the dependencies:\n\n```sh\nyarn install\n```\n\nCreate a `.env` (or use our `.env.sample`) file in the root of the project and add the following environment variables:\n\n```sh\nNEAR_ACCOUNT_ID=\n# Head to https://www.pimlico.io/ for an API key\nPIMLICO_KEY=\n```\n\nTo use the CLI tool provided here in `examples/*` you will also need to provide a privateKey for your Near account.\n\n```sh\nNEAR_ACCOUNT_PRIVATE_KEY=\n```\n\n## Usage\n\n### Running the Example\n\nThe example script `examples/send-tx.ts` demonstrates how to use the transaction manager. You can run it with the following command:\n\n```sh\nyarn start --usePaymaster --recoveryAddress \u003crecovery_address\u003e --safeSaltNonce \u003csafe_salt_nonce\u003e\n```\n\n### Example Arguments\n\nThe example script accepts the following arguments:\n\n- `--usePaymaster`: Boolean flag to indicate if the transaction should be sponsored by a paymaster service.\n- `--recoveryAddress`: The recovery address to be attached as the owner of the Safe (immediately after deployment).\n- `--safeSaltNonce`: The salt nonce used for the Safe deployment.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FBitteProtocol%2Fnear-safe","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FBitteProtocol%2Fnear-safe","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FBitteProtocol%2Fnear-safe/lists"}