{"id":19610723,"url":"https://github.com/onflow/fcl-dev-wallet","last_synced_at":"2025-04-05T03:03:15.721Z","repository":{"id":37063201,"uuid":"336096746","full_name":"onflow/fcl-dev-wallet","owner":"onflow","description":"A Flow wallet for development purposes. To be used with the Flow Emulator.","archived":false,"fork":false,"pushed_at":"2025-02-02T23:43:48.000Z","size":35725,"stargazers_count":52,"open_issues_count":13,"forks_count":36,"subscribers_count":43,"default_branch":"main","last_synced_at":"2025-03-29T02:02:47.814Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/onflow.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":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-02-04T22:14:25.000Z","updated_at":"2025-03-18T13:28:25.000Z","dependencies_parsed_at":"2024-01-16T20:59:05.920Z","dependency_job_id":"5814078b-2a78-4792-8874-a678223a4300","html_url":"https://github.com/onflow/fcl-dev-wallet","commit_stats":null,"previous_names":[],"tags_count":38,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/onflow%2Ffcl-dev-wallet","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/onflow%2Ffcl-dev-wallet/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/onflow%2Ffcl-dev-wallet/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/onflow%2Ffcl-dev-wallet/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/onflow","download_url":"https://codeload.github.com/onflow/fcl-dev-wallet/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247280228,"owners_count":20912967,"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":[],"created_at":"2024-11-11T10:32:38.089Z","updated_at":"2025-04-05T03:03:15.695Z","avatar_url":"https://github.com/onflow.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cbr /\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"\"\u003e\n    \u003cimg src=\"./banner.svg\" alt=\"Logo\" width=\"600\" height=\"auto\"\u003e\n  \u003c/a\u003e\n\n  \u003cp align=\"center\"\u003e\n    \u003ci\u003eA Flow wallet for effortless development, to be used with the Flow Emulator and FCL.\u003c/i\u003e\n    \u003cbr /\u003e\n    \u003ca href=\"https://docs.onflow.org/fcl/\"\u003e\u003cstrong\u003eFCL docs»\u003c/strong\u003e\u003c/a\u003e\n    \u003cbr /\u003e\n    \u003cbr /\u003e\n    \u003ca href=\"https://github.com/onflow/fcl-dev-wallet/issues\"\u003eReport Bug\u003c/a\u003e\n    ·\n    \u003ca href=\"#getting-started\"\u003eGetting Started\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/p\u003e\n\u003cbr /\u003e\n\u003cbr /\u003e\n\n## Introduction\n\nThe FCL dev wallet is a mock Flow wallet that simulates the protocols used by [FCL](https://docs.onflow.org/fcl/) to interact with the Flow blockchain on behalf of simulated user accounts.\n\n**IMPORTANT**\n\n\u003e **Warning**\n\u003e\n\u003e This project implements an FCL compatible interface, but should **not** be used as a reference for building a production grade wallet.\n\u003e\n\u003e This project should only be used in aid of local development against a locally run instance of the Flow blockchain like the Flow emulator, \n\u003e and should never be used in conjunction with Flow Mainnet, Testnet, Canarynet or any other instances of Flow.\n\n## Getting started\n\nBefore using the dev wallet, you'll need to start the Flow emulator.\n\n### Install the `flow-cli`\n\nThe Flow emulator is bundles with the Flow CLI. Instructions for installing the CLI can be found here: [https://docs.onflow.org/flow-cli/install/](https://docs.onflow.org/flow-cli/install/)\n\n### Create a `flow.json` file\n\nRun this command to create `flow.json` file (typically in your project's root directory):\n\n```sh\nflow init\n```\n\n### Start the emulator\n\nStart the emulator and deploy the contracts by running the following command from the directory containing `flow.json` in your project:\n\n```sh\nflow emulator start\nflow project deploy --network emulator\n```\n\n## Start the dev wallet\n\n```js\nPORT=8701 npm run dev\n```\n\n**Note:** The following variables should match the `emulator-account` defined in your project's `flow.json` file.\nFor details about `flow.json` visit the `flow-cli` [configuration reference](https://docs.onflow.org/flow-cli/configuration/).\n\n## Configuring your JavaScript application\n\nThe FCL dev wallet is designed to be used with [`@onflow/fcl`](https://github.com/onflow/flow-js-sdk) version `1.0.0` or higher. The FCL package can be installed with: `npm install @onflow/fcl` or `yarn add @onflow/fcl`.\n\nTo use the dev wallet, configure FCL to point to the address of a locally running [Flow emulator](#start-the-emulator) and the dev wallet endpoint.\n\n```javascript\nimport * as fcl from \"@onflow/fcl\"\n\nfcl\n  .config()\n  // Point App at Emulator REST API\n  .put(\"accessNode.api\", \"http://localhost:8888\")\n  // Point FCL at dev-wallet (default port)\n  .put(\"discovery.wallet\", \"http://localhost:8701/fcl/authn\")\n```\n\n### Test harness\n\nIt's easy to use this FCL harness app as a barebones\napp to interact with the dev-wallet during development:\n\nNavigate to http://localhost:8701/harness\n\n🚀\n\n## Contributing\nReleasing a new version of Dev Wallet is as simple as tagging and creating a release, a Github Action will then build a bundle of the Dev Wallet that can be used in other tools (such as CLI). If the update of the Dev Wallet is required in the CLI, a seperate update PR on the CLI should be created.\n \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fonflow%2Ffcl-dev-wallet","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fonflow%2Ffcl-dev-wallet","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fonflow%2Ffcl-dev-wallet/lists"}