{"id":18417464,"url":"https://github.com/stellar-deprecated/integration-tests","last_synced_at":"2025-04-07T12:32:40.618Z","repository":{"id":143428689,"uuid":"83691567","full_name":"stellar-deprecated/integration-tests","owner":"stellar-deprecated","description":null,"archived":true,"fork":false,"pushed_at":"2019-11-02T03:37:54.000Z","size":92,"stargazers_count":9,"open_issues_count":3,"forks_count":7,"subscribers_count":23,"default_branch":"master","last_synced_at":"2025-03-02T03:44:11.252Z","etag":null,"topics":["blockchain","cryptocurrency","integration-testing","stellar"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/stellar-deprecated.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":"2017-03-02T15:13:00.000Z","updated_at":"2024-07-02T13:27:14.000Z","dependencies_parsed_at":"2023-07-26T04:15:31.793Z","dependency_job_id":null,"html_url":"https://github.com/stellar-deprecated/integration-tests","commit_stats":null,"previous_names":["stellar-deprecated/integration-tests"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stellar-deprecated%2Fintegration-tests","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stellar-deprecated%2Fintegration-tests/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stellar-deprecated%2Fintegration-tests/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stellar-deprecated%2Fintegration-tests/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stellar-deprecated","download_url":"https://codeload.github.com/stellar-deprecated/integration-tests/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247653288,"owners_count":20973800,"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":["blockchain","cryptocurrency","integration-testing","stellar"],"created_at":"2024-11-06T04:09:31.283Z","updated_at":"2025-04-07T12:32:35.610Z","avatar_url":"https://github.com/stellar-deprecated.png","language":"JavaScript","readme":"[![Build Status](https://travis-ci.org/stellar/integration-tests.svg?branch=master)](https://travis-ci.org/stellar/integration-tests)\n\n# Stellar Integration Tests\n\nThis repository contains script responsible for performing integration tests of different components of the Stellar network.\n\n## Architecture\n\nThis section describes the architecture of integration tests.\n\n### Architecture Diagram\n![Diagram](diagram.png)\n\n### Components\n\n#### Monitor\n\nMonitor (`monitor.js`) is the main app run by travis. It's responsible for:\n* Starting tests when both FI server are online.\n* Checking the current status of tests and returning the correct exit code if tests succeed/fail/timeout.\n\n#### ngrok\n\n[ngrok](https://ngrok.com/) allows creating http/https tunnels to Docker containers. This allows us to expose `stellar.toml`, federation server and auth server to the internet so other FI can access them.\n\n#### FI Container\n\nFI Container is built from docker image that can be found in `container` directory. It consists of:\n* [Bridge](https://github.com/stellar/bridge-server/blob/master/readme_bridge.md) server,\n* [Compliance](https://github.com/stellar/bridge-server/blob/master/readme_compliance.md) server,\n* Custom FI server (`index.js`). It provides:\n  * Callbacks for `bridge` and `compliance` servers.\n  * Callbacks for `monitor` to start tests and check tests status.\n  * Proxy to `compliance` auth server (to allow creating a single tunnel to docker container).\n  * Tests code.\n\nServices are listening on the following ports within a docker container:\n\nService | Port | Exposed to docker host?\n--------|------|------------------------\nbridge | 8000 | No\ncompliance external | 8001 | No\ncompliance internal | 8002 | No\nFI server with proxy to `compliance` auth server | 8003 | **Yes**\n\n#### DB Container\n\nDocker container with a DB server that provides storage for `bridge` and `compliance` servers.\n\n## Configuration\n\nDocker cluster is defined in `docker-compose.yml` and can be started using `docker-compose` command.\n\n`docker-compose` is using environment variables defined in `container1.env`, `container2.env` and secret variables set in Travis. The list of environment variables can be found below:\n\nDescription | Scope | Name | Value\n------------|-------|------|-------\nNgrok Auth Token | Global | `NGROK_AUTH_TOKEN` | _secret_\nF1 Domain | Global | `FI1_DOMAIN` | _random_\nF2 Domain | Global | `FI2_DOMAIN` | _random_\nF1 Bridge version | Global | `FI1_BRIDGE_VERSION` | Defined in .travis.yml: `master` - master branch, other values define release version \nF2 Bridge version | Global | `FI2_BRIDGE_VERSION` | Defined in .travis.yml: `master` - master branch, other values define release version\nFI1 Receiving account | container1.env | `RECEIVING_ACCOUNT` | `GAAJKG3WQKHWZJ5RGVVZMVV6X3XYU7QUH2YVATQ2KBVR2ZJYLG35Z65A`\nFI1 Receiving secret | Global | `FI1_RECEIVING_SEED` | _secret_\nFI1 Signing account | container1.env | `SIGNING_ACCOUNT` | `GBAPTLS2A72RGEQIK6GQ4F74AIYFS2N7WIQ7LZOYKOJT4KD6MUQEHOEU`\nFI1 Signing secret | Global | `FI1_SIGNING_SEED` | _secret_\nFI2 Receiving account | container2.env | `RECEIVING_ACCOUNT` | `GCNP7JE6KR5CKHMVVFTZJUSP7ALAXWP62SK6IMIY4IF3JCHEZKBJKDZF`\nFI2 Receiving secret | Global | `FI2_RECEIVING_SEED` | _secret_\nFI2 Signing account | container2.env | `SIGNING_ACCOUNT` | `GD4SMSFNFASBHPMCOJAOVYH47OXQM5BGSHFLKHO5BGRGUK6ZOAVDG54B`\nFI2 Signing secret | Global | `FI2_SIGNING_SEED` | _secret_\nIssuing account | container*.env | `ISSUING_ACCOUNT` | `GDNFUWF2EO4OWXYLI4TDEH4DXUCN6PB24R6XQW4VATORK6WGMHGRXJVB`\n\n## Tests flow\n\nSee `script.sh`.\n\n1. Build `container` docker image using files in `container` directory.\n1. Generate random ngrok subdomains for FIs and start ngrok.\n1. Start a cluster by `docker-compose up`.\n1. Start `monitor` app.\n  1. Wait for **both** FIs to go online.\n  1. When **both** FIs are working start tests.\n  1. Monitor current status of tests.\n  1. Print results and exit with correct (error) code.\n\n## TODO\n\n* More test scenarios.\n* Use `docker-stellar-core-horizon` instead of SDF's instances.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstellar-deprecated%2Fintegration-tests","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstellar-deprecated%2Fintegration-tests","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstellar-deprecated%2Fintegration-tests/lists"}