https://github.com/shashwatah/solbond

On-chain wedding registry dApp built on Solana.
https://github.com/shashwatah/solbond

blockchain blockchain-demo dapp dapps javascript nodejs rust solana solana-client solana-program svelte sveltejs typescript wedding

Last synced: 2 months ago
JSON representation

On-chain wedding registry dApp built on Solana.

• Host: GitHub
• URL: https://github.com/shashwatah/solbond
• Owner: shashwatah
• License: mit
• Created: 2021-08-27T14:06:04.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2024-01-16T19:52:30.000Z (11 months ago)
• Last Synced: 2024-01-17T04:12:16.653Z (11 months ago)
• Topics: blockchain, blockchain-demo, dapp, dapps, javascript, nodejs, rust, solana, solana-client, solana-program, svelte, sveltejs, typescript, wedding
• Language: Svelte
• Homepage: https://solbond.vercel.app
• Size: 877 KB
• Stars: 11
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        


  


  

  


  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](https://www.youtube.com/channel/UCi-pkXLbm7sqXFhV1NBLUfQ) 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](https://github.com/shashwatah/solbond/tree/master/client#readme) to setup the client.

- Follow the [Program README](https://github.com/shashwatah/solbond/tree/master/program#readme) to setup the program.

## Deployment

Solbond's client is currently deployed on Vercel, and the program is deployed on devnet.




Click [here](https://solbond.vercel.app) to visit.

## References

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

- Paul Schaaf's Escrow Client: [https://github.com/paul-schaaf/escrow-ui](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](https://medium.com/coinmonks/get-married-on-the-blockchain-25091f12399b)

- Solana Program Library: [https://github.com/solana-labs/solana-program-library](https://github.com/solana-labs/solana-program-library)

## License

[MIT License](https://github.com/shashwatah/solbond/blob/main/LICENSE) | Copyright (c) 2024 Kumar Shashwat