Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/huuquyet/soroban-payment
Clone of Payment Dapps for the Soroban Dapps Challenge
https://github.com/huuquyet/soroban-payment
rust soroban stellar webpack
Last synced: 2 months ago
JSON representation
Clone of Payment Dapps for the Soroban Dapps Challenge
- Host: GitHub
- URL: https://github.com/huuquyet/soroban-payment
- Owner: huuquyet
- License: mit
- Created: 2023-12-04T04:32:38.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-06-22T12:43:25.000Z (6 months ago)
- Last Synced: 2024-10-02T08:56:35.411Z (3 months ago)
- Topics: rust, soroban, stellar, webpack
- Language: TypeScript
- Homepage: https://soroban-payment.vercel.app
- Size: 7.77 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Security: .github/SECURITY.md
Awesome Lists containing this project
README
# Soroban React Payment
The Payment DApp is an easy to use application designed to mirror the Soroban
payment flow currently found in Freighter.
You can explore this dapp at https://scaffold-soroban.stellar.org/ by choosing
payment from the "select demo" dropdown.
## Prerequisites
The Payment DApp relies on the following dependencies:
- Node (>=16.14.0 <=18.0.0): https://nodejs.org/en/download/
- Bun: https://bun.sh
- Freighter wallet(v5.0 or newer): https://www.freighter.app/
## Features
The Payment DApp offers the following features:
1. **Freighter Wallet Integration**: The Payment DApp seamlessly integrates with
Freighter/Albedo/XBull, allowing users to connect their wallet to access
Soroban token balances and utilize their signing capabilities for secure and
integrity-checked transactions.
2. **Transaction Construction**: Leveraging the Soroban token's contract
interface, the DApp constructs transactions that invoke the `transfer` method
of the
[token interface](https://github.com/stellar/soroban-examples/blob/main/token/src/contract.rs#L27).
This method facilitates the transfer of Soroban tokens from one address to
another.
## Getting Started
To use the Payment DApp, follow these steps:
1. Install and set up one of the supported wallets.
- [Freighter wallet](https://www.freighter.app/)
- [Albedo wallet](https://albedo.link/install-extension)
- [XBull wallet](https://xbull.app/)
2. Clone and navigate into the
[Payment DApp repository](https://github.com/stellar/soroban-react-payment/tree/main)
by running the following:
```
git clone https://github.com/stellar/soroban-react-payment.git
cd soroban-react-payment
```
3. Install the dependencies by running the following:
```
bun install
```
4. If you are using the Freighter wallet, ensure that experimental mode is
enabled. You can find this setting in Freighter wallet at:
_`Settings(⚙️)>Preferences>ENABLE EXPERIMENTAL MODE`_.
6. [Enable and add Soroban Tokens](https://soroban.stellar.org/docs/getting-started/connect-freighter-wallet#enable-soroban-tokens)
in Freighter.
7. Select the account that will be used to send Soroban tokens.
8. Provide the required transaction parameters, such as the token to send,amount
of tokens to transfer and the destination address.
9. Review the transaction details to ensure accuracy and then click the "Sign
with Freighter" once . Freighter will prompt you to sign the transaction with
your wallet's private key.
10. Once signed, the click the "Submit payment" button and the transaction will
be submitted to the network.
11. The Payment DApp will show a confirmation message once the transaction has
been successfully submitted.
## Build the Project
```
bun setup && bun run build
```
## Starting a Dev Environment
```
bun setup && bun start
```
## Contributions
Contributions to the Payment DApp are welcome. If you encounter any issues, have
suggestions for improvements, or would like to contribute to the codebase,
please submit an issue, pull request, or reach out to us on
[Discord](https://discord.com/channels/897514728459468821/1037073682599780494).