{"id":13408865,"url":"https://github.com/gfusee/xnetwork","last_synced_at":"2026-01-12T10:58:51.930Z","repository":{"id":148261374,"uuid":"600047934","full_name":"gfusee/xnetwork","owner":"gfusee","description":null,"archived":false,"fork":false,"pushed_at":"2024-03-15T15:27:07.000Z","size":542,"stargazers_count":13,"open_issues_count":2,"forks_count":2,"subscribers_count":4,"default_branch":"main","last_synced_at":"2024-07-31T20:32:02.786Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/gfusee.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}},"created_at":"2023-02-10T13:18:57.000Z","updated_at":"2024-05-09T21:21:04.000Z","dependencies_parsed_at":"2024-03-15T16:48:38.506Z","dependency_job_id":null,"html_url":"https://github.com/gfusee/xnetwork","commit_stats":null,"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"purl":"pkg:github/gfusee/xnetwork","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gfusee%2Fxnetwork","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gfusee%2Fxnetwork/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gfusee%2Fxnetwork/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gfusee%2Fxnetwork/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gfusee","download_url":"https://codeload.github.com/gfusee/xnetwork/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gfusee%2Fxnetwork/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28338895,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-12T10:40:25.642Z","status":"ssl_error","status_checked_at":"2026-01-12T10:39:27.820Z","response_time":98,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: 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":[],"created_at":"2024-07-30T20:00:55.986Z","updated_at":"2026-01-12T10:58:51.914Z","avatar_url":"https://github.com/gfusee.png","language":"TypeScript","readme":"# xNetwork\n\nThis project offers an effortless way to run a localnet of MultiversX and its corresponding API without any configuration needed.\nWhile you can run a localnet of MultiversX using the [MultiversX CLI](https://multiversx.com/), this project provides a more comprehensive environment, including a proxy and a complete API.\n\n## Features\n- Run your own localnet of MultiversX\n- Choose the number of shards you prefer\n- Create an initial address with 1,000,000 $EGLD\n- Run the corresponding API, identical to https://api.multiversx.com\n- Run MxOps scenes at startup\n\n## Requirements\n- [Docker](https://docs.docker.com/get-started/) and [Docker Compose](https://docs.docker.com/compose/gettingstarted/).\n\n## Usage\n\n1. Install the package via NPM:\n\n    ```bash\n    npm install -g @gfusee/xnetwork\n    ```\n\n2. That's it! Run the following command to run the tool:\n\n    ```bash\n    xnetwork\n    ```\n\n# Features documentation\n\n## Give 1,000,000 EGLD to a custom address\n\nBy default, xNetwork will generate a wallet for you and give it 1,000,000 EGLD, the secret key will be print in the console after the network is up.\nBut you can choose in the CLI to give the EGLD to a custom address.\n\n## Run MxOps scenes at startup\n\nWhen creating a new network, you can choose to run [MxOps](https://github.com/Catenscia/MxOps) scenes from a selected folder at startup. By doing so, each scene will run under a scenario called `xnetwork`, so make sure you allow it in your scenes AND that the network `LOCAL` is allowed too.\n\nThe `xnetwork` scenario includes some helpful variables:\n\n- An account named `xnetwork_genesis`, which is the account that has the initial 1,000,000 EGLD (if you chose not to use a custom address to give them)\n\nNote that you can put all the files and folders you want in the scenes folder (`mxops_config.ini`, `.wasm`, `.pem`, etc...), and they will all be available in scenes under the path 'mxops'.\n\nHere is an example of a valid scene file, assuming you have the `.wasm` in `\u003cselected folder in the CLI\u003e/contract/ping-pong/output/ping-pong.wasm` : \n\n```yaml\nallowed_networks:\n    - LOCAL\n\nallowed_scenario:\n  - \".*\"\n\nsteps:\n\n  - type: ContractDeploy\n    sender: xnetwork_genesis\n    wasm_path: \"./contract/ping-pong/output/ping-pong.wasm\"\n    contract_id: \"egld-ping-pong\"\n    gas_limit: 60000000\n    arguments:\n        - 500000000000000000\n        - 1\n    upgradeable: True\n    readable: False\n    payable: False\n    payable_by_sc: True\n\n  - type: ContractCall\n    sender: xnetwork_genesis\n    contract: \"egld-ping-pong\"\n    endpoint: ping\n    gas_limit: 3000000\n    value: 500000000000000000\n\n  - type: ContractCall\n    sender: xnetwork_genesis\n    contract: \"egld-ping-pong\"\n    endpoint: pong\n    gas_limit: 3000000\n\n```\n\n# Contributing\n\nIf you encounter any issues or would like to contribute to this project, feel free to open a pull request or an issue on GitHub.\n","funding_links":[],"categories":["MultiversX community"],"sub_categories":["SDKs and dev tools"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgfusee%2Fxnetwork","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgfusee%2Fxnetwork","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgfusee%2Fxnetwork/lists"}