Skip to main content

Scaffold Soroban

Demonstrative Soroban Dapps

The Soroban team has invested considerable effort into contract implementation. They’ve built CLI’s and libraries, enabling contract builders to create and invoke using Rust, which forms the “backend” of Soroban. However, the “frontend”, which involves JS client libraries, required attention.

Background

During the Soroban Hackathon, we recognized that while the frontend libraries were functional, their user experience was far from ideal. Furthermore, the lack of clear examples made it harder for dapp creators to design and understand Soroban's UX.

To tackle this, the Wallet Engineering team, in collaboration with the Soroban team, has decided to launch “Scaffold Soroban”, a collection of demo dapps. These dapps demonstrate basic functionalities in a structured, easy-to-follow manner, primarily focusing on how to construct/deploy Soroban contract invocations.

Dapp Demos

For easy accessibility, we have compiled the dapps into a single repository, which contains the following dapps:

1. Payment Dapp

This dapp mirrors the Soroban payment flow in Freighter by using the wallet’s Soroban token balances to invoke the xfer method on the token’s contract.

See the demo

2. Mint Token Dapp

This dapp allows a token admin to mint tokens by using the admin account to invoke the mint method on the token’s contract.

See the demo

3. Atomic Swap Dapp

This dapp demonstrates a simplified swap between two tokens by using the wallet’s Soroban token balances to invoke the swap method on the atomic swap contract.

See the demo

How To Explore the Dapps on Scaffold-Soroban

To begin using these examples, navigate to Scaffold-Soroban and choose the name of the dapp you're interested in from the "select demo" dropdown:

  • Payment: Choose "payment".
  • Token Minter: Select "mint-token".
  • Atomic Swap: Opt for "atomic-swap".

Dive in and discover the power of Soroban!

Functionality Behind the Dapps

With the introduction of these dapps, let's delve deeper into some of their standout features that showcase the power and innovation behind the dapps:

Functionality behind the dapps is extensive and diverse, leveraging the @stellar/stellar-sdk library to integrate with the Soroban RPC and facilitating direct communication with Soroban using a JSON RPC interface on the Stellar network. They are equipped to communicate across different network setups, as they incorporate the RPC_URLS and getServer functionalities, providing adaptability that is crucial for various development and deployment scenarios. Users can retrieve user-friendly token information without engaging with complex blockchain operations, by utilizing functions like getTokenSymbol, getTokenName, and getTokenDecimals.

A significant feature is the simulateTx function, which allows users to preview the outcome of a transaction before actually executing it. simulateTx allows users to submit a trial contract invocation by first running a simulation of the contract invocation as defined on the incoming transaction. The results are then applied to a new copy of the transaction, which is returned with the ledger footprint and authorization set, making it ready for signing and sending. The returned transaction will also have an updated fee, the sum of the fee set on the incoming transaction with the contract resource fees estimated from the simulation. It is advisable to check the fee on the returned transaction and validate or take appropriate measures for interaction with the user to confirm it is acceptable.

Other utilities such as accountToScVal and numberToI128 are also provided to simplify transaction creation by converting user-friendly inputs into the formats expected by the Soroban RPC on the Stellar network. Furthermore, the dapps are built with premade helper functions such as the makePayment function which facilitates streamlined "transfer" operations and also includes memos for supplementary transaction-related information.

The code referenced showcases various functionalities including sending transactions, retrieving token information, simulating transactions, building swaps, and authorizing contract calls, all of which are ready to be cloned, customized, and expanded upon to suit your unique needs and ideas.

Conclusion

We hope these dapps will help you understand the Soroban ecosystem better and inspire you to build your own dapps using tools like [stellar-sdk]https://www.npmjs.com/package/@stellar/stellar-sdk) and freighter-api. We look forward to seeing what you create!

For any queries or discussions, don't hesitate to join us on Discord!.