muratgulsen/solbond

On-chain wedding registry dApp built on Solana.

Solbond

An on-chain wedding registry dApp built on Solana with Rust and Svelte.js.

About • Notes • Prerequisites • Setup • Deployment • References • License

This solbond exists under the address: A9VTe6uyjrxjJ1uHVjaRnvCoQHYhuyPbd6GqqES1X1as

About

This project was made as a submission for the on-chain wedding track by Superpumped in the 'Building out Loud' Hackathon by Solana. This repo contains code for both, the Solana Program built with Rust and the client built with Svelte, JavaScript, and TypeScript.

Notes

• Features expected to be on an on-chain wedding dApp but do not exist on Solbond:

  • Shared assets account - The solana program already creates an account to store each solbond's state, the same account can be used as shared asset accounts.
  • Annulment - Upon annulment the above mentioned account can be dissolved and the assets can be divided among the partners.
  • KYC - on-chain or off-chain KYC is needed to make a dApp that solves this particular problem, legally viable.

• Misc

  • Any error encountered when sending a transaction, e.g. not enough balance in the wallet, displays the same, vague error message: 'Transaction resulted in an error'. I'll fix this later.
  • Solbond stores data on-chain, services like arweave and IPFS are (obvious) better alternatives.

• Important:

  • Solana's 'Sollet' wallet has been discontinued, hence, other than viewing previously created contracts, the project is unusable.

Prerequisites

for running the dApp locally:

• General

  • Git is need to clone the repository on your machine.

• Client:

  • npm is needed to install packages.
  • Node.js is needed to run the client.

• Program

  • Rust and Solana CLI tools are needed to build the program and run a test-validator.

for using the dApp:

• 2 Sollet wallets are needed to use the dApp (Only sollet is supported currently).

Setup

• Follow the Client README to setup the client.

• Follow the Program README to setup the program.

Deployment

Solbond's client is currently deployed on Vercel, and the program is deployed on devnet.
Click here to visit.

References

• Paul Shcaaf's Escrow Program: https://github.com/paul-schaaf/solana-escrow/tree/master/program

• Paul Schaaf's Escrow Client: https://github.com/paul-schaaf/escrow-ui

• Claude Barde's 'Get Married on the Blockchain!' medium article: https://medium.com/coinmonks/get-married-on-the-blockchain-25091f12399b

• Solana Program Library: https://github.com/solana-labs/solana-program-library

License

MIT License | Copyright (c) 2024 Kumar Shashwat