{"id":18417420,"url":"https://github.com/stellar/soroban-react-payment","last_synced_at":"2025-04-07T12:32:33.272Z","repository":{"id":166612782,"uuid":"642089510","full_name":"stellar/soroban-react-payment","owner":"stellar","description":"Soroban example dapps","archived":false,"fork":false,"pushed_at":"2024-04-15T16:34:50.000Z","size":1419,"stargazers_count":6,"open_issues_count":3,"forks_count":6,"subscribers_count":20,"default_branch":"main","last_synced_at":"2024-04-16T21:04:54.974Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","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/stellar.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-05-17T19:52:20.000Z","updated_at":"2024-05-29T22:07:55.431Z","dependencies_parsed_at":null,"dependency_job_id":"8c89c643-4cad-46e0-bd76-46121d6d26ba","html_url":"https://github.com/stellar/soroban-react-payment","commit_stats":null,"previous_names":["stellar/soroban-react-payment"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stellar%2Fsoroban-react-payment","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stellar%2Fsoroban-react-payment/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stellar%2Fsoroban-react-payment/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stellar%2Fsoroban-react-payment/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stellar","download_url":"https://codeload.github.com/stellar/soroban-react-payment/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247653247,"owners_count":20973788,"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-06T04:09:24.210Z","updated_at":"2025-04-07T12:32:28.237Z","avatar_url":"https://github.com/stellar.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Soroban React Payment\n\nThe Payment DApp is an easy to use application designed to mirror the Soroban\npayment flow currently found in Freighter.\n\nYou can explore this dapp at https://scaffold-soroban.stellar.org/ by choosing\npayment from the \"select demo\" dropdown.\n\n## Prerequisites\n\nThe Payment DApp relies on the following dependencies:\n\n- Node (\u003e=16.14.0 \u003c=18.0.0): https://nodejs.org/en/download/\n\n- Yarn (v1.22.5 or newer): https://classic.yarnpkg.com/en/docs/install\n\n- Freighter wallet(v5.0 or newer): https://www.freighter.app/\n\n## Features\n\nThe Payment DApp offers the following features:\n\n1. **Freighter Wallet Integration**: The Payment DApp seamlessly integrates with\n   Freighter/Albedo/XBull, allowing users to connect their wallet to access\n   Soroban token balances and utilize their signing capabilities for secure and\n   integrity-checked transactions.\n\n2. **Transaction Construction**: Leveraging the Soroban token's contract\n   interface, the DApp constructs transactions that invoke the `transfer` method\n   of the\n   [token interface](https://github.com/stellar/soroban-examples/blob/main/token/src/contract.rs#L27).\n   This method facilitates the transfer of Soroban tokens from one address to\n   another.\n\n## Getting Started\n\nTo use the Payment DApp, follow these steps:\n\n1. Install and set up one of the supported wallets.\n\n- [Freighter wallet](https://www.freighter.app/)\n- [Albedo wallet](https://albedo.link/install-extension)\n- [XBull wallet](https://xbull.app/)\n\n2. Clone and navigate into the\n   [Payment DApp repository](https://github.com/stellar/soroban-react-payment/tree/main)\n   by running the following:\n\n   ```\n   git clone https://github.com/stellar/soroban-react-payment.git\n   cd soroban-react-payment\n   ```\n\n3. Install the dependencies by running the following:\n\n   ```\n   yarn\n   ```\n\n4. If you are using the Freighter wallet, ensure that experimental mode is\n   enabled. You can find this setting in Freighter wallet at:\n   _`Settings(⚙️)\u003ePreferences\u003eENABLE EXPERIMENTAL MODE`_.\n\n\u003cimg src = \"./public/img/freighter_settings.png\" width=\"50%\" height=\"50%\"/\u003e\n\n6. [Enable and add Soroban Tokens](https://soroban.stellar.org/docs/getting-started/connect-freighter-wallet#enable-soroban-tokens)\n   in Freighter.\n\n7. Select the account that will be used to send Soroban tokens.\n\n\u003cimg src = \"./public/img/account_selection.png\" width=\"50%\" height=\"50%\"/\u003e\n\n8. Provide the required transaction parameters, such as the token to send,amount\n   of tokens to transfer and the destination address.\n\n\u003cimg src = \"./public/img/token_select.png\" width=\"50%\" height=\"50%\"/\u003e\n\u003cbr/\u003e\n\u003cimg src = \"./public/img/send_amount.png\" width=\"50%\" height=\"50%\"/\u003e\n\u003cbr/\u003e\n\u003cimg src = \"./public/img/destination.png\" width=\"50%\" height=\"50%\"/\u003e\n\n9. Review the transaction details to ensure accuracy and then click the \"Sign\n   with Freighter\" once . Freighter will prompt you to sign the transaction with\n   your wallet's private key.\n\n\u003cimg src = \"./public/img/confirm.png\" width=\"50%\" height=\"50%\"/\u003e\n\n10. Once signed, the click the \"Submit payment\" button and the transaction will\n    be submitted to the network.\n\n\u003cimg src = \"./public/img/submit_tx.png\" width=\"50%\" height=\"50%\"/\u003e\n\n11. The Payment DApp will show a confirmation message once the transaction has\n    been successfully submitted.\n\n\u003cimg src = \"./public/img/tx_success.png\" width=\"50%\" height=\"50%\"/\u003e\n\n## Build the Project\n\n```\nyarn \u0026\u0026 yarn build\n```\n\n## Starting a Dev Environment\n\n```\nyarn \u0026\u0026 yarn start\n```\n\n## Contributions\n\nContributions to the Payment DApp are welcome. If you encounter any issues, have\nsuggestions for improvements, or would like to contribute to the codebase,\nplease submit an issue, pull request, or reach out to us on\n[Discord](https://discord.com/channels/897514728459468821/1037073682599780494).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstellar%2Fsoroban-react-payment","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstellar%2Fsoroban-react-payment","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstellar%2Fsoroban-react-payment/lists"}